Aller au contenu principal

Create a new vehicle in the fleet

POST 
/company/vehicles/

Enregistre un nouveau véhicule dans la flotte de l'entreprise avec ses métadonnées associées et des téléchargements de fichiers optionnels.

Objectif​

Permettre aux entreprises d'ajouter des véhicules à leur flotte avec des spécifications détaillées incluant les types de cargaison, les capacités de transport et la documentation (images et certificats ITV).

Cas d'utilisation​

  • Enregistrer un véhicule nouvellement acquis avec toutes ses spécifications
  • Télécharger la documentation du véhicule (image, certificat ITV)
  • Définir un véhicule comme celui par défaut de l'utilisateur pour les opérations de signature numérique
  • Migrer les données de flotte depuis des systèmes externes

Flux de validation​

flowchart TD
  A[Recevoir la Requête] --> B{Limite de Paiement OK ?}
  B -->|Non| C[402 Paiement Requis]
  B -->|Oui| D{L'Utilisateur a une Entreprise ?}
  D -->|Non| E[401 CIA_NOT_FOUND]
  D -->|Oui| F{Champs Obligatoires Présents ?}
  F -->|Non| G[400 Erreur de Validation]
  F -->|Oui| H{shipping_type = fresh ?}
  H -->|Oui| I{fresh_cargo_temp Valide ?}
  I -->|Non| J[400 Température Requise]
  I -->|Oui| K[Créer le Véhicule]
  H -->|Non| K
  K --> L{default_vehicle = true ?}
  L -->|Oui| M[Mettre à Jour le Véhicule par Défaut]
  L -->|Non| N[Enregistrer l'Utilisation Facturable]
  M --> N
  N --> O[Retourner le Véhicule Créé]

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.

Validation conditionnelle​

  • Si `shipping

Request​

Responses​

Véhicule créé avec succès.

Response Headers