Suchdienst-Backend​

• Die Protokollierung der Suchdienst-APIs-Zugriffe wurde erweitert. Es können jetzt die aufgerufene Schnittstelle (z. B. der Pfad /v2/locations), die Teilnehmer-Kennung (Client-ID), die IP-Adresse des anfragenden Systems, der Zeitpunkt der Abfrage, das verwendete Programm (UserAgent) und der Status Code der Anfrage ausgewertet werden.

Dokumentation​

• Die Anwenderdokumente (Sammlerdienst Konzept, Bereitstelldienst Konzept, Bereitstelldienst Anbindungsanleitung, Suchdienst Konzept, Validator Handbuch) sind jetzt unter docs.fitko.de erreichbar und werden nun über OpenCode gepflegt.

Changed​

Validator Backend​

• Der VAL0023 wurde dahingehend korrigiert, dass er nur noch die Attribute von languageCode prüft.

Validator Service​

• Die Validatorstatistik wurde verbessert. Der CSV-Export enthält jetzt Spaltenüberschriften.
• Die Bezeichnungen in der Validatorstatistik wurden überarbeitet: Die "tägliche" Validierung heißt nun "nächtlich".
• Fehlerhafte Zuordnungen bei der Push-Validierung ("Sofort" und "Nächtlich") wurden korrigiert.
• Im Beschreibungstext des Validatorhandbuchs wurden Anpassungen zum Pull- und Pushverfahren vorgenommen.

Produktportal​

• Auf der Seite Produktportal/Dienste/Umgebungen wurden Links zu den Suchdienst-APIs beider Umgebungen hinzugefügt.

Infrastruktur​

• Die Stage Umgebung wurde auf den Ingress-Controller traefik umgestellt. Diese Umstellung war aufgrund der ngnix Abkündigung notwendig.

Fixed​

Validator-Backend​

• Die Validierungsregel von VAL0065 wurde für "BegriffImKontext" und "Ursprungsportal" um Mehrsprachigkeit erweitert. Der Validator, bzw. die neuen Validierungsregeln sind vorerst weiterhin im Warnungsmodus.

Bereitstelldienst​

• Als abgeleitete Maßnahme aus dem Last- und Performancetest wurde die Recoveryzeit angepasst. Laufende Abfragen werden nun erst zu einem späteren Zeitpunkt unterbrochen.

Versionen: Sammlerdienst 7.19.0, Suchdienst Backend 11.16.0, Suchdienst Frontend 4.15.0, Validator Backend 8.13.2, Fachvalidator Library 13.3.3, Validator Frontend 6.11.1, Bereitstelldienst 6.21.0, Konverterdienst 1.8.1, Konverter Library 1.16.4

Add​

Suchdienst Backend​

• Die Such API wurde modernisiert und um den neuen Endpunkt /v8beta1/servicedescriptions ergänzt, der Zugangskanäle (XZuFi 2.3.1) berücksichtigt. Dabei wurde der Endpunkt im In- und Outputmodell deutlich verschlankt. Weitere Details erhalten Sie zeitnah in einem Blogbeitrag.

Suchclient​

• Der Suchclient (Stage: preprod.servicesuche.bund.de bzw. Prod: servicesuche.bund.de ) wurde an v8beta1/servicedescriptions angebunden.

Sammlerdienst​

• Zum Monitoring der Verfügbarkeit von XRepository und FIM-Leistungskatalog wurden Anpassungen an internen Endpunkten vorgenommen.

openCode​

• Der Quellcode des Backoffices wurde auf openCode abgelegt. 

Infrastruktur​

• Es wurden erste Anpassungen an der bestehenden Infrastruktur vorgenommen, um ein PVOG Release auf openCode zu bauen.

Changed​

Suchdienst Backend​

• Als Ergebnis des Last- und Performancetestes wurde die Suchdienst Warteschlange optimiert. Gleichzeitige Importe werden schneller verarbeitet. 
• Bei der Orte Schnittstelle wurde in der Vorschlagssuche v3/locations/suggestions der Ort vorangestellt. Das erleichtert für Nutzer die Suche nach Orten, in denen Ortsteile die gleiche ARS aufweisen. 
• Es wurde der HK-DE Datensatz 2026 eingespielt.

Dokumentation​

• Die Aufwertung der Stage-Umgebung wird in der Dokumentation (Anbindungsanleitung, Konzepte) vollständig umgesetzt. Die Dokumente stehen unter Downloads zur Verfügung.

Produktportal​

• Die Aufwertung der Stage-Umgebung wird auf dem Produktportal abgebildet, alle Verweise auf die Demo Umgebung wurden entfernt und überarbeitet.
• Die neue Seite Umgebungen wurde angelegt und enthält u.a. Verlinkungen auf die Swagger Benutzeroberfläche der Suchdienst REST-APIs.
• Die Roadmap auf der Startseite des Produktportals ist aktualisiert.
• Informationen zum Suchclient wurden auf der Seite des Suchdienstes ergänzt.

Fix​

Sicherheit​

• Durch Updates der Infrastruktur wurden kritische Schwachstellen behoben.

Backoffice (9.21.1)​

• Die unterstützende Funktionalität zur gezielten Objektsuche (Fehleranalyse) in Redaktionssystemen bzw. dem Sammlerdienst wurde wieder hergestellt.

Add​

Produktportal & Frontends​

• Zur Stärkung des Wiedererkennungswerts und des Vertrauens in die Plattform wurde die offizielle Dachmarke der deutschen Verwaltung (Vorgabe des IT-Planungsrats) integriert. Die standardisierte Kopfzeile (basierend auf der Kern-Dachmarken-Komponente) wurde im Produktportal, im Client des Suchdienstes sowie im Validator-Frontend implementiert.

Changed​

Dokumentation​

• Die technische Dokumentation wurde konsolidiert: Automatisch generierte Schnittstellen-Konzepte für den Sammlerdienst, Suchdienst, Bereitstelldienst und Validator wurden entfernt. Die Konzepte verweisen nun direkt auf die OpenAPI-Dokumentation im Produktportal.
• Das Validator-Handbuch wurde um spezifische Regelungen für die Push-Schnittstelle erweitert. In der zentralen Übersichtstabelle (Kapitel 3.4) wurde eine Spalte für den Ausführungsstatus bei Push-Importen ergänzt. Funktionale Abweichungen (z. B. bei VAL0006 für Löschoperationen) sind nun explizit als „Besonderheit Push“ markiert.

Suchdienst Backend​

• In den API-Beschreibungen (z. B. für den Suchdienst Endpunkt /v3/locations) wurde die Beschreibung des Parameters q von „Ort“ auf „SpezifischerStandort (bevorzugt Ort/Ortsteil oder PLZ)“ angepasst. Ein ergänzender Hinweis zur mangelnden Eindeutigkeit reiner Stadtnamen in einzelnen Bundesländern wurde hinzugefügt.
• Das Suchdienstkonzept wurde entsprechend überarbeitet (Ersetzung des Begriffs „Ort“ durch „Ort/Ortsteil/PLZ“).

Suchdienst Frontend (Suchclient)​

• Bessere Berücksichtigung des regional unterschiedlichen Sprachgebrauchs bei der Ortssuche: Der Platzhaltertext im Eingabefeld wurde auf „PLZ oder Ort/Ortsteil eingeben“ angepasst und sämtliche GUI-Labels verwenden nun konsistent die Bezeichnung „Ort/Ortsteil“.
• Die Fehlermeldung „Ort unbekannt“ wurde durch die nutzerfreundlichere Formulierung „Leider konnten wir den von Ihnen eingegebenen Ort nicht finden.“ ersetzt, ergänzt um den Hilfetext: „Bitte versuchen Sie es mit der Eingabe des Ortsteils oder der Postleitzahl (PLZ).“

Validator Service​

• Der Reiter „Info“ im Validator Service wurde funktional erweitert: Für jeden aktiven Validator wird nun neben dem Modus auch der spezifische Prüfzeitpunkt für Push-Nachrichten dargestellt. Die Bezeichnungen der Validierungszeitpunkte wurden optimiert, um die Abgrenzung zwischen sofortiger Synchronprüfung und asynchronen/täglichen Prüfungen klarer zu vermitteln.

Schnittstellen / Fehler-Handling​

• Die Rückmeldungen des Systems bei fehlerhaften API-Anfragen wurden präzisiert, um Entwicklern und angeschlossenen Clients eine schnellere und eindeutigere Fehlerdiagnose zu ermöglichen.

Fixed​

Validator Backend (Fachvalidator Library)​

• Die HTML-Prüfung wurde so angepasst, dass die Elemente OnlinedienstParameterIndividuell und OnlinedienstParameterEfA von der restriktiven Tag-Prüfung ausgenommen sind. Diese lassen nun gemäß XZuFi-Spezifikation (ab Version 2.3) beliebige HTML-Strukturen fehlerfrei zu.

PVOG Datentransfer​

• Es wurde ein Fehler behoben, durch den fehlerhafte oder unvollständige Anfragen fälschlicherweise an das BKG (Bundesamt für Kartographie und Geodäsie) weitergeleitet wurden. Diese Anfragen werden nun bereits im PVOG korrekt abgefangen und abgewiesen.

Add​

Sammlerdienst​

• Die Serverlogs sind nach der Redaktionssystem ID oder Name des Redaktionssystems sortierbar.

openCode​

• Das Validator Frontend wurde auf openCode (https://gitlab.opencode.de/fitko/fim/xzufi-validator-frontend) veröffentlicht. 

Changed​

Suchdienst Backend​

• Die Funktionalität der Schnittstelle /v7/servicedescriptions/{ars} wurde präziser dokumentiert. Für fachlich korrekte Treffer sollte nur nach dem ARS von Gemeinden gesucht werden.
• Beim Import und in der nächtlichen Gesamtbestandvalidierung werden nur noch Anfragen zum BKG weitergeleitet, die ein gefülltes Feld PLZ enthalten.

Sammlerdienst​

• Push-Nachrichten dürfen nur noch ein SchreibeObjekt oder ein LoescheObjekt beinhalten. Nachrichten mit mehreren Objekten werden vom Sammlerdienst nicht mehr angenommen.

Produktportal​

• Die OpenAPI Dokumentation auf dem Produktportal ist mit der Produktivumgebung verknüpft (PVOG APIs | PVOG Produktportal).

Fixed​

Security​

• Behebung diverser Schwachstellen mit dem Update auf Spring Boot Tomcat Version 4.0.7. 
• Das bisher eingeschränkt mögliche Cross-Origin Resource Sharing am Suchdienst Backend wurde vollständig unterbunden.

Versionen: Sammlerdienst 7.15.0, Suchdienst Backend 11.14.0, Suchdienst Frontend 4.13.3, Validator Backend 8.12.3, Fachvalidator Library 13.2.0, Validator Frontend 6.8.2, Bereitstelldienst 6.19.0, Konverterdienst 1.7.1, Konverter Library 1.16.0

Add​

OpenCode​

• Das Backend des XZufi-Konverters wurde auf openCode veröffentlicht.
• Das Validator-Backend wurde auf openCode veröffentlicht.

Produktportal​

• Für die Beantragung eines Bereitstelldienst Zugangs wurde der Prozess und das Formular auf dem Produktportal veröffentlicht.

Changed​

OpenCode​

• Die README-Datei des Sammlerdienstes wurde zur besseren Nutzbarkeit mit der Template-Vorgabe vereinheitlicht (openCode Sammlerdienst).
• Die README-Datei des Bereitstelldienstes wurde zur besseren Nutzbarkeit mit der Template-Vorgabe vereinheitlicht (openCode Bereitstelldienst) .

Suchdienst​

• Die abgekündigten API-Endpunkte wurden entfernt:

  • /v1/organisationunits/jzufi wird ersetzt durch /v2/organisationunits/jzufi und darauffolgend /v1/organisationunits/:id/jzufi-2-2 bzw. /v1/organisationunits/:id/jzufi-2-3.
  • /v2/servicedescriptions/jzufi wird ersetzt durch /v3/servicedescriptions/jzufi und darauffolgend /v1/servicedescriptions/:id/jzufi-2-2 bzw. /v1/servicedescriptions/:id/jzufi-2-3.
  • /v2/relations/{ars}/jzufi wird ersetzt durch /v3/relations/:ars/jzufi und darauffolgend /v1/relations/jzufi-2-2 bzw. /v1/relations/jzufi-2-3.

• Die automatische Aktualisierung der Gemeinden(ARS)-Liste aus dem XRepository urn🇩🇪bund:destatis:bevoelkerungsstatistik:schluessel:rs wurde implementiert.

Validator​

• Folgende abgekündigte Endpunkte wurden endgültig entfernt:

  • /v5/validiere und
  • /v1/{redsyscode}/redsyskonfig.

• Die aktuellen Endpunkte sind auf dem Produktportal beschrieben.

Konverter​

• Automatisierung des monatlichen Reports für den XZuFi-2.3.1-Rollout-Verantwortlichen zu Informationsverlusten bei der Konvertierung von XZuFi 2.3.1 nach 2.2 . Ziel des Reports ist das Abschätzen der Risiken bei einer Abwärtskonvertierung.

Fixed​

Bereitstelldienst​

• Die Beschreibung des Endpunktes /v3/verwaltungsobjekte wurde ergänzt.

Suchdienst Backend​

• Auf der Detailseite zur Leistung werden Formular-Links jetzt entsprechend der angefragten Sprache ausgeliefert.
• Die zugrundeliegende Datenbasis (Postleitzahlen/ARS) für die abgekündigten Schnittstellen /v2/locations und /v2/locations/suggestions wurde aktualisiert.

Suchdienst Frontend​

• Die Detailansicht der Leistung im Suchclient nutzt den Endpunkt v6/servicedescriptions/:lbid/detail.

Konverter​

• Behebung von Verarbeitungsfehlern bei der Abwärtskonvertierung von XZuFi Version 2.3.1 auf 2.2.0: Lange Textinhalte mit kombinierten diakritischen Zeichen oder Emojis führen nicht mehr zu Anwendungsabbrüchen.

Sicherheit​

• Zur Behebung der Schwachstellen in CVE-2026-9256 wurde nginx auf 1.31.1 angehoben.

Versionen: Sammlerdienst 7.14.1, Suchdienst Backend 11.13.0, Suchdienst Frontend 4.13.3, Validator Backend 8.11.0, Fachvalidator Library 13.1.1, Validator Frontend 6.7.1, Bereitstelldienst 6.18.1, Konverterdienst 1.6.6, Konverter Library 1.15.2

Add​

Last- und Performance-Test​

• Im Rahmen eines Last- und Performance-Tests wurde die Infrastruktur unter Peak- und Dauerlast gesetzt, um Optimierungspotenzial zu identifizieren.

OpenCode​

• Es wurden weitere funktionale Bausteine (Bibliotheken) des Portalverbund Online-Gateways (PVOG) auf openCode veröffentlicht:

  • pv_schema
  • pv_schema_annotations
  • pv_antivirus
  • pv_testdatengenerator
  • pv_externaldownloader
  • pv_frontendconfig

Changed​

Bereitstelldienst​

• Der Endpunkt /v2/verwaltungsobjekte liefert nur noch XZuFi 2.3.1 aus und wird als deprecated markiert (siehe Produktportal/Ressourcen/Deprecations).
• Bereitstelldienst-Nutzer müssen spätestens ab November 2026 auf den neuen Endpunkt /v3/verwaltungsobjekte/xzufi-2-3-1 umstellen.

Validator Backend​

• Fehlerhafte Protokolle und Archive werden nach 24 Stunden automatisch entfernt.
• Manuelle Validierungen der User werden durch automatisierte Validierungen nicht mehr blockiert.
• Die Fehlermeldungen der technischen Validierungen wurden vereinfacht und im Validatorhandbuch Kapitel 3.1. Technische Validierung ausführlicher erläutert.

Suchdienst Backend​

• Der Endpunkt v6/servicedescriptions/{lbid}/detail wurde produktiv gesetzt. Es gab folgende Anpassungen im Vergleich zu /v6beta3/servicedescriptions/{lbid}/detail:

  • Der Such-Parameter validDate entfällt, es wird automatisch mit dem aktuellen Zeitstempel gesucht.
  • Der Such-Parameter applyDynamicParams entfällt, es werden automatisch die dynamischen Parameter angewandt.

• Folgende Location-Endpunkte wurden als deprecated markiert und werden zum November 2026 entfernt (siehe Produktportal/Ressourcen/Deprecations):

  • /v2/locations/suggestions
  • /v2/locations

Sammlerdienst​

• Die Sammlerdienst URL /sammlerdienst-1/api wurde abgeschaltet. Die Sammlerdienst Schnittstelle ist für authentifizierte Nutzer über https://stage.pvog.fitko.net/sammlerdienst/api/v1/push erreichbar.

Fixed​

Suchdienst Backend​

• Ein Bearbeitungskonflikt beim Neuberechnen der Verwaltungsleistungen wurde behoben.
• Für die korrekte Anzeige vorberechneter Verwaltungsleistungen wurde die Gemeindeverzeichnis-Datei aktualisiert.

Validator Backend​

• Der Download des FIM Leistungskataloges wurde zeitlich optimiert.

Bereitstelldienst​

• Aktualisierung der Schnittstellendokumentation (Release 9.17.5)

Sicherheit​

• Auf Testservern – ohne externen Zugriff – wurde für interne Zugriffe ein Passwortschutz für Redaktionssysteme eingerichtet.

• Redis Security Hotfix auf Version 8.6.3 (Release 9.17.6)

Versionen: Sammlerdienst 7.14.0, Suchdienst Backend 11.12.0, Suchdienst Frontend 4.12.0, Validator Backend 8.10.0, Fachvalidator Library 13.0.1, Validator Frontend 6.7.0, Bereitstelldienst 6.17.5, Konverterdienst 1.6.5, Konverter Library 1.15.1

Add​

Suchdienst Backend​

• Die Orte-BKG Endpunkten suchdienst/api/v3/locations\, suchdienst/api/v3/locations/details\ und suchdienst/api/v3/locations/ars\ liefern zusätzlich auch die Geokoordinaten (Längen- und Breitengrad).

OpenCode​

• Der Quellcode des Sammlerdienstes liegt auf openCode.

Changed​

Suchdienst Frontend​

• Die Links in Organisationseinheiten werden mit dem Darstellungstext aus dem XZuFi-Feld "kennungzusatz" angezeigt, sofern dieser geliefert wird. Ist "kennungzusatz" nicht vorhanden, wird der Link dargestellt.
• Bei Leistungen werden die erforderlichen Unterlagen separat (statt unter Dokumente) dargestellt.

Suchdienst Backend​

• Der Endpunkt `/v1beta2/onlineservices/{odId}/organisations` liegt aktualisiert vor. Es wurde die Rolle "UNBESTIMMT" zu "UNKNOWN" umbenannt. (Blogbeitrag zur Beta API).
• Es gibt neue JZuFi-Endpunkte mit expliziter XZuFi-Version als Bestandteil des Pfades. So werden Probleme beim Generieren von clientseitigem Code aus der Suchdienst-API-Spezifikation behoben. Ein Beispiel dafür ist `v1/servicedescriptions{id}/jzufi-2-3`.

Validator Frontend​

• Im Reiter 'Weitere Informationen' ergänzen die ValidatorIds (z.B. VAL0001) die Beschreibungen.
• Der Modus eines einzelnen Validators wird mit Hinweis, Warnung, Fehler benannt.

Konverter Library​

• In der Konvertierung XZuFi 2.3.1 zu XZuFi 2.2 wurde ergänzt, dass "Leistung.modulDokument (2.3.1)" zu "Leistung.modulText (Code 08): erforderliche Unterlagen (2.2)" umgewandelt wird, selbst wenn bereits ein Dokumentmodul existiert. Die Inhalte beider 2.2-Module werden dann in dem konvertierten 2.3.1-Dokumentmodul kombiniert.

OpenCode​

• Ein README Template schafft eine kurze und strukturierte Darstellung der PVOG Komponenten, damit externe Nachnutzende schnell die benötigten Informationen finden.

Fixed​

Fachvalidator​

• Der Validator VAL0033 wurde so korrigiert, dass jetzt auch URIs (z.B. HTTP-Links) abgelehnt werden, die Leerzeichen innerhalb der URI enthalten.

Konverter Library​

• Bei der Konvertierung XZuFi 2.3.1 zu 2.2 werden DestinationSignature-IDs aus idSekundaer übernommen, wenn keine Kommunikationssysteme mit DestinationSignature-IDs definiert sind.

Sammlerdienst (ab 9.16.3)​

• Konfigurationsanpassung: Pushnachrichten können mit einer Größe von max. 5 MB statt bisher 1 MB verarbeitet werden.

Versionen: Sammlerdienst 7.13.0, Suchdienst Backend 11.11.0, Suchdienst Frontend 4.11.3, Validator Backend 8.9.2, Fachvalidator Library 12.8.2, Validator Frontend 6.6.0, Bereitstelldienst 6.17.4, Konverterdienst 1.6.4, Konverter Library 1.14.2

Add​

Suchdienst​

• Zum 01.08.2026 werden die Suchdienst-Endpunkte über pvog.fitko.de abgeschaltet. Zur Information der Nutzer dieser APIs, wird ein Hinweis in der Swagger Dokumentation angezeigt.
• Der neue Beta-Endpunkt /v1beta1/onlineservices/{odId}/organisations gibt die Organisationseinheiten, die für einen Onlinedienst zuständig sind zurück.
• Der neue Beta-Endpunkt /v1beta1/onlineservices liefert alle Onlinedienste auf der angefragten ARS Basis.

OpenCode​

• Der Quellcode des Produktportals liegt auf openCode.

Changed​

Suchdienst​

• Die Endpunkte des Suchdienstes, die den ARS über den BKG Service ermitteln (https://produktportal.pvog.fitko.de/api/suchdienst/orte-bkg/), nutzen statt der bisherigen Datengrundlage gdz_geokodierung, neu die Datengrundlage gdz_geokodierung_bund.

Konverter​

• Bei der Konvertierung der Daten zwischen XZuFi 2.2 und XZuFi 2.3.1 wird die destinationSignature nach den Konvertierungsregeln ausgegeben.
• Die Mappingtabelle des Konverters auf openCode ist aktualisiert.

Produktportal​

• Die Erklärung zur Barrierefreiheit des Produktportals wurde aktualisiert.

EfA Parametrisierungsportal (nicht Teil des PVOG)​

• Die Swagger Dokumentation wurde für die Nutzenden vervollständigt und aktualisiert.

Fixed​

Konverter​

• Ein Fehler in der Darstellung der Beschreibungstexte in OpenCode wurde aktualisiert.

Add​

Suchdienst​

• Zur Auswertung der mitgesandten API Keys wurden die Logs der Suchdienst Anfragen erweitert.
• Für die Nutzer der Suchdienst APIs unter pvog.fitko.de wurde nach dem Domainumzug auf pvog.fitko.net eine Weiterleitung eingerichtet, damit auch weiterhin Daten aus der Produktivumgebung des PVOG abgerufen werden können.
• Nutzer der Suchdienst APIs unter pvog.fitko.de werden über das Feld X-Deprecated-Domain im Header zum Abschalttermin 01.08.2026 informiert.

Suchclient​

• Die BSI-Konformität der Content Security Policy (CSP) wurde verbessert.

Validator​

• Für die Fortschrittsanzeige der Validierung im Validator Service und an der Validator API wurde ein zusätzlicher Status STUCK eingefügt.

OpenCode​

• Der Code des Bereitstelldienstes wurde auf OpenCode veröffentlicht.
• Zur besseren Nutzbarkeit wurden die publiccode.yml Dateien des PVOG Projektes vereinheitlicht.

Changed​

Sammlerdienst​

• Anpassung der Sammlerdienst Schnittstelle von /sammlerdienst-1/api zu /sammlerdienst/api.

Suchdienst​

• Die Endpunkte zur Ortssuche auf der Basis der BKG Geodaten nutzen jetzt die Datengrundlage gdz_geokodierung_bund. Damit sollen Aktualisierungen im BKG Service schneller verfügbar sein.

  Achtung! Abweichend zu den obigen Releaseterminen wurde diese Änderung zum Testen am 19.02. auf Demo und am 26.02. auf PreProd vorgenommen.

Fixed​

Sammlerdienst​

• Bei der Zusendung einer falschen SchemeAgency in der Berechtigung für ein Redaktionssystem wird die Zugriffsverweigerung mit einem 403 Fehler beantwortet.

Suchdienst​

• In Erweiterung der v6beta3/servicedescriptions/ wird die Beschreibung des Onlinedienstes für Onlinedienst-Links ohne Beschreibung übertragen.

Suchclient​

• Weitere Werte der Codeliste 'Kommunikationskanal / Erreichbarkeit' werden nun als Text-Element bei der Organisationseinheit dargestellt.

Versionen: Sammlerdienst 7.11.0, Suchdienst Backend 11.9.0, Suchdienst Frontend 4.10.8, Validator Backend 8.5.1, Fachvalidator Library 12.7.11, Validator Frontend 6.4.2, Bereitstelldienst 6.16.2, Konverterdienst 1.5.3, Konverter Library 1.11.7

Add​

Produktportal​

• Für die Messbarkeit des Nutzendenverhaltens auf dem Produktportal wurde Matomo implementiert. Dadurch können Probleme im Produktportal besser identifiziert und Neuigkeiten und Wartungsmeldungen gezielter geschaltet werden. Informationen hierzu und die Möglichkeit des Widerspruchs finden sich in der Datenschutzerklärung.
• Nutzbare dynamische Parameter wurden auf dem Produktportal veröffentlicht. Zum einen wurden die Beschreibungen der APIs angepasst (z.B. hier), zum anderen wurde im Suchdienst Konzept (Produktportal) ein neuer Abschnitt zu dynamischen Parametern ergänzt.

OpenCode​

• Der Quellcode des Suchdienstes wurde auf openCode veröffentlicht.
• Der Quellcode des EfA Parametrisierungsportals (EPP) wurde auf openCode veröffentlicht.

EfA Parametrisierungsportal​

• Eine zweite Instanz des EPP wurde bereitgestellt.

Changed​

Sammlerdienst​

• Bei Clients im Push Verfahren wird die in den übermittelten Daten verwendete SchemeAgencyID (einzigartige ID jedes Redaktionssystems) auf Gültigkeit geprüft. Dies soll verhindern, dass im Fehlerfall Daten eines anderen Bundeslandes überschrieben werden.

Suchclient​

• Links auf den Suchclient, die Text an die Domain angehängt haben, werden auf die URL des Suchclients weitergeleitet. So lässt sich z.B. https://servicesuche.bund.de/beispielinhalt öffnen, geht dann aber auf https://servicesuche.bund.de/, damit potentiell angehängte Inhalte nicht für Inhalte des PVOG oder des Suchclients gehalten werden.

Fixed​

Validator​

• Es wurde ein Fehler behoben, bei dem der technische Validator bei großen XML-Dateien abgestürzt ist.
• Ein Problem, bei dem die manuelle Validierung beim Start hängt, wurde behoben.

EfA Parametrisierungsportal​

• Falsche Fehlermeldungen bei der Nutzung von Endpunkten des EPP wurden korrigiert.

Suchclient​

• Es wurde ein Problem behoben, bei dem Formulare nach der Umstellung auf XZuFi 2.3.1 teilweise nicht mehr dargestellt werden konnten.

Versionen: Sammlerdienst 7.10.1, Suchdienst Backend 11.8.3, Suchdienst Frontend 4.10.7, Validator Backend 8.5.1, Fachvalidator Library 12.7.9, Validator Frontend 6.4.2, Bereitstelldienst 6.16.1, Konverterdienst 1.5.2, Konverter Library 1.11.5

Add​

EfA Parametrisierungsportal​

• Es wurden Actuator-Endpunkte im Backend ergänzt.

Produktportal​

• Der Downloadbereichs des Produktportals wurde überarbeitet.

  • Das Sammlerdienst-Konzept, Validatorhandbuch, Bereitstelldienst-Konzept, Suchdienst-Konzept und die Bereitstelldienst-Anbindungsanleitung sind nun im Downloadbereich direkt aufrufbar und können heruntergeladen werden.

• Vorbereitende Maßnahmen für den Umzug des Produktportals auf die Produktivumgebung wurden umgesetzt.

Hochverfügbarkeit​

• Ausstehende Tests für die Hochverfügbarkeit wurden abgeschlossen.

Suchdienst​

• Die Möglichkeit zur Nutzung von API Keys wurde eingerichtet. Details hierzu finden Sie im Produktportal über den Link.

Changed​

Sammlerdienst​

• Der Konsistenzprüfer beachtet vor Ausführung der Konsistenzprüfung den Status der Konsumenten (Bereitstelldienst und Suchdienst). Wenn die Konsumenten noch mit der Verarbeitung neuer Daten beschäftigt sind, wird die Konsistenzprüfung später durchgeführt.

Suchdienst​

• Die Swagger Dokumentationen aller Endpunkte wurden um die Information welche XZuFi Version ausgeben wird und ob bei der Ausgabe ggf. eine Konvertierung vorgenommen wird, ergänzt.

Fixed​

Suchdienst​

• Die Spezifikation ist wieder konform zu openapi-generator. Der Bug mit der Kategorieklasse wurde behoben. Betroffen waren die JZuFi Endpunkte mit XZuFi 2.3.1 Unterstützung.
• Die Sicherheitslücke CVE-2025-15284 wurde behoben.
• Die Sicherheitslücke CVE-2025-68154 wurde behoben.

Add​

Validator Backend​

• Lastverteilung von CPU-Workloads über Redisson.

Konverterdienst​

• Informationsverluste bei der Konvertierung 2.3 nach 2.2 werden als Prometheus-Metrik veröffentlicht.

Fixed​

Sammlerdienst​

• Der Sammlerdienst nimmt erst nach der Intialisierungsphase Traffic an.
• Fehlendes Element Klasse in einer Lösche-Nachricht führt zu einer "Nullpointer Exeption".

EfA Parametrisierungsportal​

• Der GET /onlinedienstparameter/{sprache}/{leistungsschluessel}/{ars}{}-Endpunkt gibt nicht alle Parameter zurück.
• Für den Endpunkt PUT /profile/id, jeder Wert im Feld Status ergibt HTTP 422.

Versionen: Sammlerdienst 7.9.2, Suchdienst Backend 11.7.3, Suchdienst Frontend 4.10.3, Validator Backend 8.6.2, Fachvalidator Library 12.7.4, Validator Frontend 6.4.6, Bereitstelldienst 6.15.2, Konverterdienst 1.4.4, Konverter Library 1.9.4

Add​

EfA Parametrisierungsportal​

• Für die Tester des Portals wurde die Authentifizierung und Autorisierung implementiert.
• Endpunkte und Modelle wurden für den testenden Personenkreis im Swagger dokumentiert.

Last- und Performancetest​

• Vorbereitung einer Testumgebung für die Erstellung von Testfällen.

Produktportal​

• Unter Dienste / Bereitstelldienst wurden FAQ ergänzt.
• Unter Dokumentation / FAQ wurden FAQ ergänzt.
• Unter Neuigkeiten / Sprint Review sind die Präsentationen des Sprint Reviews als Download einsehbar.

Hochverfügbarkeit​

• Der Aufbau und die Voraussetzungen für die Testbarkeit des PVOG in der hochverfügbaren Umgebung wurden abgeschlossen.

Changed​

Validator Backend​

• Für die Eindeutigkeit der Redaktionssysteme sollen bei der Validierung zukünftig die SchemeAgencyID anstatt der Länderkürzel verwendet werden. Es wurden neue Endpunkte /v6/validiere und /v2/{redaktionssystemId}/redsyskonfig geschaffen.
• /v5/validiere und /v1/:redsyscode/redsyskonfig werden zum Mai 2026 abgekündigt.

Suchdienst Frontend​

• Meta Tags für die korrekte Anzeige suchen & finden für die Internetsuche (Suchmaschinenoptimierung) wurden ergänzt.

Suchdienst Backend​

• Durch Anpassungen der BKG-Schnittstellen /v3/locations und /v3/locations/ars hinsichtlich der Antwortqualität sind in der ARS-Suche Qualitätsverbesserung bei der Auswertung der BKG-Antworten erreicht worden.
• Anpassung der OpenAPI Beschreibung in Bezug auf Vererbung in Leistungsmodulen.

Fixed​

Sammlerdienst​

• Um die Verarbeitung einer Push-Nachricht umfänglicher verfolgen zu können, wurde das Logging (Request, Nachrichten-UUID) erweitert.
• Das Redaktionssystem Hessen wurde zur Fehlerbehebung auf Demo und Prod vollständig neu importiert. Der Suchdienst und der Bereitstelldienst wurden aus dem Sammlerdienst neu gefüllt und berechnet.

Suchdienst Frontend​

• Die Sicherheitslücke CVE-2025-64718 wurde behoben.

Versionen: Sammlerdienst 7.9.1, Suchdienst Backend 11.7.2, Suchdienst Frontend 4.10.2, Validator Backend 8.6.1, Fachvalidator Library 12.7.3, Validator Frontend 6.4.4, Bereitstelldienst 6.15.1, Konverterdienst 1.4.3, Konverter Library 1.9.3

Add​

Produktportal​

• Zusätzliche zu Swagger wird die Suchdienst BetaAPI v6beta3/servicedescriptions/:lbid/detail auf dem [Produktportal] (https://produktportal.pvog.fitko.de/api/beta-apis/suchdienst/get-sd-out-model-v-6/) angezeigt. Diese API gibt eine Leistung mit allen Informationen und allen zuständigen Organisationseinheiten in einem bestimmten Gebiet (ARS) zurück. Feedback ist ausdrücklich erwünscht!

Fixed​

Sammlerdienst​

• Im Rahmen der Arbeiten für die Hochverfügbarkeit wurde die Leader Election resilienter gestaltet.

Suchdienst Frontend​

• Berücksichtigt weitere Modul-Kombinationen für Anzeige von Organisationseinheiten (relevant nur für den Beta-Endpunkt v6beta/details).

Im Rahmen der Entwicklung des Efa-Parametrisierungsportals ist eine Lösung zur Authentifizierung und Autorisierung am Backend entwickelt worden. Der Zugriff ist begrenzt für den Test und läuft ausschließlich auf einer Testumgebung und ist nicht Bestandteil des Releases.

Versionen: Sammlerdienst 7.9.0, Suchdienst Backend 11.7.1, Suchdienst Frontend 4.10.0, Validator Backend 8.6.0, Fachvalidator Library 12.7.2, Validator Frontend 6.4.3, Bereitstelldienst 6.15.0, Konverterdienst 1.4.2, Konverter Library 1.9.2

Add​

Suchclient​

• Die Aktualisierungsangaben zu einer Leistung enthalten jetzt zusätzlich das Datum der fachlichen Freigabe

Suchdienst​

• Das Leistungsmodul "Fachliche Freigabe" wird jetzt von dem Beta-API Endpunkt im Leistungsmodul 'FachlicheFreigabeModul' ausgegeben

Validator-Service​

• Der Validator-Service erfüllt die Voraussetzungen zur Hochverfügbarkeit

Produktportal​

• Die Informationsseite des XZuFi 2.3.1-Rollout Programms ist auf der Landing Page verlinkt

Changed​

Suchclient​

• Die Aktualisierungsangabe "Aktualisiert am" zu einer Leistung wird jetzt aus dem in der XZuFi-Datei angegebenen Feld "geaendertDatumZeit" in den Versionsinformationen ausgegeben

Suchdienst​

• Der Beta-API Endpunkt '/v6beta2/servicedescriptions//detail?q=' wurde geändert zu '/v6beta3/servicedescriptions//detail?ars='
• Die Verarbeitung von Ursprungsportalen orientiert sich am XZuFi 2.3.1 Standard und liefert maximal ein Ursprungsportal pro Sprache und Zugangskanal
• Die Beschreibung des API Endpunktes '/v5/organisationunits/detail' wurde angepasst

Validator-Service​

• Der Protokollmodus des Validators 50 wurde von Warnung auf Hinweis gesetzt

Produktportal​

• Die Downloads des Produktportals wurden in den Bereich Ressourcen verschoben

Fixed​

Suchclient​

• Organisationseinheiten werden in Leistungen ohne Modul 22/23 dargestellt
• Das Problem mit nicht ladenden Leistungen in der Servicesuche Bund ist behoben
• Spezialisierungen, die nur einen Link und keine Beschreibung enthalten, werden ausgegeben

Suchdienst​

• Leistungen ohne Anbieter (Keine zuständige Organisationseinheit oder Onlinedienst) werden nicht mehr ausgegeben
• Leistungen enthalten jetzt mehr Felder aus Spezialisierungen

Sammlerdienst​

• Ein Pull-Import wird nicht mehr abgebrochen, wenn Objekte mit unterschiedlicher XZuFi-Version in der Datenbank vorliegen

Produktportal​

• Die fehlerhafte Darstellung von Soft Hyphen in den RSS Feeds wurden behoben

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.

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.

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.

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.

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.