Create a new bid
POST/company/bid-auctions/
Permite que um transportador faça um lance em um leilão de transporte disponível.
Objetivo
Permitir que os transportadores ofereçam seu preço por um serviço de transporte, competindo com outros transportadores para ganhar o leilão.
Casos de Uso
- O transportador encontrou um leilão interessante e quer oferecer seu serviço
- O transportador quer melhorar seu lance anterior com um valor menor
- Integração com sistemas automatizados de lances
Validações
- O serviço deve estar no estado 'published'
- O valor deve ser positivo e menor que o lance atual mais baixo (se existir)
- O usuário deve ter permissões de transportador
- Não é possível dar lances em leilões próprios
Exemplo de request:
{
service_code: TRANS-12345,
amount: 850.50
}
Request
Responses
- 200
- 400
- 401
Puja criada com sucesso. Retorna os detalhes atualizados do leilão.
Response Headers
Erro nos dados do lance. Possíveis causas:
- BID_NOT_VALID: Valor inválido (negativo ou formato incorreto)
- SERVICE_CODE_NOT_PROVIDED: Código de serviço não fornecido
- AUCTION_NOT_ELIGIBLE: Serviço não encontrado ou não elegível para lances
- BID_TOO_HIGH: Lance maior que o lance atual mais baixo
Response Headers
Não autorizado. Possíveis causas:
- Token JWT inválido ou expirado
- Usuário sem permissões de transportador