Create a new bid
POST/company/bid-auctions/
Ermöglicht es einem Transportunternehmen, ein Gebot für eine verfügbare Transportauktion abzugeben.
Ziel
Ermöglichen, dass Transportunternehmen ihren Preis für einen Transportdienst anbieten, im Wettbewerb mit anderen Transportunternehmen, um die Auktion zu gewinnen.
Anwendungsfälle
- Transportunternehmen hat eine interessante Auktion gefunden und möchte seinen Dienst anbieten
- Transportunternehmen möchte sein vorheriges Gebot mit einem niedrigeren Betrag verbessern
- Integration mit automatisierten Gebotssystemen
Validierungen
- Der Dienst muss sich im Status 'published' befinden
- Der Betrag muss positiv und niedriger als das aktuell niedrigste Gebot sein (falls vorhanden)
- Der Benutzer muss Transportunternehmer-Berechtigungen haben
- Es können keine Gebote auf eigene Auktionen abgegeben werden
Beispiel einer Anfrage:
{
service_code: TRANS-12345,
amount: 850.50
}
Request
Responses
- 200
- 400
- 401
Auktion erfolgreich erstellt. Gibt die aktualisierten Auktionsdetails zurück.
Response Headers
Fehler in den Gebotsdaten. Mögliche Ursachen:
- BID_NOT_VALID: Ungültiger Betrag (negativ oder falsches Format)
- SERVICE_CODE_NOT_PROVIDED: Dienstleistungscode nicht angegeben
- AUCTION_NOT_ELIGIBLE: Dienstleistung nicht gefunden oder nicht für Gebote geeignet
- BID_TOO_HIGH: Gebot höher als das derzeit niedrigste Gebot
Response Headers
Nicht autorisiert. Mögliche Ursachen:
- Ungültiges oder abgelaufenes JWT-Token
- Benutzer verfügt nicht über die Berechtigungen eines Transportunternehmens