Skip to main content

​
Tiendanube Integration

Connect your Tiendanube store with ZenFlow to automatically import orders, sync inventory, and streamline your fulfillment operations.
This integration supports Tiendanube stores in Argentina, Brazil, Mexico, Colombia, and Chile.

​
Features

Order Import

Automatically import paid orders from Tiendanube

Status Updates

Update order and shipping status in your store

Inventory Sync

Real-time stock synchronization

Product Sync

Import and sync your product catalog

​
Setup Guide

​
Step 1: Connect Your Store

  1. Go to Settings > Integrations in ZenFlow
  2. Click Connect Tiendanube
  3. Enter your Tiendanube store URL (e.g., mystore.tiendanube.com)
  4. Log in and authorize ZenFlow

​
Step 2: Configure Import Settings

After connecting, set your preferences: 
Order Settings:
- Import orders: Paid orders only / All orders
- Default warehouse: [Select]
- Auto-assign picking flow: Yes/No

Product Settings:
- Sync products: Yes/No
- Match by: SKU / Barcode / Name
- Create missing products: Yes/No

Inventory Settings:
- Sync direction: ZenFlow -> Tiendanube / Bidirectional
- Sync frequency: Real-time / Every 15 min / Hourly

​
Step 3: Initial Sync

Click Sync Now to perform an initial synchronization:
  1. Import existing products
  2. Import pending orders
  3. Sync current inventory levels

​
Order Flow

​
API Reference

​
Get Store Connection

GET /api/v1/integrations/tiendanube/stores
Response: 
{
  "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"
      }
    ]
  }
}

​
Sync Orders

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

​
Sync Products

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

​
Update Inventory

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

​
Webhook Events

ZenFlow receives these events from Tiendanube:
EventDescription
order/createdNew order placed
order/paidOrder payment confirmed
order/fulfilledOrder marked as shipped
order/cancelledOrder cancelled
product/createdNew product added
product/updatedProduct details changed

​
Product Mapping

​
Automatic Matching

ZenFlow tries to match products automatically using:
  1. SKU (exact match)
  2. Barcode / EAN
  3. Product name (fuzzy match)

​
Manual Mapping

For products that can’t be matched automatically:
  1. Go to Integrations > Tiendanube > Product Mapping
  2. View unmatched products
  3. Select the corresponding ZenFlow product for each
{
  "mappings": [
    {
      "tiendanube_product_id": "12345",
      "tiendanube_variant_id": "67890",
      "zenflow_product_id": 100,
      "zenflow_sku": "PROD-001"
    }
  ]
}

​
Multi-variant Products

For products with variants (size, color, etc.):
  • Each variant maps to a separate ZenFlow product
  • Stock is tracked per variant
  • Orders include variant-specific details
Example mapping:
TiendanubeZenFlow
T-Shirt (S)TSHIRT-S
T-Shirt (M)TSHIRT-M
T-Shirt (L)TSHIRT-L

​
Troubleshooting

​
Orders Not Syncing

Check that Tiendanube webhooks are properly configured. Go to your Tiendanube admin panel > Apps > ZenFlow to verify the connection.
By default, only “paid” orders are imported. Adjust your settings if you need to import orders in other states.

​
Inventory Mismatch

Verify your sync direction setting. If set to “ZenFlow -> Tiendanube”, changes in Tiendanube won’t update ZenFlow.
Use the “Full Sync” option to reconcile all inventory levels.

​
Product Not Found

Ensure the product SKU in Tiendanube matches exactly with ZenFlow (case-sensitive).
Enable “Create missing products” to automatically add new products from Tiendanube.

​
Rate Limits

OperationLimit
API calls2 requests/second
Bulk operations100 items/request
ZenFlow handles rate limiting automatically with exponential backoff.

​
Support