2025.2.0 - ci-build
IGTTPFHIRGatewayEPIX - Local Development build (v2025.2.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions
OperationDefinition: addPatient
| Official URL: https://ths-greifswald.de/fhir/OperationDefinition/epix/AddPatient | Version: 2025.2.0 | |||
| Draft as of 2026-02-05 | Computable Name: AddPatient | |||
Fügt eine oder mehrere Patientenidentitäten hinzu.
Zweck
Anlegen und Matching (Record Linkage) von übermittelten Patienten-Resourcen auf Basis der personenidentifizierenden Informationen (IDAT) im E-PIX.
Dabei werden eine oder mehrere Patientenidentitäten im E-PIX erzeugt. Nach Abschluss des Record Linkage Prozesses werden für jede übermittelte Patienten-Resource der Master Person Index (MPI ID), die MPI-Zuordnung (Person-Ressource) sowie der Match-Status und vorhandene Identitäten zurückgegeben.
URL: [base]/$addPatient
Parameters
| Use | Name | Scope | Cardinality | Type | Binding | Documentation |
| IN | domain | 1..1 | string | Angabe der Matching-Domaene | ||
| IN | source | 1..1 | string | Datenquelle | ||
| IN | identity | 1..* | Patient | Patient-Ressource (analog zu Patienten-Identität). | ||
| IN | saveAction | 1..1 | Coding | https://ths-greifswald.de/fhir/ValueSet/epix/SaveAction (Required) | ||
| IN | forceReferenceUpdate | 1..1 | boolean | |||
| OUT | matchResult | 1..* | Match-Ergebnis zu einer übergebenen Patienten-Identität. Für jeden im Request übergebenen identity-Parameter wird genau ein matchResult zurück gegeben. | |||
| OUT | matchResult.sourceIdentity | 1..1 | Patient | Die im Request übergebene, unveränderte Patienten-Ressource, auf die sich dieses Match-Ergebnis bezieht. | ||
| OUT | matchResult.matchStatus | 1..1 | Coding | https://ths-greifswald.de/fhir/ValueSet/epix/MatchStatus (Required) | Match-Status aus dem Matching der übermittelten Patienten-Identität | |
| OUT | matchResult.mpiPerson | 0..1 | Person | Person-Ressource, die den MPI-Eintrag repräsentiert. | ||
| OUT | matchResult.identity | 0..* | Patient | Patient-Ressource (analog zu Patienten-Identität, referenziert aus dem MPI-Index der Personen-Ressource). |
Anlegen und Matching (Record Linkage) von übermittelten Patienten-Resourcen auf Basis der personenidentifizierenden Informationen (IDAT) im E-PIX.
Dabei werden eine oder mehrere Patienten-Identitäten im E-PIX erzeugt. Nach Abschluss des Record Linkage Prozesses werden für jede übermittelte Patienten-Resource der Master Person Index (MPI ID), die MPI-Zuordnung (Person-Ressource) sowie der Match-Status und vorhandene Identitäten zurückgegeben.
Voraussetzung
Die angegebenen Parameter zur Spezifikation der Matching-Domäne und der Datenquelle müssen im E-PIX konfiguriert sein.
Aufruf und Rückgabe
Die bereitgestellte Funktionalität kann per POST-Request aufgerufen werden. Die erforderlichen Angaben werden per POST-BODY in Form von FHIR Parameters übermittelt.
<HOST>:<PORT>/ttp-fhir/fhir/epix/$addPatient
Der Funktionsaufruf liefert eine Parameters-Ressource bestehend aus einem oder mehreren Multi-Part-Parametern zurück.
Die Parameter "identity" und "sourceIdentity" enthalten eine Patient-Ressource entsprechend dem allgemeinen Patient-Profil.
Der Parameter "mpiPerson" enthält eine Person-Ressource entsprechend dem allgemeinen Person-Profil. Die Angabe link.assurance='level4' kennzeichnet hierbei die Referenz-Identität.
Im Erfolgsfall wird der HTTP Statuscode 200 zurückgegeben.
Im Fehlerfall wird einer der folgenden HTTP Statuscodes in Verbindung mit einer OperationOutcome-Ressource zurückgegeben:
- 400: Fehlende oder fehlerhafte Parameter.
- 401: Fehlende Authentifizierung oder Autorisierung.
- 404: Parameter mit unbekanntem Inhalt.
- 422: Fehlende oder falsche Patienten-Attribute.