# Ruta para desarrolladores

> API pública de Ruta (entregas para couriers de Uruguay): crear y seguir entregas, webhooks firmados, entorno de prueba, integraciones con tiendas online (Shopify, Tiendanube, WooCommerce y Wix) y guías del producto para empresas y repartidores.

Cada página está también en Markdown: los enlaces de abajo apuntan a esa versión. Todo junto en [llms-full.txt](llms-full.txt).

## Empezar

- [Inicio](index.md): Qué podés hacer con Ruta y por dónde empezar.
- [Inicio rápido](inicio-rapido.md): La primera entrega y el primer aviso en 10 minutos.
- [Autenticación](autenticacion.md): Claves, permisos, claves por comercio y rotación.
- [Entorno de prueba](entorno-de-prueba.md): Claves ruta_test_, espacio aislado sin cupo y simulador.

## Guías para tu empresa

- [Conectá tu tienda](conecta-tu-tienda.md): Shopify, Tiendanube, WooCommerce y Wix paso a paso, sin programar.
- [Ordenar ruta](ordenar-ruta.md): El orden de paradas de cada repartidor, a mano o sugerido por calles.
- [Direcciones y puntos en el mapa](direcciones-y-mapa.md): Sugerencias de direcciones, el punto aproximado y el mapa de repartidores.
- [Cobros contra entrega y rendición](cobros-y-rendicion.md): Cobrar en pesos o dólares y controlar el efectivo que te entregan.
- [Avisos al cliente](avisos-al-cliente.md): El seguimiento con hora estimada y los avisos por WhatsApp o email.
- [Planes](planes.md): Qué incluye cada plan y cómo cambiarlo.
- [Preguntas del repartidor](preguntas-del-repartidor.md): Lo que más pregunta quien reparte con la app de Ruta.

## API

- [Entregas](entregas.md): Crear, consultar, corregir, cancelar, lote, estados y zonas.
- [El objeto entrega](objeto-entrega.md): Cada campo de una entrega y su ciclo de vida, con el evento de cada paso.
- [Idempotencia](idempotencia.md): Reintentar sin duplicar con Idempotency-Key.
- [Comprobantes y etiquetas](comprobantes-y-etiquetas.md): Comprobante con enlaces firmados de 5 minutos y etiqueta PDF.
- [Errores](errores.md): Cada código RFC 9457 y qué hacer.
- [Límites y versiones](limites.md): Encabezados RateLimit, tamaños y política de cambios.

## Webhooks

- [Webhooks](webhooks.md): Eventos con nombre, firma HMAC-SHA256, reintentos y prueba.

## Integraciones

- [Tiendas online](integraciones.md): Pedidos pagos de tu tienda que se convierten solos en entregas.
- [WooCommerce](woocommerce.md): Conectar una tienda WooCommerce paso a paso, con webhooks.
- [Shopify](shopify.md): Conectar una tienda Shopify con una app de lectura, con webhooks.
- [Tiendanube](tiendanube.md): Conectar una Tiendanube autorizando la app de Ruta, sin claves.
- [Wix](wix.md): Conectar un sitio Wix con API key, reparto local y webhooks firmados.

## Recursos

- [Ejemplos](ejemplos.md): Ciclo completo en curl y un cliente JavaScript.
- [Soporte y preguntas frecuentes](soporte.md): A quién escribir, qué mandar y las dudas más comunes.
- [Cambios](cambios.md): Historial de la API y de las integraciones.

## Referencia

- [OpenAPI 3.1 (sólo /api/v1 y webhooks)](openapi.json)
- [Referencia navegable](referencia.html)