Pular para o conteúdo principal

Update existing auction

PUT 
/company/auction

Permite modificar um leilão existente. Apenas leilões no estado 'rascunho' podem ser editados.

Proporcionar capacidade de edição de leilões antes da sua publicação.

Objetivo​

Permitir ajustes e correções nos dados do leilão enquanto permanece em rascunho.

Casos de Uso​

  • Corrigir erros em endereços ou datas antes de publicar
  • Ajustar peso, volume ou tipo de carga
  • Modificar preço inicial ou de adjudicação
  • Atualizar descrição ou notas adicionais
  • Alterar estado para 'published' para iniciar período de lances

Lógica de Publicação Automática​

Quando o estado é atualizado para published, o sistema executa automaticamente:

flowchart LR
  A[Status = published] --> B{date_start válida?}
  B -->|Não definida| C[date_start = AGORA]
  B -->|No passado| C
  B -->|Futura| D[Manter date_start]
  C --> E[Validar dados completos]
  D --> E
  E --> F{Validação OK?}
  F -->|Não| G[400 Erro de Validação]
  F -->|Sim| H[Enviar notificações]
  H --> I[Publicar no marketplace]

Ajuste automático de date_start:

  • Se date_start não estiver definida OU date_start < data atual
  • Define-se date_start = new Date() (data/hora atual)
  • Garante que leilões publicados tenham data de início válida

Validações adicionais ao publicar:

  • date_start e date_end devem existir e ser futuras
  • etl_date e etd_date devem ser válidas
  • Peso e altura da carga devem ser positivos
  • Endereços devem existir e ser válidos

Restrição importante:

  • Apenas leilões no estado 'rascunho' podem ser editados
  • Uma vez publicado, bloqueado ou adjudicado, NÃO pode ser editado
  • Para modificar um leilão publicado, usar draft-from-empty

Request​

Responses​

Leilão atualizado com sucesso