StructureDefinition-VSDMPayorOrganization.json

{
  "resourceType": "StructureDefinition",
  "id": "VSDMPayorOrganization",
  "url": "https://gematik.de/fhir/vsdm2/StructureDefinition/VSDMPayorOrganization",
  "version": "1.0.0-rc6",
  "name": "VSDMPayorOrganization",
  "title": "Kostenträger",
  "status": "active",
  "experimental": false,
  "date": "2026-01-30",
  "publisher": "gematik GmbH",
  "description": "Angaben zum Kostenträger im Versichertenstammdatenmanagement (VSDM) 2.0",
  "fhirVersion": "4.0.1",
  "kind": "resource",
  "abstract": false,
  "type": "Organization",
  "baseDefinition": "http://hl7.org/fhir/StructureDefinition/Organization",
  "derivation": "constraint",
  "differential": {
    "element": [
      {
        "id": "Organization",
        "path": "Organization",
        "short": "Kostenträger",
        "definition": "Angaben zum Kostenträger im Versichertenstammdatenmanagement (VSDM) 2.0",
        "comment": "Die Struktur wird unabhängig von der Versicherungsart (GKV/PKV) definiert."
      },
      {
        "id": "Organization.identifier",
        "path": "Organization.identifier",
        "slicing": {
          "discriminator": [
            {
              "type": "value",
              "path": "system"
            }
          ],
          "rules": "open"
        },
        "min": 1
      },
      {
        "id": "Organization.identifier:IKNR",
        "path": "Organization.identifier",
        "sliceName": "IKNR",
        "short": "Institutionskennzeichen (IKNR)",
        "definition": "Eindeutige Identifikation des Kostenträgers über das Institutionskennzeichen (IKNR).",
        "min": 1,
        "max": "1",
        "type": [
          {
            "code": "Identifier",
            "profile": [
              "http://fhir.de/StructureDefinition/identifier-iknr"
            ]
          }
        ],
        "mustSupport": true
      },
      {
        "id": "Organization.name",
        "path": "Organization.name",
        "short": "Name des Kostenträgers",
        "definition": "Name des Kostenträgers.\nVerwender müssen mindestens 45 Zeichen verarbeiten können.",
        "min": 1,
        "mustSupport": true
      },
      {
        "id": "Organization.address",
        "path": "Organization.address",
        "short": "Adresse des Kostenträgers",
        "definition": "Adresse des Kostenträgers. \nDie meisten Adressfelder sind optional; verpflichtend ist die Angabe des Staats (Ländercode).\nHinweise zur Abbildung von Adressen und Beispiele siehe [Adresse](https://ig.fhir.de/basisprofile-de/stable/ig-markdown-Datentypen-Address.html) im deutschen Basisprofil."
      },
      {
        "id": "Organization.address.country",
        "path": "Organization.address.country",
        "short": "Staat",
        "definition": "Staatsangabe",
        "comment": "Hier ist die Staatsangabe im Volltext (z.B. zur postalischen Adressierung) anzugeben.",
        "mustSupport": true
      },
      {
        "id": "Organization.address.country.extension",
        "path": "Organization.address.country.extension",
        "slicing": {
          "rules": "open",
          "discriminator": [
            {
              "type": "value",
              "path": "url"
            },
            {
              "type": "pattern",
              "path": "value.ofType(Coding)"
            }
          ]
        },
        "min": 1
      },
      {
        "id": "Organization.address.country.extension:countryCode",
        "path": "Organization.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": "Organization.address.country.extension:countryCode.value[x]",
        "path": "Organization.address.country.extension.value[x]",
        "binding": {
          "strength": "required",
          "valueSet": "https://gematik.de/fhir/vsdm2/ValueSet/VSDMISO3166VS"
        }
      },
      {
        "id": "Organization.address.country.extension:anlage8",
        "path": "Organization.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": "Organization.address.country.extension:anlage8.value[x]",
        "path": "Organization.address.country.extension.value[x]",
        "binding": {
          "strength": "required",
          "valueSet": "https://fhir.kbv.de/ValueSet/KBV_VS_Base_Deuev_Anlage_8"
        }
      },
      {
        "id": "Organization.address.country.extension:anlage8.value[x].system",
        "path": "Organization.address.country.extension.value[x].system",
        "fixedUri": "http://fhir.de/CodeSystem/deuev/anlage-8-laenderkennzeichen"
      }
    ]
  }
}