Shopify Integration

Connect your Shopify store with ZenFlow to automatically import orders, sync inventory, and streamline your fulfillment operations.

This integration supports Shopify stores from any country. Compatible with Shopify and Shopify Plus.

Features

Import Orders

Automatically import paid orders from Shopify

Update Status

Mark orders as fulfilled and send tracking info

Inventory Sync

Real-time stock synchronization to Shopify

Product Mapping

Link Shopify products with your ZenFlow catalog

Setup Guide

Step 1: Connect Your Store

Go to Settings > Integrations in ZenFlow
Click Connect Shopify
Enter your store domain (e.g., mystore.myshopify.com)
You’ll be redirected to Shopify to authorize the app
Accept the requested permissions

ZenFlow requests permissions to read/write orders, products, and inventory. These are necessary for bidirectional sync.

Step 2: Configure Sync Settings

After connecting, set your preferences:

Order Settings:
- Sync orders: Yes/No
- Import only paid: Yes/No
- Default warehouse: [Select]

Inventory Settings:
- Sync stock: Yes/No
- Direction: ZenFlow -> Shopify

Step 3: Map Products

Link your Shopify products with ZenFlow:

Go to Integrations > Shopify > Product Mapping
ZenFlow will attempt to auto-match by SKU
For unmatched products, manually select the ZenFlow product

Order Flow

API Reference

Start Authorization

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

Request:

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

Response:

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

Get Connection Status

GET /api/v1/integrations/shopify/status

Response:

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

Update Configuration

PUT /api/v1/integrations/shopify/config

Request:

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

Manually Sync Orders

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

Request:

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

Sync Stock to Shopify

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

Syncs all inventory levels for mapped products to Shopify.

List Product Mappings

GET /api/v1/integrations/shopify/mappings

Response:

{
  "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"
      }
    ]
  }
}

Create Product Mapping

POST /api/v1/integrations/shopify/mappings

Request:

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

Delete Mapping

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

Disconnect Store

DELETE /api/v1/integrations/shopify/disconnect

Webhook Events

ZenFlow automatically receives these webhooks from Shopify:

Topic	Description	ZenFlow Action
`orders/create`	New order created	Imports order if paid
`orders/paid`	Payment confirmed	Imports order for fulfillment
`orders/updated`	Order updated	Records changes
`orders/cancelled`	Order cancelled	Cancels order in ZenFlow
`orders/fulfilled`	Order fulfilled	Records fulfillment
`products/create`	Product created	Records for mapping
`products/update`	Product updated	Updates mapping info
`products/delete`	Product deleted	Removes mapping
`inventory_levels/update`	Stock updated	Records change (if bidirectional)
`app/uninstalled`	App uninstalled	Revokes credentials

Product Mapping

Automatic Matching

ZenFlow attempts to match products automatically using:

SKU (exact match)
Barcode (if configured in Shopify)

Manual Mapping

For products that don’t auto-match:

Go to Integrations > Shopify > Product Mapping
Filter by “Unmapped”
Select the corresponding ZenFlow product

Multi-Variant Products

Each Shopify variant maps to a separate product in ZenFlow:

Shopify	ZenFlow
Blue Shirt (S)	SHIRT-BLUE-S
Blue Shirt (M)	SHIRT-BLUE-M
Blue Shirt (L)	SHIRT-BLUE-L
Red Shirt (S)	SHIRT-RED-S

Status Mapping

Shopify Status	ZenFlow Status
`unfulfilled`	Ready to pick
`partial`	In progress
`fulfilled`	Shipped
`restocked`	Cancelled

Troubleshooting

Orders Not Importing

Check sync configuration

Make sure sync_orders is enabled in the configuration. Go to Integrations > Shopify > Settings.

Check order status

By default, only orders with paid status are imported. Verify the order has confirmed payment in Shopify.

Check webhooks

Webhooks are registered automatically. If there are issues, disconnect and reconnect the integration.

Stock Not Syncing

Check product mapping

The product must be properly mapped. Verify a mapping exists in Product Mapping.

Check sync flag

Each mapping has a sync_stock flag. Make sure it’s enabled for products you want to sync.

Check Shopify locations

ZenFlow syncs with the primary Shopify location. If you have multiple locations, verify which one is set as primary.

Authorization Error

Insufficient permissions

If authorization fails, verify you accepted all requested permissions. Try disconnecting and reconnecting.

Expired token

Shopify tokens are long-lived. If expired, disconnect and reconnect the integration.

Rate Limits

Operation	Limit
API calls	2 requests/second
Token bucket	40 tokens

ZenFlow handles rate limits automatically with exponential backoff and respects Shopify’s “leaky bucket” algorithm.

Required Scopes

The integration requests the following permissions:

read_orders, write_orders - Read and update orders
read_products, write_products - Read and update products
read_inventory, write_inventory - Manage stock levels
read_locations - Read inventory locations
read_fulfillments, write_fulfillments - Manage fulfillments

Support

Shopify API Documentation
Contact [email protected] for integration help

​Shopify Integration

​Features

Import Orders

Update Status

Inventory Sync

Product Mapping

​Setup Guide

​Step 1: Connect Your Store

​Step 2: Configure Sync Settings

​Step 3: Map Products

​Order Flow

​API Reference

​Start Authorization

​Get Connection Status

​Update Configuration

​Manually Sync Orders

​Sync Stock to Shopify

​List Product Mappings

​Create Product Mapping

​Delete Mapping

​Disconnect Store

​Webhook Events

​Product Mapping

​Automatic Matching

​Manual Mapping

​Multi-Variant Products

​Status Mapping

​Troubleshooting

​Orders Not Importing

​Stock Not Syncing

​Authorization Error

​Rate Limits

​Required Scopes

​Support

Shopify Integration

Features

Setup Guide

Step 1: Connect Your Store

Step 2: Configure Sync Settings

Step 3: Map Products

Order Flow

API Reference

Start Authorization

Get Connection Status

Update Configuration

Manually Sync Orders

Sync Stock to Shopify

List Product Mappings

Create Product Mapping

Delete Mapping

Disconnect Store

Webhook Events

Product Mapping

Automatic Matching

Manual Mapping

Multi-Variant Products

Status Mapping

Troubleshooting

Orders Not Importing

Stock Not Syncing

Authorization Error

Rate Limits

Required Scopes

Support