API 2026-10 稳定：改地址重算税、metafield 过滤报错

发生了什么#

Shopify 在 9 月 17 日发布 2026-10 版本说明，10 月 1 日转为稳定版，官方文档标注可访问至 2027 年 10 月 16 日 15:00 UTC。这一版把几处「静默失败」改成了显式报错，也对订单税费与运费模板做了行为调整，属于必须在升级前处理的一版。

关键细节#

• 未履约订单修改收货地址后会按新目的地重算税费，需要重新查询 taxLines、totalTaxSet 与订单总额并核对余额
• 用未配置为可过滤的 metafield 做过滤会直接报错，不再静默忽略条件返回错误结果
• carrierServiceCreate 只注册服务，不再自动把费率加入通用运费模板
• 草稿单的 priceRule 与旧 PriceRule 类型被移除，改用 discountTitle 与 discountCode
• OrderDisplayFulfillmentStatus 新增 FULFILLMENT_NOT_REQUIRED，可履约数量为 0 的订单不再返回 UNFULFILLED
• Customer Account API 移除 Customer.lastIncompleteCheckout 及 Checkout 子树，且没有替代字段
• 客户细分条件改用 MATCHES / NOT MATCHES，命名相对日期被弃用；折扣增加 rollouts 连接，需要 read_rollouts 权限
• 库存调整相关 mutation 不再返回 ITEM_NOT_STOCKED_AT_LOCATION 错误，相关处理逻辑可以删除

对商家与开发者的影响#

订单同步、折扣、运费、客户账户四类应用必须先跑一轮回归。尤其是「改地址 → 税费变化 → 余额对不上」这条链路，出错时不会报错，只会在对账时暴露。

metafield 过滤从静默忽略改为报错，会把此前隐藏的 bug 一次性暴露出来。看到报错不要当成新问题，它很可能一直存在，只是以前没被发现。

建议动作#

1. 全局搜索代码里的 priceRule、lastIncompleteCheckout、旧的细分布尔写法和 `created_at:>` 增量逻辑
2. 在测试店用 2026-10 跑订单改地址、草稿单折扣、承运商费率三条链路
3. 升级前先在响应头里固定 API 版本，确认无误再切生产