查询卖家收到的退款列表
查询卖家收到的退款列表
1.请求参数:
请求URL:
参数名 | 类型 | 说明 | 示例 |
---|---|---|---|
appid | String | 合作伙伴AppId | uwkahf@jfs92 |
timestamp | String | 当前时间戳 | |
tb_seller_nick | String | 淘宝卖家店铺登录账号,非店铺名称 | kingdo |
status | String | 非必填,退款状态,默认查询所有退款状态的数据,除了默认值外每次只能查询一种状态。WAIT_SELLER_AGREE(买家已经申请退款,等待卖家同意) WAIT_BUYER_RETURN_GOODS(卖家已经同意退款,等待买家退货) WAIT_SELLER_CONFIRM_GOODS(买家已经退货,等待卖家确认收货) SELLER_REFUSE_BUYER(卖家拒绝退款) CLOSED(退款关闭) SUCCESS(退款成功) | |
buyer_nick | String | 非必填,买家昵称 | |
type | String | 非必填, 交易类型列表,一次查询多种类型可用半角逗号分隔,默认同时查询guarantee_trade, auto_delivery这两种类型的数据 | |
start_modified | Date | 非必填, 查询修改时间开始。格式: yyyy-MM-dd HH:mm:ss | |
end_modified | Date | 非必填, 查询修改时间结束。格式: yyyy-MM-dd HH:mm:ss | |
page_no | int | 非必填,页码。取值范围:大于零的整数; 默认值:1 | |
page_size | int | 非必填,每页条数。取值范围:大于零的整数; 默认值:40;最大值:100 | |
use_has_next | boolean | 非必填, 是否启用has_next的分页方式,如果指定true,则返回的结果中不包含总记录数,即total_results为0,但是会新增一个是否存在下一页的的字段,通过此种方式获取增量退款,接口调用成功率在原有的基础上有所提升。 | |
sign | String | 接口签名 | 如何计算生成见示例代码 |
refund_id | String | 必填, 退款单号 | 比如106322832633563058 |
sysid | String | 代表不同的应用,具体请咨询客服,否则接口会调用失败 | 100 |
2. 请求示例代码(Java)
@Test
public void getRefundReceive() throws Exception {
String tb_seller_nick = Config.TBSellerNick ;
//业务参数
Map<String, String> data = new HashMap<String, String>();
data.put("appid", Config.AppId);
Long timestamp = System.currentTimeMillis() / 1000;
data.put("timestamp", timestamp.toString());
data.put("tb_seller_nick", tb_seller_nick);
// 退款状态 ,如果要全部状态的话,不要传入字段status
data.put("status", "WAIT_SELLER_AGREE");
data.put("start_modified", "2021-01-01 00:00:00");
data.put("end_modified", "2021-04-01 00:00:00");
data.put("page_no", "1");
data.put("page_size", "30");
data.put("use_has_next", "true");
// data.put("sysid", "103");
// 签名
data.put("sign", Utils.Sign(data,Config.AppSecret));
// 调用服务API
doHttpRequest(Config.TaoBaoRefunReceiveUrl ,data);
}
3. 返回结果如下:
{
"code": 0,
"message": "ok",
"data": {
"has_next": false,
"refunds": [{
"buyer_nick": "我是买家",
"created": "2021-03-22 14:33:49",
"desc": "",
"good_status": "BUYER_NOT_RECEIVED",
"has_good_return": false,
"modified": "2021-03-23 14:34:04",
"oid": "1645829892702565830",
"order_status": "TRADE_CLOSED",
"payment": "0.00",
"reason": "不想要或拍多了",
"refund_fee": "48.00",
"refund_id": "106322832633563058",
"refund_phase": "onsale",
"seller_nick": "百鞋馆",
"status": "SUCCESS",
"tid": "1645829892702565830",
"title": "真皮男士增高鞋男高帮工装鞋-api23",
"total_fee": "48.00",
"company_name": "", // 物流公司名称
"sid": "", // 退货运单号
"sku": "", // 商品SKU信息
"attribute": "", // 退款扩展属性
"outer_id": "", //商品外部商家编码
"operation_contraint": "" // 退款约束,可选值:cannot_refuse(不允许操作),refund_onweb(需要到网页版操作)
}] ,
"request_id": "719j2mar72pa",
"total_results": 1
}
}
说明: code为0表示成功,非0为失败,message会包含失败原因。
返回字段 | 类型 | 说明 |
---|---|---|
good_status | string | 货物状态。可选值BUYER_NOT_RECEIVED (买家未收到货) BUYER_RECEIVED (买家已收到货) BUYER_RETURNED_GOODS (买家已退货) |
order_status | string | 退款对应的订单交易状态。可选值TRADE_NO_CREATE_PAY(没有创建支付宝交易) WAIT_BUYER_PAY(等待买家付款) WAIT_SELLER_SEND_GOODS(等待卖家发货,即:买家已付款) WAIT_BUYER_CONFIRM_GOODS(等待买家确认收货,即:卖家已发货) TRADE_BUYER_SIGNED(买家已签收,货到付款专用) TRADE_FINISHED(交易成功) TRADE_CLOSED(交易关闭) TRADE_CLOSED_BY_TAOBAO(交易被淘宝关闭) ALL_WAIT_PAY(包含:WAIT_BUYER_PAY、TRADE_NO_CREATE_PAY) ALL_CLOSED(包含:TRADE_CLOSED、TRADE_CLOSED_BY_TAOBAO) 取自”http://open.taobao.com/dev/index.php/%E4%BA%A4%E6%98%93%E7%8A%B6%E6%80%81" |
status | string | 退款状态。可选值WAIT_SELLER_AGREE(买家已经申请退款,等待卖家同意) WAIT_BUYER_RETURN_GOODS(卖家已经同意退款,等待买家退货) WAIT_SELLER_CONFIRM_GOODS(买家已经退货,等待卖家确认收货) SELLER_REFUSE_BUYER(卖家拒绝退款) CLOSED(退款关闭) SUCCESS(退款成功) |
has_good_return | bool | 买家是否需要退货”判断, true为退款退货,false仅退款。 |
文档更新时间: 2023-11-15 15:58 作者:admin