Create a new bid
POST/company/bid-auctions/
Permette a un trasportatore di fare un'offerta per un'asta di trasporto disponibile.
Obiettivo
Consentire ai trasportatori di offrire il proprio prezzo per un servizio di trasporto, competendo con altri trasportatori per vincere l'asta.
Casi d'Uso
- Il trasportatore ha trovato un'asta interessante e vuole offrire il proprio servizio
- Il trasportatore vuole migliorare la propria offerta precedente con un importo inferiore
- Integrazione con sistemi automatizzati di offerte
Validazioni
- Il servizio deve essere nello stato 'published'
- L'importo deve essere positivo e inferiore all'offerta attuale più bassa (se esiste)
- L'utente deve avere i permessi di trasportatore
- Non si possono fare offerte sulle proprie aste
Esempio di richiesta:
{
service_code: TRANS-12345,
amount: 850.50
}
Request
Responses
- 200
- 400
- 401
Puja creata con successo. Restituisce i dettagli aggiornati dell'asta.
Response Headers
Errore nei dati dell'offerta. Possibili cause:
- BID_NOT_VALID: Importo non valido (negativo o formato errato)
- SERVICE_CODE_NOT_PROVIDED: Codice servizio non fornito
- AUCTION_NOT_ELIGIBLE: Servizio non trovato o non idoneo per offerte
- BID_TOO_HIGH: Offerta superiore all'offerta corrente più bassa
Response Headers
Non autorizzato. Possibili cause:
- Token JWT non valido o scaduto
- Utente senza permessi di trasportatore