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

NameCanonical
ISiKAngehoerigerhttps://gematik.de/fhir/isik/StructureDefinition/ISiKAngehoeriger

idΣ0..1string
metaΣ0..1Meta
implicitRulesΣ ?!0..1uri
language0..1codeBinding
text0..1Narrative
contained0..*Resource
extensionI0..*Extension
modifierExtension?! I0..*Extension
identifierΣ0..*Identifier
activeΣ ?!0..1boolean
id0..1string
extensionI0..*Extension
referenceΣ I1..1string
typeΣ0..1uriBinding
identifierΣ0..1Identifier
displayΣ0..1string
relationshipΣ0..*CodeableConceptBinding
nameS Σ I1..1HumanName, deutsches Basisprofil
telecomΣ I0..*ContactPoint
id0..1string
Geschlecht-AdministrativI0..*Extension(Coding)
value0..1System.String
birthDateΣ0..1date
id0..1string
StadtteilS I0..1Extension(string)
useΣ ?!0..1codeBinding
typeS Σ1..1codeBindingPattern
textΣ0..1string
id0..1string
StrasseS I0..1Extension(string)
HausnummerS I0..1Extension(string)
AdresszusatzS I0..1Extension(string)
PostfachI0..0Extension(string)
value0..1System.String
cityS Σ1..1string
districtΣ0..0string
stateΣ0..1stringBinding
postalCodeS Σ1..1string
countryS Σ1..1stringBinding
periodΣ I0..1Period
id0..1string
StadtteilI0..1Extension(string)
useΣ ?!0..1codeBinding
typeS Σ1..1codeBindingPattern
textΣ0..1string
id0..1string
StrasseI0..0Extension(string)
HausnummerI0..0Extension(string)
AdresszusatzI0..0Extension(string)
PostfachS I0..1Extension(string)
value0..1System.String
cityS Σ1..1string
districtΣ0..0string
stateΣ0..1stringBinding
postalCodeS Σ1..1string
countryS Σ1..1stringBinding
periodΣ I0..1Period
photoI0..*Attachment
periodI0..1Period
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
language1..1CodeableConceptBinding
preferred0..1boolean

keyseverityhumanexpression
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 Patienten

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


Verkettete Suchparameter (Chaining und Reverse Chaining)

Für Suchparameter vom Typ 'Reference' MÜSSEN die Festlegungen für Chaining und Reverse Chaining verpflichtend implementiert werden. Chaining und Reverse Chaining MUSS für alle Suchparameter über alle Ebenen und Datenobjekte hinweg (potentiell in Kombination) unterstützt werden.

Alle zu unterstützenden verketteten Suchparameter auf den entsprechenden Referenzen sind im CapabilityStatement unter CapabilityStatement.rest.resource.searchInclude bzw. CapabilityStatement.rest.resource.searchRevInclude angegeben. Siehe CapabilityStatement

Weitere Informationen und Beispiele zur Suche nach verketteten Parametern finden sich in diesem IG unter Suchparameter und in der FHIR-Basisspezifikation im Abschnitt "Chained Parameters" und im Abschnitt "Reverse Chaining".

Die verketteten Suchparameter des Profils RelatedPerson hängen wie folgt mit den festgelegten Anwendungsfällen (Use Cases) zusammen:

  1. Der verkette Suchparameter RelatedPerson:patient unterstüzt den Anwendungsfall:

    Um für einen Patienten eindeutig seinen Angehörigen identifizieren und einbeziehen zu können.

  2. Der verkette Suchparameter Coverage:subscriber unterstüzt den Anwendungsfall:

    Um für ein bekanntes Versicherungsverhältnis alle zugehörigen Versicherungsnehmer finden zu können, z.B. die Eltern zur Familienversicherung.

  3. Der verkette Suchparameter Coverage:payor unterstüzt den Anwendungsfall:

    Um für ein bekanntes Versicherungsverhältnis alle zugehörigen, auch private, Beitragszahler finden zu können, z.B. die Gesellschaft hinter einer betrieblichen Krankenzusatzversicherung.


Beispiele

Valides Minimalbeispiel für das Profil ISiKAngehoeriger:

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