Saltar al contenido principal

Create New Transport Auction

POST 

/company/auction

Crea una nueva subasta de transporte de mercancías siguiendo un flujo estructado. Requiere autenticación JWT válida y verificación de plan de pago activo.

Permite a las empresas publicar ofertas de transporte para recibir pujas de transportistas.

Objetivo

Facilitar la creación de subastas públicas o privadas de transporte con toda la información necesaria para que los transportistas puedan ofertar por el servicio.

Casos de Uso

  • Crear subasta pública para recibir múltiples ofertas de transportistas
  • Generar borrador de subasta para revisar antes de publicar
  • Guardar configuraciones de rutas frecuentes como favoritos

Flujo de Validación

flowchart TD
A[Recibir Request] --> B{Usuario Autenticado?}
B -->|No| C[401 Unauthorized]
B -->|Sí| D{Plan de Pago Activo?}
D -->|No| E[404 No Payment Plan]
D -->|Sí| F{Fechas en UTC?}
F -->|No| G[400 Invalid Date Format]
F -->|Sí| H{Direcciones Válidas?}
H -->|No| I[400 Invalid Address]
H -->|Sí| J{Pesos/Volumen Positivos?}
J -->|No| K[400 Invalid Cargo]
J -->|Sí| L[Crear Subasta - 201]

Request

Responses

Subasta creada exitosamente