17.1.0版本更新

本版本变更概览

17.1.0 版本主要补充了商品查询接口的商品状态筛选入参，并在订单相关接口中补充了退货金额、退货数量和商品溯源数据链接等返回字段。

接口变更明细

1. `GET /openApiV2/Commodity/pageList`

接口名称：获取商品 SPU

变更类型：新增入参

新增入参：

status

说明：商品状态，Y:正常、N:删除、D:彻底删除，支持多个值逗号分隔

版本说明：版本>=17.1.0支持

返回字段检查结果：当前在线文档中未发现 17.1.0 专属的返回字段版本说明

2. `GET /openApiV2/Commodity/pageSkuList`

接口名称：获取商品 SKU

变更类型：新增入参

新增入参：

status

说明：商品状态，Y:正常、N:删除、D:彻底删除，支持多个值逗号分隔

版本说明：版本>=17.1.0支持

返回字段检查结果：当前在线文档中未发现 17.1.0 专属的返回字段版本说明

3. `GET /openApiV2/Order/pageList`

接口名称：获取订单列表

变更类型：新增返回字段

新增返回字段：

data.list[].return_amount

说明：退货金额

字段备注：版本>=17.1.0版本后支持

4. `GET /openApiV2/Order/detail`

接口名称：获取订单详情

变更类型：新增返回字段

新增返回字段：

data.order.return_amount

说明：退货金额

字段备注：版本>=17.1.0后支持

data.order.commodity_list[].cloud_origin_url

说明：商品溯源数据链接

字段备注：该链接是一个获取溯源数据的接口，需要调用这个接口地址才能拿到数据，版本>=1710后支持

data.order.commodity_list[].return_quantity

说明：商品退货数量

字段备注：与 return_amount 同版本说明

data.order.commodity_list[].return_amount

说明：商品退货金额

对接方建议

如需查询删除商品或彻底删除商品，请确认商品查询接口对接版本至少为 17.1.0。

如需展示订单退货金额、商品退货数量或商品溯源数据链接，请确认订单接口对接版本至少为 17.1.0。

cloud_origin_url 仅返回溯源数据接口地址，如需实际溯源内容，还需按文档说明继续调用对应链接。

来源页面

本版本变更概览#

接口变更明细#

1. GET /openApiV2/Commodity/pageList#

2. GET /openApiV2/Commodity/pageSkuList#

3. GET /openApiV2/Order/pageList#

4. GET /openApiV2/Order/detail#

对接方建议#

来源页面#