StructureDefinition-VSDMPatient.json

{
  "resourceType": "StructureDefinition",
  "id": "VSDMPatient",
  "url": "https://gematik.de/fhir/vsdm2/StructureDefinition/VSDMPatient",
  "version": "1.0.0-rc7",
  "name": "VSDMPatient",
  "title": "Versicherter",
  "status": "active",
  "experimental": false,
  "date": "2026-03-13",
  "publisher": "gematik GmbH",
  "description": "Angaben zum Versicherten im Versichertenstammdatenmanagement (VSDM) 2.0",
  "fhirVersion": "4.0.1",
  "kind": "resource",
  "abstract": false,
  "type": "Patient",
  "baseDefinition": "https://gematik.de/fhir/ti/StructureDefinition/ti-patient",
  "derivation": "constraint",
  "differential": {
    "element": [
      {
        "id": "Patient",
        "path": "Patient",
        "short": "Versicherter im VSDM",
        "definition": "Der VSDMPatient bildet einen Versicherten im Versichertenstammdatenmanagement (VSDM) 2.0 ab.\nDer VSDMPatient ist vom zentralen TIPatient abgeleitet. \nDer 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.\nDieser Sachverhalt wird in einer Folgeversion des IG klargestellt."
      },
      {
        "id": "Patient.identifier",
        "path": "Patient.identifier",
        "min": 1
      },
      {
        "id": "Patient.identifier:KVNR",
        "path": "Patient.identifier",
        "sliceName": "KVNR",
        "short": "Versichertennummer (KVNR)",
        "definition": "Es wird der zehnstellig (unveränderliche) Teil der KVNR verwendet. \nZur eindeutigen Identifikation muss genau eine KVNR angegeben werden.",
        "comment": "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": "Die KVNR identifiziert den Versicherten, auf den sich die bereitgestellten Stammdaten beziehen.",
        "min": 1
      },
      {
        "id": "Patient.name:Name",
        "path": "Patient.name",
        "sliceName": "Name"
      },
      {
        "id": "Patient.name:Name.text",
        "path": "Patient.name.text",
        "short": "vollständiger zusammengesetzter Name",
        "definition": "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.\nDie Bildungsregel ist dabei [Titel] [Vornamen] [Namenszusätze] [Vorsatzworte] [Nachnamen].",
        "comment": "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"
      },
      {
        "id": "Patient.name:Name.family",
        "path": "Patient.name.family",
        "comment": "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\nVerwender müssen mindestens 87 Zeichen verarbeiten können."
      },
      {
        "id": "Patient.name:Name.family.extension:namenszusatz",
        "path": "Patient.name.family.extension",
        "sliceName": "namenszusatz",
        "comment": "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\nEine 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.\nUm die Verarbeitung ausländischer Namensangaben nicht zu verhindern, ist die Wertetabelle nur als \"preferred binding\" hinterlegt.\nVerwender müssen mindestens 20 Zeichen verarbeiten können."
      },
      {
        "id": "Patient.name:Name.family.extension:namenszusatz.value[x]",
        "path": "Patient.name.family.extension.value[x]",
        "binding": {
          "strength": "preferred",
          "valueSet": "https://gematik.de/fhir/vsdm2/ValueSet/VSDMNamenszusatzVS"
        }
      },
      {
        "id": "Patient.name:Name.family.extension:nachname",
        "path": "Patient.name.family.extension",
        "sliceName": "nachname",
        "short": "Nachname ohne Vorsatzwort und Zusätze",
        "definition": "Diese Erweiterung kann den Nachnamen ohne Vorsatzworte und Zusätze aufnehmen.\nWenn weder Vorsatzworte noch Namenszusätze existieren, kann die Erweiterung entfallen.",
        "comment": "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.\nVerwender müssen mindestens 45 Zeichen verarbeiten können."
      },
      {
        "id": "Patient.name:Name.family.extension:vorsatzwort",
        "path": "Patient.name.family.extension",
        "sliceName": "vorsatzwort",
        "short": "Vorsatzwort",
        "definition": "Vorsatzwort zum Nachnamen des Patienten (z.B. \"van\" in \"Ludwig van Beethoven\").",
        "comment": "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.\nEine 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.\nUm die Verarbeitung ausländischer Namensangaben nicht zu verhindern, ist die Wertetabelle nur als \"preferred binding\" hinterlegt.\nVerwender müssen mindestens 20 Zeichen verarbeiten können."
      },
      {
        "id": "Patient.name:Name.family.extension:vorsatzwort.value[x]",
        "path": "Patient.name.family.extension.value[x]",
        "binding": {
          "strength": "preferred",
          "valueSet": "https://gematik.de/fhir/vsdm2/ValueSet/VSDMVorsatzwortVS"
        }
      },
      {
        "id": "Patient.name:Name.given",
        "path": "Patient.name.given",
        "comment": "Mehrere Vornamen können durch Leerzeichen oder Bindestrich getrennt in einem Wert angegeben werden. \nVon der Wiederholung des given-Elemente SOLL kein Gebrauch gemacht werden; es wird zur besseren Interoperabilität allerdings nicht technisch verboten.\nVerwender müssen mindestens 45 Zeichen verarbeiten können."
      },
      {
        "id": "Patient.name:Name.prefix",
        "path": "Patient.name.prefix",
        "definition": "Namensteile vor dem Vornamen, z.B. akademischer Titel.\nWenn dieses Attribut zur Angabe des akademischen Titels verwendet wird, ist die Erweiterung prefix-qualifier mit dem Wert AC (academic) verpflichtend anzugeben.\nMehrere Titel werden durch Leerzeichen getrennt angegeben. \nVerwender müssen mindestens 20 Zeichen verarbeiten können.",
        "comment": "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."
      },
      {
        "id": "Patient.name:Name.prefix.extension:prefix-qualifier",
        "path": "Patient.name.prefix.extension",
        "sliceName": "prefix-qualifier",
        "short": "Art des Namenspräfix",
        "definition": "Kodierte Angabe der Art des Namenspräfix zur technischen Unterscheidung zwischen verschieden Präfixen wie akademischem Titel.\nAchtung: Für das Vorsatzwort ist das Attribut family.extension[vorsatzwort] zu verwenden.\nFür akademische Titel ist verpflichtend die Kennzeichnung AC (academic) zu verwenden.",
        "comment": "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."
      },
      {
        "id": "Patient.telecom",
        "path": "Patient.telecom",
        "slicing": {
          "discriminator": [
            {
              "type": "profile",
              "path": "system"
            }
          ],
          "rules": "open"
        }
      },
      {
        "id": "Patient.telecom:TIMessengerID",
        "path": "Patient.telecom",
        "sliceName": "TIMessengerID",
        "comment": "Bis zur Schaffung einer entsprechenden Rechtsgrundlage wird die TI-Messenger-ID für GKV-Versicherte im VSDM 2.0 nicht genutzt.",
        "min": 0,
        "max": "1",
        "type": [
          {
            "code": "ContactPoint",
            "profile": [
              "https://gematik.de/fhir/vsdm2/StructureDefinition/VSDMContactPointTIM"
            ]
          }
        ]
      },
      {
        "id": "Patient.gender",
        "path": "Patient.gender",
        "short": "Administrative Geschlechtsangabe (FHIR-Kodierung)",
        "definition": "Administrative Geschlechtsangabe gemäß den Unterlagen des Kostenträgers, kodiert nach FHIR-Standard.",
        "comment": "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."
      },
      {
        "id": "Patient.gender.extension:other-amtlich",
        "path": "Patient.gender.extension",
        "sliceName": "other-amtlich",
        "short": "Administrative Geschlechtsangabe (deutsche Kodierung)",
        "definition": "Administrative Geschlechtsangabe gemäß den Unterlagen des Kostenträgers, kodiert nach Wertetabelle zur Unterscheidung zwischen \"divers\" und \"unbestimmt\".",
        "comment": "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.\nNur bei FHIR-Kodierung \"other\" zu verwenden (vgl. Constraint pat-de-1).",
        "mustSupport": true
      },
      {
        "id": "Patient.birthDate",
        "path": "Patient.birthDate",
        "definition": "Das Geburtsdatum des Versicherten ist in den VSD eine Pflichtangabe. \nPartielle Datumsangaben sind allerdings zulässig.",
        "comment": "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)."
      },
      {
        "id": "Patient.address",
        "path": "Patient.address",
        "slicing": {
          "discriminator": [
            {
              "type": "value",
              "path": "type"
            }
          ],
          "rules": "open"
        }
      },
      {
        "id": "Patient.address:StrassenAdresse",
        "path": "Patient.address",
        "sliceName": "StrassenAdresse",
        "min": 0,
        "max": "1",
        "type": [
          {
            "code": "Address",
            "profile": [
              "http://fhir.de/StructureDefinition/address-de-basis"
            ]
          }
        ],
        "mustSupport": true
      },
      {
        "id": "Patient.address:StrassenAdresse.type",
        "path": "Patient.address.type",
        "min": 1,
        "patternCode": "physical"
      },
      {
        "id": "Patient.address:StrassenAdresse.line",
        "path": "Patient.address.line",
        "comment": "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": true
      },
      {
        "id": "Patient.address:StrassenAdresse.line.extension:Strasse",
        "path": "Patient.address.line.extension",
        "sliceName": "Strasse",
        "mustSupport": true
      },
      {
        "id": "Patient.address:StrassenAdresse.line.extension:Hausnummer",
        "path": "Patient.address.line.extension",
        "sliceName": "Hausnummer",
        "mustSupport": true
      },
      {
        "id": "Patient.address:StrassenAdresse.line.extension:Adresszusatz",
        "path": "Patient.address.line.extension",
        "sliceName": "Adresszusatz",
        "mustSupport": true
      },
      {
        "id": "Patient.address:StrassenAdresse.city",
        "path": "Patient.address.city",
        "mustSupport": true
      },
      {
        "id": "Patient.address:StrassenAdresse.postalCode",
        "path": "Patient.address.postalCode",
        "mustSupport": true
      },
      {
        "id": "Patient.address:StrassenAdresse.country",
        "path": "Patient.address.country",
        "definition": "Staatsangabe",
        "comment": "Hier ist die Staatsangabe im Volltext (z.B. zur postalischen Adressierung) anzugeben.",
        "mustSupport": true
      },
      {
        "id": "Patient.address:StrassenAdresse.country.extension",
        "path": "Patient.address.country.extension",
        "slicing": {
          "rules": "open",
          "discriminator": [
            {
              "type": "value",
              "path": "url"
            },
            {
              "type": "pattern",
              "path": "value.ofType(Coding)"
            }
          ]
        },
        "min": 1
      },
      {
        "id": "Patient.address:StrassenAdresse.country.extension:countryCode",
        "path": "Patient.address.country.extension",
        "sliceName": "countryCode",
        "short": "Länderkennzeichen nach ISO 3166-1",
        "definition": "Kodierte Angabe des Länderkennzeichens nach ISO 3166-1.",
        "comment": "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).\nDurch die Verwendung der internationalen Kodierung wird die interoperable Verwendung der Adressangabe erleichtert.\nIn 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.\nUm eine Abbildung ohne Informationsverlust zu ermöglichen, wird mit dem erweiterten ValueSet die Verwendung eines alternativen CodeSystem ermöglicht.",
        "min": 1,
        "max": "1",
        "type": [
          {
            "code": "Extension",
            "profile": [
              "http://hl7.org/fhir/StructureDefinition/iso21090-codedString"
            ]
          }
        ],
        "mustSupport": true
      },
      {
        "id": "Patient.address:StrassenAdresse.country.extension:countryCode.value[x]",
        "path": "Patient.address.country.extension.value[x]",
        "binding": {
          "strength": "required",
          "valueSet": "https://gematik.de/fhir/vsdm2/ValueSet/VSDMISO3166VS"
        }
      },
      {
        "id": "Patient.address:StrassenAdresse.country.extension:anlage8",
        "path": "Patient.address.country.extension",
        "sliceName": "anlage8",
        "short": "Länderkennzeichen nach DEÜV Anlage 8",
        "definition": "Kodierte Angabe des Länderkennzeichens nach DEÜV, Anlage 8. ",
        "comment": "Diese Erweiterung dient zur Wahrung der Abwärtskompatibilität für Systeme, die den gemäß DEÜV kodierten Wert benötigen.\nDie Kodierung nach DEÜV ist im GKV-Bereich eine Pflichtangabe, im PKV-Bereich ist sie optional.\nUm diese Vorgabe einer konditionalen Prüfung umzusetzen, sind die Invarianten VSDMCoverageGKV-address-* an der VSDMCoverageGKV-Struktur hinterlegt.\nDiese 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": 0,
        "max": "1",
        "type": [
          {
            "code": "Extension",
            "profile": [
              "http://hl7.org/fhir/StructureDefinition/iso21090-codedString"
            ]
          }
        ],
        "mustSupport": true
      },
      {
        "id": "Patient.address:StrassenAdresse.country.extension:anlage8.value[x]",
        "path": "Patient.address.country.extension.value[x]",
        "binding": {
          "strength": "required",
          "valueSet": "https://fhir.kbv.de/ValueSet/KBV_VS_Base_Deuev_Anlage_8"
        }
      },
      {
        "id": "Patient.address:StrassenAdresse.country.extension:anlage8.value[x].system",
        "path": "Patient.address.country.extension.value[x].system",
        "fixedUri": "http://fhir.de/CodeSystem/deuev/anlage-8-laenderkennzeichen"
      },
      {
        "id": "Patient.address:PostfachAdresse",
        "path": "Patient.address",
        "sliceName": "PostfachAdresse",
        "min": 0,
        "max": "1",
        "type": [
          {
            "code": "Address",
            "profile": [
              "http://fhir.de/StructureDefinition/address-de-basis"
            ]
          }
        ],
        "mustSupport": true
      },
      {
        "id": "Patient.address:PostfachAdresse.type",
        "path": "Patient.address.type",
        "min": 1,
        "patternCode": "postal"
      },
      {
        "id": "Patient.address:PostfachAdresse.line",
        "path": "Patient.address.line",
        "comment": "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": true
      },
      {
        "id": "Patient.address:PostfachAdresse.line.extension:Postfach",
        "path": "Patient.address.line.extension",
        "sliceName": "Postfach",
        "mustSupport": true
      },
      {
        "id": "Patient.address:PostfachAdresse.city",
        "path": "Patient.address.city",
        "mustSupport": true
      },
      {
        "id": "Patient.address:PostfachAdresse.postalCode",
        "path": "Patient.address.postalCode",
        "mustSupport": true
      },
      {
        "id": "Patient.address:PostfachAdresse.country",
        "path": "Patient.address.country",
        "definition": "Staatsangabe",
        "comment": "Hier ist die Staatsangabe im Volltext (z.B. zur postalischen Adressierung) anzugeben.",
        "mustSupport": true
      },
      {
        "id": "Patient.address:PostfachAdresse.country.extension",
        "path": "Patient.address.country.extension",
        "slicing": {
          "rules": "open",
          "discriminator": [
            {
              "type": "value",
              "path": "url"
            },
            {
              "type": "pattern",
              "path": "value.ofType(Coding)"
            }
          ]
        },
        "min": 1
      },
      {
        "id": "Patient.address:PostfachAdresse.country.extension:countryCode",
        "path": "Patient.address.country.extension",
        "sliceName": "countryCode",
        "short": "Länderkennzeichen nach ISO 3166-1",
        "definition": "Kodierte Angabe des Länderkennzeichens nach ISO 3166-1.",
        "comment": "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).\nDurch die Verwendung der internationalen Kodierung wird die interoperable Verwendung der Adressangabe erleichtert.\nIn 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.\nUm eine Abbildung ohne Informationsverlust zu ermöglichen, wird mit dem erweiterten ValueSet die Verwendung eines alternativen CodeSystem ermöglicht.",
        "min": 1,
        "max": "1",
        "type": [
          {
            "code": "Extension",
            "profile": [
              "http://hl7.org/fhir/StructureDefinition/iso21090-codedString"
            ]
          }
        ],
        "mustSupport": true
      },
      {
        "id": "Patient.address:PostfachAdresse.country.extension:countryCode.value[x]",
        "path": "Patient.address.country.extension.value[x]",
        "binding": {
          "strength": "required",
          "valueSet": "https://gematik.de/fhir/vsdm2/ValueSet/VSDMISO3166VS"
        }
      },
      {
        "id": "Patient.address:PostfachAdresse.country.extension:anlage8",
        "path": "Patient.address.country.extension",
        "sliceName": "anlage8",
        "short": "Länderkennzeichen nach DEÜV Anlage 8",
        "definition": "Kodierte Angabe des Länderkennzeichens nach DEÜV, Anlage 8. ",
        "comment": "Diese Erweiterung dient zur Wahrung der Abwärtskompatibilität für Systeme, die den gemäß DEÜV kodierten Wert benötigen.\nDie Kodierung nach DEÜV ist im GKV-Bereich eine Pflichtangabe, im PKV-Bereich ist sie optional.\nUm diese Vorgabe einer konditionalen Prüfung umzusetzen, sind die Invarianten VSDMCoverageGKV-address-* an der VSDMCoverageGKV-Struktur hinterlegt.\nDiese 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": 0,
        "max": "1",
        "type": [
          {
            "code": "Extension",
            "profile": [
              "http://hl7.org/fhir/StructureDefinition/iso21090-codedString"
            ]
          }
        ],
        "mustSupport": true
      },
      {
        "id": "Patient.address:PostfachAdresse.country.extension:anlage8.value[x]",
        "path": "Patient.address.country.extension.value[x]",
        "binding": {
          "strength": "required",
          "valueSet": "https://fhir.kbv.de/ValueSet/KBV_VS_Base_Deuev_Anlage_8"
        }
      },
      {
        "id": "Patient.address:PostfachAdresse.country.extension:anlage8.value[x].system",
        "path": "Patient.address.country.extension.value[x].system",
        "fixedUri": "http://fhir.de/CodeSystem/deuev/anlage-8-laenderkennzeichen"
      }
    ]
  }
}