Overslaan naar inhoud
Get Support
  • Er zijn geen suggesties want het zoekveld is leeg.

NABIDH-gids deel 6: NABIDH-foutcodes en verzendstatussen

Als een NABIDH-verzending niet slaagt, laat Pabau je drie dingen weten: in welke fase het misging, welk veld de oorzaak was en wat je eraan kunt doen. Dit artikel is het volledige naslagwerk voor alle drie — geschreven zodat een praktijkmanager de op

Als een NABIDH-verzending niet slaagt, laat Pabau je drie dingen weten: in welke fase het misging, welk veld de oorzaak was en wat je eraan kunt doen. Dit artikel is het volledige naslagwerk voor alle drie — geschreven zodat een praktijkmanager de oplossing kan vinden, en zodat een technische lezer elke code kan koppelen aan de DHA-specificatie.

Dit artikel is onderdeel van de NABIDH-gidsreeks:

Waar fouten vandaan komen

Een NABIDH-bericht doorloopt drie controlepunten. Weten welk controlepunt het bericht heeft gestopt, laat je zien wie het kan oplossen.

OPMERKING: Een verzending kan de vooraanmeldingscontrole doorstaan en toch door NABIDH worden geweigerd, omdat NABIDH sommige regels afdwingt die Pabau niet kan zien (bijvoorbeeld of een Sheryan-zorgverlener-ID daadwerkelijk bij jouw praktijk is geregistreerd). Lees altijd het eigen antwoord van NABIDH op de verzending, niet alleen de vooraanmeldingsbevindingen.

Verzendstatussen

Elke rij in het tabblad Logs heeft een van zes statussen.

Foutklassen

Elke mislukte verzending krijgt ook een foutklasse, weergegeven als een gekleurd label. De klasse bepaalt of Pabau zelf opnieuw probeert.

De retry-ladder

Fouten waarbij een nieuwe poging mogelijk is, worden exponentieel vertraagd, beginnend bij 30 seconden en telkens verdubbeld. Een verzending krijgt in totaal 8 pogingen, verspreid over ongeveer een uur.

OPMERKING: Nieuwe pogingen zijn beperkt tot maximaal 6 uur uit elkaar, maar met 8 pogingen wordt die limiet in de praktijk nooit bereikt — de langste werkelijke tussentijd is 32 minuten. Een dead-lettered verzending is niet verloren: herstel de oorzaak en druk op Retry om het opnieuw uit te voeren.

Een NABIDH-bevestiging lezen

Een productie-NABIDH-endpoint antwoordt met een HL7-bevestigingsbericht. Het belangrijke deel is het MSA-segment.

Als het antwoord AE of AR is, geven nog twee velden meer detail:

  • ERR-5 — de toepassingsfoutcode. 5001 is de generieke validatiefout van NABIDH.
  • ERR-7 — een voor mensen leesbare diagnose die aangeeft wat er misging.

Het veld MSA-2 herhaalt het berichtcontrole-ID dat Pabau heeft verstuurd, waarmee een antwoord wordt gekoppeld aan de bijbehorende verzending.

Een DHA-testtool-antwoord lezen

De DHA HL7-testtool die tijdens onboarding wordt gebruikt, antwoordt niet met een HL7-bevestiging. Het geeft een gewone zin terug:

Validation : Success — het bericht is goedgekeurd.

Validation : PID:16 Marital Id Invalid against NAB002/CodeSystem should be NAB002~PID:30 Pat.DeathInd. Invalid~ — het bericht is afgewezen, en elke reden wordt gescheiden door een tilde (~).

Elke reden heeft dezelfde opbouw:

TIP: Herstel eerst het verplichte veld dat in de eerste fout wordt genoemd, voordat je de rest oppakt. NABIDH meldt vaak vervolgfouten voor naburige velden wanneer een verplicht veld leeg is, en die verdwijnen automatisch zodra het eerste veld is gecorrigeerd.

Naslagwerk per veld: wat je zelf kunt oplossen

Dit zijn de bevindingen die worden veroorzaakt door data in je Pabau-account. Elke bevinding noemt de exacte plek om het te corrigeren. De kolom Spec-referentie verwijst naar het onderdeel van de NABIDH Inbound HL7 v2.5.1-specificatie waarop de regel is gebaseerd — handig als je met DHA praat.

Klantkaart — identiteit en demografische gegevens

Open de klant en dan Klant bewerken.

Klantkaart — allergieën

Open de klant → Allergieën.

Klantkaart — problemen / diagnoses

Open de klant → Problemen.

Afspraken en bezoeken

Open de boeking, of de bijbehorende dienst in Instellingen → Diensten.

Teamrecords — Sheryan-zorgverlener-ID's

Elke behandelaar heeft een 8-cijferige Sheryan-zorgverlener-ID nodig op zijn/haar teamrecord.

Voorschriften

Open het voorschrift in het klantrecord.

Documenten en brieven

Open de bijlage of brief in het klantrecord.

Labresultaten

Open het labaanvraagformulier of -rapport in het klantrecord.

Toestemming en VIP-markeringen

Wordt aangestuurd door aangepaste klantvelden die gekoppeld zijn op het tabblad Mapping.

Verbindingsinstellingen

Deze komen van de verbinding zelf, niet van een klantrecord. Herstel ze in Instellingen → Datasynchronisatie → Beheren → Instellingen.

Bevindingen die je beter kunt melden dan zelf oplossen

Ongeveer de helft van de controles betreft waarden die Pabau zelf genereert — berichtheaders, tijdstempels, structurele markeringen. Als een daarvan wordt gemarkeerd, betekent dit dat de berichtbouwer iets onverwachts heeft geproduceerd, niet dat jouw data fout is. Stuur het verzendings-id naar de support van Pabau; er is niets aan te passen in je account.

De velden in deze categorie zijn:

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

OPMERKING: Een paar controles vallen in beide categorieën — bijvoorbeeld PID-3.1 (het Pabau-recordnummer van de klant) en PRB-4 horen altijd automatisch aanwezig te zijn, dus als deze worden gemarkeerd, is het beter om dit te melden dan om het zelf te bewerken.

Wat te doen als niets anders het verklaart

  1. Open de verzending in Logs en vouw de mislukte poging uit.
  2. Lees de antwoordinhoud — de eigen woorden van NABIDH zijn het meest betrouwbare signaal.
  3. Controleer de vooraanmeldingsbevindingen die bij de poging staan vermeld; elke bevinding bevat een oplossing in duidelijke taal.
  4. Corrigeer het record in Pabau en druk vervolgens op Retry bij de verzending (of Sync latest om de huidige status van het record opnieuw te versturen).
  5. Nog steeds vastgelopen? Stuur de support van Pabau de verzendings-id en de correlatie-id uit de lade — samen identificeren ze het exacte bericht.