| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| app_key | Long | 是 | 接入时申请的app_key |
| method | String | 是 | 接口名称 |
| access_token | String | 是 | Oauth2.0授权获得的access_token |
| sign | String | 是 | 对 API 调用参数（除sign外）进行 md5 加密获得。参数的顺序为字母表的顺序 |
| timestamp | Long | 是 | 时间戳，使用Unix时间戳格式 |
| format | String | 是 | 响应格式。默认为json格式，固定 |
| sign_method | String | 否 | 参数的加密方法选择，当前只支持Md5 |
| version | String | 否 | API协议版本，固定值为：1.0 |
| 名称 | 类型 | 必选 | 描述 | 示例值 |
|---|---|---|---|---|
| refundQueryByBuyerReq | Object | 是 | 请求参数对象 | |
| queryStatus | String | 是 | * query_refund_or_return_all：全部状态(不包含已取消的退款订单) * query_refund_or_return_all_for_openapi：全部状态(包含已取消的退款订单) * query_return_goods_requested：买家发起退货，等待卖家同意 * query_return_goods_agreed：卖家同意，等待买家退货 * query_return_goods_shipped： 买家发货，等待卖家收货 * query_refund_requested：买家发起退款，等待卖家同意 * query_refund_completed：退款完成 * query_refund_or_return_seller_refused：买家退款或退货或发货被卖家拒绝 | |
| refundType | String | 是 | * query_refund_type_all：全部类型（退款、退货、退到官方） | |
| startCreated | String | 是 | * 退款订单创建时间开始，2016-06-01 00:00:00 | |
| endCreated | String | 是 | * 退款订单创建时间结束：2016-06-11 00:00:00 | |
| startUpdated | String | 是 | * 退款订单更新时间开始：2016-06-01 00:00:00 | |
| endUpdated | String | 是 | * 退款订单更新时间结束：，2016-06-11 00:00:00 | |
| buyerUserId | Number | 是 | 买家用户ID(buyerUserId和unionId必须至少填一个，优先使用buyerUserId) | |
| unionId | String | 是 | 买家unionId(buyerUserId和unionId必须至少填一个，优先使用buyerUserId) | |
| pageNum | Number | 是 | 当前页码 | |
| pageSize | Number | 是 | 分页记录数(不能超过30) | |
| userId | Number | 是 | 商家用户id |
| 名称 | 类型 | 描述 | 默认值 |
|---|---|---|---|
| status | Object | 状态 | |
| code | String | 状态码 | |
| msg | String | 错误信息 | |
| result | Object | 返回结果 | |
| data | Object | 返回结果data对象 | |
| refundFullDTOList | Object[] | 返回结果数组 | |
| refundFullDTOList_object | Object | 返回结果对象 | |
| reason | String | 退款原因 | |
| itemIdStr | String | 商品id(加密后) | |
| itemCode | String | 商品编码 | |
| orderStatus | String | 订单状态，包括： ORDER_CREATED": "已下单", ORDER_CANCELLED": "订单取消", ORDER_PAID": "已支付", ORDER_SHIPPED": "已发货", ORDER_RECEIVED": "已收货", ORDER_COMPLETED": "订单完成", ORDER_CLOSED": "订单关闭" | |
| createdStr | String | 创建时间 | |
| itemOrderId | Number | 商品级别订单id | |
| buyerName | String | 买家姓名 | |
| expense | Number | 运费 | |
| timeLines | Object[] | 操作记录数组 | |
| timeLines_object | Object | 操作记录对象 | |
| actionType | String | 操作类型code | |
| showContent | String[] | 操作日志内容 | |
| createdStr | String | 创建时间 | |
| actionName | String | 操作类型描述 | |
| refundDescription | String | 买家退款描述 | |
| nowPrice | Number | 商品折扣后的价格(分) | |
| number | Number | 商品数量 | |
| refundType | String | 类型:退货/退款 | |
| itemId | Number | 商品id(明文) | |
| refundShipInfo | Object | 退货地址/物流信息 | |
| shopOrderId | Number | 店铺级订单id | |
| updatedStr | String | 修改时间 | |
| price | Number | price(分) | |
| goodsPrice | Number | 商品订单货款总额 nowPrice*num | |
| refundId | Number | 退款id | |
| skuCode | String | sku编码 | |
| status | String | 退款订单状态 买家发起退货，等待卖家同意RETURN_GOODS_REQUESTED ---> return_goods_requested 卖家同意，等待买家退货RETURN_GOODS_AGREED ----> return_goods_agreed 买家发货，等待卖家收货RETURN_GOODS_SHIPPED ----> return_goods_shipped 买家发起退款，等待卖家同意REFUND_REQUESTED -----> refund_requested 买卖家协商一致，等待资金退款结果 REFUND_OR_RETURN_DEAL_AGREED -----> refund_or_return_deal_agreed 买家退款或退货被卖家拒绝REFUND_OR_RETURN_SELLER_REFUSED -----> refund_or_return_seller_refused 买家发货后，卖家未收到货RETURN_GOODS_SELLER_DECLARE_NOT_RECEIVED -----> return_goods_seller_declare_not_received 退款完成REFUND_COMPLETED -----> refund_completed 退款取消REFUND_CANCELLED -----> refund_cancelled * 注：超时的不算取消节点。 | |
| refundOrderUrl | String | 售后单url链接到PC端售后单页面 | |
| hasNext | Boolean | 是否还有下一页 | |
| success | Boolean | 是否成功 |
1).{
"refundQueryByBuyerReq":{
"queryStatus":"query_refund_or_return_all",
"startCreated":"2020-04-01 11:00:00",
"endCreated":"2020-04-25 11:00:00",
"refundType":"query_refund_type_all",
"buyerUserId":1515467013,
"pageNum":1,
"pageSize":30
}
}
1).{
"status": {
"code": "0000000",
"msg": "调用成功"
},
"result": {
"data": {
"refundFullDTOList": [
{
"reason": "不想买了",
"itemIdStr": "1qmhdso",
"itemCode": "10J5001",
"orderStatus": "ORDER_CLOSED",
"createdStr": "2020-04-01 23:47:22",
"itemOrderId": 80177282227013,
"buyerName": "丁来佳",
"expense": 9900,
"timeLines": [
{
"actionType": "REFUND_MONEY_DETAIL",
"showContent": [
"退款现金: 99.00元"
],
"createdStr": "2020-04-02 14:53:37",
"actionName": "退款金额明细"
},
{
"actionType": "REFUND_SELLER_AGREE",
"showContent": [],
"createdStr": "2020-04-02 14:53:06",
"actionName": "商家同意退款"
},
{
"actionType": "REFUND_BUYER_ADD",
"showContent": [
"退款原因：不想买了",
"退款现金：99.00元",
"退款说明：无"
],
"createdStr": "2020-04-01 23:47:22",
"actionName": "买家申请退款"
}
],
"refundDescription": "",
"nowPrice": 9900,
"number": 1,
"refundType": "refund_money",
"itemId": 804941552,
"refundShipInfo": {},
"shopOrderId": 80177282217013,
"updatedStr": "2020-04-02 14:53:37",
"price": 9900,
"goodsPrice": 9900,
"refundId": 300320406,
"skuCode": "10J50011105",
"status": "refund_completed"
},
{
"reason": "不想买了",
"itemIdStr": "1qmj0ko",
"itemCode": "10TC005",
"orderStatus": "ORDER_CLOSED",
"createdStr": "2020-04-24 13:23:23",
"itemOrderId": 80185748527013,
"buyerName": "丁来佳",
"expense": 3700,
"timeLines": [
{
"actionType": "REFUND_MONEY_DETAIL",
"showContent": [
"退款现金: 37.00元",
"备注：本次退款含邮费8.00元"
],
"createdStr": "2020-04-24 13:30:27",
"actionName": "退款金额明细"
},
{
"actionType": "REFUND_SELLER_AGREE",
"showContent": [],
"createdStr": "2020-04-24 13:30:05",
"actionName": "商家同意退款"
},
{
"actionType": "REFUND_BUYER_ADD",
"showContent": [
"退款原因：不想买了",
"退款现金：37.00元",
"备注：本次退款含邮费8.00元",
"退款说明：无"
],
"createdStr": "2020-04-24 13:23:23",
"actionName": "买家申请退款"
}
],
"refundDescription": "",
"nowPrice": 2900,
"number": 1,
"refundType": "refund_money",
"itemId": 804979640,
"refundShipInfo": {},
"shopOrderId": 80185748517013,
"updatedStr": "2020-04-24 13:30:27",
"price": 2900,
"goodsPrice": 2900,
"refundId": 300335583,
"skuCode": "10TC00501120",
"status": "refund_completed"
}
],
"hasNext": false
}
},
"success": true
}