Ihre CSV-Datei für den Import vorbereiten

Eine saubere CSV-Datei entscheidet über den Unterschied zwischen einem reibungslosen Massenimport und einem Bildschirm voller Validierungsfehler. Dieser Artikel definiert die genauen Spalten, Formate und Regeln, die Ihre Datei befolgen muss, bevor Sie Strafmandate importieren.

Erforderliche Spalten

Ihre CSV-Datei muss eine Kopfzeile mit allen sieben dieser Spalten enthalten. Spaltennamen werden ohne Berücksichtigung der Groß-/Kleinschreibung abgeglichen, und zusätzliche Spalten werden ignoriert.

Spalte	Format und Regel
`violationTypeKey`	Pflichttext. Der Schlüssel des Verstoßtyps.
`occurredAtUtc`	Pflichtfeld. Ein gültiges UTC-Datum/-Uhrzeit im ISO-8601-Format, zum Beispiel `2026-03-15T10:30:00Z`.
`location`	Pflichttext.
`amount`	Pflichtfeld. Eine Dezimalzahl größer als null, mit einem Punkt als Dezimaltrennzeichen (zum Beispiel `120.00`).
`vehicleId`	Pflichtfeld. Eine ganze Zahl größer als null, die das Flottenfahrzeug identifiziert.
`aktenzeichen`	Pflichttext. Das Aktenzeichen der Behörde.
`countryCode`	Pflichtfeld. Genau zwei Buchstaben (ISO-Code); wird in Großbuchstaben gespeichert.

Hinweis: Fehlt in der Kopfzeile eine erforderliche Spalte, schlägt der gesamte Import fehl, bevor eine einzige Zeile geprüft wird, mit einer Meldung, die genau auflistet, welche Spalten fehlen.

Formatierungsregeln

Kopfzeile plus Daten — die Datei benötigt die Kopfzeile und mindestens eine Datenzeile. Eine Datei nur mit Kopfzeile wird abgelehnt.
Zeilenenden — Windows- und Unix-Zeilenenden funktionieren beide; leere Zeilen werden ignoriert.
Dezimaltrennzeichen — verwenden Sie für den Betrag einen Punkt (.), kein Komma. Der Wert wird mit invarianter Formatierung geparst.
Datumsangaben in UTC — geben Sie occurredAtUtc als UTC an; Werte werden als Weltzeit gelesen.
Ländercode — muss zwei Buchstaben umfassen; alles Längere oder Kürzere wird abgelehnt.

Werte, die Kommas oder Anführungszeichen enthalten

Der Importer versteht das standardmäßige CSV-Quoting. Enthält ein Wert ein Komma — häufig bei einem Ort — setzen Sie den gesamten Wert in doppelte Anführungszeichen. Um ein wörtliches doppeltes Anführungszeichen innerhalb eines in Anführungszeichen gesetzten Werts einzuschließen, verdoppeln Sie es.

"Berlin, Kurfuerstendamm 42" hält das Komma innerhalb eines Felds.
"Gate ""A"" entrance" erzeugt den Text Gate "A" entrance.

Duplikate vermeiden

Der Importer identifiziert ein Mandat anhand seines Aktenzeichens und Fahrzeugs zusammen. Zwei Zeilen mit demselben Aktenzeichen und derselben vehicleId werden als Duplikate behandelt — unabhängig davon, ob die Übereinstimmung gegenüber bereits im System vorhandenen Mandaten oder einer anderen Zeile in derselben Datei besteht. Duplikate werden übersprungen; geben Sie daher jedem einzelnen Mandat sein eigenes Aktenzeichen und bestätigen Sie, dass das Fahrzeug korrekt ist.

Beispiel

violationTypeKey,occurredAtUtc,location,amount,vehicleId,aktenzeichen,countryCode
speeding,2026-03-15T10:30:00Z,"Berlin, Kurfuerstendamm 42",120.00,101,BL-2026-00001,DE
parking,2026-03-16T08:05:00Z,Hamburg Hafencity,35.50,102,HH-2026-00042,DE

Tipp: Führen Sie nach dem Vorbereiten der Datei immer einen Probelauf durch. Er meldet die genaue Zeilennummer und den Grund für jedes Problem, sodass Sie es vor der Übernahme beheben können.