Skip to main content

Integración con TiendaNube

TiendaNube — pasos para crear, configurar e instalar la integración con TiendaNube. ↓ mercadolibre · ⬆ intro de la sección

Esta guía documenta los pasos para crear, configurar e instalar la integración con TiendaNube en el sistema centralizado de identidades y administración.

1. Creación de la Aplicación en TiendaNube​

Para comunicarte con la API de TiendaNube a través del modelo global OAuth, primero debes registrar una aplicación como Developer (Partner) en TiendaNube.

  1. Accede al TiendaNube Partners Portal.
  2. Ve a la sección de Aplicaciones y selecciona Crear aplicación.
  3. Completa los detalles con el nombre comercial de la integración, logo y descripciones.
  4. URIs de Autenticación y Redirección:
    • Defina las URL correctas donde TiendaNube tiene que redirigir después de que un usuario acepte la instalación.
    • Ejemplo de Redirect URI: https://tu-dominio.com/api/admin/tiendanube/oauth/callback (o tu entorno local).
  5. Permisos y Scopes:
    • Configura qué eventos de webhook y accesos requieres (ej. lectura y escritura en products, orders, customers, etc.).
  6. Al finalizar la creación, el panel de Partners te entregará dos credenciales claves:
    • Client ID (App ID)
    • Client Secret

2. Configuración de Variables de Entorno​

Una vez que la aplicación está registrada y posees las credenciales globales, debes proveerlas al sistema. user-service es el encargado de leerlas en tiempo real para negociar las confirmaciones con TiendaNube y asignar los tokens resultantes al usuario.

Configura las siguientes variables en tu archivo .env:

TIENDANUBE_CLIENT_ID="TU_CLIENT_ID_APP_TIENDANUBE"
TIENDANUBE_CLIENT_SECRET="TU_CLIENT_SECRET"
TIENDANUBE_REDIRECT_URI="https://tu-dominio.com/api/admin/tiendanube/oauth/callback"

Nota importante: En TiendaNube el prefijo utilizado por la plataforma es habitualmente TIENDANUBE_ en lugar de GLOBAL_MERCADOLIBRE_. Revisa tu service.py en user-service para verificar el nombrado exacto.

3. Instalación de la App y Flujo Visual del Cliente​

A diferencia de otros OAuths simples, la integración con TiendaNube se asume a un nivel más profundo como una "Instalación de App" dentro del panel o ecosistema de su propia tienda.

El proceso paso a paso:​

  1. El cliente / usuario navega al Portal Administrativo de la plataforma, específicamente a la pestaña Integración de TiendaNube.
  2. Al no tener la cuenta todavía conectada ("Sin Conexión Activa"), el usuario pulsará el botón "Conectar Cuenta".
  3. El portal enviará al cliente hacia los servidores de TiendaNube mediante una ventana nueva o redirección (con el parámetro del Client ID).
  4. Instalación de Aplicación: El usuario, en el entorno visual de TiendaNube (debiendo iniciar sesión como propietario de una tienda), verá un resumen indicando (Nuestra App) quiere acceder a la información de tu comercio.
  5. Cuando el propietario hace clic en Instalar Aplicación, TiendaNube envía de vuelta al cliente hacia el Redirect URI que declaraste.
  6. El callback intercepta el evento y realiza una petición final en el backend intercambiando el code por un único access_token estable (y un identificador de tienda user_id de TiendaNube).
  7. Este Tienda ID y Access Token se vinculan a la jerarquía de subsistemas de la cuenta principal del cliente en nuestro sistema.
  8. Automáticamente, la interfaz se refresca reportando un estado de "CONECTADO", confirmando un Scope Autorizado correcto, marcando el Access Token como "DISPONIBLE" y mostrando su Tienda ID interno.

(Es importante educar al cliente final de que NO se le pedirán contraseñas crudas y que el proceso es una vinculación oficial cifrada a través de una App de integración instalada).