Skip to main content

Integracion con Tiendanube

Conecta tu tienda Tiendanube con ZenFlow para importar pedidos automaticamente, sincronizar inventario y optimizar tus operaciones de fulfillment.
Esta integracion soporta tiendas Tiendanube en Argentina, Brasil, Mexico, Colombia y Chile.

Caracteristicas

Importar Pedidos

Importa automaticamente pedidos pagados de Tiendanube

Actualizar Estados

Actualiza el estado del pedido y envio en tu tienda

Sync Inventario

Sincronizacion de stock en tiempo real

Sync Productos

Importa y sincroniza tu catalogo de productos

Guia de Configuracion

Paso 1: Conectar tu Tienda

  1. Ve a Configuracion > Integraciones en ZenFlow
  2. Haz clic en Conectar Tiendanube
  3. Ingresa la URL de tu tienda Tiendanube (ej: mitienda.tiendanube.com)
  4. Inicia sesion y autoriza a ZenFlow

Paso 2: Configurar Importacion

Despues de conectar, establece tus preferencias:
Configuracion de Pedidos:
- Importar pedidos: Solo pagados / Todos los pedidos
- Almacen por defecto: [Seleccionar]
- Auto-asignar flujo de picking: Si/No

Configuracion de Productos:
- Sincronizar productos: Si/No
- Coincidir por: SKU / Codigo de barras / Nombre
- Crear productos faltantes: Si/No

Configuracion de Inventario:
- Direccion de sync: ZenFlow -> Tiendanube / Bidireccional
- Frecuencia de sync: Tiempo real / Cada 15 min / Cada hora

Paso 3: Sincronizacion Inicial

Haz clic en Sincronizar Ahora para realizar una sincronizacion inicial:
  1. Importar productos existentes
  2. Importar pedidos pendientes
  3. Sincronizar niveles de inventario actuales

Flujo de Pedidos

Referencia API

Obtener Conexion de Tienda

GET /api/v1/integrations/tiendanube/stores
Respuesta:
{
  "success": true,
  "data": {
    "stores": [
      {
        "id": "1234567",
        "name": "Mi Tienda",
        "url": "mitienda.tiendanube.com",
        "country": "AR",
        "connected_at": "2024-01-15T10:30:00Z",
        "status": "active",
        "last_sync": "2024-01-20T15:45:00Z"
      }
    ]
  }
}

Sincronizar Pedidos

POST /api/v1/integrations/tiendanube/sync/orders
Request:
{
  "store_id": "1234567",
  "date_from": "2024-01-01",
  "status": ["paid", "packed"]
}

Sincronizar Productos

POST /api/v1/integrations/tiendanube/sync/products
Request:
{
  "store_id": "1234567",
  "create_missing": true,
  "update_existing": true
}

Actualizar Inventario

POST /api/v1/integrations/tiendanube/inventory/update
Request:
{
  "store_id": "1234567",
  "products": [
    {
      "sku": "PROD-001",
      "stock": 100
    },
    {
      "sku": "PROD-002",
      "stock": 50
    }
  ]
}

Eventos Webhook

ZenFlow recibe estos eventos de Tiendanube:
EventoDescripcion
order/createdNuevo pedido creado
order/paidPago del pedido confirmado
order/fulfilledPedido marcado como enviado
order/cancelledPedido cancelado
product/createdNuevo producto agregado
product/updatedDetalles del producto cambiados

Mapeo de Productos

Coincidencia Automatica

ZenFlow intenta coincidir productos automaticamente usando:
  1. SKU (coincidencia exacta)
  2. Codigo de barras / EAN
  3. Nombre del producto (coincidencia difusa)

Mapeo Manual

Para productos que no pueden coincidir automaticamente:
  1. Ve a Integraciones > Tiendanube > Mapeo de Productos
  2. Ver productos sin coincidir
  3. Selecciona el producto ZenFlow correspondiente para cada uno
{
  "mappings": [
    {
      "tiendanube_product_id": "12345",
      "tiendanube_variant_id": "67890",
      "zenflow_product_id": 100,
      "zenflow_sku": "PROD-001"
    }
  ]
}

Productos Multi-variante

Para productos con variantes (talle, color, etc.):
  • Cada variante mapea a un producto ZenFlow separado
  • El stock se rastrea por variante
  • Los pedidos incluyen detalles especificos de variante
Ejemplo de mapeo:
TiendanubeZenFlow
Remera (S)REMERA-S
Remera (M)REMERA-M
Remera (L)REMERA-L

Solucion de Problemas

Pedidos No Se Sincronizan

Verifica que los webhooks de Tiendanube esten configurados correctamente. Ve a tu panel de admin de Tiendanube > Apps > ZenFlow para verificar la conexion.
Por defecto, solo se importan pedidos “pagados”. Ajusta tu configuracion si necesitas importar pedidos en otros estados.

Desajuste de Inventario

Verifica tu configuracion de direccion de sync. Si esta en “ZenFlow -> Tiendanube”, los cambios en Tiendanube no actualizaran ZenFlow.
Usa la opcion “Sync Completo” para reconciliar todos los niveles de inventario.

Producto No Encontrado

Asegurate de que el SKU del producto en Tiendanube coincida exactamente con ZenFlow (sensible a mayusculas/minusculas).
Habilita “Crear productos faltantes” para agregar automaticamente nuevos productos desde Tiendanube.

Limites de Tasa

OperacionLimite
Llamadas API2 requests/segundo
Operaciones bulk100 items/request
ZenFlow maneja los limites de tasa automaticamente con backoff exponencial.

Soporte