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

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

Tipos de IVA

Request

Obtiene los tipos de IVA de Ofimedic.

Query

tokenstringrequired

Código o Token de la sesión.

Example: token=1234

tipoIVAIDstring

Identificador del tipo de IVA.

Example: tipoIVAID=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/GetTiposIVA?fechaModificacion=01%2F01%2F1970&showBajas=1&tipoIVAID=1&token=1234'

Responses

Relación de tipos de IVA

Bodyapplication/jsonArray [

idinteger

Identificador del tipo de IVA.

Example: 1

nombrestring

Nombre del tipo de IVA.

Example: "10%"

IVAnumber(float)

Porcentaje de IVA.
Admite decimales.

Example: 10

]

Response

application/json

[
  {
    "id": 1,
    "descripcion": "21.56%",
    "IVA": 21.56
  }
]

Tipos de visita

Request

Obtiene los tipos de visita de Ofimedic.

Query

tokenstringrequired

Código o Token de la sesión.

Example: token=1234

tipoVisitaIDstring

Identificador del tipo de visita.

Example: tipoVisitaID=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/GetTiposVisita?fechaModificacion=01%2F01%2F1970&showBajas=1&tipoVisitaID=1&token=1234'

Responses

Relación de tipos de visita

Bodyapplication/jsonArray [

idinteger

Identificador del tipo de visita.

Example: 1

descripcionstring

Nombre del tipo de visita.

Example: "Tipo de visita 1"

ubicacionstring

Ubicación del tipo de visita.

Example: "Consulta"

especialidadIdinteger

Identificador de la especialidad del tipo de visita.

Example: 1

especialidadstring

Nombre de la especialidad del tipo de visita.

Example: "Especialidad 1"

idExternostring

Identificador externo del tipo de visita.

Example: "CO123"

]

Response

application/json

[
  {
    "id": 1,
    "descripcion": "Tipo de visita 1",
    "ubicación": "Consulta",
    "especialidadId": 1,
    "especialidad": "Especialidad 1",
    "idExterno": "AB123"
  }
]

Usuarios y facultativos

Request

Obtiene los usuarios/facultativos de Ofimedic.

Query

tokenstringrequired

Código o Token de la sesión.

Example: token=1234

doctorIDstring

Identificador del facultativo.

Example: doctorID=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/GetDoctores?doctorID=1&fechaModificacion=01%2F01%2F1970&showBajas=1&token=1234'

Responses

Relación de facultativos

Bodyapplication/jsonArray [

idinteger

Identificador del facultativo.

Example: 1

esUsuarioboolean

“True” si es usuario, “False” si no es usuario.

Example: true

esDoctorboolean

“True” si es facultativo, “False” si no es facultativo.

Example: false

usuariostring

Nombre del usuario en caso de que esUsuario sea “True”.

Example: "nombre.usuario"

nombrestring

Nombre del facultativo.

Example: "(Nombre)"

apellidosstring

Apellidos del facultativo.

Example: "(Apellidos)"

dnistring

DNI del facultativo.

Example: "00000000A"

direccionstring

Dirección del facultativo.

Example: "Gran Via 1"

poblacionstring

Población del facultativo.

Example: "Barcelona"

cpstring

Código postal del facultativo.

Example: "01234"

provinciastring

Provincia del facultativo.

Example: "Barcelona"

paisstring

País del facultativo.

Example: "España"

telefonoFijostring

Teléfono fijo del facultativo.

Example: "900000000"

telefonoMovilstring

Teléfono móvil del facultativo.

Example: "600000000"

emailstring(email)

Email del facultativo.

Example: "example@correo.com"

delegacionesArray of objects

Delegaciones disponibles del facultativo.

especialidadesArray of objects

Especialidades asignadas al facultativo.

tiposAtencionArray of objects

Tipos de atención disponibles del facultativo.

idExternostring

Identificador externo del facultativo.

Example: "1"

idExternoAltstring

Identificador externo alternativo del facultativo.

Example: "99"

bajaboolean

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

Example: false

titulacionstring

Titulación del facultativo.

Example: "Dr."

numColegiadostring

Número de colegiado.

observacionesstring

Observaciones del facultativo.

fotografiastring

Fotografía del facultativo.

Sólo se devuelve la fotografía en base64 si se obtienen los datos de un solo facultativo.

]

Response

application/json

[
  {
    "id": 1,
    "esUsuario": true,
    "esDoctor": true,
    "usuario": "nombre.usuario",
    "nombre": "(Nombre)",
    "apellidos": "(Apellidos)",
    "dni": "00000000A",
    "direccion": "Gran Via 1",
    "poblacion": "Barcelona",
    "cp": "01234",
    "provincia": "Barcelona",
    "pais": "España",
    "telefonoFijo": "900000000",
    "telefonoMovil": "600000000",
    "email": "example@correo.com",
    "delegaciones": [ … ],
    "especialidades": [ … ],
    "tiposAtencion": [ … ],
    "idExterno": "2",
    "idExternoAlt": "99",
    "baja": false,
    "titulacion": "Dr.",
    "numColegiado": "",
    "observaciones": "",
    "fotografia": ""
  }
]

Otras acciones

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

Operations