Patient Service: Query API

Die Query API: Patient Service ermöglicht es dem Versicherten, seine Versicherteninformationen im ePA-Aktensystem abzurufen.

Einsatzbereich

Das ePA-FdV rufen die Versicherteninformationen ab, um dem Akteninhaber Einsicht in seine gespeicherten Daten zu ermöglichen.

Nachricht

Die Nachricht zum Abruf der Versicherteninformationen wird als HTTP GET-Anfrage an den Patient Service gesendet, um die aktuellen Daten des Versicherten abzurufen.

Auslösung

Wenn das ePA-FdV die Versicherteninformationen abrufen möchte, sendet es eine Query API: Patient Service Nachricht an den Patient Service.

Resource API

Bei Anfragen an die Query API für die Patient-Ressource wird die Antwort als ein FHIR Bundle des Typs searchset zurückgegeben. Dieses Bundle enthält eine Instanz der Patient-Ressource.

contentTypes: - "application/fhir+xml" - "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: "-" 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" - statusCode: '404' description: "Not found" errorCode: "-" note: "EPAOperationOutcome" base: "[base]" paths: /epa/patient/api/v1/fhir/Patient: get: include: - "#default-api" - "#query-responses" operationId: "listPatient_PatientSvc" fhir: capabilityStatement: url: "./CapabilityStatement-epa-patient-server.json" forResourceType: "Patient" responseExamples: - name: "application/fhir+json" type: JSON url: './Bundle-example-searchset-patient.json' - name: "application/fhir+xml" type: XML url: './Bundle-example-searchset-patient.xml' Der Patient Service MUSS die Suchparameter der Ressource Patient verarbeiten können, wie sie im CapabilityStatement mit dem Namen EPAPatientServer festgelegt sind.

Resource API (Versionshistorie)

base: "[base]" paths: /epa/patient/api/v1/fhir/Patient/_history: get: include: - "#default-api" - "#history-response" operationId: "listPatient_PatientSvc" responseExamples: - name: "application/fhir+json" type: JSON url: './Bundle-example-patient-history-bundle.json' - name: "application/fhir+xml" type: XML url: './Bundle-example-patient-history-bundle.xml'

Instance API

base: "[base]" paths: /epa/patient/api/v1/fhir/Patient/[id]: get: include: - "#default-api" - "#instance-responses" operationId: "getPatientById_PatientSvc" /epa/patient/api/v1/fhir/Patient/[id]/_history: get: include: - "#default-api" - "#instance-responses" operationId: "getPatientById_PatientSvc" /epa/patient/api/v1/fhir/Patient/[id]/_history/[versionId]: get: include: - "#default-api" - "#instance-responses" operationId: "getPatientById_PatientSvc"

Sicherheitsanforderungen

Der Patient Service MUSS die gesetzlich verbindlichen Regelungen der Zugriffsrechte bzgl. der Berufsgruppen und Datenkategorien aus der [gemSpec_Aktensystem_ePAfueralle#Legal Policy] berücksichtigen. Die generelle Ausführung der Abrufen von Versicherteninformationen Operation des Patient Service ist ausschließlich für ePA-Client-Systeme mit der Nutzergruppe aus der nachstehenden Liste durchzuführen:

professionOID
oid_versicherter

Generelle Sicherheitsanforderungen werden hier festgehalten.

Protokollierung

Die Protokollierung erfolgt über den Patient Service. Weitere Anforderungen sind [gemSpec_Aktensystem_ePAfueralle#Protokollierung] zu entnehmen.