Integración de aplicaciones de terceros con Provet Cloud

Introducción

El sistema de gestión de la práctica veterinaria Provet Cloud se puede integrar con aplicaciones de terceros utilizando herramientas llamadas REST API y webhooks. Este artículo describe el uso de estas metodologías de integración.

Webhooks están disponibles en Provet Cloud para enviar notificaciones a sistemas de terceros sobre adiciones o cambios en los datos dentro de Provet Cloud. Los webhooks no transfieren los datos reales modificados, sino que transfieren la información sobre lo que ha cambiado simplemente notificando el cambio al sistema de terceros. Los datos reales pueden ser obtenidos por el sistema de terceros mediante la utilización de la API REST de Provet Cloud.

REST API es un método de comunicación para acceder, editar o añadir a los datos que residen en Provet Cloud de forma programática por cualquier aplicación de terceros. La API REST de Provet Cloud ofrece la mayoría de los datos clave de Provet Cloud para ser leídos o manipulados por otros sistemas.

La combinación de Provet Cloud webhooks & REST API crea posibilidades únicas para la construcción de soluciones integradas. Cualquier proveedor de otros sistemas familiarizado con estas tecnologías puede integrarse fácilmente con los datos que residen en el sistema de gestión de la práctica veterinaria Provet Cloud utilizando estas tecnologías.

Nordhealth ofrece consultoría para ayudar con el uso de la API REST & webhooks. Para obtener más información, consulte nuestro sitio para desarrolladores https://developers.provetcloud.com/ .

Ejemplo de solución de integración

Caso: Si un sistema de terceros (por ejemplo, un sistema financiero) quisiera tener información inmediata sobre una consulta recién creada en Provet Cloud, ésta podría archivarse combinando los webhooks & REST API de la siguiente manera utilizando el webhook de consulta.

  1. Se crea una consulta en Provet Cloud.

  2. Provet Cloud envía una notificación de gancho HTTP de consulta a la URL definida en la configuración.

    • Webhook: Consulta crear/actualizar

    • Parámetro: consultation_id=123 (se ha creado la consulta con ID 123)

  3. El sistema de terceros recibe el gancho y sabe que la consulta con ID 123 se ha creado en Provet Cloud.

  4. El sistema de terceros solicita la consulta con datos ID 123 mediante la llamada a la API REST.

  5. Provet Cloud devuelve los datos de la consulta con ID 123 en formato JSON.

  6. El sistema de terceros recibe los datos de la consulta y los procesa de la forma deseada (y crea más llamadas a la API REST, si es necesario).

integration-solution-scheme.png

Webhooks

Los Webhooks se configuran y habilitan en Ajustes > General > Integraciones > Webhooks.

  • Ejemplo: "consulta_id=123"

  • Si la respuesta es distinta de HTTP 200, se volverá a intentar la entrega de la notificación

  • En la página de configuración, también puede ver una lista actualizada de los webhooks activados y su estado de entrega. Hay un registro disponible para la revisión

  • Si deja vacío el campo de ubicación de la clínica, el webhook funcionará en toda la organización.

  • Algunas acciones en las que no se puede deducir la ubicación de la clínica, como la actualización de clientes y pacientes a través de la API REST, no activan webhooks específicos de la ubicación de la clínica.

  • Los webhooks son peticiones HTTP POST a la URL definida en la configuración de cada webhook

  • La solicitud POST contiene datos que identifican qué tipo de datos se actualizaron, y el ID del objeto

  • Los Webhooks esperan recibir una respuesta HTTP 200 en el proceso exitoso

  • Los webhooks pueden configurarse para que sean específicos de una ubicación de la clínica, en cuyo caso sólo se activan cuando se actualizan los elementos de una determinada ubicación de la clínica, o pueden configurarse para que abarquen toda la organización, en cuyo caso siempre se activan.

  • Se pueden establecer varios webhooks para el mismo desencadenante y/o ubicación clínica, y las actualizaciones desencadenarán todos los webhooks que se apliquen en la situación.

  • A los webhooks se les puede dar un nombre opcional para ayudar a identificarlos y diferenciarlos.

  • Los webhooks que ya no sean necesarios pueden desactivarse desmarcando la casilla Activo.

Los siguientes eventos Webhook están actualmente disponibles en la configuración de Provet Cloud. Cada uno de los ganchos puede tener una dirección URL diferente (o la misma), a la que Provet Cloud envía el gancho cuando se activa en el evento.

  • Informe contable: parámetro accountingreport_id

  • Cita: parámetro appointment_id

  • Borrar cita: parámetro appointment_id

  • Crear recordatorio de cita: parámetro reminder_id

  • Actualización del recordatorio de cita: parámetro reminder_id

  • Borrar recordatorio de cita: parámetro reminder_id

  • Elemento del armario cancelar uso: parámetro id elemento

  • Elemento del armario uso: parámetro id elemento

  • Cliente: parámetro client_id

  • Borrar cliente: parámetro client_id

  • Preferencia de comunicación del cliente: parámetro id de preferencia de comunicación

  • Consulta crear/actualizar:: parámetro consultation_id

  • Borrar consulta: parámetro consultation_id

  • Consulta finalizada: parámetro consultation_id

  • Elemento de consulta: parámetro consultationitem_id

  • Alta de consulta en espera: parámetro consultation_id

  • Lista de trabajo de diagnóstico por imagen: parámetro diagnosticimagingworklist_id

  • Actualización de la lista de trabajo de diagnóstico por imagen: parámetro diagnosticimagingworklist_id

  • Eliminación de la lista de trabajo de diagnóstico por imagen: parámetro diagnosticimagingworklist_id

  • Registro de correos electrónicos enviados

  • Actualización de la situación del plan de salud

  • Reclamación de seguro: parámetro insuranceclaim_id

  • Factura: parámetro id factura

  • Borrador de factura (notifica cuando se actualiza un borrador de factura o se añaden elementos automáticamente): parámetro id factura

  • Pago de la factura: parámetro invoicepayment_id

  • Borrar línea de factura

  • Solicitud de laboratorio (derivación): parámetro laboratory_referral_id

  • Notas & comunicación

  • Artículo del armario de organización: parámetro item_id

  • Organización alimentaria: parámetro item_id

  • Organización item: : parámetro item_id

  • Organización análisis de laboratorio: parámetro item_id

  • Organización panel de análisis de laboratorio: parámetro item_id

  • Organización: parámetro item_id

  • Procedimiento de organización: parámetro item_id

  • Suministro de la organización: parámetro item_id

  • Paciente: parámetro patient_id

  • Crear una base de datos de pacientes

  • Envío de información sobre pacientes derivados

  • Recordatorio crear/modificar

  • Recordatorio eliminar

  • Borrar plantilla de recordatorio

  • Registro de SMS enviados

  • Entrada de artículos en stock

  • Borrar entrada de stock

  • Pedido de existencias

  • Supresión de pedidos de existencias

  • Artículo de pedido de existencias

  • Borrar posición de pedido de stock

  • Plan de tratamiento

  • Eliminación del plan de tratamiento

  • Punto del plan de tratamiento

  • Supresión del elemento del plan de tratamiento

  • Pago no asignado: parámetro unallocatedpayment_id

  • Usuario, parámetro id de usuario

Nota

Esta lista se actualizó en agosto de 2024. Constantemente se desarrollan ganchos adicionales basados en las peticiones de nuestros usuarios.

API REST

Provet Cloud proporciona la API REST para permitir el acceso a los datos almacenados en Provet Cloud. La API utiliza la autenticación OAuth 2.0. Los datos se devuelven en el formato JSON.

  • Para acceder a la API REST, debe solicitar a Provet Cloud Support que le genere una plantilla de integración

    • Provet Cloud API soporta dos tipos de concesión: Código de Autorización y Credenciales de Cliente.

      • El Código de Autorización se utiliza para autenticar interfaces de usuario y casos en los que los usuarios acceden a la API como ellos mismos. PKCE es compatible y muy recomendable. Los clientes públicos DEBEN usar PKCE.

      • Las credenciales de cliente se utilizan para la conectividad backend en la que los servicios se comunican directamente con otros sin ninguna acción del usuario.

  • Se puede acceder a la API REST utilizando una URL compilada como sigue: https://<provet_environment>/<provet_id>/api/0.1/

    • <provet_environment> La URL difiere un poco para cada entorno. Puede ser, por ejemplo

      • provetcloud.com para el medio ambiente de la UE

      • us.provetcloud.com para el entorno de EE.UU.

    • En la URL <provet_id> es el id único de la instancia Provet Cloud para su empresa

    • La URL completa se muestra siempre en la configuración de la API en Provet Cloud Configuración > Integraciones > Acceso a la API abierta.

Provet Cloud REST API es navegable, lo que debería permitir una buena posibilidad para que los desarrolladores evalúen las posibilidades de transferencia de datos.

Catálogo de integración en Provet Cloud

Una vez creada la plantilla, la integración se puede ver en el catálogo de integraciones en Provet Cloud: Ajustes > Integraciones > Acceso API abierto > Añadir aplicación. El catálogo enumera las integraciones disponibles y tiene una breve descripción de lo que hace cada integración. Si la integración tiene más instrucciones de configuración, que se muestra en el catálogo también.

9947060702108-mceclip0.png

Las integraciones pueden tener una visibilidad restringida: pueden estar restringidas sólo a determinados inquilinos de Provet Cloud o en determinados países. El tercero que proporciona la integración puede elegir la amplitud con la que la integración debe ser visible en los inquilinos. Cuando hay restricciones, la aplicación se muestra en el Catálogo de Integración sólo en aquellos inquilinos / en aquellos países en los que está permitida.

Opciones en el registro de un nuevo cliente

Cada vez que un nuevo cliente se registra para utilizar una integración, es decir, la elige del catálogo de integraciones en Provet Cloud (Añadir aplicación), se envían credenciales de cliente únicas al proveedor de la integración. Hay dos opciones para notificar el registro de un nuevo cliente que se pueden elegir al crear una plantilla de integración:

  • correo electrónico

  • URL de conexión

Cuando la integración se utiliza sólo en una instancia de Provet Cloud, el correo electrónico es una buena opción: entonces la persona que recibe el correo electrónico puede configurar los detalles de autenticación a la integración y empezar a usarlo. Por otro lado, cuando la integración se utiliza ampliamente, se recomienda la URL de conexión y la automatización de la adición de un nuevo cliente.

Hookup URL está a la escucha de cualquier notificación automatizada de nuevos clientes. Cuando un nuevo cliente añade la integración en Provet Cloud, la herramienta de orquestación envía automáticamente un mensaje JSON a esa URL dada. No hay necesidad de ninguna interacción humana, cuando la integración analiza automáticamente el nuevo cliente desde el mensaje JSON y añade sus credenciales a su tabla de clientes.

Esquema JSON de los datos enviados para los nuevos registros de integración:

{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"required": [
     "provet_id",
     "client_id",
     "client_secret",
     "algorithm",
     "authorization_grant_type",
     "client_type",
     "redirect_uris",
     "token_url",
     "authorize_url",
     "openid_autodiscovery_url"
],
"properties": {
     "provet_id": {
          "type": "number",
          "description": "Provet ID of the tenant who added this integration."
     },
     "client_id": {
          "type": "string"
     },
     "client_secret": {
          "type": ["null", "string"]
     },
     "algorithm": {
           "type": ["null", "string"],
           "description": "Signing algorithm used.",
           "examples": [null, "HS256", "RS256"]
     },
     "authorization_grant_type": {
           "type": "string",
           "description": "Authorization flow used.",
           "examples": ["authorization-code", "client-credentials"]
     },
     "client_type": {
           "type": "string",
           "description": "Client type.",
           "examples": ["confidential", "public"]
     },
     "redirect_uris": {
           "type": "string",
           "description": "Space-separated list of callback URIs.",
           "examples": ["https://example.com/callback"]
     },
     "token_url": {
            "type": "string",
            "description": "OAuth2.0 token endpoint URL."
     },
     "authorize_url": {
            "type": "string",
            "description": "OAuth2.0 authorize endpoint URL."
     },
     "openid_autodiscovery_url": {
            "type": ["null", "string"],
             "description": "OpenID autodiscovery URL. Null if integration does not use OpenID."
     }
 }
}

Datos disponibles a través de la API REST

La API REST puede utilizarse para leer la mayoría de los datos y crear/actualizar algunas partes seleccionadas de los mismos. La primera página de la API navegable enumera todos los objetos a los que se puede acceder. Aquí está la lista de los objetos más comunes.

Genérico

Nombre

C

U

D

Descripción

Punto final

Campo personalizado

Campos personalizados definidos en la configuración; pueden utilizarse en pacientes y clientes, por ejemplo

campos_personalizados

Valor del campo personalizado

Si se utilizan campos personalizados en un paciente X, generarán una fila aquí

valores_campo_personalizados

Nota

Notas que residen en la sección "Notas & Comunicación" en la página del paciente/cliente

nota

noteadmin

Tarea

Tareas para veterinarios

tarea

Recordatorio

Recordatorios para los pacientes

recordatorio

Plantilla de recordatorio

Plantilla para crear recordatorios

remindertemplate

Cliente & Paciente

Nombre

C

U

D

Descripción

Punto final

Cliente

Cliente para paciente

cliente

Paciente

Paciente

paciente

Número de teléfono

Números de teléfono de los clientes

número de teléfono

Historia importada

Permite importar el historial del paciente desde sistemas antiguos en un formato específico

historia importada

Facturación

Nombre

C

U

D

Descripción

Punto final

Factura

Facturas para clientes

factura

Fila de facturas

Líneas de facturas

invoicerow

Pago de facturas

Pagos de facturas

pago de facturas

Pago anticipado

Pago anticipado (también conocido como pagos no asignados) a clientes. Puede utilizarse para pagar una factura futura.

pago no asignado

Forma de pago

Métodos de pago disponibles en el sistema

método de pago

Reclamación al seguro

Reclamaciones de seguros para pacientes

reclamación de seguros

Cliente de reclamaciones de seguros

Cliente ficticio copiado de los datos del cliente para la reclamación al seguro

reclamación de seguroscliente

Paciente que reclama un seguro

Paciente ficticio copiado de los datos del paciente para la reclamación al seguro

insurreclaimpatient

Organización

Nombre

C

U

D

Descripción

Punto final

Ubicación de la clínica

Clínicas

ubicación de la clínica

Grupo de ubicación de la clínica

Grupo de clínicas

ubicación de la clínicagrupo

Usuario

Cuenta de usuario de provet cloud

usuario

Datos del usuario

Información adicional sobre el usuario

detalles de usuario

Grupo de usuarios

Grupo de trabajo Usuarios, relativo al acceso de los usuarios

grupo de usuarios

Lista de artículos

La lista de artículos contiene un número X de artículos. Las clínicas están suscritas a una lista de artículos y la utilizarán en las consultas y las preventas.

lista de artículos

Artículo

Elementos en entornos. Un modelo general ampliable para todos los elementos. Contiene subtipos: Procedimiento, Medicina, Suministro, Alimentación, Análisis de laboratorio, Panel de análisis de laboratorio

Artículo

procedimiento

medicina

suministro

alimentos

análisis de laboratorio

laboratorioanálisispanel

Grupo de artículos

También conocido como grupo de facturas. Los artículos se pueden agrupar por información de subgrupo que se puede filtrar en algunas búsquedas

itemsubgrupo

grupo de facturación

Grupo IVA

Grupos de IVA de la organización

vatgroup

Plantilla de texto

Plantillas de texto personalizadas para utilizar en ProvetCloud, por ejemplo, notas de consulta e instrucciones de alta

plantilla_texto

Plantilla de artículos

Plantillas de elementos en la configuración.Describe un conjunto de elementos

itemtemplate

Elemento plantilla elemento

Un elemento, o plantilla de elementos en la plantilla de elementos de configuración

itemtemplateitem

Precios alternativos

Opciones de precios alternativas para los artículos, por ejemplo, permitir la venta al por mayor más barata a partir de cierta cantidad.

precios alternativos

Listas

Listas personalizadas en los ajustes para, por ejemplo, especies y razas

lista

Lista de artículos

Un elemento de las listas personalizadas en la configuración

listitem

Codelistas

Una forma más cómoda de ver los elementos de la lista. Contiene sólo los elementos activos de la lista, pero puede enumerar códigos que no proceden de la base de datos, como los códigos VeNom, por ejemplo.

lista de códigos

Número de plaza

En relación con las características de los animales de producción; una información numérica para el lugar de retención del paciente

holdplacen numbers

Stock

Nombre

C

U

D

Descripción

Punto final

Nivel

Todos los artículos de stock y sus niveles

stock/artículo

nivel de existencias

Ubicación

Ubicación de las acciones

existencias/ubicación

Lote

Lotes de stock para artículos de stock

stock/lote

Entrada

Entradas de stock (utilizaciones) para artículos de stock

stock/entrada

Mayorista

Mayoristas para hacer pedidos

mayorista

Pida

Pedido de productos al mayorista

pedir

Pedir artículo

Artículo en el pedido del producto

elemento de pedido

Diagnóstico por imagen

Nombre

C

U

D

Descripción

Punto final

Lista de trabajo

Entradas en la lista de trabajo para derivaciones de diagnóstico por imagen

diagnosticimaging_worklist

Modalidad

Modalidad de diagnóstico por imagen

modalidad

Categoría

Categoría de diagnóstico por imagen

categoría de imágenes

Subcategoría

Subcategoría para categorías de diagnóstico por imagen

subcategoría de imágenes

Área objetivo

Área objetivo de la modalidad

área de destino

Recursos

Recursos para el diagnóstico por imagen

recurso

Consulta

Nombre

C

U

D

Descripción

Punto final

Consulta

Consulta para el cliente y el/los paciente(s)

consulta

Artículo

Elemento base para los elementos añadidos a la consulta. Contiene subtipos: Procedimiento, Medicamento, Suministro, Alimentación, Análisis de laboratorio

punto de consulta

elementos_de_consulta/procedimiento

artículos_consulta/medicina

consulta_artículos/suministros

consulta_artículos/alimentos

elementos_de_consulta/análisis

Plan de tratamiento

Plan de tratamiento que contiene información sobre los elementos que se utilizarán en el futuro

plan de tratamiento

Punto del plan de tratamiento

Punto del plan de tratamiento.

plan de tratamientoprocedimiento

tratamientoplanmedicina

treatmentplansupply

plan de tratamientoalimentación

Estimación

Estimación para consulta

estimación

Partida estimada

Partida añadida para presupuesto de consulta

elemento de estimación

Plantilla de artículos

Plantillas de artículos (también conocidas como paquetes de consulta) que se han añadido a una consulta

formulario de consulta

Laboratorio de referencia

Derivación (también conocida como solicitud) de consulta

consulta_laboratorio_remisión

Muestra de laboratorio

Una muestra con análisis de consulta y paneles de consulta

muestra_consulta

Derivación para diagnóstico por imagen

Derivación (también conocida como solicitud) de consulta

remisión_diagnóstico_imagen

Área de diagnóstico por imagen

Área objetivo utilizada durante la consulta

área_objetivo_de_la_consulta

Programación

Nombre

C

U

D

Descripción

Punto final

Cita previa

Citas para pacientes. También conocido como Evento de programación de citas

cita

Turno

Turnos para los usuarios

turno

Tipo de turno

Tipos de turnos definidos en los ajustes

tipo de cambio

Razón

Motivo del nombramiento

motivo

Grupo de motivos

Los grupos de motivos pueden ser específicos de la ubicación de la clínica. Se utilizan para agrupar motivos en las búsquedas

grupo_motivo

Motivo de la cancelación

motivo de la anulación

Triaje

Una instancia que contiene información sobre los eventos de triaje

triaje

Categoría de triaje

Categorías para el triaje en entornos

categoría_triage

Entrada de triaje

Un evento en triaje

entrada_triage

Disponibilidad de veterinarios

Devuelve los turnos disponibles para veterinarios en el periodo de tiempo determinado

veterinarios_disponibilidad

Cliente de reservas en línea

Cliente ficticio creado para la cita de reserva en línea

onlinebookingclient

Paciente de reserva en línea

Paciente ficticio creado para cita de reserva en línea

onlinebookingpaciente

Permisos

Cuando se añade una nueva aplicación de integración a Provet Cloud, se crea automáticamente un usuario virtual para esa integración. El usuario virtual se llama Integración <Nombre de integración> y se puede encontrar en la configuración de usuario de Provet Cloud en la pestaña Virtual. El usuario virtual se asigna por defecto al grupo de permisos Usuarios.

Si la integración necesita permisos diferentes (se deniegan algunos puntos finales o desea restringir los permisos), recomendamos crear un nuevo grupo de permisos sólo para ese usuario virtual:

  1. Copie un grupo de permisos existente o cree uno nuevo y cámbiele el nombre por uno descriptivo, por ejemplo, el mismo que el de la integración.

  2. Conceda al grupo los permisos necesarios. Compruebe en Provet Cloud API schema, qué permisos necesita cada endpoint. Compruebe también Gestión de permisos de usuario y grupos.

  3. Edite el usuario virtual y añádalo al nuevo grupo de permisos (campo Grupo de permisos predeterminado). El usuario tampoco tiene un rol Work por lo que también debes elegirlo. Técnico es el rol destinado a usuarios virtuales como el usuario de la integración.

Ejemplo de uso

Para obtener información sobre una consulta con el número de identificación 338, se enviaría una solicitud HTTP GET con los parámetros de autenticación a la siguiente URL: https://provetcloud.com/<provet_id>/api/0.1/consultation/338/

Ejemplo de respuesta:

{
    "url": "https://provetcloud.com/<provet_id>/api/0.1/consultation/338/",
    "client": "https://provetcloud.com/<provet_id>/api/0.1/client/1/",
    "patients": [
        "https://provetcloud.com/<provet_id>/api/0.1/patient/1/"
    ],
    "complaint": "Test consultation",
    "admitted_time": "2017-05-18T10:35:00Z",
    "first_entry": null,
    "started": "2017-05-18T10:35:00Z",
    "finished": null,
    "ended": null,
    "status": 8,
    "type": 0,
    "invoice": "https://provetcloud.com/api/<provet_id>/0.1/invoice/609/",
    "supervising_veterinarian": "https://provetcloud.com/api/<provet_id>/0.1/user/1/",
    "clinic location": "https://provetcloud.com/<provet_id>/api/0.1/clinic location/1/",
    "consultation_items": [
        "https://provetcloud.com/<provet_id>/api/0.1/consultationitem/4558/",
        "https://provetcloud.com/<provet_id>/api/0.1/consultationitem/4559/",
        "https://provetcloud.com/<provet_id>/api/0.1/consultationitem/4560/"
    ],
    "reporting_dimension_1": null,
    "reporting_dimension_2": null
}

A partir de la respuesta es posible encontrar el ID de la factura relacionada con esta consulta, así como todas las demás entidades relacionadas con esta consulta. Estas pueden obtenerse mediante otras llamadas a la API REST.

Filtros

Algunos endpoints tienen campos que se pueden utilizar para filtrar los resultados. Los campos filtrables se pueden ver en la parte superior de la página del punto final de la API REST de Provet Cloud (por ejemplo, https://provetcloud.com/<provet_id>/api/0.1/consultation/) si el punto final tiene campos filtrables.

Los siguientes métodos están disponibles para filtrar (los sinónimos están separados por comas):

  • es, eq (igual)

  • is_not, not_eq, neq (no igual)

  • lt (menos de)

  • lte (menor o igual)

  • gt (mayor que)

  • gte (mayor o igual)

  • range (valores entre, necesita dos valores en orden [de,a])

  • not_in_range (arriba invertido)

  • contiene (el texto contiene el texto buscado, distingue entre mayúsculas y minúsculas)

  • contiene_no (arriba invertido)

  • icontains (el texto contiene el texto buscado, sin distinción entre mayúsculas y minúsculas)

  • icontains_not (arriba invertido)

  • in (el elemento se encuentra en la lista dada [valor1,valor2,valor3])

  • not_in (arriba invertido)

  • is_null (verdadero o falso)

Los métodos de filtrado pueden utilizarse con parámetros de consulta utilizando las siguientes sintaxis:

[campo]__[método]=valor (ej. cliente__es=10 que utiliza el id del cliente para la búsqueda)

[campo].[propiedad]__[método]=valor (ej. cliente.id__es=10)

Tenga en cuenta que las fechas deben indicarse para los parámetros de consulta en el formato AAAA-MM-DD hh:mm+[TimeZone]hh:mm (eg. 2017-12-24 15:30+00:00) .

Si necesitamos encontrar todas las consultas con las condiciones

  • la denuncia contiene la palabra "vacc" (no distingue mayúsculas de minúsculas)

  • la hora_de_admisión está comprendida entre 2017-12-01 00:00+00:00 (mayor o igual que) y 2018-01-01 00:00+00:00 (menor que)

  • el identificador de la clínica es 1

  • id de cliente es 10

  • la identificación de uno de los pacientes en la consulta es 20

utilizaríamos la siguiente url:

https://provetcloud.com/<provet_id>/api/0.1/consultation/?complaint__icontains=vacc&admitted_time__gte=2017-12-01 00:00%2B00:00&admitted_time__lt=2018-01-01 00:00%2B00:00&clinic location__is=1&client__is=10&patients__is=20

Tenga en cuenta que los signos "+" están codificados en la URL (%2B) en el ejemplo anterior para que la URL funcione.

Si necesitamos encontrar todas las consultas en las que

  • el nombre del cliente es John y

  • el cliente se apellida Doe

utilizaríamos la siguiente URL:

https://provetcloud.com/ <provet_id>/api/0.1/consultation/?client.firstname__is=John&client.lastname__is=Doe

Exponga

Algunos endpoints tienen campos que pueden ser expuestos, que entonces mostrarán algunos de los campos internos del objeto expuesto. Los campos expuestos se pueden ver en la parte superior de la página del punto final de la API REST de Provet Cloud (por ejemplo, https://provetcloud.com/<provet_id>/api/0.1/invoicerow/) si el punto final tiene campos expuestos. Para exponer un campo, puede añadir ?expose_<field_name> en la URL, del mismo modo que se utilizan los filtros.

Liberar una integración

Cuando haya desarrollado y probado su integración y desee lanzarla al uso público, póngase en contacto con el soporte de Provet Cloud para que su Plantilla de Integración sea visible para todas las instancias de Provet Cloud. Si su integración no es específica del cliente y está destinada a ser utilizada en muchas instancias de Provet Cloud por muchos usuarios, hay algunos requisitos que deben cumplirse antes de salir al mercado. Estos requisitos están destinados a facilitar la integración y proporcionar la información necesaria para el soporte de Provet Cloud.

  1. Cree un breve vídeo sobre su integración: cómo utilizarla y qué hace.

  2. Cree una instrucción de incorporación que contenga todos los pasos manuales necesarios para que el usuario de Provet Cloud utilice su integración. Los pasos también pueden incluir las acciones necesarias en su sistema.

  3. Facilítenos tanto el vídeo como la guía de incorporación y díganos en qué mercados/países debería ser visible su integración.

Actualización

¿Fue útil este artículo?

Usuarios a los que les pareció útil: 1 de 1

¿Tiene más preguntas? Enviar una solicitud

Comentarios

0 comentarios

Inicie sesión para dejar un comentario.