Conectar Tiendanube

En un par de minutos los pedidos pagos de una Tiendanube (o Nuvemshop) empiezan a llegar a Ruta como entregas. No hay claves que copiar: autorizás la app de Ruta en tu tienda y listo. Necesitás entrar al administrador de la tienda y al panel de Ruta como administrador de tu courier.

#Antes de empezar

#1. Conectá la tienda

El enlace de autorización vale cinco minutos y sirve una sola vez. Si tardaste más, Ruta te avisa que venció: tocá Conectar con Tiendanube de nuevo.

Al conectar, Ruta:

• guarda el permiso de la tienda cifrado (no se vuelve a mostrar, ni en el panel ni en la API);
• registra en Tiendanube tres avisos (webhooks): pedido creado, pedido pagado y pedido cancelado, para que los pedidos lleguen segundos después de pagarse, y uno más, app desinstalada, para enterarse si sacás la app;
• deja prendido Avisar a Tiendanube (ver abajo) si la tienda aceptó el permiso de envíos;
• hace la primera revisión de la tienda y, después, una cada 15 minutos por si algún aviso se pierde.

#2. Verificá que funciona

#Qué pedidos se importan

#Pago contra entrega

Tiendanube no distingue «efectivo al recibir» de una transferencia pendiente: los dos son pagos offline pendientes. Por eso, en Ajustes de la conexión → Pago contra entrega, elegís qué medios de pago offline se cobran al entregar, escritos como se llaman en Tiendanube → Configuración → Medios de pago (por ejemplo, «Efectivo al recibir»; no importan mayúsculas ni espacios de más).

• Un pedido abierto, con pago pendiente de uno de esos medios y envío a cargo de la tienda, entra como entrega sin esperar el pago, con el total del pedido como monto a cobrar en su moneda (pesos uruguayos o dólares; en otra moneda no se importa y figura con el motivo; si la conexión ya tiene un monto fijo, se usa ese).
• Los demás pagos pendientes siguen esperando a que los marques como pagados.
• Con la lista vacía (como viene), sólo entran los pedidos pagos.

Un pedido se importa una sola vez, aunque Tiendanube lo avise de nuevo. Si un pedido no se puede importar (por ejemplo, no tiene dirección de envío), Ruta importa los demás igual y la ejecución lo marca con INTEGRATION_PAYLOAD_INVALID.

Si tu sistema ya había creado la entrega por la API con el número de pedido como referencia externa (externalReference: 306 para el pedido #306), Ruta no crea otra: une el pedido a esa entrega.

#Qué datos se usan

#Avisar a la tienda

Como Shipday, Ruta le cuenta a Tiendanube cómo va cada entrega, así el comprador recibe el seguimiento por la propia tienda:

• Sólo se marcan las órdenes de envío a cargo de la tienda; si un pedido tiene otra parte enviada por una transportista, esa no se toca.
• Ruta lee primero cómo está la orden en Tiendanube y sólo cambia lo que falta: si ya está despachada, no la vuelve a despachar; un reintento no duplica nada.
• Si Tiendanube rechaza el cambio (por ejemplo, porque alguien marcó el envío a mano), la conexión pasa a Requiere revisión con INTEGRATION_STORE_UPDATE_REJECTED. La entrega sigue igual y los pedidos nuevos siguen llegando.
• Se apaga y se prende en Ajustes de la conexión → Avisar a Tiendanube. Viene prendido en las conexiones nuevas que aceptaron el permiso de envíos. Las conexiones hechas antes del 2026-10-22 sólo tienen permiso de lectura: tocá Volver a autorizar la tienda, aceptá el permiso nuevo y prendé la opción.

#Si cancelás un pedido que ya es una entrega

Cuando un pedido importado se cancela, o su pago se anula o reembolsa, Ruta se entera por el aviso «pedido cancelado» o en la revisión siguiente (cada 15 minutos):

Cada cancelación se aplica una sola vez. Si después reabrís el pedido, Ruta no reactiva la entrega: creá una nueva desde el panel.

#Varias tiendas, pausar y desconectar

• Varias tiendas: cada tienda es su propia conexión. Si dos tiendas tienen un pedido con el mismo número, son dos entregas distintas.
• Pausar: Pausar conexión en Ruta deja de traer pedidos sin tocar la tienda.
• Desconectar: en Tiendanube, andá a Mis aplicaciones y desinstalá Ruta. Ruta deja de poder leer la tienda al instante, borra el permiso guardado y la conexión pasa a Requiere revisión con el aviso «Se desinstaló la app de Ruta». Las entregas ya creadas siguen en tu historial.
• Volver a conectar: en la conexión, tocá Volver a conectar y aceptá el permiso otra vez. Es la misma conexión: no se duplican pedidos.

#Cómo llegan los avisos (para técnicos)

Tiendanube manda cada aviso a:

https://<tu-courier>/api/integrations/sources/<id-de-la-conexion>/webhooks/tiendanube

Los avisos de la app (app desinstalada y los tres de privacidad) van a una dirección fija de la app:

https://<tu-courier>/api/integrations/tiendanube/webhooks/{app-uninstalled|store-redact|customers-redact|customers-data-request}

El cuerpo de un aviso de pedido trae sólo store_id, event e id del pedido. Ruta lo acepta si la firma x-linkedstore-hmac-sha256 (HMAC-SHA256 en hexadecimal del cuerpo, con el secreto de la app de Ruta) es correcta, si la tienda es la de esa conexión y si el evento es order/created, order/paid u order/cancelled. Después vuelve a pedir el pedido a Tiendanube con el permiso de la tienda: un aviso falso no puede inventar una dirección.

#Privacidad: pedidos de datos de Tiendanube

Tiendanube puede pedirle a la app de Ruta que borre los datos de una tienda o de un cliente, o que informe qué datos tiene de un cliente. Ruta los recibe, los registra sólo con números de identificación (nunca el email, teléfono ni documento del cliente) y te deja un aviso en Últimas búsquedas de pedidos:

#Problemas frecuentes

¿Seguís con problemas? Mandale al soporte de tu courier la hora del pedido, su número y el código que muestra la conexión.