Sehr geehrte PVOG Nutzer,

zum 9.6.2026 (mit dem PreProd-Deployment des PVOG Releases 9.18.) wird die lange angekündigte Optimierung der PVOG Infrastruktur erfolgen.

Mit der Abschaltung der Demo-Umgebung übernimmt die PreProd-Umgebung die Funktionen und die bestehende URL https://stage.pvog.fitko.net. Durch den Wegfall der Demo Umgebung können kürzere Releasezeiten bis zum Ausrollen von PVOG Releases bis zur PVOG Produktivumgebung realisiert werden. Die PreProd Umgebung wird als produktionsnahe Testumgebung mit Daten aus allen Redaktionssystemen aufgewertet. Außerdem können wir das FITKO-Domainkonzept abschließend umsetzen.

Was müssen Sie als, Bereitstelldienst-, Validator Service/API oder Konverter Service/API- Nutzende beachten?

• Der Link zum PVOG Dienst unter stage.pvog.fitko.net bleibt erhalten.
• Sollten Sie Zugangsdaten (Passwort oder Token) nur für die Demo Umgebung haben, bekommen Sie bis 26.5. neue Zugangsdaten.
• Sollten Sie Zugangsdaten (Passwort oder Token) für die PreProd Umgebung haben, blieben diese erhalten.
• Die PVOG Dienste der PreProd Umgebung sind ab 9.6.2026 nicht mehr über pvog-preprod.fitko.de erreichbar. Bitte nutzen Sie ab dem 9.6. den Zugriff über stage.pvog.fitko.net.

Was ist zu tun?

• Prüfen Sie bitte rechtzeitig, ob Ihnen die notwendigen Zugangsdaten für die PreProd Umgebung (bisher pvog-preprod.fitko.de) vorliegen und melden Sie sich, wenn bis zum 26.5.2026 keine ergänzenden Zugangsdaten bei Ihnen eingetroffen sind.
• Passen Sie Ihre Systeme ggf. an die neue Domain an.

Für Fragen zu Importen werden wir zeitnah direkt auf die jeweiligen Redaktionssysteme oder Dienstleister zugehen.

Sollten Sie Fragen haben, zögern Sie bitte nicht, uns anzusprechen!

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.

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/jzufi	deprecated
/v2/servicedescriptions/jzufi	deprecated
/v2/relations/{ars}/jzufi	deprecated
/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.

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.

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.

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

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

2. 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.

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

Antwortschema

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

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!

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.

Schema der Antwort

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

• urn:xoev-de:fim:codeliste:xzufi.organisationseinheitsrollefueronlinedienst (ZSOD OE referenziert in 2.3.1)
• urn:xoev-de:fim:codeliste:xzufi.zustaendigkeitsrolle (XZuFi 2.2)

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!

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.

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.

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.

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.

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.