Pular para o conteúdo principal

Create New Transport Auction

POST 
/company/auction

Cria uma nova leilão de transporte de mercadorias seguindo um fluxo estruturado. Requer autenticação JWT válida e verificação de plano de pagamento ativo.

Permite que empresas publiquem ofertas de transporte para receber lances de transportadoras.

Objetivo​

Facilitar a criação de leilões públicos ou privados de transporte com todas as informações necessárias para que as transportadoras possam licitar pelo serviço.

Casos de Uso​

  • Criar leilão público para receber múltiplas ofertas de transportadoras
  • Gerar rascunho de leilão para revisar antes de publicar
  • Salvar configurações de rotas frequentes como favoritas

Fluxo de Validação​

flowchart TD
  A[Receber Request] --> B{Usuário Autenticado?}
  B -->|Não| C[401 Não Autorizado]
  B -->|Sim| D{Plano de Pagamento Ativo?}
  D -->|Não| E[404 Sem Plano de Pagamento]
  D -->|Sim| F{Datas em UTC?}
  F -->|Não| G[400 Formato de Data Inválido]
  F -->|Sim| H{Endereços Válidos?}
  H -->|Não| I[400 Endereço Inválido]
  H -->|Sim| J{Pesos/Volume Positivos?}
  J -->|Não| K[400 Carga Inválida]
  J -->|Sim| L[Criar Leilão - 201]

Request​

Responses​

Leilão criado com sucesso.