Shopify 发布 2026-10 稳定版 API

Shopify 于 2026 年 10 月 1 日发布 2026-10 稳定版 API，该版本为最新稳定版，可在生产环境中使用，至少支持到 2027 年 10 月 16 日 15:00 UTC。

本次更新涉及订单、元字段、客户账户、税费、分析和 Storefront API 等多项变更，其中部分变更需要更新代码，尤其是订单税费、草稿订单折扣、元字段筛选和客户账户结账相关集成。

在订单方面，使用 orderUpdate 或 REST Admin API 订单更新端点修改未履约订单的收货地址后，系统会针对新目的地重新计算税费；更新后需查询 updated taxLines、totalTaxSet、totals，并比对余额以处理付款或退款差额。此外，OrderCreateFulfillmentInput 新增 trackingNumbers，orderCreate 在导入多包裹履约订单时可附加多个跟踪号，若同时提供 trackingNumber 和 trackingNumbers，则以 trackingNumber 优先。

客户方面，CustomerPhoneNumber 新增 smsMarketingConsent 字段，采用与 WhatsApp 相同的结构化同意模型，原有的扁平 SMS 营销同意字段已弃用。细分查询语言函数改用 MATCHES 和 NOT MATCHES，不再使用 = true 和 = false，12_months_ago、90_days_ago、30_days_ago 和 7_days_ago 等命名日期已弃用，改用 -12m 等日期偏移。

折扣方面，折扣类型新增只读的 rollouts 连接，需添加 read_rollouts 访问范围，并读取 Discount.rollouts、Rollout 时间表及有效流量分配，因为折扣自身的日期无法描述其作为 rollout 一部分时的可用性。

商品与集合方面，GraphQL Admin API 在按不支持筛选的元字段进行查询过滤时现在会返回错误，而不再静默忽略该谓词；ProductVariant 新增 barcodes 连接，最多支持 20 个带类型的条形码，ProductVariant.barcode 已弃用。

本次更新还包括：新增结构化市场退货政策配置文件；订阅合同计算 API 通过 Shopify 结账引擎运行订阅合同编辑，支持在计算期间使用 Shopify Functions，并可在提交更改前预览总额、配送选项和警告；买家现在可以请求移除未履约的订单项，GraphQL Admin API 新增 RequestedOrderEdit 及相关操作，Customer Account API 新增 orderRequestEdit，并有三个 requested_order_edit webhook 主题报告每个请求的生命周期。