RutaDocs

API v1 · Webhooks · Integraciones

Conectá tu tienda o tu sistema con Ruta

Creá entregas desde tu tienda, ERP o planilla, seguí cada paso del recorrido y recibí avisos firmados cuando cambian de estado. Todo en español, con ejemplos que podés copiar.

Empezar en 10 minutos → Ver la referencia

Terminal
curl "$RUTA_API/api/v1/deliveries" \
  -H "Authorization: Bearer $RUTA_API_KEY" \
  -H "Idempotency-Key: pedido-1042" \
  -H "Content-Type: application/json" \
  -d '{"customerName": "Ana Pérez",
       "address": "Av. Italia 1234",
       "externalReference": "1042"}'

Elegí cómo integrarte

Conectar una tienda Sin programar: los pedidos de tu tienda Shopify, Tiendanube, WooCommerce o Wix llegan solos como entregas. Paso a paso →

Usar la API Para tu propio sistema: creá entregas de a una o hasta 100 por llamada, con la referencia de tu pedido y reintentos seguros.

Recibir avisos Eventos con nombre propio (asignada, en camino, entregada, no entregada…), firmados con HMAC-SHA256.

Guías para tu empresa

Sin programar, con capturas del panel y de la app.

Conectá tu tienda Shopify, Tiendanube, WooCommerce y Wix: qué pedidos entran y cómo se entera la tienda.

Ordenar ruta El orden de paradas de cada repartidor, a mano o sugerido por calles.

Direcciones y puntos en el mapa Sugerencias de direcciones, el punto aproximado y el mapa de repartidores.

Cobros contra entrega y rendición En pesos o dólares, y el efectivo que te entregan tus repartidores.

Avisos al cliente El seguimiento con hora estimada y los avisos por WhatsApp o email.

Planes Qué incluye cada plan y cómo cambiarlo.

Preguntas del repartidor Lo que más pregunta quien reparte con la app.

En 10 minutos

  1. Pedí a un administrador de tu courier una clave en Configuración → Desarrolladores (o creala vos si administrás la cuenta). Para empezar, elegí el Tipo de clave De prueba.
  2. Seguí el inicio rápido: una llamada con curl crea tu primera entrega.
  3. Registrá un webhook y tocá Enviar evento de prueba para verificar la firma.
  4. Cuando todo funcione, cambiá a una clave Real.

Todo lo que hay

Autenticación Claves, permisos, claves por comercio y rotación.

Entorno de prueba Claves ruta_test_… en un espacio aislado sin cupo y un simulador del recorrido.

El objeto entrega Cada campo y el ciclo de vida, con el evento de cada paso.

Idempotencia Reintentar sin duplicar entregas con Idempotency-Key.

Comprobantes y etiquetas Foto y firma por enlaces de 5 minutos; etiqueta PDF de 10 × 15 cm.

Errores Cada code RFC 9457 y qué hacer con él.

Límites y versiones Cupos por minuto, tamaños y política de cambios.

Ejemplos El ciclo completo en curl y un cliente JavaScript.

Referencia de la API Cada endpoint y cada evento, generada del contrato OpenAPI.

Cambios Qué cambió y cuándo.

Soporte A quién escribir, qué mandar y preguntas frecuentes.

Nota

La referencia se genera del mismo contrato que usa el servidor, así que siempre coincide con lo que responde la API.

Ver en Markdown