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 Gateway-Logs, auf den Kommunikationsserver und auf die HL7-Rohnachrichten voraus. Für den Sozialdienst sind sie nur bedingt durchführbar.
Notiz: Wenn Sie im Sozialdienst arbeiten, starten Sie mit dem Artikel Warum können Patientendaten nicht importiert werden? Dort steht der Workaround, mit dem Sie einen Fall über eine Änderung im KIS erneut übertragen können, weisen Sie Ihre IT Abteilung aber gerne auf diesen Artikel hin um das Problem langfristig zu lösen.
Symptom
Der Import funktioniert grundsätzlich, nur einzelne Fallnummern lassen sich nicht importieren. Typische Meldungen:
Die Fallnummer lässt sich nicht importieren, obwohl der Patient im KIS existiert.
Der Import bricht mit dem Fehlercode 404 „Patient nicht gefunden“ ab.
Der Patient konnte nicht importiert werden, es handelt sich um einen Langlieger.
Der Patient musste in Recare manuell angelegt werden.
Zu genau einer Fallnummer wurde nichts übernommen, obwohl das KIS die Nachricht nachweislich gesendet hat.
Beim Versand eines Dokuments zu einem älteren Fall steht im Log
MDM: patient cannot be Nil. Im Sozialdienst schlägt dann lediglich der Dokumentversand fehl.
Wann dieser Artikel nicht passt
Der Haken Verbindung zum Gateway besteht fehlt oder es kommen gar keine Nachrichten mehr an. Arbeiten Sie in diesem Fall den Artikel Für die Klinik-IT, warum Patientendaten nicht importiert werden können? ab.
Der Fall wird in Recare als neuer Fall angelegt oder der Import schlägt nur in einem Mandanten fehl. Das deutet auf die Mandanten- und Standortzuordnung hin und ist ein eigenes Fehlerbild.
Der Import bricht mit Fehler 500 ab. Das ist ebenfalls ein eigenes Fehlerbild.
Wenden Sie sich in den letzten beiden Fällen mit Fallnummer, Zeitstempel und Fehlercode an den Recare Kundenservice.
Schritt 1: Fallnummer in den Logs suchen
Durchsuchen Sie das lokale Log
C:\Recare\recare.lognach der Fallnummer und nach der zugehörigen Nachricht.Bei Fehlercode 404: Stellen Sie zusätzlich die
recare.logder Gateway-VM zum betroffenen Zeitraum bereit und suchen Sie darin nachdeleted patient with case idbeziehungsweiseGetPatient - could not find patient.Melden Sie Fallnummer und Zeitstempel an den Recare Kundenservice. Der Support durchsucht parallel die serverseitigen Logs nach der Fallnummer und teilt Ihnen das Ergebnis mit.
So werten Sie den Logbefund aus:
Im Log stehen
deleted patient with case id,GetPatient - could not find patientoderMDM: patient cannot be Nil: siehe Ursache 1.Die Fallnummer ist nirgends auffindbar: siehe Ursache 2.
Die Nachricht ist vorhanden, enthält aber nicht das erwartete Feld oder Segment: siehe Ursache 3. Prüfen Sie zusätzlich mit dem Recare Kundenservice das Mapping.
Die Nachricht ist laut Kommunikationsserver ausgegangen, am Gateway aber nicht verarbeitet: siehe Ursache 4.
Ursache 1: Der Fall wurde auf dem Gateway bereits gelöscht
Das ist die häufigste Ursache. Das Gateway hält fallbezogene Daten nur für eine begrenzte Zeit vor und entfernt sie danach nach den konfigurierten Löschregeln.
Daran erkennen Sie diese Ursache:
Der Import bricht mit 404 „Patient nicht gefunden“ ab.
Im Log steht
deleted patient with case id ...oderGetPatient - could not find patient ....Beim Dokumentversand erscheint
MDM: patient cannot be Nil.
Betroffen sind typischerweise ältere Fälle, Langlieger und Häuser, die Fälle spät abrechnen. Teilweise liegen mehr als drei Monate zwischen Aufnahme und Dokumentversand.
Den Abschnitt Vorhaltedauer der fallbezogenen Daten finden Sie in der technischen Dokumentation unter https://his-integrations.docs.recaresolutions.com. Die Dokumentation ist passwortgeschützt. Das Passwort wurde Ihnen im Rahmen der Integration mitgeteilt. Falls es nicht vorliegt, erfragen Sie es beim Recare Kundenservice.
Notiz: Wie lange fallbezogene Daten in Ihrer Installation vorgehalten werden und ob die Vorhaltedauer angepasst werden kann, klären Sie bitte mit dem Recare Kundenservice.
Workaround: Fall im KIS ändern
Nehmen Sie im KIS eine minimale Änderung an den Patienten- beziehungsweise Falldaten vor und speichern Sie sie.
Dadurch geht eine neue HL7-Nachricht (A08) an das Gateway und die Daten werden nachgesendet.
Stoßen Sie den Import in Recare erneut an beziehungsweise wiederholen Sie den Dokumentversand.
Ursache 2: Die ADT-Nachricht hat das Gateway nie erreicht
Taucht die Fallnummer weder in den serverseitigen Logs noch im lokalen Log C:\Recare\recare.log auf, hat das Gateway die Nachricht nie erhalten. Die Ursache liegt dann auf KIS-Seite beziehungsweise beim Kommunikationsserver.
Prüfen Sie im Kommunikationsserver, ob eine Nachricht zu dieser Fallnummer versandt wurde, und notieren Sie den Zeitstempel.
Binden Sie den KIS-Anbieter oder den Dienstleister des Kommunikationsservers ein.
Wichtig: Die Schnittstelle auf der KIS-Seite fällt nicht in den Zuständigkeitsbereich von Recare. Recare kann nur bestätigen, ob eine Nachricht am Gateway angekommen ist.
Ursache 3: Für den Fall kommen keine oder unvollständige ADT-Nachrichten an
Manche KIS beziehungsweise Kommunikationsserver senden für einen Fall gar keine oder nur unvollständige ADT-Nachrichten. Erkennbar ist das daran, dass in den Rohnachrichten zum Beispiel nur ADT-A03 und BAR-P12 mit nahezu leerem PID-Segment ankommen und keine A08.
Teilweise ist das bewusst als Datenschutzfilter eingerichtet: Erst ein Sozialdienstauftrag mit der Methode Recare erzeugt eine ORM, die der Kommunikationsserver in eine A08 wandelt.
Prüfen Sie die HL7-Rohnachrichten in den Gateway-Logs oder über die Testseite: Welche Nachrichtentypen kommen an, ist eine A08 dabei, und ist die Fallnummer enthalten?
Fehlen die A08, binden Sie den Dienstleister des Kommunikationsservers oder die KIS-IT ein.
Berücksichtigen Sie bei A31 und A40, dass die Zuordnung über die Patienten-ID läuft und nicht über die Fallnummer.
Notiz: Welche Nachrichtentypen und ADT-Felder ausgewertet werden, unterscheidet 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.
Ursache 4: Die Nachricht enthält keine Fallnummer
Nachrichten ohne Fallnummer werden am Gateway verworfen. Erkennbar ist das daran, dass die Nachricht im Kommunikationsserver als ausgegangen protokolliert, am Gateway aber nicht verarbeitet ist.
Prüfen Sie, ob die Nachricht überhaupt eine Fallnummer enthält.
Ausnahme sind A31 und A40: Diese Nachrichten werden über die Patienten-ID zugeordnet.
Diese Angaben benötigt der Recare Kundenservice
die Fallnummer und den Zeitstempel des Sendens beziehungsweise des Importversuchs
das Alter des Falls, also wie lange die Aufnahme zurückliegt
die Information, ob der Fall aus der Zeit vor Aktivierung der Schnittstelle stammt, und seit wann die Schnittstelle produktiv genutzt wird
das lokale Log
C:\Recare\recare.logbeziehungsweise dierecare.logder Gateway-VM zum betroffenen Zeitraumden Fehlercode und den genauen Fehlertext, idealerweise als Screenshot
die Information, ob im KIS eine Änderung am Fall vorgenommen und der Import danach erneut geprüft wurde
die Information, welche ADT-Nachrichtentypen für diesen Fall an das Gateway gesendet werden, insbesondere ob A08 ankommen
FAQs
Warum lässt sich eine einzelne Fallnummer nicht importieren, obwohl der Patient im KIS existiert?
Eine einzelne Fallnummer lässt sich meist dann nicht importieren, wenn das Gateway den Fall nach den Löschregeln bereits entfernt hat oder wenn die ADT-Nachricht das Gateway nie erreicht hat. Ob die Fallnummer am Gateway angekommen ist, zeigt die Logsuche nach der Fallnummer.
Was bedeutet der Fehlercode 404 „Patient nicht gefunden“?
Der Fehlercode 404 „Patient nicht gefunden“ bedeutet, dass zu dieser Fallnummer keine Daten mehr auf dem Gateway liegen. Im Log stehen dann Meldungen wie deleted patient with case id oder GetPatient - could not find patient.
Was bedeutet die Logmeldung MDM: patient cannot be Nil?
Die Logmeldung MDM: patient cannot be Nil bedeutet, dass die fallbezogenen Daten zum Zeitpunkt des Dokumentversands nicht mehr auf dem Gateway lagen. Sie tritt typischerweise beim Versand eines Dokuments zu einem älteren Fall auf und kann nur vom Recare Kundenservice geprüft werden.
Wie lange werden fallbezogene Daten auf dem Gateway vorgehalten?
Fallbezogene Daten werden nur für eine begrenzte Zeit vorgehalten und danach nach den konfigurierten Löschregeln entfernt. Die Details beschreibt der Abschnitt Vorhaltedauer der fallbezogenen Daten in der technischen Dokumentation. Welche Vorhaltedauer für Ihre Installation gilt, klären Sie mit dem Recare Kundenservice.
Wie kann ein bereits gelöschter Fall erneut importiert werden?
Ein bereits gelöschter Fall kann erneut importiert werden, indem Sie im KIS eine minimale Änderung an den Patientendaten vornehmen und speichern. Dadurch geht eine neue HL7-Nachricht (A08) an das Gateway und die Daten werden nachgesendet.
Was ist zu tun, wenn die Fallnummer in keinem Log auftaucht?
Wenn die Fallnummer in keinem Log auftaucht, hat das Gateway die Nachricht nie erhalten. Lassen Sie in diesem Fall die KIS-Seite und den Kommunikationsserver prüfen und binden Sie den KIS-Anbieter oder den Dienstleister des Kommunikationsservers ein.
Warum kommen für einen Fall nur A03 und BAR-P12 an?
Wenn für einen Fall nur A03 und BAR-P12 mit nahezu leerem PID-Segment ankommen, sendet das KIS beziehungsweise der Kommunikationsserver keine A08. Teilweise ist das bewusst als Datenschutzfilter eingerichtet, sodass erst ein Sozialdienstauftrag mit der Methode Recare eine entsprechende Nachricht auslöst.
Werden Nachrichten ohne Fallnummer verarbeitet?
Nein, Nachrichten ohne Fallnummer werden am Gateway verworfen. Ausnahme sind A31 und A40, die über die Patienten-ID zugeordnet werden.
Welche Angaben benötigt der Recare Kundenservice?
Der Recare Kundenservice benötigt die Fallnummer und den Zeitstempel, das Alter des Falls, das lokale Log beziehungsweise die recare.log der Gateway-VM zum betroffenen Zeitraum, den Fehlercode mit genauem Fehlertext, die Information, ob im KIS eine Änderung vorgenommen wurde, und die Information, welche ADT-Nachrichtentypen für den Fall gesendet werden.