En resumen
Luna Labs incluye un servidor TCP que escucha mensajes ASTM E1394 (puerto 9100 por defecto). Registras cada analizador con su identificador, mapeas los códigos del equipo a tu catálogo, y los resultados llegan al expediente de la orden — ya estructurados, con sello de tiempo y trazabilidad completa.
Cómo funciona
El flujo de un resultado desde el analizador hasta el expediente es:
- El analizador termina de medir una muestra y emite un mensaje ASTM E1394 por TCP.
- El puente de Luna Labs recibe el mensaje, valida los checksums y reconstruye los frames.
- El sistema identifica al remitente (el senderId del mensaje) y verifica que sea un instrumento registrado y activo.
- Identifica la orden por folio (que el analizador transmite junto con la muestra).
- Para cada código de prueba en el mensaje, busca el mapeo al catálogo de Luna Labs.
- Verifica que el analito esté efectivamente solicitado en la orden.
- Guarda el resultado con
source="instrument", sello de tiempo y referencia al mensaje original.
Registrar un instrumento
- 1
Abre Instrumentos
En el menú lateral, ve a Instrumentos. Es exclusivo del responsable.
- 2
Nuevo instrumento
Captura: nombre (ejemplo: "Cobas c311 - Mostrador"), fabricante, modelo, senderId (el identificador que el equipo enviará en el header del mensaje ASTM — viene en el manual del fabricante).
- 3
Actívalo
Solo los instrumentos activos pueden enviar resultados. Para retirar uno temporalmente, lo desactivas — los mensajes que llegan se registran como
unknown_sender.
Mapeo de códigos
Cada analizador usa sus propios códigos para los analitos. Tu Cobas puede llamar GLU2 a la glucosa; tu catálogo la llama GLU. El mapeo traduce.
Desde el detalle del instrumento, pestaña Mapeos:
- Haz clic en Nuevo mapeo.
- Captura el código del instrumento (tal como aparece en el mensaje ASTM, ejemplo:
GLU2). - Selecciona el analito del catálogo (
GLU - Glucosa). - Guarda.
Repítelo para cada analito que el instrumento reporta. Los códigos sin mapeo configurado serán rechazados con estado no_mapping y aparecerán en la pestaña de Mensajes para que los configures.
no_mapping exponiendo todos los códigos del equipo. Mapeas a partir de la lista real, no del manual.Configurar el analizador para enviar a Luna Labs
Esto depende del fabricante. En general, en el menú de comunicaciones del equipo configuras:
- Modo: bidireccional o solo envío (host).
- Protocolo: ASTM E1394 (también llamado ASTM low-level o LIS-01).
- Dirección IP: la del servidor Luna Labs (te la damos al activar la integración).
- Puerto: 9100 (configurable).
- Sender ID: el identificador único que registraste arriba.
Algunos analizadores comunes que probamos: Roche Cobas, Mindray BS, Sysmex XN, Snibe Maglumi, Tosoh AIA, Awareness ELISA washers/readers. Si tu equipo habla ASTM, debería funcionar.
Pestaña de mensajes
Cada mensaje recibido aparece en Instrumentos › [tu equipo] › Mensajes. Auto-refresca cada 5 segundos. Para cada mensaje verás:
- Fecha y hora de recepción.
- Estado de la ingestión (ver tabla más abajo).
- Folio identificado (si lo hubo).
- Lista de analitos: aceptados, rechazados (sin mapeo, sin orden, etc.).
- El mensaje crudo ASTM (útil para diagnóstico).
Estados de ingestión
| Estado | Significado |
|---|---|
accepted | Todos los analitos se mapearon, todos estaban solicitados, todo se guardó. |
partial | Algunos aceptados, algunos rechazados. El detalle muestra cuáles. |
no_order | El folio que el instrumento transmitió no existe en Luna Labs. |
no_mapping | El instrumento está registrado pero no tiene ningún mapeo configurado. |
unknown_sender | El senderId del mensaje no corresponde a ningún instrumento activo. |
error | Falla de protocolo: checksum, frame mal formado, etc. |
Diagnóstico de problemas comunes
El analizador envía pero los mensajes no llegan
- Verifica la IP y puerto del equipo. Haz ping desde el analizador (si tiene esa opción).
- Confirma que el puente esté activo: en Instrumentos verás el indicador "Puente activo · Puerto 9100".
- Verifica firewall en la red del laboratorio.
Llegan pero todos en estado no_order
El analizador no está enviando el folio correcto. Verifica cómo se programa la lista de trabajo (worklist) en tu equipo — debe usar el folio de Luna Labs exactamente (incluyendo el guion: 2026-0481).
Llegan pero todos en estado no_mapping
Aún no has configurado mapeos. Abre el mensaje, copia los códigos que vienen y créalos en la pestaña de Mapeos.
Mensajes con estado error
Problema de protocolo. Comparte el mensaje crudo con nosotros — la pestaña incluye un botón "Copiar mensaje". Lo revisamos y te decimos si es del lado del equipo o del puente.