ARS im SSP: Zustellpunkte haben Suchfunktion mit validierter Adressfunktion

User Story

Als verantwortliche Person im Self-Service-Portal möchte ich beim Anlegen oder Bearbeiten eines Zustellpunkts eine adressbasierte ARS-Suchfunktion nutzen können, damit ich die korrekte amtliche Zuständigkeit einfach, fehlerfrei und ohne manuelle Recherche auswählen kann.

Warum

Die manuelle Eingabe oder externe Recherche des amtlichen Regionalschlüssels (ARS) führt regelmäßig zu Fehlern, Rückfragen und Aufwänden im Anbindungsprozess. Eine integrierte Suchfunktion mit validierter Adresslogik stellt sicher, dass Zustellpunkte korrekt konfiguriert sind und fachliche wie technische Prozesse stabil funktionieren.

Links, Hinweise, Bemerkungen

• ARS-Referenz: https://www.amtlicher-regionalschluessel.de/
• Übergangslösung aktuell über freie Texteingabe im SSP
• Bedarf gemeldet durch Onlinedienste, Behörden, IT-Dienstleister
• Option: Wiederverwendung der bereits existierenden Geodatenlogik aus ARS-PoC

Akzeptanzkriterien

1. Im SSP steht eine ARS-Suchfunktion zur Verfügung, die auf Basis einer Adresse oder Ortsangabe passende ARS-Einträge vorschlägt.
2. Die Suchfunktion verwendet eine validierte Adresslogik (z. B. offizielle Geodatenquelle).
3. Der ausgewählte ARS wird automatisch in den Zustellpunkt übernommen und geprüft.
4. Fehlermeldungen erscheinen, wenn ein ARS nicht zugeordnet oder validiert werden kann.
5. Der Prozess ist barrierefrei nutzbar und im SSP klar beschrieben.

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

• Prüfung, ob weitere Gebietsschlüssel (z. B. Schulsprengel) über dieselbe Logik abbildbar sind
• Erweiterung der API-Endpunkte für ARS-Validierungen
• Anpassung der Fachverfahren-Integration, falls notwendig
• Dokumentation in der Betriebsdokumentation
• Definition of Done wurde überprüft.