Merge pull request #141 from vwegert-adesso/develop

Aktualisierung develop-Branch

Author: AlexanderGrossgematik

.github/workflows/main.yml

@@ -4,11 +4,12 @@ name: CI (FHIR Validation)
 
 # Controls when the action will run. 
 on:
-  # Triggers the workflow on push or pull request events but only for the master branch
+  # Triggers the workflow on push or pull request events but only for the master branch.
+  # Added working branch to support clean-up of current validation issues - will be removed once branch is merged.
   push:
-    branches: [ master ]
+    branches: [ main, adesso-update-mapping ]
   pull_request:
-    branches: [ master ]
+    branches: [ main, adesso-update-mapping ]
 
   # Allows you to run this workflow manually from the Actions tab
   workflow_dispatch:
@@ -23,24 +24,36 @@ jobs:
 
     # Steps represent a sequence of tasks that will be executed as part of the job
     steps:
-      - name: Checkout code
-        uses: actions/checkout@v2
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
 
-      # Java and .NET are already installed on ubuntu-latest
+      # Install .NET runtime
+      - name: Setup .NET Core SDK
+        uses: actions/setup-dotnet@v4
+        with:
+          dotnet-version: 8.0.x
+      
+      # Install Java runtime (only needed if you want to run the offical HL7 Java validator)
+      - name: Setup Java JDK
+        uses: actions/setup-java@v4
+        with:
+          distribution: 'temurin'
+          java-version: '17'
 
       - name: Firely.Terminal (GitHub Actions)
-        uses: FirelyTeam/firely-terminal-pipeline@v0.4.0
+        uses: FirelyTeam/firely-terminal-pipeline@v0.7.8
         with:
-          PATH_TO_CONFORMANCE_RESOURCES: Resources/fsh-generated/resources/
-          #PATH_TO_EXAMPLES: Examples
-          PATH_TO_QUALITY_CONTROL_RULES: qc/custom
+          PATH_TO_CONFORMANCE_RESOURCES: src/fhir/fsh-generated/resources/
+          FIRELY_TERMINAL_VERSION: 3.4.0
+          PATH_TO_EXAMPLES: src/fhir/fsh-generated/resources
+          #PATH_TO_QUALITY_CONTROL_RULES: qc/custom
           DOTNET_VALIDATION_ENABLED: true
           JAVA_VALIDATION_ENABLED: true
-          OUTPUT_FORMAT: RAW
-          JAVA_VALIDATION_OPTIONS: -allow-example-urls true
-          JAVA_VALIDATOR_VERSION: 6.0.11
+          JAVA_VALIDATION_OPTIONS: -allow-example-urls true -advisor-file advisor.json -output-style compact -show-message-ids -ig kbv.all.st#1.24.0 -ig kbv.basis#1.7.0
           SIMPLIFIER_USERNAME: ${{ secrets.SIMPLIFIER_USERNAME }}
           SIMPLIFIER_PASSWORD: ${{ secrets.SIMPLIFIER_PASSWORD }}
           SUSHI_ENABLED: true
-          SUSHI_OPTIONS: Resources/
-          EXPECTED_FAILS: VALIDATION_CONFORMANCE_DOTNET VALIDATION_CONFORMANCE_JAVA VALIDATION_EXAMPLES_JAVA
+          SUSHI_OPTIONS: src/fhir
+          EXPECTED_FAILS: VALIDATION_CONFORMANCE_DOTNET VALIDATION_CONFORMANCE_JAVA

CHANGELOG-FHIR.md

@@ -0,0 +1,134 @@
+# Changelog / Änderungsverzeichnis
+
+In diesem Änderungsverzeichnis werden die Änderungen an den für die Erstellung des FHIR-Profils dokumentiert.
+
+Das Format ist angelehnt an [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
+Historische Release Notes (vor Beginn dieser Aufzeichnung) wurden zum Teil unbearbeitet oder nur geringfügig umformatiert aus Simplifier übernommen.
+
+## Nächste Version
+
+### Neu
+
+### Änderung
+
+### Abkündigung
+
+### Entfernung
+
+### Fehlerbehebung
+
+### Security
+
+## [1.0.0] - 2026-04-17
+
+Keine inhaltlichen Änderungen gegenüber Version 1.0.0-rc8.
+
+## [1.0.0-rc8] - 2026-04-10
+
+### Neu
+
+- Eine neue Fehlermeldung mit dem TDS-Code 79015 und dem Fehlercode `VSDSERVICE_INVALID_PROFILE_VERSION` zur Signalisierung einer ungültigen Versionsangabe im Request wurde eingefügt.
+  Dazu wurden die CodeSystems `VSDMTDSCodeCS` und `VSDMErrorcodeCS` sowie die zugehörigen ConceptMaps angepasst.
+  ([issue 125](https://github.com/gematik/spec-VSDM2/issues/125))
+- Für die Elemente `VSDMCoverageGKV.period.start/end` und `VSDMCoverageGKV.extension:ruhenderLeistungsanspruch.extension:dauer.value[x].start/end` wird jetzt durch eine Invariante die Verwendung unvollständiger Datumsangaben wie JJJJ oder JJJJ-MM verhindert.
+  ([issue 126](https://github.com/gematik/spec-VSDM2/issues/126))
+- Für GKV-Versicherte wird die Angabe des Werts `unknown` für des Elements `VSDMPPatient.gender` durch eine Invariante verhindert.
+  ([issue 127](https://github.com/gematik/spec-VSDM2/issues/127))
+
+### Änderung
+
+- Die Must Support-Kennzeichnung einer Reihe von Elementen wurde angepasst.
+  In diesem Zusammenhang wurden Beispieldaten für GKV-Kostenträger um nicht zu unterstützende Elemente bereinigt.
+  ([issue 128](https://github.com/gematik/spec-VSDM2/issues/128))
+- Die Platzhalter in den Fehlermeldungen wurden mit einheitlichen Trennern (Unterstrich) versehen. 
+  Dazu wurde `[media type]` durch `[media_type]` und `[http-operation]` durch `[http_operation]` ersetzt.
+  ([issue 129](https://github.com/gematik/spec-VSDM2/issues/129))
+- Aktualisierung der Paketabhängigkeiten 
+  ([issue 137](https://github.com/gematik/spec-VSDM2/issues/137))
+  - `de.gematik.terminology` von Version 1.0.8 auf Version 1.0.9 
+  - `de.gematik.ti` von Version 1.2.0 auf Version 1.3.1 
+  - `kbv.all.st` von Version 1.34.0 auf Version 1.37.0 
+  - `kbv.ita.for` von Version 1.3.0 auf Version 1.3.1
+
+### Abkündigung
+
+(keine)
+
+### Entfernung
+
+(keine)
+
+### Fehlerbehebung
+
+- In einigen Beispieldateien zu Fehlermeldungen wurden inkonsistente Texte im Element `OperationOutcome.issue.details.text` korrigiert.
+  ([issue 122](https://github.com/gematik/spec-VSDM2/issues/122))
+
+### Security
+
+(keine)
+
+## [1.0.0-rc7] - 2026-03-13
+
+- Die Kennzeichnung von Haupt- und abrechnendem Kostenträger wurde zur Verbesserung der Kompatibilität mit anderen Spezifikation (z.B. ISIK) umgestellt.
+  ([issue #112](https://github.com/gematik/spec-VSDM2/issues/112]))
+- Im VSDM 2.0 sollen generell zu allen kodierten Werten Anzeigetexte mitgeliefert werden. 
+  Die Profilierung von `VSDMCoverageGKV/PKV.type` wurde von `fixedValue` auf `pattern` umgestellt, um das zu ermöglichen.
+  ([issue #116](https://github.com/gematik/spec-VSDM2/issues/116))
+- In der ConceptMap `VSDMDEUEVAnlage8ISO3166` wurde eine fehlende Zuordnung des Ländercodes AU (Ashmore- und Cartierinseln) ergänzt.
+  ([issue #102](https://github.com/gematik/spec-VSDM2/issues/102))
+- In den Beispielen für `VSDMOperationOutcome` wurden die Profilangaben um eine Versionsangabe ergänzt.
+  ([issue #104](https://github.com/gematik/spec-VSDM2/issues/104))
+- Das Beispiel für `VSDMOperationOutcome-InvalidHeader` wurde auf die aktuelle Spezifikationslage angepasst.
+  ([issue #106](https://github.com/gematik/spec-VSDM2/issues/106))
+- Das abgekündigte Element `OperationOutcome.issue.location` in den Beispielen (zur Kodierung von Feldangaben) wurde durch das Nachfolge-Element `OperationOutcome.issue.expression` ersetzt .
+  ([issue #108](https://github.com/gematik/spec-VSDM2/issues/108))
+
+_(Release Notes aus der Simplifier-Veröffentlichung übernommen)_
+
+## [1.0.0-rc6] - 2026-01-30
+
+Release Candidate 6 (rc6) beinhaltet inhaltliche Ergänzungen und Korrekturen der FHIR-Artefakte für VSDM 2. 
+Der Fokus liegt auf Vervollständigung der Terminologien, Harmonisierung der Canonicals sowie redaktionellen und technischen Anpassungen der Profile.
+Hinzufügen bzw. Aktualisierung mehrerer ConceptMaps und CodeSystem-Mappings für VSDM-TDS (z. B. ErrorCode und IssueSeverity). 
+Erweiterung der ValueSets und Mapping-Artefakte für TDS-Fehlermeldungen und Statuscodes.
+
+_(Release Notes aus der Simplifier-Veröffentlichung übernommen)_
+
+## [1.0.0-rc5] - 2025-09-17
+
+Integration PKV
+
+_(Release Notes aus der Simplifier-Veröffentlichung übernommen)_
+
+## [1.0.0-rc4] - 2025-01-23
+
+Initiales Release VSDM 2.0
+
+_(Release Notes aus der Simplifier-Veröffentlichung übernommen)_
+
+## [1.0.0-rc3] - 2024-11-14
+
+Update ErrorCodes
+
+_(Release Notes aus der Simplifier-Veröffentlichung übernommen)_
+
+## [1.0.0-rc2] - 2024-11-14
+
+Anpassung der ErrorCodes OperationOutcome
+
+_(Release Notes aus der Simplifier-Veröffentlichung übernommen)_
+
+## [1.0.0-rc1] - 2024-10-25
+
+Vorabveröffentlichung VSDM 2.0
+
+_(Release Notes aus der Simplifier-Veröffentlichung übernommen)_
+
+[1.0.0-rc1]: https://simplifier.net/packages/de.gematik.vsdm2/1.0.0-rc1
+[1.0.0-rc2]: https://simplifier.net/packages/de.gematik.vsdm2/1.0.0-rc2
+[1.0.0-rc3]: https://simplifier.net/packages/de.gematik.vsdm2/1.0.0-rc3
+[1.0.0-rc4]: https://simplifier.net/packages/de.gematik.vsdm2/1.0.0-rc4
+[1.0.0-rc5]: https://simplifier.net/packages/de.gematik.vsdm2/1.0.0-rc5
+[1.0.0-rc6]: https://simplifier.net/packages/de.gematik.vsdm2/1.0.0-rc6
+[1.0.0-rc7]: https://simplifier.net/packages/de.gematik.vsdm2/1.0.0-rc7
+[1.0.0-rc8]: https://simplifier.net/packages/de.gematik.vsdm2/1.0.0-rc8

README.md

@@ -3,10 +3,14 @@
 # Spezifikation VSDM 2.0 FHIR-Profile und API
 
 ## Disclaimer
-Dieses Dokument beschreibt die für die Implementierung des Versicherungsstammdatenmanagements (VSDM) 2.0 erforderlichen Vorgaben. Weitere Vorgaben zur Implementierung der Anteile von PoPP und Zero Trust sind zum Stand der Veröffentlichung von VSDM 2.0 nicht Bestandteil dieses Dokuments. Die Aufnahme der Implementierungsvorgaben aus PoPP und Zero Trust in den ILF für VSDM 2.0 erfolgt iterativ sobald die notwendigen Informationen aus diesen Implementierungsleitfäden vorliegen.
+Dieses Dokument beschreibt die für die Implementierung des Versicherungsstammdatenmanagements (VSDM) 2.0 erforderlichen Vorgaben. Weitere Vorgaben zur Implementierung der Anteile von PoPP und Zero Trust sind nicht Bestandteil dieses Dokuments. Die Implementierungsvorgaben für PoPP und Zero Trust erfolgt in den jeweiligen Implementierungsleitfäden der Produkttypen.
 
 Die in der Spezifikation VSDM 2.0 [gemSpec_VSDM_2] enthaltenen und in den Steckbrief [gemSST_CS_VSDM_2] ausgeleiteten Anforderungen an Clientsysteme haben informativen Charakter und treffen Festlegungen über diesen Implementierungsleitfaden hinaus. Die Anforderungen dienen zur Unterstützung der Implementierung durch Primärsystemhersteller.
 
+Neben diesem Implementierungsleitfaden stellt die gematik zusätzlich eine OpenAPI-Beschreibung in GitHub zur Verfügung. Diese umfasst zusätzliche Informationen und Hinweise an die PS-Hersteller aus Entwicklersicht.
+
+Dieser Implementierungsleitfaden betrachtet Vorgaben für GKV und PKV.
+
 ## Einleitung
 Die gematik geht neue Wege und möchte auf diesem Weg die Nutzung der Schnittstellen rund um das VSDM 2.0 vorstellen. Die Beschreibung dieser API ergänzt die normativen Dokumente der gematik sowie die Festlegungen über die VSDM-Profile (inkl. Beispielen) des genutzten FHIR-Standards.
 
@@ -15,10 +19,18 @@ Auf den folgenden Seiten stellt die gematik die Nutzung der Schnittstellen durch
 ## Was ist VSDM 2.0
 
 VSDM steht für „Versichertenstammdatenmanagement“. Es ist ein Teil der Telematikinfrastruktur (TI) im deutschen Gesundheitswesen und dient der Verwaltung und dem Abgleich der Stammdaten von gesetzlich versicherten Personen.
-VSDM 2.0 ist die Weiterentwicklung des bestehenden VSDM 1.0. Die Versichertenstammdaten (VSD) werden mit VSDM 2.0 nicht mehr auf der eGK des Versicherten gespeichert und aktualisiert sondern direkt vom Primärsystem (PS) des Leistungserbringers (LE) vom Fachdienst der Krankenkasse abgerufen und ggf. im PS aktualisiert.
+Mit dem Versichertenstammdatenmanagement (VSDM) 2.0 wird die bisherige Verarbeitung von Versichertenstammdaten innerhalb der Telematikinfrastruktur (TI) grundlegend modernisiert. Ziel ist es, die Aktualisierung, Prüfung und Bereitstellung von Stammdaten effizienter, sicherer und flexibler zu gestalten – sowohl für die gesetzliche Krankenversicherung (GKV) als auch für die private Krankenversicherung (PKV).
+
+VSDM 2.0 ist die Weiterentwicklung des bestehenden VSDM 1.0. Während im bisherigen VSDM (Version 1) die Prüfung der Versichertenstammdaten ausschließlich über die elektronische Gesundheitskarte (eGK) erfolgte, erweitert VSDM 2.0 das Verfahren um neue technische Möglichkeiten und standardisierte Schnittstellen. Dadurch wird eine bessere Integration in bestehende Primärsysteme, eine verbesserte Nutzererfahrung sowie eine höhere Prozesssicherheit im Praxis- und Klinikalltag erreicht.
+
+Die Versichertenstammdaten (VSD) werden mit VSDM 2.0 nicht mehr auf der eGK des Versicherten gespeichert und aktualisiert sondern direkt vom Primärsystem (PS) des Leistungserbringers (LE) vom Fachdienst der Krankenkasse bzw. der privaten Krankenversicherung abgerufen und ggf. im PS aktualisiert. Durch die Entkopplung von VSD und eGK können alle Krankenversicherungen (gesetzliche wie private) gemeinschaftlich betrachtet werden.
 Während bei VSDM 1.0 in den Anwendungsfällen die Komponenten Konnektor, eHealth Kartenterminals, eGK, SMC-B, Intermediär und schließlich die VSDM-Backend-Dienste des Versicherers zum Einsatz kommen, reduziert VSDM 2.0 die Abhängigkeiten von diesen Komponenten. 
 Mit der Initiative TI 2.0 wird die gesamte Infrastruktur modernisiert und auf den neuesten Stand der Sicherheits- und Architekturprinzipien gebracht.
 
+Dieser Implementierungsleitfaden richtet sich an Primärsystemhersteller und beschreibt die technischen, organisatorischen und fachlichen Anforderungen für die Integration der VSDM 2.0-Schnittstellen in Praxisverwaltungssysteme, Krankenhausinformationssysteme und weitere primäre Anwendungssysteme. Dabei werden die unterschiedlichen Rahmenbedingungen und Datenflüsse von GKV und PKV berücksichtigt, um eine einheitliche, standardkonforme Umsetzung sicherzustellen. Neben der Beschreibung der Schnittstellen werden praxisnahe Hinweise zur Implementierung gegeben.
+
+Die Harmonisierung der Verfahren zwischen GKV und PKV ist ein zentrales Ziel von VSDM 2.0. Sie schafft die Grundlage für eine einheitliche Kommunikation und vereinfacht die Integration in unterschiedliche Systemlandschaften. Damit leistet VSDM 2.0 einen wichtigen Beitrag zur digitalen Vernetzung im Gesundheitswesen und bildet eine Voraussetzung für zukünftige Anwendungen der elektronischen Gesundheitskarte und der TI 2.0.
+
 In der TI 2.0 wird der Nachweis des Versorgungskontextes mittels PoPP („Proof-of-Patient-Presence“) von fachlichen Anwendungsfällen entkoppelt. Bei VSDM 2.0  ist dies die Bereitstellung demografischer Daten. Die Versicherer stellen also eine einfache FHIR-REST-API bereit, mit der die Client-Software der Arztpraxis „nur“ zusätzliche Daten anfordert, indem sie ein legitimes PoPP-Token bereitstellt.
 
 ## Mit VSDM 2.0 werden auch die privaten Krankenversicherer (PKV) die Vorteile der Bereitstellung der Versichertenstammdaten für die Versicherten und die Leistungserbringer nutzen, z.B. Wegfall manueller Datenübernahmen in das Primärsystem und sofortige Übersicht aller vertraglichen Leistungen. Hier finden Sie die relevanten User Stories für die Leistungserbringer in Verbindiung mit privat versicherten Patienten: [Link einfügen]
@@ -50,7 +62,6 @@ Im Rahmen der Anwendungsfälle finden im Primärsystem weitere Abläufe im Zusam
 
 [Primärsystem-Interaktionen](docs/vsdm_psinteraktionen.md)
 
-
 ## Informationsmodell VSD
 Hier geht es zur Informationsseite zum neuen Informationsmodell für VSDM 2.0.
 
@@ -80,13 +91,21 @@ Hier geht es zur Informationsseite zu Statuscodes
 
 In VSDM 1.0 wurde ein proprietäres XML-Datenformat in einer SOAP-Servicekette verwendet. Mit VSDM 2.0 wird der VSD Datensatz in den FHIR-Standard migriert, der im deutschen Gesundheitswesen immer mehr zum Einsatz kommt. Die FHIR-Profile und Beispielressourcen werden im offiziellen [VSDM 2 simplifier project](https://simplifier.net/vsdm2) veröffentlicht.
 
-## Mitgeltende Dokumente und Informationen
+## Mitgeltende Dokumente
 Hier finden Sie eine Übersicht zu den weiterführenden Dokumenten zur Implementierung.
 
 - [Spezifikation VSDM 2.0](https://gemspec.gematik.de/prereleases/Draft_ZeroTrust_VSDM2_24_1/gemSpec_VSDM_2_V1.0.0_CC/)
 - [FHIR-Profile VSDM 2.0](https://simplifier.net/vsdm2)
 - [Steckbrief Clientsystem-Schnittstelle zum VSDM 2.0](https://gemspec.gematik.de/docs/gemSST/gemSST_CS_VSDM_2)
 
+## Weiterführende Informationen
+
+| Quelle | Herausgeber: Titel |
+| :------------- | :------------ |
+| gemSpec_PoPP_Service | gematik: Spezifikation Proof of Patient Presence-Service  |
+| gemSpec_ZETA | gematik: Spezifikation Zero Trust Access (ZETA) |
+| gemGlossar | gematik: Glossar der Telematikinfrastruktur | 
+
 
 ## Branch Modell
 In diesem Repository werden Branches verwendet um den Status der Weiterentwicklung und das Review von Änderungen abzubilden.
@@ -115,6 +134,10 @@ Wie oben erwähnt, wird das VSDM 2.0 auf die Verwendung einer RESTful FHIR-API r
 
 [vsdm2.yaml](./src/openapi/vsdm2.yaml).
 
+Zusätzliche Informationen zu Design-Entscheidungen und Abweichungen vom FHIR-Standard finden Sie hier:
+
+[API Design & FHIR-Konformität](docs/vsdm_api_design.md)
+
 
 
 # Kontakt

ReleaseNotes.md

@@ -0,0 +1,37 @@
+
+# Release Notes – Implementierungsleitfaden VSDM 2.0
+
+**Produkt:** Implementierungsleitfaden VSDM 2.0  
+**Repository:** https://github.com/gematik/spec-VSDM2  
+**Version:** {{VERSION}}  
+**Stand:** {{BRANCH / TAG}}  
+**Veröffentlichungsdatum:** {{YYYY-MM-DD}}  
+
+---
+
+## Überblick
+
+Mit dieser Version wird der **Implementierungsleitfaden für VSDM 2.0** veröffentlicht.  
+Der Leitfaden unterstützt Hersteller von Primärsystemen bei der technischen Umsetzung des
+Versichertenstammdatenmanagements (VSDM) gemäß der VSDM-2.0-Spezifikation der gematik
+auf Basis einer REST- und FHIR-orientierten Architektur.
+
+Der Implementierungsleitfaden ergänzt die normativen Spezifikationen und dient als praxisnahe
+Hilfestellung für Entwicklung, Integration und Test.
+
+## Mitgeltende Artefakte
+
+Der Implementierungsleitfaden bezieht sich u. a. auf folgende Artefakte:
+
+- OpenAPI-Spezifikation der VSDM-2.0-Schnittstelle (`vsdm2.yaml`)
+- FHIR-Profile und Beispiele (gematik-Simplifier-Projekt)
+- Weitere relevante gematik-Spezifikationen und Produkttypsteckbriefe
+
+- ## Änderungen gegenüber vorherigen Versionen
+
+- Initiale Veröffentlichung des Implementierungsleitfadens VSDM 2.0
+
+- ## Ausblick
+
+- Erweiterungen und Präzisierungen des Leitfadens erfolgen in zukünftigen Versionen
+  auf Basis von Rückmeldungen aus Implementierung und Test.