查询退款留言/凭证列表
查询退款留言/凭证列表
1.请求参数:
请求URL:
参数名 | 类型 | 必须 | 示例值 | 说明 |
---|---|---|---|---|
appid | String | true | uwkahf@jfs92 | 合作伙伴AppId |
timestamp | String | true | 1633618722 | 当前时间戳 |
tb_seller_nick | String | true | kingdo | 淘宝卖家店铺登录账号,非店铺名称 |
sign | String | true | 999de41d862efaa6f1084ead3b3ba480 | 如何计算生成见示例代码 |
refund_id | Number | true | 123456789 | 退款单号 |
page_no | Number | false | 1 | 页码 |
page_size | Number | false | 40 | 每页条数 |
refund_phase | String | false | onsale | 退款阶段,可选值:onsale(售中),aftersale(售后),天猫退款为必传。 |
sysid | String | false | 100 | 代表不同的应用,具体请咨询客服,否则接口会调用失败 |
2. 请求示例代码(Java)
@Test
public void TaoBaoRefunMessageGet() 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", Config.TBSellerNick);
data.put("refund_id", "132050558727563058");
data.put("page_no", "1");
data.put("page_size", "20");
// 签名
data.put("sign", Utils.Sign(data,Config.AppSecret));
// 调用服务API
doHttpRequest(Config.TaoBaoRefunMessageGetUrl ,data);
}
3. 返回结果
返回结果如下
{
"code": 0,
"message": "ok",
"data": {
"refund_messages": {
"refund_message": [{
"content": "亲,不好意思,已经在路上了,不要退了哈",
"created": "2021-10-09 12:14:11",
"id": 4489767828550,
"message_type": "NORMAL",
"owner_id": 661153176,
"owner_nick": "百鞋馆",
"owner_role": "2",
"pic_urls": {
"pic_url": [{
"url": "https://nonpublic.alicdn.com/nonpublic/file/refund_platform/IK88U/1zkEC8I3q9W/10c4e375673b80795cbe9503da426249?auth_key=1633761653-0-0-62c11d9981a1e738c737750405b1bc8d"
}]
},
"refund_id": "132050558727563058"
}, {
"content": "发起了仅退款申请,货物状态:未发货,原因:不想要了,金额:10.00元。",
"created": "2021-10-09 12:06:39",
"id": 4489761456469,
"message_type": "NORMAL",
"owner_id": 14563058,
"owner_nick": "superchina",
"owner_role": "1",
"pic_urls": {
"pic_url": null
},
"refund_id": "132050558727563058"
}]
},
"request_id": "zociif73ly4q",
"total_results": 2
},
"trace_id": ""
}
说明: code为0表示成功,非0为失败,message会包含失败原因。 其他响应参数说明如下:
参数名 | 类型 | 示例值 | 说明 |
---|---|---|---|
total_results | Number | 100 | 查询到的退款留言/凭证总数 |
refund_messages | RefundMessage [] | 查询到的退款留言/凭证列表 | |
id | Number | 127305 | 留言编号 |
owner_id | Number | 65754071 | 留言者编号 |
owner_nick | String | tbtest1202 | 留言者昵称 |
content | String | 测试信息 | 留言内容。最大长度: 400个字节 |
pic_urls | PicUrl[] | http://img08.taobao.net/bao/uploaded/i8/T1jVXXXePbXXaoPB6a_091917.jpg | 凭证附件地址(图片) |
url | String | http://img03.daily.taobaocdn.net/refund/T1r.dbXn8tXXb1upjX.jpg | 图片链接地址 |
created | Date | 2000-01-01 00:00:00 | 留言创建时间。格式:yyyy-MM-dd HH:mm:ss |
message_type | String | NORMAL | 退款类型:NORMAL(普通留言),RETURN_GOODS_APPROVED(卖家留退货地址时留言);如果为RETURN_GOODS_APPROVED,则退款留言中有卖家收货地址 |
refund_phase | String | onsale | 退款阶段,可选值:onsale(售中), aftersale(售后) |
refund_id | String | 127305 | 退款编号。 |
owner_role | String | 2 | 留言者身份1代表买家,2代表卖家,3代表小二 |
文档更新时间: 2023-11-15 15:58 作者:admin