Bezugnehmend auf unseren Newsletter vom 30.10.2024 erinnern wir an die Umstellung auf multipart/form-data.
Verschiebung:
Aufgrund von Rückfragen und unter Berücksichtigung der Anzahl an Vorsorgeeinrichtungen, die bisher immer noch mit multipart/mixed antworten, lässt sich ableiten, dass einige Vorsorgeeinrichtungen nicht hinreichend auf den bisher geplanten Wechsel zum 01.07.2025 vorbereitet sind. Natürlich hat die lückenlos funktionierende Kommunikation höchste Priorität. Daher erfolgt die Umstellung nun erst zum 24.07.2025. Die Zentrale Stelle für die Digitale Rentenübersicht (ZfDR) unterstützt den Content-Typ multipart/mixed nur noch bis zum 23.07.2025.
Bei Klärungsbedarf kommen Sie bitte zeitnahe auf uns zu.
Zusammengefasste Details zur Schnittstellenanpassung:
Bei der Änderung des Media-Typs von multipart/mixed in multipart/form-data sind verschiedene Punkte zu beachten.
Der Content-Typ multipart/form-data bietet über einen Content-Disposition Header die Möglichkeit, für Multipart-Attachments einen Namen zu vergeben. Die ZfDR nutzt diesen Header, um die Referenz zwischen dem Baustein im JSON-Attachment und der dazugehörigen PDF herzustellen.
Der Content-Disposition Header hat dabei folgenden Aufbau:
Content-Disposition: form-data; name="standmitteilung_referenz_01"
Es ist zu beachten, dass die Content-Disposition „form-data“ immer in exakt dieser Form am Anfang des Headers stehen muss. Die Namensvergabe des Attachments erfolgt über das Feld "name", welches für die Herstellung der Referenz zu dem dazugehörigen Unterbaustein über das JSON-Feld "standmitteilung_referenz" verwendet wird.
Da die Referenzierung über den Content-Disposition Header stattfindet, entfällt auch der vorher genutzte Custom-Header "X-Standmitteilung-Referenz".
Folgende Dokumentationen, welche auf der Internetseite für die Vorsorgeeinrichtungen zu finden sind, enthalten entsprechende Informationen bereits seit November 2024 und wurden nun für ein besseres Verständnis in den betroffenen Kapiteln erneut redaktionell überarbeitet:
- Kommunikationshandbuch - Verfahren (Version 05.00.00)
- Kommunikationshandbuch - technische Grundlagen (Version 12.00.00)
- Datenbeschreibung (Version 09.00.00)
- Schnittstellen-Beschreibung (Version 2.0.1 entfernt, Version 3.0.1 eingefügt)
Im Versionswechsel der Schnittstellen-Beschreibung von 3.0.0 zu 3.0.1 wurden keine funktionalen Änderungen vorgenommen, lediglich eine Beschreibung wurde angepasst.