Massenimport von Fahrzeugen (CSV)

Die Massenimport-Funktion ermöglicht es Ihnen, mehrere Fahrzeuge auf einmal zu Ihrer Flotte hinzuzufügen, indem Sie eine CSV-Datei verwenden. Dies ist ideal für die Ersteinrichtung der Flotte, Flottenerweiterungen oder die Migration von einem anderen System.

Zugriff auf die Import-Funktion

Navigieren Sie zu Dashboard > Fahrzeuge
Klicken Sie auf die Schaltfläche CSV importieren in der oberen rechten Ecke
Der Import-Dialog wird geöffnet

CSV-Dateianforderungen

Dateiformat

Format: CSV (Kommagetrennte Werte)
Kodierung: UTF-8 (empfohlen)
Trennzeichen: Komma (,)
Kopfzeile: Die erste Zeile muss Spaltennamen enthalten

Erforderliche Spalten

Nur eine Spalte ist erforderlich:

Spalte	Beschreibung	Beispiel
`vehicle_number`	Eindeutiger Identifikator für das Fahrzeug	"VH-001", "SCOOTER-123"

Wichtig

Jedes Fahrzeug muss eine eindeutige vehicle_number haben. Duplikate aktualisieren bestehende Datensätze, anstatt neue zu erstellen.

Optionale Spalten (Aktiv importiert)

Diese Spalten werden vollständig von der Import-Funktion unterstützt:

Spalte	Beschreibung	Beispiel
`vehicle_model_id`	Modell-ID (numerisch) oder Modellname (Text)	"1" oder "Levy Max"
`vehicle_model`	Modellname (Alternative zu vehicle_model_id)	"Levy Max Pro"
`iot_imei`	IMEI des verknüpften IoT-Geräts	"123456789012345"
`vin`	Fahrzeug-Identifizierungsnummer	"1HGBH41JXMN109186"

Standardwerte beim Import

Beim Import von Fahrzeugen werden die folgenden Standardwerte gesetzt:

Feld	Standardwert
`status`	"offline"
`battery_level`	0
`iot_battery_pct`	0
`vehicle_odometer`	"0"

Hinweis

Um zusätzliche Werte wie Akkuladestände, GPS-Koordinaten oder benutzerdefinierte Status festzulegen, aktualisieren Sie die Fahrzeuge nach dem Import einzeln oder verwenden Sie die API.

CSV-Beispielvorlagen

Minimale Vorlage

vehicle_number
VH-001
VH-002
VH-003
VH-004
VH-005

Grundvorlage mit IoT

vehicle_number,iot_imei,vehicle_model
VH-001,123456789012345,Levy Max
VH-002,123456789012346,Levy Max
VH-003,123456789012347,Levy Max Pro
VH-004,123456789012348,Levy Max Pro
VH-005,123456789012349,Segway E22

Vollständige Vorlage

vehicle_number,vehicle_model,iot_imei,vin
VH-001,Levy Max,123456789012345,1HGBH41JXMN109186
VH-002,Levy Max,123456789012346,1HGBH41JXMN109187
VH-003,Levy Max Pro,123456789012347,1HGBH41JXMN109188
VH-004,Levy Max Pro,123456789012348,1HGBH41JXMN109189
VH-005,Segway E22,123456789012349,1HGBH41JXMN109190

Status-Hinweis

Alle importierten Fahrzeuge starten mit dem Status "offline". Aktualisieren Sie die einzelnen Fahrzeugstatus nach dem Import über das Dashboard oder die API.

Import-Prozess

Schritt 1: Bereiten Sie Ihre CSV-Datei vor

Erstellen Sie eine CSV-Datei gemäß dem oben genannten Format
Stellen Sie sicher, dass die Spalte vehicle_number vorhanden ist und alle Werte eindeutig sind
Überprüfen Sie die Datengenauigkeit vor dem Import

Schritt 2: Laden Sie die Datei hoch

Klicken Sie auf CSV importieren auf der Fahrzeugseite
Wählen Sie Ihre CSV-Datei aus
Das System wird die Datei parsen und validieren

Schritt 3: Vorschau überprüfen

Vor dem Import sehen Sie:

Anzahl der zu importierenden Fahrzeuge
Alle Validierungsfehler
Warnungen zu potenziellen Problemen

Schritt 4: Import bestätigen

Klicken Sie auf Importieren, um fortzufahren
Warten Sie, bis der Import abgeschlossen ist
Überprüfen Sie die Ergebniszusammenfassung

Schritt 5: Ergebnisse verifizieren

Nach dem Import sehen Sie:

Importierte Anzahl: Erfolgreich hinzugefügte/aktualisierte Fahrzeuge
Fehlgeschlagene Anzahl: Fahrzeuge, die nicht importiert werden konnten
Fehlerdetails: Spezifische Fehler für fehlgeschlagene Zeilen

Wie der Import vorhandene Fahrzeuge behandelt

Der Import verwendet "Upsert"-Logik (Aktualisieren oder Einfügen):

Neue Fahrzeuge

Wenn vehicle_number nicht existiert, wird ein neues Fahrzeug erstellt
Das Fahrzeug wird dem ausgewählten Unterkonto zugewiesen
Der Anfangsstatus wird auf "offline" gesetzt

Vorhandene Fahrzeuge

Wenn vehicle_number bereits existiert, wird der Datensatz aktualisiert
Nur angegebene Felder werden aktualisiert
Vorhandene Daten für nicht angegebene Felder bleiben erhalten
Der updated_at-Zeitstempel wird aktualisiert

Beispiel: Wenn Sie eine CSV mit nur vehicle_number und iot_imei für ein bestehendes Fahrzeug importieren, wird nur die iot_imei aktualisiert - alle anderen Felder bleiben unverändert.

IoT-Geräte während des Imports verknüpfen

Automatische Verknüpfung

Wenn Sie eine iot_imei in Ihrer CSV angeben:

Das System sucht nach einem vorhandenen IoT-Gerät mit dieser IMEI
Wenn gefunden und nicht verknüpft, wird es mit dem Fahrzeug verknüpft
Wenn gefunden und bereits mit einem anderen Fahrzeug verknüpft, kann der Import für diese Zeile fehlschlagen

Best Practice

Erstellen Sie zuerst IoT-Geräte über die IoT-Geräte-Seite
Notieren Sie die IMEI für jedes Gerät
Fügen Sie die IMEIs in Ihre Fahrzeug-Import-CSV ein
Die Geräte werden automatisch verknüpft

Fahrzeugmodelle angeben

Sie können das Fahrzeugmodell auf zwei Arten angeben:

Nach Modell-ID

Wenn Sie die Modell-ID kennen (von der Fahrzeugmodelle-Seite):

vehicle_number,vehicle_model_id
VH-001,123
VH-002,123
VH-003,456

Nach Modellname

Sie können stattdessen den Modellnamen verwenden:

vehicle_number,vehicle_model_id
VH-001,Levy Max
VH-002,Levy Max
VH-003,Levy Max Pro

Oder verwenden Sie die Spalte vehicle_model:

vehicle_number,vehicle_model
VH-001,Levy Max
VH-002,Levy Max
VH-003,Levy Max Pro

Die Import-Funktion versucht, nach Namen abzugleichen, wenn keine numerische ID angegeben wird.

Fehlerbehandlung

Häufige Validierungsfehler

Fehler	Ursache	Lösung
"Fahrzeugnummer erforderlich"	Leere oder fehlende vehicle_number	Stellen Sie sicher, dass alle Zeilen eine vehicle_number haben
"Ungültiges IMEI-Format"	IMEI nicht 15 Ziffern	IMEI-Format prüfen
"Modell nicht gefunden"	Modell-ID/Name existiert nicht	Erstellen Sie zuerst das Modell oder korrigieren Sie den Namen
"Doppelte Fahrzeugnummer"	Gleiche vehicle_number zweimal in CSV	Doppelte Zeilen entfernen

Verhalten bei teilweisem Import

Der Import ist nicht atomar - erfolgreiche Zeilen werden importiert, auch wenn einige fehlschlagen
Fehlgeschlagene Zeilen werden mit spezifischen Fehlermeldungen gemeldet
Sie können fehlgeschlagene Zeilen korrigieren und erneut importieren (Aktualisierungen sind sicher)

API-Referenz

Endpunkt

POST /api/vehicles/import

Anfragekörper

{
  "csv_data": [
    {
      "vehicle_number": "VH-001",
      "iot_imei": "123456789012345",
      "vehicle_model": "Levy Max"
    },
    {
      "vehicle_number": "VH-002",
      "iot_imei": "123456789012346",
      "vehicle_model": "Levy Max"
    }
  ],
  "subaccount_id": "uuid-des-ziel-unterkontos"
}

Antwort

{
  "success": true,
  "message": "Erfolgreich 2 Fahrzeug(e) importiert",
  "imported_count": 2,
  "failed_count": 0,
  "failures": [],
  "results": [
    {
      "success": true,
      "vehicle_uuid": "uuid-1",
      "vehicle_number": "VH-001",
      "error_message": null
    },
    {
      "success": true,
      "vehicle_uuid": "uuid-2",
      "vehicle_number": "VH-002",
      "error_message": null
    }
  ]
}

Best Practices

Vor dem Import

Vorhandene Daten sichern, wenn Sie bestehende Fahrzeuge aktualisieren
Ihre CSV validieren zuerst mit einem Tabellenkalkulationsprogramm
Fahrzeugmodelle erstellen, bevor Sie Fahrzeuge importieren, die auf sie verweisen
IoT-Geräte erstellen, wenn Sie sie während des Imports verknüpfen möchten