Shopify API 2026-10 稳定版发布：订单税、元字段过滤与顾客账户等需改代码

Shopify 开发者文档发布 2026-10 Release Notes。该版本为当前最新稳定 API，自2026年10月1日起可供生产使用，至少可用至2027年10月16日 15:00 UTC。官方写明，本版重点涉及订单、元字段（metafield）、顾客账户、税务、分析与 Storefront API；其中订单税重算、草稿订单折扣、元字段过滤器、顾客账户结账等变更「需要代码更新」，建议在采用前审查受影响集成。[1]

几处明确要求行动的变更

• 顾客分段查询：Segment 查询语言改用 MATCHES / NOT MATCHES，命名日期如 12_months_ago 等弃用，改用 -12m 一类偏移；CustomerPhoneNumber 短信营销同意迁到结构化 smsMarketingConsent 字段。[1]

• 订单与税务：对未履约订单用 orderUpdate 或 REST 更新改收货地址时，系统会按新目的地重算税；调用后应查询更新后的 taxLines、totalTaxSet 等并处理支付或退款差额。[1]

• 草稿订单折扣：DraftOrderDiscountNotAppliedWarning 移除已弃用的 priceRule，相关 PriceRule 类型也从公共 schema 移除；查询改选 discountTitle、discountCode。[1]

• 元字段过滤：按无效 metafield 过滤查询时改为返回错误，而不再静默忽略；升级前须确认定义支持过滤与比较运算符。[1]

• 变体条码：ProductVariant 新增最多20个类型化条码的 barcodes 连接，原 barcode 字段弃用，只返回第一条。[1]

• 顾客账户 API：移除已弃用的 Customer.lastIncompleteCheckout 及不可达的 Checkout 类型子树，无替换字段，升级前须删掉相关查询。[1]

其他值得记录的能力

版本还引入或扩展：SubscriptionContractCalculation（订阅合同经结账引擎计算，替代多步 SubscriptionDraft）、买家可请求移除未履约行项目的 RequestedOrderEdit 系列、Next Gen Events 正式可用、Rollouts 查询与 webhook、ShopifyQL 应用分析能力，以及 POS UI 扩展购物车写入需确认、Session API 移除 staffMemberId 等破坏性调整。完整清单与生效日期以官方 changelog 分条为准。[1]

对商家应用与第三方集成方，2026-10 更像一次「升级前必读的稳定版变更说明」，而不是上手教程：应对照自有 scopes、查询字段与 webhook 订阅做差异清单，再决定何时从旧版本切过去。[1]

来源

[1] 2026-10: Release notes，Shopify.dev，版本发布日期2026年10月1日（页面查询2026年10月25日）。

#Shopify #API #2026-10 #电商开发 #ReleaseNotes