Shopify Admin API

2026-10 升级后订单改地址税费被重算

现象#

版本从 2026-07 提到 2026-10 后三处同时出问题:改过收货地址的订单税额变化、按 metafield 过滤商品直接报错、无需发货的订单状态仍是 UNFULFILLED。

原因#

  • 2026-10 起 orderUpdate 修改未履约订单的地址会按新目的地重算税费,旧税额不再保留
  • 按未配置为可过滤的 metafield 过滤会返回错误,此前是静默忽略该条件
  • 枚举新增 FULFILLMENT_NOT_REQUIRED,无需发货的订单不再返回 UNFULFILLED
  • 创建承运商服务不再自动加入 General 配送模板,结账页会缺少对应运费

处理步骤#

  1. 在 2026-10 开发店重放关键查询,先看响应里的 errors 与 extensions.code
  2. 改地址后重查 taxLines、totalTaxSet 与订单总额,差额走余额调整而不是直接改价
  3. 给枚举映射补 FULFILLMENT_NOT_REQUIRED 分支,避免落进 default 抛错
  4. 过滤前用 metafieldDefinitions 确认 definition 的 capabilities 允许过滤
  5. 建完承运商服务后手动把费率加进配送模板,并回查结账页是否出现该选项

验收标准#

2026-10 下核心链路无 errors;改地址订单的税额等于新地址税率算出的结果;无需发货订单返回 FULFILLMENT_NOT_REQUIRED 而不报错。

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