VSDM 2.0 – Einleitende Übersichtsseite

Diese Seite bietet einen kompakten Überblick zu VSDM 2.0 (Versichertenstammdatenmanagement, Generation 2.0) im Kontext von TI 2.0. Sie ordnet das System fachlich und technisch ein, beschreibt die wichtigsten Artefakte und verlinkt auf Referenzen, Spezifikationen und Schnittstellenbeschreibungen.

Überblick und Einordnung

VSDM 2.0 ist ein zentraler Dienst innerhalb der TI 2.0, der die Verwaltung, Prüfung und Aktualisierung von Versichertenstammdaten für elektronische Gesundheitsdienste standardisiert. Ziel ist eine moderne, interoperable und cloudfähige Architektur mit klaren API-Schnittstellen, robusten Sicherheitsmechanismen und guter Integrationsfähigkeit in Primärsysteme.

Artefakte und Referenzen

Nachfolgend sind die wichtigsten Artefakte für Implementierung, Verständnis und Konformität von VSDM 2.0 zusammengestellt.

Spezifikation (verbindlich)

gemSpec VSDM 2 (Version 1.0.0 CC): gemSpec_VSDM_2
FHIR Spezifikation auf Simplifier: Simplifier – VSDM2 Introduction

Referenzinhalte und Ressourcen

GitHub-Repository: gematik/spec-VSDM2
Enthält begleitende Materialien zur Spezifikation (z. B. Modelle, Beispiele, ergänzende Dokumente).

API-Portal: OpenAPI-basierte Schnittstellenbeschreibung

Die Interfacebeschreibung wird im API-Portal auf Basis von OpenAPI bereitgestellt (dieses Dokument dient als Einstiegsseite).
Typische Inhalte:
- Endpunkte, HTTP-Methoden, Request/Response-Schemata
- Fehlercodes und Beispielaufrufe
Da die VSDM2.0 Schnittstelle über den ZETA Proxy angesprochen wird und der ZETA Proxy leichte veränderungen an der Anfrage vornimmt (Hinzufügen von Headern, Entfernen von Autorisierungsinformationen), sind zwei OpenAPI-Dokumente definiert:
- VSDM2-client-api.yaml: Für Clients, die Anfragen an den ZETA Proxy stellen.
- VSDM2-resource-server-api.yaml: Für den Resource Server, der die Anfragen vom ZETA Proxy erhält.

               VSDM2-client-api        VSDM2-resource-server-api\n                      │                         │\n┌──────────────────┐  │   ┌─────────────────┐   │  ┌───────────────┐\n│   Primärsystem   │  │   │                 │   │  │               │\n│  ┌────────────┐  │  │   │   ZETA-Guard    │   │  │ VSDM Resource │\n│  │VSDM 2.0    │  │──┴──▶│  (HTTP-Proxy)   │───┴─▶│     Server    │\n│  │Client      │  │      │                 │      │               │\n│  └────────────┘  │      └─────────────────┘      └───────────────┘\n└──────────────────┘

WICHTIG Information:

Die im API-Portal abgebildeten OpenAPI-Beschreibungen weichen von der veröffentlichen Version auf github ab und enthält deutlich detailliertere Informationen über die Endpunkte und der Komponenten. Die OpenAPI Dokumente sind Teil des PoC für das Developer Portal und können Abweichungen oder Fehler enthalten. Maßgebend sind die Dokumente der Spezifikation (gemSpec_VSDM_2).

TestHub (TI 2.0)

Als Hilfsmittel zur Umsetzung dient eine Referenzimplementierung für TI 2.0-Komponenten (ti2.0-testHub), die die VSDM 2.0-Schnittstellen exemplarisch abbildet. Diese Referenz ist zur Orientierung gedacht und unterstützt:

Verständnis von Sequenzen und Integrationspunkten
Testen gegen die OpenAPI-Schnittstellen
Ableitung eigener Implementierungen in Primärsystemen

Hinweise:

Die Referenzimplementierung richtet sich nach den gemSpec-Vorgaben und ist nicht produktiv zu verwenden.
Konfigurations- und Betriebsaspekte (z. B. Zertifikatsmanagement) müssen gemäß gemSpec VSDM 2 angepasst werden.

Start mit der Implementierung

Spezifikation studieren
1. Beginnen Sie mit der gemSpec VSDM 2, um Anforderungen und Konformität zu verstehen:
  gemSpecVSDM2V1.0.0CC.pdf
Domänenkontext erfassen
1. Überblick und fachliche Beschreibung der FHIR-Schnittstellen:
  Simplifier – VSDM2 Introduction
Artefakte sichten
1. Begleitmaterialien und Modelle:
  GitHub – spec-VSDM2
API nutzen
1. Greifen Sie auf die OpenAPI-Beschreibung im API-Portal zu (Endpunkte, Schemata, Beispiele).
2. Validieren Sie Requests/Responses anhand der Spezifikation und Beispielpayloads.
3. Verwenden Sie gängige Code-Generatoren und die OpenAPI-Dokumente zum Erstellen des Client-Codes
4. Nutzen Sie die Mocking-Server Möglichkeiten um ihre eigene Implementierung mit den Contract-Testing zu überprüfen
Referenzimplementierung evaluieren

Verwenden Sie das ti2.0-testHub zur Orientierung bei Zeta-SDK Nutzung und Fehlerbehandlung.

","contentUpdatedAt","Fri, 16 Jan 2026 16:46:38 GMT","generatorLanguages","SHUBApiDetails","exploreUrl","currentToc",{"_70":200,"_201":202,"_194":203,"_204":205,"_152":465},[],"shubUrl","apiRenderer","TOGGLE","routingSettings",{"_471":472,"_473":19},"routing","browser","credentialsEnabled","isTemplatePreview","metaInfo",{"_477":478,"_173":174,"_194":479},"canonicalUrl","https://portal.developer.gematik.solutions/vsdm20/docs/vsdm-2-0","Übersicht | VSDM 2.0 | gematik","actionData","errors"]