Strafmandate per CSV im Stapel importieren

Der CSV-Massenimport ermöglicht es Ihnen, aus einer einzigen Tabelle viele Strafmandate auf einmal anzulegen. Dieser Artikel behandelt den vollständigen Importablauf: Vorschau mit einem Probelauf und anschließendes sicheres Übernehmen der Charge mit Duplikaterkennung und Replay-Schutz.

Bevor Sie beginnen

Sie benötigen die Modulberechtigung Strafmandate (strafmandate:view), die die Rollen SystemAdmin und FleetManager standardmäßig besitzen. Bereiten Sie eine CSV-Datei mit den erforderlichen Spalten vor — siehe Bereiten Sie Ihre CSV-Datei für den Import vor für die genauen Kopfzeilen- und Formatierungsregeln.

Schritt 1: Vorschau mit einem Probelauf

Führen Sie immer zuerst einen Probelauf durch. Er validiert jede Zeile und meldet, was geschehen würde, ohne etwas in Ihre Daten zu schreiben.

Öffnen Sie den Massenimport-Bereich des Moduls Strafmandate und geben Sie Ihren CSV-Inhalt ein.
Führen Sie den Probelauf aus.
Lesen Sie die Zusammenfassung: Gesamtzeilen, importierbare Zeilen, Validierungsfehler und übersprungene Duplikate.
Prüfen Sie die zeilenweise Vorschau, um für jede Zeile deren Aktenzeichen und Fahrzeug zu sehen, ob sie gültig ist, ob sie ein Duplikat ist, ob sie importiert wird und etwaige Fehlermeldungen.

Tipp: Korrigieren Sie die als Validierungsfehler gekennzeichneten Zeilen in Ihrer Quelldatei und führen Sie den Probelauf erneut aus, bis die Anzahl importierbarer Zeilen Ihren Erwartungen entspricht.

Schritt 2: Den Import übernehmen

Wenn die Vorschau stimmig aussieht, übernehmen Sie dieselbe CSV-Datei. Die Übernahme importiert nur die Zeilen, die der Probelauf als importierbar markiert hat — gültige Zeilen, die keine Duplikate sind. Ungültige Zeilen und Duplikate werden übersprungen, nicht als fehlgeschlagen gewertet.

Übergeben Sie die CSV-Datei an die Aktion Import (Übernahme).
Übergeben Sie einen Idempotency-Key mit der Anfrage. Dieser ist erforderlich; ohne ihn wird der Import mit „Idempotency-Key header is required.“ abgelehnt.
Lesen Sie die Ergebniszusammenfassung.

Die Übernahme-Zusammenfassung

Feld	Bedeutung
Gesamtzeilen	Jede Datenzeile in der Datei.
Erstellt	Tatsächlich erstellte Mandate.
Zugeordnet	Erstellte Mandate, für die die automatische Fahrerzuordnung einen Fahrer vorgeschlagen hat.
Nicht zugeordnet	Erstellte Mandate ohne vorgeschlagenen Fahrer.
Übersprungene Duplikate	Zeilen, die übersprungen wurden, weil das Mandat bereits existiert oder sich innerhalb der Datei wiederholt.
Validierungsfehler	Zeilen, die übersprungen wurden, weil sie die Validierung nicht bestanden haben.

Jedes importierte Mandat wird im Status open angelegt, erhält eine eindeutige interne ID, durchläuft die automatische Fahrerzuordnung und wird im Prüfprotokoll erfasst.

Duplikaterkennung und Replay-Sicherheit

Ein Mandat wird als Duplikat behandelt, wenn die Kombination aus seinem Aktenzeichen und Fahrzeug bereits in Ihren Daten vorhanden ist oder sich innerhalb derselben Datei wiederholt. Duplikate werden übersprungen, sodass ein erneuter Upload keine Doppel erzeugt.

Der Idempotency-Key macht die Übernahme zudem sicher wiederholbar. Wenn Sie denselben Schlüssel erneut übergeben — etwa nach einer Netzwerkzeitüberschreitung — gibt das System das ursprüngliche Ergebnis als replayed markiert zurück, anstatt die Charge ein zweites Mal zu importieren.

Hinweis: Verwenden Sie für jeden wirklich neuen Import einen frischen Idempotency-Key. Das erneute Verwenden eines vorherigen Schlüssels gibt das zwischengespeicherte Ergebnis dieses früheren Imports zurück, anstatt Ihre neue Datei zu importieren.