Eine offizielle Website der Bundesrepublik Deutschland
Zum Hauptinhalt springen

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.

Wartungsarbeiten für Deployments PVOG Release 9.13

Eine Minute Lesezeit

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

  • 10.02.2026 (Dienstag) - Demo-Umgebung (stage.pvog.fikto.net)
  • 17.02.2026 (Dienstag) - PreProd/Stage-Umgebung (pvog-preprod.fitko.de)
  • 24.02.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.13 wird nach dem Demo Deployment auf dem Produktportal unter Neuigkeiten/Release Notes veröffentlicht.

Umzug auf pvog.fitko.net - Zeitlicher Ablauf

2 Minuten Lesezeit

Die Umstellung der PVOG-Produktivumgebung auf die neue Domain pvog.fitko.net erfolgt am 02.02.2026. Nachfolgend erhalten Sie den genauen Zeitplan sowie wichtige Hinweise zum Ablauf:

Zeitlicher Ablauf am 02.02.2026

  • Ab 7:30 Uhr:

    Die Redaktionssysteme werden angehalten. Ab diesem Zeitpunkt nimmt das PVOG keine aktualisierten Daten an, bis der Umzug abgeschlossen ist.

  • Suchdienst:

    Der Suchdienst bleibt während der gesamten Umstellung verfügbar. Die neue Domain (pvog.fitko.net) und die bisherige Domain (pvog.fitko.de) werden für mehrere Wochen parallel produktiv betrieben. Ein zeitgenauer Umstieg ist daher nicht erforderlich. Während des Parallelbetriebs wird in den HTTP-Responses ein entsprechender Header zur Kennzeichnung gesendet.

  • Geplanter Schwenk:

    Der Schwenk auf die neue Domain ist für den Zeitraum zwischen ca. 14:00 und 15:00 Uhr vorgesehen. Bitte beachten Sie, dass der Schwenk auch zu einem späteren Zeitraum passieren kann.

  • Bereitstelldienst:

    Während des eigentlichen Schwenks ist der Bereitstelldienst nicht erreichbar. Bis zum Schwenk ist die alte Domain (pvog.fitko.de) verfügbar. Nach Abschluss des Schwenks müssen die Daten vom Bereitstelldienst über die neue Domain (pvog.fitko.net) abgerufen werden.

Wichtige Hinweise:

  • Bitte prüfen Sie, ob Sie PVOG-Endpunkte in eigenen Anwendungen oder Prozessen nutzen, und stellen Sie sicher, dass die Zugriffe nach dem Schwenk auf die neue Domain umgestellt werden.
  • Informieren Sie ggf. Ihre technischen Ansprechpartner und Entwicklerteams über den Ablauf und die notwendigen Anpassungen.
  • Weitere Informationen zum Domainumzug finden sich im Blogbeitrag Umzug auf pvog.fitko.net.

Für Rückfragen stehen wir Ihnen selbstverständlich gerne unter dataportpvogsupport@dataport.de zur Verfügung.

Vielen Dank für Ihre Aufmerksamkeit und Unterstützung!

API Keys

Eine Minute Lesezeit

Die Verwendung von API Keys ermöglicht schnellere und zielgerichtetere Unterstützung durch den PVOG Support bei Problemen oder API‑Änderungen.

API Keys können über das Formular auf dem Produktportal angefordert werden.

Zusätzlich ermöglicht die Nutzung von API Keys eine bessere Möglichkeit zur Benachrichtigung und Betreuung der API‑Konsumenten bei wichtigen Änderungen. Weitere Informationen sind hier auf dem Produktportal nachlesbar.

Wartungsarbeiten für Deployments PVOG Release 9.12

Eine Minute Lesezeit

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

  • 20.01.2026 (Dienstag) - Demo-Umgebung (stage.pvog.fikto.net)
  • 27.01.2026 (Dienstag) - PreProd/Stage-Umgebung (pvog-preprod.fitko.de)
  • 02.02.2026 (Montag) - Prod-Umgebung (pvog.fitko.de)

In diesem Release wird es während des Deployments auf der Prod-Umgebung zu Beeinträchtigungen kommen. Grund hierfür ist der Umzug auf den Hochverfügbarkeitscluster.

Die entstehenden Beeinträchtigungen bitten wir 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.12 wird nach dem Demo Deployment auf dem Produktportal unter Neuigkeiten/Release Notes veröffentlicht.

Wartungsarbeiten für Deployments PVOG Release 9.11

Eine Minute Lesezeit

Achtung! Abweichender Releaseprozess zum Jahresbeginn!

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

  • 7.1.2026 (Mittwoch) - Demo-Umgebung (stage.pvog.fikto.net)
  • 12.1.2026 (Montag) - PreProd/Stage-Umgebung (pvog-preprod.fitko.de)
  • 15.1.2026 (Donnerstag) - 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.10 wird nach dem Demo Deployment auf dem Produktportal unter Neuigkeiten/Release Notes veröffentlicht.

Validator API – neue Endpunkte

2 Minuten Lesezeit

Die Hauptaufgabe des Validators besteht in der technischen und fachlichen Prüfung der XZuFi-Dokumente, die über den Sammlerdienst in den Datenbestand des PVOG übernommen werden sollen. Dabei werden sowohl die Validierungsregeln als auch die technische Funktionalität der PVOG-Komponente Validator kontinuierlich weiterentwickelt, um eine zuverlässige und präzise Datenkontrolle zu gewährleisten.

Die Redaktionssysteme können zu übermittelnde Daten mithilfe spezieller Schnittstellen direkt gegen den Validator prüfen, bevor sie an den Sammlerdienst gesandt werden. Diese Validierung kann entweder manuell über den Validator Service oder maschinell per Validator APIs jeweils pro PVOG Umgebung erfolgen. Die Prüfergebnisse liegen direkt vor.

Im November 2025 wurden im Zuge dieser Weiterentwicklung zwei neue Validator Endpunkte eingeführt, die nicht abwärtskompatibel sind und speziell auf die Anforderungen technischer Dienstleister mehrerer Redaktionssysteme zugeschnitten sind.

Diese Umstellung auf die SchemeAgencyID dient der verbesserten Datenkontrolle und Systemzuordnung. Gleichzeitig wurde angekündigt, dass die bisherigen Schnittstellen validator-backend/api/v5/validiere und validator-backend/api/v6/validiere bis Mai 2026 abgekündigt werden, was eine Umstellung auf die neuen Endpunkte erforderlich macht.

Die Nutzung der Validator-Schnittstellen ist nicht öffentlich zugänglich, sondern setzt einen Benutzer mit entsprechendem Authentifizierungstoken voraus, um die Sicherheit und Integrität der Datenverarbeitung zu gewährleisten.

Redaktionssysteme, die Interesse an einem Zugang zum Validator Service oder einem automatisierten Abruf der Validatorergebnisse haben, werden gebeten, sich an den PVOG Support zu wenden, um entsprechende Zugänge und Unterstützung zu erhalten.

Für Nutzer des manuellen Validator-Services ergeben sich durch die Einführung der neuen Endpunkte keine Änderungen, sodass der bisherige Workflow unverändert fortgeführt werden kann.