Eine Mitteilung an die Behörde weiterleiten (Anhörung)

Dieser Artikel erläutert, wie Sie die Antwort auf eine Anhörung (Anhörung der Behörde / Fahrerermittlungsersuchen) an die ausstellende Behörde für ein Strafmandat weiterleiten und wie der eingebaute Idempotenzschutz verhindert, dass dieselbe Nachricht zweimal versendet wird.

Bevor Sie weiterleiten

Die Weiterleitung ist rollenabhängig: Sie benötigen die Berechtigung strafmandate:forward-authority. Außerdem müssen Sie bereits geklärt haben, wer gefahren ist — das Strafmandat benötigt eine aktive Fahrerzuordnung oder einen ausdrücklichen Datensatz „Fahrer unbekannt“. Fehlt beides, wird die Weiterleitung mit einem 409-Konflikt und der Meldung „Assign a driver or mark driver as unknown before forwarding to the authority“ (Fehlercode FORWARDING_REQUIRES_DRIVER_ASSIGNMENT) blockiert.

Die Kommunikation weiterleiten

1. Bestätigen Sie, dass der Fahrer auf dem Strafmandat zugeordnet oder als unbekannt markiert ist.
2. Wählen Sie die Aktion „An Behörde weiterleiten“.
3. Geben Sie den Kanal (wie die Nachricht versendet wird) und den Payload (den Nachrichteninhalt) an.
4. Übergeben Sie einen Idempotency-Key für die Anfrage. Dieser ist erforderlich — eine Anfrage ohne diesen wird mit IDEMPOTENCY_KEY_REQUIRED abgelehnt.
5. Senden Sie ab. Bei Erfolg zeichnet das System die Kommunikation auf und gibt ein Ergebnis von forwarded, einen Content-Hash und ein Replayed-Flag zurück.

Jede weitergeleitete Nachricht wird als ausgehende Behördenkommunikation gespeichert — mit ihrem Kanal, dem Versandzeitpunkt, dem Idempotency-Key und einem SHA-256-Content-Hash von Kanal und Payload. Der Hash ermöglicht es Ihnen, genau zu bestätigen, was versendet wurde.

Wie Idempotenz Sie schützt

Eine Weiterleitung an eine Behörde darf niemals durch einen versehentlichen erneuten Versuch dupliziert werden. Das System schützt davor auf zwei Arten:

• Replay mit gleichem Schlüssel — wenn Sie mit demselben Idempotency-Key erneut senden, erhalten Sie das ursprüngliche Ergebnis zurück, wobei replayed auf true gesetzt ist, anstatt dass eine zweite Nachricht erstellt wird. Dies gilt innerhalb des Aufbewahrungsfensters des Schlüssels (24 Stunden).
• Persistierte Suche — auch unabhängig vom Cache wird eine bereits für dieses Strafmandat und diesen Idempotency-Key gespeicherte Kommunikation als Replay zurückgegeben statt dupliziert.

Hinweis: Blockierungs- und Nicht-gefunden-Antworten werden für denselben Schlüssel ebenfalls gemerkt, sodass ein erneuter Versuch nach einer Blockierung wegen fehlenden Fahrers oder einem unbekannten Strafmandat konsistent dieselbe Antwort liefert. Um eine wirklich neue Nachricht zu senden, verwenden Sie einen neuen Idempotency-Key.

Tipp: Erzeugen Sie für jede einzelne Nachricht, die Sie senden möchten, einen frischen, eindeutigen Idempotency-Key und verwenden Sie exakt denselben Schlüssel nur dann erneut, wenn Sie die identische Anfrage nach einem Netzwerkfehler bewusst wiederholen.

Bestätigen, dass eine Weiterleitung erfolgt ist

Eine erfolgreiche Weiterleitung erscheint auf der Strafmandat-Chronik als Behördenkommunikation, die von authority-pending auf forwarded gewechselt ist, einschließlich Kanal und Content-Hash. Ist das Replayed-Flag true, wurde die Nachricht bereits zuvor versendet und nicht erneut gesendet.

Verwandte Artikel

• Einen Fahrer einem Strafmandat zuordnen
• Die Strafmandat-Chronik
• Fristen berechnen und verfolgen