EntwicklungsressourcenFöderale IT-StandardsPVOG - ein Produkt der Fitko
QuellcodeFeedback
Zum Hauptinhalt springen

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.

Informationen zum PVOG auf dem Produktportal

2 Minuten Lesezeit

Das Portalverbund Online-Gateway (PVOG) fungiert als integrative Plattform, die die Verwaltungsportale und Redaktionssysteme des Bundes sowie der Länder miteinander verknüpft und kontinuierlich weiterentwickelt wird. Die fortlaufende Entwicklung des PVOG wird transparent gestaltet, indem Interessierte die Möglichkeit erhalten, diese Prozesse in regelmäßigen Veranstaltungen wie der monatlichen UserGroup sowie dem Sprint Review am Ende jedes Entwicklungszyklus, jeweils donnerstags, zu verfolgen und aktiv zu begleiten.

Für fachliche Rückfragen zur Funktionsweise des PVOG, den Zugriffsmöglichkeiten auf die bereitgestellten Daten sowie allgemeine Anliegen steht der PVOG Support über den Helpdesk des Produktportals PVOG Helpdesk | PVOG Produktportal oder per E-Mail zur Verfügung.

Das Produktportal des PVOG wird zukünftig als umfassende Informationsquelle erweitert. Was ist neu?

  • Der Bereich Dienste / Bereitstelldienst wurde um FAQ ergänzt. Hier wird zum Beispiel die Frage beantwortet, wer Zugriff auf die PVOG Daten über den Bereitstelldienst bekommen kann.
  • Die Antworten im Bereich Dokumentation / FAQ haben den Fokus auf allgemeine Fragen zum PVOG, wie zum Beispiel die Releaseplanung.
  • Im Glossar werden einzelne Begriffe erläutert. Melden Sie sich gern, wenn für Sie relevante Begriffe nicht enthalten sind.
  • Um die Anliegen der UserGroup und die angesprochenen Themen des monatlichen Treffens für Interessierte zu veröffentlichen, wurde dieser Bereich des Produktportals um die Präsentationen und Protokolle der letzten sechs Treffen ergänzt. Hier finden Sie auch den Termin der nächsten User Group.
  • Das Sprint Review am Ende jedes Sprint berichtet über die technische Weiterentwicklung des PVOGs. Um auch hier die Informationen weiter zu verbreiten, sind die Präsentationen des Sprint Reviews als Download einsehbar.

Technische Erkennung abgekündigter Schnittstellen

Eine Minute Lesezeit

Das PVOG wird kontinuierlich in seinen Komponenten weiterentwickelt; auch hinsichtlich der Schnittstellen, über die Daten aus den Redaktionssystemen abgerufen und bereitgestellt werden.

Die Weiterentwicklung der Schnittstellen manifestiert sich in der Einführung neuer API-Versionen bei größeren Verbesserungen. Dies führt dazu, dass ältere API-Versionen nach einem definierten Zeitraum abgeschaltet werden, um die Schnittstellen effizient mit neuen Funktionalitäten erweitern zu können.

Die Abschaltung veralteter API-Versionen ist somit ein notwendiger Schritt zur Sicherstellung der Weiterentwicklung und Modernisierung der Schnittstellen.

Nutzer werden über die Abkündigung (Deprecation) von Schnittstellen auf mehreren Wegen informiert:

Header Darstellung beispielhaft im Suchdienst

Technisch signalisiert eine als deprecated gekennzeichnete API in der Antwort den Header „x-pvog-deprecated: true“, während aktuelle Schnittstellen diesen Header nicht enthalten. Dies ermöglicht eine automatisierte Erkennung veralteter Schnittstellen durch die Nutzer.

(Text überarbeitet von LLMoin)

Wartungsarbeiten für Deployments PVOG Release 9.10

Eine Minute Lesezeit

Achtung! Abweichender Releaseprozess wegen Jahresende!

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

  • 3.12.2025 (Mittwoch) - Demo-Umgebung (stage.pvog.fikto.net)
  • 8.12.2025 (Montag) - PreProd/Stage-Umgebung (pvog-preprod.fitko.de)
  • 11.12.2025 (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.

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 .