Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://ayuda.gudink.com/llms.txt

Use this file to discover all available pages before exploring further.

Categoría: Integración Tiendanube Última actualización: 2026-04-26 Gudink y tu Tiendanube están siempre en sincronización. No tenés que hacer nada para que los pedidos aparezcan — esta guía explica cómo funciona por abajo, para que sepas qué esperar y cuándo algo no está andando como debería.

Cómo llegan los pedidos a Gudink

Tiendanube nos avisa en tiempo real cada vez que pasa algo relevante en tu tienda (un nuevo pedido, un pago, un cambio de dirección, etc.) a través de un sistema llamado webhooks. En la práctica, un pedido que entra en Tiendanube aparece en tu /pedidos de Gudink en pocos segundos. Si tenés conectada la tienda y no ves un pedido que sabés que entró, no entres en pánico: Gudink tiene varias capas de seguridad para recuperar esos casos raros donde un aviso se pierde.

Cuándo Gudink se sincroniza con Tiendanube

Además del flujo en tiempo real, Gudink corre una reconciliación (un pull explícito desde TN) en cuatro momentos:
CuándoQué pasa
Cuando hacés loginAl iniciar sesión, Gudink chequea que tu tienda siga conectada y trae los pedidos recientes que pudieran haberse perdido
Cuando clickeás “Sincronizar”En /tiendas/tiendanube, el botón Sincronizar hace un pull completo de productos + pedidos desde Tiendanube
Apenas reconectás tu tiendaDespués de aceptar los permisos en TN, Gudink dispara una reconciliación automática (cubre todo lo que pasó mientras estabas desconectado)
Cada 3 horas, en backgroundAunque no uses Gudink, corremos la reconciliación automáticamente — nada se queda atrás más que un par de horas
La ventana por defecto de la reconciliación es de últimos 30 días. Eso cubre el 99.9% de los casos reales.

Cuándo clickear Sincronizar manualmente

Si notás algo raro, el botón Sincronizar en /tiendas/tiendanube es lo primero a probar:
  • “Vendí algo hace 10 minutos y no lo veo en Gudink”
  • “Aparece menos pedidos de los que vendí esta semana”
  • “Acabo de cambiar un producto en TN y quiero que Gudink lo vea ahora”
El botón hace el pull en unos segundos y te muestra un toast con cuántos pedidos recuperó.

Señales de que la sincronización está bien

Entrá a /tiendas/tiendanube y fijate: Pill verde “Conectada” arriba a la derecha → el token sigue vigente, los webhooks están suscritos ✅ “Última sincronización: hace X min” → los eventos están fluyendo desde TN (cada vez que llega un webhook, este timestamp se actualiza) ✅ Métricas que cuadran con lo que ves en TN (productos publicados + pedidos) Si la última sincronización dice “hace varias horas” o “hace días” y sabés que hubo actividad en TN en ese período, algo no está andando — clickeá Sincronizar y, si no se resuelve, ver Requiere reconexión.

¿Por qué esta arquitectura?

Webhooks son rápidos (segundos) pero pueden fallar por causas ajenas a Gudink: TN puede tener un bache de red, un deploy nuestro puede coincidir con un aviso, etc. La reconciliación periódica nos da un colchón para recuperar esos casos sin que el seller tenga que notarlos. Pagás el costo de un pull cada 3h a cambio de no perder nunca un pedido — nos parece un buen trato.

Qué pasa si pruebo Sincronizar y sigue faltando un pedido

  • Si el pedido es de hace menos de 30 días: probablemente es un bug — escalá a soporte con el número de pedido en TN.
  • Si es de hace más de 30 días: la ventana automática no cubre tan atrás. Soporte puede hacer un pull manual más profundo.