Passa al contenuto principale

Create multiple vehicles from CSV file

POST 
/company/vehicles/bulk/

Consente la creazione in blocco di più veicoli tramite caricamento di un file CSV.

Obiettivo​

Permettere alle aziende di importare in modo efficiente l'intera flotta o grandi lotti di veicoli da sistemi esterni o fogli di calcolo.

Casi d'Uso​

  • Migrare una flotta esistente da un altro sistema
  • Importare veicoli da fogli di calcolo di gestione flotta
  • Onboarding in blocco di nuovi veicoli
  • Aggiornare più veicoli simultaneamente

Flusso di Validazione​

flowchart TD
  A[Ricevi File CSV] --> B{Limite Pagamento OK?}
  B -->|No| C[402 Pagamento Richiesto]
  B -->|Sì| D{File Presente?}
  D -->|No| E[404 FILE_NON_TROVATO]
  D -->|Sì| F{Analizza CSV}
  F --> G{Intestazioni Valide?}
  G -->|No| H[Ritorna ko: INTESTAZIONI_MINIME]
  G -->|Sì| I{Dati Presenti?}
  I -->|No| J[400 DATI_NON_VALIDI]
  I -->|Sì| K[Processa Ogni Riga]
  K --> L{Riga Valida?}
  L -->|Sì| M[Crea Veicolo - Aggiungi a ok]
  L -->|No| N[Aggiungi a ko con motivo]
  M --> O{Altre Righe?}
  N --> O
  O -->|Sì| K
  O -->|No| P[Aggiorna Azienda]
  P --> Q[Ritorna array ok e ko]

Limiti di Pagamento​

Questo endpoint è soggetto ai limiti del piano tariffario tramite il middleware isPaymentUpdate. Se l'azienda ha raggiunto il suo limite di veicoli, la richiesta fallirà con errore 402 prima di elaborare il CSV.

Struttura CSV​

Intestazioni obbligatorie (minime):

  • cargo_type
  • vehicle_type
  • plate
  • shipping_type

**Int

Request​

Responses​

Creazione in blocco completata (può includere errori parziali). Controlla gli array 'ok' e 'ko' per i risultati.

Response Headers