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

Beta API v6beta3/servicedescriptions

2 Minuten Lesezeit

Mit Release 9.8 wurde die neue Suchdienst Schnittstelle suchdienst/api/v6beta3/servicedescriptions/:lbid/detail  vorgestellt.

Diese neue API wurde im Vergleich zu suchdienst/api/v5/servicedescriptions/:ars/detail im Modell verschlankt und ist nicht abwärtskompatibel. Nun fragen wir unsere PVOG Nutzer nach Feedback bis zum 31.12.2025:

  • Entspricht der reduzierte Detailierungsgrad den Anforderungen?
  • Sollen Ergänzungen vorgenommen werden?
  • Gibt es Anregungen?

Der Vergleich der Schnittstellen wird in folgender Übersicht dargestellt:

Neu - Bitte um Feedback!Bestehend
suchdienst/api/v6beta3/servicedescriptions/suchdienst/api/v5/servicedescriptions/

Übersicht der API Schemata

Felder mit * sind Pflichtfelder.

Ergänzend zur Verschlankung werden in v6beta3/servicedescriptions/:lbid/detail Informationen aus den Leistungsmodulen mit den Zugangskanälen in den Details abgebildet.

Schema v6beta3/servicedescriptions

Das Feld „name“ aus dem leikaTextModul wird nach aktuell geltenden Regeln befüllt:

  • Wenn Code 03 Inhalte hat, wird dieser Information angezeigt.
  • Wenn Code 03 keine Inhalte hat, wird Code 02 angezeigt.
  • Zusätzlich wird der Inhalt aus dem Zugangskanal priorisiert. Wenn vorhanden, wird die Information aus 100 (Online) gewählt. Falls 100 nicht vorhanden ist, wird 000 (Online/Offline) angezeigt oder falls ebenfalls nicht vorhanden, als letzte Option 200 (Offline).

Das Feld „details“ enthält detaillierte Information aus den Leistungsmodulen inklusive Zugangskanal im Feld „accessChannel“.

Für Feedback bitten wir um Kontaktaufnahme über unser Postfach dataportpvogsupport@dataport.de .

Neue Datumsangaben in der Servicesuche Bund

Eine Minute Lesezeit

Mit dem PVOG Release 9.8 wurde in der Servicesuche Bund am Seitenende die Übernahme der Datumsinformation aus der XZuFi Datei nach XZuFi Schema 2.3.1 implementiert.

Datumsangabe im SuchClient

Das Feld „Letzte Aktualisierung“ zeigt nicht mehr das letzte Importdatum, sondern wird aus dem Feld versionsinformation (xzufi:Versionsinformation) der Leistung ausgelesen.

Die Angabe „Freigeben am“ basiert auf den Einträgen in Leistung.ModulFachlicheFreigabe „fachlichFreigegebenAm“. Wenn die Leistung zwei solcher Module enthält, eines für Zugangskanal online und eines für offline, werden beide Daten mit entsprechendem Hinweis ausgegeben.

Der „Gültigkeitszeitraum“ der Leistung wird wie bisher aus dem Feld gueltigkeit (xzufi:Zeitraum) ermittelt.

Die Ausgabe aller FachlicheFreigabeModule je Zugangskanal ist über den Beta-Endpunkt suchdienst/api/v6beta3/servicedescriptions/:lbid/detail abrufbar. Falls die entsprechenden Daten nicht vorliegen, wird ein entsprechender Hinweis angezeigt.

Datumsangabe im SuchClient ohne XZuFi Information

Die beschriebene Änderung wurde am 3. November 2025 produktiv gesetzt.

Wartungsarbeiten für Deployments PVOG Release 9.9.0

Eine Minute Lesezeit

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

  • 11.11.2025 - Demo-Umgebung (stage.pvog.fikto.net)
  • 18.11.2025 - PreProd/Stage-Umgebung (pvog-preprod.fitko.de)
  • 25.11.2025 - Prod-Umgebung (pvog.fitko.de)

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.9.0 wird nach dem Demo Deployment auf dem Produktportal unter Neuigkeiten/Release Notes veröffentlicht.

Wartungsarbeiten für Deployments PVOG Release 9.8.1

Eine Minute Lesezeit

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

  • 21.10.2025 - Demo-Umgebung (stage.pvog.fikto.net)
  • 28.10.2025 - PreProd/Stage-Umgebung (pvog-preprod.fitko.de)
  • 03.11.2025 - Prod-Umgebung (pvog.fitko.de)

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.8.1 wird nach dem Demo Deployment auf dem Produktportal unter Neuigkeiten/Release Notes veröffentlicht.

Finden von Spezialisierungen über die Suche

Eine Minute Lesezeit

Mit dem Release 9.7 sind Spezialisierungen von Leistungen mit indiziert und damit über die Suchen des PVOG aufzufinden. Bisher konnten ausschließlich die Titel und Beschreibungen der Leistungen über die APIs und das Frontend (Servicesuche Bund) gefunden werden, jetzt funktioniert dies auch mit den Inhalten von Spezialisierungen. Damit gibt es jetzt mehr und bessere Ergebnisse der Suchen.

Beispiel: Für Rostock ist in der Leistung "Kommunale Sportförderung: Zuwendung für kleine, bedürftige Sportvereine beantragen" die Beschreibung spezialisiert.

Die Leistung in Rostock:

Screenshot der Leistung

Ergebnisse der Suche im Frontend vor Release 9.7:

Screenshot der Suche nach "Richtlinie für die Sportförderung" ohne Ergebnisse

Ergebnisse der Suche im Frontend nach Release 9.7:

Screenshot der Suche nach "Richtlinie für die Sportförderung" mit Ergebnissen

PVOG | Infrastruktur Wartungsarbeiten an PrePROD/PROD Umgebung am 24.09.2025

Eine Minute Lesezeit

Am 24.09.2025 (Mittwoch) finden an der PROD- und Stage/PrePROD-Umgebung planmäßige Wartungsarbeiten der Infrastruktur statt. 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 längerfristige Beeinträchtigungen feststellen, wenden Sie sich bitte an unser Funktionspostfach dataportpvogsupport@dataport.de.

Wartungsarbeiten für Deployments PVOG Release 9.7

Eine Minute Lesezeit

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

  • 30.09.2025 - Demo-Umgebung (stage.pvog.fikto.net)
  • 07.10.2025 - PreProd/Stage-Umgebung (pvog-preprod.fitko.de)
  • 14.10.2025 - Prod-Umgebung (pvog.fitko.de)

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.7 wird nach dem Demo Deployment auf dem Produktportal unter Neuigkeiten/Release Notes veröffentlicht.

Neue API im Suchdienst

Eine Minute Lesezeit

Mit Release 9.6 wird für den PVOG Suchdienst eine neue Schnittstelle veröffentlicht.

Die Schnittstelle /v1/organisationunits/{oeID}/ars gibt eine Liste von ARS (Amtlichen Regionalschlüsseln) aus den Zuständigkeiten einer Organisationseinheit für einen bestimmten Leistungsschlüssel zurück.

Die Ergebnisse der Schnittstelle unterstützen bei der Suche nach Zuständigkeiten für eine bestimmte Leistung. Damit können Online Dienste anhand der OrganisationsId und dem Leikaschlüssel in weiteren Schritten die Onlinedienst Parameter ermitteln.

Als notwendige Parameter muss die ID der Organisationseinheit im Format [schemeAgencyId].OE.[LeistungsID] und die LeiKa-ID mit übergeben werden. Weitere Informationen können im Produktportal oder über die Swagger UI eingesehen werden.

Als Antwort wird eine Liste von ARS Schlüsseln geliefert.

Wartungsarbeiten für Deployments PVOG Release 9.6

Eine Minute Lesezeit

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

  • 11.09.2025- Demo-Umgebung (stage.pvog.fikto.net)
  • 16.09.2025 - PreProd/Stage-Umgebung (pvog-preprod.fitko.de)
  • 23.09.2025 - Prod-Umgebung (pvog.fitko.de)

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.6 wird nach dem Demo Deployment auf dem Produktportal unter Neuigkeiten/Release Notes veröffentlicht.

Verschoben - PVOG | Außerplanmäßige Wartungsarbeiten PrePROD-/PROD-Umgebungen

Eine Minute Lesezeit

Im Rahmen von außerplanmäßigen Wartungsarbeiten werden notwendige Aktualisierungen einer PVOG Datenbank vorgenommen:

  • 21.08.2025 (Donnerstag) Stage/PrePROD-Umgebung
  • 25.08.2025 (Montag) PROD-Umgebung

Die PVOG Suchdienst APIs der Umgebungen und die SuchClients preprod.servicesuche.bund.de / servicesuche.bund.de stehen zur Verfügung.
Alle anderen PVOG Dienste sind voraussichtlich zwischen 8:00 und 11:00 Uhr nicht erreichbar.

Sollten Sie längerfristige Beeinträchtigungen feststellen, wenden Sie sich bitte an unser Funktionspostfach dataportpvogsupport@dataport.de.