FAQ

Als Response bei einer Suche kommt der HTTP-Statuscode 200 OK zurück, aber das Bundle mit den Suchergebnissen enthält keine Einträge. Woran liegt das und was ist zu tun?

Ursache: Der Request an sich ist valide und konnte auch erfolgreich verarbeitet werden. Im 116117 Terminservice sind jedoch keine Ressourcen vorhanden, die zurückgegeben werden können.

  • Möglichkeit 1: Die gesetzten Suchparameter sind nicht widersprüchlich, dennoch wurden mit den Suchparametern keine Ressourcen im 116117 Terminservice gefunden.

    • Ein Beispiel hierfür ist eine Suche nach Appointments mit einer ANR als Suchparameter: Existiert im 116117 Terminservice keine Terminbuchung, die dem Arzt mit der angegebenen ANR zugeordnet ist, enthält das Bundle mit den Suchergebnissen keinen Eintrag.

  • Möglichkeit 2: Die angegebenen Suchparameter schließen sich gegenseitig aus.

    • Wie auf den Seiten zu den jeweiligen search interactions beschrieben, prüfen die Systeme des 116117 Terminservices nur bedingt auf Plausibilität.

    • Ein Beispiel hierfür ist die Suche nach Appointments mit einer ANR und einer BSNR als Suchparameter: Die Systeme des 116117 Terminservices prüfen vorab NICHT, ob der Arzt mit der angegebenen ANR tatsächlich in der Praxis mit der angegebenen BSNR tätig ist. Ist der Arzt nicht in der Praxis tätig, wird kein Fehler sondern ein leeres Bundle zurückgegeben.

Lösung: Suchparameter prüfen und ggf. anpassen


Als Response auf einen Request kommt der HTTP-Statuscode 400 Bad Request zurück. Woran liegt das und was ist zu tun?

Ursache: Der gesendete Request ist nicht valide.

  • Beispiel: Unerlaubte Werte oder Zeichen in einem Suchparameter

Lösung: Request korrigieren

  • Das im Response Body enthaltene OperationOutcome enthält nähere Informationen zum aufgetrenen Fehler.

Als Response auf einen Request kommt der HTTP-Statuscode 401 Unauthorized zurück. Woran liegt das und was ist zu tun?

Ursache: Der Access Token, der im Header Authorization übergeben wurde, ist ungültig.

Lösung: Neuen Access Token anfragen


Als Response auf einen Request kommt der HTTP-Statuscode 403 Forbidden zurück und das OperationOutcome enthält den Fehler TVSTS1006. Woran liegt das und was ist zu tun?

Voraussetzung: Das OperationOutcome, welches im Response Body vom 116117 Terminservice zurückgegeben wird, enthält folgende Werte:

  • OperationOutcome.issue.details.coding.code: TVSTS1006

  • OperationOutcome.issue.details.coding.display: Die Ärzte in der Einrichtung enthalten nicht alle notwendigen Daten, um die Terminsynchronisationsschnittstelle nutzen zu können.

Ursache: Bei den in der Fehlermeldung erwähnten Daten handelt es sich um die Stammdaten der Ärzte. Diese Stammdaten werden von den KVen bereitgestellt und per Stammdatenimport an den 116117 Terminservice übermittelt. Fehlt in den Stammdaten der Nachname und / oder die Arztnummerfachgruppen eines Arztes, können durch den 116117 Terminservice keine FHIR-Ressourcen erstellt und zurückgegeben werden, die diesen Arzt betreffen. (Die Arztnummerfachgruppe ist die zweistellige Fachgruppencodierung für die 8. und 9. Stelle der ANR.) Wenn ein PVS für eine Praxis autorisiert ist, in der ein Arzt mit unvollständigen Stammdaten tätig ist und einen Request an den 116117 Terminservice schickt, kommt demnach der oben genannte Fehler zurück.

Lösung: Zuständige KV kontaktieren und um Korrektur der Stammdaten bitten

  • Hinweis: Erst, wenn die vollständigen Stammdaten an den 116117 Terminservice übertragen wurden, wird der Request des PVS nicht mehr vom 116117 Terminservice mit dem oben genannten Fehler abgelehnt.

Als Response auf einen Request kommt der HTTP-Statuscode 403 Forbidden zurück. Woran liegt das und was ist zu tun?

Voraussetzung: Das OperationOutcome, welches im Response Body vom 116117 Terminservice zurückgegeben wird, enthält im Element OperationOutcome.issue.details.coding.code NICHT den Wert TVSTS1006.

Ursache: Die Authentifizierung für die Schnittstelle war erfolgreich, aber der Anfragende ist nicht für die gewünschte Aktion autorisiert. Das bedeutet, dass der Access Token, der im Header Authorization übergeben wurde, an sich gültig ist. Die BSNR der Praxis, für die Ressourcen abgerufen, angelegt, verändert oder gelöscht werden sollen, ist jedoch NICHT im Access Token enthalten.

  • Beispiel: Der Anfragende möchte einen Terminslot für die Praxis A anlegen. Im Request übergibt der Anfragende seinen Access Token, der jedoch nur die BSNR der Praxis B enthält. Der 116117 Terminservice validiert den Access Token und prüft den Request Body. Da der Terminslot für die Praxis A angelegt werden soll, der Access Token aber nur die BSNR der Praxis B enthält, gibt der 116117 Terminservice den HTTP-Statuscode 403 zurück.

Lösung: Access Token und Request überprüfen

  • Wurde der Access Token für die richtige BSNR angefordert?

  • Beim Abrufen von Ressourcen mit dem Suchparameter BSNR: Ist die BSNR korrekt, die im Request Body als Suchparameter angegeben wurde?

  • Beim Verändern oder Anlegen von Ressourcen: Wird innerhalb der Ressource, die im Request Body übergeben wird, auf die richtige Praxis verwiesen?

    • Hinweis: Bei einigen Ressourcen wird in der Ressource nicht direkt die BSNR angegeben sondern auf die PractitionerRole verwiesen, die wiederum die BSNR der Praxis enthält. Dies ist bspw. bei Terminprofilen der Fall. Hier muss entsprechend geprüft werden, ob auf die korrekte PractitionerRole verwies wurde.

  • Beim Verändern oder Löschen von Ressourcen: Ist die ID der Ressource korrekt, die in der URL angegeben wurde?

    • Hinweis: Wird eine falsche ID angegeben, kann es sich um eine Ressource einer anderen Praxis handeln. Ist der Anfragende für diese Praxis nicht autorisiert, darf der Anfragenden die Ressource nicht verändern oder löschen.

Als Response auf einen Request kommt der HTTP-Statuscode 405 Method Not Allowed zurück. Woran liegt das und was ist zu tun?

Ursache: Der angefragte Endpunkt existiert, aber die im Request verwendete HTTP-Methode ist für diesen Endpunkt nicht zulässig.

Lösung: HTTP-Methode korrigieren


Als Response auf einen Request kommt der HTTP-Statuscode 412 Precondition Failed zurück. Woran liegt das und was ist zu tun?

Ursache: Ein verpflichtender Request Header fehlt oder enthält einen nicht erlaubten Wert.

Lösung: Request Header korrigieren

  • Die erforderlichen Request Header inkl. der erlaubten Werte und Beispiele sind auf den Seiten zu den jeweiligen Operationen und Interaktionen zu finden.

Als Response auf einen Request kommt der HTTP-Statuscode 415 Unsupported Media Type zurück. Woran liegt das und was ist zu tun?

Ursache: Der Request Header Content-Type fehlt oder enthält einen nicht erlaubten Wert oder der Request Body hat das falsche Format.

Lösung: Request Header Content-Type oder Request Body korrigieren

  • Die erlaubten Werte für alle Request Header sowie Beispiele für den Request Body sind auf den Seiten zu den jeweiligen Operationen und Interaktionen zu finden.

Als Response auf einen Request kommt der HTTP-Statuscode 500 Internal Server Error zurück. Woran liegt das und was ist zu tun?

Ursache: Es gibt ein technisches Problem beim 116117 Terminservice.

Lösung: Support-Ticket vom Typ Fehler im Serviceportal 116117 Terminservice der kv.digital GmbH erstellen