Create a new bid
POST/company/bid-auctions/
Permite a un transportista realizar una puja por una subasta de transporte disponible.
Objetivo
Permitir que los transportistas oferten su precio por un servicio de transporte, compitiendo con otros transportistas para ganar la subasta.
Casos de Uso
- Transportista encontró una subasta interesante y quiere ofrecer su servicio
- Transportista quiere mejorar su puja anterior con un monto menor
- Integración con sistemas automatizados de pujas
Validaciones
- El servicio debe estar en estado 'published'
- El monto debe ser positivo y menor que la puja actual más baja (si existe)
- El usuario debe tener permisos de transportista
- No se pueden pujar en propias subastas
Ejemplo de request:
{
"service_code": "TRANS-12345",
"amount": 850.50
}
Request
Responses
- 200
- 400
- 401
Puja creada exitosamente. Devuelve los detalles actualizados de la subasta.
Response Headers
Error en los datos de la puja. Posibles causas:
- BID_NOT_VALID: Monto inválido (negativo o formato incorrecto)
- SERVICE_CODE_NOT_PROVIDED: Código de servicio no proporcionado
- AUCTION_NOT_ELIGIBLE: Servicio no encontrado o no elegible para pujas
- BID_TOO_HIGH: Puja mayor que la puja actual más baja
Response Headers
No autorizado. Posibles causas:
- Token JWT inválido o expirado
- Usuario sin permisos de transportista