Cargas

Crear una carga

Con Idempotency-Key (tu número de pedido): si reintentás, te devolvemos la misma carga, no otra.

curl -X POST https://www.rutazo.com/api/v1/cargas \
  -H "Authorization: Bearer rtz_test_…" -H "Content-Type: application/json" \
  -H "Idempotency-Key: PEDIDO-12345" \
  -d '{
    "categoria": "carga-general",
    "origen":  { "direccion": "Av. Pellegrini 1500, Rosario, Santa Fe", "detalle": "Depósito 3" },
    "destino": { "direccion": "Av. Warnes 2000, Buenos Aires" },
    "fecha": "2026-09-30",
    "ficha": { "tipo_carga": "Paletizada", "peso": 1200, "largo": 240, "ancho": 120, "alto": 150, "bultos": 4 },
    "cotizacion_id": "fac7f079-…",
    "forma_pago": "contado_descarga",
    "publicacion": "marketplace",
    "referencia_externa": "PEDIDO-12345",
    "cliente": { "nombre": "Ana Pérez", "email": "ana@ejemplo.com", "telefono": "1155551234" }
  }'

{ "id": "9a74464a-…", "referencia": "RUT-2026-9A74", "estado": "buscando_transportista",
  "precio_total": 632500, "url_seguimiento": "https://www.rutazo.com/p/…", "transportista": null }

cliente es obligatorio cuando la carga es a nombre de tu cliente final: recibe el link de seguimiento y coordina el viaje. Si la carga es a nombre de tu empresa, no va.

forma_pago es cómo le paga el dador al transportista. Es lo primero que mira un transportista después del precio, así que sin ella la carga no se publica: la respuesta es 400 con codigo: "validacion" y las opciones válidas en detalles.opciones. Si el cliente todavía no lo sabe, mandá "a_convenir".

Adónde va la carga

publicacion es obligatoria: así nada sale al marketplace por accidente.

Valor	Qué pasa
marketplace	Sale al marketplace y Rutazo busca el transportista.
propia	Queda en tu cuenta, para tus transportistas. No la ve nadie más. Necesita una clave de cuenta propia y el plan que incluye cargas propias.

En una carga propia podés, además:

• asignar_a: el CUIT de un transportista de tu agenda. Se la asignamos y le llega su hoja de ruta. Si el CUIT no está en tu agenda, la carga no se crea y te lo decimos.
• precio: lo que le cobrás a tu cliente. Es opcional, y nuestra referencia de mercado queda al lado.

{ …,
  "publicacion": "propia",
  "asignar_a": { "cuit": "30716378752" },
  "precio": 450000 }

Seguir la carga

GET /v1/cargas/{id} devuelve el estado, el transportista, el pago, la entrega (fotos y firma) y los eventos. Con GET /v1/cargas?referencia_externa=… buscás por tu número de pedido. El contacto del transportista aparece cuando el viaje está confirmado.

Cancelar

POST /v1/cargas/{id}/cancelar con un motivo, mientras el viaje no esté confirmado.

Estados de una carga

buscando_transportista · asignada · retirada · en_ruta · entregada · completada · cancelada · sin_transportista