Angehöriger (RelatedPerson)


Motivation

Der Angehörige wird vor allem im Zusammenhang mit Anwendungsszenarien verwendet, in denen das Versicherungsverhältnis eine Rolle spielt. Hier können Angehörige, bspw. der hauptversicherte Elternteil eines minderjährigen Kindes, in der Familienversicherung sein. In Selbstzahler-Szenarien können Angehörige die Zahler für eine im Krankenhaus erbrachte Leistung sein.


Kompatibilität

Für das Profil ISiKAngehoeriger wurde bis zum Zeitpunkt der Veröffentlichung kein Abgleich der Kompatibilität zu anderen Profilen (der KBV und der Medizininformatik-Initiative) durchgeführt.


Profil

ISiKAngehoerigerhttps://gematik.de/fhir/isik/v3/Basismodul/StructureDefinition/ISiKAngehoeriger

identifierΣ0..*Identifier
activeΣ ?!0..1boolean
referenceΣ I1..1string
typeΣ0..1uriBinding
identifierΣ0..1Identifier
displayΣ0..1string
relationshipΣ0..*CodeableConceptBinding
nameS Σ I1..1HumanName, deutsches Basisprofil
telecomΣ I0..*ContactPoint
Geschlecht-AdministrativI0..*Extension(Coding)
birthDateΣ0..1date
StadtteilS I0..1Extension(string)
useΣ ?!0..1codeBinding
typeS Σ1..1codeBindingFixed Value
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 Σ1..1stringBinding
startΣ I0..1dateTime
endΣ I0..1dateTime
StadtteilI0..1Extension(string)
useΣ ?!0..1codeBinding
typeS Σ1..1codeBindingFixed Value
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 Σ1..1stringBinding
startΣ I0..1dateTime
endΣ I0..1dateTime
photoI0..*Attachment
periodI0..1Period
language1..1CodeableConceptBinding
preferred0..1boolean

relatedp-de-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 den Must-Support-Feldern

RelatedPerson.name

Bedeutung: Name der angehörigen Person

Hinweise: Siehe Beschreibung der Deutschen Basisprofile

RelatedPerson.patient

Bedeutung: Referenz zum verwandten Patient

RelatedPerson.address.type

Bedeutung: Die Art der Adresse (physisch / postalisch)

Hinweise: Siehe Beschreibung der Deutschen Basisprofile

RelatedPerson.address.line

Bedeutung: Enthält Straßenname, Hausnummer, Richtung, Postfach und ähnliche Adressinformationen

Hinweise: Siehe Beschreibung der Deutschen Basisprofile

RelatedPerson.address.city

Bedeutung: Enthält Name der Stadt oder des Ortes

Hinweise: Siehe Beschreibung der Deutschen Basisprofile

RelatedPerson.address.postalCode

Bedeutung: Postleitzahl für das Gebiet

Hinweise: Siehe Beschreibung der Deutschen Basisprofile

RelatedPerson.address.country

Bedeutung: Land (kann z. B. ein ISO 3166-Code mit 2 oder 3 Buchstaben sein)

Hinweise: Siehe Beschreibung der Deutschen Basisprofile


Interaktionen

Für die Ressource RelatedPerson MUSS die REST-Interaktion "READ" implementiert werden.

Folgende Suchparameter sind für das Bestätigungsverfahren relevant, auch in Kombination:

  1. Der Suchparameter "_id" MUSS unterstützt werden:

    Beispiele:

    GET [base]/RelatedPerson?_id=103270

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

  2. Der Suchparameter "patient" MUSS unterstützt werden:

    Beispiele:

    GET [base]/RelatedPerson?patient=Patient/123

    Anwendungshinweise: Weitere Informationen zur Suche nach "RelatedPerson.patient" finden sich in der FHIR-Basisspezifikation - Abschnitt "Reference Search".

  3. Die Suche nach einem beliebigen Bestandteil des Namens KANN unterstützt werden:

    Beispiele:

    GET [base]/RelatedPerson?name=Heidi

    GET [base]/RelatedPerson?name=Alpenzauber

    Anwendungshinweise: Weitere Informationen zur Suche nach "RelatedPerson.name" finden sich in der FHIR-Basisspezifikation - Abschnitt "String Search".

  4. Der Suchparameter "address" KANN unterstützt werden:

    Beispiele

    GET [base]/RelatedPerson?address=Berlin

    Anwendungshinweise: Weitere Informationen zur Suche nach "RelatedPerson.address" finden sich in der FHIR-Basisspezifikation - Abschnitt "String Search".

    1. Der Suchparameter "address-city" KANN unterstützt werden:

    Beispiele:

    GET [base]/RelatedPerson?address-city=Berlin

    Anwendungshinweise: Weitere Informationen zur Suche nach "RelatedPerson.address.city" finden sich in der FHIR-Basisspezifikation - Abschnitt "String Search".

  5. Der Suchparameter "address-country" KANN unterstützt werden:

    Beispiele:

    GET [base]/RelatedPerson?address-country=DE

    Anwendungshinweise: Weitere Informationen zur Suche nach "RelatedPerson.address.country" finden sich in der FHIR-Basisspezifikation - Abschnitt "String Search".

  6. Der Suchparameter "address-postalcode" KANN unterstützt werden:

    Beispiele:

    GET [base]/RelatedPerson?address-postalcode=10117

    Anwendungshinweise: Weitere Informationen zur Suche nach "RelatedPerson.address.postalCode" finden sich in der FHIR-Basisspezifikation - Abschnitt "String Search".


Beispiele

Valides Minimalbeispiel für das Profil ISiKAngehoeriger:

{
    "resourceType": "RelatedPerson",
    "id": "ISiKAngehoerigerMustermann",
    "meta": {
        "profile":  [
            "https://gematik.de/fhir/isik/v3/Basismodul/StructureDefinition/ISiKAngehoeriger"
        ]
    },
    "patient": {
        "reference": "Patient/PatientinMusterfrau"
    },
    "name":  [
        {
            "family": "Mustermann",
            "given":  [
                "Maxine"
            ]
        }
    ],
    "address":  [
        {
            "type": "both",
            "line":  [
                "Milchstr. 42"
            ],
            "city": "Beispielstadt",
            "postalCode": "78143",
            "country": "DE"
        }
    ]
}