Delete a bid
DELETE/company/bid-auctions/:service_code
Permite que um usuário exclua um lance que tenha feito anteriormente, desde que o leilão ainda não tenha sido adjudicado.
Objetivo
Permitir que transportistas retraiam um lance antes que o leilão seja adjudicado, mantendo a flexibilidade no processo de participação.
Casos de Uso
- Transportista percebe que cometeu um erro no valor do lance
- Transportista não está mais disponível para a data de transporte
- Transportista encontrou uma oportunidade melhor em outro leilão
- Erro nos dados do lance que precisa ser corrigido
Restrições
- Apenas os próprios lances podem ser excluídos
- O leilão deve estar no estado 'published'
- Requer autenticação via JWT
- Não pode ser excluído se o leilão já foi adjudicado
Exemplo de uso:
DELETE /company/bid-auctions/TRANS-12345
Request
Responses
- 200
- 401
- 404
Puja removida com sucesso. Retorna mensagem de confirmação.
Response Headers
Não autorizado. Possíveis causas:
- NO_TOKEN: Token JWT inválido ou expirado
- TOKEN_NOT_VALID: Token não válido para este usuário
- Usuário não é o proprietário do lance
Response Headers
Não encontrado. Possíveis causas:
- SERVICE_CODE_NOT_PROVIDED: O código de serviço não existe
- BID_NOT_FOUND: O usuário não tem lances neste leilão