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
Version5.1.0
Basishttp://hl7.org/fhir/StructureDefinition/RelatedPerson

Inhalt

idS Σ0..1string
id0..1string
extensionC0..*Extension
versionIdΣ0..1id
lastUpdatedΣ0..1instant
sourceΣ0..1uri
profileΣ0..*canonical(StructureDefinition)
securityΣ0..*CodingBinding
tagΣ0..*Coding
implicitRulesΣ ?!0..1uri
language0..1codeBinding
text0..1Narrative
contained0..*Resource
extensionC0..*Extension
modifierExtension?! C0..*Extension
identifierΣ0..*Identifier
activeΣ ?!0..1boolean
id0..1string
extensionC0..*Extension
referenceS Σ C1..1string
typeΣ0..1uriBinding
identifierΣ0..1Identifier
displayΣ0..1string
relationshipS Σ0..*CodeableConceptBinding
id0..1string
extensionC0..*Extension
useS Σ ?!0..1codeBindingPattern
textΣ0..1string
id0..1string
namenszusatzC0..1Extension(string)
nachnameC0..1Extension(string)
vorsatzwortC0..1Extension(string)
value0..1System.String
givenS Σ0..*string
id0..1string
prefix-qualifierC0..1Extension(code)
value0..1System.String
suffixΣ0..*string
periodΣ0..1Period
id0..1string
extensionC0..*Extension
systemS Σ C1..1codeBinding
valueS Σ1..1string
useΣ ?!0..1codeBinding
rankΣ0..1positiveInt
periodΣ0..1Period
genderΣ0..1codeBinding
birthDateΣ0..1date
id0..1string
StadtteilS C0..1Extension(string)
useΣ ?!0..1codeBinding
typeS Σ1..1codeBindingPattern
textΣ0..1string
id0..1string
StrasseC0..1Extension(string)
HausnummerC0..1Extension(string)
AdresszusatzC0..1Extension(string)
PostfachC0..0Extension(string)
value0..1System.String
cityS Σ1..1string
districtΣ0..0string
stateΣ0..1stringBinding
postalCodeS Σ1..1string
countryS Σ1..1stringBinding
periodΣ0..1Period
id0..1string
StadtteilC0..1Extension(string)
useΣ ?!0..1codeBinding
typeS Σ1..1codeBindingPattern
textΣ0..1string
id0..1string
StrasseC0..0Extension(string)
HausnummerC0..0Extension(string)
AdresszusatzC0..0Extension(string)
PostfachC0..1Extension(string)
value0..1System.String
cityS Σ1..1string
districtΣ0..0string
stateΣ0..1stringBinding
postalCodeS Σ1..1string
countryS Σ1..1stringBinding
periodΣ0..1Period
photo0..*Attachment
period0..1Period
id0..1string
extensionC0..*Extension
modifierExtensionΣ ?! C0..*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="5.1.0" />
<name value="ISiKAngehoeriger" />
<status value="active" />
<experimental value="false" />
<date value="2025-10-23" />
<publisher value="gematik GmbH" />
<description value="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 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.\n 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.\n 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.\n Von Clients erzeugte Ressourcen, die im Kontext einer CREATE-Interaktion übermittelt werden, MÜSSEN NICHT über ein `lastUpdate`verfügen." />
</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.\nIm ISik Kontext MUSS die referenzierte Ressource konform zu [ISiKPatient](https://gematik.de/fhir/isik/StructureDefinition/ISiKPatient) sein.\nJenseits 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, \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" />
<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.\n **Begründung MS:** Siehe untergeordnete Elemente" />
<min value="1" />
<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`\n gekennzeichnet werden und mindestens über einen Vor- und Nachnamen verfügen. \n **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. \n **Begründung Pflichtfeld:** Ein offizieller Name ist nur zulä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" />
<comment value="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 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) \n **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.\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ß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. \n **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 \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 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ät mit Systemen zu gewährleisten, die diese Extension nicht verwenden. \n **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...). \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." />
</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'.\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." />
</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ä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 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. \n **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'.\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 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ä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." />
</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>
{
"resourceType": "StructureDefinition",
"id": "ISiKAngehoeriger",
"url": "https://gematik.de/fhir/isik/StructureDefinition/ISiKAngehoeriger",
"version": "5.1.0",
"name": "ISiKAngehoeriger",
"status": "active",
"experimental": false,
"date": "2025-10-23",
"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.id",
"path": "RelatedPerson.id",
"short": "serverseitige, interne ID des Datensatzes",
"comment": "**bedingtes Pflichtfeld/bedingtes MS:** Alle von einem Server bereitgestellten Ressourcen MÜSSEN über eine `id` verfügen.\n Von Clients erzeugte Ressourcen, die im Kontext einer CREATE-Interaktion übermittelt werden, MÜSSEN NICHT über eine `id`verfügen.",
"mustSupport": true
},
{
"id": "RelatedPerson.meta.versionId",
"path": "RelatedPerson.meta.versionId",
"short": "Eindeutiger Name der serverseitigen Version des Datensatzes",
"comment": "Alle von einem Server bereitgestellten Ressourcen SOLLEN über eine `versionID` verfügen.\n Von Clients erzeugte Ressourcen, die im Kontext einer CREATE-Interaktion übermittelt werden, MÜSSEN NICHT über eine `versionID`verfügen."
},
{
"id": "RelatedPerson.meta.lastUpdated",
"path": "RelatedPerson.meta.lastUpdated",
"short": "Zeitpunkt der letzten Änderung",
"comment": "Alle von einem Server bereitgestellten Ressourcen SOLLEN über ein `lastUpdate` verfügen.\n Von Clients erzeugte Ressourcen, die im Kontext einer CREATE-Interaktion übermittelt werden, MÜSSEN NICHT über ein `lastUpdate`verfügen."
},
{
"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 Dokumentation zu einem Patienten und ermöglicht wichtige API-Funktionen wie verkettete Suche, (Reverse-)Include etc.\nIm ISik Kontext MUSS die referenzierte Ressource konform zu [ISiKPatient](https://gematik.de/fhir/isik/StructureDefinition/ISiKPatient) sein.\nJenseits von ISiK KÖNNEN weitere Instanzen mit anderen Profilen referenziert werden.",
"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",
"short": "Slice für den offiziellen Namen der angehörigen Person",
"comment": "Basierend auf dem Pattern .use = official wird dieser Slice gewählt.\n **Begründung MS:** Siehe untergeordnete Elemente",
"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"
},
"short": "Offizielle Adresse der angehörigen Person",
"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",
"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
}
]
}
}
ISiKAngehoeriger

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.idserverseitige, interne ID des Datensatzes

bedingtes Pflichtfeld/bedingtes MS: Alle von einem Server bereitgestellten Ressourcen MÜSSEN über eine id verfügen. Von Clients erzeugte Ressourcen, die im Kontext einer CREATE-Interaktion übermittelt werden, MÜSSEN NICHT über eine idverfügen.

RelatedPerson.patientPatientenbezug

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.

RelatedPerson.patient.referencePatienten-Link

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. Im ISik Kontext MUSS die referenzierte Ressource konform zu ISiKPatient sein. Jenseits von ISiK KÖNNEN weitere Instanzen mit anderen Profilen referenziert werden.

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:NameSlice für den offiziellen Namen der angehörigen Person

Basierend auf dem Pattern .use = official wird dieser Slice gewählt. Begründung MS: Siehe untergeordnete Elemente

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

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.addressOffizielle Adresse der angehörigen Person

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

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

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>
<use value="official" />
<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"
]
},
"name": [
{
"use": "official",
"family": "Mustermann",
"given": [
"Maxine"
]
}
],
"patient": {
"reference": "Patient/PatientinMusterfrau"
},
"address": [
{
"type": "both",
"line": [
"Milchstr. 42"
],
"city": "Beispielstadt",
"postalCode": "78143",
"country": "DE"
}
],
"relationship": [
{
"coding": [
{
"code": "DAUC",
"system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode"
}
]
}
]
}
Maxine Mustermann