Shopify Fulfillment REST API集成报错：必填参数缺失/无效排查求助

以下是几个直接导致该错误的常见原因及修复方案：

1. JSON格式语法错误 #

你的tracking_info.url字段用了.做字符串拼接，这不符合JSON语法规范，会导致整个Payload解析失败。正确的拼接要在代码层面完成，比如：

• JavaScript/TypeScript：用+拼接后再传入Payload："url": "https://ship.nimbuspost.com/shipping/tracking/" + $trackingID
• PHP：代码中完成拼接后再生成JSON

修复后的合法Payload示例（变量已替换为实际值）：

{
  "fulfillment": {
    "line_items_by_fulfillment_order": [
      {
        "fulfillment_order_id": 123456789
      }
    ],
    "tracking_info": {
      "number": "TRK123456",
      "url": "https://ship.nimbuspost.com/shipping/tracking/TRK123456"
    }
  }
}

2. 变量未实际替换 #

如果$orderID和$trackingID是代码占位符，但未被替换为真实的订单ID（数字类型）和追踪号（字符串类型），Payload中会保留无效的占位符内容，被API判定为参数无效。

发送请求前必须确保这些变量已替换为真实有效数据。

3. 核对API必填字段要求 #

若上述两点修复后仍报错，需确认：

• fulfillment_order_id是真实存在的有效ID
• 若为部分发货，需在line_items_by_fulfillment_order的数组项中添加fulfillment_order_line_items字段，指定要发货的商品行信息；整单发货则当前结构合法，但需确保订单状态支持发货操作

内容的提问来源于stack exchange，提问作者Crewman Dev