WMS 顯示倉庫有 100 件，不代表 Shopify 應顯示可賣 100 件。已承諾訂單、揀貨、草稿保留、安全庫存、瑕疵、調撥與待入庫都會改變 available-to-sell。同步若只傳單一數字，系統延遲時容易超賣或錯誤歸零。
先定義庫存狀態和 owner，再選 adjustment、set 或 full snapshot 的更新方式。
建立 SKU 與 location mapping
每個 Shopify inventory item/variant 對應 WMS item ID、SKU、barcode 和單位；每個 Shopify location 對應實體倉、門市、3PL 或虛擬節點。Mapping 有生效日、停用和唯一性檢查。
重複 SKU、bundle、kit、預購和非庫存服務需個別規則。找不到 mapping 的更新進隔離隊列，不能套到相似 SKU。
定義可售量公式
常見為 on_hand 減 committed、reserved、safety stock 和 unavailable，再加上允許承諾的特定 incoming。公式依倉、品類、market 和履約 SLA 可能不同，但必須版本化且可解釋。
Shopify InventoryQuantity 支援 available、committed、reserved、incoming 等狀態概念，實際寫入和 owner 依當期 API 與 fulfillment service 設計確認。
決定寫入 authority
若 WMS 是 physical inventory 主系統，Shopify order 先保留/commit，WMS 回寫履約與調整。不要讓 ERP、WMS、3PL 和人工同時 set 同一 location available。緊急人工改動需有過期與回寫流程。
Cycle count 和 warehouse adjustment 從 WMS 來；Shopify cancel/return 是否立即釋放，取決於商品是否實際回庫和檢驗。
使用版本和冪等
每個 update 帶 source event ID、SKU/location、quantity、occurred_at、version 和 reason。重試同一事件不重複加減，舊 version 不覆蓋新值。Adjustment 和 absolute set 不可無序混用。
API timeout 後先查狀態或使用 idempotent mutation，不直接再加一次。Batch partial success 逐 item 保存結果。
處理延遲與超賣
量測 WMS event 到 Shopify visible 的 p50/p95/p99 latency。Flash sale 期間縮短同步、降低 safety stock 或暫停高風險 SKU。超賣時定義取消、替代、延後和客服 owner，不能讓系統靜默負庫存。
庫存歸零與異常跳動設告警，但不要每筆小變化通知。按銷售速度和剩餘 cover 排 severity。
Bundle 和組合另外計算
Bundle 可售量由 component 最小可組數決定，component 被其他商品共用時每次變動都需重算。預組 kit 則可能是獨立庫存。拆單、換品和退貨需要反向規則。
不要只在 storefront 顯示 bundle 有貨，checkout 後才由 WMS 拒單。計算結果同步到真正可承諾位置。
全量對帳補增量漏失
Webhook/queue 提供即時增量，定時 snapshot 逐 SKU/location 比較 Shopify 和 WMS。差異標 missing event、stale mapping、manual override、in-flight order 和 true mismatch。設定 tolerance 與 cutoff time。
對帳修正寫明 reason，避免 full sync 和增量互相追趕。API 可靠性模式可參考 同步失敗補救。
上線先影子比對
先讀取 WMS 計算但不寫 Shopify，和現行庫存比較；再單一倉/品類啟用，最後擴大。測 order、cancel、refund、fulfillment、return、transfer、cycle count、WMS outage 和 retry。
Runbook 包含 freeze、manual available、queue pause、replay 和 rollback。WMS 同步成功的標準，是每個可售數字都能追到來源和版本，延遲或故障時也有控制超賣的手段。