Zodra je NABIDH-verbinding is geconfigureerd, gekoppeld en ingeschakeld, behandelt deze gids het operationele gedeelte: testgebeurtenissen versturen, het bezorglogboek lezen, herhalingen begrijpen en de fouten oplossen die je waarschijnlijk tegenkomt.
Dit artikel maakt deel uit van de NABIDH-gidsreeks:
- Deel 1: Wat is NABIDH en hoe Pabau ermee verbindt
- Deel 2: Pabau met NABIDH verbinden
- Deel 3: Je gegevens koppelen voor NABIDH
- Deel 4: Kiezen welke gebeurtenissen naar NABIDH worden verstuurd
- Deel 5: NABIDH-verzendingen testen, monitoren en oplossen (je bent hier)
- Deel 6: NABIDH-foutcodes en bezorgstatussen
- Deel 7: NABIDH-codetabellen naslagwerk
Stap 1: Een testgebeurtenis versturen
De knop Testgebeurtenis versturen staat op het tabblad 3. Koppeling van de verbinding. Het kiest een willekeurig overeenkomend record uit je account en stuurt dit door de live pipeline — precies wat de echte gebeurtenis zou versturen — en markeert de verzending als test in het logboek.
- Klik op Testgebeurtenis versturen, kies de te testen gebeurtenis (bijv. client.create → Patiënt toevoegen (ADT^A28)) en klik op Test versturen.
- Open Logboeken en zet Tests verbergen uit om de verzending binnen te zien komen.
- Open de verzending om het exacte verstuurde HL7-bericht en de reactie van NABIDH te bekijken.
OPMERKING: Tests gebruiken echte records en worden daadwerkelijk afgeleverd bij het geconfigureerde eindpunt. Als er geen geschikt record bestaat voor de gekozen gebeurtenis (bijvoorbeeld een bezoektest zonder in aanmerking komende afspraak), vertelt Pabau je precies wat je eerst moet aanmaken. Destructieve tests — patiënt verwijderen en samenvoegen — zijn alleen toegestaan bij dummy-omgevingsverbindingen, zodat een test nooit een echte patiënt uit de uitwisseling kan verwijderen.
Stap 2: Het bezorglogboek lezen
Klik op Logboeken in de header van de verbinding. Elke verzending wordt weergegeven met de trigger, actie, record, status en aantal pogingen, en een achterstandsbalk bovenaan toont wat er nu in de wachtrij staat, wordt verwerkt, opnieuw wordt geprobeerd of in de dode-letterbak zit.
Je kunt filteren op status, object en trigger, zoeken op record- of correlatie-ID, de datumrange beperken, nieuwe verzendingen live volgen met Live, en alles downloaden met Exporteer CSV. Bezorgstatussen:
- In wachtrij / Wordt verwerkt — wacht op of bezig met een verzendpoging.
- Gelukt — NABIDH heeft het bericht geaccepteerd.
- Nieuwe poging gepland — een tijdelijke storing; Pabau probeert het automatisch opnieuw.
- Mislukt — een permanente storing (meestal validatie); wordt niet automatisch opnieuw geprobeerd.
- Dode letter — opgegeven na het uitputten van alle automatische pogingen; kan nog handmatig opnieuw worden verstuurd.
Stap 3: Een verzending inspecteren
Klik op een rij om het detailvenster van de verzending te openen. Voor elke poging kun je het exacte verzoek (het ruwe HL7-bericht) en de reactie (bevestiging van NABIDH) uitklappen, beide kopiëren en de correlatie-ID bekijken voor supportgesprekken. Een Spec-conformiteit-paneel controleert elke poging aan de hand van de DHA NABIDH HL7 v2.5.1-specificatie en toont bevindingen met de specificatieverwijzing en een uitleg "Hoe op te lossen" — dit is de snelste manier om een afwijzing te begrijpen.
OPMERKING: NABIDH beantwoordt elk bericht met een HL7-bevestiging: AA betekent geaccepteerd, terwijl AE/AR betekenen dat het bericht werd afgewezen door de eigen validatie van NABIDH — de diagnostische tekst die NABIDH terugstuurt, wordt bij de poging getoond.
Stap 4: Een verzending opnieuw proberen
Tijdelijke storingen (netwerkproblemen, korte onbeschikbaarheid van NABIDH, snelheidsbeperking) worden automatisch opnieuw geprobeerd met oplopende vertragingen — beginnend bij 30 seconden en verdubbelend tot een maximum van 6 uur, tot maximaal 8 pogingen voordat de verzending naar de dode-letterbak gaat. Permanente storingen (validatie, afwijzingen) worden niet automatisch opnieuw geprobeerd. Vanuit het detailvenster van de verzending heb je twee handmatige opties:
- Oorspronkelijke payload opnieuw versturen — verstuurt het exacte oorspronkelijke bericht opnieuw, byte voor byte. Gebruik dit wanneer het probleem aan de ontvangende kant lag.
- Laatste gegevens synchroniseren — leest het record opnieuw in, bouwt het bericht opnieuw op met de huidige gegevens en koppeling, en verstuurt dat. Gebruik dit nadat je het record of de koppeling hebt hersteld.
Stap 5: Veelvoorkomende storingen oplossen
- Validatie — het record mist iets wat NABIDH vereist. Het bericht noemt het veld: meestal een ontbrekend Emirates-ID bij een inwoner van Dubai, een ontbrekende geboortedatum of contactgegevens, een dienst zonder NABIDH-specialisme, of een zorgverlener zonder Sheryan-licentie. Herstel het record (of de koppeling uit deel 3) en gebruik daarna Laatste gegevens synchroniseren.
- Afgewezen — de eigen validatie van NABIDH heeft het bericht geweigerd (een AE/AR-bevestiging of een 4xx-reactie). Open het Spec-conformiteitspaneel en de diagnostische reactie om te zien waarom.
- Authenticatie — NABIDH accepteert je applicatiesleutel niet meer. Vervang deze in de kaart Inloggegevens op het tabblad Instellingen.
- Configuratie — het eindpunt of de verbindingsinstellingen zijn onjuist. Controleer deze opnieuw op het tabblad Instellingen en gebruik Verbinding testen.
- Netwerk / Bestemmingsfout / Snelheidsbeperking — tijdelijke problemen onderweg naar NABIDH; deze worden automatisch opnieuw geprobeerd en lossen zich meestal vanzelf op.
Stap 6: Een onbekende code opzoeken
De twee naslagartikelen aan het einde van deze reeks bestaan voor de momenten waarop het logboek iets onbekends toont:
- Deel 6: NABIDH-foutcodes en bezorgstatussen — elke bezorgstatus en foutbadge, het exacte herhalingsschema, hoe je een AA/AE/AR-bevestiging en een DHA-testresultaat leest, en een veld-voor-veld lijst van wat je in Pabau moet corrigeren voor elke mogelijke bevinding.
- Deel 7: NABIDH-codetabellen naslagwerk — alle 25 NABIDH-codetabellen volledig. Wanneer een afwijzing zegt dat een waarde "ongeldig is volgens NAB002", vind je hier dat NAB002 de burgerlijke staat is en welke waarden NABIDH accepteert.
TIP: Houd af en toe de achterstandsbalk bovenaan het logboek in de gaten — "Niets in de wachtrij — verzendingen verlopen soepel." is de gezonde toestand. Een toenemend aantal herhalingen of dode letters is je signaal om de meest recente storing te openen en de conformiteitsbevindingen te lezen.