Zum Hauptinhalt springen

Obtener subastas pendientes de firma

GET 

/auction/sign

Obtiene el listado de subastas cerradas que requieren firma por parte de la compañía o transportista.

Criterios de inclusión:

  • Subastas en estado 'closed'
  • Con ganador asignado (bidWinner)
  • Donde la compañía o el transportista no han firmado aún
  • Ordenadas por fecha de cierre (más recientes primero)

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)
  • signedBy: Filtro por firmante pendiente ('company' o 'trucker')

Ejemplo de uso:

GET /api/auction/sign?page=1&limit=10&signedBy=company

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

Responses

Lista paginada de subastas pendientes de firma. Cada item incluye:

  • service_code: Identificador único (ej: VIGMURnT4FN)
  • status: 'closed'
  • bidWinner: Información del transportista ganador
  • signed_by_company/signed_by_trucker: Estados de firma
  • createdAt/closedAt: Fechas relevantes