Für wen ist dieser Artikel relevant?
Dieser Artikel richtet sich an die Klinik-IT und an technische Verantwortliche für die KIS-Anbindung an Recare.
Die Schritte setzen Zugriff auf die ADT-Nachrichten, auf die Gateway-GUI und auf die Konfiguration der Schnittstelle voraus.
Notiz: Wenn Sie im Sozialdienst arbeiten, geben Sie diesen Artikel an Ihre IT-Abteilung weiter. Die Prüfschritte lassen sich nur mit Zugriff auf die Schnittstelle durchführen.
Symptom
Der Import schlägt in genau einem Mandanten oder an einem Standort fehl, während derselbe Fall in einem anderen Mandanten funktioniert.
Bei einem neu angelegten Mandanten erscheint kein grüner KIS-Haken.
Es erscheint der Fehler
Could not fetch patient: got status 404.Die ADT-Nachrichten stehen nachweislich im Log, der Fall taucht in Recare aber nicht auf oder wird als neuer Fall angelegt.
Wann dieser Artikel nicht passt
Der Haken Verbindung zum Gateway besteht fehlt oder es kommen gar keine Nachrichten an. Arbeiten Sie in diesem Fall den Artikel Für die Klinik-IT, warum Patientendaten nicht importiert werden können? ab.
Die Fallnummer ist in keinem Log auffindbar oder der Fall wurde wegen der Vorhaltedauer gelöscht. Dafür gilt der Artikel Für die Klinik-IT, warum einzelne Fallnummern nicht importiert werden können?
Der Import bricht mit Fehler 500 ab. Das ist ein eigenes Fehlerbild.
Der Fall wird importiert und es fehlen nur einzelne Felder wie Krankenkasse, Diagnosen oder Hausarzt. Dann geht es um das jeweilige Feld und nicht um die Zuordnung.
Notiz: Ein abweichendes Fallnummern-Format kann bei fehlenden Datenfeldern als Begleitursache auftreten. Prüfen Sie Ursache 4, wenn parallel zum fehlenden Feld auch die Zuordnung des Falls nicht stattfindet.
Ursache 1: Das Mandanten- und Standort-Mapping der hospital-ID passt nicht
Recare liest die hospital-ID meist aus dem ADT-Feld PV1.39. Ist beim Mandanten ein falsches Kürzel hinterlegt, schlägt der Import genau in diesem Mandanten fehl, während derselbe Fall in einem anderen Mandanten funktioniert.
Notiz: Die genutzten ADT-Felder unterscheiden sich von Integration zu Integration. Unter Umständen wurde für Ihr Haus individuell ein anderes Feld verwendet beziehungsweise gemappt. Welche Felder in Ihrer Integration ausgewertet werden, erfahren Sie beim Recare Kundenservice.
Prüfen Sie, welches Kürzel in PV1.39 oder dem entsprechenden Feld tatsächlich gesendet wird, und gleichen Sie es mit den bei Recare hinterlegten hospital-IDs ab.
Prüfen Sie zusätzlich, welches Kürzel in MSH.4.1 gesendet wird.
Weicht ein Kürzel ab, melden Sie den betroffenen Mandanten oder Standort und die tatsächlich gesendeten Kürzel an den Recare Kundenservice. Das Mandanten-Mapping wird auf Recare-Seite korrigiert.
Lassen Sie die Anwendenden nach der Korrektur neu einloggen und prüfen Sie mit einem neu übertragenen Fall gegen.
Notiz: Greift die Änderung nach dem neuen Login nicht, kann ein Neustart des Recare-Dienstes beziehungsweise des Gateway-Servers erforderlich sein. Der Recare Kundenservice teilt Ihnen mit, was in Ihrem Fall nötig ist.
Ursache 2: Der Mandant ist nicht mit dem Gateway verknüpft
Ein neu angelegter Mandant wird nicht automatisch mit dem Gateway verknüpft. Erkennbar ist das daran, dass beim neuen Mandanten kein grüner KIS-Haken erscheint.
Prüfen Sie, ob der betroffene Mandant mit dem Gateway verknüpft ist.
Fehlt der grüne KIS-Haken, ist die Verknüpfung nachzuziehen. Melden Sie den betroffenen Mandanten an den Recare Kundenservice, wenn Sie die Verknüpfung nicht selbst herstellen können.
Prüfen Sie danach den Import mit einem neu übertragenen Fall.
Ursache 3: Die Fallnummern-Feldkonfiguration passt nicht
Ist die Feldkonfiguration für die Fallnummer auf Recare-Seite nicht korrekt gesetzt, erscheint der Fehler Could not fetch patient: got status 404.
Führen Sie einen Test-Import mit der Fallnummer im vollen HL7-Format
[Fallnummer]^0^^^VNdurch.Nutzen Sie dafür die Gateway-GUI auf der Seite Imports. Sie zeigt pro Fall, welche Datenpunkte importiert werden.
Melden Sie das Ergebnis an den Recare Kundenservice. Die Feldkonfiguration wird auf Recare-Seite angepasst.
Notiz: Welches Feld und welches Format für die Fallnummer ausgewertet werden, kann je Integration abweichen. Ist für Ihr Haus ein anderes Feld gemappt, nennt Ihnen der Recare Kundenservice das für Sie gültige Format.
Ursache 4: Das Fallnummern-Format weicht zwischen KIS und Recare ab
Weicht das Format der Fallnummer ab, typischerweise durch führende Nullen, findet kein Matching statt: Die ADT-Nachrichten sind im Log vorhanden, der Fall taucht in Recare aber nicht auf oder wird als neuer Fall angelegt.
Stellen Sie eine anonymisierte Beispiel-HL7-Nachricht des betroffenen Falls bereit, aus der das Fallnummernformat hervorgeht.
Recare bestimmt daraus das Format und passt das Mapping an.
Lassen Sie die Anwendenden anschließend neu einloggen, starten Sie bei Bedarf den Recare-Dienst oder den Gateway-Server neu und prüfen Sie mit einem neu übertragenen Fall gegen.
Wichtig: Rechnen Sie mit einer Übergangszeit. Ältere Fälle müssen gegebenenfalls noch im alten Format importiert werden.
Notiz: Informieren Sie nach der Umstellung auch die Anwendenden im Sozialdienst. Sie sehen ab diesem Zeitpunkt andere Fallnummern.
Diese Angaben benötigt der Recare Kundenservice
den betroffenen Mandanten oder Standort und die Information, ob derselbe Fall in einem anderen Mandanten funktioniert
die in PV1.39 beziehungsweise im entsprechend gemappten Feld übermittelten Kürzel und die Information, ob sie zu den hinterlegten Mandanten passen
das in MSH.4.1 gesendete Kürzel
eine anonymisierte Beispiel-HL7-Nachricht des betroffenen Falls, aus der das Fallnummernformat hervorgeht
die Fallnummer, den Zeitstempel und den genauen Fehlertext, zum Beispiel
Could not fetch patient: got status 404das Ergebnis des Test-Imports aus der Gateway-GUI
die Information, ob nach der Anpassung ein Neustart des Recare-Dienstes oder des Gateway-Servers möglich ist und ein erneuter Import versucht wurde
FAQs
Warum schlägt der Import nur in einem Mandanten fehl?
Schlägt der Import nur in einem Mandanten fehl, während derselbe Fall in einem anderen Mandanten funktioniert, ist beim betroffenen Mandanten meist ein falsches Kürzel als hospital-ID hinterlegt. Gleichen Sie das tatsächlich gesendete Kürzel mit dem hinterlegten Mapping ab.
Woher liest Recare die Zuordnung zum Mandanten?
Recare liest die hospital-ID meist aus dem ADT-Feld PV1.39. Prüfen Sie zusätzlich, welches Kürzel in MSH.4.1 gesendet wird, damit beide Feldpositionen abgeglichen sind. Die ADT-Felder unterscheiden sich von Integration zu Integration, deshalb kann für Ihr Haus auch ein anderes Feld gemappt sein.
Warum erscheint bei einem neu angelegten Mandanten kein grüner KIS-Haken?
Fehlt beim neu angelegten Mandanten der grüne KIS-Haken, ist dieser Mandant nicht mit dem Gateway verknüpft. Die Verknüpfung muss nachgezogen werden, danach funktioniert der Import auch in diesem Mandanten.
Was bedeutet der Fehler Could not fetch patient: got status 404?
Der Fehler Could not fetch patient: got status 404 weist auf eine nicht passende Fallnummern-Feldkonfiguration hin. Prüfen Sie das mit einem Test-Import der Fallnummer im vollen HL7-Format [Fallnummer]^0^^^VN in der Gateway-GUI.
Warum wird ein Fall in Recare als neuer Fall angelegt, obwohl die ADT-Nachrichten im Log stehen?
Wird ein Fall als neuer Fall angelegt, obwohl die ADT-Nachrichten im Log stehen, findet kein Matching statt. Ursache ist in der Regel ein abweichendes Fallnummern-Format zwischen KIS und Recare, typischerweise durch führende Nullen.
Welche Rolle spielen führende Nullen in der Fallnummer?
Führende Nullen sind die häufigste Ursache für ein abweichendes Fallnummern-Format. Weicht das Format ab, wird der Fall nicht zugeordnet. Eine anonymisierte Beispiel-HL7-Nachricht zeigt das tatsächliche Format, danach kann das Mapping angepasst werden.
Was ist nach einer Anpassung des Mappings zu tun?
Nach einer Anpassung des Mappings sollten sich die Anwendenden neu einloggen. Greift die Änderung dadurch nicht, kann ein Neustart des Recare-Dienstes oder des Gateway-Servers erforderlich sein. Prüfen Sie anschließend mit einem neu übertragenen Fall gegen.
Müssen ältere Fälle nach einer Formatumstellung anders importiert werden?
Ja, in einer Übergangszeit müssen ältere Fälle gegebenenfalls noch im alten Format importiert werden. Informieren Sie auch die Anwendenden im Sozialdienst, weil sie nach der Umstellung andere Fallnummern sehen.
Welche Angaben benötigt der Recare Kundenservice?
Der Recare Kundenservice benötigt den betroffenen Mandanten oder Standort, die in PV1.39 und MSH.4.1 gesendeten Kürzel, eine anonymisierte Beispiel-HL7-Nachricht des betroffenen Falls, die Fallnummer mit Zeitstempel und genauem Fehlertext sowie das Ergebnis des Test-Imports aus der Gateway-GUI.