第三方仓发货后 Shopify 订单还停在未发货怎么查

现象#

3PL 后台显示已出库并给出 UPS 单号，Shopify 订单页仍是 Unfulfilled，没有 tracking，客户也没收到发货邮件。

原因#

• 3PL 只更新自己系统，没有回调 fulfillmentCreate 把结果写回 Shopify
• 履约服务只实现了 fulfillment_request 接收端，没做发货完成回传
• 回传时用了错误的 fulfillmentOrderId，请求被拒但对方没读 userErrors
• 应用缺少 write_fulfillments 权限，或履约单已关闭导致写回失败

处理步骤#

1. 在订单里看 FulfillmentOrder.status 与 requestStatus，确认请求已被 accept
2. 让 3PL 用 fulfillmentCreate 按 lineItemsByFulfillmentOrder 逐单回传
3. 回传体必须带 trackingInfo.number、company 和 notifyCustomer
4. 在对方日志里检查 userErrors，常见是数量超过 remainingQuantity
5. 只缺单号时用 fulfillmentTrackingInfoUpdate 补写，避免重复创建 fulfillment

验收标准#

订单页显示 Fulfilled 与 UPS 单号，客户收到发货邮件，fulfillments 里只有一条记录。