Patient (Patient)
Die nachfolgenden Festlegungen spezifizieren die Abbildung von Minimalanforderungen für die Bereitstellung von administrativen Patientendaten im Rahmen des Bestätigungsverfahrens der gematik.
Motivation
Der Austausch administrativer Patientendaten ist eine der grundlegenden Funktionalitäten beim Datenaustausch in der klinischen Versorgung.
In FHIR werden sämtliche klinischen Ressourcen durch Verlinkung auf die Ressource 'Patient' in einen Patientenkontext gestellt.
Die Herstellung des korrekten Patientenkontextes durch Suchen der Patientenressource anhand von Eigenschaften wie Aufnahmenummer, Name oder Geburtsdatum, die Anzeige der zutreffenden Suchergebnisse und der Auswahl bzw. Bestätigung des richtigen Datensatzes durch den Anwender steht am Beginn der meisten klinischen Workflows.
Kompatibilität
Dieses Profil basiert auf dem Profil KBV_PR_Base_Patient der KBV Basisprofile.
Instanzen, die gegen ISiKPatient valide sind, sind auch valide gegen:
- Profil KBV_PR_Base_Patient der KBV Basisprofile - v1.2.1
- Profil Patient im International Patient Summary (IPS) - STU-1
- Profil Patient der MI-Initiative - v2.0.0
- wenn in indentifier:pid.assigner eine Referenz auf eine Organisation angegeben wurde
- wenn in identifier:versichertenId_GKV.assigner die IK-NR der Krankenversicherung angegeben ist
- Profil Patient der KBV Archiv- und Wechselschnittstelle - v1.2.0
- wenn die Ressource einen Narrative enthält und in den Metadaten die Canonical-URL des KBV-Profile angegeben wird
Instanzen, die gegen dieses Profil valide sind, sind nicht valide gegen:
Profil Patient der formularübergreifenden Vorgaben der KBV - v1.0.3 (eRezept/eAU)
Um die Kompatibilität herzustellen sind folgende Schritte erforderlich:- es MUSS genau eine Adresse angegeben werden (Mehrfachangaben sind nicht erlaubt)
- folgende Elemente MÜSSEN entfernt werden:
- active
- identifier:pid
- name:geburtsname
- gender
Profil Patient Deutsches Elektronisches Melde- und Informationssystem für den Infektionsschutz (RKI) - v1.1.1
Aus Gründen der Datensparsamkeit bei der Übermittelung einer Meldung nach Infektionsschutzgesetz müssen bestimmte Datenelemente entfernt werden. Um die Kompatibilität herzustellen sind folgende Schritte erforderlich:- es MUSS der offizielle Name der Person angegeben werden (Angabe des Geburtsnamen nicht erlaubt)
- es MUSS die Straßenanschrift der Person angegeben werden (Angabe einer Postfachadresse nicht erlaubt)
- innerhalb der Straßenanschrift der Person MÜSSEN alle Zustell- oder Abholangaben in eine Adresszeile abgebildet werden
FHIR-Profil
Folgende FHIRPath-Constraints sind im Profil zu beachten:
Anmerkungen zu Must-Support-Feldern
Patient.active
Bedeutung: Indikator "Patientdatensatz ist in aktiver Benutzung"
Hinweise: Siehe Beschreibung in der FHIR Kernspezifikation
Patient.identifier:versichertenId_GKV
Bedeutung: Versicherten ID der gesetzlichen Krankenkasse
Hinweise: Siehe Beschreibung der Deutschen Basisprofile
Patient.identifier:pid
Bedeutung: Organisationsinterner Patienten-Identifier
Hinweise: Siehe Beschreibung der Deutschen Basisprofile
Patient.identifier:versicherungsnummer_pkv
Bedeutung: Versicherten Nr., falls versichert bei einer privaten Krankenkasse
Hinweise: Siehe Beschreibung der Deutschen Basisprofile
Patient.name:name
Bedeutung: Vollständiger Name
Hinweise: Siehe Beschreibung der Deutschen Basisprofile
Patient.name:geburtsname
Bedeutung: Geburtsname des Patienten (nur Nachname)
Hinweise: Siehe Beschreibung der Deutschen Basisprofile
Patient.address:Strassenanschrift
Bedeutung: Straßenadresse
Hinweise: Siehe Beschreibung der Deutschen Basisprofile
Patient.address:Postfach
Bedeutung: Postfachadresse
Hinweise: Siehe Beschreibung der Deutschen Basisprofile
Patient.gender
Bedeutung: Administratives Geschlecht
Hinweise: Siehe Beschreibung der Deutschen Basisprofile
Patient.birthdate
Bedeutung: Geburtsdatum
Hinweise: Siehe Beschreibung der Deutschen Basisprofile
Stornierung von Patienten
Im Rahmen des ISiK Basismoduls SOLLTE die Stornierung eines Patienten entweder durch das Löschen der Patienten-Ressource oder der Verwendung des Feldes Patient.active
abgebildet werden. Dies ist abhängig davon, wie die Stornierung im bestätigungsrelevanten System umgesetzt ist. Im letzteren Fall wird die Stornierung durch das Setzen von Patient.active
auf false
gekennzeichnet.
Interaktionen
Für die Ressource Patient MUSS die REST-Interaktion "READ" implementiert werden.
Für die Ressource Patient KANN die REST-Interaktion "POST" implementiert werden. Diese Interaktion dient für die Vorabübermittelung von (unverifizierten und/oder unvollständigen) Patientenstammdaten.
- Das bestätigungsrelevante System SOLLTE die übermittelte
Patient
-Ressource löschen oder als inaktiv kennzeichnen, insoweit Geschäftsregeln oder andere Gründe dazu führen, dass diePatient
-Ressource nicht permanent im System angelegt wird (z.B. keine Bestätigung durch die Anwender*in des Systems oder keine Aufnahme der Patient*in).
Folgende Suchparameter sind für das Bestätigungsverfahren relevant, auch in Kombination:
Der Suchparameter "_id" MUSS unterstützt werden:
Beispiele:
GET [base]/Patient?_id=103270
Anwendungshinweise: Weitere Informationen zur Suche nach "_id" finden sich in der FHIR-Basisspezifikation - Abschnitt "Parameters for all resources".
Dieser Suchparameter ist für die Umsetzung des IHE PDQm Profils verpflichtend.
Der Suchparameter "identifier" MUSS unterstützt werden:
Beispiele:
GET [base]/Patient?identifier=http://fhir.krankenhaus.example|1032702
GET [base]/Patient?identifier=1032702
Anwendungshinweise: Weitere Informationen zur Suche nach "Patient.identifier" finden sich in der FHIR-Basisspezifikation - Abschnitt "Token Search".
Dieser Suchparameter ist für die Umsetzung des IHE PDQm Profils verpflichtend.
Der Suchparameter "given" MUSS unterstützt werden:
Beispiele:
GET [base]/Patient?given=Erika
Anwendungshinweise: Weitere Informationen zur Suche nach "Patient.name.given" finden sich in der FHIR-Basisspezifikation - Abschnitt "String Search".
Dieser Suchparameter ist für die Umsetzung des IHE PDQm Profils verpflichtend.
Der Suchparameter "family" MUSS unterstützt werden:
Beispiele:
GET [base]/Patient?family=Musterfrau
Anwendungshinweise: Weitere Informationen zur Suche nach "Patient.name.family" finden sich in der FHIR-Basisspezifikation - Abschnitt "String Search".
Dieser Suchparameter ist für die Umsetzung des IHE PDQm Profils verpflichtend.
Der Suchparameter "birthdate" MUSS unterstützt werden:
Beispiele:
GET [base]/Patient?birthdate=1964-12-08
Anwendungshinweise: Weitere Informationen zur Suche nach "Patient.birthDate" finden sich in der FHIR-Basisspezifikation - Abschnitt "Date Search".
Der Suchparameter "gender" MUSS unterstützt werden:
Beispiele:
GET [base]/Patient?gender=female
Anwendungshinweise: Weitere Informationen zur Suche nach "Patient.gender" finden sich in der FHIR-Basisspezifikation - Abschnitt "Token Search".
Dieser Suchparameter ist für die Umsetzung des IHE PDQm Profils verpflichtend.
Der Suchparameter "name" KANN unterstützt werden:
Beispiele:
GET [base]/Patient?name=Erika
GET [base]/Patient?name=Musterfrau
Anwendungshinweise: Weitere Informationen zur Suche nach "Patient.name" finden sich in der FHIR-Basisspezifikation - Abschnitt "String Search".
Der Suchparameter "_profile" KANN unterstützt werden:
Beispiele:
GET [base]/Patient?_profile=https://gematik.de/fhir/ISiK/v2/StructureDefinition/ISiKPatient
Anwendungshinweise: Weitere Informationen zur Suche nach "_profile" finden sich in der FHIR-Basisspezifikation - Abschnitt "Parameters for all resources".
Der Suchparameter "address" KANN unterstützt werden:
Beispiele
GET [base]/Patient?address=Berlin
Anwendungshinweise: Weitere Informationen zur Suche nach "Patient.address" finden sich in der FHIR-Basisspezifikation - Abschnitt "String Search".
Dieser Suchparameter ist für die Umsetzung des IHE PDQm Profils verpflichtend.
Der Suchparameter "address-city" KANN unterstützt werden:
Beispiele:
GET [base]/Patient?address-city=Berlin
Anwendungshinweise: Weitere Informationen zur Suche nach "Patient.address.city" finden sich in der FHIR-Basisspezifikation - Abschnitt "String Search".
Dieser Suchparameter ist für die Umsetzung des IHE PDQm Profils verpflichtend.
Der Suchparameter "address-country" KANN unterstützt werden:
Beispiele:
GET [base]/Patient?address-country=DE
Anwendungshinweise: Weitere Informationen zur Suche nach "Patient.address.country" finden sich in der FHIR-Basisspezifikation - Abschnitt "String Search".
Dieser Suchparameter ist für die Umsetzung des IHE PDQm Profils verpflichtend.
Der Suchparameter "address-postalcode" KANN unterstützt werden:
Beispiele:
GET [base]/Patient?address-postalcode=10117
Anwendungshinweise: Weitere Informationen zur Suche nach "Patient.address.postalCode" finden sich in der FHIR-Basisspezifikation - Abschnitt "String Search".
Dieser Suchparameter ist für die Umsetzung des IHE PDQm Profils verpflichtend.
Der Suchparameter "active" KANN unterstützt werden:
Beispiele:
GET [base]/Patient?active=true
Anwendungshinweise: Weitere Informationen zur Suche nach "Patient.active" finden sich in der FHIR-Basisspezifikation - Abschnitt "Token Search".
Dieser Suchparameter ist für die Umsetzung des IHE PDQm Profils verpflichtend.
Der Suchparameter "telecom" KANN unterstützt werden:
Beispiele:
GET [base]/Patient?telecom=phone|+49152236898
Anwendungshinweise: Weitere Informationen zur Suche nach "Patient.telecom" finden sich in der FHIR-Basisspezifikation - Abschnitt "Token Search".
Dieser Suchparameter ist für die Umsetzung des IHE PDQm Profils verpflichtend.
Beispiele
Valides Minimalbeispiel Patient:
{ "resourceType": "Patient", "id": "PatientinMusterfrau", "meta": { "profile": [ "https://gematik.de/fhir/isik/v2/Basismodul/StructureDefinition/ISiKPatient" ] }, "identifier": [ { "type": { "coding": [ { "system": "http://fhir.de/CodeSystem/identifier-type-de-basis", "code": "GKV" } ] }, "system": "http://fhir.de/sid/gkv/kvid-10", "value": "A123456789" }, { "type": { "coding": [ { "code": "MR", "system": "http://terminology.hl7.org/CodeSystem/v2-0203" } ] }, "system": "https://fhir.krankenhaus.example/NamingSystem/PID", "value": "TestPID" }, { "use": "secondary", "type": { "coding": [ { "code": "PKV", "system": "http://fhir.de/CodeSystem/identifier-type-de-basis" } ] }, "value": "1234567890", "assigner": { "display": "Test PKV AG" } } ], "name": [ { "use": "official", "family": "Fürstin von Musterfrau", "_family": { "extension": [ { "url": "http://fhir.de/StructureDefinition/humanname-namenszusatz", "valueString": "Graf" }, { "url": "http://hl7.org/fhir/StructureDefinition/humanname-own-name", "valueString": "Musterfrau" }, { "url": "http://hl7.org/fhir/StructureDefinition/humanname-own-prefix", "valueString": "von" } ] }, "given": [ "Erika" ], "prefix": [ "Dr." ], "_prefix": [ { "extension": [ { "url": "http://hl7.org/fhir/StructureDefinition/iso21090-EN-qualifier", "valueCode": "AC" } ] } ] }, { "use": "maiden", "family": "Gabler", "_family": { "extension": [ { "url": "http://hl7.org/fhir/StructureDefinition/humanname-own-name", "valueString": "Gabler" } ] } } ], "active": true, "gender": "female", "birthDate": "1964-08-12", "address": [ { "type": "both", "line": [ "Musterweg 2", "3. Etage" ], "_line": [ { "extension": [ { "url": "http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-streetName", "valueString": "Musterweg" }, { "url": "http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-houseNumber", "valueString": "2" } ] }, { "extension": [ { "url": "http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-additionalLocator", "valueString": "3. Etage" } ] } ], "city": "Musterhausen", "postalCode": "98764", "country": "DE" }, { "type": "postal", "line": [ "Postfach 8 15" ], "_line": [ { "extension": [ { "url": "http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-postBox", "valueString": "Postfach 8 15" } ] } ], "city": "Musterhausen", "postalCode": "98764", "country": "DE" } ] }