Sistema de salud (HIS/EHR)

La sección "Sistema de salud" (dentro del grupo "Integraciones" del sidebar de Quralo One) te permite conectar Quralo con el sistema de salud de tu organización —un HIS, EHR u otro— para que los servicios de Quralo (add-ons) puedan consumir sus datos clínicos.

"Esta integración permite que Quralo se autentique contra la API FHIR R4 de tu sistema de salud (HIS, EHR u otro) y consuma sus datos cuando los servicios de Quralo (add-ons) lo requieran. La autenticación usa el estándar SMART Backend Services (OAuth 2.0 Client Credentials con firma Private Key JWT, algoritmos RS384 o ES384)."

Esta documentación está pensada para el personal técnico de tu organización: la persona que configura y administra la integración de Quralo con su sistema de salud.

Qué es y qué hace

Quralo se autentica contra la API FHIR R4 de tu sistema de salud y consume sus datos cuando los add-ons de Quralo lo necesitan. Por ejemplo, si un add-on requiere leer datos demográficos de un paciente, resultados de laboratorio o prescripciones, Quralo obtiene un token de acceso (OAuth 2.0) y consulta esos recursos en tu sistema.

Dirección de la integración

Es una integración saliente: Quralo es el cliente de la API externa. No la confundas con API Connect, que va en la dirección contraria (sistemas externos consumiendo la API de Quralo).

Integración	Dirección	Quralo actúa como
Sistema de salud (esta sección)	Quralo → sistema externo	Cliente de la API FHIR R4 del HIS/EHR
API Connect	Sistema externo → Quralo	Servidor de la API

Cómo funciona en resumen

1. En Quralo One creás la integración y el sistema genera automáticamente un par de claves (pública/privada).
2. Registrás la clave pública (JWK) en tu sistema de salud como un cliente de API (SMART Backend Services). Ese sistema te devuelve un Client ID.
3. Completás el Client ID en Quralo y verificás la conexión con el botón "Probar conexión".
4. A partir de ahí, Quralo solicita tokens OAuth 2.0 y consume datos de la API FHIR R4 según los scopes que configures.

Puntos clave

• Una única integración por organización. No se configuran varias: el flujo es por organización, no por sistema.
• La clave privada nunca sale del servidor de Quralo. Solo se muestra y descarga la clave pública (JWK), que es la que registrás en el sistema externo.
• HTTPS obligatorio en producción. Quralo solo acepta http en entornos de desarrollo (para servidores FHIR locales).
• Monitoreo automático. Quralo verifica la conexión periódicamente y te avisa por email (solo en transiciones de estado) si se cae o se restablece.
• Los add-ons necesitan scopes. Cada add-on de Quralo indica qué scopes SMART necesita; la integración debe incluir esos permisos para que pueda operar.

Requisitos del sistema externo (resumen)

Para que la integración funcione, tu sistema de salud debe:

1. Exponer una API FHIR R4 (la verificación exige fhirVersion == 4.0.1 en /metadata).
2. Tener un token endpoint OAuth 2.0 que acepte grant_type=client_credentials con Private Key JWT (y, idealmente, exponga .well-known/smart-configuration para auto-descubrimiento).
3. Permitir registrar un cliente M2M pegando un JWK (clave pública) y devolver un client_id.
4. Soportar los algoritmos de firma RS384 (RSA) o ES384 (EC P-384) — SMART Backend Services exige uno de estos dos.
5. Permitir allowlist de IPs de salida de Quralo (si aplica).
6. Conceder scopes SMART de tipo system/....

El detalle completo está en Configuración → Requisitos del sistema externo.

Conceptos necesarios

Si querés entender en profundidad cómo funciona la autenticación (OAuth 2.0, Client Credentials, Private Key JWT, SMART Backend Services) y qué es FHIR R4, visitá la sección Conceptos. Te va a servir tanto para configurar como para explicarle a tu sistema externo exactamente qué necesita.

Guía rápida de secciones

• Conceptos — OAuth 2.0, Client Credentials, Private Key JWT, SMART Backend Services y FHIR R4 explicados.
• Configuración — Requisitos del sistema externo y el flujo paso a paso (exacto a la UI).
• Scopes — Catálogo de scopes SMART disponibles.
• Verificación y monitoreo — Estados, "Probar conexión", monitoreo automático y emails.
• Gestión de claves — Regeneración, rotación y eliminación de la integración.
• Solución de problemas — Errores típicos y qué hacer.