[Epic] ZBP-Adapter ermöglicht bidirektionale Kommunikation

Warum

Ab voraussichtlich Oktober 2025 wird die Integrationsumgebung des ZBP die bidirektionale Kommunikation unterstützen.

Ziel

Als Bürger möchte ich auf die Nachricht einer Behörde antworten können.
Als Behörde möchte ich Antworten auf per Nachricht an das ZBP gestellte Nachfragen erhalten können, auch wenn mein Fachverfahren keinen Zugriff auf das Verbindungsnetz hat.

Links, Hinweise, Bemerkungen

Vorabversion der Schnittstellenbeschreibung mit BiDiKoZBP_Schnittstellenbeschreibung_Zentrales_Bürgerpostfach_R4.0.0.0_V1.1_mit_BiDi.pdf

• Die BiDiKo des ZBP wird mithilfe der BiDiKo von FIT-Connect realisiert.
• Alle für die Zustellung der Rückantwort relevanten Informationen (caseId und Encryption Key) werden vom ZBP-Adapter signiert der Nachricht an das ZBP im Feld routingInfomitgegeben.
• Diese Information sind dann in der Rückantwort enthalten.
• Der ZBP-Adapter prüft bei Antworten die Signatur des Inhalts von routingInfo und verwendet die Daten zum Senden eines Replys bzw. setzt ansonsten den Status der Antwort auf Error. Nach erfolgreichen Senden wird der Status auf COLLECTED gesetzt.
• Der ZBP-Adapter ruft den Status der gesendeten Replys ab. Sollte es ein accept / reject Event geben, wird der Status der Antwort beim ZBP entsprechend gesetzt.
• Die API des ZBP zum Abrufen von Antworten gestaltet sich folgendermaßen: "An den Anfrager gibt die Schnittstelle immer die neuen Antwortnachrichten zurück, die seit der letzten Abholanfrage neu eingegangen und für welche durch den Anfrager die Abholung noch nicht mindestens mit dem Status “COLLECTED” quittiert worden sind.". Solle keine Möglichkeit geschaffen werden, Genau die Antworten im Status “COLLECTED” abzurufen, muss der ZBP-Adapter die IDs der von ihm versendeteten Replys persistieren, zu denen es noch kein accept/reject gibt. ITZBund wüeder bevorzugen, wenn dazu ein eignerer mit dem ZBP-Adapter ausgelieferter DB-Container verwendet werden würde.

Stories

Akzeptanzkriterien

1. Der ZBP-Adapter gibt bei Nachrichten, die eine Antwort erlauben (Feld replyAllowed), im Feld routingInfo signiert die caseIdund den Encryption Key mit.
2. Der ZBP-Adapter ruft in konfigurierbaren Intervallen Antworten beim ZBP ab und sendet diese anhand der routingInfo der Antwort als Reply an den betreffenden case und setzt anschließend den Status der Antwort auf COLLECTED. Dabei wird die Signatur der routingInfo geprüft und im Fehlerfall der Status auf ERROR gesetzt.
3. Der ZBP-Adapter ruft in konfigurierbaren Intervallen den Status der offenen Replys ab und setzt den Status der Antwort beim ZBP auf DELIVERED bzw. ERROR, sobald ein accept- bzw. reject-Event vorliegt.
4. Definition of Done wurde überprüft.

Mögliche Folgeaktivitäten

Offene Fragen

• Das ZBP kann anscheinend eine Benachrichtigung über das Lesen einer Nachricht an den Sender zurückgeben. Die könnte evtl. per FIT-Connect-BiDiKo an das sendende System übermittelt werden.