{
  "description": "Strukturierte Fehlermeldung im Versichertenstammdatenmanagement (VSDM) 2.0",
  "_filename": "StructureDefinition-VSDMOperationOutcome.json",
  "package_name": "de.gematik.vsdm2",
  "date": "2026-03-13",
  "derivation": "constraint",
  "publisher": "gematik GmbH",
  "fhirVersion": "4.0.1",
  "name": "VSDMOperationOutcome",
  "abstract": false,
  "type": "OperationOutcome",
  "experimental": "false",
  "resourceType": "StructureDefinition",
  "title": "Fehlermeldung des VSDM Resource Servers",
  "package_version": "1.0.0-rc7",
  "status": "active",
  "id": "ec75a804-75b8-488c-8950-8b04c8422816",
  "kind": "resource",
  "url": "https://gematik.de/fhir/vsdm2/StructureDefinition/VSDMOperationOutcome",
  "version": "1.0.0-rc7",
  "differential": {
    "element": [ {
      "id": "OperationOutcome",
      "path": "OperationOutcome",
      "short": "Fehlermeldung des VSDM Resource Servers",
      "definition": "Strukturierte Fehlermeldung im Versichertenstammdatenmanagement (VSDM) 2.0"
    }, {
      "id": "OperationOutcome.text",
      "min": 1,
      "path": "OperationOutcome.text",
      "short": "Fehlerbeschreibung zur Anzeige",
      "comment": "Der Beschreibungstext darf identisch zum Anzeigetext in issue.details.text sein.",
      "definition": "Dieser Beschreibungstext wird vom Clientsystem zur Anzeige gebracht, wenn keine anderweitige Fehlerbehandlung auf Grundlage der strukturierten Informationen möglich ist.\nDie Beschreibung soll so formuliert sein, dass sie für den Anwender des Clientsystems verständlich ist.",
      "mustSupport": true
    }, {
      "id": "OperationOutcome.text.status",
      "path": "OperationOutcome.text.status",
      "patternCode": "generated"
    }, {
      "id": "OperationOutcome.text.div",
      "path": "OperationOutcome.text.div",
      "mustSupport": true
    }, {
      "id": "OperationOutcome.issue",
      "path": "OperationOutcome.issue",
      "short": "Strukturierte Fehlerbeschreibung",
      "definition": "Diese strukturierte Fehlerbeschreibung kann zur Behandlung innerhalb des Clientsystems ausgewertet werden.",
      "mustSupport": true
    }, {
      "id": "OperationOutcome.issue.severity",
      "path": "OperationOutcome.issue.severity",
      "short": "Schweregrad der Fehlermeldung",
      "comment": "Für VSDM-spezifische Fehlermeldungen kann der Schweregrad anhand der ConceptMap VSDMErrorcodeIssueSeverity abgeleitet werden.",
      "definition": "Beschreibt die Kritikalität (den Schweregrad) der Fehlermeldung mit Bezug auf die Ausführung der gesamten Anfrage.",
      "mustSupport": true
    }, {
      "id": "OperationOutcome.issue.code",
      "path": "OperationOutcome.issue.code",
      "short": "Klassifizierung der Fehlermeldung",
      "comment": "Für VSDM-spezifische Fehlermeldungen kann der Schweregrad anhand der ConceptMap VSDMErrorcodeIssueType abgeleitet werden.",
      "definition": "Ordnet die Fehlermeldung einem standardisierten Fehlertyp zu.",
      "mustSupport": true
    }, {
      "id": "OperationOutcome.issue.details",
      "min": 1,
      "path": "OperationOutcome.issue.details",
      "short": "Fehlerbeschreibung",
      "definition": "Diese Struktur beschreibt die aufgetretene Fehlersituation."
    }, {
      "id": "OperationOutcome.issue.details.coding",
      "max": "1",
      "min": 1,
      "path": "OperationOutcome.issue.details.coding",
      "short": "Fehlercode aus den Wertetabellen gemäß Spezifikation",
      "binding": {
        "strength": "required",
        "valueSet": "https://gematik.de/fhir/vsdm2/ValueSet/VSDMErrorcodeVS"
      },
      "definition": "Es sind grundsätzlich die VSDM-spezifischen Fehlercodes aus dem CodeSystem VSDMErrorcodeCS zu verwenden.\nFalls keiner der Fehlercodes fachlich zutreffend ist, kann ein allgemeiner Fehlercode aus den Standard-FHIR-CodeSystemen verwendet werden."
    }, {
      "id": "OperationOutcome.issue.details.coding.system",
      "min": 1,
      "path": "OperationOutcome.issue.details.coding.system",
      "mustSupport": true
    }, {
      "id": "OperationOutcome.issue.details.coding.code",
      "min": 1,
      "path": "OperationOutcome.issue.details.coding.code",
      "mustSupport": true
    }, {
      "id": "OperationOutcome.issue.details.coding.display",
      "path": "OperationOutcome.issue.details.coding.display",
      "short": "Meldungstext laut Katalog",
      "definition": "Dieses Feld nimmt den unverarbeiteten Meldungstext gemäß CodeSystem/ValueSet auf."
    }, {
      "id": "OperationOutcome.issue.details.text",
      "min": 1,
      "path": "OperationOutcome.issue.details.text",
      "short": "Aufbereiteter Meldungstext",
      "definition": "Dieses Feld nimmt den aufbereiteten Meldungstext aus dem CodeSystem/ValueSet mit ersetzten Platzhaltern auf.",
      "mustSupport": true
    }, {
      "id": "OperationOutcome.issue.diagnostics",
      "min": 1,
      "path": "OperationOutcome.issue.diagnostics",
      "short": "Diagnostik- und Lösungsmöglichkeiten",
      "comment": "Dieses Feld darf keine technischen Interna des Fachdienstes (stack traces o.ä.) enthalten.",
      "definition": "Dieses Feld liefert Hinweise zur Fehlerbehebung durch das Clientsystem in Anlehnung an Anforderung A_27014. \nDieser Text richtet sich primär an Entwickler und technische Betreuer des Clientsystems und soll dem Anwender in der Regel nicht zur Anzeige gebracht werden.",
      "mustSupport": true
    } ]
  },
  "baseDefinition": "http://hl7.org/fhir/StructureDefinition/OperationOutcome"
}