Aller au contenu principal

Bulk create truckers from CSV

POST 
/company/truckers/bulk/

Créez plusieurs transporteurs en masse via l'importation d'un fichier CSV.

Flux d'importation :

  1. L'utilisateur télécharge un fichier CSV contenant les données des transporteurs
  2. Le système valide les en-têtes obligatoires
  3. Il traite chaque ligne en validant les données
  4. Il vérifie l'unicité de l'email, du taxid et du téléphone
  5. Il génère des mots de passe automatiques si non fournis
  6. Il crée les transporteurs validés
  7. Il retourne un rapport avec les succès et les erreurs

Validations par ligne :

  • Email : Unique dans le système et format valide
  • Taxid : Unique et format valide selon le pays
  • Téléphone : Format valide selon l'expression régulière
  • Véhicule par défaut : Existe dans l'entreprise (via l'immatriculation)
  • Rôle : Valeur valide (normalisée automatiquement)

En-têtes CSV obligatoires :

  • name, lastname, email, phone, taxid
  • Optionnel : default_vehicle (immatriculation du véhicule)

Génération des identifiants :

  • Si aucun mot de passe n'est fourni : Génération automatique
  • Envoi d'un email de bienvenue avec les identifiants
  • Email personnalisé avec le nom de l'entreprise

Format du CSV :

  • Séparateur : virgule (,)
  • Encodage : UTF-8
  • Première ligne : en-têtes
  • Exemple : name,lastname,email,phone,taxid,default_vehicle

Réponse détaillée :

  • ok : Tableau des transporteurs créés avec succès
  • ko : Tableau des erreurs avec la ligne, la raison et les données

Structure des erreurs :

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

Codes d'erreur courants :

  • MIN_HEADERS : En-têtes obligatoires manquants
  • EMAIL_ALREADY_IN

Request​

Responses​

Processus d'importation terminé