PVOG – ein Produkt der Fitko
EntwicklungsressourcenFöderale IT-StandardsQuellcode
Zum Hauptinhalt springen

Wartungsarbeiten für Deployments PVOG Release 9.17.

Eine Minute Lesezeit

Die planmäßigen Deployments für PVOG Release 9.17 finden an folgenden Tagen zwischen 7:30 Uhr und 9:30 Uhr statt :

  • 12.05.2026 (Dienstag) - Demo-Umgebung (stage.pvog.fikto.net)
  • 19.05.2026 (Dienstag) - PreProd-Umgebung (pvog-preprod.fitko.de)
  • 26.05.2026 (Dienstag) - Prod-Umgebung (pvog.fitko.net)

Im Regelfall sollte dies nicht zu Beeinträchtigungen führen.

Falls es in diesem Zeitraum zu kurzfristigen Beeinträchtigungen kommt, bitten wir dies zu entschuldigen. Sollten Sie Fragen haben, wenden Sie sich gern an den PVOG Support unter dataportpvogsupport@dataport.de.

Parallel zu den Blogbeiträgen werden die Wartungsarbeiten per Mail an den Verteiler der Anbindungsteilnehmer versandt. Wenn Sie keine E-Mail erhalten, aber Informationen zur Verfügbarkeit des PVOG benötigen, nehmen wir Sie gern in den Verteiler auf.

Die ReleaseNote zum Release 9.17 wird nach dem Demo Deployment auf dem Produktportal unter Neuigkeiten/Release Notes veröffentlicht.

Neue JZuFi Endpunkte pro XZuFi Version im Suchdienst

2 Minuten Lesezeit

Mit der Umstellung auf XZuFi 2.3.1 wurde in den JZuFi Endpunkten implementiert, dass die XZuFi-Version beim Abruf im http-Header angefordert werden musste.

Zwischenzeitlich erreichte uns eine Kundenanforderung, zu JZuFi Endpunkten, die mit dem Codegenerator die gewünschte XZuFi-Version nicht korrekt abrufen konnte.

Da eine entsprechende Konfiguration des Codegenerators nicht möglich war, erfolgte im Release 9.16 eine Erweiterung der Endpunkte durch die Einführung von zwei Methoden pro Endpunkt, um die Kompatibilität mit dem Codegenerator zu gewährleisten.

Im Detail wurden ab Version 9.16 verschiedene Endpunkte als deprecated markiert, während parallel neue Versionen mit differenzierten Pfaden eingeführt wurden, die explizit die jeweilige XZuFi-Version in der URL abbilden.

Ab PVOG Release 9.16. (Deployment Produktion am 5.5.2026)
/v1/organisationunits/jzufideprecated
/v2/servicedescriptions/jzufideprecated
/v2/relations/{ars}/jzufideprecated
/v3/organisationunits/jzufi - deprecated/v1/organisationunits/:id/jzufi-2-2
/v1/organisationunits/:id/jzufi-2-3
/v3/relations/:ars/jzufi - deprecated/v1/relations/jzufi-2-2
/v1/relations/jzufi-2-3
/v2/servicedescriptions/jzufi - deprecated/v1/servicedescriptions/:id/jzufi-2-2
/v1/servicedescriptions/:id/jzufi-2-3

Das zugrundeliegende Schema der Endpunkte blieb unverändert, sodass lediglich die URL angepasst werden muss, um die gewünschte Version anzusprechen.

Details zu den Endpunkten sind auf dem Produktportal oder in der OpenAPI Dokumentation einzusehen.

Insgesamt stellt diese Anpassung sicher, dass trotz der Einschränkungen des Codegenerators eine korrekte und flexible Nutzung der JZuFi-Endpunkte mit unterschiedlichen XZuFi-Versionen möglich ist. Mit Release 9.16. werden die Endpunkte ohne XZuFi-Version ebenfalls auf „deprecated“ gesetzt. Die Termine können dem Produktportal/Ressourcen/Deprecations entnommen werden.

Für Nutzer der PVOG Suchdienst REST APIs wird die Verwendung von API Keys empfohlen, um die Weiterentwicklung der Schnittstellen zu unterstützen. Informationen zur Beantragung und Nutzung der API Keys sind auf dem PVOG Produktportal verfügbar.

Neues vom ValidatorService

Eine Minute Lesezeit

Mit dem PVOG Release 9.16. konnten in der Übersicht „Weitere Informationen“ des Validator Services folgende zusätzliche Informationen für mehr Nutzerfreundlichkeit ergänzt werden:

  • ValidatorIDs, z. B. VAL0065, neben dem Validatornamen und der Kurzbeschreibung (auf- und abwärts sortierbar)
  • Modus des Validators auf Deutsch (Hinweis,Warnung, Fehler)

Es werden nur noch aktive Validatoren angezeigt.

ValidatorService 9.16 Ansicht Weitere Informationen

Für die Nutzung des Validator Services sind Zugangsdaten pro Umgebung notwendig.

Demo: https://stage.pvog.fitko.net/validator/

PreProd: https://pvog-preprod.fitko.de/validator/

Prod: https://pvog.fitko.net/validator/

Für die Beantragung eines Zugangs schreiben Sie bitte an den PVOG Support unter pvogsupport@dataport.de.

Neue Beta-API für die Ausgabe von Onlinediensten innerhalb eines Gebietes

2 Minuten Lesezeit

Mit dem PVOG Release 9.15. wurde für den Suchdienst der neue Endpunkt /v1beta2/onlineservices veröffentlicht.

Der Endpunkt liefert Onlinedienste innerhalb des angefragten ARS-Bereichs. Die Filterung erfolgt entlang der ARS-Hierarchie sowohl nach oben als auch nach unten.

Filterung nach oben: Bei der Suche nach der ARS 091 (Oberbayern) werden Onlinedienste mit Zuständigkeit für 091 sowie für übergeordnete Ebenen geliefert, z.B. Bayern (09) oder Bund (00).

Filterung nach unten: Bei der Suche nach 091 werden zusätzlich Onlinedienste für untergeordnete Ebenen bis hinunter zur Gemeindeebene geliefert, z.B. München (091620000000).

Beispiele zu den Ergebnissen der Abfrage

  1. Abfrage mit <= 1000 Ergebnisse Beispiel: https://stage.pvog.fitko.net/suchdienst/api/v1beta2/onlineservices?ars=100

Abfrage mit bis zu 1000 Ergebnisse

Für die ARS 100 werden im ersten Schritt alle Ergebnisse der Abfrage (725 hits) der insgesamt 725 Ergebnisse (totalHits) angezeigt.

  1. Abfrage mit > 1000 Ergebnissen Beispiel: https://stage.pvog.fitko.net/suchdienst/api/v1beta2/onlineservices?ars=090

Für die ARS 090 werden im ersten Schritt der Abfrage 1000 Ergebnisse (hits) der insgesamt 1590 Ergebnisse (totalHits) angezeigt.

Abfrage mit mehr als 1000 Ergebnisse

Die weiteren Onlinedienste können durch das Setzen des „nextPageToken“ abgefragt werden.

Beispiel:

https://stage.pvog.fitko.net/suchdienst/api/v1beta2/onlineservices?ars=090&nextPageToken=L100042.OD.12184_43865

Einschränkung über Leika

Als weiterer Parameter kann in der Abfrage die Ergebnismenge auf eine Leistung aus dem Leistungskatalog eingeschränkt werden. Das Ergebnis sind die Onlinedienste, die für eine Leistung mit dem konkreten Leistungsschlüssel, zuständig sind.

https://stage.pvog.fitko.net/suchdienst/api/v1beta2/onlineservices?ars=090&leikaIds=99050012104000

Response

Ergebnis der Abfrage

Antwortschema

Das Schema der Antwort ist auf dem Produktportal abgebildet und ermöglich die gezielte Weiterverarbeitung der Ergebnisse.

Schema des Endpunktes

Parallel zum Produktportal kann auch die Swagger Dokumentation zum Ausprobieren verwendet werden.

Geben Sie gern Feedback zur vorgestellten beta API, z. b. in der User Group oder über das Helpdesk-Formular auf dem PVOG Produktportal!

Neue Beta-API für die Ausgabe von zuständigen Organisationseinheiten an Onlinediensten

2 Minuten Lesezeit

Mit dem PVOG Release 9.15. wurde für den Suchdienst der neue Endpunkt /v1beta1/onlineservices veröffentlicht.

Der Endpunkt gibt die Organisationseinheiten zurück, die einem Onlinedienst zugeordnet sind. Der Test des Endpunktes kann über das Produktportal oder die Swagger Dokumentation erfolgen.

Beispiel: https://stage.pvog.fitko.net/suchdienst/api/v1beta1/onlineservices/L100012.OD.277549726/organisations

Ergebnis: Es werden alle zugeordneten Organisationseinheiten und die zugehörige Leistung ausgegeben.

Abfrageergebnis am Beispiel der Swagger Dokumentation

Schema der Antwort

Schema Beschreibung des Endpunktes

Die Beschreibungen der Rollen der Organisationseinheiten für den Onlinedienst sind an zwei Codelisten angelehnt:

Liste der Ansprechpunkte

Bitte geben Sie gern Feedback zum neu veröffentlichten Endpunkt, z.B. in der User Group oder über das Helpdesk-Formular auf dem PVOG Produktportal!

Wartungsarbeiten für Deployments PVOG Release 9.16.

Eine Minute Lesezeit

Die planmäßigen Deployments für PVOG Release 9.16 sind wegen des Last- und Performancetestes gegen die PreProd-Umgebung zum Teil eine Woche verschoben und finden an folgenden Tagen zwischen 7:30 Uhr und 9:30 Uhr statt :

  • 15.04.2026 (Mittwoch) verschoben - Demo-Umgebung (stage.pvog.fikto.net)
  • 28.04.2026 (Dienstag) - PreProd-Umgebung (pvog-preprod.fitko.de)
  • 05.05.2026 (Dienstag) - Prod-Umgebung (pvog.fitko.net)

Im Regelfall sollte dies nicht zu Beeinträchtigungen führen.

Falls es in diesem Zeitraum zu kurzfristigen Beeinträchtigungen kommt, bitten wir dies zu entschuldigen. Sollten Sie Fragen haben, wenden Sie sich gern an den PVOG Support unter dataportpvogsupport@dataport.de.

Parallel zu den Blogbeiträgen werden die Wartungsarbeiten per Mail an den Verteiler der Anbindungsteilnehmer versandt. Wenn Sie keine E-Mail erhalten, aber Informationen zur Verfügbarkeit des PVOG benötigen, nehmen wir Sie gern in den Verteiler auf.

Die ReleaseNote zum Release 9.16 wird nach dem Demo Deployment auf dem Produktportal unter Neuigkeiten/Release Notes veröffentlicht.

Validator Backend - Neuer Status im Validierungsprozess

Eine Minute Lesezeit

Der Validator Service wurde im Zuge der Einführung der Hochverfügbarkeit redundant ausgelegt, sodass nun zwei Validator Dienste parallel betrieben werden können. Diese Redundanz gewährleistet, dass im Falle eines Ausfalls eines Dienstes die bereits begonnenen Validierungsaufgaben nahtlos von dem anderen Dienst übernommen werden können, um eine unterbrechungsfreie Verarbeitung sicherzustellen.

Zur Unterstützung dieser Funktionalität wurde im Validierungsprozess ein neuer Status STUCK implementiert, der sowohl bei der Nutzung der Validator API als auch im Validator Service Anwendung findet. Dieser Status wird aktiviert, wenn innerhalb von fünf Minuten keine Aktualisierung der Validierung erfolgt, was darauf hinweist, dass die Verarbeitung vorübergehend pausiert, jedoch nicht abgebrochen wird. Die Fortsetzung der Verarbeitung erfolgt automatisch, sobald vorherige Tasks abgeschlossen sind, wodurch eine konsistente und zuverlässige Weiterbearbeitung gewährleistet wird.

Beschreibung Objekt Fortschritt mit Status

Der Status STUCK wird über die API-Endpunkt /v1/{id}/fortschritt kommuniziert, sodass externe Systeme oder Nutzer den aktuellen Stand der Validierung nachvollziehen können. Im Frontend wird in diesem Fall eine Meldung angezeigt, die den Nutzer darüber informiert, dass die Validierung angehalten wurde und in Kürze fortgesetzt wird. Diese Maßnahmen tragen dazu bei, die Stabilität und Transparenz des Validierungsprozesses in einer hochverfügbaren Systemumgebung zu erhöhen.

Wartungsarbeiten für Deployments PVOG Release 9.15

Eine Minute Lesezeit

Die planmäßigen Deployments für PVOG Release 9.15 finden an folgenden Tagen zwischen 7:30 Uhr und 9:30 Uhr statt:

  • 24.03.2026 (Dienstag) - Demo-Umgebung (stage.pvog.fikto.net)
  • 31.03.2026 (Dienstag) - PreProd/Stage-Umgebung (pvog-preprod.fitko.de)
  • 07.04.2026 (Dienstag) - Prod-Umgebung (pvog.fitko.net)

Im Regelfall sollte dies nicht zu Beeinträchtigungen führen.

Falls es in diesem Zeitraum zu kurzfristigen Beeinträchtigungen kommt, bitten wir dies zu entschuldigen. Sollten Sie Fragen haben, wenden Sie sich gern an den PVOG Support unter dataportpvogsupport@dataport.de.

Parallel zu den Blogbeiträgen werden die Wartungsarbeiten per Mail an den Verteiler der Anbindungsteilnehmer versandt. Wenn Sie keine E-Mail erhalten, aber Informationen zur Verfügbarkeit des PVOG benötigen, nehmen wir Sie gern in den Verteiler auf.

Die ReleaseNote zum Release 9.15 wird nach dem Demo Deployment auf dem Produktportal unter Neuigkeiten/Release Notes veröffentlicht.

Wartungsarbeiten für Deployments PVOG Release 9.14

Eine Minute Lesezeit

Die planmäßigen Deployments für PVOG Release 9.14 finden an folgenden Tagen zwischen 7:30 Uhr und 9:30 Uhr statt:

  • 05.03.2026 (Donnerstag) - Demo-Umgebung (stage.pvog.fikto.net)
  • 10.03.2026 (Dienstag) - PreProd/Stage-Umgebung (pvog-preprod.fitko.de)
  • 17.03.2026 (Dienstag) - Prod-Umgebung (pvog.fitko.net)

Im Regelfall sollte dies nicht zu Beeinträchtigungen führen.

Falls es in diesem Zeitraum zu kurzfristigen Beeinträchtigungen kommt, bitten wir dies zu entschuldigen. Sollten Sie Fragen haben, wenden Sie sich gern an den PVOG Support unter dataportpvogsupport@dataport.de.

Parallel zu den Blogbeiträgen werden die Wartungsarbeiten per Mail an den Verteiler der Anbindungsteilnehmer versandt. Wenn Sie keine E-Mail erhalten, aber Informationen zur Verfügbarkeit des PVOG benötigen, nehmen wir Sie gern in den Verteiler auf.

Die ReleaseNote zum Release 9.14 wird nach dem Demo Deployment auf dem Produktportal unter Neuigkeiten/Release Notes veröffentlicht.

Reihenfolge der Suchdienst Ergebnisse

3 Minuten Lesezeit

Werden die Suchdienst APIs des PVOG benutzt, um z.B. nach einer Leistung zu suchen, kommen die Ergebnisse in einer bestimmten Reihenfolge zurück. Diese wird dann in der Servicesuche Bund und ggf. anderen angebundenen Portalen umgesetzt.

Bei der Navigation über Lebenslagen auf der Servicesuche Bund anstelle der Suche, werden die Ergebnisse nur nach der ID sortiert. Auch die Reihenfolge der Organisationseinheiten oder Onlinediensten, die an einer Leistung zurückgegeben werden, nutzt die ID der Einträge.

Wie kommt die Reihenfolge zustande?

Die Ergebnisse der Suche über die Schnittstellen werden primär nach dem Score sortiert. Der Score gibt an, wie gut ein Suchtreffer zu dem eingegebenen Suchtext passt. Bei gleichem Score wird die ID der Leistung herangezogen.

Score

Der Score setzt sich aus verschiedenen Faktoren zusammen. Um den Score zu berechnen, werden die folgenden Felder (Deutsch und Englisch) berücksichtigt In der Leistungsbeschreibung und Spezialisierung (unabhängig von der spezialisierten GebietsID):

  • Leistungsbezeichnung (Leistungstextmodul Code 02)
  • Leistungsbezeichnung II (Leistungsname) (Leistungstextmodul Code 03)
  • Volltext (Leistungstextmodul Code 06)
  • Teaser (Leistungstextmodul Code 24)
  • UrsprungsportalModul – Titel
  • BegriffImKontext – Begriff

In Onlinediensten:

  • Bezeichnung des Onlinedienstes (nicht Name des Onlinedienst-Links)
  • Beschreibung des Onlinedienstes (nicht Name des Onlinedienst-Links)

Dabei werden Schreibfehler in der Suche ausgeglichen und es wird bei Leistungsbezeichnungen auch in Teilen von Wörtern gesucht (z.B. ist die Suche nach „Wahl“ auch beim Begriff „Wahlschein“ erfolgreich).
Die einzelnen Felder sind dabei unterschiedlich gewichtet und die Ergebnisse jeden Eintrags werden relativ zu allen vorhandenen Leistungen bewertet, um den Score zu erstellen.

ID der Leistung

Die berücksichtigte ID setzt sich zusammen aus der SchemeAgencyID des Redaktionssystems und der vom Redaktionssystem vergebenen ID. Bei einer Sortierung nach ID werden also alle Leistungen eines Redaktionssystems zusammen ausgegeben (aufgrund der übereinstimmenden SchemeAgencyID).

Wie kann die Reihenfolge durch das Redaktionssystem beeinflusst werden?

Das Redaktionssystem kann auf verschiedenen Wegen Einfluss auf die Berechnung des Scores nehmen. Da der Algorithmus aber sehr komplex und vielschichtig ist und die Scores auf Basis der gesamten Datenbank und nicht nur auf einem einzelnen Datensatz berechnet werden, kann nicht konkret vorhergesagt werden, wie sich einzelne Anpassungen auf den Score eines Eintrags auswirken. Um die Reihenfolge zu bearbeiten, können Redaktionssysteme testweise Anpassungen an einzelnen berücksichtigten Modulen vornehmen. Anschließend kann an der Suchdienst API geprüft werden, ob sich die Reihenfolge durch die vorgenommenen Anpassungen geändert hat.

Wie kann Feedback gegeben werden?

Sollte auffallen, dass Ergebnisse der Suchdienst API häufig in nicht gewünschter Reihenfolge zurückgeliefert werden oder sich ein anderes Vorgehen für einen der beschriebenen Fälle gewünscht werden, kann dies gerne an den PVOG Support gemeldet werden. Dies kann über das Helpdesk Formular auf dem Produktportal passieren oder durch eine Mail an dataportpvogsupport@dataport.de. Bei einem größeren festgestellten Bedarf können hier alternative Lösungswege evaluiert werden, z.B. dass auch die Organisationseinheiten auf Detail-Seiten eine bestimmte Ordnung bekommen. Hier könnten bspw. Organisationseinheiten mit kommunaler Verantwortung über Organisationseinheiten auf Landesebene zurückgegeben werden.