-
25.09.2025 👨💻 Implementierungsleitfaden v1.5.17
-
25.09.2025 👨💻 FHIR VZD HOWTO Search v1.1.6
-
25.09.2025 👨💻 DirectoryAdministration.yaml v1.12.8
-
25.09.2025 👨💻 DirectoryApplicationMaintenance.yaml v1.4.8
-
19.09.2025 👨💻 Implementierungsleitfaden v1.5.16
-
27.06.2025 👨💻 Implementierungsleitfaden v1.5.15
-
16.05.2025 👨💻 Implementierungsleitfaden AVS v1.0.1
-
12.03.2025 👨💻 Implementierungsleitfaden v1.5.13
-
26.09.2024 👨💻 FHIR VZD Implementierungsleitfaden v1.2.4
-
11.09.2024 👨💻 Implementierungsleitfaden v1.5.12
-
29.07.2024 👨💻 FHIR VZD Implementierungsleitfaden v1.2.2
-
16.05.2024 👨💻 DirectoryAdministration.yaml 1.12.6
-
16.05.2024 👨💻 DirectoryApplicationMaintenance.yaml 1.4.5
-
07.05.2024 👨💻 Simplifier Profil 0.11.6
-
30.04.2024 👨💻 Simplifier Profil 0.11.5
-
26.04.2024 👨💻 Implementierungsleitfaden v1.5.10
-
22.04.2024 👨💻 Simplifier Profil 0.11.3
-
04.04.2024 👨💻 Implementierungsleitfaden v1.5.9
-
23.02.2024 👨💻 Implementierungsleitfaden v1.5.7
-
11.09.2023 👨💻 FHIR VZD Implementierungsleitfaden v1.0.2
-
25.08.2023 👨💻 FHIR VZD Implementierungsleitfaden v1.0.1
-
28.07.2023 👨💻 FHIR VZD Implementierungsleitfaden v1.0.0
-
12.05.2023 👨💻 Implementierungsleitfaden v1.5.5
-
11.04.2023 🔥 FHIR Package 0.10.2
-
18.01.2023 👨💻 Directory Administration API v1.9.5
-
18.01.2023 👨💻 Directory Application Maintenance API v1.2.4
-
14.12.2022 📄 Spezifikationen Verzeichnisdienst „VZD FHIR 1.0.0“
-
26.09.2022 👨💻 Implementierungsleitfaden v1.5.4
-
23.06.2022 📄 Implementierungsleitfaden v1.5.3. Ab dieser Version wird das Dokument über github.com veröffentlicht.
-
31.05.2022 Produktrelease v3.1.0-14
-
8.04.2022 👨💻 Directory Application Maintenance API v1.1.4
-
8.04.2022 👨💻 Directory Administration API v1.8.1
-
25.02.2022 🔥 FHIR Package 0.6.1
-
17.02.2022 🎁 Produktrelease v3.1.0-11
-
14.02.2022 📄 Implementierungsleitfaden v1.5.2
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.
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):
-
Über den TI-Konnektor wird dem KIM-Client sowie Primärsystemen eine LDAP Schnittstelle zur Abfrage der Daten bereitgestellt. Schnittstelle
I_Directory_Query, dezentral. -
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. -
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. -
Die KIM Anbieter ergänzen die Basisdaten um eigene Inhalte, insb. um die KIM-EMail-Adressen. Schnittstelle
I_Application_Maintenance. -
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.
-
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).
-
TIM Anbieter registrieren sich und verifizieren sich gegenseitig mit Hilfe von VZD Schnittstelle.
I_Directory_TIM_Provider_Services -
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).
-
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.
Die folgende Abbildung gibt einen Überblick über die Systemarchitektur des Verzeichnisdienstes.
Copyright 2025 gematik GmbH
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License.
See the [LICENSE](./LICENSE) for the specific language governing permissions and limitations under the License.
-
Copyright notice: Each published work result is accompanied by an explicit statement of the license conditions for use. These are regularly typical conditions in connection with open source or free software. Programs described/provided/linked here are free software, unless otherwise stated.
-
Permission notice: Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions::
-
The copyright notice (Item 1) and the permission notice (Item 2) shall be included in all copies or substantial portions of the Software.
-
The software is provided "as is" without warranty of any kind, either express or implied, including, but not limited to, the warranties of fitness for a particular purpose, merchantability, and/or non-infringement. The authors or copyright holders shall not be liable in any manner whatsoever for any damages or other claims arising from, out of or in connection with the software or the use or other dealings with the software, whether in an action of contract, tort, or otherwise.
-
The software is the result of research and development activities, therefore not necessarily quality assured and without the character of a liable product. For this reason, gematik does not provide any support or other user assistance (unless otherwise stated in individual cases and without justification of a legal obligation). Furthermore, there is no claim to further development and adaptation of the results to a more current state of the art.
-
Gematik may remove published results temporarily or permanently from the place of publication at any time without prior notice or justification.
-
Please note: Parts of this code may have been generated using AI-supported technology.’ Please take this into account, especially when troubleshooting, for security analyses and possible adjustments.