Schritt-für-Schritt-Anleitung

Um einen Onlinedienst oder ein Verwaltungssystem an FIT-Connect anzubinden, empfehlen wir den folgenden Stufenplan:

Bevor es losgeht ...

Einstieg und Kontakt

Bevor Sie mit der technischen Umsetzung beginnen, empfehlen wir Ihnen den Einstieg über die folgende Seite: Einstieg in die Anbindung

Wenn Sie bereits wissen, was Sie umsetzen möchten, können Sie hier direkt starten. Andernfalls: Nutzen Sie frühzeitig bei Fragen oder zur weiteren Abstimmung unser Kontaktformular.

Projektteam vorbereiten

Für eine erfolgreiche Umsetzung empfehlen wir, frühzeitig folgende Rollen einzubinden:

• Fachlich Verantwortliche (z. B. für Zuständigkeiten, FIM/XÖV, Zertifikate)
• Technische Ansprechpersonen (z. B. Entwickler:innen, Architekt:innen)
• Datenschutz und IT-Sicherheit (für rechtliche und technische Abstimmungen)

Technisch Verantwortliche sollten die Entwicklerdokumentation kennen.

Unterschied Onlinedienst und Verwaltungssystem

Weiterhin sollte klar sein, was sie an FIT-Connect anbinden wollen: Einen Onlinedienst, ein Verwaltungssystem oder beides? Konzeptionell und organisatorisch ergibt sich daraus kein wesentlicher Unterschied, für die Entwicklung hingegen schon.

Was Sie wann beachten müssen, haben wir in den folgenden Tabellen in den Spalten Onlinedienst und Verwaltungssystem hervorgehoben.

1 Konzeptionelle Vorüberlegungen

Die konzeptionellen Vorüberlegungen sollten möglichst vor Beginn der Implementierung abgeschlossen sein. Wir empfehlen grundsätzlich, die fachlich Verantwortlichen durch technisch versiertes Personal zu unterstützen, da viele der Fragen ineinandergreifen.

1.1 Organisatorische und fachliche Vorüberlegungen

Zielgruppe: Fachseite Behörde Unternehmen

Im ersten Schritt sollten durch die Behörde fachliche Fragestellungen rund um die Leistung beantwortet werden, die entweder durch den Onlinedienst abgebildet oder durch das Verwaltungssystem verarbeitet werden.

Ziel der Vorüberlegungen

Die Vorüberlegungen helfen dabei, die Voraussetzungen für eine digitale Antragstellung über FIT-Connect strukturiert zu erfassen. Sie ermöglichen es, frühzeitig relevante Informationen zu klären, z. B. welche Verwaltungsleistung digitalisiert werden soll, welches System dafür genutzt wird und wie Daten technisch übertragen werden können. Diese Übersicht unterstützt Sie dabei, alle beteiligten Systeme, Zuständigkeiten und technischen Anforderungen im Blick zu behalten.

Nr.	Aufgabe	Online- dienst Behörde	Onlinedienst/ Unternehmen	Verwaltungs- system Behörde	Verwaltungssystem/ Unternehmen
1	Bestimmen Sie die Verwaltungsleistung, die Bürger:innen online beantragen sollen.	✅	✅	✅	✅
2	Ermitteln Sie, welches Verwaltungssystem für die Abwicklung dieser Leistung genutzt werden soll.	❌	❌	✅	✅
3	Ermitteln Sie den Leistungsschlüssel (LeiKa-Schlüssel) der ausgewählten Leistung.	✅	✅	✅	✅
4	Ermitteln Sie, wie das Verwaltungssystem auf Anträge antwortet und auf welchem Weg (ZBP, FIT-Connect, ELSTER, FINK, E-Mail oder Brief) Bescheide kommen.	❌	❌	✅	✅
5	Identifizieren Sie die zuständige öffentliche Stelle, bei der die Leistung online beantragt werden soll, und prüfen Sie die Online-Erreichbarkeit.	✅	✅	❌	❌
6	Bestimmen Sie die zuständige Behörde anhand des Amtlichen Regionalschlüssels (ARS).	❌	❌	✅	✅
7	Geben Sie an, welches Datenformat (FIM- oder XÖV-Schema) das Verwaltungssystem für die Übermittlung von Fachdaten verwendet.	✅	✅	✅	✅
8	Prüfen Sie, ob für diese Leistung bereits bestehende Onlinedienste zur Nachnutzung verfügbar sind.	✅	✅	❌	❌

1.2 Technische Vorüberlegungen

Zielgruppe: Entwicklung Behörde Unternehmen

In diesem Schritt klären die technischen Ansprechpersonen für die Verwaltungssysteme bzw. Onlinedienste die erforderlichen Implementierungen an ihrem System.

Nr.	Aufgabe	Online- dienst Behörde	Onlinedienst/ Unternehmen	Verwaltungs- system Behörde	Verwaltungssystem/ Unternehmen
	Unterstützung von RESTful APIs
1	Prüfen, ob das System RESTful APIs unterstützt.	✅	✅	✅	✅
2	Integration der API-Endpunkte gemäß FIT-Connect-Dokumentation.	✅	✅	✅	✅
	Datenformate
3	Sicherstellen, dass standardisierte Datenformate (z. B. JSON, XML) unterstützt werden.	✅	✅	✅	✅
4	Auswahl und technische Umsetzung des passenden Fachdatenschemas (FIM- oder XÖV-Schema).	✅	✅	✅	✅
5	Abstimmung und Implementierung der richtigen Version des Metadatenschemas mit dem Verwaltungssystem.	✅	✅	❌	❌
	Webdienstintegration
6	Integration der notwendigen Webdienste in den Onlinedienst ermöglichen.	✅	✅	❌	❌
7	Technische Umsetzung des Rückkanals für Bescheide (z. B. FIT-Connect, ELSTER, FINK, E-Mail, Brief, ZBP).	✅	✅	✅	✅
8	Entscheidung und technische Umsetzung von Callback- oder Polling-Unterstützung.	✅	✅	✅	✅
	Fehlerbehandlung
9	Dokumentation und Zugriff auf bekannte Fehlercodes sicherstellen.	✅	✅	❌	❌
10	Umsetzung der Fehlerbehandlung nach den Vorgaben der FIT-Connect-Dokumentation.	❌	❌	✅	✅
11	Implementierung technischer Mechanismen zur robusten Fehlerbehandlung im System.	✅	✅	✅	✅

2 Organisatorische und rechtliche Vorbereitung

Zielgruppe: Fachseite Behörde Unternehmen

Für die späteren Schritte 4 (Regressionstests) und 5 (Produktivsetzung) wird ein Zugang zur Stage- und Produktionsumgebung benötigt. Dafür sind einige Vorbereitungen notwendig. Unter anderem müssen Sie bei der erstmaligen Anmeldung den Nutzungsbedingungen und dem AVV zustimmen. Hierzu gibt es häufig Klärungsbedarf. Planen Sie daher für diese Arbeitsschritte mehrere Wochen ein, da interne Abstimmungen, Rückfragen und auch die Anforderung von Zertifikaten häufig länger dauern als ursprünglich angenommen.

Die organisatorische und rechtliche Vorbereitung kann parallel zur Implementierung (Schritt 3) von FIT-Connect erfolgen, da die Entwicklung und Implementierung von FIT-Connect auf der Test-Umgebung stattfindet. Um diese nutzen zu können, sind keine Vorbereitungen notwendig.

Nr.	Aufgabe	Online- dienst Behörde	Onlinedienst/ Unternehmen	Verwaltungs- system Behörde	Verwaltungssystem/ Unternehmen
	Anlegen eines Self-Service-Portal-Kontos auf der Stage- und Produktionsumgebung
1	Beschaffen Sie sich ein Mein Unternehmenskonto-Zertifikat für den Login auf Stage- und Produmgebung. Die Schritte dafür sind unter "Login mit Mein Unternehmenskonto" beschrieben.	✅	✅	✅	✅
2	Anmeldung auf der Stage- und Produktionsumgebung. Den Link finden Sie auf unserer Webseite oder im Self-Service-Portal.	✅	✅	✅	✅
	Rechtliche Themen
3	Beachten Sie, dass Sie bei der Ersteinwahl auswählen, ob Sie ein Verwaltungssystem oder Onlinedienst sind, sodass Ihnen die richtigen Vertragsunterlagen zur Unterzeichnung dargestellt werden. Falls Sie diese nicht unterzeichnen können, wenden Sie sich bitte an das Anbindungsmanagement. Stimmen Sie den Nutzungsbedingungen zu. Den Nutzungsbedingungen stimmen Sie zu, während Sie sich das erste Mal auf der Stage- bzw. Produktionsumgebung anmelden. Sie können und sollten diese aber bereits vorher geprüft haben. Sie finden diese unter Nutzungsbedingungen. Die Adressaten sind die rechtlichen Vertreter:innen des Onlinedienstes, die FIT-Connect für ihren Onlinedienst nutzen wollen. Wenn Sie diesen einmal zugestimmt haben, gelten diese für alle Anbindungen mit FIT-Connect.	✅	✅	✅	✅
4	Wenn Sie ein Onlinedienst sind, müssen Sie zusätzlich den Auftragsverarbeitungsvertrag (AVV) abstimmen und unterzeichnen. Hier gilt (wie bei den Nutzungsbedingungen), dass diese erst ab der Stage- bzw. Produktionsumgebung erforderlich sind.	✅	✅	❌	❌
	Zertifikate
5	Beschaffung und Bestätigung des V-PKI-Zertifikats über die zuständige Landes-Registrierungsstelle. Wo und wie Sie V-PKI-Zertifikate beschaffen können, erfahren Sie unter "Zertifikate beantragen".	✅	✅	✅	✅
6	Umwandlung des V-PKI-Zertifikats mit Hilfe von Python (JWK-Tool). Wie das geht, erfahren Sie unter "Umwandlung eines Zertifikats".	✅	✅	✅	✅

3 Implementierung von FIT-Connect

Parallel zu den organisatorischen Vorbereitungen sollte mit der Entwicklung und Implementierung von FIT-Connect begonnen werden.

3.1 Implementierung von Schnittstellen

Zielgruppe: Entwicklung Behörde Unternehmen

Im ersten Schritt wird der Onlinedienst bzw. das Verwaltungssystem an die Testumgebung von FIT-Connect angebunden. Der Schwerpunkt liegt auf dem Test einzelner Funktionen des Onlinedienstes bzw. Verwaltungssystems. Das Testsystem von FIT-Connect ist öffentlich verfügbar. Eine technische Schritt-für-Schritt-Anleitung für die Anbindung an FIT-Connect finden Sie in der Entwicklerdokumentation.

Um die Anbindung Ihrer Fachanwendung an FIT-Connect auf technisch effiziente Weise umzusetzen, stehen zeitgemäße Software Development Kits (SDKs) und Programmierschnittstellen (APIs) bereit. Diese unterstützen Ihre Entwickler:innen dabei, Anträge medienbruchfrei zu übertragen, Zustellpunkte automatisiert zu verwalten oder Rückmeldungen sicher zu empfangen.

Die SDKs enthalten wiederverwendbare Code-Bausteine und Best Practices für verschiedene Programmiersprachen (Java, .NET und JavaScript). Über die REST APIs können Ihre Systeme direkt mit FIT-Connect kommunizieren – zum Beispiel für das Versenden von Anträgen oder den Abruf von Rückkanalnachrichten.

Bitte geben Sie diesen Hinweis an Ihre technischen Ansprechpartner:innen weiter, damit diese prüfen können, welches SDK oder welche API für Ihre Anwendung am besten geeignet ist.

Nr.	Aufgabe	Online- dienst Behörde	Onlinedienst/ Unternehmen	Verwaltungs- system Behörde	Verwaltungssystem/ Unternehmen
1	Datenbereitstellung: Onlinedienst stellt Anwendungsdaten aus der Onlinedienstplattform dem Verwaltungssystem bereit.	✅	✅	✅	✅
2	Möglichkeit zur Abfrage von Daten besteht.	✅	✅	✅	✅
3	Ereignisprotokollierung für Statusänderungen implementieren.	✅	✅	✅	✅
4	Echtzeitdatenübertragung durch den Onlinedienst ist technisch möglich (falls erforderlich).	✅	✅	✅	✅

3.2 Konfigurieren der Testumgebung auf dem Self-Service-Portal

Zielgruppe: Entwicklung Behörde Unternehmen

Damit die Schnittstelle getestet werden kann, bedarf es eines Testaufbaus, der den Versand vom Onlinedienst in das Verwaltungssystem simuliert. Wenn Sie nur einen Onlinedienst bzw. Verwaltungssystem aninden wollen, müssen Sie den fehlenden Teil, beispielsweise mit unseren SDKs, simulieren oder direkt mit der Gegenstelle testen.

Nr.	Aufgabe	Online- dienst Behörde	Onlinedienst/ Unternehmen	Verwaltungs- system Behörde	Verwaltungssystem/ Unternehmen
	Anbindung an das Testsystem
1	Aufbau einer Test-Umgebung für die FIT-Connect-Anbindung.	✅	✅	✅	✅
2	Testaufbau für einen Onlinedienst zum Versenden von Einreichungen an einen Zustellpunkt bereitstellen.	❌	❌	✅	✅
3	Testaufbau für ein Verwaltungssystem, das die Einreichungen vom Zustellpunkt abholt, bereitstellen.	✅	✅	❌	❌
4	Anmeldung in der Testumgebung des FIT-Connect Self-Service-Portals.	✅	✅	✅	✅
5	Zertifikatserstellung für Testzwecke. Es gibt drei mögliche Tools. Informationen und Downloads dazu finden Sie unter "Zertifikate umwandeln". Für das Testsystem wird noch kein Verwaltungs-PKI benötigt.	❌	❌	✅	✅
6	Anlegen eines Zugangs für den Onlinedienst. Eine technische Schritt-für-Schritt-Anleitung finden Sie unter "Accountregistrierung und Zugangsdaten-Verwaltung".	✅	✅	✅	✅
7	Anlegen eines Zustellpunktes für das Verwaltungssystem. Eine technische Schritt-für-Schritt-Anleitung finden Sie unter "Zustellpunkt erhalten".	✅	✅	✅	✅

3.3 Testen von FIT-Connect auf der Testumgebung

Zielgruppe: Entwicklung Behörde Unternehmen

Nr.	Aufgabe	Online- dienst Behörde	Onlinedienst/ Unternehmen	Verwaltungs- system Behörde	Verwaltungssystem/ Unternehmen
	Integrationstests auf dem Testsystem
1	Klärung des Testablaufs mit den beteiligten Dienstleistern.	✅	✅	✅	✅
2	Testen eines erfolgreichen Durchstichs: Übermittlung eines Antrags vom Onlinedienst über FIT-Connect an ein Verwaltungssystem. Weitere Informationen finden Sie unter "Verwaltungssysteme".	✅	✅	✅	✅
3	Durchführung einer Sicherheitsüberprüfung. Der Sicherheitsverantwortliche oder das IT-Security-Team muss prüfen, ob FIT-Connect den internen Sicherheitsanforderungen genügt. Bei Rückfragen melden Sie sich gerne beim Anbindungsmanagement.	✅	✅	✅	✅
4	Externe Sicherheitsprüfung für die Schnittstellen durchführen.	✅	✅	✅	✅

4 Regressionstests für die eigene Abnahme

4.1 Konfiguration im Self-Service-Portal der Stage- und Produktionsumgebung

Zielgruppe: Entwicklung Behörde Unternehmen

Es ist zwar nicht verpflichtend, aber wir empfehlen Regressionstests für die eigene Abnahme der entwickelten Schnittstellen. Wir stellen dafür eine zur Produktions-Umgebung deckungsgleiche Stage-Umgebung zur Verfügung.

Voraussetzung für diesen Schritt ist die Umsetzung der Aufgaben aus Abschnitt 2 "Organisatorische und rechtliche Vorbereitung". Für diesen Schritt sollten nun das Zertifikat von Mein Unternehmenskonto und das V-PKI-Zertifikat zur Ver- und Entschlüsselung der übertragenen Daten vorliegen.

Nr.	Aufgabe	Online- dienst Behörde	Onlinedienst/ Unternehmen	Verwaltungs- system Behörde	Verwaltungssystem/ Unternehmen
1	Einwahl in die Stage- und Prod-Umgebung.	✅	✅	✅	✅
2	Stage-Umgebung konfigurieren; analog wie in der Test-Umgebung, siehe Abschnitt 3.2. Beachten Sie, dass Sie bei der Ersteinwahl auswählen, ob Sie ein Verwaltungssystem oder Onlinedienst sind, sodass Ihnen die richtigen Vertragsunterlagen zur Unterzeichnung dargestellt werden. Falls Sie diese nicht unterzeichnen können, wenden Sie sich bitte an das Anbindungsmanagement; dieses kann Ihnen die Vertragsunterlagen per E-Mail zusenden.	✅	✅	✅	✅
3	Prod-Umgebung konfigurieren; analog wie in der Test-Umgebung, siehe Abschnitt 3.2. Beachten Sie, dass Sie bei der Ersteinwahl auswählen, ob Sie ein Verwaltungssystem oder Onlinedienst sind, sodass Ihnen die richtigen Vertragsunterlagen zur Unterzeichnung dargestellt werden. Falls Sie diese nicht unterzeichen können, wenden Sie sich bitte an das Anbindungsmanagement; dieses kann Ihnen die Vertragsunterlagen per E-Mail zusenden.	✅	✅	✅	✅
4	Absprache mit Verwaltungssystem und Behörde über deren Anbindungsfortschritt und weitere Testungen. Dies müssen Sie nur durchführen, wenn die Abnahme mit dem Onlinedienst oder Verwaltungssystem eines anderen Dienstleisters erfolgt.	✅	✅	✅	✅

4.2 Regressionstests auf der Stage-Umgebung

Zielgruppe: Entwicklung Behörde Unternehmen

IT-Dienstleister führen hier nochmals alle Tests aus, um zu überprüfen, ob das Verwaltungssystem und der Onlinedienst auch gegen das Referenzsystem von FIT-Connect fehlerfrei arbeiten.

Nr.	Aufgabe	Online- dienst Behörde	Onlinedienst/ Unternehmen	Verwaltungs- system Behörde	Verwaltungssystem/ Unternehmen
1	Durchführung aller Tests durch IT-Dienstleister, um fehlerfreies Arbeiten gegen die Stage-Umgebung von FIT-Connect zu gewährleisten.	✅	✅	✅	✅

5 Produktivsetzung

Zielgruppe: Entwicklung Behörde Unternehmen

Der Onlinedienst ist nun mit dem Produktivsystem von FIT-Connect verbunden und kann Anträge von Bürger:innen entgegennehmen und diese an das Verwaltungssystem weiterleiten. Damit ist die Anbindung abgeschlossen.

Nr.	Aufgabe	Online- dienst Behörde	Onlinedienst/ Unternehmen	Verwaltungs- system Behörde	Verwaltungssystem/ Unternehmen
1	Bestätigung der Bereitschaft für die Nutzung in der Produktivumgebung. Dies müssen Sie individuell in Ihrer Organisation (Behörde bzw. Unternehmen) bzw. mit den Herstellern und IT-Dienstleistern vereinbaren.	✅	✅	✅	✅
2	Eintragung in das FIM-Redaktionssystem. Damit das Verwaltungssystem der Behörde über die FIT-Connect Routingarchitektur auffindbar ist, müssen die von FIT-Connect bereitgestellten signierten Adressierungsinformationen zunächst im jeweiligen FIM Bundes- oder Landesredaktionssystem hinterlegt werden. Weitere Informationen dazu finden Sie auf der Seite "Antragsrouting konfigurieren".	✅	✅	✅	✅

6 Überführung in den Regelbetrieb

Zielgruppe: Entwicklung Behörde Unternehmen

Nr.	Aufgabe	Online- dienst Behörde	Onlinedienst/ Unternehmen	Verwaltungs- system Behörde	Verwaltungssystem/ Unternehmen
1	Abschluss einer Wartungsvereinbarung für die Schnittstellen. Wir empfehlen den Abschluss einer Wartungsvereinbarung mit Ihrem IT-Dienstleister.	✅	✅	✅	✅
2	Implementierung eines klar definierten Update-Mechanismus für Schnittstellenänderungen. Updates erhalten Sie grundsätzlich über Ihre hinterlegte E-Mail-Adresse im Self-Service-Portal-Account. Weiterhin empfehlen wir Ihnen die Abkündigungen und das Changelog regelmäßig einzusehen.	✅	✅	✅	✅