<StructureDefinition xmlns="http://hl7.org/fhir">
  <id value="ISiKAngehoeriger" />
  <url value="https://gematik.de/fhir/isik/StructureDefinition/ISiKAngehoeriger" />
  <version value="6.0.0-rc" />
  <name value="ISiKAngehoeriger" />
  <status value="active" />
  <experimental value="false" />
  <date value="2026-04-02" />
  <publisher value="gematik GmbH" />
  <description value="Dieses Profil ermöglicht die Darstellung von Angehörigen in ISiK Szenarien.  &#xA;&#xA;**Motivation**&#xA;&#xA;Der Angehörige wird vor allem im Zusammenhang mit Anwendungsszenarien verwendet,&#xA; in denen das Versicherungsverhältnis eine Rolle spielt. &#xA; Hier können Angehörige, bspw. der hauptversicherte Elternteil &#xA; eines minderjährigen Kindes, in der Familienversicherung sein. &#xA; In Selbstzahler-Szenarien können Angehörige die Zahler für eine &#xA; im Krankenhaus erbrachte Leistung sein.&#xA;In FHIR werden Angehörige von Patienten mit der RelatedPerson-Ressource repräsentiert.&#xA;&#xA;**Kompatibilität**&#xA;&#xA;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.&#xA;&#xA;Hinweise zu Inkompatibilitäten können ü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 'other' gewählt wird, muss die amtliche Differenzierung per Extension angegeben werden" />
        <expression value="gender.exists() and gender='other' implies gender.extension('http://fhir.de/StructureDefinition/gender-amtlich-de').exists()" />
        <source value="https://gematik.de/fhir/isik/StructureDefinition/ISiKAngehoeriger" />
      </constraint>
    </element>
    <element id="RelatedPerson.id">
      <path value="RelatedPerson.id" />
      <short value="serverseitige, interne ID des Datensatzes" />
      <comment value="**bedingtes Pflichtfeld/bedingtes MS:** Alle von einem Server bereitgestellten Ressourcen MÜSSEN über eine `id` verfügen.&#xA;  Von Clients erzeugte Ressourcen, die im Kontext einer CREATE-Interaktion übermittelt werden, MÜSSEN NICHT über eine `id`verfügen." />
      <mustSupport value="true" />
    </element>
    <element id="RelatedPerson.meta.versionId">
      <path value="RelatedPerson.meta.versionId" />
      <short value="Eindeutiger Name der serverseitigen Version des Datensatzes" />
      <comment value="Alle von einem Server bereitgestellten Ressourcen SOLLEN über eine `versionID` verfügen.&#xA;  Von Clients erzeugte Ressourcen, die im Kontext einer CREATE-Interaktion übermittelt werden, MÜSSEN NICHT über eine `versionID`verfügen." />
    </element>
    <element id="RelatedPerson.meta.lastUpdated">
      <path value="RelatedPerson.meta.lastUpdated" />
      <short value="Zeitpunkt der letzten Änderung" />
      <comment value="Alle von einem Server bereitgestellten Ressourcen SOLLEN über ein `lastUpdate` verfügen.&#xA;  Von Clients erzeugte Ressourcen, die im Kontext einer CREATE-Interaktion übermittelt werden, MÜSSEN NICHT über ein `lastUpdate`verfügen." />
    </element>
    <element id="RelatedPerson.implicitRules">
      <path value="RelatedPerson.implicitRules" />
      <short value="Verweis auf die Regeln, nach denen die Ressource erstellt wurde" />
      <comment value="Begründung Constraint: In ISiK existiert kein Use-Case für dieses Element. Da es sich um ein Modifying Element handelt, wird es daher ausgeschlossen.&#xA;  Darüber hinaus werden die Regeln als URI vorgehalten. Dies führt dazu, dass sich hinter der URI eine beliebige Menge an Regeln befinden kann; wodurch  nicht sichergestellt werden kann, dass alle Clients die Regeln korrekt interpretieren können." />
      <max value="0" />
    </element>
    <element id="RelatedPerson.active">
      <path value="RelatedPerson.active" />
      <short value="Status des Datensatzes" />
      <comment value="**Einschränkung der übergreifenden MS-Definition:** Die Implementierung dieses Elements ist für Server optional. Die Kennzeichnung als Must-Support erfolgt, da es sich um ein als Modifier-Element markiertes Feld in der Kernspezifikation handelt. &#xA;&#xA;  **Hinweis zur Verwendung:**&#xA;  * `true` = Der Datensatz befindet sich in Verwendung/kann verwendet werden  &#xA;  * `false`= Der Datensatz wurde storniert (z.B. bei Dubletten, Merge) oder archiviert  &#xA;  &#xA;    **WICHTIGER Hinweis für Implementierer:**  &#xA;    * Alle server-seitigen Implementierungen SOLLEN in der Lage sein, die systemintern möglichen Statuswerte korrekt in FHIR abzubilden.&#xA;    * Alle client-seitigen Implementierungen SOLLEN in der Lage sein, sämtliche Status-Codes zu interpretieren und dem Anwender in angemessener Form darstellen zu können." />
      <mustSupport value="true" />
    </element>
    <element id="RelatedPerson.patient">
      <path value="RelatedPerson.patient" />
      <short value="Patientenbezug" />
      <comment value="Motivation Kardinalität und Must-Support: Referenz auf den Patienten, zu dem diese angehörige Person in Beziehung steht. Diese Verlinkung ist essentiell für die Dokumentation der Beziehung zwischen Patient und Angehörigem." />
      <mustSupport value="true" />
    </element>
    <element id="RelatedPerson.patient.reference">
      <path value="RelatedPerson.patient.reference" />
      <short value="Patienten-Link" />
      <comment value="**Begründung Pflichtfeld:** Die Verlinkung auf eine Patienten-Ressource dient der technischen Zuordnung der Dokumentation zu einem Patienten und ermöglicht wichtige API-Funktionen wie verkettete Suche, (Reverse-)Include etc.&#xA;Im ISik Kontext MUSS die referenzierte Ressource konform zu [ISiKPatient](https://gematik.de/fhir/isik/StructureDefinition/ISiKPatient) sein.&#xA;Jenseits von ISiK KÖNNEN weitere Instanzen mit anderen Profilen referenziert werden." />
      <min value="1" />
      <mustSupport value="true" />
    </element>
    <element id="RelatedPerson.relationship">
      <path value="RelatedPerson.relationship" />
      <short value="Verwandtschaftsverhältnis" />
      <comment value="**Begrü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örigen Person" />
      <comment value="Aufgrund der primären Nutzung von Angehörigen-Informationen im ISiK-Kontext als Brief- und Rechnungsempfänger, &#xA;  ist die Angabe des offiziellen Namens relevant.&#xA;  Wenn kein Name vorliegt, MUSS die [data-absent-reason-Extension](https://www.hl7.org/fhir/R4/extension-data-absent-reason.html) eingesetzt werden.   &#xA;  **Weitere Hinweise:** siehe [Deutsche Basisprofile](https://simplifier.net/guide/leitfaden-de-basis-r4/ig-markdown-Ressourcen-Patient?version=current#ig-markdown-Ressourcen-Patient-Name)" />
      <mustSupport value="true" />
    </element>
    <element id="RelatedPerson.name:Name">
      <path value="RelatedPerson.name" />
      <sliceName value="Name" />
      <short value="Slice für den offiziellen Namen der angehörigen Person" />
      <comment value="Basierend auf dem Pattern .use = official wird dieser Slice gewählt.&#xA;  **Begründung MS:** Siehe untergeordnete Elemente" />
      <min value="0" />
      <max value="1" />
      <type>
        <code value="HumanName" />
        <profile value="http://fhir.de/StructureDefinition/humanname-de-basis" />
      </type>
      <patternHumanName>
        <use value="official" />
      </patternHumanName>
      <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äferierte Namen für die Brief- und Rechnungszustellung SOLLTE als `official`&#xA;    gekennzeichnet werden und mindestens über einen Vor- und Nachnamen verfügen.    &#xA;    **Begrü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ändiger Nachname bzw. Familienname der Person, einschließlich Vor- und Zusätze." />
      <mustSupport value="true" />
    </element>
    <element id="RelatedPerson.name:Name.given">
      <path value="RelatedPerson.name.given" />
      <comment value="Kann mehrfach verwendet werden, um den Rufnamen sowie weitere Vornamen, Mittelnamen oder Mittel-Initialen abzubilden." />
      <mustSupport value="true" />
    </element>
    <element id="RelatedPerson.name:Name.prefix">
      <path value="RelatedPerson.name.prefix" />
      <short value="Präfix" />
      <comment value="Präfix, z.B. akademischer Titel od. militä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)  &#xA;  **Begrü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ü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ü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>
      <short value="Offizielle Adresse der angehörigen Person" />
      <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.&#xD;&#xA;Such 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ßenanschrift" />
      <comment value="Wohn- oder Aufenthaltsort des Angehö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('http://hl7.org/fhir/ValueSet/iso3166-1-2') or country.memberOf('http://hl7.org/fhir/ValueSet/iso3166-1-3'))" />
        <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.  &#xA;    **Begrü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ßennamen, Hausnummer, Appartmentnummer, c/o &#xA;    sowie weitere Zustellungshinweise enthalten. &#xA;    Die Informationen können in mehrere line-Komponenten aufgeteilt werden. &#xA;    Bei Verwendung der Extensions, um Straße, Hausnnummer und Postleitzahl strukturiert zu übermitteln, &#xA;    müssen diese Informationen stets vollständig auch in der line-Komponente, &#xA;    die sie erweitern, enthalten sein, um es Systemen, die diese Extensions nicht verwenden zu ermöglichen, &#xA;    auf diese Informationen zugreifen zu können.  &#xA;    **Begründung Pflichtfeld:** Ohne diese Angabe ist die Adresse nicht zustellbar.  &#xA;    **Begründung für Reduktion der max. Kardinalität:** Die maximale Kardinalität wurde in Übereinstimmung mit der &#xA;    DIN-Norm 5008 (Schreib- und Gestaltungsregeln für die Text- und Informationsverarbeitung) auf 3 beschrä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).&#xA;        Bei Angabe einer Strasse in dieser Extension muss diese auch in Address.line angegeben werden,&#xA;        um die Interoperabilität mit Systemen zu gewährleisten, die diese Extension nicht verwenden.  &#xA;        **Begründung MS:** Erforderlich fü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" />
      <comment value="Hausnummer, sowie Zusätze (Appartmentnummer, Etage...). &#xA;        Bei Angabe einer Hausnummer in dieser Extension muss diese auch in Address.line angegeben werden,&#xA;        um die Interoperabilität mit Systemen zu gewährleisten, die diese Extension nicht verwenden.   &#xA;        **Begründung MS:** Erforderlich fü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" />
      <comment value="Zusätzliche Informationen, wie z.B. '3. Etage', 'Appartment C'.&#xA;        Bei Angabe einer Zusatzinformation in dieser Extension muss diese auch in Address.line angegeben werden,&#xA;        um die Interoperabilität mit Systemen zu gewährleisten, die diese Extension nicht verwenden.  &#xA;        **Begründung MS:** Erforderlich fü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,&#xA;        um die Interoperabilität mit Systemen zu gewährleisten, die diese Extension nicht verwenden. &#xA;        Eine Postfach-Adresse darf nicht in Verbindung mit Address.type `physical` oder `both` verwendet werden.  &#xA;        **Begründung MS:** Erforderlich fü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ü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" />
      <comment value="**Begrü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ü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ü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('http://hl7.org/fhir/ValueSet/iso3166-1-2') or country.memberOf('http://hl7.org/fhir/ValueSet/iso3166-1-3'))" />
        <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.  &#xA;    **Begrü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ält die Postfachadresse als String der Form 'Postfach: 12345'.&#xA;    Bei Verwendung der Postfach-Extension, um die Postfachnummer strukturiert zu übermitteln, &#xA;    müssen diese Informationen stets vollständig auch in der line-Komponente, &#xA;    die sie erweitern, enthalten sein, um es Systemen, die diese Extensions nicht verwenden zu ermöglichen, &#xA;    auf diese Informationen zugreifen zu können.  &#xA;    **Begründung Pflichtfeld:** Ohne diese Angabe ist die Adresse nicht zustellbar.  &#xA;    **Begründung für Reduktion der max. Kardinalität:** Die maximale Kardinalität wurde in Übereinstimmung mit der &#xA;    DIN-Norm 5008 (Schreib- und Gestaltungsregeln für die Text- und Informationsverarbeitung) auf 3 beschrä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,&#xA;        um die Interoperabilität mit Systemen zu gewährleisten, die diese Extension nicht verwenden. &#xA;        Eine Postfach-Adresse darf nicht in Verbindung mit Address.type `physical` oder `both` verwendet werden.  &#xA;        **Begründung MS:** Erforderlich fü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ü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" />
      <comment value="**Begrü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ündung Pflichtfeld:** Ohne diese Angabe ist die Adresse nicht zustellbar." />
      <min value="1" />
      <mustSupport value="true" />
    </element>
  </differential>
</StructureDefinition>