Inhalt

Wartung

InhaltStatusChange-Termin RUChange-Termin TUChange-Termin PUScope / Beschreibung

VZD FHIR - Sizing-Anpassungen an Datenbanken

ERLEDIGT

17.02.2026 
17:00 - 21:00

17.02.2026 
17:00 - 21:00

19.02.2026
22:00 - 02:00 
Harmonisierung der Datenbankparameter zur Sicherstellung einer gleichmäßigen Auslastung der Datenbankserver.

Veröffentlichungen - VZD LDAP

VersionStatusChange-Termin RUChange-Termin TUChange-Termin PURelease Notes (+Kommentar)

VZD LDAP 3.3.0-10

gemProdT_VZD_PTV_1.6.6-0_V1.0.0


IN DEFINITION

Mitte Juni 2026

Mitte Juni 2026Mitte Juli 2026
I_Directory_Administration (REST)
  • Seltene Doppelanlieferungen konnten dazu führen, dass Datensätze mit gleicher TelematikID mehrfach im VZD gespeichert wurden. Durch die Umstellung der AddDirectoryEntry-Methode auf eine synchrone Verarbeitung wird dieses Verhalten nun verhindert. 

I_Directory_Application_Maintenance (REST)
  • Entfernung des HTTP-Statuscodes 423 (Locked) für inaktive Basiseinträge.

I_Directory_Query (ldap)
  • Keine Änderungen

Diverse interne betriebliche Optimierungen (ohne Schnittstellenänderung). Unter anderem:

  • Zur Verbesserung der Nachvollziehbarkeit wird das LastChangeDate künftig auch bei Änderungen durch den CleanUp-Job (z. B. Entfernung oder Deaktivierung von Zertifikaten) aktualisiert.
  • Weitere Optimierungen zur Verbesserung von Laufzeit und Robustheit von technischen Komponenten u.a. der CleanUp-Jobs. 

Schnittstellenversionen

VZD LDAP 3.3.0-9

gemProdT_VZD_PTV_1.6.6-0_V1.0.0


ERLEDIGT

29.01.26 17:00 - 20:00

03.02.26 17:00 - 20:0017.02.26 22:00 - 01:00
I_Directory_Administration (REST)
  • Optimierung ChangeDateTime: Aktualisierung nur noch bei inhaltlichen Änderungen, nicht mehr bei jedem Aufruf.
I_Directory_Query (ldap)
  • Indizierung des nicht verwendeten Felds “description” zur Optimierung von standardmäßigen Mozilla Thunderbird-Suchanfragen.

Interne betriebliche Optimierungen (ohne Schnittstellenänderung)

  • Verbesserung der Laufzeit bei regelmäßigen Basiseintrags-Löschungen (>365 Tage ohne Zertifikat).
  • Verbesserung der Laufzeit bei Zertifikatsvalidierung.
  • Verbesserung der Laufzeit von FAD-Synchronisation in die LDAP-Views.

  • Die fachlichen Log-Einträge wurden so erweitert, dass auch bei Operationen "mark_Directory_Entry_Certless" und "unmark_Directory_Entry_Certless" die TelematikID gepflegt wird. (Die Anreicherung erfolgt anhand der UUID des LDAP-Eintrags und stellt sicher, dass die TelematikID als zentrales Suchattribut an der readLog-Schnittstelle konsistent verfügbar ist.)

Schnittstellenversionen


Veröffentlichungen - VZD FHIR

VersionStatusChange-Termin RUChange-Termin TUChange-Termin PURelease Notes (+ Kommentar)

VZD FHIR 1.2.0-17

gemProdT_VZD_FHIR_PTV_1.1.3-0_V1.0.0

IN DEFINITION

Anfang Juli 2026

Mitte Juli 2026Ende Juli 2026

search / fdv-search (REST)

  • Die nearPharmacy- und nearSearch-Suchoperationen wurden um einen optionalen Specialty-Parameter erweitert.

owner(REST)

  • Die KIM-Fachdaten werden nun unidirektional vom LDAP-VZD in den FHIR-VZD synchronisiert, inklusive Anlage von Endpunkten (Endpoints) je Mail-Adresse und Indexierung für die Suche inkl. Volltextsuche. Die Bearbeitung von KIM-Endpunkten über die owner-Schnittstellen wurde vollständig unterbunden (keine Anlage, Änderung, Löschung oder Verknüpfung), um die Konsistenz der aus dem LDAP synchronisierten Daten sicherzustellen.

VZD SSP

  • Die Ergebnisliste wurde um weitere relevante Kategorien ergänzt.
  • Die Anzeige von KIM-Adressen in der Detailansicht eines VZD-Eintrags wurde analog zu TIM-Endpunkten umgesetzt. Die Darstellung erfolgt ausschließlich read-only.
  • Auf der Startseite wurde ein Banner integriert, dessen Inhalte dynamisch aktualisiert werden können. Dieser dient zukünftig inb. für offizielle Meldungen. 
  • Inaktive VZD-Einträge werden in der Detailansicht als solche gekennzeichnet. 
  • Weitere geringfügige Darstellungsanpassungen. 

Weiteres

  • Aktualisierung des HAPI-FHIR-Profils auf 1.1.1
  • (Aktualisierung des HAPI FHIR Servers auf 8.10)

Schnittstellenversionen

HAPI FHIR Profil

VZD FHIR 1.2.0-16

gemProdT_VZD_FHIR_PTV_1.1.3-0_V1.0.0

ERLEDIGT

09.04.26 
17:00 - 20:00

21.04.26 
17:00 - 20:00
28.04.26 
22:00 - 02:00

search / fdv-search (REST)

  • Mapping und Suche "fdv-relevant" (ePA):

    Die Suche wurde gemäß ePA-Vorgaben um folgende Leistungserbringergruppen erweitert:

    • Ergotherapiepraxen

    • Logopädische Praxen

    • Podologiepraxen

    • Ernährungstherapeutische Praxen

    Diese Einrichtungen werden nun bei entsprechenden FDV-Suchen berücksichtigt. (Weitere Informationen befinden sich im Implementierungsleitfaden unter https://github.com/gematik/api-vzd/blob/develop/docs/FHIR_VZD_HOWTO_Search.adoc#4-special-case-search-by-professionoids-in-the-epa-context)

    Statt einer "_tag"-basierten Suche erfolgt das Mapping aus Performancegründen auf die Volltextsuchen ("_text").

  • Bei den Suchoperationen near und nearPharmacy werden nun auch Sonder-Schließzeiten berücksichtigt. Dadurch werden nur aktuell verfügbare Organisationen bzw. Apotheken angezeigt.

owner (REST)

  • Bei der Anlieferung von Apotheken-Daten über die Owner-Schnittstelle wird der Spezialisierungswert „apo-vzd“ mit VZD FHIR 1.2.0-15 nicht korrekt verarbeitet.

    Folge: Bei einer Aktualisierung können bestehende Spezialisierungen unbeabsichtigt entfernt werden.

    Workaround (bis Version 1.2.0-16): Vor der Aktualisierung eines HealthcareService-Datensatzes muss der Textwert „apo-vzd“ im Bereich „Specialty“ entfernt werden.

    Fix: Mit Version 1.2.0-16 wird der Wert korrekt verarbeitet.

  • Die Validierung der Institutionskennzeichen (IK) in der Federationlist wurde aktualisiert, sodass ab VZD FHIR 1.2.0-16 zusätzlich zu den bisherigen Präfixen „10“, „16“ und „95“ auch „45“, „97“, „98“ und „99“ unterstützt werden.

readCertificates (REST)

  • Die Schnittstelle I_FHIR_VZD_Certificates wurde um den Suchparameter ldapUid erweitert. 

VZD SSP

  • Überarbeitung der Darstellung pharmazeutischer und medizinischer Leistungen

  • Erweiterung der „Vor-Ort“-Leistungen

  • Entfernung der Services:

    • Abholung ohne TI

    • Versand ohne TI

    • Botendienst ohne TI

  • Verbesserte Darstellung von Botendienst-Lieferumkreis und PLZ

  • Erweiterung Prüfung für Sonderöffnungszeiten, Sonderschließzeiten und Notdienstzeiten.

  • Weitere Verbesserungen zur Erhöhung der Barrierefreiheit im SSP.

Weiteres

Schnittstellenversionen

HAPI FHIR Profil


Archiv 2025

Wartung

InhaltStatusChange-Termin RUChange-Termin TUChange-Termin PUScope / Beschreibung

Anpassung VZD FHIR Datenbank & Routing

ERLEDIGT

01.12.2025
17:00 - 18:00

Nicht relevant

Wird im Rahmen der Datenbank- migration am 20.11.2025 durchgeführt.

Aus betrieblichen Gründen wird die Konfiguration der Master-Datenbank (Schreibzugriffe) angepasst.

Zusätzlich werden externe Suchanfragen über die Owner-Schnittstelle künftig auf die Slave-Datenbanken (Lesezugriffe) umgeleitet.

Fachliche Änderungen sind mit dieser Anpassung nicht verbunden.

Datenbankmigration VZD FHIR

ERLEDIGT

23.10.2025  
17:00 - 21:00

./.

20.11.2025  
22:00 - 02:00

Zur Steigerung der Ausfallsicherheit wird die Datenbankarchitektur auf eine Master-Master-Redundanz umgestellt.

Im Zuge dessen erfolgen ebenfalls Anpassungen des Routings sowie eine Erweiterung der Server-Ressourcen.

Interne Anpassung VZD LDAP mit Downtime

ERLEDIGT

./../.

27.11.2025
22:00 - 00:00

Umstellung von RSA auf ECC für interne Kommunikation. 

Keine fachlichen / technischen Änderungen für Schnittstellenbenutzer. 

Deaktivierung SOAP-IDirectoryApplicationMaintenance-Schnittstelle

ERLEDIGT

24.02.2025 
17:00 - 20:00

16.09.2025 
17:00 - 20:00

09.10.2025
22:00 - 01:00

(inkl. Abbau LDAP View 6)

  • Deaktivierung der SOAP-Änderungsschnittstelle "I_Directoy_Application_Maintenance" für KIM-Fachdaten (KIM 1.0)
  • Aktualisierung DNS-SD Records entsprechend gematik AFO: GS-A_4810 inklusive Entfernung der SOAP-Schnittstellen. 

Inbetriebnahme Authserver (Keycloak) Cluster

ERLEDIGT

28.05.2025
17:00 - 21:00 Uhr 

./.

18.09.2025

22:00 - 00:00

Zur Verbesserung der Erreichbarkeit und Ausfallsicherheit wird die bisherige Einzelinstanz von Keycloak durch einen hochverfügbaren Keycloak-Cluster ersetzt.
Die Verteilung der eingehenden Anfragen erfolgt über ein Loadbalancing, wobei die extern erreichbaren Schnittstellen (URLs) unverändert bleiben.

Im Zuge der Umstellung kam es aufgrund unterschiedlicher Unterstützung von Cipher Suites durch einzelne Clients zu abweichendem TLS-Verhalten:
Einige Clients bevorzugten RSA-basierte Verbindungen gegenüber der ursprünglich eingesetzten Elliptic Curve (EC)-basierten Kommunikation.
Dies machte einen Wechsel des TLS-Zertifikats inklusive der zugrunde liegenden Root-CA erforderlich.

EC Root-CA:

  • Name: D-TRUST Root Class 3 CA 2 2009

  • Seriennummer: 0x983F3

RSA Root-CA:

  • Name: D-TRUST Root Class 3 CA 2 EV 2009

  • Seriennummer: 0x983F4

Die Prüfung des Root-CA-Zertifikats ist laut [gematik]-Spezifikation nicht vorgesehen.
Sollte eine solche Prüfung jedoch durch Clients eigenverantwortlich implementiert worden sein, bitten wir darum, die Zertifikatskette clientseitig entsprechend zu aktualisieren.

Das konkrete Datum der Umstellung wird im Rahmen der betrieblichen Changes inkl. Release Notes bekannt gegeben

VZD FHIR - Alle FHIR-Suchen (Search, FDV-Search und Owner)

ERLEDIGT

./.

./.

23.07.2025

Aufgrund von langlaufenden Anfragen einzelner Clients wurde das Timeout für Datenbankabfragen von 60 auf 30 Sekunden reduziert.

Anfragen, die diese Schwelle überschreiten, werden künftig mit einer Fehlermeldung beendet.

Wir bitten alle Clients, ihre Implementierungen gemäß den offiziellen Vorgaben gemSpec_VZD_FHIR_Directory sowie den empfohlenen Best Practices zu optimieren, um eine möglichst kurze Laufzeit der Suchanfragen sicherzustellen. Weitere Hinweise finden Sie in unserer FAQ.

LDAP: Anpassung Idle Timeout #3

ERLEDIGT

./../.

03.06.2025
22:00 - 24:00 Uhr

  • Aktuell gibt es einen signifikanten Anstieg der offenen (nicht genutzten) Verbindungen zum OpenDj (verbunden über den HA-Proxy). Zur Vermeidung von Konflikten mit Client-IdleTimeouts wird die maximale IdleTime am LDAP-View-Server (OpenDj) auf 70 Sekunden eingestellt. 

Änderung Kim-Fachdaten-Schnittstelle "I_Directory_Application_Maintenance" (REST) Server-Zertifikat und -Konfiguration zur Unterstützung von ECC NIST

ERLEDIGT

19.05.2025

~ 09:00 - 11:00

26.05.2025

17:00 - 19:00

05.06.2025

22:00 - 00:00

  • RU
    • Umstellung Server (NGINX) aus ECC NIST. 
    • Parallele Konfiguration von ECC Brainpool und ECC NIST im Server (NGINX). 
    • Kein RSA in ECC-Only-Testwoche
    • RSA als Fallback bis Ende des Jahres.
  • TU 
    • Umstellung Server (NGINX) aus ECC NIST. 
    • Parallele Konfiguration von ECC Brainpool und ECC NIST im Server (NGINX). 
    • RSA als Fallback bis 18.06.25
  • PU
    • Umstellung Server (NGINX) aus ECC NIST. 
    • Parallele Konfiguration von ECC Brainpool und ECC NIST im Server (NGINX).
    • RSA als Fallback bis Ende des Jahres.

Deaktivierung SHA1

Deaktivierung LDAP-IDirectoryApplicationMaintenance-Schnittstelle

ERLEDIGT

07.01.2025
17:00 - 19:00 Uhr

09.01.2025
17:00 - 19:00 Uhr
12.02.2025
22:00 - 24:00 Uhr
  • TLS 1.2 SHA1 Cipher Suiten werden für die Schnittstellen "VZD LDAP-Schnittstellen LDAP-Query (flache Liste)", "I_Directory_Maintenance, I_Directory_Appl_Maintenance (SOAP + REST)", "LDAP (Directory_Appl_Maintenance)" und "REST (I_Dir_Administration)" in einem Change deaktiviert.

  • Deaktivierung der LDAP-Änderungsschnittstelle "I_Directoy_Application_Maintenance"

VZD FHIR: Technische Anpassungen Anbindung Gematik-IDP & Betriebliche Konfigurationsanpassung HAPI-FHIR-Server

ERLEDIGT

12.12.2024
17:00 - 19:00 Uhr
12.12.2024
17:00 - 19:00 Uhr
11.02.2025
22:00 - 24:00 Uhr
  • Änderung des UserAgent-Formats bei der Kommunikation mit dem Gematik-IDP

LDAP: Anpassung Idle Timeout #2

ERLEDIGT

./../.

13.01.2025
22:00 - 24:00 Uhr

Aktuell gibt es einen signifikanten Anstieg der offenen (nicht genutzten) Verbindungen zum OpenDj (verbunden über den HA-Proxy). Zur Reduzierung dieser Verbindungen wird die maximale IdleTime am LDAP-View-Server (OpenDj) auf 60 Sekunden eingestellt. 

Aktualisierung Authentifizierungsserver und VZD Self-Service-Portal

ERLEDIGT

28.10.2024
17:00 - 19:00 Uhr
30.10.2024
17:00 - 19:00 Uhr
05.11.2024
22:00 - 24:00 Uhr
Der Authentifizierungsserver und das Self-Service-Portal werden aktualisiert.
Während des angegebenen Zeitraums kann die Erreichbarkeit des Authentifizierungsserver eingeschränkt sein.

LDAP: Anpassung Idle Timeout

ERLEDIGT

15.10.2024
17:00 - 19:00 Uhr
17.10.2024
17:00 - 19:00 Uhr

17.10.2024
22:00 - 24:00 Uhr

Aktuell gibt es einen signifikanten Anstieg der offenen (nicht genutzten) Verbindungen zum OpenDj (verbunden über den HA-Proxy). Zur Reduzierung dieser Verbindungen wird die maximale IdleTime am LDAP-View-Server (OpenDj) auf 5 Minuten eingestellt. 

Veröffentlichungen VZD LDAP

VersionStatusChange-Termin RUChange-Termin TUChange-Termin PURelease Notes (+Kommentar)

VZD LDAP 3.3.0-8

gemProdT_VZD_PTV_1.6.6-0_V1.0.0

ERLEDIGT

14.10.25 
17:00 - 20:00

20.10.25 
17:00 - 20:00
05.11.25
22:00 - 01:00

I_Directory_Query (ldap)

  • Keine Anpassung

I_Directory_Administration (REST)

  • Korrektur I_Directory_Administration.readLog in Kombination von Löschmarkierungen

  • Optimierung des fachlichen Loggings bei der Prüfung des Zertifikat-Aktivitätsstatus. 
    Log-Einträge werden nur noch bei tatsächlichen Statusänderungen erzeugt.

 I_Directory_Application_Maintenance (REST)

  • Fachdatenänderungen von KIM-Anbietern werden bei deaktivierten Basiseinträgen (entry.active=false) mit einer Fehlermeldung 423 beantwortet. 
    Die Löschung von Fachdaten bleibt weiterhin möglich.

VZD LDAP 3.3.0-7

gemProdT_VZD_PTV_1.6.6-0_V1.0.0

ERLEDIGT

07.08.25
17:00 - 20:00

12.08.25 
17:00 - 20:00
20.08.25
22:00 - 01:00 

I_Directory_Administration (REST)

  • Beim Setzen der Lösch-Markierung auf Basiseinträgen wird nun ein fachlicher Log-Eintrag erzeugt.
    Dies erfolgt im Rahmen einer Migration auch rückwirkend für alle bereits als gelöscht markierten Einträge.
  • Führende & angehängte Leerzeichen werden bei Übernahme des Zertifikatsfeld givenName entfernt.
  • Plausibilisierungsregeln werden in der Referenzumgebung (RU) und gematik-Testumgebung (TU) für Testkarten (Infix "Testkarte") deaktiviert.
  • Die zulässigen ProfessOids und Spezialisierungen an der I_Directory_Administration-Schnittstelle wurden entsprechend dem aktuellen FHIR-Profil 0.14.0 wie folgt angepasst. 

Die Codes 175, 176, 177, 178, 186, 187, 188 zu System "1.3.6.1.4.1.19376.3.276.1.5.11" wurden ergänzt und die veralteten Codes 5, 67, 93, 158, 159, 161, 162, 163, 164, 166, 167, 168, 170, 171, 172 entfernt.

Zudem wurden die ProfessionOIDs 274, 275, 276, 277, 312, 313, 315, 316, 318, 319 zu EntryType 1 (System = "1.2.276.0.76.4" ergänzt und 1.3.6.1.4.1.24796.4.11.1 entfernt. (Bereits in der PU 3.3.0-6 umgesetzt) 

I_Directory_Query (ldap)

  • Zur Optimierung der I_Directory_Query-Performance für Mozilla Thunderbird wurde das LDAP-Schema um entsprechende Mozilla-Attribute ergänzt und mit einem Index versehen.

VZD LDAP 3.3.0-6

gemProdT_VZD_PTV_1.6.6-0_V1.0.0

ERLEDIGT

27.05.25
17:00 - 20:00 

16.06.25
17:00 - 20:00 

25.06.25
22:00 - 01:00

I_Directory_Administration (REST)

  • Breaking Change: Der Standardwert „DE“ für den CountryCode wird bei der Anlage (AddDirectoryEntry) und Aktualisierung (ModifyDirectoryEntry) über den REST-Service RsDirectoryAdministration nicht mehr automatisch gesetzt. Bei der Anlieferung einer PLZ, StateOrProvince, City, Straße muss ein CountryCode obligatorisch angeliefert. Nicht-Anlieferung führt zu einem "Bad Request"-Fehler (Fehlercode 400)
  • Anpassung Fehlermeldung bei Anlage von Einträgen ohne Adressinformationen
  • Aufgrund Bibliothek-Aktualisierungen werden leere Listen-Attribute als leere Liste statt "null"-Objekt zurückgegeben.
  • Aktivierung einer Prüfung zur Vermeidung von Echtdaten in der Referenzumgebung und der Testumgebung.
  • Die zulässigen ProfessOids und Spezialisierungen an der I_Directory_Administration-Schnittstelle wurden entsprechend dem aktuellen FHIR-Profil 0.14.0 wie folgt angepasst. 

    Die Codes 175, 176, 177, 178, 186, 187, 188 zu System "1.3.6.1.4.1.19376.3.276.1.5.11" wurden ergänzt und die veralteten Codes 5, 67, 93, 158, 159, 161, 162, 163, 164, 166, 167, 168, 170, 171, 172 entfernt.

    Zudem wurden die ProfessionOIDs 274, 275, 276, 277, 312, 313, 315, 316, 318, 319 zu EntryType 1 (System = "1.2.276.0.76.4" ergänzt und 1.3.6.1.4.1.24796.4.11.1 entfernt.

    (Änderung in der RU und TU erfolgt mit dem nächsten geplanten Release) 

I_Directory_Application_Maintenance (REST)

  • Vorhandene Fachdaten werden bei Überschreitung von MaxKOMLEadr nicht mehr gelöscht .

VZD LDAP 3.3.0-5

ERLEDIGT

25.03.2025
17:00 - 20:00 Uhr 

11.03.2025 
17:00 - 20:00 Uhr

08.04.2025
22:00 - 01:00 Uhr

  • Aktivierung von Plausibilisierungsregeln (V004, V005, V006) zur Sicherstellung der Spezialisierungsinhalte (SMCB, HBA, Apotheken)

  • Erweiterung des optionalen Attributs „lanr“ (Lebenslange Arztnummer) im Datenmodell und in der Kartenherausgeber-Pflegeschnittstelle I_Directory_Administration (vzd_DirectoryAdministration_1.12.7.yaml).

  • Diverse Betriebsoptimierungen ohne funktionale Auswirkungen

VZD LDAP 3.3.0-4

ERLEDIGT

18.11.2024
17:00 - 19:00 Uhr

11.12.24 17:00 - 19:00
(Nacharbeiten) 

16.12.2024
17:00 - 19:00 Uhr

17.03.2025
22:00 - 24:00 Uhr


Verschiebung auf März 25

Aktivierung abgestimmter Plausibilisierungsregeln zur Erhöhung der Datenqualität an der Rest-Schnittstelle “I_Directory_Administration” (Link zur Gematik-Spezifikation: https://github.com/gematik/api-vzd/blob/main/docs/gemILF_Pflege_VZD.adoc#pr%C3%BCfungen-beim-eintragen-von-daten-zur-verbesserung-der-datenqualit%C3%A4t)

Regeln und damit verbundene Einschränkungen wurden den Kartenherausgebern / Identity Providern direkt kommuniziert.

Datenmigration

  • Es ist keine Migration vorgesehen.

VZD LDAP 3.3.0-3

ERLEDIGT

09.09.2024
17:00 - 19:00 Uhr
16.09.2024
17:00 - 19:00 Uhr
01.10.2024
22:00 - 24:00 Uhr
  • Korrektur der Gematik Rohdatenlieferung gemäß Spezifikation. (Anlieferung des Standardwerts “{}” für einen leeren Messageblock)

  • Ergänzung der möglichen Apotheken-Spezialisierung um 50 "Sterilherstellung" https://simplifier.net/packages/de.gematik.fhir.directory/0.11.12/files/2522372
  • Anlage eines Such-Index auf das Attribut "ProvidedBy" zur Verbesserung der Suchperformance.
  • Weitere betriebliche Optimierungen ohne fachliche Auswirkungen

VZD LDAP 3.3.0-2

ERLEDIGT

27.06.2024 
17:00 - 19:00 Uhr
04.07.2024 
17:00 - 19:00 Uhr
18.07.2024
22:00 - 24:00 Uhr
  • VZD LDAP Rohdatenlieferung gemäß Gematik Spezifikation

  • Konfiguration neuer ProfessionOids im VZD LDAP möglich:

    • EntryType 1 (isPersonalEntry=true) → 1.2.276.0.76.4.305, 1.2.276.0.76.4.308

    • EntryType 3 (isPersonalEntry=false) → 1.2.276.0.76.4.304, 1.2.276.0.76.4.306

    • EntryType 4 (isPersonalEntry=false) → 1.2.276.0.76.4.292

    • EntryType 10 (isPersonalEntry=false) → 1.2.276.0.76.4.303

  • Weitere betriebliche Optimierungen

VZD LDAP 3.3.0-1

ERLEDIGT

15.04.2024
17:00 - 19:00 Uhr
17.04.2024
17:00 - 19:00 Uhr
29.04.2024 
22:00 - 24:00 Uhr
  • Erweiterung des SOAP-Service I_Directory_App_Maintenance zur Füllung des KimData Attributs
  • Korrektur des OCSP-Cache. Die Rückgabe des Status 200 “unknown” und “busy” werden zukünftig nicht mehr von der Komponente TLS-Proxy gecachet.

  • Diverse betriebliche Optimierungen 

VZD LDAP 3.3.0

ERLEDIGT

30.01.2024 
17:00 - 19:00 Uhr
13.02.2024 
17:00 - 19:00 Uhr
29.04.2024 
22:00 - 24:00 Uhr
  • Erweiterung diverser Komponenten-Schnittstellen um das neue Attribut KimData analog zu KomLeData.
  • Datenmigration KomLeData in KimData
  • Diverse betriebliche Optimierungen 

Veröffentlichungen VZD FHIR

VersionStatusChange-Termin RUChange-Termin TUChange-Termin PURelease Notes (+ Kommentar)

VZD FHIR 1.2.0-15

gemProdT_VZD_FHIR_PTV_1.1.3-0_V1.0.0

ERLEDIGT

10.11.25 
17:00 - 21:00


11.11.25 
17:00 - 21:00



08.12.25
22:00 - 02:00 

FDV-Search

  • Eingehende FDV-Suchanfragen mit relevanten, ODER-verknüpften ProfessionOIDs werden intern auf das Flag "fdv-relevant" gemappt werden. Dadurch werden komplexe organization.type-Abfragen automatisch optimiert und auf eine performantere Flag-Suche umgeschrieben, während alle weiteren Suchparameter unverändert bestehen bleiben. (Weitere Informationen befinden sich im Implementierungsleitfaden unter https://github.com/gematik/api-vzd/blob/develop/docs/FHIR_VZD_HOWTO_Search.adoc#4-special-case-search-by-professionoids-in-the-epa-context)

  • Für die Umkreissuche (near- und nearPharmacy-Operationen) in der eRezept-App wurde analog zur Search-/FDV-Search-Schnittstelle das Attribut fullUrl ergänzt. Dadurch können Referenzen wie providedBy automatisch mit der passenden Ressource verknüpft werden, was die Interoperabilität und Verarbeitung der Suchergebnisse verbessert. 

Owner / Owner-Auth

  • Breaking Change: Zur Härtung des Anmeldeprozesses wurde folgende Anforderung umgesetzt. Bei der Anmeldung an der VZD FHIR Owner-Schnittstelle wird zukünftig überprüft, ob die verwendete HBA- / SMCB-Karte (Telematik-ID) dem VZD FHIR bereits bekannt ist. Damit kann sich niemand anmelden der kein Inhaber einer VZD FHIR-Ressource ist. Es ist durch den Kartenherausgeber / TSP organisatorisch sicherzustellen, dass der der entsprechende Eintrag im VZD LDAP angelegt und damit autom. in den VZD FHIR synchronisiert wird.

  • Die bisherigen FHIR-Codings für HealthcareService.type aus den Containern „apo-vzd“ und „ldap“ wurden in einem gemeinsamen CodeableConcept-Container „ldap“ zusammengeführt. Dabei werden Dubletten konsolidiert, sodass die Daten künftig ausschließlich über die LDAP-Synchronisation gepflegt und über die Owner-Schnittstelle mit SMCB-Karte bearbeitet werden können. 

  • Die FHIR-Codings für HealthcareService.specialty aus den Containern „apo-vzd“ und „owner“ wurden in einem gemeinsamen CodeableConcept-Container „apo-vzd“ zusammengeführt. Änderungen über die Owner-Schnittstelle werden künftig ebenfalls mit dem Zusatz „apo-vzd“ gekennzeichnet, wodurch Dubletten konsolidiert werden. Damit ist die Pflege der speciality über die AVS-Systeme / durch den Owner zu erfolgen. 

  • Das Verhalten des Attributs userSelected wurde angepasst: Der Wert ist nun immer false und wird unabhängig von Änderungen durch den Owner stets angezeigt. 

  • Mit der Aufweichung der Input-Validierung ist es zukünftig möglich bei Aktualisierungen von HealthcareService- und PractitionerRole-Ressourcen alle Endpunkt-Referenzen zu aktualisieren. Zuvor war es nur möglich eigene Referenzen zu aktualisieren. 

Self Service Portal

  • Breaking Change: Zur Härtung des Anmeldeprozesses wurde folgende Anpassung umgesetzt. Bei der Anmeldung am VZD Self Service Portal wird künftig überprüft, ob die eingesetzte HBA- oder SMC-B-Karte (Telematik-ID) bereits im VZD FHIR bekannt ist. Dadurch wird sichergestellt, dass sich nur Personen anmelden können, die Inhaber einer entsprechenden VZD FHIR-Ressource sind. Es ist durch den Kartenherausgeber / TSP organisatorisch sicherzustellen, dass der der entsprechende Eintrag im VZD LDAP angelegt und damit autom. in den VZD FHIR synchronisiert wird. 

Allgemein

  • In den Komponenten TI-FHIR-Provider und TI-Service-Provider wurde die Prüfung des „Bearer“-Präfixes im Authorization-Header angepasst, sodass künftig keine Unterscheidung der Groß- und Kleinschreibung mehr erfolgt. Damit werden auch Varianten wie „bearer“ oder „BEARER“ akzeptiert, was die Kompatibilität der Schnittstellen verbessert und Fehler bei der Tokenverwendung vermeidet. 

Profilupdate

Aktualisierung des HAPI-FHIR-Profils auf 1.0.0

Versions- und Abhängigkeits-Updates

  • Aktualisierung der Paketversion auf 1.0.0 in der package.json und allen Ressourcendateien

  • Hinzufügen neuer Abhängigkeiten in package.json und fhirpkg.lock.json:

    • de.gematik.terminology

    • de.gematik.ti

    • hl7.terminology.r4

    • hl7.fhir.uv.extensions.r4

    • dvmd.kdl.r4

Ressourcen- und CodeSystem-Änderungen

  • Entfernung folgender Ressourcen:

    • CodeSystem-OrganizationProfessionOID.json

    • CodeSystem-PractitionerProfessionOID.json

    • CodeSystem-OrganizationProviderType.json

  • Grund: Migration zu den neuen Dependencies bzw. Refactoring der Codesysteme.

Aktualisierung des HAPI-FHIR-Profils auf 0.15.0

  • Aktualisierungen der Pharmacy Healthcare Specialty Codes:
    Die Anzeigewerte für die Spezialcodes 60, 70, 80, 90 und 100 wurden aktualisiert, sodass deren Definitionen nun direkt im Anzeigetext (Display) enthalten sind.

  • Entfernung eines ungenutzten Value Sets:
    Das Value Set http://ihe-d.de/ValueSets/IHEXDShealthcareFacilityTypeCodePatientRelatedHealthcare wurde aus den HealthcareServiceCategoryCodes entfernt, da es nicht mehr verwendet oder benötigt wird.

Aktualisierung des HAPI-FHIR-Profils auf 0.16.0

VZD FHIR 1.2.0-14

gemProdT_VZD_FHIR_PTV_1.1.3-0_V1.0.0

ERLEDIGT

06.08.25
17:00 - 21:00


13.08.25
17:00 - 21:00 



20.08.25
22:00 - 02:00

VZD FHIR

  • Sicherheitsinformationen (meta.security) wie die HolderId und OwnerId werden im TI-FHIR-Provider nicht mehr entfernt und stehen für nachgelagerte Systeme zur Verfügung.

  • GEO-Koordinaten werden bei Adressänderungen für Apotheken automatisch ergänzt. 

  • Titel (z. B. „Prof. Dr. Med“) werden im _text-Feld nach neuer Formatierung gespeichert, um durchsuchbar zu sein.

  • Owner und Holder können jetzt Telekommunikationsdaten in PractitionerRole-Einträgen pflegen.

  • Das Format für TIM-Endpunkte wird bei POST/PUT-Anfragen überprüft.

  • Notdienstzeiten werden nun in den Suchen near und nearPharmacy berücksichtigt.

  • Personeneinträge ohne Vornamen unterstützt: Die Pflicht zur Angabe von givenName entfällt.

  • Profil-Update: Aktualisierung auf HAPI-Profil Version 0.14.0 (FVZ-5255).

Self-Service-Portal (SSP)

  • Owner können GEO-Koordinaten manuell eingeben, die Validierung des Formats erfolgt direkt im Dialog.

  • Neben der FHIR-Historie wird jetzt auch die LDAP-Änderungshistorie angezeigt.

  • Die technische HolderId wird in der Änderungshistorie durch den zugehörigen Namen ersetzt.

  • Zertifikate werden mit farbigem Statusbalken nach Restgültigkeit in Cards dargestellt.

  • Anmeldemethoden sind nun direkt im ersten Dialog sichtbar, inklusive überarbeitetem Wording und FAQ-Link.

  • Änderungen an Mehrwertdaten sind im SSP nur noch für (Versand-)Apotheken erlaubt.

  • Die Funktion „Reservierung“ wird nun fachlich korrekt als „Abholung“ im Feld specialty geführt und im SSP entsprechend angezeigt.

Aktualisierung des HAPI-FHIR-Profils auf 0.14.0

Fachliche Änderungen

  • Feld given im PractitionerDirectory: Kardinalität von 1..* zu 0..* geändert.

  • Datenmigration: .telecom von Practitioner nach PractitionerRole kopiert und dann auf Practitioner entfernt.

  • Neue Extensions:

    • holderId für PractitionerRoleDirectory und HealthcareServiceDirectory.

    • OwnerTelematikIdEx (inkl. Einbindung in mehrere Directory-Ressourcen mit Kardinalität 0..*).

  • Neue SearchParameter:

    • HolderIdSP (Suche nach holderId)

    • OwnerTelematikIdSP (Suche nach owner TelematikId)

  • Neue Konzepte hinzugefügt zu:

    • OrganizationProfessionOID

    • PractitionerProfessionOID

  • Änderungen an Display-Values einiger PractitionerProfessionOID-Konzepte. 

  • Neue Fachgebiet-Codes zu PharmacyHealthcareSpecialtyCS hinzugefügt:

    • #60 Bluthochdruck: Standardisierte Risikoerfassung bei Bluthochdruck

    • #70 Inhalativa: Üben der Inhalationstechnik

    • #80 Polymedikation: Erweiterte Medikationsberatung bei Polymedikation

    • #90 Orale Krebstherapie: Betreuung bei Einnahme von Krebsmedikamenten

    • #100 Organtransplantation: Beratung nach Organtransplantation

Technische Änderungen (keine fachliche Auswirkung)

  • .type-Slicing geändert: CodingSystemCodeInv direkt auf .type-Slices angewendet (zur Vermeidung von Snapshotting-Problemen).

  • .telecom von Practitioner zu PractitionerRole verschoben.

  • Veraltete OID KBV_CS_SFHIR_BAR2_WBO_OID_URL entfernt (durch IHE-Codes ersetzt).

  • Beispiele bereinigt: communication und appointmentRequired entfernt.

  • Veraltete Codes aus VZDHealthCareServiceCharacteristicsCS entfernt.

  • Zwei Invarianten aus VZD-Service-Opening-TimeInv erstellt für bessere Fehlermeldungen.

  • Binding des ValueSet bei Endpoint.connectionType korrigiert (von code auf connectionType(Coding)).

  • OwnerTelematikIdSP: Basis von Resource zu spezifischen Ressourcen-Typen geändert (für hapi-fhir-server-Kompatibilität).

  • Entfernt: erx-token-receiver aus VZDHealthCareServiceCharacteristicsCS

    • Keine Migration, Begründung: Code wurde im VZD nicht verwendet.

VZD FHIR 1.2.0-13

gemProdT_VZD_FHIR_PTV_1.1.3-0_V1.0.0

ERLEDIGT

28.05.2025
17:00 - 21:00 Uhr 

17.06.2025
17:00 - 21:00 Uhr 

26.06.2025
22:00 - 02:00 Uhr

Logging & Monitoring

Funktionserweiterung Owner-Schnittstelle

  • Pflege OrganizationVisibility und EndpointVisibility als Holder über Owner-Schnittstelle
  • Pflege NCPeH-Einträgen über Owner-Schnittstelle

Bugfixes & Abweichungen

  • TIM: Korrektur der Fehlermeldung bei Pflege der IK-Nummer
  • TIM: Korrektur IK-Attributsname in Föderationsliste (alt: IKS, neu: IK)

  • Anpassung von LDAP-Synchronisation zur Synchronisation von Personen ohne Vornamen (Standardwert: "-")

VZD FHIR 1.2.0-12

ERLEDIGT

27.03.2025
17:00 - 20:00 Uhr 

13.03.2025
17:00 - 20:00 Uhr

10.04.2025
22:00 - 01:00 Uhr

Im Rahmen der VZD-Weiterentwicklung wurden diverse Funktionalitäten erweitert und verbessert. Dies umfasst folgende Änderungen:

1. Aktualisierung des HAPI-FHIR-Profils auf 0.11.25

Auszug Changelog:

Version 0.11.25

  • fix: CodeSystem: AerztlicheBerufsvarianten contained codes with a wrong prefix of #, these prefixes were removed. data migration remove #from code instances of the CodeSystem: urn:oid:1.2.276.0.76.5.493 used on Practitoner.qualification

Version 0.11.24

  • fix: relaxed cardinality of OrganizationDirectory.identifier[IKNR] from 0..1 -> 0..* allowing multiple IKNR for an Organization
  • removed: PractitionerDirectory.identifier[ZANR] as it is not required.
  • fix: breaking Updated Contents of external IHE & KBV CodeSystems
  • fix: breaking OrganizationVisibilityCS: renamed #hide-erezeptApp "Eintrag nicht in eRezeptApp darstellen" to #hide-versicherte "Eintrag für Versicherte verbergen"

data migration

  • CodeSystem: OrganizationVisibilityCS (https://gematik.de/fhir/directory/CodeSystem/OrganizationVisibilityCS)
    • #hide-erezeptApp "Eintrag nicht in eRezeptApp darstellen" was changed to #hide-versicherte "Eintrag für Versicherte verbergen"
  • CodeSystem: KBV_CS_SFHIR_BAR2_WBO Fachgruppen (urn:oid:1.2.276.0.76.5.114)
    • removed:
      • #091 "SP Kinderkardiologie"
      • #196 "SP Kinderradiologie"
      • #304 "FA Kinderchirurgie"
      • #518 "FA Sprach-, Stimm- und kindliche Hörstörungen"
      • #530 "SP Kinder-Hämatologie und -Onkologie"
      • #542 "FA Plastische und Ästhetische Chirurgie"
      • #544 "FA Allgemeinchirurgie"
    • new:
      • #144 "Psychotherapeutisch tätige Ärztin/Psychotherapeutisch tätiger Arzt (Zusatzbezeichnung)"
      • #305 "Medizinische Genetik"
      • #306 "Medizinische Informatik"
      • #307 "Pathologische Physiologie"
      • #317 "Physiologische Chemie"
      • #350 "Biomathematik"
      • #351 "Biophysik"
      • #352 "Geschichte der Medizin"
      • #353 "Industrietoxikologie"
      • #354 "Klinische Strahlenphysik"
      • #355 "Medizinische Wissenschaftsinformation"
      • #356 "Medizinische Physik und Biophysik"
      • #358 "Fachbiologie der Medizin"
      • #371 "Fachwissenschaftlerin/Fachwissenschaftler Chemie und Labordiagnostik"
      • #372 "Fachwissenschaftlerin/Fachwissenschaftler Genetik"
      • #373 "Fachwissenschaftlerin/Fachwissenschaftler Immunologie"
      • #374 "Fachwissenschaftlerin/Fachwissenschaftler Zytologie/Histologie"
      • #470 "Psychologische Psychotherapeutin/Psychologischer Psychotherapeut"
      • #471 "Kinder- und Jugendlichenpsychotherapeutin/Kinder- und Jugendlichenpsychotherapeut"
      • #474 "Fachpsychotherapeutin/Fachpsychotherapeut für Erwachsene"
      • #475 "Fachpsychotherapeutin/Fachpsychotherapeut für Kinder und Jugendliche"
      • #476 "Fachpsychotherapeutin/Fachpsychotherapeut für Neuropsychologische Psychotherapie"
      • #573 "FÄ/FA Kinder -und Jugendchirurgie"
      • #574 "FÄ/FA Plastische, Rekonstruktive und Ästhetische Chirurgie"
      • #575 "FÄ/FA Phoniatrie und Pädaudiologie ((M-)WBO 2018)"
      • #576 "SP Kinder- und Jugend-Hämatologie und -Onkologie"
      • #577 "SP Kinder- und Jugend-Kardiologie"
      • #578 "SP Kinder- und Jugendradiologie"
      • #579 "FÄ/FA Innere Medizin und Infektiologie ((M-)WBO 2018)"
    • CodeSystem: QualifikationenNichtAerztlicherAutoren_OID_URL (urn:oid:1.3.6.1.4.1.19376.3.276.1.5.11)
      • removed:
        • #5 "Tiermedizinischer Fachangestellter"
        • #93 "Medizinische Datenerhebung"
        • #142 "Veterinärmedizinischer-technischer Assistent"
        • #158 "Medien, Kultur, Gestaltung, Kunst (außer Pädagogen)"
        • #159 "Schutz und Sicherheit"
        • #162 "Verfahrens- und Produktentwicklung, technisches Zeichnen, Konstruktion"
        • #163 "Sprachen"
        • #164 "Produktion, Produktionsplanung, Produktionssteuerung, Instandhaltung"
        • #166 "Reinigung"
        • #167 "Bau, Architektur, Rohstoffe"
        • #168 "Verwaltungsberufe (außer medizinische), kaufmännische Berufe, Verkehr"
        • #170 "Elektro, Energie, Ver- und Entsorgung"
        • #171 "Gastgewerbe und Tourismus, Veranstaltungsmanagement und Hauswirtschaft"
        • #172 "IT"
      • new:
        • #175 "Fachgesundheits- und krankenpfleger für Intensivpflege und Anästhesie"
        • #176 "Fachgesundheits- und krankenpfleger im Operations-/Endoskopiedienst"
        • #177 "Fachgesundheits- und krankenpfleger für Hygiene"
        • #178 "Fachgesundheits- und krankenpfleger für Palliativ- und Hospizpflege"
        • #186 "Pflegefachmann/Pflegefachfrau"
        • #187 "Fachgesundheits- und krankenpfleger für Onkologie"
        • #188 "Fachgesundheits- und krankenpfleger für Psychiatrie"

Version 0.11.23

  • feat: added Invariant CodingSytemCodeInv throwing a warning if a Coding element is missing system or code. Added to:
    • EndpointDirectory.meta.tag, EndpointDirectory.connectionType, EndpointDirectory.payloadType.coding, OrganizationVisibility.valueCoding, EndpointVisibility.valueCoding, SpecialOpeningTimesEX.extension[qualifier].valueCoding, NCPeHCountryEx.valueCoding, HealthcareServiceDirectory.meta.tag, HealthcareServiceDirectory.category.coding, HealthcareServiceDirectory.type.coding, HealthcareServiceDirectory.specialty.coding, HealthcareServiceDirectory.communication.coding, HealthcareServiceDirectory.characteristic.coding, LocationDirectory.meta.tag, OrganizationDirectory.meta.tag, OrganizationDirectory.type.coding, PractitionerDirectory.meta.tag, PractitionerDirectory.qualification.code.coding, PractitionerDirectory.communication.coding, PractitionerRoleDirectory.meta.tag
  • feat: added a data type profile CodingWithCodeAndSystem setting .code and .system to a min cardinality of 1. Applied in the derived strict profiles at the same elements as the CodingSytemCodeInv invariant.
  • fix: added SearchParameters with Uplifted-Refchains extension for hapi fhir servers
  • fix: added strict profiles: These profiles are derived from the VZD-profiles, are restricted non-MS elements to 0..0, add closed slicing. Purpose technical validation for VZD implementations (will be later activated)
  • fix: Extensions: OrganizationVisibility & EndpointVisibility had a required binding on Extension.value[x] which implies a min cardinality of 1. valueCoding is now set to 1.. explicitly.
  • feat: upgraded dependency de.basisprofil.r4 to version 1.5.1. This has no direct impact on the vzd.

Version 0.11.22

  • feat: added SearchParameter for NCPeHCountryEx: OrganizationNCPeHCountrySP
  • feat: added SearchParameter for Organization.alias: OrganizationAliasSP
  • feat: added strict profiles: These profiles are derived from the VZD-profiles, are restricted non-MS elements to 0..0, add closed slicing. Purpose technical validation for VZD implementations

Version 0.11.21

  • feat: restricted all extensible bindings to required:
    • EndpointDirectory.code
    • EndpointDirectory.payloadType
    • HealthcareServiceDirectory.type
    • HealthcareServiceDirectory.characteristic
    • LocationDirectory.state
    • PractitionerDirectory.qualification.code
  • feat: removed ServiceType from Fhir core from HealthcareServiceSpecialtyVS
    • affects: HealthcareServiceDirectory.speciality
  • feat: added NCPeHCountryEx to OrganizationDirectory to represent the NCPeH country in a coded form
  • feat: added CodeSystems for HealthcareServiceTypeVS which weren't included before
  • feat: added * OrganizationProfessionOID#1.2.276.0.76.4.292 "NCPeH Fachdienst" to HealthcareServiceCategoryCodes ValueSet

Version 0.11.20

  • fix: SystemsEngineering:tim.gematik.de Example address is now a matrix uri

2. Erweiterung des neuen Attributs “IK” inklusive Validierung in Föderationsliste

Lediglich erfolgreiche Validierungsergebnisse führen zur Anlage / Aktualisierung.
Ansonsten wird der Fehlercode 400 “BAD REQUEST” zurückgemeldet.

    • ik beginnt mit einem konfigurierten Präfix (initial “10”, “16” und “95”)

    • ik besteht aus einer neunstelligen Ziffernfolge

    • ik obligatorisch wenn isInsurance=true

    • ik darf nicht angeliefert werden wenn isInsurance=false

    • ik muss eindeutig sein in der gesamten Federationsliste
      Und muss ebenfalls eindeutig sein innerhalb eines Requests (JSON-Array)
      Nicht eindeutige ik führen zu dem Fehlercode 409 CONFLICT.

3. Optimierungen an der Volltextsuche

    • Implementierung Suchoperation "near" für Umkreissuche von Apotheken

    • Entfernung des Volltext-Attributs “_text” bei Anlieferung unter zwei Zeichen

    • Entfernung von Punkten bei folgendem Leerzeichen

    • Unterstützung von Synonymen in der Volltext-Suche

      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

      Praxis, Gemeinschaftspraxis, Dres, BAG, üBAG, Berufsausübungsgemeinschaft, Praxisgemeinschaft, Gruppenpraxis, Spezialpraxis

4. Synchronisation von LANR aus dem VZD LDAP

5. Korrektur Abrechnungsnummer der Zahnärzte bei Synchronisation aus dem VZD LDAP

6. Umbenennung Flag “hide-erezeptApp” auf “hide-Versicherte” zum Verstecken von Organisationen

7. Diverse Betriebsoptimierungen

Datenmigration

Prüfen Sie ob folgende Kriterien erfüllt sind. In diesem Fall ist keine Datenmigration notwendig. 
Nehmen Sie ansonsten eine Korrektur vor. (Insbesondere für Owner-Ressourcen der TIM-Testdatensätze relevant)

VZD FHIR 1.2.0-11

ERLEDIGT

20.11.2024 Teil 1
17:00 - 20:00 Uhr 

26.11.2024 Teil 2
17:00 - 20:00 Uhr

02.12.2024
17:00 - 20:00 Uhr

04.12.2024 - 05.12.24 Teil 1
22:00 - 01:00 Uhr 

(voraussichtlich) 09.12.2024 - 10.12.24 Teil 2
22:00 - 01:00 Uhr

  • Im Rahmen der VZD-Weiterentwicklung wurden diverse Funktionalitäten erweitert und verbessert.

  • Dies umfasst folgendes

    • Die Aufbewahrungsdauer des Fachlichen Logs wird nach Absprache mit der gematik auf 2 Jahre (730 Tage) verlängert. 

    • Eine neue Abfrageschnittstelle für Zertifikate wurde im VZD-FHIR implementiert, die eine Suche ermöglicht. Für die Nutzung ist ein neuer Scope erforderlich, der an die relevanten Authentifizierungsschnittstellen ergänzt wurde. Die Ergebnismenge wird standardmäßig auf 200 Einträge begrenzt. 

    • SMCB- und HBA-Zertifikate aus dem VZD LDAP werden nun bei der Synchronisation auch im VZD FHIR gespeichert. Neben den Zertifikaten werden Meta-Informationen wie Issuer, CreatedAt und ValidUntil persistiert, wobei nur aktivierte Zertifikate übernommen und nicht mehr benötigte Zertifikate bei der Synchronisation entfernt werden. 

    • Über die Owner-Schnittstelle können Owner das Flag "hide-erezeptApp" an eigenen Organisationen (identifiziert über die TelematikId) setzen. Alle anderen Änderungen werden nicht übernommen. 

    • Bei der Suche über die Schnittstelle “fdv-search” werden Endpunkte aus dem Ergebnis entfernt sobald dieser das Flag (Extension) Endpoint.endpointVisibility = ““hide-versicherte” gesetzt hat. 

    • Das HAPI-Profil wurde auf die Version 0.11.19 (https://simplifier.net/packages/de.gematik.fhir.directory/0.11.19) aktualisiert.

    • Die HAPI-FHIR Volltext-Suche wurde überarbeitet, sodass spezielle Zeichen im _text-Attribut standardmäßig ignoriert und ausschließlich als Bestandteil des Suchbegriffs behandelt werden. Dies erfolgt durch das automatische Ersetzen des Zeichens. Für komplexe Suchanfragen kann das ursprüngliche Verhalten mit dem neuen Parameter _complexSearch=true wiederhergestellt werden.

      Bisher definierte (und damit ersetzte) Spezialzeichen sind "-" und ",". Weitere können nach Absprache mit der Gematik folgen.

  • Der Change wird aufgrund seiner Größe in zwei Teilschritten durchgeführt.
    • Im ersten Termin werden alle Komponenten bis auf der HAPI-FHIR-Server aktualisiert.
    • Im zweiten Termin wird der HAPI-FHIR-Server inkl. Datenbank aktualisiert.

Datenmigration

  • Es ist keine Migration vorgesehen.

VZD FHIR 1.2.0-10

ERLEDIGT

13.08.2024
17:00 - 20:00 Uhr
./.28.08.2024 - 29.08.24
22:00 - 01:00 Uhr
  • Aktualisierung des HAPI-Profils auf Version 0.11.12 (https://simplifier.net/packages/de.gematik.fhir.directory/0.11.12)

  • Volltextsuche

    • Verbesserung der Suchergebnisse bei unkonkreten Anfragen durch eine interne Erweiterung

    • Automatische Übernahme von Suchparametern in die Volltextsuche ("_text"-Attribut) zur Verbesserung der Suchergebnisse.
      Relevante Attribute:
      • Suche nach HealthcareService = specialty, service-type, organization.type
      • Suche nach PractitionerRole = practitioner.qualification
  • Holder-Authensierung
    • Authentisierung zur Nutzung der Suche an den Schnittstellen "Search" und "Owner" mit Keycloak-Client-Secret (Realm: RSDirectoryAdministration)
  • Self Service Portal

    • Unterstützung des Authentifizierungsverfahrens mit HBA-/SMCB-Karte in Kombination mit der Authenticator-App.

    • Oberflächenanpassungen: Anpassungen gemäß den aktualisierten Gematik-Vorgaben

  • Weitere technische Korrekturen: Durchführung kleinerer technischer Korrekturen und betrieblicher Verbesserungen

    • Validierung Accept-Header gleich "application/fhir+json" bei HAPI-Operationen. Eine fehlerhafte Anlieferung wird mit einer sprechenden Fehlermeldung beantwortet. 
    • Erstellung neuer Suchparameter für die Suche nach Endpoint.EndpointVisibility und  Organization.OrganizationVisibility.
    • Korrektur der Gematik Rohdatenlieferung gemäß Spezifikation. (Anlieferung des Standardwerts “{}” für einen leeren Messageblock.)
    • Standardwertsetzung für Umkreissuchen ohne Angabe eines Umkreises und der Einheit. Standardwert: 50 km

VZD FHIR 1.2.0-9

ERLEDIGT

16.05.2024
17:00 - 19:00 Uhr
./.06.06.2024
22:00 - 24:00 Uhr
  • Aktualisierung des HAPI-FHIR-Profils zur Unterstützung der sogenannten “Mehrwertdaten” für Apotheken. Neues Profil siehe de.gematik.fhir.directory 0.11.5 - SIMPLIFIER.NET

    • Dabei wurden u.a. die Attribute “Type”, “Spezialisierung” und “Charakteristika” für HealthcareService-Ressourcen angepasst.

    • Zusätzlich wurden neue Attribute zur Einschränkung der Ressourcen-Sichtbarkeit “EndpointVisibility” (Endpoint) und “OrganizationVisbility” (Organization) ergänzt.

  • Korrektur der Rohdatenlieferung

    • Entfernung von Anführungszeichen bei Integer-Werten.

    • Anlieferung eines Leer-Strings statt geschweiften Klammern bei fehlenden Messageblock-Inhalten.

    • Beibehaltung der Suchparameter-Reihenfolge.

  • Die FederationList kann nun auch als NIST-Variante abgerufen werden. Die ausgestellten AccessToken werden mit NIST- statt Brainpool-Algorithmus signiert.

  • Die Suche nach Endpointen (status=active) ist an der Search- und FDV-Search-Schnittstelle möglich.

  • Organisationen mit Flag "hide-erezeptApp" werden server-seitig gefiltert.

  • Korrektur an der Owner-Auth (Backchannel)-Schnittstelle: An der Schnittstelle wird nun spezifikations-konform die Übergabe des grant_type "urn:telematik:params:grant-type:decoupled" erwartet. In der Vorversion wurde fälschlicherweise "urn:telematik:params:grant_type:decoupled" (Mit Unterstrich statt Bindestrich) erwartet. 
  • Weitere Minor-Fixes

VZD FHIR 1.2.0-8

ERLEDIGT

05.03.2024
17:00 - 19:00 Uhr
./.19.03.2024 
22:00 - 24:00 Uhr
  • Neuen Schnittstellen Service-Authenticate und FDV-Search

  • Zusammenführung von FHIR-Ressourcen über das ProvidedBy-Attribut

  • Verknüpfung von Personen und Institutionen

  • Rohdaten entsprechend der gematik-Anforderungen (ausgenommen dem UseCase FVZD.UC_7_1)


  • No labels