Zum Hauptinhalt springen

Create multiple vehicles from CSV file

POST 
/company/vehicles/bulk/

Ermöglicht die Massenerstellung mehrerer Fahrzeuge durch den Upload einer CSV-Datei.

Ziel​

Unternehmen die effiziente Importierung ihres gesamten Fuhrparks oder großer Fahrzeugstapel aus externen Systemen oder Tabellenkalkulationen ermöglichen.

Anwendungsfälle​

  • Migration eines bestehenden Fuhrparks von einem anderen System
  • Import von Fahrzeugen aus Flottenmanagement-Tabellen
  • Massen-Onboarding neuer Fahrzeuge
  • Gleichzeitige Aktualisierung mehrerer Fahrzeuge

Validierungsablauf​

flowchart TD
  A[CSV-Datei empfangen] --> B{Zahlungslimit OK?}
  B -->|Nein| C[402 Payment Required]
  B -->|Ja| D{Datei vorhanden?}
  D -->|Nein| E[404 FILE_NOT_FOUND]
  D -->|Ja| F{CSV parsen}
  F --> G{Header gültig?}
  G -->|Nein| H[Return ko: MIN_HEADERS]
  G -->|Ja| I{Daten vorhanden?}
  I -->|Nein| J[400 INVALID_DATA]
  I -->|Ja| K[Jede Zeile verarbeiten]
  K --> L{Zeile gültig?}
  L -->|Ja| M[Fahrzeug erstellen - Zu ok hinzufügen]
  L -->|Nein| N[Zu ko hinzufügen mit Grund]
  M --> O{Weitere Zeilen?}
  N --> O
  O -->|Ja| K
  O -->|Nein| P[Unternehmen aktualisieren]
  P --> Q[ok- und ko-Arrays zurückgeben]

Zahlungslimits​

Dieser Endpunkt unterliegt den Limits des Zahlungsplans über die Middleware isPaymentUpdate. Wenn das Unternehmen sein Fahrzeuglimit erreicht hat, schlägt die Anfrage mit Fehler 402 fehl, bevor die CSV verarbeitet wird.

CSV-Struktur​

Erforderliche Header (Minimum):

  • cargo_type
  • vehicle_type
  • plate
  • shipping_type

Optionale Header:

  • fresh_cargo_temp

Beispiel-CSV:

Request​

Responses​

Massenanlage abgeschlossen (kann teilweise Fehler enthalten). Ergebnisse in den Arrays 'ok' und 'ko' prüfen.

Response Headers