FHIR IG Statistics: StructureDefinition/ISiKAngehoeriger

Resources that use this resource

Resources that this resource uses

Narrative

No narrative content found in resource

Source

{
  "resourceType": "StructureDefinition",
  "id": "ISiKAngehoeriger",
  "url": "https://gematik.de/fhir/isik/StructureDefinition/ISiKAngehoeriger",
  "version": "5.0.0",
  "name": "ISiKAngehoeriger",
  "status": "active",
  "experimental": false,
  "date": "2025-06-26",
  "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",
        "comment": "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": 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,
        "mustSupport": true
      },
      {
        "id": "RelatedPerson.name:Name",
        "path": "RelatedPerson.name",
        "sliceName": "Name",
        "min": 1,
        "max": "1",
        "type": [
          {
            "code": "HumanName",
            "profile": [
              "http://fhir.de/StructureDefinition/humanname-de-basis"
            ]
          }
        ],
        "patternHumanName": {
          "use": "official"
        },
        "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",
        "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.\r\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",
        "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",
        "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",
        "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",
        "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
      }
    ]
  }
}