Aller au contenu principal

Create multiple vehicles from CSV file

POST 
/company/vehicles/bulk/

Permet la création en masse de plusieurs véhicules à partir d'un téléchargement de fichier CSV.

Objectif​

Permettre aux entreprises d'importer efficacement leur flotte entière ou de grands lots de véhicules depuis des systèmes externes ou des feuilles de calcul.

Cas d'utilisation​

  • Migrer une flotte existante depuis un autre système
  • Importer des véhicules depuis des feuilles de calcul de gestion de flotte
  • Intégration en masse de nouveaux véhicules
  • Mettre à jour plusieurs véhicules simultanément

Flux de validation​

flowchart TD
  A[Recevoir le fichier CSV] --> B{Limite de paiement OK ?}
  B -->|Non| C[402 Paiement requis]
  B -->|Oui| D{Fichier présent ?}
  D -->|Non| E[404 FICHIER_NON_TROUVÉ]
  D -->|Oui| F{Analyser le CSV}
  F --> G{En-têtes valides ?}
  G -->|Non| H[Retourner ko : EN-TÊTES_MINIMUM]
  G -->|Oui| I{Données présentes ?}
  I -->|Non| J[400 DONNÉES_INVALIDES]
  I -->|Oui| K[Traiter chaque ligne]
  K --> L{Ligne valide ?}
  L -->|Oui| M[Créer le véhicule - Ajouter à ok]
  L -->|Non| N[Ajouter à ko avec raison]
  M --> O{Plus de lignes ?}
  N --> O
  O -->|Oui| K
  O -->|Non| P[Mettre à jour l'entreprise]
  P --> Q[Retourner les tableaux ok et ko]

Limites de paiement​

Ce point de terminaison est soumis aux limites du plan de paiement via le middleware isPaymentUpdate. Si l'entreprise a atteint sa limite de véhicules, la requête échouera avec l'erreur 402 avant le traitement du CSV.

Structure du CSV​

En-têtes requis (minimum) :

  • cargo_type
  • vehicle_type
  • plate
  • shipping_type

**En

Request​

Responses​

Création en masse terminée (peut inclure des échecs partiels). Vérifiez les tableaux 'ok' et 'ko' pour les résultats.

Response Headers