Módulo de Vinculación de Contexto Externo (ECL)

El módulo ECL permite que sistemas externos —como un HIS (Health Information System) u otros integradores— adjunten un bloque de información contextual personalizada al interactuar con Quralo. Este contexto se almacena temporalmente y se devuelve intacto junto con la respuesta o en futuras interacciones.

¿Qué es el "contexto externo"?

El "contexto externo" es cualquier paquete de datos (identificador, metadatos, referencias internas del HIS, etc.) que el sistema externo necesita mantener a lo largo de una transacción, acción del usuario o evento. Quralo actúa como un "contenedor sellado", transportando este contexto sin conocer ni depender de su estructura o propósito.

Formato requerido para el contexto externo

El contenido de contexto debe estar en formato JSON y contener los siguientes datos:

{
  "t": "{ ehr | }", // Tipo de dato (por ejemplo, 'ehr')
  "p": { // Datos de la persona
    "ln": "Apellido", // Lastname
    "fn": "Nombre", // Firstname
    "sx": "Sexo", // Sex
    "db": "Fecha de nacimiento", // Date of birth
    "it": "{ national_id: DNI | passport: Pasaporte | cuit: CUIT | cdi: CDI }", // Person ID type
    "in": "Número de identificación", // Person ID number
    "em": "Email", // Email address
    "pn": "Número de teléfono" // Phone number
  },
  "a": { // Datos del autor
    "it": "Tipo de identificación", // Author ID type
    "in": "Número de identificación" // Author ID number
  },
  "m": { /* ... */ } // Objeto de metadatos para información adicional personalizada
}

El campo m (metadata) es el espacio donde pueden incluir toda la información adicional que deseen asociar a su sistema externo, permitiendo mantener el contexto durante toda la actividad a realizar. Este campo es completamente libre y puede contener cualquier estructura de datos que necesiten para su integración.

Casos de uso

• Integraciones con sistemas clínicos (HIS) que requieren que se les devuelva información propia para mantener la coherencia de estado y contextualización de la acción del usuario.
• Escenarios donde Quralo actúa como proxy o middleware, sin lógica de negocio propia sobre el contexto.
• Mejora la interoperabilidad asimétrica, permitiendo que el sistema externo mantenga su lógica y control sin imponerla a Quralo.

Consideraciones

• El contenido del contexto no se valida ni se interpreta: es responsabilidad del sistema externo asegurar su integridad y uso adecuado.
• Si el contexto contiene datos sensibles o identificadores, considerar las implicancias en auditoría, cumplimiento y privacidad según las políticas vigentes.

Activación y uso

Para utilizar el módulo ECL:

1. Activa la funcionalidad desde la sección ECL del dashboard de Quralo Negocios.
2. Utiliza el SDK de Quralo para generar un código QR que será escaneado por los médicos utilizando la app de Quralo Médicos.

Nota: Si necesitas ayuda para activar ECL, consulta la guía de activación.

SDKs disponibles

Selecciona el SDK para tu lenguaje preferido. Actualmente solo el SDK de PHP 5.6 está disponible:

PHP 5.6

PHP 8.x

Próximamente

Python

Próximamente

JavaScript

Próximamente

Java

Próximamente

Badges de Quralo QR

Utiliza los siguientes badges para indicar la disponibilidad de un código QR de Quralo en tu sistema. Al presionarlos, se mostrará el código QR para escanear. Puedes descargar cada badge en formato PNG o SVG:

Preview	Nombre	Descargar
	Color	SVG | PNG
	Light	SVG | PNG
	Negro	SVG | PNG

Tip: Puedes integrar estos badges en tu sistema para mejorar la experiencia de interoperabilidad.

---

Más información

• Guía de activación
• Ejemplo de integración
• Preguntas frecuentes