PractitionerRole abrufen (PractitionerRole Search)

Inhalt

1. Beschreibung und fachlicher Kontext
2. Request
   • Request Header
   • Request Body
     • Suchparameter: ID
     • Suchparameter: Betriebsstättennummer (BSNR)
     • Suchparameter: Arztnummer (ANR)
     • Suchparameter: Anzahl der Suchergebnisse
     • Suchparameter: Seite der Suchergebnisse
   • Beispiele
3. Response
   • Response Header
   • Response Body
   • Beispiele

Beschreibung und fachlicher Kontext

Beim Abrufen von PractitionerRoles handelt es sich um die FHIR-Standardinteraktion search. Diese ermöglicht das Synchronisieren mit dem 116117 Terminservice, um den aktuellen Status einzelner oder mehrerer PractitionerRoles abzurufen.

Die PractitionerRole dient als Verbindung zwischen einer Praxis / medizinischen Einrichtung und einem dort tätigen Arzt. Aufgrund der Einschränkungen der jeweiligen Basisprofile wird in Terminprofilen und Terminbuchungen auf eine PractitionerRole verwiesen. Die Referenzen der Profile untereinander ist auf der Seite FHIR-Ressourcen beschrieben. Dort sind auch die Seiten zu den genannten Profilen verlinkt, unter denen weitere Details zu finden sind.

Das Abrufen der PractitionerRoles ist nur für das Anlegen eines Terminprofils notwendig, da beim Anlegen eines Terminprofils die korrekte PractitionerRole-ID angeben werden muss. Details hierzu sind unter Terminprofil anlegen (Schedule Create) zu finden.

Beim Abrufen der PractitionerRoles sind die übertragenen Datenmengen in der Regel gering. Die maximale Anzahl an PractitionerRoles entspricht der Anzahl der in einer Praxis / medizinischen Einrichtung tätigen Ärzte plus einer weiteren PractitionerRole, die keinen Verweis auf einen Arzt enthält. Ruft eine Praxis / medizinische Einrichtung die PractitionerRoles für die Haupt- und alle Nebenbetriebsstätten ab, ist die Anzahl der zurückgegebenen Ressourcen entsprechend die Summe der Anzahl der Ärzte all dieser Betriebsstätten und der Anzahl der Betriebsstätten.

Generelle Hinweise, die für alle search interactions gelten, sind auf der Seite Operationen und Interaktionen gelistet. Dort sind auch detaillierte Informationen zum Thema Paging zu finden.

Request

Das Abrufen von PractitionerRoles erfordert einen POST-Request. Es können entweder alle PractitionerRoles aller autorisierten Einrichtungen oder nur bestimmte PractitionerRoles anhand entsprechender Suchparameter im Request Body abgefragt werden (siehe hierzu Abschnitt Request Body).

Bitte beachten: Laut FHIR-Standard wäre auch eine Suche mit Suchparametern innerhalb der URL und / oder mittels GET-Request möglich, was durch die Systeme des 116117 Terminservices jedoch NICHT unterstützt wird. Ein GET-Request auf die oben angegebene URL führt zu einem Fehler. Suchparameter in der URL werden von den Systemen des 116117 Terminservices ignoriert, d.h. weder validiert noch verarbeitet.

Request Header

Folgende Request Header werden von den Systemen des 116117 Terminservices unterstützt und verarbeitet:

Request Body

Der Request Body muss alle Suchparameter enthalten, nach denen die Suchergebnisse gefiltert werden sollen.

In den folgenden Abschnitten werden die einzelnen Suchparameter im Detail beschrieben. Suchparameter, die hier nicht aufgelistet sind, aber dennoch im Request Body übergeben werden, werden von den Systemen des 116117 Terminservices ignoriert. Das bedeutet, dass die Systeme des 116117 Terminservice diese Suchparameter nicht verarbeiten. Es wird in diesem Fall KEIN Fehler geworfen; die Suche wird ohne die unbekannten Suchparameter durchgeführt.

Bitte beachten: Die Systeme des 116117 Terminservices prüfen bei Angabe mehrerer Suchparameter nur bedingt auf Plausibilität. Das bedeutet, dass nicht zwangsweise eine Fehlermeldung als Response zurückkommt, wenn sich mehrere Suchparameter gegenseitig ausschließen. Beispiele hierfür sind UND-Verknüpfungen bei mehreren BSNRs oder eine UND-Verknüpfung einer ANR und einer BSNR, wobei der zur ANR zugehörige Arzt nicht in der Praxis / medizinischen Einrichtung arbeitet, die zur angegebene BSNR gehört. In solchen Fällen kommt der HTTP-Statuscode 200 OK mit einem Searchset Bundle (im Response Body) zurück, welches KEINE Suchergebnisse enthält.

Suchparameter: ID

Suchparameter: Betriebsstättennummer (BSNR)

Suchparameter: Arztnummer (ANR)

Suchparameter: Anzahl der Suchergebnisse

Suchparameter: Seite der Suchergebnisse

¹ Wie Parameter mit UND bzw. ODER verknüpft werden können, ist in der HL7-FHIR-Dokumentation unter Search – Standard Parameters: Composite Search Parameters beschrieben.

² Die möglichen Präfixe sind in der HL7-FHIR-Dokumentation unter Search – Standard Parameters: Prefixes beschrieben.

Beispiele

Beispiel 1: Suche anhand einer ANR

# Suche die PractitionerRole, die der ANR 123456789 zugeordnet ist
POST https://terminsynchronisation.eterminservice.kv-safenet.de/pvs​/terminsynchronisation/api/PractitionerRole/_search
Content-Type: application/x-www-form-urlencoded
anr=123456789

Beispiel 2: Suche anhand mehrerer IDs

# Suche alle PractitionerRoles, die eine der folgenden IDs haben: 123456789, 123456789-1122334
POST https://terminsynchronisation.eterminservice.kv-safenet.de/pvs​/terminsynchronisation/api/PractitionerRole/_search
Content-Type: application/x-www-form-urlencoded
_id=123456789,123456789-1122334

Beispiel 3: Suche anhand einer BSNR

# Suche alle PractitionerRoles, die der BSNR 123456789 zugeordnet sind
POST https://terminsynchronisation.eterminservice.kv-safenet.de/pvs​/terminsynchronisation/api/PractitionerRole/_search
Content-Type: application/x-www-form-urlencoded
bsnr=123456789

Response

Für die Suche von PractitionerRoles wird im Erfolgsfall der HTTP-Statuscode 200 OK sowie ein Searchset Bundle im Response Body zurückgegeben.

• Wurden bei der Suche keine Suchparameter übergeben, enthält das zurückgegebene Searchset alle PractitionerRoles, die den Haupt- und Nebenbetriebsstätten der in der Autorisierung übergebenen BSNRs zugeordnet sind.

• Wurde bei der Suche mindestens ein Suchparameter übergeben, enthält dieses Searchset alle PractitionerRoles, die anhand der Suchparameter in Verbindung mit den autorisierten BSNRs ermittelt werden konnten.

Im Fehlerfall wird ein dem Fehler entsprechender HTTP-Statuscode (bspw. 400 Bad Request oder 500 Internal Server Error) sowie ein OperationOutcome im Response Body zurückgegeben. Dieses OperationOutcome enthält Details zum aufgetretenen Fehler.

Response Header

Folgende Response Header werden von den Systemen des 116117 Terminservices gesetzt und an den Anfragenden zurückgesendet:

Response Body

Im Erfolgsfall ist im Response Body ein Searchset Bundle enthalten, welches folgende Ressourcen und Informationen enthält:

• Suchergebnisse, wenn vorhanden: PractitionerRoles (im Element Bundle.entry)

• Alle Suchparameter, die durch die Systeme des 116117 Terminservices verarbeitet und für die Suche genutzt wurden (im Element Bundle.link)

• Verweis auf die vorherige und / oder nächste Seite der Suchergebnisse, wenn vorhanden (im Element Bundle.link)

  • Bitte beachten: Hierbei handelt es sich um einen Verweis in Form einer URL – um die Seite tatsächlich abzurufen, muss jedoch ein POST-Request mit den Suchparametern im Request Body abgeschickt werden.

  • Details zum Thema Paging sind auf der Seite Operationen und Interaktionen zu finden.

• Folgende in den PractitionerRoles referenzierte Ressourcen:

  • Arzt (Practitioner)

Details zum Searchset Bundle sind unter Profil: Suchergebnisse (Bundle) zu finden.

Im Fehlerfall ist im Response Body ein OperationOutcome enthalten. Details hierzu sind unter Profil: Fehler (OperationOutcome) zu finden.

Beispiele

Alle Beispiele für den Erfolgsfall sind hier im vorliegenden Projekt zu finden.

Alle Beispiele für den Fehlerfall sind hier im vorliegenden Projekt zu finden.