Skip to main content

​
Integracion con WooCommerce

Conecta tu tienda WooCommerce con ZenFlow para importar pedidos automaticamente, sincronizar inventario y optimizar tus operaciones de fulfillment.
Esta integracion soporta WooCommerce 3.5+ con WordPress. Compatible con productos simples y variables.

​
Caracteristicas

Importar Pedidos

Importa automaticamente pedidos en procesamiento

Actualizar Estados

Sincroniza estados de pedidos bidirecccionalmente

Sync Inventario

Sincronizacion de stock en tiempo real hacia WooCommerce

Productos Variables

Soporte completo para productos con variaciones

​
Guia de Configuracion

​
Paso 1: Generar Credenciales API en WooCommerce

  1. En tu panel de WordPress, ve a WooCommerce > Ajustes > Avanzado > REST API
  2. Haz clic en Agregar clave
  3. Configura:
    • Descripcion: ZenFlow Integration
    • Usuario: Selecciona un administrador
    • Permisos: Lectura/Escritura
  4. Haz clic en Generar clave API
  5. Guarda la Consumer Key y Consumer Secret (no se mostraran nuevamente)
Asegurate de copiar las credenciales inmediatamente. WooCommerce solo las muestra una vez.

​
Paso 2: Conectar en ZenFlow

  1. Ve a Configuracion > Integraciones en ZenFlow
  2. Haz clic en Conectar WooCommerce
  3. Ingresa:
    • URL de tu tienda (ej: https://mitienda.com)
    • Consumer Key
    • Consumer Secret
  4. Haz clic en Conectar

​
Paso 3: Configurar Sincronizacion

Despues de conectar, establece tus preferencias: 
Configuracion de Pedidos:
- Sincronizar pedidos: Si/No
- Estados a importar: Processing
- Almacen por defecto: [Seleccionar]

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

​
Flujo de Pedidos

​
Referencia API

​
Conectar Tienda

POST /api/v1/integrations/woocommerce/connect
Request: 
{
  "store_url": "https://mitienda.com",
  "consumer_key": "ck_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "consumer_secret": "cs_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "warehouse_id": 1
}
Respuesta: 
{
  "success": true,
  "data": {
    "id": "cred_abc123",
    "store_url": "https://mitienda.com",
    "store_name": "Mi Tienda",
    "status": "active",
    "connected_at": "2024-01-15T10:30:00Z"
  }
}

​
Obtener Estado de Conexion

GET /api/v1/integrations/woocommerce/status
Respuesta: 
{
  "success": true,
  "data": {
    "connected": true,
    "store_url": "https://mitienda.com",
    "store_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/woocommerce/config
Request: 
{
  "sync_orders": true,
  "sync_stock": true
}

​
Sincronizar Pedidos Manualmente

POST /api/v1/integrations/woocommerce/sync/orders
Request: 
{
  "date_from": "2024-01-01",
  "date_to": "2024-01-31"
}

​
Sincronizar Stock a WooCommerce

POST /api/v1/integrations/woocommerce/sync/stock
Sincroniza todos los niveles de inventario de productos mapeados hacia WooCommerce.

​
Listar Mapeos de Productos

GET /api/v1/integrations/woocommerce/mappings
Respuesta: 
{
  "success": true,
  "data": {
    "mappings": [
      {
        "id": "map_abc123",
        "product_id": 100,
        "product_sku": "PROD-001",
        "wc_product_id": 456,
        "wc_variation_id": null,
        "wc_sku": "PROD-001",
        "sync_stock": true,
        "last_stock_sync": "2024-01-20T15:45:00Z"
      }
    ]
  }
}

​
Crear Mapeo de Producto

POST /api/v1/integrations/woocommerce/mappings
Request: 
{
  "product_id": 100,
  "wc_product_id": 456,
  "wc_variation_id": null,
  "sync_stock": true
}

​
Eliminar Mapeo

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

​
Desconectar Tienda

POST /api/v1/integrations/woocommerce/disconnect

​
Eventos Webhook

ZenFlow recibe estos webhooks de WooCommerce automaticamente:
TopicDescripcionAccion en ZenFlow
order.createdNuevo pedido creadoImporta si esta en “processing”
order.updatedPedido actualizadoActualiza estado en ZenFlow
order.deletedPedido eliminadoMarca como cancelado
Los webhooks se registran automaticamente en WooCommerce cuando conectas tu tienda.

​
Mapeo de Productos

​
Coincidencia Automatica

Cuando se importa un pedido, ZenFlow intenta coincidir productos automaticamente:
  1. Busca mapeo existente por wc_product_id + wc_variation_id
  2. Si no existe, busca por SKU en el catalogo de ZenFlow
  3. Si encuentra por SKU, crea el mapeo automaticamente

​
Mapeo Manual

Para productos que no coinciden automaticamente:
  1. Ve a Integraciones > WooCommerce > Mapeo de Productos
  2. Filtra por “Sin mapear”
  3. Selecciona el producto ZenFlow correspondiente

​
Productos Variables

Cada variacion de WooCommerce se mapea a un producto separado en ZenFlow:
WooCommerceZenFlow
Remera (Talle: S, Color: Azul)REMERA-S-AZUL
Remera (Talle: M, Color: Azul)REMERA-M-AZUL
Remera (Talle: L, Color: Azul)REMERA-L-AZUL

​
Mapeo de Estados

Estado WooCommerceEstado ZenFlow
pendingPendiente
processingListo para preparar
on-holdPendiente
completedCompletado
cancelledCancelado
refundedCancelado
failedCancelado

​
Solucion de Problemas

​
No Puedo Conectar

Asegurate de usar la URL correcta incluyendo https://. La URL debe ser accesible publicamente.
Las Consumer Key y Secret deben tener permisos de Lectura/Escritura. Genera nuevas credenciales si es necesario.
WooCommerce requiere HTTPS para la API REST. Asegurate de que tu sitio tenga un certificado SSL valido.

​
Pedidos No Se Importan

Por defecto, solo se importan pedidos en estado “Processing”. Los pedidos en “Pending” o “On-hold” no se importan automaticamente.
Ve a WooCommerce > Ajustes > Avanzado > Webhooks y verifica que los webhooks de ZenFlow esten activos.
Asegurate de que sync_orders este habilitado en la configuracion de la integracion.

​
Stock No Se Sincroniza

El producto debe estar mapeado correctamente. Verifica que exista un mapeo en Mapeo de Productos.
Cada mapeo tiene un flag sync_stock. Asegurate de que este habilitado.
En WooCommerce, el producto debe tener habilitada la opcion “Gestionar stock” para que ZenFlow pueda actualizar las cantidades.

​
Limites de Tasa

OperacionLimite
Llamadas API5 requests/segundo
Timeout30 segundos
ZenFlow maneja los limites de tasa automaticamente con reintentos y backoff exponencial.

​
Requisitos

  • WooCommerce 3.5 o superior
  • WordPress 5.0 o superior
  • HTTPS habilitado (certificado SSL)
  • API REST de WooCommerce habilitada
  • Permalinks configurados (no usar “Simple”)

​
Soporte