Aller au contenu principal

Create New Transport Auction

POST 
/company/auction

Créez une nouvelle enchère de transport de marchandises en suivant un flux structuré.
Requiert une authentification JWT valide et la vérification d’un plan de paiement actif.

Permet aux entreprises de publier des offres de transport pour recevoir des soumissions de transporteurs.

Objectif​

Faciliter la création d’enchères de transport publiques ou privées avec toutes les informations nécessaires pour que les transporteurs puissent soumissionner sur le service.

Cas d’utilisation​

  • Créer une enchère publique pour recevoir plusieurs offres de transporteurs
  • Générer un brouillon d’enchère pour vérification avant publication
  • Enregistrer des configurations d’itinéraires fréquents en tant que favoris

Flux de validation​

flowchart TD
  A[Recevoir la requête] --> B{Utilisateur authentifié ?}
  B -->|Non| C[401 Non autorisé]
  B -->|Oui| D{Plan de paiement actif ?}
  D -->|Non| E[404 Aucun plan de paiement]
  D -->|Oui| F{Dates en UTC ?}
  F -->|Non| G[400 Format de date invalide]
  F -->|Oui| H{Adresses valides ?}
  H -->|Non| I[400 Adresse invalide]
  H -->|Oui| J{Poids/Volume positifs ?}
  J -->|Non| K[400 Marchandise invalide]
  J -->|Oui| L[Créer l’enchère – 201]

Request​

Responses​

Enchère créée avec succès