Aufgrund geringfügiger Fehler im letzten Newsletter vom 18.12.2025 stellen wir Ihnen heute die korrigierte Fassung zur Verfügung. Bitte beachten Sie die entsprechend fett/kursiv markierten Stellen.

Zusätzliche Informationen bei angepasst synchroner Anfrage

Mit Release d23 am 09.07.2026 wird ermöglicht, dass Rückmeldungen der Vorsorgeeinrichtungen mit einem unzulässigem retry-after-Zeitraum mit neuen zusätzlichen Informationen quittiert werden. Dazu wird in der Anfrage-Schnittstelle ein neuer http-Custom-Header „X-Max-Retry-After“ gesendet. Dieser kann die Vorsorgeeinrichtung verwenden um einen validen „Retry-After“-Wert in einer http202-Antwort zu ermitteln. Ergänzend dazu wird eine neue Fehlernummer eingesetzt. Die Fehlernummer _0006 (Unzulässigen retry-after-Zeitraum vorgegeben) wird immer dann ausgelöst, wenn die ZfDR infolge einer Anfrage eine Nachricht der Vorsorgeeinrichtung mit Statuscode http202 (Aufforderung zur erneuten Anfrage) erhält, deren avisierter Zeitpunkt der erneuten Anfrage außerhalb des definierten Retry-After-Zeitraums im „X-Max-Retry-After“-Header liegt. Zusätzlich wird der Vorsorgeeinrichtung mit dem Fehler mitgeteilt, welcher maximale retry-after-Zeitraum zugelassen ist und um welchen Nachfrageversuch der ZfDR es sich handelt.

Die OpenAPI-Spezifikation wird im ersten Schritt mit diesem Newsletter entsprechend erweitert.

Ab dem 09.07.2026 wird die ZfDR immer den neuen Header „X-Max-Retry-After“ senden und wird immer, wenn die Vorsorgeeinrichtung einen ungültigen retry-after-Zeitraum anbietet, folgende Informationen zurückmelden:

• die neue Fehlernummer,
• den maximalen retry-after-Zeitraum und
• den Zähler für den Nachfrageversuch (1 bis 5)

Vorsorgeeinrichtungen, die nicht genau am 09.07.2026 releasen, sollten die oben genannten neuen Attribute ab diesem Tag optional verarbeiten können, sodass sie Daten der ZfDR verarbeiten können, die bis zum 09.07.2026 ohne die neuen Merkmale und ab dem 09.07.2026 mit den neuen Merkmalen von der ZfDR übermittelt werden.

Aktualisierung Kommunikationshandbuch (technisch), Datenbeschreibung und Schnittstellenbeschreibung (OpenAPI Spezifikation)

Das technische Kommunikationshandbuch (KHB) enthält neben den Informationen über die neue Fehlernummer _0006 mit ihren beiden Zusatzinformationen (s.o.) auch Ausführungen zum Thema Zertifikatserneuerung und einen Hinweis auf zusätzliche nicht verarbeitungsrelevante Parameter.

Die Datenbeschreibung wurde ebenfalls um die neue Fehlernummer _0006 erweitert. Zudem wurde die Zeichenanzahl des Attributes ‚standmitteilung_referenz‘ erhöht.

Die Änderungen in KHB und Datenbeschreibung können Sie auch den jeweiligen Änderungsübersichten entnehmen.

Die OpenAPI Spezifikation ‚Schnittstellenbeschreibung_3.1.0.yaml‘ wurde insbesondere wie folgt geändert:

• Attribut ‚standmitteilung_referenz‘ Zeichenlänge von 40 auf 254 geändert
• Fehlernummer_0006 neu aufgenommen (vgl. technisches KHB und Datenbeschreibung)
• X-Max-Retry-After als neuer Header in den Anfragedaten, maximal möglicher Wiederanfragezeitraum
• max_retry_after und nachfragezaehler als neue Attribute in den Fehlerdaten, analog zu Anfragedaten