Skip to content

API specification for gematik Directory, a service which provides Information about organizations and practitioners in the german healthcare.

License

Notifications You must be signed in to change notification settings

gematik/api-vzd

Repository files navigation

Verzeichnisdienst der Telematikinfrastruktur

gem Spec VZD v1.14 gemILF Pflege VZD v1.5 simplifier.net 0.10
Admin API 1.9 Application Maintenance API 1.2

Aktuelles

GitHub Branches

Der Verzeichnisdienst wird auf verschiedenen GitHub Branches dokumentiert:

  • main Branch: Enthält die Dokumentation passend für die aktuelle Verzeichnisdienst Produktivumgebung (PU)

  • develop Branch: Enthält die Dokumentation passend für den aktuelle in Entwicklung befindlichen Verzeichnisdienst.

  • feature/* Branches: Diese Branches werden zur Vorbereitung und Diskussion von neuen Themen genutzt, die noch nicht in Entwickung sind. Diese Dokumente können unvollständig sein und sich bis zur Fertigstellung ändern.

Kontextabgrenzung

VZD Systemkontext
Figure 1. Verzeichnisdienst Systemkontext


Verzeichnisdienst der TI verwaltet Einträge von Leistungserbringern und Organisationen/Institutionen mit allen definierten Attributen, die in das Verzeichnis aufgenommen werden sollen. Anhand einer Suchanfrage können diese Daten abgefragt werden (z. B. Adressdaten, X.509-Zertifikate). Ferner können Einträge des Verzeichnisses durch Kartenherausgeber (Basisdaten) oder berechtigte fachanwendungsspezifische Dienste (Fachanwendungsdaten) geändert, hinzugefügt und gelöscht (Kartenherausgeber vollständige Einträge, fachanwendungsspezifische Dienste nur die jeweiligen Fachdaten) werden.

Verzeichnisdienst bietet folgende Außenschnittstellen an (s. Nummerierung in der Abbildung):

  1. Über den TI-Konnektor wird dem KIM-Client sowie Primärsystemen eine LDAP Schnittstelle zur Abfrage der Daten bereitgestellt. Schnittstelle I_Directory_Query, dezentral.

  2. Die Konnektoren leiten die Anfragen zustandslos über das zentrale Netz der TI an den Verzeichnisdienst weiter. Über die LDAP Schnittstelle des zentrale betriebenen VZD werden speziell für solche Abfragen aufbereitete und optimierte Daten durchsucht (so genannte flache Liste). Schnittstelle I_Directory_Query, zentral.

  3. Die Kartenherausgeber (bspw. Landesärztekammer oder Kassenzahnärztliche Vereinigungen) in Kooperation mit Trust Service Provider sind verantwortlich für die Befüllung des VZD mit Basisdaten und Zertifikaten. Hierfür stell VZD eine REST API für die Administration der Daten im Verzeichnisdienst. Schnittstelle I_Directory_Administration.

  4. Die KIM Anbieter ergänzen die Basisdaten um eigene Inhalte, insb. um die KIM-EMail-Adressen. Schnittstelle I_Application_Maintenance.

  5. Für die Suche der Apotheken, z.B. in der gematik eRezept APP, wird der FHIR VZD genutzt. Die AVS der Apotheken bzw. der Apotheker über das FHIR VZD Self-Service Portal ergänzen die FHIR VZD Daten um weitere Inhalte (z.B. Öffnungszeiten der Apotheken). Schnittstellen FHIRDirectoryFdvSearchAPI (/fdv/search) für die Suche und FHIRDirectoryOwnerAPI (/owner) für die Ergänzung der Daten.

  6. Für die Suche der Leistungserbringer-Institutionen im Rahmen der Berechtigungsvergabe in der elektronischen Patientenakte (ePA),vermittelt das ePA-Aktensystem die Kommunikation zwischen VZD und ePA-Frontend. Schnittstelle FHIRDirectoryFdvSearchAPI (/fdv/search).

  7. TIM Anbieter registrieren sich und verifizieren sich gegenseitig mit Hilfe von VZD Schnittstelle. I_Directory_TIM_Provider_Services

  8. VZD bietet direkten Zugriff zu den Daten über FHIR REST Schnittstellen für die Clients (z.B. TIM, FDV, eRezept App,…​). Schnittstellen FHIRDirectoryFdvSearchAPI (/fdv/search) & FHIRDirectoryFdvSearchAPI (/fdv/search).

  9. In Entwicklung: Die Leistungserbringer können ihre Daten selbstständig administrieren, um z.B. die Organisationsstrukturen und Standorte zur erfassen. Schnittstelle FHIRDirectoryOwnerAPI (/owner). Für TIM Clients und für die Ergänzung von Mehrwertdaten der Apotheken wurde diese Schnittstelle schon freigegeben.

Systemarchitektur

Die folgende Abbildung gibt einen Überblick über die Systemarchitektur des Verzeichnisdienstes.

VZD overview

LDAP-Directory Datenmodell

FHIR-Directory Datenmodell

Datenmodell

About

API specification for gematik Directory, a service which provides Information about organizations and practitioners in the german healthcare.

Topics

Resources

License

Security policy

Stars

Watchers

Forks

Packages

No packages published

Contributors 10