Une fois votre connexion NABIDH configurée, mappée et activée, ce guide aborde l'aspect opérationnel : envoyer des événements de test, lire le journal des envois, comprendre les nouvelles tentatives et corriger les échecs que vous êtes le plus susceptible de rencontrer.
Cet article fait partie de la série de guides NABIDH :
- Partie 1 : Qu'est-ce que NABIDH et comment Pabau s'y connecte
- Partie 2 : Connecter Pabau à NABIDH
- Partie 3 : Mapper vos données pour NABIDH
- Partie 4 : Choisir les événements envoyés à NABIDH
- Partie 5 : Tester, surveiller et résoudre les problèmes des envois NABIDH (vous êtes ici)
- Partie 6 : Codes d'erreur et statuts d'envoi NABIDH
- Partie 7 : Référence des tables de codes NABIDH
Étape 1 : envoyer un événement de test
Le bouton Envoyer un événement de test se trouve sous l'onglet 3. Mapping de la connexion. Il sélectionne un enregistrement correspondant au hasard dans votre compte et le fait passer par le pipeline en direct — exactement ce que l'événement réel enverrait — et étiquette l'envoi comme test dans le journal.
- Cliquez sur Envoyer un événement de test, choisissez l'événement à tester (par ex. client.create → Ajouter un patient (ADT^A28)), puis cliquez sur Envoyer le test.
- Ouvrez Journaux et désactivez Masquer les tests pour voir l'envoi apparaître.
- Ouvrez l'envoi pour inspecter le message HL7 exact qui a été envoyé et la réponse de NABIDH.
REMARQUE : les tests utilisent de vrais enregistrements et sont réellement livrés au point de terminaison configuré. Si aucun enregistrement approprié n'existe pour l'événement choisi (par exemple, un test de visite sans rendez-vous éligible), Pabau vous indique exactement quoi créer au préalable. Les tests destructifs — suppression et fusion de patients — ne sont autorisés que sur les connexions d'environnement fictif, de sorte qu'un test ne peut jamais effacer un vrai patient de l'échange.
Étape 2 : lire le journal des envois
Cliquez sur Journaux dans l'en-tête de la connexion. Chaque envoi est répertorié avec son déclencheur, son action, son enregistrement, son statut et son nombre de tentatives, et une bande d'arriéré en haut affiche ce qui est actuellement en file d'attente, en cours de traitement, en nouvelle tentative ou en lettre morte.
Vous pouvez filtrer par statut, objet et déclencheur, rechercher par enregistrement ou ID de corrélation, restreindre la plage de dates, observer l'arrivée des nouveaux envois avec En direct, et tout télécharger avec Exporter en CSV. Statuts d'envoi :
- En file d'attente / En cours — en attente ou en cours de tentative d'envoi.
- Réussi — NABIDH a accepté le message.
- Nouvelle tentative programmée — un échec temporaire ; Pabau réessaiera automatiquement.
- Échec — un échec permanent (le plus souvent une validation) ; il ne sera pas réessayé automatiquement.
- Lettre morte — abandon après épuisement de toutes les tentatives automatiques ; peut encore être rejoué manuellement.
Étape 3 : inspecter un envoi
Cliquez sur une ligne pour ouvrir le panneau de détails de l'envoi. Pour chaque tentative, vous pouvez développer la requête exacte (le message HL7 brut) et la réponse (l'accusé de réception de NABIDH), copier l'une ou l'autre, et voir l'ID de corrélation pour les conversations avec le support. Un panneau Conformité aux spécifications vérifie chaque tentative par rapport à la spécification DHA NABIDH HL7 v2.5.1 et répertorie les constatations avec la référence de la spécification et une explication « Comment corriger » — c'est le moyen le plus rapide de comprendre un rejet.
REMARQUE : NABIDH répond à chaque message par un accusé de réception HL7 : AA signifie accepté, tandis que AE/AR signifient que le message a été rejeté par la propre validation de NABIDH — le texte de diagnostic renvoyé par NABIDH est affiché sur la tentative.
Étape 4 : réessayer un envoi
Les échecs temporaires (problèmes réseau, indisponibilité brève de NABIDH, limitation de débit) réessaient automatiquement avec des délais croissants — à partir de 30 secondes, doublant jusqu'à un plafond de 6 heures, pour un maximum de 8 tentatives avant que l'envoi ne soit mis en lettre morte. Les échecs permanents (validation, rejets) ne réessaient pas automatiquement. Depuis le panneau de l'envoi, vous disposez de deux options manuelles :
- Rejouer la charge utile d'origine — renvoie exactement le message d'origine, octet pour octet. À utiliser lorsque le problème se situait du côté du destinataire.
- Synchroniser les dernières données — relit l'enregistrement, reconstruit le message avec les données et le mapping actuels, et l'envoie. À utiliser après avoir corrigé l'enregistrement ou le mapping.
Étape 5 : corriger les échecs courants
- Validation — il manque à l'enregistrement un élément requis par NABIDH. Le message nomme le champ : le plus souvent un numéro d'identité Emirates manquant pour un résident de Dubaï, une date de naissance ou un contact manquant, un service sans spécialité NABIDH, ou un praticien sans licence Sheryan. Corrigez l'enregistrement (ou le mapping de la partie 3), puis Synchronisez les dernières données.
- Rejeté — la propre validation de NABIDH a refusé le message (un accusé de réception AE/AR ou une réponse 4xx). Ouvrez le panneau Conformité aux spécifications et le diagnostic de réponse pour comprendre pourquoi.
- Authentification — NABIDH n'accepte plus votre clé d'application. Remplacez-la dans la carte Identifiants de l'onglet Paramètres.
- Configuration — le point de terminaison ou les paramètres de connexion sont incorrects. Vérifiez-les à nouveau dans l'onglet Paramètres et utilisez Tester la connexion.
- Réseau / Erreur de destination / Limitation de débit — problèmes transitoires en route vers NABIDH ; ceux-ci réessaient automatiquement et se résolvent normalement d'eux-mêmes.
Étape 6 : rechercher un code que vous ne reconnaissez pas
Les deux articles de référence à la fin de cette série existent pour les moments où le journal vous montre quelque chose d'inconnu :
- Partie 6 : codes d'erreur et statuts d'envoi NABIDH — chaque statut d'envoi et badge d'erreur, le calendrier exact des nouvelles tentatives, comment lire un accusé de réception AA/AE/AR et une réponse de l'outil de test DHA, ainsi qu'une liste champ par champ de ce qu'il faut corriger dans Pabau pour chaque constatation possible.
- Partie 7 : référence des tables de codes NABIDH — les 25 tables de codes NABIDH en intégralité. Lorsqu'un rejet indique qu'une valeur est « invalide par rapport à NAB002 », c'est ici que vous découvrez que NAB002 correspond à l'état civil et quelles valeurs NABIDH accepte.
ASTUCE : gardez un œil de temps en temps sur la bande d'arriéré en haut du journal — « Rien en file d'attente — les envois circulent normalement. » est l'état sain. Un nombre croissant de nouvelles tentatives ou de lettres mortes est le signal pour ouvrir l'échec le plus récent et lire ses constatations de conformité.