<div class="hero">
<div>
<p class="hero-kicker">API v1 · Webhooks · Integraciones</p>

# Conectá tu tienda o tu sistema con Ruta

<p class="lead">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.</p>
<p class="actions"><a class="button primary" href="inicio-rapido.html">Empezar en 10 minutos →</a> <a class="button" href="referencia.html">Ver la referencia</a></p>
</div>
<div>

```bash
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"}'
```

</div>
</div>

## Elegí cómo integrarte

<div class="cards">

**[Conectar una tienda](conecta-tu-tienda.html)**
Sin programar: los pedidos de tu tienda Shopify, Tiendanube, WooCommerce o Wix llegan solos como entregas. [Paso a paso →](conecta-tu-tienda.html)

**[Usar la API](entregas.html)**
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](webhooks.html)**
Eventos con nombre propio (asignada, en camino, entregada, no entregada…), firmados con HMAC-SHA256.

</div>

## Guías para tu empresa

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

<div class="cards">

**[Conectá tu tienda](conecta-tu-tienda.html)**
Shopify, Tiendanube, WooCommerce y Wix: qué pedidos entran y cómo se entera la tienda.

**[Ordenar ruta](ordenar-ruta.html)**
El orden de paradas de cada repartidor, a mano o sugerido por calles.

**[Direcciones y puntos en el mapa](direcciones-y-mapa.html)**
Sugerencias de direcciones, el punto aproximado y el mapa de repartidores.

**[Cobros contra entrega y rendición](cobros-y-rendicion.html)**
En pesos o dólares, y el efectivo que te entregan tus repartidores.

**[Avisos al cliente](avisos-al-cliente.html)**
El seguimiento con hora estimada y los avisos por WhatsApp o email.

**[Planes](planes.html)**
Qué incluye cada plan y cómo cambiarlo.

**[Preguntas del repartidor](preguntas-del-repartidor.html)**
Lo que más pregunta quien reparte con la app.

</div>

## En 10 minutos

<div class="steps">

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](inicio-rapido.html): 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**.

</div>

## Todo lo que hay

<div class="cards">

**[Autenticación](autenticacion.html)**
Claves, permisos, claves por comercio y rotación.

**[Entorno de prueba](entorno-de-prueba.html)**
Claves `ruta_test_…` en un espacio aislado sin cupo y un simulador del recorrido.

**[El objeto entrega](objeto-entrega.html)**
Cada campo y el ciclo de vida, con el evento de cada paso.

**[Idempotencia](idempotencia.html)**
Reintentar sin duplicar entregas con `Idempotency-Key`.

**[Comprobantes y etiquetas](comprobantes-y-etiquetas.html)**
Foto y firma por enlaces de 5 minutos; etiqueta PDF de 10 × 15 cm.

**[Errores](errores.html)**
Cada `code` RFC 9457 y qué hacer con él.

**[Límites y versiones](limites.html)**
Cupos por minuto, tamaños y política de cambios.

**[Ejemplos](ejemplos.html)**
El ciclo completo en `curl` y un cliente JavaScript.

**[Referencia de la API](referencia.html)**
Cada endpoint y cada evento, generada del contrato OpenAPI.

**[Cambios](cambios.html)**
Qué cambió y cuándo.

**[Soporte](soporte.html)**
A quién escribir, qué mandar y preguntas frecuentes.

</div>

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