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

Command 'tree' could not render: File was not found for 'https://gematik.de/fhir/ISiK/v2/StructureDefinition/ISiKPatient'

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 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/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/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"
        }
    ]
}