Ofimedic Cita Online (1.0.0)

Introducción

Especificaciones de los métodos que permiten interactuar con la información almacenada en las bases de datos de Ofimedic.

Especificaciones

  • La URL para acceder al servicio tendrá la siguiente estructura:
    • http://{URL}/services.asmx/{NombreMétodo}
    • https://{URL}/services.asmx/{NombreMétodo}

  • Los parámetros de entrada que son obligatorios están marcados como tal.
    • Hay parámetros de entrada que pueden no estar marcados como obligatorios, pero que lo sean bajo ciertas condiciones, las cuales están indicadas.

  • Si un parámetro es opcional, hay que pasar un espacio en blanco.

  • Todas las llamadas que incluyen parámetros de entrada en formato de fecha con inicio (START) y final (END) tendrán una limitación, la cuál estará indicada en cada método.

  • Todos los mensajes de respuesta estarán formateados en JSON.

  • En el caso de que la función indique horario restringido de obtención de datos, solo se permiten llamadas entre las 21:00h y las 10:59h.

Historial de cambios

Lista actualizada con los cambios realizados. Se indican las fechas y la descripción de los cambios. Se muestra del cambio más reciente al más antiguo.

30/01/2025

  • Modificaciones en GetAppointments:
    • Inclusión de los campos APP_ARRIVAL_TIME, APP_ENTER_TIME, APP_EXIT_TIME y APP_STATEID.
    • Eliminación del campo APP_CREATED.

23/12/2024

  • Adecuación del documento y modificaciones en SearchAvailabilities, CheckAvailavility y GetAppointments.

23/01/2024

  • Creación del documento.
Overview
URL

https://www.ofimedic.com/soporte/asistencia.asp

E-mail

soporte@ofimedic.com

Languages
Servers
Test

https://ws.ofimedic.com/citaonlinews/test/services.asmx/

Conexión

Prueba de conexión.

Operations

Citas

Respuesta de las acciones relativas a las citas en Ofimedic.

Operations

Disponibilidad

Búsqueda de datos de disponibilidad a partir de parámetros y valores indicados.

Operations

Búsqueda

Request

Obtiene los huecos libres de la agenda de Ofimedic.

Query
AVA_START_DAYstring(date)required

Fecha de inicio. Se indica en formato de fecha (dd/mm/aaaa).

Example: AVA_START_DAY=01/01/2024
AVA_START_TIMEstring(time)required

Hora de inicio. Se indica en formato de hora (hh:mm).

Example: AVA_START_TIME=08:00
AVA_END_DAYstring(date)

Fecha de finalización. Se indica en formato de fecha (dd/mm/aaaa).
Si se indica este parámetro, debe ser posterior a AVA_START_DAY.

Example: AVA_END_DAY=31/12/2024
RESOURCE_IDstring

Identificador del facultativo.

Example: RESOURCE_ID=1
LOCATION_IDstring

Identificador del centro/delegación.

Example: LOCATION_ID=1
INSURANCE_IDstring

Identificador de la compañía.

Example: INSURANCE_ID=1
ACTIVITY_IDstring

Identificador del tipo de visita.

Example: ACTIVITY_ID=1
AVA_RESULTS_NUMBERstring

Número de disponibilidades mostradas.
0 si se desea mostrar todas las disponibilidades.
En caso de no indicar este parámetro se mostrarán, como máximo, 100 resultados en la respuesta.
Si se indica un 0 o un número superior a 100, la consulta estará restringida por horario.

Example: AVA_RESULTS_NUMBER=0
curl -i -X GET \
  -u <username>:<password> \
  'https://ws.ofimedic.com/citaonlinews/test/services.asmx/SearchAvailabilities?ACTIVITY_ID=1&AVA_END_DAY=31%2F12%2F2024&AVA_RESULTS_NUMBER=0&AVA_START_DAY=01%2F01%2F2024&AVA_START_TIME=08%3A00&INSURANCE_ID=1&LOCATION_ID=1&RESOURCE_ID=1'

Responses

Relación de huecos disponibles

Bodyapplication/jsonArray [
AVA_DATEstring(date)

Fecha disponible.
Formato en "dd/mm/aaaa".

Example: "16/02/2025"
AVA_START_TIMEstring(time)

Hora de inicio.
Formato en "hh:mm".

Example: "12:00"
AVA_END_TIMEstring(time)

Hora de finalización.
Formato en "hh:mm".

Example: "12:15"
RESOURCE_IDinteger

Identificador del facultativo.

Example: 1
LOCATION_IDinteger

Identificador del centro/delegación (requerido si se indica RESOURCE_ID).

Example: 2
INSURANCE_IDinteger

Identificador de la compañía.

Example: 4
ACTIVITY_IDinteger

Identificador del tipo de visita.

Example: 2
]
Response
application/json
[
  {
    "AVA_DATE": "16/02/2025",
    "AVA_START_TIME": "12:00",
    "AVA_END_TIME": "12:15",
    "RESOURCE_ID": 1,
    "LOCATION_ID": 2,
    "INSURANCE_ID": 4,
    "ACTIVITY_ID": 2
  }
]

Comprobación

Request

Comprueba si el hueco indicado está libre en la agenda de Ofimedic.

Query
AVA_START_DAYstring(date)required

Fecha de inicio. Se indica en formato de fecha (dd/mm/aaaa).

Example: AVA_START_DAY=01/01/2024
AVA_START_TIMEstring(time)required

Hora de inicio. Se indica en formato de hora (hh:mm).

Example: AVA_START_TIME=08:00
AVA_END_DAYstring(date)

Fecha de finalización. Se indica en formato de fecha (dd/mm/aaaa).
Si se indica este parámetro, debe ser posterior a AVA_START_DAY.

Example: AVA_END_DAY=31/12/2024
RESOURCE_IDstring

Identificador del facultativo.

Example: RESOURCE_ID=1
LOCATION_IDstring

Identificador del centro/delegación.

Example: LOCATION_ID=1
INSURANCE_IDstring

Identificador de la compañía.

Example: INSURANCE_ID=1
ACTIVITY_IDstring

Identificador del tipo de visita.

Example: ACTIVITY_ID=1
AVA_RESULTS_NUMBERstring

Número de disponibilidades mostradas.
0 si se desea mostrar todas las disponibilidades.
En caso de no indicar este parámetro se mostrarán, como máximo, 100 resultados en la respuesta.
Si se indica un 0 o un número superior a 100, la consulta estará restringida por horario.

Example: AVA_RESULTS_NUMBER=0
curl -i -X GET \
  -u <username>:<password> \
  'https://ws.ofimedic.com/citaonlinews/test/services.asmx/CheckAvailability?ACTIVITY_ID=1&AVA_END_DAY=31%2F12%2F2024&AVA_RESULTS_NUMBER=0&AVA_START_DAY=01%2F01%2F2024&AVA_START_TIME=08%3A00&INSURANCE_ID=1&LOCATION_ID=1&RESOURCE_ID=1'

Responses

Relación de huecos disponibles

Bodyapplication/jsonArray [
AVA_DATEstring(date)

Fecha disponible.
Formato en "dd/mm/aaaa".

Example: "16/02/2025"
AVA_START_TIMEstring(time)

Hora de inicio.
Formato en "hh:mm".

Example: "12:00"
AVA_END_TIMEstring(time)

Hora de finalización.
Formato en "hh:mm".

Example: "12:15"
RESOURCE_IDinteger

Identificador del facultativo.

Example: 1
LOCATION_IDinteger

Identificador del centro/delegación (requerido si se indica RESOURCE_ID).

Example: 2
INSURANCE_IDinteger

Identificador de la compañía.

Example: 4
ACTIVITY_IDinteger

Identificador del tipo de visita.

Example: 2
]
Response
application/json
[
  {
    "AVA_DATE": "16/02/2025",
    "AVA_START_TIME": "12:00",
    "AVA_END_TIME": "12:15",
    "RESOURCE_ID": 1,
    "LOCATION_ID": 2,
    "INSURANCE_ID": 4,
    "ACTIVITY_ID": 2
  }
]

Obtención de listados

Obtiene las listas con los datos a partir de los valores especificados.

Operations