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:

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

NameCanonical
ISiKPatienthttps://gematik.de/fhir/isik/v2/Basismodul/StructureDefinition/ISiKPatient
idS Σ0..1System.String
useΣ ?!0..1codeBinding
typeS Σ1..1CodeableConceptBinding
systemS Σ1..1uriFixed Value
valueS Σ I1..1string
periodΣ I0..1Period
assignerΣ I0..1Reference(Organization)
useΣ ?!0..1codeBinding
typeS Σ1..1CodeableConceptBinding
systemS Σ1..1uri
valueS Σ1..1string
periodΣ I0..1Period
assignerΣ I0..1Reference(Organization)
useS Σ ?!0..1codeBindingFixed Value
typeS Σ1..1CodeableConceptBinding
systemΣ0..1uri
valueS Σ1..1string
periodΣ I0..1Period
referenceΣ I0..1string
typeΣ0..1uriBinding
useΣ ?!0..1codeBinding
typeΣ0..1CodeableConceptBinding
systemS Σ1..1uriFixed Value
valueS Σ I1..1string
periodΣ I0..1Period
assignerΣ I0..1Reference(Organization)
displayS Σ1..1string
activeS Σ ?!0..1boolean
useS Σ ?!1..1codeBinding
textΣ0..1string
namenszusatzS I0..1Extension(string)
nachnameS I0..1Extension(string)
vorsatzwortS I0..1Extension(string)
givenS Σ1..*string
url1..1System.StringFixed Value
valueCodecode
suffixΣ0..*string
periodΣ I0..1Period
useS Σ ?!1..1codeBinding
textΣ0..1string
namenszusatzS I0..1Extension(string)
nachnameS I0..1Extension(string)
vorsatzwortS I0..1Extension(string)
givenΣ0..0string
suffixΣ0..*string
periodΣ I0..1Period
systemΣ I1..1codeBinding
valueΣ1..1string
useΣ ?!0..1codeBinding
rankΣ0..1positiveInt
periodΣ I0..1Period
Geschlecht-AdministrativS I0..1Extension(Coding)
url1..1System.StringFixed Value
valueCodecode
deceasedBooleanboolean
deceasedDateTimedateTime
StadtteilS I0..1Extension(string)
useΣ ?!0..1codeBinding
typeS Σ1..1codeBinding
textΣ0..1string
StrasseS I0..1Extension(string)
HausnummerS I0..1Extension(string)
AdresszusatzS I0..1Extension(string)
PostfachI0..0Extension(string)
cityS Σ1..1string
districtΣ0..0string
stateΣ0..1stringBinding
postalCodeS Σ1..1string
countryS Σ I1..1stringBinding
startΣ I0..1dateTime
endΣ I0..1dateTime
StadtteilI0..1Extension(string)
useΣ ?!0..1codeBinding
typeS Σ1..1codeBinding
textΣ0..1string
StrasseI0..0Extension(string)
HausnummerI0..0Extension(string)
AdresszusatzI0..0Extension(string)
PostfachS I0..1Extension(string)
cityS Σ1..1string
districtΣ0..0string
stateΣ0..1stringBinding
postalCodeS Σ1..1string
countryS Σ I1..1stringBinding
startΣ I0..1dateTime
endΣ I0..1dateTime
maritalStatus0..1CodeableConceptBinding
multipleBirthBooleanboolean
multipleBirthIntegerinteger
photoI0..*Attachment
relationship0..*CodeableConceptBinding
name0..1HumanName
telecomI0..*ContactPoint
address0..1Address
gender0..1codeBinding
organizationI0..1Reference(Organization)
periodI0..1Period
language1..1CodeableConceptBinding
preferred0..1boolean
generalPractitionerI0..*Reference(Organization | Practitioner | PractitionerRole)
managingOrganizationΣ I0..1Reference(Organization)
otherΣ I1..1Reference(Patient | RelatedPerson)
typeΣ1..1codeBinding

Folgende FHIRPath-Constraints sind im Profil zu beachten:

keyseverityhumanexpression
isik-pat-1errorFalls die Geschlechtsangabe 'other' gewählt wird, muss die amtliche Differenzierung per Extension angegeben werdengender.exists() and gender='other' implies gender.extension('http://fhir.de/StructureDefinition/gender-amtlich-de').exists()
address-cnt-2or3-charwarningThe content of the country element (if present) SHALL be selected EITHER from ValueSet ISO Country Alpha-2 http://hl7.org/fhir/ValueSet/iso3166-1-2 OR MAY be selected from ISO Country Alpha-3 Value Set http://hl7.org/fhir/ValueSet/iso3166-1-3, IF the country is not specified in value Set ISO Country Alpha-2 http://hl7.org/fhir/ValueSet/iso3166-1-2.country.empty() or (country.memberOf('http://hl7.org/fhir/ValueSet/iso3166-1-2') or country.memberOf('http://hl7.org/fhir/ValueSet/iso3166-1-3'))
address-cnt-2or3-charwarningThe content of the country element (if present) SHALL be selected EITHER from ValueSet ISO Country Alpha-2 http://hl7.org/fhir/ValueSet/iso3166-1-2 OR MAY be selected from ISO Country Alpha-3 Value Set http://hl7.org/fhir/ValueSet/iso3166-1-3, IF the country is not specified in value Set ISO Country Alpha-2 http://hl7.org/fhir/ValueSet/iso3166-1-2.country.empty() or (country.memberOf('http://hl7.org/fhir/ValueSet/iso3166-1-2') or country.memberOf('http://hl7.org/fhir/ValueSet/iso3166-1-3'))

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 die Patient-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:

  1. 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.

  2. 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.

  3. 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.

  4. 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.

  5. 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".

  6. 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.

  7. 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".

  8. Der Suchparameter "_profile" KANN unterstützt werden:

    Beispiele:

    GET [base]/Patient?_profile=https://gematik.de/fhir/isik/v2/Basismodul/StructureDefinition/ISiKPatient

    Anwendungshinweise: Weitere Informationen zur Suche nach "_profile" finden sich in der FHIR-Basisspezifikation - Abschnitt "Parameters for all resources".

  9. 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.

  10. 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.

  11. 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.

  12. 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.

  13. 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.

  14. 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/sid/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": "Fürstin"
                    },
                    {
                        "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"
        }
    ]
}