<status value="active" /> <experimental value="false" /> <date value="2026-04-17" /> <publisher value="gematik GmbH" /> <description value="Angaben zum Versicherten im Versichertenstammdatenmanagement (VSDM) 2.0" /> <fhirVersion value="4.0.1" /> <kind value="resource" /> <abstract value="false" /> <type value="Patient" /> <baseDefinition value="https://gematik.de/fhir/ti/StructureDefinition/ti-patient" /> <derivation value="constraint" /> <differential> <element id="Patient"> <path value="Patient" /> <short value="Versicherter im VSDM" /> <definition value="Der VSDMPatient bildet einen Versicherten im Versichertenstammdatenmanagement (VSDM) 2.0 ab. Der VSDMPatient ist vom zentralen TIPatient abgeleitet. Der Ressource Server des VSDM stellt allerdings keinen FHIR Data Service im Sinne des Implementation Guide TI Common dar, so dass die meisten Anforderungen dieses IG auf den VSDMPatient nicht zutreffen. Dieser Sachverhalt wird in einer Folgeversion des IG klargestellt." /> </element> <element id="Patient.identifier"> <path value="Patient.identifier" /> <min value="1" /> </element> <element id="Patient.identifier:KVNR"> <path value="Patient.identifier" /> <sliceName value="KVNR" /> <short value="Versichertennummer (KVNR)" /> <definition value="Es wird der zehnstellig (unveränderliche) Teil der KVNR verwendet. Zur eindeutigen Identifikation muss genau eine KVNR angegeben werden." /> <comment value="Hinweise zur Verwendung und Beispiele siehe [Lebenslange Krankenversicherten-ID](https://ig.fhir.de/basisprofile-de/stable/ig-markdown-LebenslangeKrankenversichertennummer10-stelligeKVID-Identifier.html) im deutschen Basisprofil." /> <requirements value="Die KVNR identifiziert den Versicherten, auf den sich die bereitgestellten Stammdaten beziehen." /> <min value="1" /> </element> <element id="Patient.name:Name"> <path value="Patient.name" /> <sliceName value="Name" /> </element> <element id="Patient.name:Name.text"> <path value="Patient.name.text" /> <short value="vollständiger zusammengesetzter Name" /> <definition value="Zur besseren Lesbarkeit sowie zur leichteren Verarbeitung für Systeme, die die einzelnen Namensbestandteile nicht getrennt benötigen, SOLL dieses Attribut den gesamten Namen mit Titel, Vorsatzwort und Namenszusätzen enthalten. Die Bildungsregel ist dabei [Titel] [Vornamen] [Namenszusätze] [Vorsatzworte] [Nachnamen]." /> <comment value="Hinweise und Beispiele siehe [Name (Patient)](https://ig.fhir.de/basisprofile-de/stable/ig-markdown-Ressourcen-Patient.html#ig-markdown-Ressourcen-Patient-Name) im deutschen Basisprofil" /> </element> <element id="Patient.name:Name.family"> <path value="Patient.name.family" /> <comment value="Hinweise zur Bildung des gesamten Namenamens siehe [Name (Patient)](https://ig.fhir.de/basisprofile-de/stable/ig-markdown-Ressourcen-Patient.html#ig-markdown-Ressourcen-Patient-Name) im deutschen Basisprofil Verwender müssen mindestens 87 Zeichen verarbeiten können." /> </element> <element id="Patient.name:Name.family.extension:namenszusatz"> <path value="Patient.name.family.extension" /> <sliceName value="namenszusatz" /> <comment value="Hinweise zum Umgang mit dieser Erweiterung siehe [Name (Patient)](https://ig.fhir.de/basisprofile-de/stable/ig-markdown-Ressourcen-Patient.html#ig-markdown-Ressourcen-Patient-Name) im deutschen Basisprofil Eine Tabelle der gültigen Namenszusätze findet sich in Anlage 7 zur DEÜV, siehe www.gkv-datenaustausch.de/arbeitgeber/deuev/gemeinsame_rundschreiben/gemeinsame_rundschreiben.jsp. Um die Verarbeitung ausländischer Namensangaben nicht zu verhindern, ist die Wertetabelle nur als "preferred binding" hinterlegt. Verwender müssen mindestens 20 Zeichen verarbeiten können." /> </element> <element id="Patient.name:Name.family.extension:namenszusatz.value[x]"> <path value="Patient.name.family.extension.value[x]" /> <binding> <strength value="preferred" /> <valueSet value="https://gematik.de/fhir/vsdm2/ValueSet/VSDMNamenszusatzVS" /> </binding> </element> <element id="Patient.name:Name.family.extension:nachname"> <path value="Patient.name.family.extension" /> <sliceName value="nachname" /> <short value="Nachname ohne Vorsatzwort und Zusätze" /> <definition value="Diese Erweiterung kann den Nachnamen ohne Vorsatzworte und Zusätze aufnehmen. Wenn weder Vorsatzworte noch Namenszusätze existieren, kann die Erweiterung entfallen." /> <comment value="Hinweise zum Umgang mit dieser Erweiterung siehe [Name (Patient)](https://ig.fhir.de/basisprofile-de/stable/ig-markdown-Ressourcen-Patient.html#ig-markdown-Ressourcen-Patient-Name) im deutschen Basisprofil. Verwender müssen mindestens 45 Zeichen verarbeiten können." /> </element> <element id="Patient.name:Name.family.extension:vorsatzwort"> <path value="Patient.name.family.extension" /> <sliceName value="vorsatzwort" /> <short value="Vorsatzwort" /> <definition value="Vorsatzwort zum Nachnamen des Patienten (z.B. "van" in "Ludwig van Beethoven")." /> <comment value="Hinweise zum Umgang mit dieser Erweiterung siehe [Name (Patient)](https://ig.fhir.de/basisprofile-de/stable/ig-markdown-Ressourcen-Patient.html#ig-markdown-Ressourcen-Patient-Name) im deutschen Basisprofil. Eine Tabelle der gültigen Vorsatzworte findet sich in Anlage 6 zur DEÜV, siehe www.gkv-datenaustausch.de/arbeitgeber/deuev/gemeinsame_rundschreiben/gemeinsame_rundschreiben.jsp. Um die Verarbeitung ausländischer Namensangaben nicht zu verhindern, ist die Wertetabelle nur als "preferred binding" hinterlegt. Verwender müssen mindestens 20 Zeichen verarbeiten können." /> </element> <element id="Patient.name:Name.family.extension:vorsatzwort.value[x]"> <path value="Patient.name.family.extension.value[x]" /> <binding> <strength value="preferred" /> <valueSet value="https://gematik.de/fhir/vsdm2/ValueSet/VSDMVorsatzwortVS" /> </binding> </element> <element id="Patient.name:Name.given"> <path value="Patient.name.given" /> <comment value="Mehrere Vornamen können durch Leerzeichen oder Bindestrich getrennt in einem Wert angegeben werden. Von der Wiederholung des given-Elemente SOLL kein Gebrauch gemacht werden; es wird zur besseren Interoperabilität allerdings nicht technisch verboten. Verwender müssen mindestens 45 Zeichen verarbeiten können." /> </element> <element id="Patient.name:Name.prefix"> <path value="Patient.name.prefix" /> <definition value="Namensteile vor dem Vornamen, z.B. akademischer Titel. Wenn dieses Attribut zur Angabe des akademischen Titels verwendet wird, ist die Erweiterung prefix-qualifier mit dem Wert AC (academic) verpflichtend anzugeben. Mehrere Titel werden durch Leerzeichen getrennt angegeben. Verwender müssen mindestens 20 Zeichen verarbeiten können." /> <comment value="Beispiele zur Verwendung siehe [Name (Patient)](https://ig.fhir.de/basisprofile-de/stable/ig-markdown-Ressourcen-Patient.html#ig-markdown-Ressourcen-Patient-Name) im deutschen Basisprofil." /> </element> <element id="Patient.name:Name.prefix.extension:prefix-qualifier"> <path value="Patient.name.prefix.extension" /> <sliceName value="prefix-qualifier" /> <short value="Art des Namenspräfix" /> <definition value="Kodierte Angabe der Art des Namenspräfix zur technischen Unterscheidung zwischen verschieden Präfixen wie akademischem Titel. Achtung: Für das Vorsatzwort ist das Attribut family.extension[vorsatzwort] zu verwenden. Für akademische Titel ist verpflichtend die Kennzeichnung AC (academic) zu verwenden." /> <comment value="Beispiele zur Verwendung siehe [Name (Patient)](https://ig.fhir.de/basisprofile-de/stable/ig-markdown-Ressourcen-Patient.html#ig-markdown-Ressourcen-Patient-Name) im deutschen Basisprofil." /> </element> <element id="Patient.telecom"> <path value="Patient.telecom" /> <slicing> <discriminator> <type value="profile" /> <path value="system" /> </discriminator> <rules value="open" /> </slicing> </element> <element id="Patient.telecom:TIMessengerID"> <path value="Patient.telecom" /> <sliceName value="TIMessengerID" /> <comment value="Bis zur Schaffung einer entsprechenden Rechtsgrundlage wird die TI-Messenger-ID für GKV-Versicherte im VSDM 2.0 nicht genutzt." /> <min value="0" /> <max value="1" /> <type> <code value="ContactPoint" /> <profile value="https://gematik.de/fhir/vsdm2/StructureDefinition/VSDMContactPointTIM" /> </type> </element> <element id="Patient.gender"> <path value="Patient.gender" /> <short value="Administrative Geschlechtsangabe (FHIR-Kodierung)" /> <definition value="Administrative Geschlechtsangabe gemäß den Unterlagen des Kostenträgers, kodiert nach FHIR-Standard." /> <comment value="Hinweise zur Verwendung dieses Attributs und der Erweiterung siehe [Geschlecht (Patient)](https://ig.fhir.de/basisprofile-de/stable/ig-markdown-Ressourcen-Patient.html#ig-markdown-Ressourcen-Patient-Geschlecht) im deutschen Basisprofil." /> </element> <element id="Patient.gender.extension:other-amtlich"> <path value="Patient.gender.extension" /> <sliceName value="other-amtlich" /> <short value="Administrative Geschlechtsangabe (deutsche Kodierung)" /> <definition value="Administrative Geschlechtsangabe gemäß den Unterlagen des Kostenträgers, kodiert nach Wertetabelle zur Unterscheidung zwischen "divers" und "unbestimmt"." /> <comment value="Hinweise zur Verwendung dieses Attributs und der Erweiterung siehe [Geschlecht (Patient)](https://ig.fhir.de/basisprofile-de/stable/ig-markdown-Ressourcen-Patient.html#ig-markdown-Ressourcen-Patient-Geschlecht) im deutschen Basisprofil. Nur bei FHIR-Kodierung "other" zu verwenden (vgl. Constraint pat-de-1)." /> <mustSupport value="true" /> </element> <element id="Patient.birthDate"> <path value="Patient.birthDate" /> <definition value="Das Geburtsdatum des Versicherten ist in den VSD eine Pflichtangabe. Partielle Datumsangaben sind allerdings zulässig." /> <comment value="Hinweise insbesondere zur Angabe unvollständiger Datumswerte siehe [Geburtsdatum (Patient)](https://ig.fhir.de/basisprofile-de/stable/ig-markdown-Ressourcen-Patient.html#ig-markdown-Ressourcen-Patient-Geburtsdatum)." /> </element> <element id="Patient.address"> <path value="Patient.address" /> <slicing> <discriminator> <type value="value" /> <path value="type" /> </discriminator> <rules value="open" /> </slicing> </element> <element id="Patient.address:StrassenAdresse"> <path value="Patient.address" /> <sliceName value="StrassenAdresse" /> <min value="0" /> <max value="1" /> <type> <code value="Address" /> <profile value="http://fhir.de/StructureDefinition/address-de-basis" /> </type> <mustSupport value="true" /> </element> <element id="Patient.address:StrassenAdresse.type"> <path value="Patient.address.type" /> <min value="1" /> <patternCode value="physical" /> </element> <element id="Patient.address:StrassenAdresse.line"> <path value="Patient.address.line" /> <comment value="Hinweise zur Abbildung von Adressen und Beispiele siehe [Adresse (Patient)](https://ig.fhir.de/basisprofile-de/stable/ig-markdown-Ressourcen-Patient.html#ig-markdown-Ressourcen-Patient-Addresse) im deutschen Basisprofil." /> <mustSupport value="true" /> </element> <element id="Patient.address:StrassenAdresse.line.extension:Strasse"> <path value="Patient.address.line.extension" /> <sliceName value="Strasse" /> <mustSupport value="true" /> </element> <element id="Patient.address:StrassenAdresse.line.extension:Hausnummer"> <path value="Patient.address.line.extension" /> <sliceName value="Hausnummer" /> <mustSupport value="true" /> </element> <element id="Patient.address:StrassenAdresse.line.extension:Adresszusatz"> <path value="Patient.address.line.extension" /> <sliceName value="Adresszusatz" /> <mustSupport value="true" /> </element> <element id="Patient.address:StrassenAdresse.city"> <path value="Patient.address.city" /> <mustSupport value="true" /> </element> <element id="Patient.address:StrassenAdresse.postalCode"> <path value="Patient.address.postalCode" /> <mustSupport value="true" /> </element> <element id="Patient.address:StrassenAdresse.country"> <path value="Patient.address.country" /> <definition value="Staatsangabe" /> <comment value="Hier ist die Staatsangabe im Volltext (z.B. zur postalischen Adressierung) anzugeben." /> <mustSupport value="true" /> </element> <element id="Patient.address:StrassenAdresse.country.extension"> <path value="Patient.address.country.extension" /> <slicing> <discriminator> <type value="value" /> <path value="url" /> </discriminator> <discriminator> <type value="pattern" /> <path value="value.ofType(Coding)" /> </discriminator> <rules value="open" /> </slicing> <min value="1" /> </element> <element id="Patient.address:StrassenAdresse.country.extension:countryCode"> <path value="Patient.address.country.extension" /> <sliceName value="countryCode" /> <short value="Länderkennzeichen nach ISO 3166-1" /> <definition value="Kodierte Angabe des Länderkennzeichens nach ISO 3166-1." /> <comment value="Diese Abbildung entspricht der auf EU-Ebene in Abstimmung befindlichen Profilierung zur [Kodierung der Landesangabe](https://build.fhir.org/ig/hl7-eu/base/StructureDefinition-Address-eu.html). Durch die Verwendung der internationalen Kodierung wird die interoperable Verwendung der Adressangabe erleichtert. In der DEÜV gibt es allerdings Ländercodes, die sich nicht auf den zum Zeitpunkt der Veröffentlichung bestehenden Stand der ISO 3166-1 abbilden lassen. Um eine Abbildung ohne Informationsverlust zu ermöglichen, wird mit dem erweiterten ValueSet die Verwendung eines alternativen CodeSystem ermöglicht." /> <min value="1" /> <max value="1" /> <type> <code value="Extension" /> <profile value="http://hl7.org/fhir/StructureDefinition/iso21090-codedString" /> </type> <mustSupport value="true" /> </element> <element id="Patient.address:StrassenAdresse.country.extension:countryCode.value[x]"> <path value="Patient.address.country.extension.value[x]" /> <binding> <strength value="required" /> <valueSet value="https://gematik.de/fhir/vsdm2/ValueSet/VSDMISO3166VS" /> </binding> </element> <element id="Patient.address:StrassenAdresse.country.extension:anlage8"> <path value="Patient.address.country.extension" /> <sliceName value="anlage8" /> <short value="Länderkennzeichen nach DEÜV Anlage 8" /> <definition value="Kodierte Angabe des Länderkennzeichens nach DEÜV, Anlage 8." /> <comment value="Diese Erweiterung dient zur Wahrung der Abwärtskompatibilität für Systeme, die den gemäß DEÜV kodierten Wert benötigen. Die Kodierung nach DEÜV ist im GKV-Bereich eine Pflichtangabe, im PKV-Bereich ist sie optional. Um diese Vorgabe einer konditionalen Prüfung umzusetzen, sind die Invarianten VSDMCoverageGKV-address-* an der VSDMCoverageGKV-Struktur hinterlegt. Diese Invarianten erzwingen die Angabe des Länderkennzeichens nach DEÜV, sobald auf die Ressource, die die Adresse enthält, aus einem GKV-Versicherungsverhältnis referenziert wird." /> <min value="0" /> <max value="1" /> <type> <code value="Extension" /> <profile value="http://hl7.org/fhir/StructureDefinition/iso21090-codedString" /> </type> <mustSupport value="true" /> </element> <element id="Patient.address:StrassenAdresse.country.extension:anlage8.value[x]"> <path value="Patient.address.country.extension.value[x]" /> <binding> <strength value="required" /> <valueSet value="https://fhir.kbv.de/ValueSet/KBV_VS_Base_Deuev_Anlage_8" /> </binding> </element> <element id="Patient.address:StrassenAdresse.country.extension:anlage8.value[x].system"> <path value="Patient.address.country.extension.value[x].system" /> <fixedUri value="http://fhir.de/CodeSystem/deuev/anlage-8-laenderkennzeichen" /> </element> <element id="Patient.address:PostfachAdresse"> <path value="Patient.address" /> <sliceName value="PostfachAdresse" /> <min value="0" /> <max value="1" /> <type> <code value="Address" /> <profile value="http://fhir.de/StructureDefinition/address-de-basis" /> </type> <mustSupport value="true" /> </element> <element id="Patient.address:PostfachAdresse.type"> <path value="Patient.address.type" /> <min value="1" /> <patternCode value="postal" /> </element> <element id="Patient.address:PostfachAdresse.line"> <path value="Patient.address.line" /> <comment value="Hinweise zur Abbildung von Adressen und Beispiele siehe [Adresse (Patient)](https://ig.fhir.de/basisprofile-de/stable/ig-markdown-Ressourcen-Patient.html#ig-markdown-Ressourcen-Patient-Addresse) im deutschen Basisprofil." /> <mustSupport value="true" /> </element> <element id="Patient.address:PostfachAdresse.line.extension:Postfach"> <path value="Patient.address.line.extension" /> <sliceName value="Postfach" /> <mustSupport value="true" /> </element> <element id="Patient.address:PostfachAdresse.city"> <path value="Patient.address.city" /> <mustSupport value="true" /> </element> <element id="Patient.address:PostfachAdresse.postalCode"> <path value="Patient.address.postalCode" /> <mustSupport value="true" /> </element> <element id="Patient.address:PostfachAdresse.country"> <path value="Patient.address.country" /> <definition value="Staatsangabe" /> <comment value="Hier ist die Staatsangabe im Volltext (z.B. zur postalischen Adressierung) anzugeben." /> <mustSupport value="true" /> </element> <element id="Patient.address:PostfachAdresse.country.extension"> <path value="Patient.address.country.extension" /> <slicing> <discriminator> <type value="value" /> <path value="url" /> </discriminator> <discriminator> <type value="pattern" /> <path value="value.ofType(Coding)" /> </discriminator> <rules value="open" /> </slicing> <min value="1" /> </element> <element id="Patient.address:PostfachAdresse.country.extension:countryCode"> <path value="Patient.address.country.extension" /> <sliceName value="countryCode" /> <short value="Länderkennzeichen nach ISO 3166-1" /> <definition value="Kodierte Angabe des Länderkennzeichens nach ISO 3166-1." /> <comment value="Diese Abbildung entspricht der auf EU-Ebene in Abstimmung befindlichen Profilierung zur [Kodierung der Landesangabe](https://build.fhir.org/ig/hl7-eu/base/StructureDefinition-Address-eu.html). Durch die Verwendung der internationalen Kodierung wird die interoperable Verwendung der Adressangabe erleichtert. In der DEÜV gibt es allerdings Ländercodes, die sich nicht auf den zum Zeitpunkt der Veröffentlichung bestehenden Stand der ISO 3166-1 abbilden lassen. Um eine Abbildung ohne Informationsverlust zu ermöglichen, wird mit dem erweiterten ValueSet die Verwendung eines alternativen CodeSystem ermöglicht." /> <min value="1" /> <max value="1" /> <type> <code value="Extension" /> <profile value="http://hl7.org/fhir/StructureDefinition/iso21090-codedString" /> </type> <mustSupport value="true" /> </element> <element id="Patient.address:PostfachAdresse.country.extension:countryCode.value[x]"> <path value="Patient.address.country.extension.value[x]" /> <binding> <strength value="required" /> <valueSet value="https://gematik.de/fhir/vsdm2/ValueSet/VSDMISO3166VS" /> </binding> </element> <element id="Patient.address:PostfachAdresse.country.extension:anlage8"> <path value="Patient.address.country.extension" /> <sliceName value="anlage8" /> <short value="Länderkennzeichen nach DEÜV Anlage 8" /> <definition value="Kodierte Angabe des Länderkennzeichens nach DEÜV, Anlage 8." /> <comment value="Diese Erweiterung dient zur Wahrung der Abwärtskompatibilität für Systeme, die den gemäß DEÜV kodierten Wert benötigen. Die Kodierung nach DEÜV ist im GKV-Bereich eine Pflichtangabe, im PKV-Bereich ist sie optional. Um diese Vorgabe einer konditionalen Prüfung umzusetzen, sind die Invarianten VSDMCoverageGKV-address-* an der VSDMCoverageGKV-Struktur hinterlegt. Diese Invarianten erzwingen die Angabe des Länderkennzeichens nach DEÜV, sobald auf die Ressource, die die Adresse enthält, aus einem GKV-Versicherungsverhältnis referenziert wird." /> <min value="0" /> <max value="1" /> <type> <code value="Extension" /> <profile value="http://hl7.org/fhir/StructureDefinition/iso21090-codedString" /> </type> <mustSupport value="true" /> </element> <element id="Patient.address:PostfachAdresse.country.extension:anlage8.value[x]"> <path value="Patient.address.country.extension.value[x]" /> <binding> <strength value="required" /> <valueSet value="https://fhir.kbv.de/ValueSet/KBV_VS_Base_Deuev_Anlage_8" /> </binding> </element> <element id="Patient.address:PostfachAdresse.country.extension:anlage8.value[x].system"> <path value="Patient.address.country.extension.value[x].system" /> <fixedUri value="http://fhir.de/CodeSystem/deuev/anlage-8-laenderkennzeichen" /> </element> </differential> </StructureDefinition>