Shopify Admin API

部分履约后再次发货报 unfulfillable 怎么办

现象#

订单有三件商品,先发一件后订单仍显示 Unfulfilled,第二次发货又报 unfulfillable,后台只有一条发货记录。

原因#

  • 部分履约要把数量写进 fulfillmentOrderLineItems.quantity,省略即被视为全发
  • 一次请求里混入两个 fulfillment order,跨 location 会让整单失败
  • 剩余数量归零后履约单自动关闭,再调用就是 closed 状态
  • notifyCustomer 默认不通知,商家以为货没发出去而重复操作

处理步骤#

  1. 先查每条 fulfillmentOrderLineItems { id remainingQuantity } 的剩余可发数量
  2. 本次只提交需要发的行与数量,未发的行不要出现在请求里
  3. 每个 location 单独一次 fulfillmentCreateV2,不要跨仓合并
  4. 拆成多个包裹时用 trackingInfo 区分,一个包裹对应一条 fulfillment
  5. 发完查 order.displayFulfillmentStatus,应为 PARTIALLY_FULFILLED

验收标准#

第二次发货复用同一条仍为 OPEN 的履约单成功,订单状态先 PARTIALLY_FULFILLED 后 FULFILLED,两段运单号都在时间线可见。

本文由 风格技术 技术团队整理,适用于 Shopify 标准版与 Plus 店铺。Shopify 平台能力迭代较快,具体操作路径与字段以官方文档和店铺后台实际版本为准。