Caso de uso: Una empresa publica una carga y gestiona todo el proceso
La situacion
Logistica Martinez SA necesita enviar 15.000 kg de material industrial de Madrid a Sevilla para manana. Su transportista habitual esta ocupado. Necesitan encontrar un transportista fiable en menos de 2 horas.
El plan
- Crear y publicar una subasta
- Recibir ofertas de transportistas
- Revisar transportistas disponibles
- Aceptar la mejor oferta
- Firmar contrato
- Hacer seguimiento en tiempo real
- Confirmar entrega
Paso 1: Crear la subasta
bash
curl -X POST "https://api.pro.cargoffer.com/api/auction/" \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{
"origin": "Madrid",
"destination": "Sevilla",
"weight": 15000,
"vehicleType": "camion",
"loadingDate": "2026-06-21",
"price": 900.00
}'La API devuelve: SRV-2026-002
Paso 2: Publicar la subasta
bash
curl -X PUT "https://api.pro.cargoffer.com/api/auction/publish/SRV-2026-002" \
-H "Authorization: Bearer <token>"En 30 minutos llegan 4 ofertas.
Paso 3: Recibir ofertas
bash
curl -X GET "https://api.pro.cargoffer.com/api/company/bid-auctions/?service_code=SRV-2026-002" \
-H "Authorization: Bearer <token>"Ofertas recibidas:
- Transportes Garcia: 810 EUR
- Manuel Lopez: 780 EUR
- Flota del Sur: 820 EUR
- Autonomo SL: 750 EUR
Paso 4: Revisar el transportista antes de aceptar
bash
curl -X GET "https://api.pro.cargoffer.com/api/company/truckers/filterByTaxid/B87654321" \
-H "Authorization: Bearer <token>"Transportes Garcia tiene buenas valoraciones. Aceptamos:
bash
curl -X POST "https://api.pro.cargoffer.com/api/company/auction/acceptCurrent" \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{"service_code": "SRV-2026-002"}'Paso 5: Firmar contrato
bash
curl -X POST "https://api.pro.cargoffer.com/api/company/auction/contract" \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{"service_code": "SRV-2026-002"}'
curl -X POST "https://api.pro.cargoffer.com/api/company/auction/sign" \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{"service_code": "SRV-2026-002"}'Paso 6: Seguimiento en vivo
bash
# Ver entregas activas
curl -X GET "https://api.pro.cargoffer.com/api/delivery/active" \
-H "Authorization: Bearer <token>"
# Enviar mensaje al transportista
curl -X POST "https://api.pro.cargoffer.com/api/company/deliveries/msg/{id}" \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{"message": "Confirmas entrega a las 15:00 en nave 7?"}'Paso 7: Confirmar entrega con QR
bash
curl -X PUT "https://api.pro.cargoffer.com/api/company/qr/confirm" \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{"token": "qr_delivery_token", "service_code": "SRV-2026-002"}'Resumen
| Hito | Hora |
|---|---|
| Creacion de subasta | 09:00 |
| Publicacion | 09:01 |
| Ofertas recibidas | 09:30 |
| Oferta aceptada | 09:35 |
| Contrato firmado | 09:40 |
| Carga recogida | 08:00 (dia siguiente) |
| Entrega confirmada | 15:30 |
Tiempo total desde que se publico hasta que se contrato un transportista: 40 minutos.