NABIDH-Leitfaden Teil 6: NABIDH-Fehlercodes und Übermittlungsstatus

Wenn eine NABIDH-Übermittlung fehlschlägt, teilt Pabau Ihnen drei Dinge mit: in welcher Phase sie gescheitert ist, welches Feld die Ursache war und was dagegen zu tun ist. Dieser Artikel ist die vollständige Referenz für alle drei — so geschrieben, dass eine Praxisleitung die Lösung findet und ein technischer Leser jeden Code auf die DHA-Spezifikation zurückführen kann.

Dieser Artikel ist Teil der NABIDH-Leitfadenserie:

• Teil 1: Was ist NABIDH und wie verbindet sich Pabau damit
• Teil 2: Pabau mit NABIDH verbinden
• Teil 3: Ihre Daten für NABIDH zuordnen
• Teil 4: Auswählen, welche Ereignisse an NABIDH gesendet werden
• Teil 5: NABIDH-Übermittlungen testen, überwachen und beheben
• Teil 6: NABIDH-Fehlercodes und Übermittlungsstatus (Sie sind hier)
• Teil 7: NABIDH-Codetabellen-Referenz

Woher Fehler kommen

Eine NABIDH-Nachricht durchläuft drei Prüfpunkte. Zu wissen, welcher sie gestoppt hat, sagt Ihnen, wer sie beheben kann.

HINWEIS: Eine Übermittlung kann die Vorabprüfung bestehen und dennoch von NABIDH abgelehnt werden, da NABIDH einige Regeln durchsetzt, die Pabau nicht sehen kann (zum Beispiel, ob eine Sheryan-Provider-ID tatsächlich für Ihre Einrichtung registriert ist). Lesen Sie immer die Antwort von NABIDH selbst zur Übermittlung, nicht nur die Ergebnisse der Vorabprüfung.

Übermittlungsstatus

Jede Zeile im Tab Protokolle trägt einen von sechs Status.

Fehlerklassen

Jede fehlgeschlagene Übermittlung wird zusätzlich mit einer Fehlerklasse gekennzeichnet, die als farbiges Abzeichen angezeigt wird. Die Klasse entscheidet, ob Pabau von selbst erneut versucht.

Die Wiederholungsstaffel

Wiederholbare Fehlschläge werden exponentiell verzögert, beginnend bei 30 Sekunden und jeweils verdoppelt. Eine Übermittlung erhält insgesamt 8 Versuche, verteilt über etwa eine Stunde.

HINWEIS: Wiederholungen sind auf einen Abstand von 6 Stunden begrenzt, bei 8 Versuchen wird diese Grenze in der Praxis jedoch nie erreicht — der längste tatsächliche Abstand beträgt 32 Minuten. Eine ins Dead-Letter verschobene Übermittlung ist nicht verloren: Beheben Sie die Ursache und klicken Sie auf Wiederholen, um sie erneut abzuspielen.

Eine NABIDH-Bestätigung lesen

Ein produktiver NABIDH-Endpunkt antwortet mit einer HL7-Bestätigungsnachricht. Der wichtige Teil ist das Segment MSA.

Lautet die Antwort AE oder AR, enthalten zwei weitere Felder die Details:

• ERR-5 — der Anwendungsfehlercode. 5001 ist der allgemeine Validierungsfehler von NABIDH.
• ERR-7 — eine für Menschen lesbare Diagnose, die benennt, was schiefgelaufen ist.

Das Feld MSA-2 gibt die von Pabau gesendete Message-Control-ID zurück; darüber wird eine Antwort ihrer Übermittlung zugeordnet.

Eine Antwort des DHA-Testwerkzeugs lesen

Das während des Onboardings verwendete HL7-Testwerkzeug der DHA antwortet nicht mit einer HL7-Bestätigung. Es gibt einen einfachen Satz zurück:

Validation : Success — die Nachricht wurde akzeptiert.

Validation : PID:16 Marital Id Invalid against NAB002/CodeSystem should be NAB002~PID:30 Pat.DeathInd. Invalid~ — die Nachricht wurde abgelehnt, und jeder Grund ist durch eine Tilde (~) getrennt.

Jeder Grund folgt demselben Aufbau:

TIPP: Beheben Sie das im ersten Fehler genannte Pflichtfeld, bevor Sie den übrigen nachgehen. NABIDH meldet häufig Folgefehler für benachbarte Felder, wenn ein Pflichtfeld leer ist; diese verschwinden von selbst, sobald das erste korrigiert ist.

Feld-für-Feld-Referenz: was Sie beheben können

Dies sind die Befunde, die durch Daten in Ihrem Pabau-Konto verursacht werden. Jeder benennt die genaue Stelle zur Korrektur. Die Spalte Spezifikationsverweis ist der Abschnitt der NABIDH-Spezifikation Inbound HL7 v2.5.1, aus dem die Regel stammt — nützlich, wenn Sie mit der DHA sprechen.

Kundenkarte — Identität und Stammdaten

Öffnen Sie den Kunden und dann Kunden bearbeiten.

Kundenkarte — Allergien

Öffnen Sie den Kunden → Allergien.

Kundenkarte — Probleme / Diagnosen

Öffnen Sie den Kunden → Probleme.

Termine und Besuche

Öffnen Sie die Buchung oder deren Leistung in Konfiguration → Leistungen.

Mitarbeiterdatensätze — Sheryan-Provider-IDs

Jeder Behandelnde benötigt eine 8-stellige Sheryan-Provider-ID in seinem Teamdatensatz.

Rezepte

Öffnen Sie das Rezept im Kundendatensatz.

Dokumente und Briefe

Öffnen Sie den Anhang oder Brief im Kundendatensatz.

Laborergebnisse

Öffnen Sie die Laboranforderung oder den Bericht im Kundendatensatz.

Einwilligungs- und VIP-Kennzeichen

Gesteuert über benutzerdefinierte Kundenfelder, die im Tab Zuordnung gebunden sind.

Verbindungseinstellungen

Diese stammen aus der Verbindung selbst und nicht aus einem Patientendatensatz. Korrigieren Sie sie unter Konfiguration → Datensynchronisierung → Verwalten → Einstellungen.

Befunde, die Sie melden statt beheben sollten

Etwa die Hälfte der Prüfungen betrifft Werte, die Pabau selbst erzeugt — Nachrichtenkopfzeilen, Zeitstempel, strukturelle Marker. Wird einer davon jemals beanstandet, bedeutet das, dass der Nachrichtengenerator etwas Unerwartetes erzeugt hat, nicht dass Ihre Daten falsch sind. Senden Sie die Übermittlungs-ID an den Pabau-Support; in Ihrem Konto ist nichts zu ändern.

Die Felder in dieser Kategorie sind:

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

HINWEIS: Einige wenige Prüfungen fallen in beide Kategorien — zum Beispiel sollten PID-3.1 (die Pabau-Datensatznummer des Patienten) und PRB-4 immer automatisch vorhanden sein; werden sie beanstandet, lohnt es sich also eher zu melden als zu bearbeiten.

Was zu tun ist, wenn nichts anderes es erklärt

1. Öffnen Sie die Übermittlung in Protokolle und klappen Sie den fehlgeschlagenen Versuch auf.
2. Lesen Sie den Antworttext — die eigenen Worte von NABIDH sind das zuverlässigste Signal.
3. Prüfen Sie die Ergebnisse der Vorabprüfung, die zum Versuch aufgeführt sind; jedes enthält eine verständliche Lösung.
4. Korrigieren Sie den Datensatz in Pabau und klicken Sie dann bei der Übermittlung auf Wiederholen (oder auf Neuesten Stand synchronisieren, um den aktuellen Stand des Datensatzes erneut zu senden).
5. Kommen Sie immer noch nicht weiter? Senden Sie dem Pabau-Support die Übermittlungs-ID und die Korrelations-ID aus dem Seitenbereich — zusammen identifizieren sie die genaue Nachricht.