Ofimedic TD (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}

  • Todos los parámetros de entrada son obligatorios a no ser que se indique lo contrario.
    • 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.

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

  • En todas las respuestas de las llamadas se devuelve el NIF del cliente en la cabecera con la etiqueta “X-Ofimedic-NIF”.

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.

29/01/2025

  • Creación de la función GetPatients

03/10/2024

  • Añadido el identificador de Ofimedic en las respuestas de GetLocations, GetResources, GetInsurances y GetUsers

18/09/2024

  • Modificación en UpdateAppointment

05/09/2024

  • Modificaciones en SetLlamada, AddAppointment y UpdateAppointment
  • Creación de GetTDActivitiesSincro y AddAppointmentSincro

05/06/2024

  • Modificación en AddAppointment

16/05/2024

  • Modificaciones en SearchAvailabilities, CheckAvailability y AddAppointment

07/03/2024

  • Modificación en GetActivities

20/02/2024

  • Modificación en GetActivities

15/01/2024

  • Modificación en GetInsurances

09/01/2024

  • Creación de la función CheckAvailability

03/01/2024

  • Modificación en GetActivities

14/11/2023

  • Modificación en GetActivities

07/11/2023

  • Modificaciones en GetActivities y SearchAvailabilities

05/10/2023

  • Modificaciones en AddAppointment y SearchAvailabilities

28/06/2023

  • Eliminación, por motivos de desuso, de la función AddPatients
  • Ajustes en AddAppointment

21/06/2023

  • Ajustes en AddAppointment

09/06/2023

  • Ajustes en GetInsurances

25/05/2023

  • Ajustes en GetAppointments

23/05/2023

  • Ajustes en UpdateAppointment

16/05/2023

  • Ajustes en GetActivities, GetInsurances, AddPatient y AddAppointment

05/05/2023

  • Ajustes en GetActivities, GetInsurances, SearchAvailabilities, GetAppointments y AddAppointment

03/05/2023

  • Ajustes en AddPatient, AddAppointment y UpdateAppointment

25/04/2023

  • Creación del documento
Languages
Servers
https://www.ofimedic.com/

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

Llamadas

Recepción de notificaciones a partir de parámetros indicados.

Operations

Obtención de listados

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

Operations

Delegaciones

Request

Obtiene los centros/delegaciones de Ofimedic.

Query
LOCATION_IDstring

Identificador del centro/delegación.

Example: LOCATION_ID=1
curl -i -X GET \
  -u <username>:<password> \
  'https://www.ofimedic.com/GetLocations?LOCATION_ID=1'

Responses

Relación de delegaciones

Bodyapplication/jsonArray [
LOCATION_IDinteger

Identificador del centro/delegación.

Example: 1
LOCATION_NAMEstring

Nombre del centro/delegación.

Example: "A"
LOCATION_ADRESSstring

Dirección del centro/delegación.

Example: "Barcelona"
LOCATION_ZIP_CODEstring

Código postal del centro/delegación.

Example: "01234"
LOCATION_CITYstring

Población del centro/delegación.

Example: "Barcelona"
LOCATION_PROVINCEstring

Provincia del centro/delegación.

Example: "Barcelona"
LOCATION_COUNTRYstring

País del centro/delegación.

Example: "España"
LOCATION_PHONEstring

Teléfono del centro/delegación.

Example: "900000000"
LOCATION_EMAILstring(email)

Email del centro/delegación.

Example: "example@correo.com"
]
Response
application/json
[ { "LOCATION_ID": 1, "LOCATION_NAME": "Delegación 1", "LOCATION_ADRESS": "Calle Ejemplo 1", "LOCATION_ZIP_CODE": "00000", "LOCATION_CITY": "Madrid", "LOCATION_PROVINCE": "Madrid", "LOCATION_COUNTRY": "España", "LOCATION_PHONE": "900000000", "LOCATION_EMAIL": "email@ejemplo.com" } ]

Facultativos

Request

Obtiene los facultativos que son usuarios y los facultativos que no son usuarios de Ofimedic.

Query
LOCATION_IDstring

Identificador del centro/delegación.

Example: LOCATION_ID=1
curl -i -X GET \
  -u <username>:<password> \
  'https://www.ofimedic.com/GetResources?LOCATION_ID=1'

Responses

Relación de facultativos

Bodyapplication/jsonArray [
RESOURCE_IDinteger

Identificador del facultativo.

Example: 1
RESOURCE_FIRST_NAMEstring

Nombre del facultativo.

Example: "A"
RESOURCE_SECOND_NAMEstring

Apellidos del facultativo.

Example: "B"
RESOURCE_MOBILE_PHONEstring

Teléfono móvil del facultativo.

Example: "600000000"
LOCATION_EMAILstring(email)

Email del facultativo.

Example: "example@correo.com"
RESOURCE_ID_NUMBERstring

DNI del facultativo.

Example: "00000000A"
AVAILABILITIES_STEPinteger

Intervalo del facultativo

Example: 4
LOCATION_IDinteger

Identificador del centro/delegación.

Example: 1
]
Response
application/json
[ { "RESOURCE_ID": 1, "RESOURCE_FIRST_NAME": "A", "RESOURCE_SECOND_NAME": "B", "RESOURCE_MOBILE_PHONE": "600000000", "LOCATION_EMAIL": "example@correo.com", "RESOURCE_ID_NUMBER": "00000000A", "AVAILABILITIES_STEP": 4, "LOCATION_ID": 1 } ]

Pacientes

Request

Obtiene los pacientes de Ofimedic.
Función actualmente inhabilitada.

Query
INCLUDE_DEACTIVATEDstring

Permite mostrar solo pacientes activos o todos los pacientes, incluidos los dados de baja.
0 para devolver sólo los pacientes activos.
1 o vacío para devolver todos los pacientes.

Example: INCLUDE_DEACTIVATED=1
curl -i -X GET \
  -u <username>:<password> \
  'https://www.ofimedic.com/GetPatients?INCLUDE_DEACTIVATED=1'

Responses

Relación de pacientes

Bodyapplication/jsonArray [
PATIENT_IDinteger

Identificador del paciente.

Example: 1
PATIENT_FIRST_NAMEstring

Nombre del paciente

Example: "A"
PATIENT_SECOND_NAMEstring

Apellidos del paciente

Example: "A"
PATIENT_EMAILstring(email)

Email del paciente.

Example: "example@ofimedic.com"
PATIENT_MOBILE_PHONEstring

Teléfono móvil del paciente.

Example: "600000000"
PATIENT_FIXED_PHONEstring

Teléfono fijo del paciente.

Example: "900000000"
PATIENT_JOB_PHONEstring

Teléfono del trabajo del paciente.

Example: "910000000"
PATIENT_ID_NUMBERstring

DNI del paciente.

Example: "00000000A"
PATIENT_BIRTHDATEstring(date)

Fecha de nacimiento del paciente.

Example: "01/01/1970"
PATIENT_GENDERstring

Sexo del paciente (“H” para hombre, “M” para mujer).

Example: "H"
PATIENT_ADRESSstring

Dirección del paciente.

Example: "C/ Ejemplo"
PATIENT_CITYstring

Población del paciente.

Example: "Madrid"
PATIENT_PROVINCEstring

Provincia del paciente.

Example: "Madrid"
PATIENT_POSTAL_CODEstring

Código postal del paciente.

Example: "01234"
PATIENT_COUNTRYstring

País del paciente.

Example: "España"
PATIENT_DEACTIVATEDinteger

Indica si el paciente está dado de baja.
1 si está dado de baja.
0 si no está dado de baja.

Example: 0
]
Response
application/json
[ { "PATIENT_ID": 1, "PATIENT_FIRST_NAME": "A", "PATIENT_SECOND_NAME": "B", "PATIENT_EMAIL": "example@ofimedic.com", "PATIENT_MOBILE_PHONE": "600000000", "PATIENT_FIXED_PHONE": "900000000", "PATIENT_JOB_PHONE": "910000000", "PATIENT_ID_NUMBER": "00000000A", "PATIENT_BIRTHDATE": "01/01/1970", "PATIENT_GENDER": "H", "PATIENT_ADRESS": "C/ Ejemplo", "PATIENT_CITY": "Madrid", "PATIENT_PROVINCE": "Madrid", "PATIENT_POSTAL_CODE": "01234", "PATIENT_COUNTRY": "España", "PATIENT_DEACTIVATED": 0 } ]

Tarifas

Request

Obtiene las tarifas de Ofimedic.

Query
RESOURCE_IDstring

Identificador del facultativo.

Example: RESOURCE_ID=1
ACTIVITY_IDstring

Identificador del tipo de visita.

Example: ACTIVITY_ID=1
TYPEinteger

Tipo de tarifa a devolver.
Si se deja este parámetro vacío se devuelven todas las tarifas.
0 para devolver sólo las tarifas privadas.
1 para devolver sólo las compañías.

curl -i -X GET \
  -u <username>:<password> \
  'https://www.ofimedic.com/GetInsurances?ACTIVITY_ID=1&RESOURCE_ID=1&TYPE=0'

Responses

Relación de tipos de visita

Bodyapplication/jsonArray [
INSURANCE_IDinteger

Identificador de la tarifa.

Example: 1
INSURANCE_NAMEstring

Nombre de la tarifa.

Example: "Tarifa privada"
TYPEinteger

Tipo de tarifa.
0 = tarifas privadas.
1 = compañías.

Example: 0
]
Response
application/json
[ { "INSURANCE_ID": 1, "INSURANCE_NAME": "Tarifa privada", "TYPE": 0 } ]

Tipos de visita

Request

Obtiene los tipos de visita de Ofimedic.

Query
RESOURCE_IDstring

Identificador del facultativo.

Example: RESOURCE_ID=1
INSURANCE_IDstring

Identificador de la compañía.

Example: INSURANCE_ID=1
curl -i -X GET \
  -u <username>:<password> \
  'https://www.ofimedic.com/GetActivities?INSURANCE_ID=1&RESOURCE_ID=1'

Responses

Relación de tipos de visita

Bodyapplication/jsonArray [
ACTIVITY_IDinteger

Identificador del tipo de visita.

Example: 1
ACTIVITY_NAMEstring

Nombre del tipo de visita.

Example: "Primer tipo de visita"
ACTIVITY_DURATIONinteger

Duración del tipo de visita.
Se indica en minutos.

Example: 15
ACTIVITY_SPECIALTY_IDinteger

Identificador de la especialidad del tipo de visita.

Example: 1
ACTIVITY_SPECIALTY_NAMEstring

Nombre de la especialidad del tipo de visita.

Example: "Especialidad 1"
ACTIVITY_APPOINTMENT_TYPEstring

Tipos de atención disponibles del facultativo.
Se muestra en una matriz los tipos de atención disponibles, con el nombre y su código.
Se muestra sólo si se informa del parámetro de entrada RESOURCE_ID.

Example: "Primer tipo de visita, 1"
ACTIVITY_SERVICESstring

Información de los servicios relacionados con el tipo de visita.
Se muestra en una matriz la información de los servicios solo si se informan los parámetros de entrada RESOURCE_ID e INSURANCE_ID.

ACTIVITY_SERVICE_IDinteger

Identificador del servicio.

Example: 1
ACTIVITY_SERVICE_NAMEstring

Nombre del servicio.

Example: "Servicio 1"
ACTIVITY_SERVICE_PRICEnumber(float)

Base Imponible del servicio.
Admite decimales.

Example: 49.99
ACTIVITY_SERVICE_PRICE_VATnumber(float)

Porcentaje de IVA del servicio.
Admite decimales.

Example: 21
ACTIVITY_OFIMEDIC_IDinteger

Identificador del tipo de visita en Ofimedic.

Example: 1
]
Response
application/json
[ { "ACTIVITY_ID": 1, "ACTIVITY_NAME": "Primer tipo de visita", "ACTIVITY_DURATION": 15, "ACTIVITY_SPECIALTY_ID": 1, "ACTIVITY_SPECIALTY_NAME": "Especialidad 1", "ACTIVITY_APPOINTMENT_TYPE": "Primer tipo de visita, 1", "ACTIVITY_SERVICES": "", "ACTIVITY_SERVICE_ID": 1, "ACTIVITY_SERVICE_NAME": "Servicio 1", "ACTIVITY_SERVICE_PRICE": 49.99, "ACTIVITY_SERVICE_PRICE_VAT": 21, "ACTIVITY_OFIMEDIC_ID": 1 } ]

Usuarios

Request

Obtiene los usuarios y/o facultativos que tienen acceso a Ofimedic.

Query
LOCATION_IDstring

Identificador del centro/delegación.

Example: LOCATION_ID=1
curl -i -X GET \
  -u <username>:<password> \
  'https://www.ofimedic.com/GetUsers?LOCATION_ID=1'

Responses

Relación de pacientes

Bodyapplication/jsonArray [
RESOURCE_IDinteger

Identificador del facultativo.

Example: 1
RESOURCE_FIRST_NAMEstring

Nombre del facultativo.

Example: "A"
RESOURCE_SECOND_NAMEstring

Apellidos del facultativo.

Example: "B"
RESOURCE_USER_NAMEstring

Nombre de usuario del facultativo.

Example: "nombre.usuario"
LOCATION_IDinteger

Identificador del centro/delegación.

Example: 2
RESOURCE_OFIMEDIC_IDinteger

Identificador del facultativo en Ofimedic.

Example: 3
]
Response
application/json
[ { "RESOURCE_ID": 1, "RESOURCE_FIRST_NAME": "A", "RESOURCE_SECOND_NAME": "B", "RESOURCE_USER_NAME": "nombre.usuario", "LOCATION_ID": 2, "RESOURCE_OFIMEDIC_ID": 3 } ]