Zum Hauptinhalt springen

Bulk create truckers from CSV

POST 
/company/truckers/bulk/

Erstelle mehrere Transportunternehmen massenhaft durch CSV-Datei-Import.

Importablauf:

  1. Benutzer lädt CSV-Datei mit Transportunternehmensdaten hoch
  2. System prüft obligatorische Header
  3. Verarbeitet jede Zeile mit Datenvalidierung
  4. Prüft Eindeutigkeit von E-Mail, Steuer-ID und Telefon
  5. Generiert automatisch Passwörter, falls nicht angegeben
  6. Erstellt erfolgreiche Transportunternehmen
  7. Gibt Bericht mit Erfolgen und Fehlern zurück

Validierungen pro Zeile:

  • E-Mail: Eindeutig im System und gültiges Format
  • Steuer-ID: Eindeutig und gültiges Format je nach Land
  • Telefon: Gültiges Format gemäß Regex
  • Standardfahrzeug: Existiert im Unternehmen (über Kennzeichen)
  • Rolle: Gültiger Wert (wird automatisch normalisiert)

Obligatorische CSV-Header:

  • name, lastname, email, phone, taxid
  • Optional: default_vehicle (Kennzeichen des Fahrzeugs)

Generierung von Zugangsdaten:

  • Falls kein Passwort angegeben: Wird automatisch generiert
  • Willkommens-E-Mail mit Zugangsdaten wird versendet
  • Personalisierte E-Mail mit Unternehmensnamen

CSV-Format:

  • Trennzeichen: Komma (,)
  • Kodierung: UTF-8
  • Erste Zeile: Header
  • Beispiel: name,lastname,email,phone,taxid,default_vehicle

Detaillierte Antwort:

  • ok: Array erfolgreich erstellter Transportunternehmen
  • ko: Array von Fehlern mit Zeile, Grund und Daten

Fehlerstruktur:

{
  line: 5,
  reason: EMAIL_ALREADY_IN_USE,
  data: {...},
  details: john@example.com
}

Häufige Fehlercodes:

  • MIN_HEADERS: Fehlende obligatorische Header
  • EMAIL_ALREADY_IN_USE: E-Mail bereits vergeben
  • TAXID_ALREADY_IN_USE: Steuer-ID bereits ver

Request​

Responses​

Importvorgang abgeschlossen