查询退款留言/凭证列表

一、请求参数

请求URL:

POST https://kf.fw199.com/gateway/taobao/refund/message/get

参数名	类型	必须	示例值	说明
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	代表不同的应用，具体请咨询客服，否则接口会调用失败

二、请求示例代码

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);

    }

三、返回结果

返回结果如下

{
    "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代表小二