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

Overview

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

E-mail soporte@ofimedic.com

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
  }
]