Saltar al contenido principal

Obtener listado de subastas

GET 
/auction/

Obtiene el listado completo de subastas de la compañía, incluyendo borradores, activas y cerradas.

Características:

  • Listado paginado
  • Ordenado por fecha de actualización (más recientes primero)
  • Filtrado por estado, fechas y búsqueda textual
  • Incluye relaciones básicas (direcciones, pujas, ganador)

Parámetros opcionales de query:

  • page: Número de página (default 1)
  • limit: Items por página (default valor de ITEMS_PAGE en .env)
  • status: Filtro por estado (draft, published, closed, cancelled)
  • search: Texto para buscar en service_code o descripción
  • minDate/maxDate: Rango de fechas para creación o modificación

Ejemplo de uso:

GET /api/auction?page=1&limit=20&status=published&search=urgente

La respuesta incluye metadatos de paginación y los campos básicos de cada subasta.

Responses​

Lista paginada de subastas. Cada item incluye:

  • service_code: Identificador único (ej: VIGMURnT4FN)
  • status: Estado actual
  • etl_date/etd_date: Fechas de carga/descarga
  • cargo_weight/cargo_height: Dimensiones
  • bid_current: Puja actual (si aplica)
  • bidWinner: Ganador (si aplica)
  • createdAt/updatedAt: Fechas creación/actualización

Metadatos de paginación:

  • total: Total de items
  • pages: Total de páginas
  • page: Página actual
  • limit: Items por página