我们正在对 Shopify Admin API 中的退货管理进行重要变更，以简化并增强其功能。
有哪些变化？
- returnRefund 突变已弃用，并被新的 returnProcess 突变所取代。returnProcess 突变通过将处置决策和财务处理合并为单个调用来简化退货生命周期管理。
- 字段 Return.suggestedReturnRefund 已弃用，取而代之的是新的 Return.suggestedFinancialOutcome 字段。
- 换货履行订单现在仅在处理换货品项时创建，以确保准确性。
- 退款和退货处理现在能够更精确地管理已退货的品项。
需要采取的操作：
如果您的应用当前使用 returnCreate 创建退货或使用 returnApproveRequest 批准退货请求，请迁移到新的 returnProcess 突变以处理退款和换货。较旧的突变（refundCreate、returnRefund）和查询字段（Return.suggestedRefund）已弃用。现在，您应改用 returnProcess 和 Return.suggestedFinancialOutcome。
可用性：
这些新 API 现可在 unstable API 版本中使用，并将在 API 版本 2025-07 中正式发布。
更多详情请参阅我们更新的 迁移指南。