Saltar al contenido principal

Update existing auction

PUT 
/company/auction

Permite modificar una subasta existente. Solo se pueden editar subastas en estado 'draft'.

Proporcionar capacidad de edición de subastas antes de su publicación.

Objetivo​

Permitir ajustes y correcciones en los datos de la subasta mientras permanece en borrador.

Casos de Uso​

  • Corregir errores en direcciones o fechas antes de publicar
  • Ajustar peso, volumen o tipo de carga
  • Modificar precio inicial o de adjudicación
  • Actualizar descripción o notas adicionales
  • Cambiar estado a 'published' para iniciar período de pujas

Lógica de Publicación Automática​

Cuando se actualiza el estado a "published", el sistema ejecuta automáticamente:

flowchart LR
  A[Status = published] --> B{date_start válida?}
  B -->|No definida| C[date_start = NOW]
  B -->|En el pasado| C
  B -->|Futura| D[Mantener date_start]
  C --> E[Validar datos completos]
  D --> E
  E --> F{Validación OK?}
  F -->|No| G[400 Validation Error]
  F -->|Sí| H[Enviar notificaciones]
  H --> I[Publicar en marketplace]

Ajuste automático de date_start:

  • Si date_start no está definida O date_start < fecha actual
  • Se establece date_start = new Date() (fecha/hora actual)
  • Garantiza que subastas publicadas tengan fecha de inicio válida

Validaciones adicionales al publicar:

  • date_start y date_end deben existir y ser futuras
  • etl_date y etd_date deben ser válidas
  • Peso y altura de carga deben ser positivos
  • Direcciones deben existir y ser válidas

Restricción importante:

  • Solo se pueden editar subastas en estado 'draft'
  • Una vez publicada, locked o awarded, NO se puede editar
  • Para modificar una subasta publicada, usar draft-from-empty

Request​

Responses​

Subasta actualizada exitosamente