Angehöriger (RelatedPerson)


Dieses Profil ermöglicht die Darstellung von Angehörigen in ISiK Szenarien.

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. In FHIR werden Angehörige von Patienten mit der RelatedPerson-Ressource repräsentiert.

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.

Hinweise zu Inkompatibilitäten können über die Portalseite gemeldet werden.

Bestätigungsrelevanz

VerbindlichkeitSHALL

Metadaten

Canonicalhttps://gematik.de/fhir/isik/StructureDefinition/ISiKAngehoeriger
Statusactive
Version4.0.1
Basishttp://hl7.org/fhir/StructureDefinition/RelatedPerson

Inhalt

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
referenceS Σ I1..1string
typeΣ0..1uriBinding
identifierΣ0..1Identifier
displayΣ0..1string
relationshipS Σ0..*CodeableConceptBinding
id0..1string
extensionI0..*Extension
useS Σ ?!0..1codeBinding
textΣ0..1string
familyS Σ0..1string
givenS Σ0..*string
prefixS Σ0..*string
suffixΣ0..*string
periodΣ I0..1Period
id0..1string
extensionI0..*Extension
systemS Σ I1..1codeBinding
valueS Σ1..1string
useΣ ?!0..1codeBinding
rankΣ0..1positiveInt
periodΣ I0..1Period
genderΣ0..1codeBinding
birthDateΣ0..1date
id0..1string
StadtteilS I0..1Extension(string)
useΣ ?!0..1codeBinding
typeS Σ1..1codeBindingPattern
textΣ0..1string
id0..1string
StrasseI0..1Extension(string)
HausnummerI0..1Extension(string)
AdresszusatzI0..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)
PostfachI0..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
<StructureDefinition xmlns="http://hl7.org/fhir">
    <id value="ISiKAngehoeriger" />
    <url value="https://gematik.de/fhir/isik/StructureDefinition/ISiKAngehoeriger" />
    <version value="4.0.1" />
    <name value="ISiKAngehoeriger" />
    <status value="active" />
    <experimental value="false" />
    <date value="2024-11-25" />
    <publisher value="gematik GmbH" />
    <description value="Dieses Profil erm&#246;glicht die Darstellung von Angeh&#246;rigen in ISiK Szenarien.  \n### Motivation\nDer Angeh&#246;rige wird vor allem im Zusammenhang mit Anwendungsszenarien verwendet,\n in denen das Versicherungsverh&#228;ltnis eine Rolle spielt. \n Hier k&#246;nnen Angeh&#246;rige, bspw. der hauptversicherte Elternteil \n eines minderj&#228;hrigen Kindes, in der Familienversicherung sein. \n In Selbstzahler-Szenarien k&#246;nnen Angeh&#246;rige die Zahler f&#252;r eine \n im Krankenhaus erbrachte Leistung sein.\nIn FHIR werden Angeh&#246;rige von Patienten mit der RelatedPerson-Ressource repr&#228;sentiert.\n\n### Kompatibilit&#228;t\nF&#252;r das Profil ISiKAngehoeriger wurde bis zum Zeitpunkt der Ver&#246;ffentlichung kein Abgleich der Kompatibilit&#228;t zu anderen Profilen (der KBV und der Medizininformatik-Initiative) durchgef&#252;hrt.\n\nHinweise zu Inkompatibilit&#228;ten k&#246;nnen &#252;ber die [Portalseite](https://service.gematik.de/servicedesk/customer/portal/16) gemeldet werden." />
    <fhirVersion value="4.0.1" />
    <kind value="resource" />
    <abstract value="false" />
    <type value="RelatedPerson" />
    <baseDefinition value="http://hl7.org/fhir/StructureDefinition/RelatedPerson" />
    <derivation value="constraint" />
    <differential>
        <element id="RelatedPerson">
            <path value="RelatedPerson" />
            <constraint>
                <key value="relatedp-de-1" />
                <severity value="error" />
                <human value="Falls die Geschlechtsangabe &#39;other&#39; gew&#228;hlt wird, muss die amtliche Differenzierung per Extension angegeben werden" />
                <expression value="gender.exists() and gender=&#39;other&#39; implies gender.extension(&#39;http://fhir.de/StructureDefinition/gender-amtlich-de&#39;).exists()" />
                <source value="https://gematik.de/fhir/isik/StructureDefinition/ISiKAngehoeriger" />
            </constraint>
        </element>
        <element id="RelatedPerson.patient">
            <path value="RelatedPerson.patient" />
            <short value="Patientenbezug" />
            <mustSupport value="true" />
        </element>
        <element id="RelatedPerson.patient.reference">
            <path value="RelatedPerson.patient.reference" />
            <short value="Patienten-Link" />
            <comment value="**Begr&#252;ndung Pflichtfeld:** Die Verlinkung auf eine Patienten-Ressource dient der technischen Zuordnung der Information zu einem Patienten \n  und erm&#246;glicht wichtige API-Funktionen wie verkettete Suche, (Reverse-)Include etc." />
            <min value="1" />
            <mustSupport value="true" />
        </element>
        <element id="RelatedPerson.relationship">
            <path value="RelatedPerson.relationship" />
            <short value="Verwandtschaftsverh&#228;ltnis" />
            <comment value="**Begr&#252;ndung MS:** Harmonisierung mit KBV (KBV_PR_Base_RelatedPerson)" />
            <mustSupport value="true" />
        </element>
        <element id="RelatedPerson.name">
            <path value="RelatedPerson.name" />
            <slicing>
                <discriminator>
                    <type value="pattern" />
                    <path value="$this" />
                </discriminator>
                <rules value="open" />
            </slicing>
            <short value="Offizieller Name der angeh&#246;rigen Person" />
            <comment value="Aufgrund der prim&#228;ren Nutzung von Angeh&#246;rigen-Informationen im ISiK-Kontext als Brief- und Rechnungsempf&#228;nger, \n  ist die Angabe des offiziellen Namens relevant.\n  Wenn kein Name vorliegt, MUSS die [data-absent-reason-Extension](https://www.hl7.org/fhir/R4/extension-data-absent-reason.html) eingesetzt werden.   \n  **Weitere Hinweise:** siehe [Deutsche Basisprofile](https://simplifier.net/guide/leitfaden-de-basis-r4/ig-markdown-Ressourcen-Patient?version=current#ig-markdown-Ressourcen-Patient-Name)" />
            <min value="1" />
            <type>
                <code value="HumanName" />
                <profile value="http://fhir.de/StructureDefinition/humanname-de-basis" />
            </type>
            <mustSupport value="true" />
        </element>
        <element id="RelatedPerson.name:Name">
            <path value="RelatedPerson.name" />
            <sliceName value="Name" />
            <min value="1" />
            <max value="1" />
            <mustSupport value="true" />
        </element>
        <element id="RelatedPerson.name:Name.use">
            <path value="RelatedPerson.name.use" />
            <short value="Verwendungszweck" />
            <comment value="Verwendungszweck des Namens. Der pr&#228;ferierte Namen f&#252;r die Brief- und Rechnungszustellung SOLLTE als `official`\n    gekennzeichnet werden und mindestens &#252;ber einen Vor- und Nachnamen verf&#252;gen.    \n    **Begr&#252;ndung MS:** Dient als Unterscheidungs- und Auswahlkriterium" />
            <mustSupport value="true" />
        </element>
        <element id="RelatedPerson.name:Name.family">
            <path value="RelatedPerson.name.family" />
            <short value="Nachname" />
            <comment value="Vollst&#228;ndiger Nachname bzw. Familienname der Person, einschlie&#223;lich Vor- und Zus&#228;tze.  \n      **Begr&#252;ndung Pflichtfeld:** Ein offizieller Name ist nur zul&#228;ssig, wenn der Nachname und mindestens ein Vorname angegeben sind." />
            <mustSupport value="true" />
        </element>
        <element id="RelatedPerson.name:Name.given">
            <path value="RelatedPerson.name.given" />
            <short value="Vorname" />
            <comment value="Kann mehrfach verwendet werden, um den Rufnamen sowie weitere Vornamen, Mittelnamen oder Mittel-Initialen abzubilden.\n      **Begr&#252;ndung Pflichtfeld:** Ein offizieller Name ist nur zul&#228;ssig, wenn der Nachname und mindestens ein Vorname angegeben sind." />
            <mustSupport value="true" />
        </element>
        <element id="RelatedPerson.name:Name.prefix">
            <path value="RelatedPerson.name.prefix" />
            <short value="Pr&#228;fix" />
            <comment value="Pr&#228;fix, z.B. akademischer Titel od. milit&#228;rischer Rang" />
            <mustSupport value="true" />
        </element>
        <element id="RelatedPerson.telecom">
            <path value="RelatedPerson.telecom" />
            <short value="Telekommunikationsverbindung" />
            <comment value="Telekommunikationsverbindung (z.B. Telefonnummer, eMail-Adresse)  \n  **Begr&#252;ndung MS:** Harmonisierung mit KBV (KBV_PR_Base_RelatedPerson)" />
            <mustSupport value="true" />
        </element>
        <element id="RelatedPerson.telecom.system">
            <path value="RelatedPerson.telecom.system" />
            <short value="Art der Telekommunikationsverbindung" />
            <comment value="**Begr&#252;ndung Pflichtfeld:** Harmonisierung mit KBV (KBV_PR_Base_RelatedPerson)" />
            <min value="1" />
            <mustSupport value="true" />
        </element>
        <element id="RelatedPerson.telecom.value">
            <path value="RelatedPerson.telecom.value" />
            <short value="Telekommunikations-Endpunkt" />
            <comment value="**Begr&#252;ndung Pflichtfeld:** Harmonisierung mit KBV (KBV_PR_Base_RelatedPerson)" />
            <min value="1" />
            <mustSupport value="true" />
        </element>
        <element id="RelatedPerson.address">
            <path value="RelatedPerson.address" />
            <slicing>
                <discriminator>
                    <type value="pattern" />
                    <path value="$this" />
                </discriminator>
                <rules value="open" />
            </slicing>
            <comment value="In order to differentiate between post box addresses and physical addresses, street names and house numbers, and to add city district names, vendors can opt to support the extensions as suggested in the German Address Base Profile http://fhir.de/StructureDefinition/address-de-basis.\nSuch differentiations are however not required within the scope of this specification." />
            <mustSupport value="true" />
        </element>
        <element id="RelatedPerson.address:Strassenanschrift">
            <path value="RelatedPerson.address" />
            <sliceName value="Strassenanschrift" />
            <short value="Stra&#223;enanschrift" />
            <comment value="Wohn- oder Aufenthaltsort des Angeh&#246;rigen" />
            <min value="0" />
            <max value="*" />
            <type>
                <code value="Address" />
                <profile value="http://fhir.de/StructureDefinition/address-de-basis" />
            </type>
            <patternAddress>
                <type value="both" />
            </patternAddress>
            <constraint>
                <key value="address-cnt-2or3-char" />
                <severity value="warning" />
                <human value="The 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." />
                <expression value="country.empty() or (country.memberOf(&#39;http://hl7.org/fhir/ValueSet/iso3166-1-2&#39;) or country.memberOf(&#39;http://hl7.org/fhir/ValueSet/iso3166-1-3&#39;))" />
                <source value="https://gematik.de/fhir/isik/StructureDefinition/ISiKAngehoeriger" />
            </constraint>
            <mustSupport value="true" />
        </element>
        <element id="RelatedPerson.address:Strassenanschrift.extension:Stadtteil">
            <path value="RelatedPerson.address.extension" />
            <sliceName value="Stadtteil" />
            <mustSupport value="true" />
        </element>
        <element id="RelatedPerson.address:Strassenanschrift.type">
            <path value="RelatedPerson.address.type" />
            <short value="Adresstyp" />
            <comment value="Hier ist stets der Wert `both` anzugeben.  \n    **Begr&#252;ndung Pflichtfeld:** Dient als Unterscheidungs- und Auswahlkriterium" />
            <min value="1" />
            <mustSupport value="true" />
        </element>
        <element id="RelatedPerson.address:Strassenanschrift.line">
            <path value="RelatedPerson.address.line" />
            <short value="Adresszeile" />
            <comment value="Diese Komponente kann Stra&#223;ennamen, Hausnummer, Appartmentnummer, c/o \n    sowie weitere Zustellungshinweise enthalten. \n    Die Informationen k&#246;nnen in mehrere line-Komponenten aufgeteilt werden. \n    Bei Verwendung der Extensions, um Stra&#223;e, Hausnnummer und Postleitzahl strukturiert zu &#252;bermitteln, \n    m&#252;ssen diese Informationen stets vollst&#228;ndig auch in der line-Komponente, \n    die sie erweitern, enthalten sein, um es Systemen, die diese Extensions nicht verwenden zu erm&#246;glichen, \n    auf diese Informationen zugreifen zu k&#246;nnen.  \n    **Begr&#252;ndung Pflichtfeld:** Ohne diese Angabe ist die Adresse nicht zustellbar.  \n    **Begr&#252;ndung f&#252;r Reduktion der max. Kardinalit&#228;t:** Die maximale Kardinalit&#228;t wurde in &#220;bereinstimmung mit der \n    DIN-Norm 5008 (Schreib- und Gestaltungsregeln f&#252;r die Text- und Informationsverarbeitung) auf 3 beschr&#228;nkt." />
            <min value="1" />
            <mustSupport value="true" />
        </element>
        <element id="RelatedPerson.address:Strassenanschrift.line.extension:Strasse">
            <path value="RelatedPerson.address.line.extension" />
            <sliceName value="Strasse" />
            <short value="Strassenname" />
            <comment value="Strassenname (ohne Hausnummer).\n        Bei Angabe einer Strasse in dieser Extension muss diese auch in Address.line angegeben werden,\n        um die Interoperabilit&#228;t mit Systemen zu gew&#228;hrleisten, die diese Extension nicht verwenden.  \n        **Begr&#252;ndung MS:** Erforderlich f&#252;r die verlustfreie Kommunikation von VSDM-Daten." />
        </element>
        <element id="RelatedPerson.address:Strassenanschrift.line.extension:Hausnummer">
            <path value="RelatedPerson.address.line.extension" />
            <sliceName value="Hausnummer" />
            <short value="Hausnummer" />
            <comment value="Hausnummer, sowie Zus&#228;tze (Appartmentnummer, Etage...). \n        Bei Angabe einer Hausnummer in dieser Extension muss diese auch in Address.line angegeben werden,\n        um die Interoperabilit&#228;t mit Systemen zu gew&#228;hrleisten, die diese Extension nicht verwenden.   \n        **Begr&#252;ndung MS:** Erforderlich f&#252;r die verlustfreie Kommunikation von VSDM-Daten." />
        </element>
        <element id="RelatedPerson.address:Strassenanschrift.line.extension:Adresszusatz">
            <path value="RelatedPerson.address.line.extension" />
            <sliceName value="Adresszusatz" />
            <short value="Adresszusatz" />
            <comment value="Zus&#228;tzliche Informationen, wie z.B. &#39;3. Etage&#39;, &#39;Appartment C&#39;.\n        Bei Angabe einer Zusatzinformation in dieser Extension muss diese auch in Address.line angegeben werden,\n        um die Interoperabilit&#228;t mit Systemen zu gew&#228;hrleisten, die diese Extension nicht verwenden.  \n        **Begr&#252;ndung MS:** Erforderlich f&#252;r die verlustfreie Kommunikation von VSDM-Daten." />
        </element>
        <element id="RelatedPerson.address:Strassenanschrift.line.extension:Postfach">
            <path value="RelatedPerson.address.line.extension" />
            <sliceName value="Postfach" />
            <short value="Postfachnummer" />
            <comment value="Postfach-Adresse. Bei Angabe eines Postfaches in dieser Extension muss das Postfach auch in Address.line angegeben werden,\n        um die Interoperabilit&#228;t mit Systemen zu gew&#228;hrleisten, die diese Extension nicht verwenden. \n        Eine Postfach-Adresse darf nicht in Verbindung mit Address.type `physical` oder `both` verwendet werden.  \n        **Begr&#252;ndung MS:** Erforderlich f&#252;r die verlustfreie Kommunikation von VSDM-Daten." />
            <max value="0" />
        </element>
        <element id="RelatedPerson.address:Strassenanschrift.city">
            <path value="RelatedPerson.address.city" />
            <short value="Stadt" />
            <comment value="**Begr&#252;ndung Pflichtfeld:** Ohne diese Angabe ist die Adresse nicht zustellbar." />
            <min value="1" />
            <mustSupport value="true" />
        </element>
        <element id="RelatedPerson.address:Strassenanschrift.postalCode">
            <path value="RelatedPerson.address.postalCode" />
            <short value="Postleitzahl" />
            <comment value="**Begr&#252;ndung Pflichtfeld:** Ohne diese Angabe ist die Adresse nicht zustellbar." />
            <min value="1" />
            <mustSupport value="true" />
        </element>
        <element id="RelatedPerson.address:Strassenanschrift.country">
            <path value="RelatedPerson.address.country" />
            <short value="Land" />
            <comment value="**Begr&#252;ndung Pflichtfeld:** Ohne diese Angabe ist die Adresse nicht zustellbar." />
            <min value="1" />
            <mustSupport value="true" />
        </element>
        <element id="RelatedPerson.address:Postfach">
            <path value="RelatedPerson.address" />
            <sliceName value="Postfach" />
            <short value="Postfachadresse" />
            <comment value="Adresse, die nur f&#252;r postalische Zustellung genutzt werden kann." />
            <min value="0" />
            <max value="*" />
            <type>
                <code value="Address" />
                <profile value="http://fhir.de/StructureDefinition/address-de-basis" />
            </type>
            <patternAddress>
                <type value="postal" />
            </patternAddress>
            <constraint>
                <key value="address-cnt-2or3-char" />
                <severity value="warning" />
                <human value="The 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." />
                <expression value="country.empty() or (country.memberOf(&#39;http://hl7.org/fhir/ValueSet/iso3166-1-2&#39;) or country.memberOf(&#39;http://hl7.org/fhir/ValueSet/iso3166-1-3&#39;))" />
                <source value="https://gematik.de/fhir/isik/StructureDefinition/ISiKAngehoeriger" />
            </constraint>
            <mustSupport value="true" />
        </element>
        <element id="RelatedPerson.address:Postfach.type">
            <path value="RelatedPerson.address.type" />
            <short value="Adresstyp" />
            <comment value="Hier ist stets der Wert `postal` anzugeben.  \n    **Begr&#252;ndung Pflichtfeld:** Dient als Unterscheidungs- und Auswahlkriterium" />
            <min value="1" />
            <mustSupport value="true" />
        </element>
        <element id="RelatedPerson.address:Postfach.line">
            <path value="RelatedPerson.address.line" />
            <short value="Adresszeile" />
            <comment value="Diese Komponente enth&#228;lt die Postfachadresse als String der Form &#39;Postfach: 12345&#39;.\n    Bei Verwendung der Postfach-Extension, um die Postfachnummer strukturiert zu &#252;bermitteln, \n    m&#252;ssen diese Informationen stets vollst&#228;ndig auch in der line-Komponente, \n    die sie erweitern, enthalten sein, um es Systemen, die diese Extensions nicht verwenden zu erm&#246;glichen, \n    auf diese Informationen zugreifen zu k&#246;nnen.  \n    **Begr&#252;ndung Pflichtfeld:** Ohne diese Angabe ist die Adresse nicht zustellbar.  \n    **Begr&#252;ndung f&#252;r Reduktion der max. Kardinalit&#228;t:** Die maximale Kardinalit&#228;t wurde in &#220;bereinstimmung mit der \n    DIN-Norm 5008 (Schreib- und Gestaltungsregeln f&#252;r die Text- und Informationsverarbeitung) auf 3 beschr&#228;nkt." />
            <min value="1" />
            <mustSupport value="true" />
        </element>
        <element id="RelatedPerson.address:Postfach.line.extension:Strasse">
            <path value="RelatedPerson.address.line.extension" />
            <sliceName value="Strasse" />
            <max value="0" />
        </element>
        <element id="RelatedPerson.address:Postfach.line.extension:Hausnummer">
            <path value="RelatedPerson.address.line.extension" />
            <sliceName value="Hausnummer" />
            <max value="0" />
        </element>
        <element id="RelatedPerson.address:Postfach.line.extension:Adresszusatz">
            <path value="RelatedPerson.address.line.extension" />
            <sliceName value="Adresszusatz" />
            <max value="0" />
        </element>
        <element id="RelatedPerson.address:Postfach.line.extension:Postfach">
            <path value="RelatedPerson.address.line.extension" />
            <sliceName value="Postfach" />
            <short value="Postfachnummer" />
            <comment value="Postfach-Adresse. Bei Angabe eines Postfaches in dieser Extension muss das Postfach auch in Address.line angegeben werden,\n        um die Interoperabilit&#228;t mit Systemen zu gew&#228;hrleisten, die diese Extension nicht verwenden. \n        Eine Postfach-Adresse darf nicht in Verbindung mit Address.type `physical` oder `both` verwendet werden.  \n        **Begr&#252;ndung MS:** Erforderlich f&#252;r die verlustfreie Kommunikation von VSDM-Daten." />
        </element>
        <element id="RelatedPerson.address:Postfach.city">
            <path value="RelatedPerson.address.city" />
            <short value="Stadt" />
            <comment value="**Begr&#252;ndung Pflichtfeld:** Ohne diese Angabe ist die Adresse nicht zustellbar." />
            <min value="1" />
            <mustSupport value="true" />
        </element>
        <element id="RelatedPerson.address:Postfach.postalCode">
            <path value="RelatedPerson.address.postalCode" />
            <short value="Postleitzahl" />
            <comment value="**Begr&#252;ndung Pflichtfeld:** Ohne diese Angabe ist die Adresse nicht zustellbar." />
            <min value="1" />
            <mustSupport value="true" />
        </element>
        <element id="RelatedPerson.address:Postfach.country">
            <path value="RelatedPerson.address.country" />
            <short value="Land" />
            <comment value="**Begr&#252;ndung Pflichtfeld:** Ohne diese Angabe ist die Adresse nicht zustellbar." />
            <min value="1" />
            <mustSupport value="true" />
        </element>
    </differential>
</StructureDefinition>
{
    "resourceType": "StructureDefinition",
    "id": "ISiKAngehoeriger",
    "url": "https://gematik.de/fhir/isik/StructureDefinition/ISiKAngehoeriger",
    "version": "4.0.1",
    "name": "ISiKAngehoeriger",
    "status": "active",
    "experimental": false,
    "date": "2024-11-25",
    "publisher": "gematik GmbH",
    "description": "Dieses Profil ermöglicht die Darstellung von Angehörigen in ISiK Szenarien.  \n### Motivation\nDer Angehörige wird vor allem im Zusammenhang mit Anwendungsszenarien verwendet,\n in denen das Versicherungsverhältnis eine Rolle spielt. \n Hier können Angehörige, bspw. der hauptversicherte Elternteil \n eines minderjährigen Kindes, in der Familienversicherung sein. \n In Selbstzahler-Szenarien können Angehörige die Zahler für eine \n im Krankenhaus erbrachte Leistung sein.\nIn FHIR werden Angehörige von Patienten mit der RelatedPerson-Ressource repräsentiert.\n\n### Kompatibilität\nFü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.\n\nHinweise zu Inkompatibilitäten können über die [Portalseite](https://service.gematik.de/servicedesk/customer/portal/16) gemeldet werden.",
    "fhirVersion": "4.0.1",
    "kind": "resource",
    "abstract": false,
    "type": "RelatedPerson",
    "baseDefinition": "http://hl7.org/fhir/StructureDefinition/RelatedPerson",
    "derivation": "constraint",
    "differential": {
        "element":  [
            {
                "id": "RelatedPerson",
                "path": "RelatedPerson",
                "constraint":  [
                    {
                        "key": "relatedp-de-1",
                        "severity": "error",
                        "human": "Falls die Geschlechtsangabe 'other' gewählt wird, muss die amtliche Differenzierung per Extension angegeben werden",
                        "expression": "gender.exists() and gender='other' implies gender.extension('http://fhir.de/StructureDefinition/gender-amtlich-de').exists()",
                        "source": "https://gematik.de/fhir/isik/StructureDefinition/ISiKAngehoeriger"
                    }
                ]
            },
            {
                "id": "RelatedPerson.patient",
                "path": "RelatedPerson.patient",
                "short": "Patientenbezug",
                "mustSupport": true
            },
            {
                "id": "RelatedPerson.patient.reference",
                "path": "RelatedPerson.patient.reference",
                "short": "Patienten-Link",
                "comment": "**Begründung Pflichtfeld:** Die Verlinkung auf eine Patienten-Ressource dient der technischen Zuordnung der Information zu einem Patienten \n  und ermöglicht wichtige API-Funktionen wie verkettete Suche, (Reverse-)Include etc.",
                "min": 1,
                "mustSupport": true
            },
            {
                "id": "RelatedPerson.relationship",
                "path": "RelatedPerson.relationship",
                "short": "Verwandtschaftsverhältnis",
                "comment": "**Begründung MS:** Harmonisierung mit KBV (KBV_PR_Base_RelatedPerson)",
                "mustSupport": true
            },
            {
                "id": "RelatedPerson.name",
                "path": "RelatedPerson.name",
                "slicing": {
                    "discriminator":  [
                        {
                            "type": "pattern",
                            "path": "$this"
                        }
                    ],
                    "rules": "open"
                },
                "short": "Offizieller Name der angehörigen Person",
                "comment": "Aufgrund der primären Nutzung von Angehörigen-Informationen im ISiK-Kontext als Brief- und Rechnungsempfänger, \n  ist die Angabe des offiziellen Namens relevant.\n  Wenn kein Name vorliegt, MUSS die [data-absent-reason-Extension](https://www.hl7.org/fhir/R4/extension-data-absent-reason.html) eingesetzt werden.   \n  **Weitere Hinweise:** siehe [Deutsche Basisprofile](https://simplifier.net/guide/leitfaden-de-basis-r4/ig-markdown-Ressourcen-Patient?version=current#ig-markdown-Ressourcen-Patient-Name)",
                "min": 1,
                "type":  [
                    {
                        "code": "HumanName",
                        "profile":  [
                            "http://fhir.de/StructureDefinition/humanname-de-basis"
                        ]
                    }
                ],
                "mustSupport": true
            },
            {
                "id": "RelatedPerson.name:Name",
                "path": "RelatedPerson.name",
                "sliceName": "Name",
                "min": 1,
                "max": "1",
                "mustSupport": true
            },
            {
                "id": "RelatedPerson.name:Name.use",
                "path": "RelatedPerson.name.use",
                "short": "Verwendungszweck",
                "comment": "Verwendungszweck des Namens. Der präferierte Namen für die Brief- und Rechnungszustellung SOLLTE als `official`\n    gekennzeichnet werden und mindestens über einen Vor- und Nachnamen verfügen.    \n    **Begründung MS:** Dient als Unterscheidungs- und Auswahlkriterium",
                "mustSupport": true
            },
            {
                "id": "RelatedPerson.name:Name.family",
                "path": "RelatedPerson.name.family",
                "short": "Nachname",
                "comment": "Vollständiger Nachname bzw. Familienname der Person, einschließlich Vor- und Zusätze.  \n      **Begründung Pflichtfeld:** Ein offizieller Name ist nur zulässig, wenn der Nachname und mindestens ein Vorname angegeben sind.",
                "mustSupport": true
            },
            {
                "id": "RelatedPerson.name:Name.given",
                "path": "RelatedPerson.name.given",
                "short": "Vorname ",
                "comment": "Kann mehrfach verwendet werden, um den Rufnamen sowie weitere Vornamen, Mittelnamen oder Mittel-Initialen abzubilden.\n      **Begründung Pflichtfeld:** Ein offizieller Name ist nur zulässig, wenn der Nachname und mindestens ein Vorname angegeben sind.",
                "mustSupport": true
            },
            {
                "id": "RelatedPerson.name:Name.prefix",
                "path": "RelatedPerson.name.prefix",
                "short": "Präfix",
                "comment": "Präfix, z.B. akademischer Titel od. militärischer Rang",
                "mustSupport": true
            },
            {
                "id": "RelatedPerson.telecom",
                "path": "RelatedPerson.telecom",
                "short": "Telekommunikationsverbindung",
                "comment": "Telekommunikationsverbindung (z.B. Telefonnummer, eMail-Adresse)  \n  **Begründung MS:** Harmonisierung mit KBV (KBV_PR_Base_RelatedPerson)",
                "mustSupport": true
            },
            {
                "id": "RelatedPerson.telecom.system",
                "path": "RelatedPerson.telecom.system",
                "short": "Art der Telekommunikationsverbindung",
                "comment": "**Begründung Pflichtfeld:** Harmonisierung mit KBV (KBV_PR_Base_RelatedPerson)",
                "min": 1,
                "mustSupport": true
            },
            {
                "id": "RelatedPerson.telecom.value",
                "path": "RelatedPerson.telecom.value",
                "short": "Telekommunikations-Endpunkt",
                "comment": "**Begründung Pflichtfeld:** Harmonisierung mit KBV (KBV_PR_Base_RelatedPerson)",
                "min": 1,
                "mustSupport": true
            },
            {
                "id": "RelatedPerson.address",
                "path": "RelatedPerson.address",
                "slicing": {
                    "discriminator":  [
                        {
                            "type": "pattern",
                            "path": "$this"
                        }
                    ],
                    "rules": "open"
                },
                "comment": "In order to differentiate between post box addresses and physical addresses, street names and house numbers, and to add city district names, vendors can opt to support the extensions as suggested in the German Address Base Profile http://fhir.de/StructureDefinition/address-de-basis.\nSuch differentiations are however not required within the scope of this specification.",
                "mustSupport": true
            },
            {
                "id": "RelatedPerson.address:Strassenanschrift",
                "path": "RelatedPerson.address",
                "sliceName": "Strassenanschrift",
                "short": "Straßenanschrift",
                "comment": "Wohn- oder Aufenthaltsort des Angehörigen",
                "min": 0,
                "max": "*",
                "type":  [
                    {
                        "code": "Address",
                        "profile":  [
                            "http://fhir.de/StructureDefinition/address-de-basis"
                        ]
                    }
                ],
                "patternAddress": {
                    "type": "both"
                },
                "constraint":  [
                    {
                        "key": "address-cnt-2or3-char",
                        "severity": "warning",
                        "human": "The 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.",
                        "expression": "country.empty() or (country.memberOf('http://hl7.org/fhir/ValueSet/iso3166-1-2') or country.memberOf('http://hl7.org/fhir/ValueSet/iso3166-1-3'))",
                        "source": "https://gematik.de/fhir/isik/StructureDefinition/ISiKAngehoeriger"
                    }
                ],
                "mustSupport": true
            },
            {
                "id": "RelatedPerson.address:Strassenanschrift.extension:Stadtteil",
                "path": "RelatedPerson.address.extension",
                "sliceName": "Stadtteil",
                "mustSupport": true
            },
            {
                "id": "RelatedPerson.address:Strassenanschrift.type",
                "path": "RelatedPerson.address.type",
                "short": "Adresstyp",
                "comment": "Hier ist stets der Wert `both` anzugeben.  \n    **Begründung Pflichtfeld:** Dient als Unterscheidungs- und Auswahlkriterium",
                "min": 1,
                "mustSupport": true
            },
            {
                "id": "RelatedPerson.address:Strassenanschrift.line",
                "path": "RelatedPerson.address.line",
                "short": "Adresszeile",
                "comment": "Diese Komponente kann Straßennamen, Hausnummer, Appartmentnummer, c/o \n    sowie weitere Zustellungshinweise enthalten. \n    Die Informationen können in mehrere line-Komponenten aufgeteilt werden. \n    Bei Verwendung der Extensions, um Straße, Hausnnummer und Postleitzahl strukturiert zu übermitteln, \n    müssen diese Informationen stets vollständig auch in der line-Komponente, \n    die sie erweitern, enthalten sein, um es Systemen, die diese Extensions nicht verwenden zu ermöglichen, \n    auf diese Informationen zugreifen zu können.  \n    **Begründung Pflichtfeld:** Ohne diese Angabe ist die Adresse nicht zustellbar.  \n    **Begründung für Reduktion der max. Kardinalität:** Die maximale Kardinalität wurde in Übereinstimmung mit der \n    DIN-Norm 5008 (Schreib- und Gestaltungsregeln für die Text- und Informationsverarbeitung) auf 3 beschränkt.",
                "min": 1,
                "mustSupport": true
            },
            {
                "id": "RelatedPerson.address:Strassenanschrift.line.extension:Strasse",
                "path": "RelatedPerson.address.line.extension",
                "sliceName": "Strasse",
                "short": "Strassenname ",
                "comment": "Strassenname (ohne Hausnummer).\n        Bei Angabe einer Strasse in dieser Extension muss diese auch in Address.line angegeben werden,\n        um die Interoperabilität mit Systemen zu gewährleisten, die diese Extension nicht verwenden.  \n        **Begründung MS:** Erforderlich für die verlustfreie Kommunikation von VSDM-Daten."
            },
            {
                "id": "RelatedPerson.address:Strassenanschrift.line.extension:Hausnummer",
                "path": "RelatedPerson.address.line.extension",
                "sliceName": "Hausnummer",
                "short": "Hausnummer ",
                "comment": "Hausnummer, sowie Zusätze (Appartmentnummer, Etage...). \n        Bei Angabe einer Hausnummer in dieser Extension muss diese auch in Address.line angegeben werden,\n        um die Interoperabilität mit Systemen zu gewährleisten, die diese Extension nicht verwenden.   \n        **Begründung MS:** Erforderlich für die verlustfreie Kommunikation von VSDM-Daten."
            },
            {
                "id": "RelatedPerson.address:Strassenanschrift.line.extension:Adresszusatz",
                "path": "RelatedPerson.address.line.extension",
                "sliceName": "Adresszusatz",
                "short": "Adresszusatz ",
                "comment": "Zusätzliche Informationen, wie z.B. '3. Etage', 'Appartment C'.\n        Bei Angabe einer Zusatzinformation in dieser Extension muss diese auch in Address.line angegeben werden,\n        um die Interoperabilität mit Systemen zu gewährleisten, die diese Extension nicht verwenden.  \n        **Begründung MS:** Erforderlich für die verlustfreie Kommunikation von VSDM-Daten."
            },
            {
                "id": "RelatedPerson.address:Strassenanschrift.line.extension:Postfach",
                "path": "RelatedPerson.address.line.extension",
                "sliceName": "Postfach",
                "short": "Postfachnummer",
                "comment": "Postfach-Adresse. Bei Angabe eines Postfaches in dieser Extension muss das Postfach auch in Address.line angegeben werden,\n        um die Interoperabilität mit Systemen zu gewährleisten, die diese Extension nicht verwenden. \n        Eine Postfach-Adresse darf nicht in Verbindung mit Address.type `physical` oder `both` verwendet werden.  \n        **Begründung MS:** Erforderlich für die verlustfreie Kommunikation von VSDM-Daten.",
                "max": "0"
            },
            {
                "id": "RelatedPerson.address:Strassenanschrift.city",
                "path": "RelatedPerson.address.city",
                "short": "Stadt",
                "comment": "**Begründung Pflichtfeld:** Ohne diese Angabe ist die Adresse nicht zustellbar.",
                "min": 1,
                "mustSupport": true
            },
            {
                "id": "RelatedPerson.address:Strassenanschrift.postalCode",
                "path": "RelatedPerson.address.postalCode",
                "short": "Postleitzahl ",
                "comment": "**Begründung Pflichtfeld:** Ohne diese Angabe ist die Adresse nicht zustellbar.",
                "min": 1,
                "mustSupport": true
            },
            {
                "id": "RelatedPerson.address:Strassenanschrift.country",
                "path": "RelatedPerson.address.country",
                "short": "Land",
                "comment": "**Begründung Pflichtfeld:** Ohne diese Angabe ist die Adresse nicht zustellbar.",
                "min": 1,
                "mustSupport": true
            },
            {
                "id": "RelatedPerson.address:Postfach",
                "path": "RelatedPerson.address",
                "sliceName": "Postfach",
                "short": "Postfachadresse",
                "comment": "Adresse, die nur für postalische Zustellung genutzt werden kann.",
                "min": 0,
                "max": "*",
                "type":  [
                    {
                        "code": "Address",
                        "profile":  [
                            "http://fhir.de/StructureDefinition/address-de-basis"
                        ]
                    }
                ],
                "patternAddress": {
                    "type": "postal"
                },
                "constraint":  [
                    {
                        "key": "address-cnt-2or3-char",
                        "severity": "warning",
                        "human": "The 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.",
                        "expression": "country.empty() or (country.memberOf('http://hl7.org/fhir/ValueSet/iso3166-1-2') or country.memberOf('http://hl7.org/fhir/ValueSet/iso3166-1-3'))",
                        "source": "https://gematik.de/fhir/isik/StructureDefinition/ISiKAngehoeriger"
                    }
                ],
                "mustSupport": true
            },
            {
                "id": "RelatedPerson.address:Postfach.type",
                "path": "RelatedPerson.address.type",
                "short": "Adresstyp",
                "comment": "Hier ist stets der Wert `postal` anzugeben.  \n    **Begründung Pflichtfeld:** Dient als Unterscheidungs- und Auswahlkriterium",
                "min": 1,
                "mustSupport": true
            },
            {
                "id": "RelatedPerson.address:Postfach.line",
                "path": "RelatedPerson.address.line",
                "short": "Adresszeile",
                "comment": "Diese Komponente enthält die Postfachadresse als String der Form 'Postfach: 12345'.\n    Bei Verwendung der Postfach-Extension, um die Postfachnummer strukturiert zu übermitteln, \n    müssen diese Informationen stets vollständig auch in der line-Komponente, \n    die sie erweitern, enthalten sein, um es Systemen, die diese Extensions nicht verwenden zu ermöglichen, \n    auf diese Informationen zugreifen zu können.  \n    **Begründung Pflichtfeld:** Ohne diese Angabe ist die Adresse nicht zustellbar.  \n    **Begründung für Reduktion der max. Kardinalität:** Die maximale Kardinalität wurde in Übereinstimmung mit der \n    DIN-Norm 5008 (Schreib- und Gestaltungsregeln für die Text- und Informationsverarbeitung) auf 3 beschränkt.",
                "min": 1,
                "mustSupport": true
            },
            {
                "id": "RelatedPerson.address:Postfach.line.extension:Strasse",
                "path": "RelatedPerson.address.line.extension",
                "sliceName": "Strasse",
                "max": "0"
            },
            {
                "id": "RelatedPerson.address:Postfach.line.extension:Hausnummer",
                "path": "RelatedPerson.address.line.extension",
                "sliceName": "Hausnummer",
                "max": "0"
            },
            {
                "id": "RelatedPerson.address:Postfach.line.extension:Adresszusatz",
                "path": "RelatedPerson.address.line.extension",
                "sliceName": "Adresszusatz",
                "max": "0"
            },
            {
                "id": "RelatedPerson.address:Postfach.line.extension:Postfach",
                "path": "RelatedPerson.address.line.extension",
                "sliceName": "Postfach",
                "short": "Postfachnummer",
                "comment": "Postfach-Adresse. Bei Angabe eines Postfaches in dieser Extension muss das Postfach auch in Address.line angegeben werden,\n        um die Interoperabilität mit Systemen zu gewährleisten, die diese Extension nicht verwenden. \n        Eine Postfach-Adresse darf nicht in Verbindung mit Address.type `physical` oder `both` verwendet werden.  \n        **Begründung MS:** Erforderlich für die verlustfreie Kommunikation von VSDM-Daten."
            },
            {
                "id": "RelatedPerson.address:Postfach.city",
                "path": "RelatedPerson.address.city",
                "short": "Stadt",
                "comment": "**Begründung Pflichtfeld:** Ohne diese Angabe ist die Adresse nicht zustellbar.",
                "min": 1,
                "mustSupport": true
            },
            {
                "id": "RelatedPerson.address:Postfach.postalCode",
                "path": "RelatedPerson.address.postalCode",
                "short": "Postleitzahl ",
                "comment": "**Begründung Pflichtfeld:** Ohne diese Angabe ist die Adresse nicht zustellbar.",
                "min": 1,
                "mustSupport": true
            },
            {
                "id": "RelatedPerson.address:Postfach.country",
                "path": "RelatedPerson.address.country",
                "short": "Land",
                "comment": "**Begründung Pflichtfeld:** Ohne diese Angabe ist die Adresse nicht zustellbar.",
                "min": 1,
                "mustSupport": true
            }
        ]
    }
}

Constraints/Invarianten

NameSchweregradBeschreibungAusdruck
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'))

Terminology-Bindings

Anmerkungen zu Must-Support-Feldern

FeldnameKurzbeschreibungHinweise
RelatedPerson.patientPatientenbezug
RelatedPerson.patient.referencePatienten-Link

Begründung Pflichtfeld: Die Verlinkung auf eine Patienten-Ressource dient der technischen Zuordnung der Information zu einem Patienten und ermöglicht wichtige API-Funktionen wie verkettete Suche, (Reverse-)Include etc.

RelatedPerson.relationshipVerwandtschaftsverhältnis

Begründung MS: Harmonisierung mit KBV (KBV_PR_Base_RelatedPerson)

RelatedPerson.nameOffizieller Name der angehörigen Person

Aufgrund der primären Nutzung von Angehörigen-Informationen im ISiK-Kontext als Brief- und Rechnungsempfänger, ist die Angabe des offiziellen Namens relevant. Wenn kein Name vorliegt, MUSS die data-absent-reason-Extension eingesetzt werden.
Weitere Hinweise: siehe Deutsche Basisprofile

RelatedPerson.name:Name
RelatedPerson.name:Name.useVerwendungszweck

Verwendungszweck des Namens. Der präferierte Namen für die Brief- und Rechnungszustellung SOLLTE als official gekennzeichnet werden und mindestens über einen Vor- und Nachnamen verfügen.
Begründung MS: Dient als Unterscheidungs- und Auswahlkriterium

RelatedPerson.name:Name.familyNachname

Vollständiger Nachname bzw. Familienname der Person, einschließlich Vor- und Zusätze.
Begründung Pflichtfeld: Ein offizieller Name ist nur zulässig, wenn der Nachname und mindestens ein Vorname angegeben sind.

RelatedPerson.name:Name.givenVorname

Kann mehrfach verwendet werden, um den Rufnamen sowie weitere Vornamen, Mittelnamen oder Mittel-Initialen abzubilden. Begründung Pflichtfeld: Ein offizieller Name ist nur zulässig, wenn der Nachname und mindestens ein Vorname angegeben sind.

RelatedPerson.name:Name.prefixPräfix

Präfix, z.B. akademischer Titel od. militärischer Rang

RelatedPerson.telecomTelekommunikationsverbindung

Telekommunikationsverbindung (z.B. Telefonnummer, eMail-Adresse)
Begründung MS: Harmonisierung mit KBV (KBV_PR_Base_RelatedPerson)

RelatedPerson.telecom.systemArt der Telekommunikationsverbindung

Begründung Pflichtfeld: Harmonisierung mit KBV (KBV_PR_Base_RelatedPerson)

RelatedPerson.telecom.valueTelekommunikations-Endpunkt

Begründung Pflichtfeld: Harmonisierung mit KBV (KBV_PR_Base_RelatedPerson)

RelatedPerson.address

In order to differentiate between post box addresses and physical addresses, street names and house numbers, and to add city district names, vendors can opt to support the extensions as suggested in the German Address Base Profile http://fhir.de/StructureDefinition/address-de-basis. Such differentiations are however not required within the scope of this specification.

RelatedPerson.address:StrassenanschriftStraßenanschrift

Wohn- oder Aufenthaltsort des Angehörigen

RelatedPerson.address:Strassenanschrift.extension:Stadtteil
RelatedPerson.address:Strassenanschrift.typeAdresstyp

Hier ist stets der Wert both anzugeben.
Begründung Pflichtfeld: Dient als Unterscheidungs- und Auswahlkriterium

RelatedPerson.address:Strassenanschrift.lineAdresszeile

Diese Komponente kann Straßennamen, Hausnummer, Appartmentnummer, c/o sowie weitere Zustellungshinweise enthalten. Die Informationen können in mehrere line-Komponenten aufgeteilt werden. Bei Verwendung der Extensions, um Straße, Hausnnummer und Postleitzahl strukturiert zu übermitteln, müssen diese Informationen stets vollständig auch in der line-Komponente, die sie erweitern, enthalten sein, um es Systemen, die diese Extensions nicht verwenden zu ermöglichen, auf diese Informationen zugreifen zu können.
Begründung Pflichtfeld: Ohne diese Angabe ist die Adresse nicht zustellbar.
Begründung für Reduktion der max. Kardinalität: Die maximale Kardinalität wurde in Übereinstimmung mit der DIN-Norm 5008 (Schreib- und Gestaltungsregeln für die Text- und Informationsverarbeitung) auf 3 beschränkt.

RelatedPerson.address:Strassenanschrift.cityStadt

Begründung Pflichtfeld: Ohne diese Angabe ist die Adresse nicht zustellbar.

RelatedPerson.address:Strassenanschrift.postalCodePostleitzahl

Begründung Pflichtfeld: Ohne diese Angabe ist die Adresse nicht zustellbar.

RelatedPerson.address:Strassenanschrift.countryLand

Begründung Pflichtfeld: Ohne diese Angabe ist die Adresse nicht zustellbar.

RelatedPerson.address:PostfachPostfachadresse

Adresse, die nur für postalische Zustellung genutzt werden kann.

RelatedPerson.address:Postfach.typeAdresstyp

Hier ist stets der Wert postal anzugeben.
Begründung Pflichtfeld: Dient als Unterscheidungs- und Auswahlkriterium

RelatedPerson.address:Postfach.lineAdresszeile

Diese Komponente enthält die Postfachadresse als String der Form 'Postfach: 12345'. Bei Verwendung der Postfach-Extension, um die Postfachnummer strukturiert zu übermitteln, müssen diese Informationen stets vollständig auch in der line-Komponente, die sie erweitern, enthalten sein, um es Systemen, die diese Extensions nicht verwenden zu ermöglichen, auf diese Informationen zugreifen zu können.
Begründung Pflichtfeld: Ohne diese Angabe ist die Adresse nicht zustellbar.
Begründung für Reduktion der max. Kardinalität: Die maximale Kardinalität wurde in Übereinstimmung mit der DIN-Norm 5008 (Schreib- und Gestaltungsregeln für die Text- und Informationsverarbeitung) auf 3 beschränkt.

RelatedPerson.address:Postfach.cityStadt

Begründung Pflichtfeld: Ohne diese Angabe ist die Adresse nicht zustellbar.

RelatedPerson.address:Postfach.postalCodePostleitzahl

Begründung Pflichtfeld: Ohne diese Angabe ist die Adresse nicht zustellbar.

RelatedPerson.address:Postfach.countryLand

Begründung Pflichtfeld: Ohne diese Angabe ist die Adresse nicht zustellbar.

Interaktionen

InteraktionVerbindlichkeit
readSHALL
search-typeSHALL
ParameterTypVerbindlichkeitHinweise
_idtokenSHALL

Beispiel:
GET [base]/[Resourcetype]?_id=103270
Anwendungshinweis:
Der Parameter _id wird selten alleinstehend verwendet, da sich zum Abruf einer Ressource anhand der id die READ-Interaktion besser anbietet. Der Parameter kann jedoch verwendet werden, um den Abruf einer Ressource bspw. mit einem _include weiterer Ressourcen zu verbinden, z.B. zum Abruf eines Encounters in Verbindung mit dem zugehörigen Patienten:
GET [base]/Encounter?_id=103270&_include=Encounter:patient Weitere Details siehe FHIR-Kernspezifikation, Abschnitt Parameters for all resources.
Dieser Suchparameter ist für die Umsetzung des IHE PDQm Profils verpflichtend.

_tagtokenSHALL

Beispiel:
GET [base]/[Resourcetype]?_tag=https://example.org/codes|needs-review
Anwendungshinweis:
Weitere Details siehe FHIR-Kernspezifikation, Abschnitt Parameters for all resources sowie Abschnitt Tags.

_countnumberSHALL

Beispiel:
GET [base]/[Resourcetype]?_count=100
Anwendungshinweis:
Weitere Details siehe FHIR-Kernspezifikation, Abschnitt Page Count.

_hasstringMAY

Beispiel: Suche nach allen Patienten, die eine Observation mit dem Code '1234-5' haben
GET [base]/Patient?_has:Observation:patient:code=1234-5
Beispiel: Suche nach allen Encountern, bei denen die Diagnose 'A12.3' gestellt wurde
GET [base]/Encounter?_has:Condition:encounter:code=A12.3
Anwendungshinweis:
Weitere Details siehe FHIR-Kernspezifikation, Abschnitt Reverse Chaining.

patientreferenceSHALL

Beispiel:
GET [base]/RelatedPerson?patient=Patient/123
Anwendungshinweis:
Weitere Details siehe FHIR-Kernspezifikation.

namestringMAY

Beispiel:
GET [base]/RelatedPerson?name=Heidi
GET [base]/RelatedPerson?name=Alpenzauber
Anwendungshinweis:
Weitere Details siehe FHIR-Kernspezifikation.

addressstringMAY

Beispiel:
GET [base]/RelatedPerson?address=Berlin
Anwendungshinweis:
Weitere Details siehe FHIR-Kernspezifikation.

address-citystringMAY

Beispiel:
GET [base]/RelatedPerson?address-city=Berlin
Anwendungshinweis:
Weitere Details siehe FHIR-Kernspezifikation.

address-countrystringMAY

Beispiel:
GET [base]/RelatedPerson?address-country=DE
Anwendungshinweis:
Weitere Details siehe FHIR-Kernspezifikation.

address-postalcodestringMAY

Beispiel:
GET [base]/RelatedPerson?address-postalcode=10117
Anwendungshinweis:
Weitere Details siehe FHIR-Kernspezifikation.

(Reverse-)Include

IncludeReverseInclude
RelatedPerson:patientCoverage:subscriber; Coverage:payor

Beispiele

Valides Minimalbeispiel:

RelatedPerson
<RelatedPerson xmlns="http://hl7.org/fhir">
    <id value="ISiKAngehoerigerMustermann" />
    <meta>
        <profile value="https://gematik.de/fhir/isik/StructureDefinition/ISiKAngehoeriger" />
    </meta>
    <patient>
        <reference value="Patient/PatientinMusterfrau" />
    </patient>
    <relationship>
        <coding>
            <system value="http://terminology.hl7.org/CodeSystem/v3-RoleCode" />
            <code value="DAUC" />
        </coding>
    </relationship>
    <name>
        <family value="Mustermann" />
        <given value="Maxine" />
    </name>
    <address>
        <type value="both" />
        <line value="Milchstr. 42" />
        <city value="Beispielstadt" />
        <postalCode value="78143" />
        <country value="DE" />
    </address>
</RelatedPerson>
{
    "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"
        }
    ],
    "relationship":  [
        {
            "coding":  [
                {
                    "code": "DAUC",
                    "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode"
                }
            ]
        }
    ]
}