Aller au contenu principal

Create a new bid

POST 
/company/bid-auctions/

Permet à un transporteur de soumissionner pour une enchère de transport disponible.

Objectif​

Permettre aux transporteurs de proposer leur prix pour un service de transport, en concurrence avec d'autres transporteurs pour remporter l'enchère.

Cas d'Utilisation​

  • Un transporteur a trouvé une enchère intéressante et souhaite proposer son service
  • Un transporteur souhaite améliorer son offre précédente avec un montant inférieur
  • Intégration avec des systèmes de soumission automatisés

Validations​

  • Le service doit être dans l'état 'published'
  • Le montant doit être positif et inférieur à l'offre actuelle la plus basse (si elle existe)
  • L'utilisateur doit avoir les permissions de transporteur
  • Il n'est pas possible de soumissionner sur ses propres enchères

Exemple de requête:

{
  service_code: TRANS-12345,
  amount: 850.50
}

Request​

Responses​

Enchère créée avec succès. Retourne les détails mis à jour de la vente aux enchères.

Response Headers