Four-channel inventory configuration

Shopify holds the source available quantity. Destinations can be TikTok Shop warehouses, Amazon merchant-fulfilled DEFAULT inventory, or published eBay Inventory API offers. Existing marketplace orders must feed Shopify through your order integration. This tool updates inventory; it does not import orders.

Allocation and warehouse mapping

Each mapping names one Shopify item and location. Mappings sharing a source must have explicit integer allocationPercent values totaling at most 100. Each target is floor(max(source minus buffer, 0) × allocationPercent / 100). Reserve additional stock for sales outside these mappings. The allocation is a publication cap, not a warehouse reservation or cross-platform transaction.

Complete JSON example

Use your authorized credentials. Omit unused marketplace connections and mappings. Amazon supports regions na, eu and fe; supply-source/FBA inventory is excluded. eBay supports existing published Inventory API offers; migrate legacy listings through eBay first.

{
  "shop": "your-store.myshopify.com",
  "shopifyToken": "YOUR_SHOPIFY_TOKEN",
  "shopifySecret": "YOUR_SHOPIFY_APP_SECRET",
  "appKey": "YOUR_TIKTOK_APP_KEY",
  "appSecret": "YOUR_TIKTOK_APP_SECRET",
  "accessToken": "YOUR_TIKTOK_ACCESS_TOKEN",
  "shopCipher": "YOUR_TIKTOK_SHOP_CIPHER",
  "amazon": {
    "clientId": "YOUR_LWA_CLIENT_ID",
    "clientSecret": "YOUR_LWA_CLIENT_SECRET",
    "refreshToken": "YOUR_LWA_REFRESH_TOKEN",
    "region": "na", "sellerId": "SELLERID", "marketplaceId": "ATVPDKIKX0DER"
  },
  "ebay": {
    "clientId": "YOUR_EBAY_CLIENT_ID",
    "clientSecret": "YOUR_EBAY_CLIENT_SECRET",
    "refreshToken": "YOUR_EBAY_REFRESH_TOKEN"
  },
  "mappings": [
    {"channel":"tiktok","sku":"SKU-1","inventoryItemId":"100","locationId":"200","productId":"300","skuId":"400","warehouseId":"500","buffer":5,"allocationPercent":30},
    {"channel":"amazon","sku":"SKU-1","inventoryItemId":"100","locationId":"200","buffer":5,"allocationPercent":30},
    {"channel":"ebay","sku":"SKU-1","inventoryItemId":"100","locationId":"200","offerId":"600","buffer":5,"allocationPercent":30}
  ]
}

Events and recovery

Signed Shopify inventory webhooks wake the worker immediately. A one-second worker scan catches pending work; a five-minute reconciliation catches missed notifications. These are internal scheduling intervals, not marketplace latency guarantees. Destination order imports must update Shopify for this event path to run. Large mapping sets and provider limits increase processing time.

Automatic increases are off until selected in the account form. The worker compares two fresh observations before writing. An unconfirmed provider write pauses synchronization. Amazon may acknowledge a change before its inventory read reflects it; inspect current quantities and resume after confirmation. Never enable a second competing inventory writer.

Access requirements

Shopify needs read_inventory and read_products access, TikTok needs authorized product/inventory access, Amazon needs an authorized Selling Partner application and inventory listing permissions, and eBay needs the sell.inventory OAuth scope. Developer/app approvals and seller authorizations remain marketplace requirements.