Submission API Nutzung klarer ausformulieren

Dokumentationsseiten (Pflichtfeld)

• Neue Dokumentationsseite
• Bestehende Dokumentationsseite (Submission API) anpassen

User Story

Als Anbindungsprojekt möchte ich Fachverfahren so gestalten, dass die Übermittlung von Antragsdaten direkt über die Submission API von FIT-Connect erfolgt. Dadurch können Behörden und IT-Dienstleister Anträge standardisiert, sicher und effizient übermitteln – ohne eigene Transportinfrastruktur entwickeln zu müssen.

Warum

Die Submission API ist die zentrale Schnittstelle, über die strukturierte Antragsdaten von Portalen, Formularservern oder Fachverfahren an die zuständigen Behörden übermittelt werden.
Mit ihr lassen sich:

• Anträge sicher und Ende-zu-Ende-verschlüsselt über FIT-Connect übermitteln,
• Metadaten (z. B. Leistung, Fachdatenschema, Zuständigkeit) eindeutig zuordnen,
• Anhänge, Nachweise und strukturierte XML-Daten gemeinsam transportieren,
• sowie Empfangsbestätigungen und Statusmeldungen austauschen.

Die Integration der Submission API reduziert den Aufwand für eigene Übermittlungslogik und stellt sicher, dass alle Nachrichten auf demselben föderalen Transportstandard basieren. Damit unterstützt sie unmittelbar die Interoperabilität zwischen Bund, Ländern und Kommunen.

Erkenntnis → Was muss dokumentiert werden? (Pflichtfeld)

Die Dokumentation zur Submission API sollte erweitert werden um:

• Einen praxisnahen Überblick, wie Onlinedienste und Fachverfahren Anträge über FIT-Connect einreichen können.
• Beispielabläufe für typische Nutzungsszenarien:
  1. Portal erstellt Submission-ID und überträgt strukturierte Antragsdaten.
  2. Metadaten (Leistung, Zuständigkeit, Rückkanal) werden ergänzt.
  3. Antragsunterlagen und Nachweise werden verschlüsselt hochgeladen.
  4. FIT-Connect leitet die Submission über die Routing API an den korrekten Zustellpunkt weiter.
  5. Empfangsbestätigung erfolgt über den Reply Channel oder ein Event.
• Erklärung der Zusammenhänge zwischen Submission-, Routing- und Destination API.
• Hinweise zu Authentifizierung, Verschlüsselung (VPKI / JWK) und Zertifikatsmanagement.
• Best Practices für Entwickler:innen, wie sich Submission-APIs in bestehende Systeme integrieren lassen.

Ziel ist, sowohl technische als auch organisatorische Akteure zu befähigen, FIT-Connect effizient in Fachverfahren und Portale einzubinden.

Links, Hinweise, Bemerkungen

• Bestehende Seite: Submission API
• Verwandte Themen:
  • Metadata 2.0 – Strukturierte Datencontainer
• Rücksprache mit FITKO-Rechtsabteilung empfohlen (bzgl. Delegation und Datenverarbeitung).

Ansprechperson (Pflichtfeld)

• Zuständige PO: Laura Elges
• Technische Ansprechperson: Andreas Aschauer

Akzeptanzkriterien (Pflichtfeld)

1. Die Dokumentation beschreibt den vollständigen Ablauf einer Submission über FIT-Connect.
2. Der technische und organisatorische Nutzen der Submission API ist klar dargestellt.
3. Beispiele zur Integration in Portale und Fachverfahren sind ergänzt.
4. Authentifizierung (ClientID/ClientSecret, Zertifikate) und Verschlüsselung (VPKI/JWK) sind erläutert.
5. Das Zusammenspiel mit Routing API und Destination API ist verständlich beschrieben.
6. Metadatenstruktur (LeiKaIDs, Fachdatenschema, Rückkanäle) ist dokumentiert.
7. Hinweise zur Verarbeitung von Anhängen und Fachdatensätzen sind enthalten.

Mögliche Folgeaktivitäten (vom Entwickler zu ergänzen)

• Definition of Done wurde überprüft.