Caso de uso: Un transportista encuentra carga de retorno y completa el ciclo
La situacion
Manuel es transportista autonomo. Acaba de entregar una carga en Barcelona y vuelve a Madrid. No quiere volver vacio porque son 620 km de perdida.
El plan
- Buscar cargas disponibles de Barcelona a Madrid
- Encontrar una que pague bien
- Ofertar y esperar adjudicacion
- Firmar contrato
- Planificar ruta de vuelta (peajes, clima, trafico)
- Hacer seguimiento de la entrega
Paso 1: Buscar cargas de retorno
Manuel consulta las cargas disponibles desde Barcelona hacia Madrid:
bash
curl -X GET "https://api.pro.cargoffer.com/api/truckers/auctions/?origin=Barcelona&destination=Madrid&dateFrom=2026-06-21" \
-H "Authorization: Bearer <token>"Resultado: 3 cargas disponibles:
- Carga A: 12.000 kg, electrodomesticos, 850 EUR
- Carga B: 5.000 kg, textil, 450 EUR
- Carga C: 20.000 kg, industrial, 1.200 EUR
Manuel elige la Carga A porque su camion carga 15.000 kg.
Paso 2: Ver detalle y ofertar
bash
curl -X GET "https://api.pro.cargoffer.com/api/truckers/auctions/image/SRV-2026-001" \
-H "Authorization: Bearer <token>"Manuel ve las fotos de la carga. Decide ofertar:
bash
curl -X POST "https://api.pro.cargoffer.com/api/truckers/auctions/bid" \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{"service_code": "SRV-2026-001", "amount": 780.00}'Oferta 780 EUR (85 EUR por debajo del precio de salida) para tener margen.
Paso 3: Comprobar si ha ganado
bash
curl -X GET "https://api.pro.cargoffer.com/api/truckers/auctions/bid/minimal/SRV-2026-001" \
-H "Authorization: Bearer <token>"Manuel ha ganado! Ahora a firmar el contrato.
Paso 4: Firmar contrato
bash
curl -X GET "https://api.pro.cargoffer.com/api/truckers/auctions/contract/SRV-2026-001" \
-H "Authorization: Bearer <token>"
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-001"}'Paso 5: Planificar la ruta completa
Manuel usa TRANSCEND para planificar el viaje de vuelta:
bash
# Calcular ruta Barcelona -> Madrid
curl -X GET "https://back.transcend.cargoffer.com/api/route?origin=Barcelona&destination=Madrid" \
-H "Authorization: Bearer <token>"
# Calcular peajes
curl -X GET "https://back.transcend.cargoffer.com/costs?origin=Barcelona&destination=Madrid&vehicleType=camion" \
-H "Authorization: Bearer <token>"
# Ver clima en ruta
curl -X GET "https://back.transcend.cargoffer.com/weather/forecast?lat=41.38&lon=2.17" \
-H "Authorization: Bearer <token>"620 km, peajes 83.80 EUR, sin alertas meteorologicas. Ruta optima.
Paso 6: Seguimiento de la entrega
Manuel actualiza el estado de su entrega durante el viaje:
bash
curl -X POST "https://api.pro.cargoffer.com/api/truckers/deliveries/eta" \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{"service_code": "SRV-2026-001", "eta": "2026-06-21T15:00:00Z"}'Resumen del caso
| Concepto | Importe |
|---|---|
| Ingreso viaje ida (ya entregado) | 850 EUR |
| Ingreso retorno (Carga A) | 780 EUR |
| Total ingresos viaje redondo | 1.630 EUR |
| Costes estimados (combustible + peajes) | -320 EUR |
| Beneficio neto | 1.310 EUR |
Manuel ha multiplicado sus ingresos por 1.9 respecto a volver vacio.