Willkommen auf der FAQ-Seite zum Verzeichnisdienst der Gematik. Hier finden Sie Antworten auf die häufigsten Fragen rund um den Verzeichnisdienst.
Unser Ziel ist es, Ihnen umfassende Informationen zu bieten und Ihnen bei der Nutzung unseres Dienstes bestmöglich zu unterstützen.
Diese Seite soll Ihnen helfen, die Funktionen und Anforderungen besser zu verstehen und mögliche Unklarheiten schnell zu klären.
Inhalt
VZD LDAP
| Schnittstelle (Zielgruppe) | Frage | Letztes Update | Status | Antwort |
|---|---|---|---|---|
| KIM | Wie sind die Mail-Adressen im KomLeData / KimData-Attribut sortiert. | Info | Die Mail-Adressen werden VZD-LDAP-seitig nicht sortiert. Der OpenDJ-Server speichert die Einträge in der Reihenfolge des internen Erstellungsdatums. Bei einer Wiederherstellung des OpenDJ-Inhalts geht diese Sortierung aufgrund der Neu-Anlage der Einträge verloren. Eine explizite Sortierung der Einträge nach Erstellungsdatum oder Adresse ist per Anforderung nicht vorgesehen. | |
| Kartenherausgeber / Identity Provider | Kontext: Plausibilisierungsregeln Welche Fehlermeldungen werden generiert, |
| Info | Die Fehlermeldungen sind für die einzelnen Plausibilisierungsregeln nicht detailliert spezifiziert. In der Regel weisen 4XX-Fehlermeldungen den Client auf ein fehlerhaftes Verhalten hin, wobei überwiegend die Fehlermeldung "400 Bad Request" verwendet wird. Wo möglich, werden zusätzlich aussagekräftige Fehlermeldungen bereitgestellt, um die Problemursache klarer zu kommunizieren. In Einzelfällen können jedoch bestimmte Konstellationen zu abweichenden Fehlercodes oder wenig aussagekräftigen Fehlermeldungen führen. Sollten Sie auf einen solchen Fall stoßen, bitten wir Sie, uns entsprechend zu informieren. |
| Kartenherausgeber I_Directory_Administration | Warum schlägt mein POST/PUT-Request auf |
| Info | Ein häufiger Fehler beim Aufruf der Schnittstelle Beispiel eines fehlerhaften Aufrufs Diese Struktur ist nicht korrekt, da der äußere Wrapper Hintergrund Zusätzlich wichtig Lösung |
| Kartenherausgeber I_Directory_Administration | Gibt es zeitliche Vorgaben der gematik für Massenoperationen und was bedeutet "Too many requests" beim POST auf I_Directory_Administration? |
| Info | Gibt es festgelegte Zeiträume für Massenoperationen durch die gematik?
Warum erscheint die Fehlermeldung „Too many requests“ beim POST auf I_Directory_Administration?
|
| Kartenherausgeber I_Directory_Administration | Wann wird ein ungültiges Zertifikat aus einem Verzeichniseintrag entfernt? |
| Info |
|
| Kartenherausgeber I_Directory_Administration | Sicherung von (Test-)Einträgen vor unerwünschten Änderungen |
| Info |
|
VZD FHIR
| Schnittstelle (Zielgruppe) | Frage | Letztes Update | Status | Antwort | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Suche (Search, fdv-Search, Owner-Search) | Welche Suche wird empfohlen? |
| Info | Aus Effizienzgründen wird empfehlen die FHIR-Suchen so kurz wie möglich zu gestalten, da jede Suche zu einer entsprechenden Abfrage an der Datenbank führt. So können die Suchen wie SQL-Datenabfragen auf ihre Geschwindigkeit optimiert werden. Folgende Maßnahmen werden empfohlen
Beispiel-Abfrage | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Suche (Search, fdv-Search, Owner-Search) | Serverseitige Optimierung der Volltext-Suche |
| Zur Verbesserung der Suchergebnisse und zur Reduzierung unnötiger Systemlast wurden / werden folgende Anpassungen implementiert
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Suche (Search, fdv-Search, Owner-Search) | Wird ein Paging vom VZD FHIR unterstützt? |
| Info | Aufgrund von technischen Restriktionen musste das HAPI-FHIR-Server eigene Paging deaktiviert werden. Bisher liegen Lösungsansätze für ein Paging vor, davon wurde bisher aber noch nichts implementiert. Ein Paging kann je nach Priorisierung zukünftig eingeplant und umgesetzt werden. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Suche (fdv-search) | Wenn die Volltextsuche Sonderzeichen enthält (bestehend aus Dash, Dot oder Slash) verhält sich die Suche unterschiedlich, je nachdem ob weitere Attribute gesetzt sind oder nicht |
| Info | Bitte die besondere Bedeutung von Sonderzeichen in Suchstrings beachten: https://github.com/gematik/api-vzd/blob/main/docs/FHIR_VZD_HOWTO_Search.adoc#characters-with-special-meaning-in-the-full-text-search Um dieses Problem zu Umgehen, werden folgende Sonderzeichen serverseitig aus der Volltextsuche entfernt, falls keine Exakte-Suche (Nutzung doppelte Anführungszeichen) ausgeführt wird. "-" / ";" / "." “.” wird nur entfernt wenn danach ein Leerzeichen folgt (z.B. “Dr. Max Mustermann”) Vielleicht helfen auch die Suchbeispiele auf der GitHub Seite (Full-text search examples). | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Suche (fdv-search) | Volltextsuche zur Performanceoptimierung |
| Info | Die Suchperformance ist stark abhängig von der Anzahl der verwendeten Suchparameter. (Technischer Hintergrund: Jeder zusätzlich Suchparameter auf Sub-Ressourcen (Organization, Practitioner, Location, Endpoint) führt zu ein oder mehreren Datenbank-JOIN-Statements. So können Anfragezeiten von >600 msec. generiert werden. Lösung: Folgende Informationen aus den Ressourcen sind im Volltext enthalten: Inhalt der _text-Feld für Organisationen Folgenden Werte werden in das _text-Feld der HealthcareService der Organisationen gespeichert:
Inhalt des _text-Feld für Personen Folgenden Werte werden in das _text-Feld der PractitionerRole der Person gespeichert:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Suche (Volltext) | Welche Synonyme werden unterstützt? |
| Info | Stand April 2026 werden folgende Synonyme bei einer Volltext-Suche ("_text") unterstützt: Str, Strasse, Str., Straße FA, Facharzt, Arzt Zahnarzt, Fachzahnarzt, FZÄ, FZA, Zahnarztpraxis Versorgungszentrum, MVZ, Ärztehaus, Poliklinik, Gesundheitszentrum, Fachambulanz Ambulanz, Notfallzentrum, Notaufnahme, Notfallambulanz, Rettungsstelle, Ambulanzzentrum, Fachambulanz, Notfallpraxis Kassenzahnärztlichen Vereinigungen, zahnärztliche Vereinigung, KZV Kassenärztliche Vereinigung, ärztliche Vereinigung, KV TK, Techniker Krankenkasse BKK, Betriebskrankenkasse LUK, Landesunfallkasse BIG, Bundesinnungskrankenkasse IKK, Innungskrankenkasse SVLFG, Sozialversicherung für Landwirtschaft, Forsten und Gartenbau MKK, meine Krankenkasse kkh, Kaufmännische Krankenkasse Häusliche Krankenpflege, HKP, Pflege, Pflegedienst, Krankenpflege, Pflegeeinrichtung, Pflegeteam, Pflegebüro, Tagespflege Klinik, Krankenhaus, Uni, Uniklinik, Universitätsklinik, Universität, klinikum, Akutklinik, Fachklinik, Hospital, Privatklinik, Poliklinik, Tagesklinik, Allgemeinkrankenhaus, Universitätskrankenhaus, Spezialklinik, Fachkrankenhaus, Krhs, Klinikbetrieb, Privatkrankenhaus Praxis, Gemeinschaftspraxis, Dres, BAG, üBAG, Berufsausübungsgemeinschaft, Praxisgemeinschaft, Gruppenpraxis, Spezialpraxis, Bereitschaftsdienstpraxis, Bereitschaftspraxis, Arztpraxis, Hausarztzentrum, Allgemeinarztpraxis, Allgemeinmedizin, Ärztezentrum Radiologie, Radiologe, Strahlenheilkunde, Röntgenmedizin kfo, Kieferorthopädie Psychiatrische Klinik, Psychiatrie, Nervenklinik, psych, psychologie, psychologe | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Authentisierung | Fehlermeldung “Access Token unknown or expired ErrorCode=[....]” Nach der Authentisierung am OAuth-Server wird erfolgreich ein service-authz-token erzeugt und beim damit ein earch-access_token angefragt. |
| Info | In der Vergangenheit konnte bei einem Kunden das Problem gelöst werden, indem der gesamte AccessToken mit Anführungszeichen übergeben wurde. In einigen Fällen wir der Token-String von den Clients unvollständig übergeben. Testen Sie gerne auch Doppelte-Anführungszeichen statt einfache. In der Windows-Konsole kommt es hier scheinbar regelmäßig zu unterschiedlichen Verhalten. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
| VZD FHIR Referenzumgebung (RU) vs. gematik Testumgebung (TU) | Welche URLs sind zu nutzen, wenn ich in der Testumgebung arbeiten möchte? |
| info | Das VZD FHIR Staging sieht folgende Umgebungen vor:
In der FHIR VZD Spezifikation sind TU, RU und PU genannt. Aktuell sind in der TU lediglich gematik exklusive Gesamtintegrationstests vorgesehen. Zulassungstests erfolgen in der Referenzumgebung (RU) RU am Beispiel von Service-Authenticate / FDV-Search Auth-Server (Keycloak): Service-Authenticate: FDV-Search (VZD FHIR): TU am Beispiel von Service-Authenticate / FDV-Search Service-Authenticate (Keycloak): Service-Authenticate (VZD FHIR): FDV-Search (VZD FHIR): | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Testdaten | Stellt die gematik Testdatensätze in der RU und TU bereit? | Info | Ja, die gematik hat in beiden Umgebungen Testdaten eingepflegt
Die Organisationen und Practitioner sind jeweils in unterschiedlichen Ausprägungen (Spezialisierungen, ProfessionOID) vorhanden. Die Adressen sind willkürliche, reale Adressen aus Deutschland. Für einzelne Apotheken zusätzlich mit den dazugehörigen Geo-Koordinaten.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Testdaten Apotheken mit Service und Öffnungszeiten |
| Für Apotheken wurden Testdatensätze mit unterschiedlichen Zusammenstellungen von angebotenen Service und Öffnungszeiten hinzugefügt. Die Adressen sind willkürliche, reale Adressen aus Deutschland. Für einzelne Apotheken zusätzlich mit den dazugehörigen Geo-Koordinaten. Eine Liste dieser Daten können sie hier einsehen: VZD-TestApotheken.xlsx
|
Beachten Sie, dass VZD Einträge in der RU jederzeit geändert werden können.