Delete a bid
DELETE/company/bid-auctions/:service_code
Ermöglicht es einem Benutzer, ein zuvor abgegebenes Gebot zu löschen, sofern die Auktion noch nicht vergeben wurde.
Ziel
Spediteuren die Möglichkeit geben, ein Gebot zurückzuziehen, bevor die Auktion vergeben wird, und dabei die Flexibilität im Teilnahmeprozess zu wahren.
Anwendungsfälle
- Spediteur stellt fest, dass er einen Fehler im Gebotsbetrag gemacht hat
- Spediteur ist zum Transporttermin nicht mehr verfügbar
- Spediteur hat eine bessere Gelegenheit in einer anderen Auktion gefunden
- Fehler in den Gebotsdaten, die eine Korrektur erfordern
Einschränkungen
- Es können nur eigene Gebote gelöscht werden
- Die Auktion muss sich im Status 'published' befinden
- Authentifizierung mittels JWT erforderlich
- Keine Löschung möglich, wenn die Auktion bereits vergeben wurde
Beispiel für die Nutzung:
DELETE /company/bid-auctions/TRANS-12345
Request
Responses
- 200
- 401
- 404
Auktion erfolgreich entfernt. Gibt eine Bestätigungsnachricht zurück.
Response Headers
Nicht autorisiert. Mögliche Ursachen:
- NO_TOKEN: Ungültiges oder abgelaufenes JWT-Token
- TOKEN_NOT_VALID: Token für diesen Benutzer nicht gültig
- Benutzer ist nicht der Eigentümer des Gebots
Response Headers
Nicht gefunden. Mögliche Ursachen:
- SERVICE_CODE_NOT_PROVIDED: Der Dienstcode existiert nicht
- BID_NOT_FOUND: Der Benutzer hat keine Gebote in dieser Auktion