Integracion con Shopify

Conecta tu tienda Shopify con ZenFlow para importar pedidos automaticamente, sincronizar inventario y optimizar tus operaciones de fulfillment.

Esta integracion soporta tiendas Shopify de cualquier pais. Compatible con Shopify y Shopify Plus.

Caracteristicas

Importar Pedidos

Importa automaticamente pedidos pagados de Shopify

Actualizar Estados

Marca pedidos como fulfillados y envia info de tracking

Sync Inventario

Sincronizacion de stock en tiempo real hacia Shopify

Mapeo de Productos

Vincula productos de Shopify con tu catalogo en ZenFlow

Guia de Configuracion

Paso 1: Conectar tu Tienda

Ve a Configuracion > Integraciones en ZenFlow
Haz clic en Conectar Shopify
Ingresa el dominio de tu tienda (ej: mitienda.myshopify.com)
Seras redirigido a Shopify para autorizar la aplicacion
Acepta los permisos solicitados

ZenFlow solicita permisos para leer/escribir pedidos, productos e inventario. Estos son necesarios para la sincronizacion bidireccional.

Paso 2: Configurar Sincronizacion

Despues de conectar, establece tus preferencias:

Configuracion de Pedidos:
- Sincronizar pedidos: Si/No
- Importar solo pagados: Si/No
- Almacen por defecto: [Seleccionar]

Configuracion de Inventario:
- Sincronizar stock: Si/No
- Direccion: ZenFlow -> Shopify

Paso 3: Mapear Productos

Vincula tus productos de Shopify con ZenFlow:

Ve a Integraciones > Shopify > Mapeo de Productos
ZenFlow intentara coincidir automaticamente por SKU
Para productos no coincidentes, selecciona el producto ZenFlow manualmente

Flujo de Pedidos

Referencia API

Iniciar Autorizacion

POST /api/v1/integrations/shopify/auth/start

Request:

{
  "shop_domain": "mitienda.myshopify.com",
  "warehouse_id": 1
}

Respuesta:

{
  "success": true,
  "data": {
    "authorization_url": "https://mitienda.myshopify.com/admin/oauth/authorize?..."
  }
}

Obtener Estado de Conexion

GET /api/v1/integrations/shopify/status

Respuesta:

{
  "success": true,
  "data": {
    "connected": true,
    "shop_domain": "mitienda.myshopify.com",
    "shop_name": "Mi Tienda",
    "status": "active",
    "sync_orders": true,
    "sync_stock": true,
    "last_sync_at": "2024-01-20T15:45:00Z"
  }
}

Actualizar Configuracion

PUT /api/v1/integrations/shopify/config

Request:

{
  "sync_orders": true,
  "sync_stock": true
}

Sincronizar Pedidos Manualmente

POST /api/v1/integrations/shopify/sync/orders

Request:

{
  "date_from": "2024-01-01",
  "date_to": "2024-01-31"
}

Sincronizar Stock a Shopify

POST /api/v1/integrations/shopify/sync/stock

Sincroniza todos los niveles de inventario de productos mapeados hacia Shopify.

Listar Mapeos de Productos

GET /api/v1/integrations/shopify/mappings

Respuesta:

{
  "success": true,
  "data": {
    "mappings": [
      {
        "id": 1,
        "product_id": 100,
        "product_sku": "PROD-001",
        "shopify_product_id": "7654321098765",
        "shopify_variant_id": "43210987654321",
        "shopify_sku": "PROD-001",
        "sync_stock": true,
        "last_stock_sync": "2024-01-20T15:45:00Z"
      }
    ]
  }
}

Crear Mapeo de Producto

POST /api/v1/integrations/shopify/mappings

Request:

{
  "product_id": 100,
  "shopify_product_id": "7654321098765",
  "shopify_variant_id": "43210987654321",
  "sync_stock": true
}

Eliminar Mapeo

DELETE /api/v1/integrations/shopify/mappings/:id

Desconectar Tienda

DELETE /api/v1/integrations/shopify/disconnect

Eventos Webhook

ZenFlow recibe estos webhooks de Shopify automaticamente:

Topic	Descripcion	Accion en ZenFlow
`orders/create`	Nuevo pedido creado	Importa el pedido si esta pagado
`orders/paid`	Pago confirmado	Importa el pedido para fulfillment
`orders/updated`	Pedido actualizado	Registra cambios
`orders/cancelled`	Pedido cancelado	Cancela el pedido en ZenFlow
`orders/fulfilled`	Pedido fulfillado	Registra el fulfillment
`products/create`	Producto creado	Registra para mapeo
`products/update`	Producto actualizado	Actualiza info de mapeo
`products/delete`	Producto eliminado	Elimina mapeo
`inventory_levels/update`	Stock actualizado	Registra cambio (si bidireccional)
`app/uninstalled`	App desinstalada	Revoca credenciales

Mapeo de Productos

Coincidencia Automatica

ZenFlow intenta coincidir productos automaticamente usando:

SKU (coincidencia exacta)
Codigo de barras (si esta configurado en Shopify)

Mapeo Manual

Para productos que no coinciden automaticamente:

Ve a Integraciones > Shopify > Mapeo de Productos
Filtra por “Sin mapear”
Selecciona el producto ZenFlow correspondiente

Productos con Variantes

Cada variante de Shopify se mapea a un producto separado en ZenFlow:

Shopify	ZenFlow
Remera Azul (S)	REMERA-AZUL-S
Remera Azul (M)	REMERA-AZUL-M
Remera Azul (L)	REMERA-AZUL-L
Remera Roja (S)	REMERA-ROJA-S

Mapeo de Estados

Estado Shopify	Estado ZenFlow
`unfulfilled`	Listo para preparar
`partial`	En progreso
`fulfilled`	Enviado
`restocked`	Cancelado

Solucion de Problemas

Pedidos No Se Importan

Verificar configuracion de sync

Asegurate de que sync_orders este habilitado en la configuracion. Ve a Integraciones > Shopify > Configuracion.

Verificar estado del pedido

Por defecto, solo se importan pedidos con estado paid. Verifica que el pedido tenga el pago confirmado en Shopify.

Verificar webhooks

Los webhooks se registran automaticamente. Si hay problemas, desconecta y vuelve a conectar la integracion.

Stock No Se Sincroniza

Verificar mapeo de producto

El producto debe estar mapeado correctamente. Verifica que exista un mapeo en Mapeo de Productos.

Verificar flag de sync

Cada mapeo tiene un flag sync_stock. Asegurate de que este habilitado para los productos que quieres sincronizar.

Verificar ubicaciones en Shopify

ZenFlow sincroniza con la ubicacion principal de Shopify. Si tienes multiples ubicaciones, verifica cual esta configurada como principal.

Error de Autorizacion

Permisos insuficientes

Si la autorizacion falla, verifica que hayas aceptado todos los permisos solicitados. Intenta desconectar y volver a conectar.

Token expirado

Los tokens de Shopify son de larga duracion. Si expira, desconecta y reconecta la integracion.

Limites de Tasa

Operacion	Limite
Llamadas API	2 requests/segundo
Bucket de tokens	40 tokens

ZenFlow maneja los limites de tasa automaticamente con backoff exponencial y respeta el algoritmo de “leaky bucket” de Shopify.

Scopes Requeridos

La integracion solicita los siguientes permisos:

read_orders, write_orders - Leer y actualizar pedidos
read_products, write_products - Leer y actualizar productos
read_inventory, write_inventory - Gestionar niveles de stock
read_locations - Leer ubicaciones de inventario
read_fulfillments, write_fulfillments - Gestionar fulfillments

Soporte

Documentacion de Shopify API
Contacta a [email protected] para ayuda con la integracion

​Integracion con Shopify

​Caracteristicas

Importar Pedidos

Actualizar Estados

Sync Inventario

Mapeo de Productos

​Guia de Configuracion

​Paso 1: Conectar tu Tienda

​Paso 2: Configurar Sincronizacion

​Paso 3: Mapear Productos

​Flujo de Pedidos

​Referencia API

​Iniciar Autorizacion

​Obtener Estado de Conexion

​Actualizar Configuracion

​Sincronizar Pedidos Manualmente

​Sincronizar Stock a Shopify

​Listar Mapeos de Productos

​Crear Mapeo de Producto

​Eliminar Mapeo

​Desconectar Tienda

​Eventos Webhook

​Mapeo de Productos

​Coincidencia Automatica

​Mapeo Manual

​Productos con Variantes

​Mapeo de Estados

​Solucion de Problemas

​Pedidos No Se Importan

​Stock No Se Sincroniza

​Error de Autorizacion

​Limites de Tasa

​Scopes Requeridos

​Soporte

Integracion con Shopify

Caracteristicas

Guia de Configuracion

Paso 1: Conectar tu Tienda

Paso 2: Configurar Sincronizacion

Paso 3: Mapear Productos

Flujo de Pedidos

Referencia API

Iniciar Autorizacion

Obtener Estado de Conexion

Actualizar Configuracion

Sincronizar Pedidos Manualmente

Sincronizar Stock a Shopify

Listar Mapeos de Productos

Crear Mapeo de Producto

Eliminar Mapeo

Desconectar Tienda

Eventos Webhook

Mapeo de Productos

Coincidencia Automatica

Mapeo Manual

Productos con Variantes

Mapeo de Estados

Solucion de Problemas

Pedidos No Se Importan

Stock No Se Sincroniza

Error de Autorizacion

Limites de Tasa

Scopes Requeridos

Soporte