{
  "description": "Angaben zum Kostenträger im Versichertenstammdatenmanagement (VSDM) 2.0",
  "_filename": "StructureDefinition-VSDMPayorOrganization.json",
  "package_name": "de.gematik.vsdm2",
  "date": "2026-07-03",
  "derivation": "constraint",
  "publisher": "gematik GmbH",
  "fhirVersion": "4.0.1",
  "jurisdiction": [ {
    "coding": [ {
      "code": "DE",
      "system": "urn:iso:std:iso:3166",
      "display": "Germany"
    } ]
  } ],
  "name": "VSDMPayorOrganization",
  "abstract": false,
  "type": "Organization",
  "experimental": "false",
  "resourceType": "StructureDefinition",
  "title": "Kostenträger",
  "package_version": "1.1.0",
  "status": "active",
  "id": "b3e5dd1a-45c8-4c3c-9db4-faed6a232d4c",
  "kind": "resource",
  "url": "https://gematik.de/fhir/vsdm2/StructureDefinition/VSDMPayorOrganization",
  "version": "1.1.0",
  "differential": {
    "element": [ {
      "id": "Organization",
      "path": "Organization",
      "short": "Kostenträger",
      "comment": "Die Struktur wird unabhängig von der Versicherungsart (GKV/PKV) definiert.",
      "definition": "Angaben zum Kostenträger im Versichertenstammdatenmanagement (VSDM) 2.0"
    }, {
      "id": "Organization.identifier",
      "min": 1,
      "path": "Organization.identifier",
      "slicing": {
        "rules": "open",
        "discriminator": [ {
          "path": "system",
          "type": "value"
        } ]
      },
      "mustSupport": true
    }, {
      "path": "Organization.identifier",
      "min": 1,
      "definition": "Eindeutige Identifikation des Kostenträgers über das Institutionskennzeichen (IKNR).",
      "short": "Institutionskennzeichen (IKNR)",
      "type": [ {
        "code": "Identifier",
        "profile": [ "http://fhir.de/StructureDefinition/identifier-iknr" ]
      } ],
      "mustSupport": true,
      "sliceName": "IKNR",
      "max": "1",
      "id": "Organization.identifier:IKNR"
    }, {
      "id": "Organization.name",
      "min": 1,
      "path": "Organization.name",
      "short": "Name des Kostenträgers",
      "definition": "Name des Kostenträgers.\nVerwender müssen mindestens 45 Zeichen verarbeiten können.",
      "mustSupport": true
    }, {
      "id": "Organization.address",
      "min": 1,
      "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.",
      "mustSupport": true
    }, {
      "id": "Organization.address.country",
      "path": "Organization.address.country",
      "short": "Staat",
      "comment": "Hier ist die Staatsangabe im Volltext (z.B. zur postalischen Adressierung) anzugeben.",
      "constraint": [ {
        "key": "country-code-iso-or-extension-1",
        "human": "Der Ländercode muss entweder als ISO 3166-1-Code in countryCode oder mit der alternativen Erweiterung countryCodeExt angegeben werden.",
        "source": "https://gematik.de/fhir/vsdm2/StructureDefinition/VSDMPayorOrganization",
        "severity": "error",
        "expression": "extension.where(url = 'http://hl7.org/fhir/StructureDefinition/iso21090-codedString').exists() != extension.where(url = 'https://gematik.de/fhir/vsdm2/StructureDefinition/VSDMISO3166Ergaenzung').exists()"
      } ],
      "definition": "Staatsangabe",
      "mustSupport": true
    }, {
      "id": "Organization.address.country.extension",
      "path": "Organization.address.country.extension",
      "slicing": {
        "rules": "open",
        "discriminator": [ {
          "path": "url",
          "type": "value"
        }, {
          "path": "value.ofType(Coding)",
          "type": "value"
        } ]
      }
    }, {
      "path": "Organization.address.country.extension",
      "min": 0,
      "definition": "Kodierte Angabe des Länderkennzeichens nach ISO 3166-1.",
      "short": "Länderkennzeichen nach ISO 3166-1",
      "type": [ {
        "code": "Extension",
        "profile": [ "http://hl7.org/fhir/StructureDefinition/iso21090-codedString" ]
      } ],
      "mustSupport": true,
      "sliceName": "countryCode",
      "max": "1",
      "id": "Organization.address.country.extension:countryCode",
      "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."
    }, {
      "path": "Organization.address.country.extension",
      "min": 0,
      "definition": "Kodierte Angabe des Länderkennzeichens nach ISO 3166-1 (erweitert).",
      "short": "Länderkennzeichen nach ISO 3166-1 (erweitert)",
      "type": [ {
        "code": "Extension",
        "profile": [ "https://gematik.de/fhir/vsdm2/StructureDefinition/VSDMISO3166Ergaenzung" ]
      } ],
      "mustSupport": true,
      "sliceName": "countryCodeExt",
      "max": "1",
      "id": "Organization.address.country.extension:countryCodeExt",
      "comment": "In der DEÜV gibt es 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 dieser Erweiterung die Verwendung eines alternativen CodeSystem ermöglicht."
    }, {
      "path": "Organization.address.country.extension",
      "min": 0,
      "definition": "Kodierte Angabe des Länderkennzeichens nach DEÜV, Anlage 8.",
      "short": "Länderkennzeichen nach DEÜV Anlage 8",
      "type": [ {
        "code": "Extension",
        "profile": [ "https://gematik.de/fhir/vsdm2/StructureDefinition/VSDMLaenderkennzeichenAnlage8" ]
      } ],
      "mustSupport": true,
      "sliceName": "anlage8",
      "max": "1",
      "id": "Organization.address.country.extension:anlage8",
      "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."
    } ]
  },
  "contact": [ {
    "name": "gematik GmbH",
    "telecom": [ {
      "value": "https://fachportal.gematik.de/anwendungen/versichertenstammdaten-management",
      "system": "url"
    } ]
  } ],
  "baseDefinition": "http://hl7.org/fhir/StructureDefinition/Organization"
}