卖家同意退货
卖家同意退货,支持淘宝和天猫的订单。
一、请求参数
请求URL:
POST https://kf.fw199.com/gateway/taobao/refund/returngoods/agree
| 参数名 | 类型 | 必须 | 示例值 | 说明 |
|---|---|---|---|---|
| appid | String | true | uwkahf@jfs92 | 合作伙伴AppId |
| timestamp | String | true | 1633618722 | 当前时间戳 |
| tb_seller_nick | String | true | kingdo | 淘宝卖家店铺登录账号,非店铺名称 |
| sign | String | true | 999de41d862efaa6f1084ead3b3ba480 | 如何计算生成见示例代码 |
| refund_id | Number | true | 328818231125 | 退款编号 |
| name | String | false | 张三 | 卖家姓名,淘宝退款为必填项。 |
| address | String | false | 浙江省杭州市西湖区XX路XX号XX小区 | 卖家提供的退货地址,淘宝退款为必填项。 |
| post | String | false | 310000 | 卖家提供的退货地址的邮编,淘宝退款为必填项。 |
| tel | String | false | 05718848388 | 卖家座机,淘宝退款为必填项。 |
| mobile | String | false | 18628219999 | 卖家手机,淘宝退款为必填项。 |
| remark | String | false | 没有问题,同意退货 | 卖家退货留言,天猫退款为必填项。 |
| refund_phase | String | false | onsale | 售中:onsale,售后:aftersale,天猫退款为必填项。 |
| refund_version | Number | false | 1409231007325 | 退款版本号,天猫退款为必填项。 |
| seller_address_id | Number | true | 123456 | 卖家收货地址编号,天猫淘宝退款都为必填项。 |
| post_fee_bear_role | Number | false | 0 | 邮费承担方,买家承担值为1,卖家承担值为0 |
| virtual_return_goods | Boolean | false | false | 是否虚拟退货,可选项 |
| sysid | String | false | 100 | 代表不同的应用,具体请咨询客服,否则接口会调用失败 |
二、请求示例代码
Java
@Test public void TaoBaorefundreturnAgree() throws Exception { 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", "132032916631563058"); data.put("mobile", "13877228899"); data.put("tel", "05718848388"); data.put("name", "张三"); data.put("address", "浙江省杭州市西湖区32路11号12小区"); data.put("post", "310000"); data.put("seller_address_id", "18701489"); // 通过查询卖家地址库接口获取 // data.put("sysid", "103"); // 签名 data.put("sign", Utils.Sign(data,Config.AppSecret)); // 调用服务API doHttpRequest(Config.TaoBaorefundreturnAgreeUrl ,data);
}三、返回结果
返回结果如下
{ "code":0, "message":"ok", "data":{ "is_success":true, "request_id":"vrueu9nmss77" }, "trace_id":""}说明: code为0表示成功,非0为失败,message会包含失败原因, 结果以is_success为准。
四、常见问题
- Q:taobao.rp.returngoods.agree (卖家同意退货)中seller_address_id卖家收货地址编号怎么获取? A:通过这个taobao.logistics.address.search (查询卖家地址库) , contact_id字段返回。