Deployments: PrePROD/Stage am 07.10.2025, Produktion am 14.10.2025 Versionen: Sammlerdienst 7.8.1, Suchdienst Backend 11.6.0, Suchdienst Frontend 4.9.2, Validator Backend 8.5.0, Fachvalidator Library 12.7.0, Validator Frontend 6.4.2, Bereitstelldienst 6.14.1, Konverterdienst 1.4.1, Konverter Library 1.9.1

Add​

Suchdienst Backend​

• Volltexte in Spezialisierungen werden, gleichberechtigt zu Leistung, in die Indizierung aufgenommen. Die Beschreibungen, die Volltexte und der Begriff im Kontext werden durchsucht. Diese Erweiterung kann zu Änderungen in den Suchergebnissen führen.

Validator Backend​

• Die Nutzung des Validator Services ist nur mit einer OAuth 2.0 Autorisierung möglich. Für einen Zugang wenden Sie sich bitte an den PVOG Support (dataportpvogsupport@dataport.de)

XZuFi 2.2. zu 2.3.1 Konverter​

• Die Protokollnachrichten wurden um die IDs der betroffenen Geschäftsobjekte und das Feld "einstufung" für die Darstellung der Kritikalität erweitert.

Change​

Validator Backend​

• Der Validator VAL0057 (Zwei Leistungen dürfen nicht den gleichen Leistungsschlüssel referenzieren.) ist auf den Modus Hinweis gesetzt. (Validatorhandbuch)
• Die Typisierungskombinationen der Redaktionssysteme der Länder (ohne Bund) 4:5, 1:3:10, 2b:1:2a, 3:4, 1:3:4 wurden ergänzt.
• Vor der Ausgabe /v1/archivvalidator/historie/{schemeAgencyId} wird nach Validator (aufsteigend) und inliegend nach Modus (Reihenfolge: Fehler, Warnung, Hinweis) sortiert.

Validator Frontend​

• Der Validator Service zeigt die Validatoren in der aufsteigenden Reihenfolge an. Es werden die Ergebnisse der Übersetzungsprüfung angezeigt. Dabei ist es möglich, dass Validatoren verschiedene Modi je Sprache haben.

Dokumentation​

• Das PVOG Testkonzept wurde für die Umstellung auf die Hochverfügbarkeit vorbereitet.
• Die Konverter Dokumentation wurde im Umgang mit Textmodul 08 in XZuFi 2.3.1 konkretisiert (Leistung.modulText zu Leistung.modulDokument).

Fixed​

Suchdienst Frontend​

• Im Impressum der servicesuche.bund.de wurde der Link zum Produktportal aktualisiert.
• Der Ort wurde aus der Suche der Hausnummern im Präzisierungsdialog entfernt.

Validator Backend​

• Validierungsstatistiken werden wieder nach 30 Tagen Zeitraum gelöscht.

Produktportal​

• Webfeeds werden korrekt angezeigt.

Deployments: PreProd/Stage am 16.09.2025, Produktion am 23.09.2025

Versionen: Sammlerdienst 7.7.0, Suchdienst Backend 11.5.0, Suchdienst Frontend 4.9.1, Validator Backend 8.4.0, Fachvalidator Library 12.6.0, Validator Frontend 6.4.1, Bereitstelldienst 6.14.0, Konverterdienst 1.4.0, Konverter Library 1.8.1

Add​

Suchdienst​

• Neue API veröffentlicht /v1/organisationunits/{oeId}/ars (API Beschreibung im Produktportal)
• Die Schnittstelle gibt eine Liste von Amtlichen Regionalschlüsseln (ARS) zurück, für die eine Organisationseinheit eine Leistung anbietet, welche im Leistungskatalog unter der angegebenen LeiKa-ID geführt wird.

Hochverfügbarkeit​

• Abschluss der Implementierung eines manuellen Smoketestes nach dem Deployment
• Die Bereitstelldienst-, Sammlerdienst- und Suchdienst-Health-Endpunkten wurden in Prometheus Metrik Werte überführt. Damit ist die zeitbasierte Überwachung möglich.

Change​

Produktportal​

• Auf der Seite UserGroup wurden die UserGroup Protokolle zum Download bereitgestellt.
• Einem Blogbeitrag können jetzt mehrere Tags zugewiesen werden.

Fixed​

Sammlerdienst​

• Der Validierungskontext für VAL0036 wurde erweitert (Validatorhandbuch).
• Fehler bei der Verarbeitung von alten Codelisten (2010, 2015, 2018) wurden behoben.

Validator-Service​

• Die Sprachprüfung für Validator VAL0036 wurde reaktiviert.

Deployments: PreProd/Stage am 26.08.2025, Produktion am 02.09.2025 

Versionen: Sammlerdienst 7.4.0, Suchdienst Backend 11.4.0, Suchdienst Frontend 4.9.0, Validator Backend 8.3.2, Fachvalidator Library 12.5.1, Validator Frontend 6.4.0, Bereitstelldienst 6.13.0, Konverterdienst 1.3.5, Konverter Library 1.8.0

Add​

Fachvalidator Library​

• Textmodulvalidator VAL0036 prüft, ob Leistung ODER Spezialisierung Module vom Typ Volltext mit Inhalt liefert (Validatorhandbuch). 

Sammlerdienst​

• Validator VAL0036 prüft bei PUSH ob Leistung ODER Spezialisierung Module vom Typ Volltext mit Inhalt liefert.

Validator Backend​

• Die Redaktionssystem-Konfiguration wird vom Sammlerdienst abgerufen. 

Suchdienst​

• Vollständige Unterstützung von Zugangskanälen in Leistungsmodulen und Spezialisierungen. 

Hochverfügbarkeit​

• Vorbereitende Einrichtung des Alertings im Kubernetes Cluster

Changed​

Dokumentation​

• Im Validatorhandbuch wurde der Modus der Validatoren VAL0036 (Hinweis), VAL0035 (Hinweis) und VAL0065 (Warnung) korrigiert.

Konverter Library​

• Die Mapping-Dokumentation des XZuFi-Konverters wurde mit einem Zeitstempel ergänzt. 

Fixed​

Fachvalidator Library​

• Anpassungen an VAL0030: modulUrsprungsportal und modulBegriffImKontext werden nicht geprüft, da hier auch in XZuFi 2.2.0 schon mehrere Module erlaubt waren (bei Ursprungsportalmodul für Mehrsprachigkeit erforderlich), stattdessen/zusätzlich wird nun "modulFachlicheFreigabe" geprüft.

Validator Frontend​

• Die Validierung von Typisierungen wurden vereinheitlicht.

Deployments: PreProd/Stage am 05.08.2025, Produktion am 12.08.2025

Versionen: Sammlerdienst 7.3.0, Suchdienst Backend 11.2.0, Suchdienst Frontend 4.8.0, Validator Backend 8.2.0, Fachvalidator Library 12.4.7, Validator Frontend 6.3.2, Bereitstelldienst 6.12.1, Konverterdienst 1.3.4, Konverter Library 1.7.0

Add​

Bereitstelldienst, Suchdienst Backend, Validator Backend, Sammlerdienst​

• Die Dokumentation der Endpunkte wird automatisch aus Swagger übernommen. Damit können Konzepte und Handbücher mit geringem Aufwand aktuell gehalten werden.

Produktportal​

• Das Helpdesk Formular wurde um ein Captcha erweitert.

Changed​

Konverter-Library​

• Das Mapping von Zugangskanälen und Leistungsmodulen wurde angepasst und dokumentiert.

Produktportal​

• Die Navigation Neuigkeiten enthält jetzt die Unterseiten zu Release Notes, Release Kalender, Blog, UserGroup und Web Feeds. Der Bereich Ressourcen enthält die PVOG APIs, Deprecations, Beta APIs, Roadmap und Zugang zum Helpdesk.

FIM Katalog​

• Die Dienste beziehen den FIM-Katalog unmittelbar vom FIM-Portal. Der letzte Download wird vorgehalten, wenn der nächste Abruf nicht funktionieren sollte.

Fixed​

Sammlerdienst​

• Kommunikationssystem und positionDarstellung werden bei XZuFi 2.3.1 Zustaendigkeiten (XZuFi 2.3.1 Schema ab Seite 119, Stand vom 1.7.2024) übernommen.

Suchdienst Backend​

• Name von EfA-Parameter (XZuFi 2.3.1) wird aus Code übernommen und wenn notwendig mit Sprach-Suffix versehen.

Deployments: PreProd/Stage am 21.07.2025, Produktion am 24.07.2025

Versionen: Suchdienst Backend 11.1.1, Sammlerdienst 7.2.0 mit Fachvalidator Library 12.4.6, Bereitstelldienst 6.11.3, Konverter Library 1.6.5

Add​

Validator Library​

• Für den Zugangskanal im XZuFi 2.3.1 Leistungsmodul wurde der Validator VAL0065 eingeführt. Das aktuelle Validatorhandbuch liegt auf dem Produktportal.

Suchdienst Backend​

• Folgende APIs wurden Deprecated gesetzt:

  • /v1/organisationunits/jzufi
  • /v2/servicedescriptions/jzufi
  • /v2/relations/{ars}/jzufi

• Die Übersicht der abgekündigten Endpunkte liegt auf dem Produktportal.

Sammlerdienst​

• Automatisches Wiederholen von abgebrochenen Importen wurde implemententiert

OpenCode​

• Versionsnummern der Komponenten werden im Kopf der ReleaseNote und als tag in openCode abgebildet.

Produktportal​

• Ein Anfrageformular wurde auf der Seite Helpdesk auf dem Produktportal intergriert .
• Auf der Seite Dienste/XZuFi-Konverter ist die Dokumention der Transformationsregeln für das Mapping von XZuFi 2.2 zu XZuFi 2.3.1 in openCode verlinkt.

Change​

• Die Sammlerdienst Architektur-Dokumentation wurde geprüft und aktualisiert.

Fixed​

Validator Library​

• VAL0052 Codelisten-Validator kann jetzt Codeslisten mit Länge >15 Zeichen verarbeiten.

Suchdienst Frontend​

• Verwandte Lebenslagen werden bei Deeplink Aufrufen mit geladen.

Sammlerdienst​

• Der Sammlerdienst erzeugt auch eine ZIP-Datei in der Gesamtbestandsvalidierung, wenn der Daten-Import ausgesetzt wurden.

Deployments: PreProd/Stage am 24.06.2025, Produktion am 30.06.2025

Versionen: Suchdienst Backend 11.0.3, Sammlerdienst 7.1.0, Bereitstelldienst 6.11.0, Fachvalidator Library 12.3.5, Konverter Library 1.6.1

Add​

Sammlerdienst​

• Der Sammlerdienst akzeptiert und verarbeitet jetzt XZuFi 2.3.1.
• Das Sammlerdienstkonzept für XZuFi 2.3.1 steht im Downloadbereich des Produktportals zur Verfügung.
• Implementieren der UebergeordnetesObjektKlasse am ZustaendigkeitTransferObjekt zum Identifizieren des Zuständigkeits-Typs.
• Description in der OpenAPI-Spezifikation um Hinweis zur Schnittstellenversionierung erweitert.

Suchdienst Backend​

• Der Suchdienst unterstützt jetzt die Verarbeitung von XZuFi 2.3.1 Daten.

• Daten im neuen XZuFi 2.3.1 Format werden in die bestehenden Modelle überführt, um eine Abwärtskompatibilität zu unseren Konsumenten zu gewährleisten.

• Neue JZuFi APIs bieten die Möglichkeit XZuFi Daten in beiden XZuFi Standards als JSON-Repräsentation zu laden. Dafür ist der Accept-Header-Parameter zu setzen. Siehe dazu auch die überarbeitete OpenAPI Dokumentation im Produktportal.

• Neue APIs

  • /v3/servicedescriptions/jzufi
  • /v2/organisationunits/jzufi
  • /v3/relations/{ars}/jzufi

• Description in der OpenAPI-Spezifikation um Hinweis zur Schnittstellenversionierung erweitert.

Bereitstelldienst​

• Bereitstellung einer Metrik für die Zugriffsstatistik nach XZuFi-Version.
• Erweiterung des Endpunktes bereitstelldienst/api/v2/verwaltungsobjekte zur optionalen Übertragung der gewünschten XZuFi-Version als Parameter.
• Verwenden der uebergeordnetesObjektKlasse aus XZuFi 2.3.1 zum Identifizieren des Zuständigkeit-Typs.
• Description in der OpenAPI-Spezifikation um Hinweis zur Schnittstellenversionierung erweitert.

Suchdienst Frontend​

• Fallback auf Gemeinde in der Ortsanzeige bei ARS-Auflösung via BKG.
• Erlaubt im Rahmen der von xZuFi 2.3 eingeführten Zugangskanäle duplizierte Modul-Codes.

Fix​

Suchdienst Frontend​

• Security: Behebt Schwachstelle CVE-2025-32997.
• Security: Behebung der Schwachstelle CVE-2025-27789.
• Hinweis auf Verlassen der Vertrauensdomäne taucht bei bestimmten Links nicht auf.
• Rendering der (Detail)- Modulblöcke überarbeitet.
• Ortsnamen auf 50 Zeichen begrenzt.

Removed​

Suchdienst Backend​

• Die abgekündigte Schnittstelle /suchdienst/v4/organisationunits/detail wurde entfernt.

Deployment in Produktion am 29.04.2025

Add​

Sammlerdienst Backend​

• Der Sammlerdienst ist in der Lage, parallel XZuFi 2.2 und 2.3.1 Daten zu verarbeiten.

Validator Service​

• Erweiterung der Validator Benutzer um die API-Funktionalität.

Changed​

Dokumentation​

• In den veröffentlichten Dokumenten wurde die "alte" Bezeichnung Leistungsbeschreibung durch Leistung ersetzt:

  1. Anbindungsanleitung des Bereitstelldienstes,
  2. XZuFi Validator Handbuch,
  3. Konzept Online Gateway Sammlerdienst,
  4. Konzept Online Gateway Suchdienst

• Der FIM-Katalog Downloader wurde auf allen PVOG Umgebungen separat realisiert.

Fixed​

Suchdienst Backend​

• Auch an den Locations-Endpunkten ist jetzt die Abfrage mit Ortsnamen von maximal 70 Zeichen möglich.

  suchdienst/api/v3/locations/suggestions

  suchdienst/api/v3/locations/details

Deployment in Produktion am 08.04.2025

Add​

Sammlerdienst Backend​

• Der Zerteiler verarbeitet XZuFi 2.3.1.
• DeltaDetektor und PushVerarbeiter verarbeiten XZuFi-Version 2.3.1.

XZuFi-Konverter​

• Während der Konvertierung aufgetretene Änderungen im XZuFi-Dokument werden als Protokoll ausgegeben. 
• Die Konverter API wurde veröffentlicht. (/api/konverter/portalverbund-konverter-rest-api) 

Produktportal​

• Auf dem Produktportal wurde ein Glossar ergänzt.

Change​

XZuFi-Konverter​

• Die openCode-Dokumentation wurde in der README um Einbindungsinformationen erweitert.

Validator​

• VAL0011 wurde angepaßt, um sms, callto und skype im Auskunftshinweismodul zu verarbeiten.

Produktportal​

• Das Produktportal hat ein neues Design bekommen.

Fix​

Suchdienst Backend​

• Der FIM-Katalog Downloader funktioniert auch mit doppelten Leistungsschlüsseln im FIM-Katalog.

Suchdienst Frontend​

• Die Begrenzung der Ortsnamen wurde auf 70 Zeichen erweitert.
• Die Ausgabe von Links mit Leerzeichen am Ende wurde korrigiert.

Deployment in Produktion am 18.03.2025

Add​

Sammlerdienst​

• Zur Vorbereitung der parallelen Verarbeitung von XZuFi 2.2 und XZuFi 2.3.1 Daten wurde die Datenhaltung erweitert. Damit kann pro Datensatz die XZuFi Version festgelegt werden.

• Zusätzlich zum Anlegen und Ändern von Push-Datensätzen wird das Löschen von Datensätzen geloggt.

Suchdienst Frontend​

• Bei der Ortspräzisierung werden nur Suchergebnisse im Feld Hausnummer angezeigt, wenn diese zur Ermittlung des korrekten Regionalschlüssels notwendig sind.

Changed​

Bereitstelldienst​

• Die Dokumentation des Anbindungsleitfadens Bereitstelldienstes wurde um den Abruf von XZuFi 2.3.1 Daten erweitert.

Fixed​

Suchdienst Frontend​

• Der Präzisierungsdialog ist nun scrollbar. Damit wird die mobile Ansicht des Suchclients optimiert.

Validator Service​

• Das Herunterladen von großen Reports aus dem Validator Frontend ist als Zip-Datei umgesetzt.

Deployment in Produktion am 25.02.2025

Add​

Bereitstelldienst​

• Der Export des Datenbestandes auch in XZuFi-Version 2.3.1 wurde ermöglicht.
• Eine Import-Verarbeitung von XZuFi 2.3.1 für Testzwecke ist realisiert. 

Validator Frontend​

• Die parallele Verarbeitung für XZuFi 2.2. und XZuFi 2.3.1 Daten ist umgesetzt.  

Validator Backend​

• Es ist die Verarbeitung vom XZuFi 2.3.1 Dateien in der Validator API möglich.
• Der Fachvalidator wurde auf OpenCode.de veröffentlicht (Siehe Blogbeitrag).

Changed​

Konverter Library​

• Die Verarbeitung von PV-Schema für XZuFi 2.3.1 ist ergänzt.

Dokumentation​

• Im Validatorhandbuch wurden Informationen zu XZuFi 2.3.1 ergänzt.

Validator Backend​

• Der FIM-Katalog wird vom neuen FIM-Portal heruntergeladen. 

Fixed​

Suchdienst Frontend​

• Ein inkorrektes Verhalten beim Ortswechsel mit bereits ausgewählter Leistung wurde behoben.
• Der Präzisierungsdialog bei der Ortssuche zeigt Fehlermeldungen an, falls der Ort nicht bekannt ist.

Validator Frontend​

• Eine Meldung weist auf die fehlende Schemeagency ID bei der Validierung hin.