> ## 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.

# Cómo se sincronizan Gudink y Tiendanube

> Gudink y tu Tiendanube están siempre en sincronización.

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ándo                            | Qué pasa                                                                                                                                   |
| --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| **Cuando hacés login**            | Al 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 tienda**   | Despué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 background**   | Aunque 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](/integracion-tn/reconectar-tienda-nube).

## ¿Por qué esta arquitectura?

Webhooks son rápidos (segundos) pero pueden fallar por causas ajenas a Gudink: TN puede tener un bache de red, una actualización nuestra 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.