Avisos

Registrá una URL y te avisamos con un POST cada vez que la carga cambia. El cuerpo va firmado: X-Rutazo-Firma: sha256=HMAC(secreto, cuerpo).

Para ver qué te llega antes de programar nada: entrá a webhook.site, copiá la URL única que te da y registrala como webhook con una clave de prueba. Cada aviso aparece ahí al instante, con sus headers y su cuerpo, tal cual lo va a recibir tu sistema.

curl -X POST https://www.rutazo.com/api/v1/webhooks \
  -H "Authorization: Bearer rtz_test_…" -H "Content-Type: application/json" \
  -d '{ "url": "https://tu-sistema.com/rutazo", "eventos": ["carga.asignada", "carga.entregada"] }'

{ "id": "…", "secreto": "whsec_…" }   ← el secreto se muestra una sola vez

// Lo que te llega
{ "id": "…", "evento": "carga.asignada", "fecha": "…", "es_prueba": false,
  "carga": { "id": "9a74464a-…", "referencia": "RUT-2026-9A74", "referencia_externa": "PEDIDO-12345", "estado": "Cerrada" } }

Eventos de webhook

carga.creada · carga.publicada · carga.asignada · carga.pago_confirmado · carga.retirada · carga.en_ruta · carga.entregada · carga.completada · carga.cancelada · carga.sin_transportista · remito.firmado

Sin respuesta 2xx, reintentamos con espera creciente (1 min, 5, 30, 2 h, 12 h) y después queda marcado como fallido.