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
- 201
- 400
- 401
- 404
Subasta creada exitosamente
Error de validación
No autorizado - Token JWT faltante o inválido
Compañía no encontrada o sin plan de pago