您现在可以使用新的ReturnReasonDefinition类型，在管理退货时捕获更细粒度、按类别划分的退货原因。这取代了之前的ReturnReason枚举，采用更丰富的数据模型，有助于为商家提供更精准的退货分析洞察，并为买家打造更个性化的退货体验。
更新内容
- 一种新的ReturnReasonDefinition类型，包含id、handle和name字段。请使用稳定的handle进行程序化逻辑处理。
- returnReasonDefinitions查询用于检索所有可用的退货原因库。
- LineItem上的新suggestedReturnReasonDefinitions连接功能，可为每种产品的类别提供量身定制的退货原因。
- returnCreate、returnRequest和orderRequestReturn变更操作现在在其行项目输入中接受returnReasonDefinitionId。
- 可在ReturnLineItem和UnverifiedReturnLineItem类型上访问returnReasonDefinition。
弃用项
输入类型和退货行项目类型上的returnReason字段已弃用。请在输入时使用returnReasonDefinitionId，在读取退货数据时使用returnReasonDefinition。
迁移指南
如果您的应用创建退货，请更新您的变更操作以使用returnReasonDefinitionId替代returnReason。在LineItem上查询suggestedReturnReasonDefinitions，以获取与每个产品上下文相关的退货原因。在读取退货数据时，请更新您的查询以使用returnReasonDefinition替代returnReason。
这些变更在 API 版本 2026-01 中可用。