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
- 200
- 400
- 401
Enchère créée avec succès. Retourne les détails mis à jour de la vente aux enchères.
Response Headers
Erreur dans les données de l'enchère. Causes possibles :
- BID_NOT_VALID : Montant invalide (négatif ou format incorrect)
- SERVICE_CODE_NOT_PROVIDED : Code de service non fourni
- AUCTION_NOT_ELIGIBLE : Service introuvable ou non éligible aux enchères
- BID_TOO_HIGH : Enchère supérieure à l'enchère actuelle la plus basse
Response Headers
Non autorisé. Causes possibles :
- Jeton JWT invalide ou expiré
- Utilisateur sans autorisations de transporteur