Una vez que tu conexión NABIDH está configurada, mapeada y activada, esta guía cubre el aspecto operativo: enviar eventos de prueba, leer el registro de entregas, entender los reintentos y solucionar los fallos que probablemente encontrarás.
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: Mapear tus datos para NABIDH
- Parte 4: Elegir qué eventos se envían a NABIDH
- Parte 5: Probar, monitorizar y solucionar problemas de las entregas a NABIDH (estás aquí)
- Parte 6: Códigos de error y estados de entrega de NABIDH
- Parte 7: Referencia de tablas de códigos de NABIDH
Paso 1: Enviar Un Evento De Prueba
El botón Enviar evento de prueba se encuentra en la pestaña 3. Mapeo de la conexión. Selecciona un registro coincidente al azar de tu cuenta y lo envía a través del flujo en vivo — exactamente lo que enviaría el evento real — y etiqueta la entrega como prueba en el registro.
- Haz clic en Enviar evento de prueba, elige el evento a probar (por ejemplo, client.create → Añadir paciente (ADT^A28)) y haz clic en Enviar prueba.
- Abre Registros y desactiva Ocultar pruebas para ver cómo llega la entrega.
- Abre la entrega para inspeccionar el mensaje HL7 exacto que se envió y la respuesta de NABIDH.
NOTA: Las pruebas usan registros reales y se entregan genuinamente al endpoint configurado. Si no existe un registro adecuado para el evento elegido (por ejemplo, una prueba de visita sin cita elegible), Pabau te indica exactamente qué crear primero. Las pruebas destructivas — eliminación y fusión de pacientes — solo se permiten en conexiones de entorno de prueba, de modo que una prueba nunca puede borrar un paciente real del intercambio.
Paso 2: Leer El Registro De Entregas
Haz clic en Registros en la cabecera de la conexión. Cada entrega aparece listada con su disparador, acción, registro, estado y número de intentos, y una franja de pendientes en la parte superior muestra lo que está en cola, procesándose, reintentándose o en cola de mensajes fallidos en este momento.
Puedes filtrar por estado, objeto y disparador, buscar por registro o ID de correlación, restringir el rango de fechas, observar cómo llegan las nuevas entregas con En vivo, y descargar todo con Exportar CSV. Estados de entrega:
- En cola / Procesando — esperando o en curso un intento de envío.
- Correcto — NABIDH aceptó el mensaje.
- Reintento programado — un fallo temporal; Pabau reintentará automáticamente.
- Fallido — un fallo permanente (normalmente de validación); no se reintentará por sí solo.
- Cola de mensajes fallidos — se abandonó tras agotar todos los reintentos automáticos; aún se puede reenviar manualmente.
Paso 3: Inspeccionar Una Entrega
Haz clic en cualquier fila para abrir el panel de detalles de la entrega. Para cada intento puedes expandir la solicitud exacta (el mensaje HL7 en bruto) y la respuesta (el acuse de recibo de NABIDH), copiar cualquiera de los dos, y ver el ID de correlación para las conversaciones de soporte. Un panel de Conformidad con la especificación audita cada intento contra la especificación DHA NABIDH HL7 v2.5.1 y enumera cualquier hallazgo con la referencia de la especificación y una explicación de "Cómo solucionarlo" — esta es la forma más rápida de entender un rechazo.
NOTA: NABIDH responde a cada mensaje con un acuse de recibo HL7: AA significa aceptado, mientras que AE/AR significan que el mensaje fue rechazado por la propia validación de NABIDH — el texto de diagnóstico que devuelve NABIDH se muestra en el intento.
Paso 4: Reintentar Una Entrega
Los fallos temporales (problemas de red, NABIDH temporalmente no disponible, limitación de velocidad) se reintentan automáticamente con retrasos crecientes — empezando en 30 segundos y duplicándose hasta un tope de 6 horas, hasta 8 intentos antes de que la entrega pase a la cola de mensajes fallidos. Los fallos permanentes (validación, rechazos) no se reintentan automáticamente. Desde el panel de la entrega tienes dos opciones manuales:
- Reenviar carga original — envía de nuevo el mensaje original exacto, byte por byte. Úsalo cuando el problema estuvo en el lado receptor.
- Sincronizar datos más recientes — vuelve a leer el registro, reconstruye el mensaje con los datos y el mapeo actuales, y lo envía. Úsalo después de corregir el registro o el mapeo.
Paso 5: Solucionar Fallos Comunes
- Validación — al registro le falta algo que NABIDH requiere. El mensaje indica el campo: lo más habitual es un ID de Emirates faltante en un residente de Dubái, una fecha de nacimiento o dato de contacto faltante, un servicio sin especialidad NABIDH, o un profesional sin licencia Sheryan. Corrige el registro (o el mapeo de la Parte 3) y luego usa Sincronizar datos más recientes.
- Rechazado — la propia validación de NABIDH rechazó el mensaje (un acuse de recibo AE/AR o una respuesta 4xx). Abre el panel de Conformidad con la especificación y el diagnóstico de la respuesta para ver por qué.
- Autenticación — NABIDH ya no acepta tu clave de aplicación. Reemplázala en la tarjeta de Credenciales de la pestaña de Configuración.
- Configuración — el endpoint o los ajustes de la conexión son incorrectos. Revísalos de nuevo en la pestaña de Configuración y usa Probar conexión.
- Error de red / Error de destino / Límite de velocidad — problemas transitorios en el camino hacia NABIDH; estos se reintentan automáticamente y normalmente se resuelven solos.
Paso 6: Buscar Un Código Que No Reconoces
Los dos artículos de referencia al final de esta serie existen para los momentos en que el registro te muestra algo desconocido:
- Parte 6: Códigos de error y estados de entrega de NABIDH — todos los estados de entrega y etiquetas de error, el calendario exacto de reintentos, cómo leer un acuse de recibo AA/AE/AR y una respuesta de la utilidad de prueba de la DHA, y una lista campo por campo de qué corregir en Pabau para cada posible hallazgo.
- Parte 7: Referencia de tablas de códigos de NABIDH — las 25 tablas de códigos de NABIDH completas. Cuando un rechazo dice que un valor es "inválido según NAB002", aquí es donde descubres que NAB002 es el estado civil y qué valores acepta NABIDH.
CONSEJO: Echa un vistazo de vez en cuando a la franja de pendientes en la parte superior del registro — "Nada en cola — las entregas están fluyendo." es el estado saludable. Un número creciente de reintentos o de mensajes fallidos es tu señal para abrir el fallo más reciente y leer sus hallazgos de conformidad.