En resumen
Luna Salud envía órdenes de laboratorio a Luna Labs por webhook. Cuando el responsable libera los resultados, Luna Labs los devuelve al expediente del paciente automáticamente. La configuración requiere una API key compartida y que los códigos de estudio coincidan entre ambos sistemas.
Qué es la integración
Si tu clínica usa Luna Salud como expediente médico electrónico (EMR), puedes conectarlo con Luna Labs para eliminar la doble captura:
- El médico solicita estudios desde Luna Salud → la orden se crea automáticamente en Luna Labs.
- El responsable libera los resultados en Luna Labs → los resultados aparecen en el expediente del paciente en Luna Salud.
Sin la integración, el responsable tendría que copiar manualmente los datos del paciente y los estudios solicitados al crear cada orden.
Cómo funciona
La comunicación entre ambos sistemas usa webhooks — llamadas HTTP automáticas que se disparan cuando ocurre un evento:
- Luna Salud → Luna Labs: cuando el médico solicita estudios de laboratorio, Luna Salud envía un webhook con los datos del paciente (nombre, edad, sexo) y la lista de estudios solicitados. Luna Labs crea la orden automáticamente.
- Luna Labs → Luna Salud: cuando el responsable libera los resultados, Luna Labs envía un callback con el folio, los valores y el PDF del reporte. Luna Salud los adjunta al expediente.
Configurar la conexión
-
1
Obtén la API key de Luna Labs
Contacta al equipo de Luna Labs para obtener tu API key de integración. Esta clave se usa para autenticar las llamadas entre ambos sistemas. Se configura como la variable de entorno
LUNA_HEALTH_API_KEY. -
2
Configura el webhook en Luna Salud
En Luna Salud, ve a Configuración › Integraciones › Laboratorio. Ingresa la URL de tu instancia de Luna Labs y la API key. Luna Salud hará una prueba de conexión automática.
-
3
Configura el callback en Luna Labs
Luna Labs necesita saber a dónde enviar los resultados. La URL de callback de Luna Salud se configura durante el setup inicial. Confirma que la URL sea accesible desde tu servidor.
Mapeo de estudios
Para que la integración funcione, los códigos de estudio deben coincidir entre Luna Salud y Luna Labs. Por ejemplo, si Luna Salud solicita "GLU" (glucosa), Luna Labs debe tener un analito con ese mismo código en su catálogo.
Verifica tu catálogo de analitos:
- Abre Catálogo › Analitos en Luna Labs.
- Compara los códigos con los que usa Luna Salud.
- Si hay diferencias, actualiza los códigos en el catálogo de Luna Labs para que coincidan.
Probar la integración
-
1
Envía una orden de prueba desde Luna Salud
En Luna Salud, crea una consulta de prueba y solicita un estudio de laboratorio (por ejemplo, glucosa). La orden debería aparecer en Luna Labs en segundos.
-
2
Verifica la orden en Luna Labs
Abre Órdenes en Luna Labs. Deberías ver la orden creada automáticamente con los datos del paciente y los estudios solicitados. El origen mostrará "Luna Salud".
-
3
Completa el ciclo
Recibe la muestra, captura resultados como analista, revisa y libera como responsable. Al liberar, verifica que los resultados aparezcan en el expediente del paciente en Luna Salud.
Solución de errores
| Error | Causa probable | Solución |
|---|---|---|
| 401 Unauthorized | API key incorrecta o no configurada | Verifica que LUNA_HEALTH_API_KEY coincida en ambos sistemas |
| La orden no aparece en Luna Labs | Webhook no configurado o URL incorrecta | Revisa la configuración del webhook en Luna Salud. Confirma que la URL es accesible |
| Estudio "no encontrado" | Código de estudio no coincide | Actualiza el código en el catálogo de Luna Labs para que coincida con Luna Salud |
| Resultados no llegan a Luna Salud | URL de callback incorrecta o servicio caído | Verifica la URL de callback. Revisa la bitácora de Luna Labs para ver si hubo error en el envío |
| Timeout en la conexión | Red o firewall bloqueando la comunicación | Confirma que ambos servidores pueden comunicarse. Revisa reglas de firewall |