在 GraphQL Admin API 2026-04 版本中，可通过 ShopifyQL 查询的多个分析退货字段已被弃用，并替换为更名后的版本（例如 sales_reversals、reversed_quantity），以更好地反映它们捕获所有订单调整（包括退款、退货、订单编辑和取消）的情况。其定义保持不变。
弃用时间线
已弃用的字段将在2026-07版本中移除，但在2027-04之前仍可通过旧版API访问。
我们为何这样做
新的字段名称澄清了广泛订单调整（销售冲销）与实物退货之间的区别。随着退货原因报告的推出，您现在可以在行项目级别查看实物退货数量及其原因，这与整体订单调整是分开的。请使用 returned_quantity、return_line_item_reason 和 is_unverified_return_line_item 在退货架构中访问这些详细信息。
您需要做什么
更新您的 ShopifyQL 查询以使用新的 sales_reversals 和 reversed_quantity 字段（见下方的映射表）。
| 已弃用的字段 | 新的替换字段 |
|---|---|
| returns | sales_reversals |
| net_returns | net_sales_reversals |
| gross_returns | gross_sales_reversals |
| total_returns | total_sales_reversals |
| discounts_returned | discount_reversals |
| shipping_returned | shipping_reversals |
| taxes_returned | tax_reversals |
| quantity_returned | reversed_quantity |
| returned_quantity_rate | reversed_quantity_rate |
| is_return_related | is_sales_reversal |
| order_or_return | order_or_sales_reversal |
详细了解更新的 字段。以及 ShopifyQL。