WooCommerce Fulfillment API：履约发货传追踪号需调用哪个接口

WooCommerce v3版本API没有设计独立的发货资源接口，所有履约、发货相关操作都复用你已经在用的orders接口，这是和其他独立电商平台API逻辑差异最大的点。

• 接口基础信息
  完成发货操作需要调用PUT方法请求/wp-json/wc/v3/orders/{目标订单ID}接口，本质是更新指定订单的属性，没有单独的ASN推送、追踪号上传接口。

注意：WooCommerce核心程序本身没有内置物流追踪号的专属存储字段，官方标准化的追踪号能力由官方免费扩展WooCommerce Shipment Tracking提供，如果你对接的站点用的是第三方物流插件，追踪号对应的存储字段需要匹配插件规则，以下是通用标准对接方案。

• 基础发货通知触发
  如果只需要标记订单履约完成、触发平台自带的发货通知邮件，只需要在请求体中更新订单状态即可：

  {
    "status": "completed"
  }
  

  当实物订单状态从processing（待履约）变更为completed（已完成）时，WooCommerce会自动向客户预留的邮箱发送发货通知，不需要额外调用消息推送类接口。

• 物流追踪号上传（适配官方追踪扩展）
  如果站点安装了官方Shipment Tracking扩展，在更新订单的请求体中追加meta_data字段传入追踪信息即可，系统会自动把追踪信息拼到发货通知邮件里，实现高级发货通知（ASN）效果：

  {
    "status": "completed",
    "meta_data": [
      {
        "key": "_wc_shipment_tracking_items",
        "value": [
          {
            "tracking_provider": "对接站点预设的物流公司标识",
            "tracking_number": "实际物流追踪单号",
            "tracking_link": "物流轨迹查询直链",
            "date_shipped": "发货日期，格式为YYYY-MM-DD"
          }
        ]
      }
    ]
  }
  

• 常见踩坑说明

  • 不用尝试找/shipments、/asn之类的独立路径，WooCommerce v3 API没有提供这类独立资源接口
  • 如果对接的站点用的是第三方物流/追踪插件，先拉取一个手动填过追踪号的订单详情，查看返回的meta_data字段里对应的追踪信息key，替换上面示例里的key即可
  • API返回200成功只代表订单数据更新完成，不代表发货邮件一定发送成功，邮件触达问题需要排查站点本身的邮件发送配置，和API调用无关

内容的提问来源于stack exchange，提问作者박상욱