查询退款留言/凭证列表

查询退款留言/凭证列表

1.请求参数:

请求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 代表不同的应用,具体请咨询客服,否则接口会调用失败

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