Caso de uso: Preparar un viaje internacional (Espana-Francia)
La situacion
Transportes Garcia SL tiene que llevar 20 pallets de Madrid a Lyon. Necesitan documentacion aduanera, costes reales y eCMR internacional.
El plan
- Buscar codigos HS para la mercancia
- Crear el eCMR con datos aduaneros
- Calcular ruta, peajes y costes
- Verificar clima y trafico
- Firmar documentacion
- Entregar y confirmar
Paso 1: Clasificar con codigos HS
Documentacion: docs.cargoffer.com/#tag/Hscode
bash
curl -X GET "https://api.pro.cargoffer.com/api/truckers/hscode/find?q=industrial+machinery&page=1&limit=5" \
-H "Authorization: Bearer <token>"Resultado: codigo HS 8479.89 para maquinaria industrial.
Paso 2: Crear eCMR con datos aduaneros
Documentacion: docs.ecmr.cargoffer.com/#tag/documents
bash
curl -X POST "https://ecmr.api.pro.cargoffer.com/api/documents" \
-H "Authorization: Bearer *** \
-H "Content-Type: application/json" \
-d '{
"type": "cmr",
"sender": {"name": "Transportes Garcia SL", "cif": "B87654321"},
"goods": [{"description": "Maquinaria", "weight": 20000, "pallets": 20, "hscode": "8479.89"}],
"incoterm": "DAP",
"countryOfOrigin": "ES",
"countryOfDestination": "FR"
}'El eCMR incluye el codigo HS necesario para la declaracion en la frontera.
Paso 3: Planificar ruta internacional
Documentacion: docs.transcend.cargoffer.com/#tag/route
bash
curl -X GET "https://back.transcend.cargoffer.com/api/route?origin=Madrid&destination=Lyon" \
-H "Authorization: Bearer <token>"Resultado: 1.050 km, 11 horas, 145 EUR en peajes.
Paso 4: Clima y trafico en ruta
Documentacion: docs.transcend.cargoffer.com/#tag/weather
bash
curl -X GET "https://back.transcend.cargoffer.com/weather/current?lat=42.42&lon=2.87" \
-H "Authorization: Bearer <token>"Sin alertas meteorologicas. Ruta optima.
Paso 5: Firmar y enviar documentacion
bash
curl -X POST "https://ecmr.api.pro.cargoffer.com/api/documents/{id}/sign" \
-H "Authorization: Bearer *** \
-H "Content-Type: application/json" \
-d '{"signer": "sender", "signatoryName": "Carlos Garcia"}'Paso 6: Confirmar entrega internacional
bash
curl -X PUT "https://api.pro.cargoffer.com/api/company/qr/confirm" \
-H "Authorization: Bearer *** \
-H "Content-Type: application/json" \
-d '{"token": "qr_lyon", "service_code": "SRV-2026-003"}'Resumen
| Concepto | Detalle |
|---|---|
| Ruta | Madrid -> Lyon (1.050 km) |
| eCMR | Con codigo HS + Incoterm DAP |
| Peajes | 145 EUR |
| Ingreso | 1.800 EUR |
| Beneficio | ~1.320 EUR |