Implementation Guide
ePA Medication Service
Version 1.0.5-1 - release

## Query API: PractitionerRole

Die Query API: PractitionerRole ermöglicht den Abruf von Daten zur Zuordnung von Leistungserbringenden zu Leistungserbringerinstitutionen im Medication Service, wie z. B. der Verbindung zwischen Ärzt:innen oder Apotheker:innen und ihren jeweiligen Praxen oder Apotheken.

### Nachricht

Die Nachricht zum Abruf von Daten zur Zuordnung von Leistungserbringenden zu Leistungserbringerinstitutionen wird als HTTP GET-Anfrage an den Medication Service gesendet, um eine Liste der hinterlegten PractitionerRole-Instanzen abzurufen.

#### Auslösung

Wenn das ePA-Client-System eine Suche nach der Zuordnung von Leistungserbringenden zu Leistungserbringerinstitutionen durchführen und dazu die korrespondierenden PractitionerRole-Ressourcen ermitteln möchte, sendet es eine Query API: PractitionerRole-Nachricht an den Medication Service. Das ePA-Client-System verarbeitet die Antwort und bringt sie zur Anzeige.

#### Resource API

Anfragen an die PractitionerRole-Ressource können über die RESTful API mittels HTTP GET-Anfragen durchgeführt werden. Dabei können spezifische Suchparameter genutzt werden, um die Anfragen zu verfeinern.

Bei Anfragen an die QueryAPI für die PractitionerRole-Ressource wird die Antwort als ein FHIR Bundle des Typs searchset zurückgegeben. Dieses Bundle enthält eine Sammlung von Einträgen, die jeweils eine Instanz der PractitionerRole-Ressource oder weitere Ressourcen im Zusammenhang mit der Abfrage enthalten können.

contentTypes: - "application/fhir+json" headerParams: - name: "x-insurantid" expectation: "MUSS" type: "string" description: "Health Record Identifier" - name: "x-useragent" expectation: "MUSS" type: "string" description: "User Agent Information" - name: "X-Request-ID" expectation: "MUSS" type: "string" description: "UUID der Nachricht" responses: - statusCode: '200' description: "Successful operation" errorCode: "-" note: "-" - statusCode: '400' description: "Unknown search parameter" errorCode: "-" note: "EPAOperationOutcome" - statusCode: '400' description: "Invalid query parameter(s)" errorCode: "-" note: "EPAOperationOutcome" - statusCode: '400' description: "Invalid request" errorCode: "-" note: "EPAOperationOutcome" - statusCode: '404' description: "Unknown resource type" errorCode: "-" note: "EPAOperationOutcome" responses: - statusCode: '200' description: "Successful operation" errorCode: "-" note: "-" - statusCode: '400' description: "Invalid request" errorCode: "malformedRequest" note: "-" - statusCode: '400' description: "Invalid request" errorCode: "-" note: "EPAOperationOutcome" - statusCode: '404' description: "Unknown resource type" errorCode: "-" note: "EPAOperationOutcome" - statusCode: '404' description: "Resource is not known" errorCode: "-" note: "EPAOperationOutcome" base: "[base]" paths: /epa/medication/api/v1/fhir/PractitionerRole: get: include: - "#default-api" - "#query-responses" operationId: "listPractitionerRoles_MedicationSvc" fhir: capabilityStatement: url: "CapabilityStatement-epa-medication-service-server.json" forResourceType: "PractitionerRole" Der Medication Service MUSS die Suchparameter der Ressource PractitionerRole verarbeiten können, wie sie im CapabilityStatement mit dem Namen EPAMedicationServiceServer festgelegt sind. Die Standardsortierung des Medication Service für die Ressource PractitionerRole MUSS anhand des Attributs _lastUpdated erfolgen.

#### Instance API

Um spezifische Details zu einer einzelnen PractitionerRole-Instanz über die RESTful API zu erhalten, kann die PractitionerRole Instance API verwendet werden, indem eine HTTP GET-Anfrage an den Endpunkt /PractitionerRole/[id] gesendet wird.

base: "[base]" paths: /epa/medication/api/v1/fhir/PractitionerRole/[id]: get: include: - "#default-api" - "#instance-responses" operationId: "getPractitionerRoleById_MedicationSvc"

#### Verarbeitung

Der Medication Service verarbeitet die Anfrage, um die PractitionerRole-Einträge zu ermitteln, die den angegebenen Suchparametern entsprechen. Darüber hinaus gibt er einen zur Verarbeitung passenden HTTP Status Code sowie ein FHIR Bundle der passenden PractitionerRole-Ressourcen zurück.

### Sicherheitsanforderungen

Generelle Sicherheitsanforderungen werden hier festgehalten.