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?

Mögliche 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.

Mögliche Lösung: Die angegebenen Suchparameter sollten geprüft und ggf. angepasst werden.


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

Mögliche Ursache: Der gesendete Request ist nicht valide.

  • Beispiel: Unerlaubte Werte oder Zeichen in einem Suchparameter

Mögliche Lösung: Der Request muss korrigiert werden.

  • 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?

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

Mögliche Lösung: Es muss ein neuer Access Token angefragt werden.


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.

Mögliche 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.

Mögliche Lösung: Die zuständige KV sollte um Korrektur der Stammdaten gebeten werden.

  • 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.

Mögliche 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.

Mögliche Lösung: Der Access Token und der Request müssen überprüft und ggf. korrigiert werden.

  • 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?

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

Mögliche Lösung: Die HTTP-Methode muss korrigiert werden.


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

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

Mögliche Lösung: Der Request Header muss korrigiert werden.

  • 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?

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

Mögliche Lösung: Entweder muss der Request Header Content-Type oder der Request Body korrigiert werden.

  • 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?

Mögliche Ursache: Es gibt ein technisches Problem beim 116117 Terminservice.

Mögliche Lösung: Es sollte ein Support-Ticket vom Typ Fehler mit folgenden Angaben im Serviceportal 116117 Terminservice der kv.digital GmbH erstellt werden:

  • Angabe des betroffenen Systems
  • Angabe der betroffenen Komponente
  • Request-Details (URL, Request Header und Request Body)
  • Response-Details (HTTP-Statuscode, Response Header und Response Body)
  • Zeitpunkt, wann der Fehler aufgetreten ist
  • Sonstige Details, die für die Repdroduktion des Fehlers relevant sein könnten.

Es gibt Fragen oder Probleme, die nicht im vorliegenden Implementation Guide oder der zugehörigen Spezifikation beschrieben sind?

Im Serviceportal 116117 Terminservice der kv.digital GmbH kann ein Support-Ticket vom Typ Fehler, Frage oder Wunsch erstellt werden, um Fehler zu melden, Verständnisfragen zu klären oder Verbesserungsvorschläge zu machen.