Guía de NABIDH Parte 6: Códigos de error y estados de entrega de NABIDH

Cuando una entrega de NABIDH no tiene éxito, Pabau te dice tres cosas: en qué etapa falló, qué campo lo causó y qué hacer al respecto. Este artículo es la referencia completa para las tres cosas — escrito para que un gerente de clínica pueda encontrar la solución, y para que un lector técnico pueda relacionar cada código con la especificación de la DHA.

Este artículo forma parte de la serie de guías de NABIDH:

• Parte 1: Qué es NABIDH y cómo se conecta Pabau a él
• Parte 2: Conectar Pabau a NABIDH
• Parte 3: Mapea tus datos para NABIDH
• Parte 4: Elige qué eventos se envían a NABIDH
• Parte 5: Prueba, supervisa y soluciona problemas de las entregas de NABIDH
• Parte 6: Códigos de error y estados de entrega de NABIDH (estás aquí)
• Parte 7: Referencia de tablas de códigos de NABIDH

De dónde vienen los errores

Un mensaje de NABIDH pasa por tres puntos de control. Saber cuál lo detuvo te dice quién puede solucionarlo.

NOTA: Una entrega puede pasar la comprobación previa y aun así ser rechazada por NABIDH, porque NABIDH aplica algunas reglas que Pabau no puede ver (por ejemplo, si un ID de proveedor Sheryan está realmente registrado en tu centro). Siempre lee la respuesta propia de NABIDH en la entrega, no solo los hallazgos de la comprobación previa.

Estados de entrega

Cada fila en la pestaña Logs tiene uno de seis estados.

Clases de error

Cada entrega fallida también se etiqueta con una clase de error, mostrada como una insignia de color. La clase decide si Pabau reintenta por sí solo.

La escalera de reintentos

Los fallos reintentables se espacian exponencialmente, empezando en 30 segundos y duplicándose cada vez. Una entrega tiene 8 intentos en total, repartidos en aproximadamente una hora.

NOTA: Los reintentos están limitados a 6 horas de separación, pero con 8 intentos ese límite nunca se alcanza en la práctica — el intervalo real más largo es de 32 minutos. Una entrega en carta muerta no se pierde: corrige la causa y pulsa Reintentar para reproducirla.

Cómo leer un acuse de recibo de NABIDH

Un endpoint de producción de NABIDH responde con un mensaje de acuse de recibo HL7. La parte importante es el segmento MSA.

Cuando la respuesta es AE o AR, dos campos más aportan el detalle:

• ERR-5 — el código de error de la aplicación. 5001 es el error de validación genérico de NABIDH.
• ERR-7 — un diagnóstico legible que indica qué salió mal.

El campo MSA-2 repite el ID de control del mensaje que envió Pabau, que es cómo se relaciona una respuesta con su entrega.

Cómo leer una respuesta de la herramienta de prueba de la DHA

La herramienta de prueba HL7 de la DHA utilizada durante la incorporación no responde con un acuse de recibo HL7. Devuelve una frase simple:

Validation : Success — el mensaje pasó.

Validation : PID:16 Marital Id Invalid against NAB002/CodeSystem should be NAB002~PID:30 Pat.DeathInd. Invalid~ — el mensaje fue rechazado, y cada motivo está separado por una virgulilla (~).

Cada motivo sigue la misma estructura:

CONSEJO: Corrige el campo obligatorio nombrado en el primer error antes de perseguir el resto. NABIDH suele reportar errores derivados en campos vecinos cuando un campo obligatorio está vacío, y esos desaparecen por sí solos una vez que se corrige el primero.

Referencia campo por campo: qué puedes corregir

Estos son los hallazgos causados por datos en tu cuenta de Pabau. Cada uno indica el lugar exacto para corregirlo. La columna Referencia de especificación es la sección de la especificación NABIDH Inbound HL7 v2.5.1 de la que proviene la regla — útil cuando hablas con la DHA.

Tarjeta del cliente — identidad y datos demográficos

Abre el cliente y luego Editar cliente.

Tarjeta del cliente — alergias

Abre el cliente → Alergias.

Tarjeta del cliente — problemas / diagnósticos

Abre el cliente → Problemas.

Citas y visitas

Abre la reserva, o su servicio en Configuración → Servicios.

Registros del personal — IDs de proveedor Sheryan

Cada profesional necesita un ID de proveedor Sheryan de 8 dígitos en su registro de equipo.

Prescripciones

Abre la prescripción en el registro del cliente.

Documentos y cartas

Abre el adjunto o la carta en el registro del cliente.

Resultados de laboratorio

Abre la solicitud o el informe de laboratorio en el registro del cliente.

Indicadores de consentimiento y VIP

Determinados por campos personalizados del cliente vinculados en la pestaña Mapeo.

Configuración de la conexión

Estos provienen de la conexión en sí, no de un registro de paciente. Corrígelos en Configuración → Sincronización de datos → Gestionar → Configuración.

Hallazgos que deberías reportar en lugar de corregir

Alrededor de la mitad de las comprobaciones cubren valores que Pabau genera por sí mismo — cabeceras de mensajes, marcas de tiempo, marcadores estructurales. Si alguno de ellos se marca, significa que el generador de mensajes produjo algo inesperado, no que tus datos estén mal. Envía el ID de entrega al soporte de Pabau; no hay nada que cambiar en tu cuenta.

Los campos de esta categoría son:

MSH-1 MSH-2 MSH-3 MSH-5 MSH-6 MSH-7 MSH-10 MSH-12 MSH-18 EVN EVN-1 EVN-2 EVN-6 EVN-7.1 PID PID-1 PID-3.5 PID-5.7 PID-11.7 PID-15 PV1 PV1-2 PV1-7.9 PV1-44 PV1-45 ZSC AL1-1 ORC ORC-1 ORC-9 ORC-12.9 RXE/RXR RXE-2.3 RXR-1.3 RXR-2.3 PRB PRB-1 PRB-2 PRB-9 PRB-14 PRB-16 OBR OBR-1 OBR-7 OBR-25 TXA TXA-1 TXA-5.9 TXA-12 TXA-17 TXA-19 OBX OBX-1 OBX-2 OBX-3.3 OBX-11 OBX-14 MRG MRG-1.1 MRG-1.5 MSH

NOTA: Algunas comprobaciones se encuentran en ambos grupos — por ejemplo PID-3.1 (el número de registro de Pabau del paciente) y PRB-4 deberían estar siempre presentes automáticamente, así que si se marcan, vale la pena reportarlas en lugar de editarlas.

Qué hacer cuando nada más lo explica

1. Abre la entrega en Logs y expande el intento fallido.
2. Lee el cuerpo de la respuesta — las propias palabras de NABIDH son la señal más fiable.
3. Revisa los hallazgos de la comprobación previa listados en el intento; cada uno incluye una solución en lenguaje sencillo.
4. Corrige el registro en Pabau, luego pulsa Reintentar en la entrega (o Sincronizar lo último para reenviar el estado actual del registro).
5. ¿Sigues atascado? Envía al soporte de Pabau el ID de entrega y el ID de correlación del panel — juntos identifican el mensaje exacto.