Skip to content

Routing API Nutzung klarer ausformulieren

[[## Dokumentationsseiten (Pflichtfeld)

  • Neue Dokumentationsseite
  • Bestehende Dokumentationsseite (Routing API) anpassen

User Story

Als Anbindungsprojekt möchte ich Fachverfahren so gestalten, dass die Routing API direkt integriert wird, um die Zuständigkeitslogik (z. B. über ARS, Fachdatenschemata oder Gebietsdaten) automatisiert zu pflegen. Dadurch entfällt die manuelle Konfiguration im Self-Service-Portal (SSP), und Anträge können direkt an die zuständige Behörde weitergeleitet werden.

Warum

Die Routing API ist das zentrale Bindeglied, um Anträge über FIT-Connect automatisch an die korrekte Zuständigkeit zu leiten.
Aktuell müssen Zuständigkeiten und Routing-Informationen manuell im SSP gepflegt werden. Dies ist fehleranfällig, ressourcenintensiv und für größere Fachverfahren schwer skalierbar.

Durch die Integration der Routing API in Fachverfahren oder Metaportale können:

  • Zuständigkeiten automatisiert gepflegt und aktualisiert werden,
  • Gebietsdaten und LeiKa-IDs direkt mit FIT-Connect synchronisiert werden,
  • Anträge ohne zusätzliche manuelle Eingriffe korrekt zugestellt werden.

Dies reduziert Wartungsaufwand, verhindert Fehler und verbessert die Nutzerfreundlichkeit für Verwaltungen und IT-Dienstleister.

Erkenntnis → Was muss dokumentiert werden? (Pflichtfeld)

In der Dokumentation sollte ein neuer Abschnitt ergänzt werden, der beschreibt, wie die Routing API zur automatisierten Zuständigkeitsverwaltung eingesetzt werden kann:

  • Zielgruppe: Betreiber von Fachverfahren, Portalen oder kommunalen Metaservices
  • Ziel: Automatisierte Pflege der Zuständigkeiten im FIT-Connect-System
  • Beispielhafte Anwendungsfälle:
    1. Eine Kommune aktualisiert ihre Zuständigkeitsgrenzen (Gebietsdaten, Schulbezirke, Kammerbezirke) → Routing wird automatisch angepasst.
    2. Ein Fachverfahren implementiert neue LeiKa-Leistungen → entsprechende Zustellpunkte werden automatisch mit der Routing API aktualisiert.
    3. Bei Umstrukturierungen (z. B. Gebietsreformen) werden ARS-Zuordnungen automatisch aktualisiert.

Notwendige Inhalte:

  • Beschreibung der Endpunkte zur Verwaltung von Zuständigkeiten (GET/POST/PATCH)
  • Technisches Beispiel für ein automatisiertes Routing-Update
  • Darstellung des Zusammenspiels zwischen Routing API und Destination API
  • Sicherheitshinweise: Zugriff nur über authentifizierte Clients (z. B. über Elster-MUK oder Keycloak-Gruppen)

Links, Hinweise, Bemerkungen

Ansprechperson (Pflichtfeld)

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

Akzeptanzkriterien (Pflichtfeld)

  1. Dokumentation beschreibt, wie Zuständigkeiten über die Routing API automatisiert gepflegt werden.
  2. Beispielablauf (z. B. JSON-Beispiel) für automatisierte Routing-Updates ist enthalten.
  3. Zusammenspiel zwischen Routing API, Destination API und SSP ist nachvollziehbar beschrieben.
  4. Sicherheitsmechanismen und Authentifizierung (Keycloak, Zertifikate) sind erläutert.
  5. Beschreibung enthält Beispiel-Use-Cases aus Verwaltungskontext (z. B. Schulbezirke, Gewerbe, Zentrale Vergabestellen).
  6. Dokumentation ist im FIT-Connect-Docs-Staging geprüft und freigegeben.
  7. Verantwortlichkeiten (z. B. Fachverfahren vs. Behörde) sind klar formuliert.
  8. Hinweis auf Versionierung und Änderungsmanagement (Routing-Änderungen über API) ergänzt.

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

Edited by Laura Elges