Zum Hauptinhalt springen

Zustellpunkt anlegen

Um Einreichungen (Anträge) über FIT-Connect zu empfangen, muss ein Zustellpunkt angelegt (konfiguriert) sein. Zum Anlegen eines Zustellpunktes nutzen Sie das Self-Service-Portal (SSP).

Self-Service-Portal

Sie erreichen das SSP, indem Sie auf die Schaltfläche "Self-Service-Portal" oben rechts auf dieser Seite klicken und eine Umgebung von FIT-Connect auswählen, für die Sie einen Zustellpunkt anlegen wollen, zum Beispiel für die öffentlich verfügbare Test-Umgebung (TEST). Die Anmeldung zum SSP ist hier beschrieben.

Einen neuen Zustellpunkt anlegen

Ein Zustellpunkt ist ein eindeutig adressierbarer Endpunkt (eine Webadresse) zur Einreichung von Anträgen an die Verwaltung über FIT-Connect. Zustellpunkte werden von einem FIT-Connect-Zustelldienst bereitgestellt. Sie finden hier eine Beschreibung für Zustelldienste. Über die Zustellpunktverwaltung im Self-Service-Portal (SSP) legen Sie neue Zustellpunkte in einem Zustelldienst an. Zudem können Sie hier bestehende Zustellpunkte ändern oder löschen.

Hinweis

Bei der Anlage der Zustellpunkte im Self-Service-Portal sollte beachtet werden, dass momentan 20 Zustellpunkte pro Client und insgesamt 500 Zustellpunkte pro Owner angelegt werden können.

Im Video zeigen wir Ihnen die Zustellpunktanlegung.

Im Video zeigen wir Ihnen die Zustellpunkt Löschung.

Zustellpunktverwaltung

Um die Zustellpunktverwaltung aufzurufen, klicken Sie im Self-Service-Portal auf den Menüpunkt Zustellpunkte in der Navigation auf der linken Seite. Anschließend klicken auf die Schaltfläche + Zustellpunkt anlegen, um einen neuen Zustellpunkt zu erstellen.

Zustellpunktverwaltung

Im Video zeigen wir Ihnen die Zustellpunktverwaltung.

Name des Zustellpunktes

In diesem Bereich vergeben Sie einen Namen, der im Self-Service-Portal angezeigt wird:

Im Video zeigen wir Ihnen die Eingabe des Namens.

Status

Das Self-Service-Portal zeigt hier den Status des neuen Zustellpunktes an: created.

Ändern Sie die Einstellung zunächst nicht. Hier finden Sie eine Beschreibung der Zustände (Status) eines Zustellpunktes.

Status für neuen Zustellpunkt festlegen

Im Video zeigen wir Ihnen die Eingabe des Status.

Einstellungen für den Status

  • created: Der Zustellpunkt ist angelegt. Er kann jedoch noch keine Anträge empfangen. Schließen Sie die Konfiguration des neuen Zustellpunktes ab und ordnen Sie diesen neuen Zustellpunkt einem Client des Typs Subscriber zu. Sie können im SSP einen Client des Typs "Subscriber" anlegen. Eine Beschreibung dazu finden Sie hier. Danach sollten Sie den Status für die Nutzung auf active setzen.

  • active: Der Zustellpunkt ist ab jetzt aktiv und kann Anträge annehmen.

Callback

In diesem Bereich des Self-Service-Portals (SSP) konfigurieren Sie eine Callback-URL für Ihr empfangendes System. Eine Callback-URL ist eine Webadresse (ein Endpunkt Ihres empfangenden Systems), die der Zustellpunkt aufruft, um Ihr empfangendes System über Ereignisse zu informieren. Hier finden Sie eine Beschreibung zu Callbacks. Die Nutzung eines Callbacks ist optional, wird jedoch empfohlen. Um eine Callback-URL festzulegen, tragen Sie hier die Adresse des Callbacks sowie ihr Callback Secret ein:

Callback konfigurieren

Hinweis

In den Bildschirmfotos auf dieser Seite sind oft Beispiele für Werte eingetragen, im Bild oben etwa für ein Callback-Secret. Die tatsächlichen Werte bei einem konkreten Zustellpunkt müssen gemeinsam mit den Verantwortlichen, mit den Entwicklerteams des Fachverfahrens und gegebenenfalls auch mit den Entwickler:innen des Onlinedienstes abgestimmt werden. Für die Anbindung von FIT-Connect müssen sich alle Beteiligten abstimmen. Hier finden Sie eine Beschreibung dazu.

Im Video zeigen wir Ihnen das Abrufen von Einreichungen.

Im Video erklären wir Ihnen den Callback.

Im Video zeigen wir Ihnen die Konfiguration des Callbacks.

Im Video zeigen wir Ihnen das Polling.

Kontaktdaten

In diesem Bereich des SSPs geben Sie Kontaktdaten zu Ansprechpartnern an, die benachrichtigt werden können, falls Fehler auftreten. Sie können hier generische Informationen eintragen, also die Team-/Organisationsdaten, sodass alle Mitarbeiter in dieser Organisation die Informationen erhalten.

Kontaktdaten eintragen

Im Video zeigen wir Ihnen die Eingabe der Kontaktdaten.

Unterstützte Versionen des Metadatenschemas

In diesem Bereich des Self-Service-Portals geben Sie an, welche Schemas (Formate) die Metadaten der Einreichungen haben können, die über den neuen Zustellpunkt an das nachgelagerte Fachverfahren gesendet werden. Das folgende Bildschirmfoto stammt von einem Zustellpunkt, der nur das Metadatenschema mit der Version 1.1.0 verarbeiten kann. Sie finden hier eine Beschreibung der Metadatenschemas.

Klicken Sie auf das Kästchen vor der Option, die Sie Antragstellern anbieten. Sie müssen mindestens eine Option anbieten. Sie können aber auch mehrere Optionen zur Verfügung stellen (die eingereichten Anträge müssen dann mit einem dieser Metadatenschemas erstellt sein):

Im Video zeigen wir Ihnen die Eingabe des Metadatenschemas.

Beide Schlüssel müssen im JSON-Format vorliegen und den Anforderungen aus Vorgaben für kryptographische Verfahren entsprechen. Ein Tool und die zugehörige Anleitung um schnell und einfach passende Schlüssel für Testzwecke zu generieren finden Sie unter Tool zur Erstellung von JSON Web Keys.

Warnung!

In diesem Bereich dürfen nur die öffentlichen Schlüssel Ihres Fachverfahrens hochgeladen werden. Die privaten Schlüssel des Fachverfahrens dürfen niemals an ein drittes System weitergegeben werden. Wenn Sie das oben genannte Tool zur Erstellung von JSON Web Keys nutzen, erkennen Sie die öffentlichen Schlüssel an den Dateinamen publicKey_encryption.jwk.json (öffentlicher Verschlüsselungsschlüssel) und publicKey_signature_verification.jwk.json (öffentlicher Signaturschlüssel).

Sicherheit

Beide Schlüssel müssen im Format JWK (JSON Web Key) vorliegen und den Anforderungen an kryptografische Verfahren entsprechen. Hier finden Sie eine Beschreibung und ein Programm, um JWKs für die Test-Umgebung (TEST) von FIT-Connect zu erstellen.

Wenn Sie einen Zustellpunkt für die Stage-Umgebung (STAGE) oder Produktiv-Umgebung (PROD) anlegen, dann benötigen Sie ein V-PKI-Zertifikat, das von der Verwaltungs-PKI für Ihr Fachverfahren ausgestellt wurde. Hier finden Sie eine Beschreibung, wie Sie ein Zertifikat der Verwaltungs-PKI beantragen. Von diesem Zertifikat der Verwaltung-PKI leiten Sie dann Dateien im Format JWK ab, mithilfe eines Skripts der FITKO.

Warnung!

In diesem Bereich dürfen nur die öffentlichen Schlüssel Ihres Fachverfahrens hochgeladen werden. Die privaten Schlüssel des Fachverfahrens dürfen niemals an ein drittes System weitergegeben werden. Wenn Sie das Tool zur Erstellung von JSON Web Keys nutzen, dann erkennen Sie die öffentlichen Schlüssel an den Dateinamen publicKey_encryption.jwk.json (öffentlicher Verschlüsselungsschlüssel) und publicKey_signature_verification.jwk.json (öffentlicher Signaturschlüssel).

Im Video zeigen wir Ihnen die Eingabe der Sicherheitskonfiguration.

Verwaltungsleistungen

In diesem Bereich des Self-Service-Portals geben Sie an, für welche Verwaltungsleistungen Anträge über den neuen Zustellpunkt an das nachgelagerte Fachverfahren gesendet werden können:

Verwaltungsleistungent

Verwaltungsleistung

Fügen Sie hier die eindeutige URN (Uniform Resource Name) der Leistung ein, die über den neuen Zustellpunkt beantragbar sein soll. Hier finden Sie eine Webseite, auf der Sie nach der eindeutigen URN einer Verwaltungsleistung suchen können. Die eindeutige URN einer Leistung besitzt eine bestimmte Form, zum Beispiel urn:de:fim:leika:leistung:99001001000000. Tragen Sie nicht den Leistungsschlüssel (LeiKa-Schlüssel) ein, hier im Beispiel 99001001000000.

Im Video zeigen wir Ihnen die Eingabe der LeiKa.

Sie können weitere Leistungen hinzufügen, indem Sie auf die Plus-Zeichen Plus-Schaltfläche klicken. Auch das Entfernen von Verwaltungsleistungen ist hier möglich.

Angebotene Rückkanäle der Verwaltungsleistung

Hier tragen Sie ein, wie der Zustellpunkt (und das nachgelagerte Fachverfahren) Bescheide zu den eingereichten Anträgen zustellen kann. Klicken Sie auf das Kästchen vor der Option, die Sie Antragstellern anbieten. Sie können mehrere Optionen zur Verfügung stellen.

Falls Sie keine Option anbieten, dann wird Ihr Fachverfahren Bescheide zu Anträgen, die über den Zustellpunkt eingereicht wurden, auf dem Postweg zustellen. Dies gilt auch für Fragen, die zu den eingereichten Anträgen auftreten sollten:

Angebotene_Rückkanäle

Wird die Rückkanaloption FIT-Connect gewählt müssen noch unterstüzte Prozessstandards angegeben werden. Details zu diesen sind im Metadatenschema zu finden.

Im Video zeigen wir Ihnen die Eingabe der Rückkanäle.

Region

Fügen Sie hier den Amtlichen Regionalschlüssel (ARS) für die oben eingetragene Verwaltungseistung ein, wenn das nachgelagerte Fachverfahren für diese Verwaltungsleistung räumlich zuständig ist. Stellen Sie dem ARS das Kürzel für Deutschland "DE" voran, zum Beispiel "DE02000000" für Hamburg. Der durch den ARS abgelöste Amtliche Gemeindeschlüssel (AGS) darf hier nicht eintragen werden.

Amtlicher Regionalschlüssel (ARS)

Der Amtliche Regionalschlüssel beschreibt eine Systematik zur Identifizierung der verwaltungspolitischen Gebiete in Deutschland, der Gemeinden, Kreise, Regierungsbezirke und Bundesländer. Im Artikel Amtlicher Regionalschlüssel (ARS) finden Sie eine Erläuterung zum ARS. Ein einfaches Tool zur Ermittlung eines ARS für ein Gebiet bietet die externe Webseite opengovtech.de. Ein ARS kann in FIT-Connect aus zwei, drei, fünf, neun oder zwölf Ziffern bestehen. Der ARS 081 zum Beispiel steht in FIT-Connect für den Regierungsbezirk Stuttgart und schließt den darunterliegenden Stadtkreis Stuttgart (08111) sowie weitere Landkreise, Städte und Gemeinden, wie etwa die Stadt Böblingen (ARS: 081150003003), im Regierungsbezirk mit ein. Dies erläutert die Seite Amtlicher Regionalschlüssel (ARS).

Im Video zeigen wir Ihnen die Eingabe des ARS.

Unterstützte Schemas der Verwaltungsleistung

Geben Sie hier an, welches Fachdatenschema (Format) das Fachverfahren, das dem neuen Zustellpunkt nachgelagert ist, bei dieser Verwaltungsleistung verarbeiten kann. Sie können mehr als ein Fachhdatenschema eintragen, wenn das Fachverfahren mehr als ein Fachdatenschema lesen und verarbeiten kann. Sie finden hier eine Erläuterung zu den Fachdatenschemas.

Fachdatenschema-URI

Tragen Sie hier den URI (Uniform Resource Identifier) des Fachdatenschemas ein, zum Beispiel https://schema.fitko.de/fim/s00000096_1.0.schema.json. Die Bezeichnung des Fachdatenschemas muss die Vorgaben erfüllen, die hier beschrieben sind. Wählen Sie zudem aus, in welchem Format dieses Schema definiert ist (JSON oder XML), hier im Beispiel JSON. Das Fachdatenschema definiert das Format der zu sendenden Fachdaten, sodass das nachgelagerte Fachverfahren die Fachdaten richtig lesen und verarbeiten kann.

Hinweis

Die Einträge in diesem Bereich müssen zwischen dem Verantwortlichen für die Umsetzung und den Entwicklern des sendenden und empfangenden Systems abstimmt werden.

Im Video zeigen wir Ihnen die Eingabe des Fachdatenschemas.

Angaben speichern

Um die Angaben zu speichern, klicken Sie auf die Schaltfläche "Speichern". Wurden alle Angaben in korrekter Form übergeben, dann wird der neue Zustellpunkt erstellt.

Hinweis

Nach der Erstellung besitzt der neue Zustellpunkt den Status created und ist für sendende Systeme weder sichtbar noch adressierbar. Hiermit soll verhindert werden, dass Einreichungen an den Zustellpunkt gesendet werden, ohne dass ein empfangsbereites System (ein Client des Typs Subscriber) vorliegt, das die Einreichungen (Anträge) für diesen Zustellpunkt abrufen kann. Daher ist es zwingend erforderlich, dass Sie vor der Aktivierung des neuen Zustellpunktes einen Client des Typs "Subscriber" anlegen und den neuen Zustellpunkt diesem Client zuweisen (nächster Abschnitt). Anschließend können Sie den neuen Zustellpunkt aktivieren, in den Status active setzen.

Hinweis

Um einen Zustellpunkt mithilfe der Routing-API zu finden, müssen die Adressierungsinformationen in einem Redaktionssystem hinterlegt sein. Weitere Informationen hierzu finden sich im Artikel Antragsrouting konfigurieren.

Zugriff auf den neuen Zustellpunkt einrichten

Der neue Zustellpunkt muss einem Client des Typs Subscriber zugeordnet werden. Dann kann der Client auf Einreichungen zugreifen, die an den neuen Zustellpunkt gesendet wurden. Sie können den neuen Zustellpunkt einem bereits vorhandenen Client des Typs Subscriber zuordnen. Oder Sie legen einen neuen Client an.

Client des Typs Subscriber anlegen

Um einen Client des Typs Subscriber anzulegen, klicken Sie im Self-Service-Portal auf den Menüpunkt Clients und dann auf die Schaltfläche + Client anlegen.

Client anlegen

Hier finden Sie eine allgemeine Beschreibung für das Anlegen von Clients des Typs Subscriber.

Erlaubte Zustellpunkte

Im Beispiel oben ist der Zustellpunkt "TestZustellpunkt" noch keinem Client zugeordnet, siehe "Berechtigen für ...".

Klicken Sie auf das Kästchen vor diesem Zustellpunkt, um dem Client zu erlauben, auf den Zustellpunkt "TestZustellpunkt" zuzugreifen.

Anlegen

Um den Client zu erstellen, klicken Sie auf die Schaltfläche "Anlegen".

Das folgende Bildschirmfoto zeigt den neu angelegten Client, dem ein Zustellpunkt zugeordnet werden muss (siehe "Erlaubte Zustellpunkte"):

MySubscriber

Zugangsdaten

Im Bild oben sehen Sie unter "Zugangsdaten" die Id des neu angelegten Clients (Client Id) sowie das Geheimnis (Client Secret) für den Client. Diese Zugangsdaten sind erforderlich, damit Ihr empfangendes System Zugang zu dem Zustellpunkt erhält, hier im Beispiel zu dem Zustellpunkt "TestZustellpunkt", und Einreichungen abrufen kann. Auf der Seite Accountregistrierung und Client-Verwaltung finden Sie eine Beschreibung dazu.

Weitere Zustellpunkte hinzufügen

Um dem Client weitere Zustellpunkte zuzuordnen, klicken Sie auf die Schaltfläche Client editieren.

Aktivieren des neuen Zustellpunktes

Sofern Ihr empfangendes System bereit ist, Einreichungen zu empfangen, können Sie nun den neuen Zustellpunkt aktivieren. Erst nach der Aktivierung ist es möglich, Einreichungen an diesen Zustellpunkt zu senden. Ändern Sie den Status des Zustellpunktes von created auf active und speichern Sie die Änderung, siehe oben Einstellungen für den Status. Weitere Informationen zu den möglichen Status finden Sie unter Statusmodell eines Zustellpunktes.

Im Video zeigen wir Ihnen die Aktivierung.