Saltar al contenido principal

Get my active auctions

GET 
/company/bid-auctions/mine

Devuelve un listado paginado de todas las subastas en las que el usuario autenticado ha realizado pujas. Incluye subastas en estado 'published', 'awarded', 'approved', etc.

Objetivo​

Permitir a los transportistas gestionar sus pujas activas, revisar el estado de sus participaciones y filtrar según diferentes criterios de interés.

Casos de Uso​

  • Transportista quiere ver todas sus pujas activas
  • Filtrar subastas que están pendientes de firma
  • Revisar subastas ganadas o perdidas
  • Ver historial completo de participaciones

Diagrama de Filtros:

flowchart TD
  A[GET /mine?filter=X] --> B{Tipo de filtro}

  B -->|all| C[Todas las pujas del usuario]
  B -->|open| D[Subastas publicadas<br/>date_end >= hoy<br/>status: published]
  B -->|to_sign| E[Adjudicadas pendientes<br/>status: awarded<br/>signed_by_trucker: false]
  B -->|awarded| F[Todas las adjudicadas<br/>status: awarded]
  B -->|closed| G[Subastas cerradas<br/>status: locked/canceled/rejected]
  B -->|lost| H[Perdidas<br/>status: approved<br/>usuario NO es ganador]
  B -->|won| I[Ganadas<br/>status: approved<br/>usuario SÍ es ganador]

  C --> J[Retornar AuctionsResponse]
  D --> J
  E --> J
  F --> J
  G --> J
  H --> J
  I --> J

  style D fill:#90EE90
  style E fill:#FFD700
  style I fill:#87CEEB
  style H fill:#FFB6C1

Ejemplo de uso:

GET /company/bid-auctions/mine?filter=to_sign&page=1&limit=10

Campos destacados en la respuesta:

  • my_bid: Monto de la puja del usuario
  • bid_current: Mejor puja actual
  • status: Estado actual de la subasta

Request​

Responses​

Listado de subastas obtenido exitosamente. Incluye metadatos de paginación y array de subastas con las pujas del usuario.

Response Headers