Eine offizielle Website der Bundesrepublik Deutschland
Zum Hauptinhalt springen

Wartungsarbeiten für Deployments PVOG Release 9.24

Eine Minute Lesezeit

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

  • 06.10.2026 (Dienstag) - Stage-Umgebung (stage.pvog.fitko.net)
  • 13.10.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 Release Note zum Release 9.24 wird nach dem Stage Deployment auf dem Produktportal unter Neuigkeiten/Release Notes veröffentlicht.

Achtung! v2/verwaltungsobjekte abgekündigt

Eine Minute Lesezeit

Im Mai 2026 wurde die XZuFi 2-3-header Lösung in der Bereitstelldienst Schnittstelle v2/verwaltungsobjekte abgekündigt (https://pvog.fitko.de/api/deprecations/). Die Abschaltung dieses Endpunktes erfolgt nach aktueller Planung produktiv zum 24.11.2026.

Ab diesem Zeitpunkt muss beim Abruf des Bereitstelldienstes der Nachfolger v3/verwaltungsobjekte/xzufi-2-3-1 verwendet werden.

Was ändert sich:

  • Es ist beim Abruf keine Angabe der XZuFi Version im header mehr erforderlich.

  • Der Endpunkt überträgt Leistungen, Leistungsspezialisierungen, Organisationseinheiten, Onlinedienste, Formulare und Zuständigkeiten als XZuFi Transfernachrichten. Mehrere Anfragen unter Verwendung des Update-Index können nötig sein, um alle Daten abzurufen. Der Umfang der abzufragenden Leistungsdaten kann durch Angabe von Amtlichen Regionalschlüsseln auf bestimmte Regionen eingeschränkt werden. Wenn die Daten nicht in der XZuFi-Version 2.3.1 an das PVOG geliefert wurden, werden die ausgelieferten Daten zuvor konvertiert.

Die aktuelle Anbindungsanleitung inkl. der Beschreibung der Schnittstelle liegt neu unter docs.fitko.de.

Für die geplante Nutzung des PVOG Bereitstelldienstes steht der Endpunkt v3/verwaltungsobjekte/xzufi-2-3-1 bereit.

Erzeugen Sie bereits Abfragen an den Bereitstelldienst, prüfen Sie bitte, ob v2/verwaltungsobjekte bei ihren Abfragen noch im Einsatz ist. Bei Fragen kontaktieren Sie uns gern!

Achtung! v3/relations/{ars}/jzufi abgekündigt

2 Minuten Lesezeit

Im Juni 2026 wurden für den PVOG Suchdienst der Endpunkt v3/relations/{ars}/jzufi zu 11/26 abgekündigt (https://pvog.fitko.de/api/deprecations/). Die Abschaltung erfolgt in der Prod Umgebung zum 26.11.2026. Danach muss der Nachfolger v1/relations/jzufi-2-3 verwendet werden.

Was ändert sich:

Der neue Endpunkt gibt das ursprüngliche XZuFi als JSON (JZuFi) der Zuständigkeits-Objekte in der XZuFi-Version 2.3.1 zurück. Ein Zuständigkeits-Objekt verknüpft Leistungen, Organisationseinheiten und Onlinedienste. Wenn die Auslieferungsversion der Daten von der Version abweicht, in der die Daten an das PVOG geliefert wurden, werden die ausgelieferten Daten entsprechend konvertiert.

Bitte prüfen Sie, ob v3/relations/{ars}/jzufi bei ihren Abfragen noch im Einsatz ist (wir haben aktuell ca. 60.000 Zugriffe in 7 Tagen) und planen ggf. die Umstellung auf v1/relations/jzufi-2-3 zeitnah ein.

Suchdienst Nutzer, die bereits eine ClientID (https://pvog.fitko.de/docs/ressourcen/client-id/) nutzen, werden von uns direkt kontaktiert.

Details finden Sie in der OpenAPI-Dokumentation (https://pvog.fitko.de/docs/umgebungen/umgebungen-ueberblick/).

Suchen von Leistungen – Neuer Endpunkt im Suchdienst

2 Minuten Lesezeit

Mit dem PVOG Release 9.21. wurde ein neuer Endpunkt für den Suchdienst vorgestellt: suchdienst/api/v8beta1/servicedescriptions 

Dieser Endpunkt löst perspektivisch den Endpunkt /v7/servicedescriptions/{ars} ab.

Ähnlich wie /v7/servicedescriptions/{ars} sucht /v8beta1/servicedescription in einem ARS-Bereich nach Leistungen, in denen der Suchbegriff enthalten ist. Das Ergebnis ist eine Liste von Leistungen.

Im Vergleich der beiden Endpunkte wurde sowohl das Input Modell, als auch das Output Modell reduziert und die Paginierung neu aufbereitet.

In der Abfrage (Input) sind Default Werte für page und size gesetzt. Das Gültigkeitsdatum ist jetzt immer der Zeitpunkt der Abfrage; für die Ausgabe muss die Leistung gültig sein. Dynamische Parameter werden standardmäßig ausgegeben.

Im Ergebnis (Output) wurden Details zur Leistung entfernt und Zugangskanäle (XZuFi Schema 2.3.1) hinzugefügt.

Output Model v8beta1_servicedescriptions.png mit Zugangskanälen

Aktuell ist der Endpunkt bereits am SuchClient (servicesuche.bund.de) implementiert.

Hinweis: Diese API-Änderungen sind noch im Beta-Stadium, also noch nicht produktiv. Wir wollen frühzeitig über diese Änderungen informieren. Nutzen Sie gern die OpenAPI Dokumentation zum Testen ihrer UseCases.

Bitte geben Sie, als Konsumenten gern Feedback zur Weiterentwicklung!

Suchdienst Nutzer, die bereits eine Client ID nutzen, werden von uns mit der Bitte um Feedback direkt kontaktiert.

Achtung! v5/servicedescriptions/{ars}/detail abgekündigt (PVOG)

2 Minuten Lesezeit

Im Juni 2026 wurde für den PVOG Suchdienst der Endpunkt v5/servicedescriptions/{ars}/detail zu 11/26 abgekündigt. Aktuell haben wir ca. 400.000 Zugriffe in 7 Tagen. Spätestens ab November 2026 muss v6/servicedescriptions/{lbid}/detail verwendet werden.

Bei beiden Endpunkten sind ARS (Gebietsschlüssel) und Leistungsid (z.B. L100012.LB.9413106) die notwendigen Abfrageparameter. Als Ergebnis einer Abfrage werden alle Informationen und alle zuständigen Organisationseinheiten in einem bestimmten Gebiet (ARS) ausgegeben. Die Onlinedienst-Links in der Antwortmenge enthalten dynamische Parameter. Der Endpunkt liefert zum Zeitpunkt der Anfrage die aktuellsten Daten nach Gültigkeitszeitraum zurück.

Was ändert sich in v6/servicedescriptions/{lbid}/detail:

  • Die Antwort wurde deutlich verschlankt und um Zugangskanäle erweitert.
  • 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.

Output Model v6/servicedescriptions/{lbid}/detail

Bitte prüfen Sie, ob v5/servicedescriptions/{ars}/detail bei ihren Abfragen noch im Einsatz ist (wir haben aktuell ca. 400.000 Zugriffe in 7 Tagen) und planen ggf. die Umstellung auf v6/servicedescriptions/{lbid}/detail zeitnah ein.

Suchdienst Nutzer, die bereits ein ClientID nutzen, werden von uns direkt kontaktiert.

Details finden Sie in der OpenAPI-Dokumentation.

Wartungsarbeiten für Deployments PVOG Release 9.23

Eine Minute Lesezeit

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

  • 15.09.2026 (Dienstag) - Stage-Umgebung (stage.pvog.fikto.net)
  • 22.09.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.23 wird nach dem Stage Deployment auf dem Produktportal unter Neuigkeiten/Release Notes veröffentlicht.

Wartungsarbeiten für Deployments PVOG Release 9.22

Eine Minute Lesezeit

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

  • 22.08.2026 (Dienstag) - Stage-Umgebung (stage.pvog.fikto.net)
  • 01.09.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.22 wird nach dem Stage Deployment auf dem Produktportal unter Neuigkeiten/Release Notes veröffentlicht.

Anpassung Validator VAL0011

Eine Minute Lesezeit

Mit dem Schema XZuFi 2.3.1 wird die Parametrisierung vonOnlinediensten in Bezug auf die Verwendung von HTML erweitert:„DieParameterwerte von „OnlinedienstParameterEfA“ und „OnlinedienstParameterIndividuell“sind von der HTML-Einschränkung ausgeschlossen. Der Standard gibt keineEinschränkungen der Inhalte von Parameterwerten vor.“ (vgl. XZuFi-2.3.1-Spezifikation"I.4.1.2 Verwendung von HTML")

Auszug XZuFi 2.3. Schema OnlinedienstParameterEfA

und

Auszug XZuFi 2.3. Schema OnlinedienstParameterIndividuell

Um die Anforderungen schemakonform abzubilden, wurde im PVOGRelease 9.20 der Validator VAL0011 angepasst. Die Parameter OnlinedienstParameterIndividuellund OnlinedienstParameterEfA werden jetzt aus der Prüfung der maskiertenHTML-Tags ausgeschlossen.

Ergänzungen an Validator VAL 0053 waren nicht notwendig, danur Elemente geprüft werden, in den HTML-Tags nicht erlaubt sind.

Die Beschreibung der Validatoren kann unter https://docs.fitko.de/pvog/docs/validator/validierungsumfangXZuFi/validierungsregeln/uebersicht_validierungsregelnnachgelesen werden.

pvog.fitko.de wird das Produktportal

Eine Minute Lesezeit

Am 26.08.2026 (korrigierter Termin) zieht das Produktportal im Rahmen eines Deployments auf pvog.fitko.de um. Damit gehen wir den nächsten wichtigen Schritt in der Umsetzung des FITKO Domainkonzeptes.

Bitte ändern Sie eventuelle Lesezeichen oder Favoriten in Ihrem Browser direkt. Die Weiterleitung der bisherigen Domain produktportal.pvog.fitko.de ist nur übergangsweise aktiv.

Mit der Umstellung endet die parallele Bereitstellung der Suchdienst APIs über die Domains pvog.fitko.de.

Die Endpunkte sind weiterhin unverändert über die Domains stage.pvog.fitko.net bzw. pvog.fitko.net erreichbar.

Wartungsarbeiten für Deployments PVOG Release 9.21

Eine Minute Lesezeit

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

  • 04.08.2026 (Dienstag) - Stage-Umgebung (stage.pvog.fikto.net)
  • 11.08.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.21 wird nach dem Stage Deployment auf dem Produktportal unter Neuigkeiten/Release Notes veröffentlicht.