ERP 整合最常見的失敗，是雙方都能修改同一欄位，出錯後不知道哪邊才是正確答案。Shopify、ERP、PIM、WMS、CRM 和 payment 各自擅長不同資料，規劃要從 ownership 和商業流程開始，不從 API endpoint 清單開始。
先畫 current state 和 target state，再逐個資料物件決定方向。
定義主資料和 owner
Product、SKU、cost、price、inventory、customer、company、order、payment、tax、fulfillment、refund 和 invoice 各列 source of truth、可修改角色、下游與衝突規則。例如 PIM 管規格、ERP 管成本與財務、WMS 管實體庫存、Shopify 管 storefront order。
同一欄位若需雙向，寫清楚 timestamp、version 或人工核准，避免 last-write-wins 默默覆蓋。
以商業事件設計資料流
列 product approved、price effective、inventory changed、order created/paid/cancelled、fulfillment、return、refund 和 customer updated。每個事件定義 payload、頻率、volume、SLA、ordering、idempotency 和 fallback。
Webhook 適合通知，定期 reconciliation 用來補漏；bulk/排程適合大量主資料。不要期待 webhook 永遠按順序且不遺失。
訂單建立保持冪等
Shopify order 到 ERP 使用固定 external ID/idempotency key。Retry、worker 重啟和 webhook duplicate 不能建立第二張 ERP 訂單。保存 Shopify order ID、ERP order ID、payload version 和處理狀態。
付款 pending、authorized、paid、partially paid、cancelled 和 refunded 映射清楚，不能每個狀態都當新訂單。
價格與稅有生效時間
ERP price list、market currency、B2B catalog、discount 和 tax 的 owner 分開。同步包含有效起訖、currency、customer/company、quantity break 和 rounding。錯價時決定停止銷售、回退前版或人工處理。
發票和財務不能從 storefront 顯示價格重新計算，需以核准訂單與稅務資料為準。
庫存使用可售量
ERP/WMS 的 on hand、available、committed、reserved、incoming 和 safety stock 不同。定義送到 Shopify 的 available-to-sell，按 location、SKU 和時間處理。Order reservation、cancel、return 和 fulfillment 都會改數量。
全量 snapshot 和增量 adjustment 要能對帳，不能同時無版本地寫入。庫存細節可參考 Shopify WMS 同步。
可靠性靠 queue 與狀態機
接收事件後快速 acknowledgment，放入 durable queue。Worker 驗證 schema、執行、retry transient error，permanent error 進 dead letter/人工隊列。每筆狀態 visible，營運能看失敗原因和安全重送。
Rate limit、timeout、partial success 和 provider outage 都有 backoff。可靠性模式可沿用 Shopify API 同步失敗。
定期 reconciliation
每小時/每日比較 order、inventory、fulfillment、refund 和 price，使用 updated_at watermark 加 overlap。Count 只能找大問題，重要資料需逐 ID/value 比較。差異分類 missing、duplicate、stale、conflict 和 expected lag。
人工修正寫回 owner system 並留下 audit，不直接在兩邊各改一半。
安全與權限
App/API 使用最小 scopes、token vault、rotation、IP/network control 和 audit log。Customer/order PII 只在必要流程傳送，log 和 dead letter 遮蔽，保存期限符合政策。
Sandbox 使用去識別或測試資料。供應商 remote access 有期限和 owner。
上線採分階段
先 read-only/影子比對，再單一資料流、market 或 warehouse，最後擴大。Runbook 包含監控、manual order、inventory freeze、rollback 和聯絡人。Cutover 期間明確哪個系統接受寫入。
ERP 整合完成的證據，是每個關鍵物件都有 owner、唯一鍵、重試、對帳和人工退路，發生延遲或失敗時訂單仍不會消失或重複。