您现在可以通过 API 版本 2026-10 中的 GraphQL Admin API、Customer Account API 以及三个新的 webhook 主题来管理买家请求的订单编辑，买家可以请求从订单中移除未履行的行项目，而商家（或代表其操作的 App）可以审查、解决或拒绝这些请求。
变更内容
买家现在可以请求编辑订单中未履行的行项目，这些请求作为一等公民资源 RequestedOrderEdit 在 Shopify 的所有 API 中暴露出来。
在 GraphQL Admin API 方面：
- 一个新的 RequestedOrderEdit 对象代表买家的请求，包括其状态、请求的更改以及请求提出、解决或拒绝的时间戳。
- 新的突变操作允许 App 代表商家和买家处理请求：requestedOrderEditCreate 创建请求，requestedOrderEditResolve 将请求标记为手动解决，而 requestedOrderEditDecline 则拒绝请求。
- 一个新的 requestedOrderEditCalculate 查询可在请求创建之前返回其计算出的财务结果。
- Order 对象新增了一个 requestedOrderEdits 连接和一个用于聚合订单请求状态以供显示的 displayRequestedEditStatus 字段；您可以使用 orders 查询中的新 requested_order_edit_status 搜索过滤器来查找有待商家操作的请求订单。
在 Customer Account API 中，新的 orderRequestEdit 突变操作允许买家提交编辑请求，而新的 requestedOrderEditCalculate 查询可预览财务结果。orderRequestEdit 通过 @ idempotent 指令支持可选的幂等键，重试的请求将返回最初创建的对象，而不是重复对象。
三个新的 webhook 主题会在请求在其生命周期中移动时通知 App：requested_order_edit/created、requested_order_edit/resolved 和 requested_order_edit/declined。有效载荷包括请求的状态、order_id 以及带有已解决数量的请求行项目更改。
受影响对象
适用于读取或管理订单的 App（如订单管理、ERP、履约和第三方物流集成），以及构建客户账户体验的 App。要使用新的 GraphQL Admin API 功能，App 需要针对查询的 read_orders 范围和针对突变的 write_orders 范围。
为何重要
在 2026-07 API 版本中，当买家希望在购买后更改订单时，没有 API 可见的记录；买家会在线下联系商家，商家手动编辑订单。通过请求进行的订单编辑遵循现有的订单编辑模型，但 App 无法看到请求、对其采取行动，或在履约前使外部系统（ERP、WMS）与待处理的更改保持同步。借助这些 API，App 现在可以在其自己的工作流中显示待处理的请求，对处于 REQUESTED 状态的订单暂停履约，并自动化解决或拒绝决策。
应对措施
无需采取任何操作。如果您希望支持买家发起的订单编辑功能，可以更新您的应用以使用最新版本的 GraphQL Admin API、Customer Account API 和 Webhooks。
相关文档
- RequestedOrderEdit 对象引用
- Admin API requestedOrderEditCreate 突变
- Customer API orderRequestEdit 突变
- Webhook 主题参考