Saltar al contenido principal

Crear subasta

POST 
/auction/

Crea una nueva subasta pública de transporte.

Requisitos:

  • Usuario autenticado con compañía válida
  • Fechas coherentes (etl_date < etd_date)
  • Dimensiones de carga válidas (peso > 0, altura > 0)
  • Direcciones de carga/descarga válidas

Validaciones realizadas:

  1. Genera un service_code único basado en direcciones
  2. Valida horarios y fechas
  3. Verifica dimensiones de carga
  4. Crea registro en base de datos

Campos obligatorios:

  • etl_date: Fecha/hora de carga
  • etd_date: Fecha/hora de descarga
  • cargo_weight: Peso de la carga (kg)
  • cargo_height: Altura de la carga (m)
  • etl_address/etd_address: IDs de direcciones

Ejemplo de body request:

{
  "etl_date": "2025-08-15T08:00:00Z",
  "etd_date": "2025-08-15T18:00:00Z",
  "cargo_weight": 1000,
  "cargo_height": 2.5,
  "etl_address": "60a1b2c3d4e5f6a1b2c3d4e5",
  "etd_address": "60a1b2c3d4e5f6a1b2c3d4e6"
}

La respuesta incluye la subasta creada con su service_code único.

Request​

Responses​

Subasta individual