Passa al contenuto principale

Bulk create truckers from CSV

POST 
/company/truckers/bulk/

Crea più trasportatori in massa tramite importazione di file CSV.

Flusso di importazione:

  1. L'utente carica un file CSV con i dati dei trasportatori
  2. Il sistema valida gli header obbligatori
  3. Elabora ogni riga validando i dati
  4. Verifica l'unicità di email, taxid e telefono
  5. Genera password automatiche se non fornite
  6. Crea i trasportatori con successo
  7. Restituisce un report con successi ed errori

Validazioni per riga:

  • Email: Unica nel sistema e formato valido
  • Taxid: Unico e formato valido secondo il paese
  • Telefono: Formato valido secondo regex
  • Default_vehicle: Esiste nella compagnia (per targa)
  • Ruolo: Valore valido (normalizzato automaticamente)

Header obbligatori CSV:

  • name, lastname, email, phone, taxid
  • Opzionale: default_vehicle (targa del veicolo)

Generazione delle credenziali:

  • Se non viene fornita una password: Viene generata automaticamente
  • Viene inviata un'email di benvenuto con le credenziali
  • Email personalizzata con il nome della compagnia

Formato del CSV:

  • Separatore: virgola (,)
  • Codifica: UTF-8
  • Prima riga: header
  • Esempio: name,lastname,email,phone,taxid,default_vehicle

Risposta dettagliata:

  • ok: Array di trasportatori creati con successo
  • ko: Array di errori con riga, motivo e dati

Struttura degli errori:

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

Codici di errore comuni:

  • MIN_HEADERS: Manca l'header obbligatorio
  • EMAIL_ALREADY_IN_USE: Email duplicata
  • TAXID_ALREADY_IN_USE: Taxid duplicato
  • EMAIL

Request​

Responses​

Processo di importazione completato