Skip to content

This repo holds FHIR-Profiles, sample Resources and OpenAPI specification for the VSDM 2 interface.

License

Notifications You must be signed in to change notification settings

gematik/spec-VSDM2

Repository files navigation


Spezifikation VSDM 2.0 FHIR-Profile und API

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.

Auf den folgenden Seiten stellt die gematik die Nutzung der Schnittstellen durch die Primärsysteme der Leistungserbringer vor.

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 vom Fachdienst der Krankenkasse abgerufen und ggf. im PS aktualisiert. Während bei VSDM 1.0 in den Anwendungsfällen die Komponenten Konnektor, eHealth Card Terminals, 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.

VSDM 2.0 entkoppelt den Versorgungsnachweis („Proof-of-Patient-Presence PoPP“) vom Anwendungsfall der Bereitstellung demografischer Daten. Damit kann der PoPP auch in anderen Anwendungen eingesetzt werden. 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.

Im nachfolgend verlinkten Kapitel finden Sie eine Übersicht, in welchem Kontext VSDM, PoPP und Zero Trust zueinander stehen:

Kontext VSDM/PoPP/ZeroTrust

Funktionen des VSDM:

  • Stammdatenabgleich: Über das VSDM 2.0 werden die Versichertenstammdaten, wie Name, Geburtsdatum, Anschrift, und Versicherungsschutz, bei jedem Arztbesuch online abgerufen und ggf. aktualisiert.
  • Sicherstellung der Aktualität: Es soll sichergestellt werden, dass die im Primärsystem gespeicherten Daten stets aktuell sind.
  • Datensicherheit: Die Daten werden verschlüsselt und sicher über die Telematikinfrastruktur übertragen.

Anwendungsszenarien

In diesem Kapitel finden Sie eine Beschreibung der für VSDM 2.0 relevanten Sektoren des Gesundheitswesens.

Anwendungsszenarien

Anwendungsfälle in VSDM 2.0

Im nachfolgend verlinkten Kapitel finden Sie die Übersicht der Anwendungsfälle im Kontext VSDM 2.0.

Anwendungsfälle

Abläufe im Primärsystem

Im Rahmen der Anwendungsfälle finden im Primärsystem weitere Abläufe im Zusammenhang mit der Versorgung des Versicherten statt. Hier finden Sie Informationen zu den Abläufen im Primärsystem und Interaktionen des Primärsystems mit dem Nutzer.

Abläufe

Primärsystem-Interaktionen

Informationsmodell VSD

Hier geht es zur Informationsseite zum neuen Informationsmodell für VSDM 2.0.

Anmerkung: Die Festlegung der finalen Inhalte des Informationsmodells erfolgt im Rahmen der Kommentierungsphase dieser Spezifikation. Die in diesem Dokument dargestellten Informationen stellen somit lediglich den bis zum Zeitpunkt der Vorveröffentlichung abgestimmten Stand dar.

Informationsmodell

Prüfungsnachweis

Hier finden Sie Informationen zum Prüfungsnachweis für VSDM 2.0.

Prüfungsnachweis

Fehlerbehandlung

Hier geht es zur Informationsseite zum Umgang mit Fehlermeldungen

Fehlermeldungen

FHIR Profile VSDM 2.0

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 veröffentlicht.

Mitgeltende Dokumente und Informationen

Hier finden Sie eine Übersicht zu den weiterführenden Dokumenten zur Implementierung.

Branch Modell

In diesem Repository werden Branches verwendet um den Status der Weiterentwicklung und das Review von Änderungen abzubilden. Folgende Branches werden verwendet

  • main (enthält den letzten freigegebenen Stand der Entwicklung; besteht permanent)

  • develop (enthält den Stand der fertig entwickelten Features und wird zum Review durch Industriepartner und Gesellschafter verwendet; basiert auf main; nach Freigabe erfolgt ein merge in main und ein Release wird erzeugt; besteht permanent)

  • feature/ilf (in feature branches werden neue Features entwickelt (ggf. basierend auf develop); nach Fertigstellung erfolgt ein merge in develop; der feature branch wird nach dem merge gelöscht)

Lizenzbedingungen

Copyright (c) 2022 gematik GmbH

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

API Dokumentation VSDM 2.0

Wie oben erwähnt, wird das VSDM 2.0 auf die Verwendung einer RESTful FHIR-API reduziert, die hier dokumentiert ist vsdm2.yaml.

Kontakt

Gehen Sie zu https://www.gematik.de oder OSPO@gematik.de

About

This repo holds FHIR-Profiles, sample Resources and OpenAPI specification for the VSDM 2 interface.

Topics

Resources

License

Code of conduct

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages