Ofimedic Web Service (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:
    • 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 los parámetros fechaInicio y fechaFin están limitados a un periodo máximo de un año.

  • Si no se indica como parámetro el identificador único, solo se permiten llamadas entre las 21:00h y las 10:59h.

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

  • En cada llamada hay que indicar como parámetro un código/token que se obtiene mediante 2FA vía email con la función SetAuth.

  • El token tiene una validez de 2 horas.

  • En todos los métodos de devolución de datos podemos indicar el parámetro fechaModificacion. Si se indica dicha fecha, se devolverán los registros modificados desde esa fecha (incluída) hasta el día actual.

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.

05/05/2025

  • Modificación en GetDelegaciones: inclusión de todos los campos de Persona Jurídica y el campo textoLOPD

26/02/2025

  • Creación de GetPacienteId y GetPaises
  • Modificación en GetDoctores: inclusión de los campos titulacion, numColegiado, observaciones y fotografia

30/01/2025

  • Modificaciones en GetVisitas: inclusión de los campos observaciones, salaID y consultorioID
  • Modificación en GetPacientes: inclusión del campo observacionesHistoria

18/10/2024

  • Modificación en GetPacientes: inclusión del campo tipoPaciente

08/10/2024

  • Creación de SetLlamada
  • Modificación en GetDoctores

03/10/2024

  • Incorporación del parámetro pacienteID en GetVisitas, GetVentas, GetCobros, GetPresupuestos, GetPresupuestosLineas, GetBonos y GetVentasDirectas

06/08/2024

  • Modificación en GetPacientes: inclusión del campo fechaAlta

29/07/2024

  • Modificación en GetDocumentos: inclusión del campo ext

26/07/2024

  • Creación de GetDocumentos

19/06/2024

  • Ampliación de GetDoctores, GetDelegaciones, GetVisitas, GetPresupuestos y GetTarifas
  • Creación de GetConsultorios y GetPresupuestosLineas

08/05/2024

  • Ampliación de GetVisitas

12/04/2024

  • Ampliación de GetPacientes

26/02/2024

  • Modificación en GetPacientes, incluyendo paginación de resultados

19/02/2024

  • Incorporación del parámetro de entrada fechaModificacion a todos los métodos de devolución de datos

15/02/2024

  • Modificación de fechas

30/01/2024

  • Modificación horario permitido de llamadas
  • Añadido 2FA para todas las llamadas

19/12/2023

  • 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/ofimedicws/test/services.asmx/

Autenticación

Autenticación con el servidor.

Operations

Obtención de datos

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

Operations

Cobros

Request

Obtiene los cobros de Ofimedic.

Query
tokenstringrequired

Código o Token de la sesión.

Example: token=1234
cobroIDstring

Identificador del cobro.

Example: cobroID=1
pacienteIDstring

Identificador del paciente.

Example: pacienteID=1
fechaIniciostring(date)

Fecha de inicio. Se indica en formato de fecha (dd/mm/aaaa).
Obligatorio indicar este parámetro si no se indica el parámetro cobroID.
La diferencia máxima entre este parámetro y fechaFin debe ser de un año natural. Debe ser anterior a fechaFin.

Example: fechaInicio=01/01/2024
fechaFinstring(date)

Fecha de finalización. Se indica en formato de fecha (dd/mm/aaaa).
Obligatorio indicar este parámetro si no se indica el parámetro cobroID.
La diferencia máxima entre fechaInicio y este parámetro debe ser de un año natural. Debe ser posterior a fechaInicio.

Example: fechaFin=31/12/2024
delegacionIDstring

Identificador de la delegación.

Example: delegacionID=1
fechaModificacionstring(date)

Fecha de modificación.

Example: fechaModificacion=01/01/1970
curl -i -X GET \
  -u <username>:<password> \
  'https://ws.ofimedic.com/ofimedicws/test/services.asmx/GetCobros?cobroID=1&delegacionID=1&fechaFin=31%2F12%2F2024&fechaInicio=01%2F01%2F2024&fechaModificacion=01%2F01%2F1970&pacienteID=1&token=1234'

Responses

Relación de cobros

Bodyapplication/jsonArray [
idinteger

Identificador del cobro.

Example: 1
fechastring(date)

Fecha de la venta.
El formato de fecha es "aaaa-mm-dd".

Example: "2024-04-29"
pacienteIdinteger

Identificador del paciente de la venta.

Example: 1
visitaIdinteger

Identificador de la visita de la venta, si está asociado.

Example: 1
presupuestoIdinteger

Identificador del presupuesto de la venta, si está asociado.

Example: 1
bonoIdinteger

Identificador del bono de la venta, si está asociado.

Example: 1
ventaDirectaIdinteger

Identificador de la venta directa de la venta, si está asociado.

Example: 1
importenumber(float)

Importe del cobro.
Admite decimales.

Example: 49.99
formaPagoIdinteger

Identificador de la forma de pago del cobro.

Example: 1
formaPagostring

Forma de pago del cobro asociado a la venta.

Example: "Efectivo"
]
Response
application/json
[
  {
    "id": 1,
    "fecha": "2024-04-29",
    "pacienteId": 1,
    "visitaId": 4296,
    "presupuestoId": 618,
    "bonoId": 47,
    "ventaDirectaId": 39,
    "importe": 60,
    "formaPagoId": 1,
    "formaPago": "Efectivo"
  }
]

Consultorios

Request

Obtiene los consultorios de Ofimedic.

Query
tokenstringrequired

Código o Token de la sesión.

Example: token=1234
consultorioIDstring

Identificador del consultorio.

Example: consultorioID=1
showBajasstring

Vacío o “1” para devolver todos los registros. “0” para devolver solo los registros dados de alta.

Example: showBajas=1
fechaModificacionstring(date)

Fecha de modificación.

Example: fechaModificacion=01/01/1970
curl -i -X GET \
  -u <username>:<password> \
  'https://ws.ofimedic.com/ofimedicws/test/services.asmx/GetConsultorios?consultorioID=1&fechaModificacion=01%2F01%2F1970&showBajas=1&token=1234'

Responses

Relación de consultorios

Bodyapplication/jsonArray [
idinteger

Identificador del consultorio.

Example: 1
nombrestring

Nombre del consultorio.

Example: "Despacho Doctor 1"
delegacionIdinteger

Identificador de la delegación del consultorio.

Example: 1
bajaboolean

“True” si el registro está dado de baja, “False” si no está dado de baja.

Example: false
]
Response
application/json
[
  {
    "id": 1,
    "nombre": "Despacho Doctor 1",
    "delegacionId": 1,
    "baja": false
  }
]

Delegaciones

Request

Obtiene las delegaciones de Ofimedic.

Query
tokenstringrequired

Código o Token de la sesión.

Example: token=1234
delegacionIDstring

Identificador de la delegación.

Example: delegacionID=1
showBajasstring

Vacío o “1” para devolver todos los registros. “0” para devolver solo los registros dados de alta.

Example: showBajas=1
fechaModificacionstring(date)

Fecha de modificación.

Example: fechaModificacion=01/01/1970
curl -i -X GET \
  -u <username>:<password> \
  'https://ws.ofimedic.com/ofimedicws/test/services.asmx/GetDelegaciones?delegacionID=1&fechaModificacion=01%2F01%2F1970&showBajas=1&token=1234'

Responses

Relación de delegaciones

Bodyapplication/jsonArray [
idinteger

Identificador de la delegación.

Example: 1
nombrestring

Nombre de la delegación.

Example: "A"
direccionstring

Dirección de la delegación.

Example: "Gran Via 1"
poblacionstring

Población de la delegación.

Example: "Barcelona"
cpstring

Código postal de la delegación.

Example: "01234"
provinciastring

Provincia de la delegación.

Example: "Barcelona"
paisstring

País de la delegación.

Example: "España"
telefonostring

Teléfono de la delegación.

Example: "900000000"
emailstring(email)

Email de la delegación.

Example: "example@correo.com"
nifstring

NIF de la delegación.

Example: "A00000000"
personaJuridicastring

Persona jurídica de la delegación.

Example: "Clínica 1"
abreviaturaPersonaJuridicastring

Abreviatura de la persona jurídica de la delegación.

Example: "C1"
direccionPersonaJuridicastring

Dirección de la persona jurídica de la delegación.

Example: "Calle Principal, 1"
poblacionPersonaJuridicastring

Población donde se ubica la persona jurídica.

Example: "Barcelona"
cpPersonaJuridicastring

Código postal de la dirección de la persona jurídica.

Example: "08000"
provinciaPersonaJuridicastring

Provincia de la persona jurídica.

Example: "Barcelona"
paisPersonaJuridicastring

País de la persona jurídica.

Example: "España"
telefonoPersonaJuridicastring

Teléfono de contacto de la persona jurídica.

Example: "911234567"
faxPersonaJuridicastring

Número de fax de la persona jurídica.

Example: "917654321"
emailPersonaJuridicastring

Correo electrónico de la persona jurídica.

Example: "contacto@clinica1.es"
webPersonaJuridicastring

Página web de la persona jurídica.

Example: "https://www.clinica1.es"
nifPersonaJuridicastring

NIF (Número de Identificación Fiscal) de la persona jurídica.

Example: "B12345678"
textoLOPDstring

Texto informativo conforme a la LOPD (protección de datos).

Example: "De acuerdo con la LOPD, sus datos serán tratados de forma confidencial."
idExternostring

Identificador externo de la delegación.

Example: "1"
bajaboolean

“True” si el registro está dado de baja, “False” si no está dado de baja.

Example: false
]
Response
application/json
[
  {
    "id": 1,
    "nombre": "Delegación 1",
    "direccion": "Gran Via 1",
    "poblacion": "Barcelona",
    "cp": "01234",
    "provincia": "Barcelona",
    "pais": "España",
    "telefono": "900000000",
    "email": "example@delegacion.com",
    "nif": "00000000A",
    "personaJuridica": "Centro médico",
    "idExterno": "1",
    "baja": false
  }
]

Otras acciones

Respuesta de búsqueda de datos a partir de los parámetros y valores especificados.

Operations