文档中心 > API类目 > 淘宝退款API

taobao.refund.messages.get (查询退款留言/凭证列表)

查询退款留言/凭证列表

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
fields String [] 必须 id,message_type,pic_urls
  • 最大列表长度:100
  • 需返回的字段列表。可选值:RefundMessage结构体中的所有字段,以半角逗号(,)分隔。
    page_no Number 可选 1
  • 默认值:1
  • 页码
    page_size Number 可选 40
  • 默认值:40
  • 每页条数
    refund_id Number 必须 123456789 退款单号
    refund_phase String 可选 onsale 退款阶段,可选值:onsale(售中),aftersale(售后),天猫退款为必传。

    响应参数

    名称 类型 示例值 描述
    refund_messages RefundMessage [] 查询到的退款留言/凭证列表
    • └ content
    • String
    • 测试信息
    • 留言内容。最大长度: 400个字节
    • └ created
    • Date
    • 2000-01-01 00:00:00
    • 留言创建时间。格式:yyyy-MM-dd HH:mm:ss
    • └ id
    • Number
    • 127305
    • 留言编号
    • └ message_type
    • String
    • NORMAL
    • 退款类型:NORMAL(普通留言),RETURN_GOODS_APPROVED(卖家留退货地址时留言);如果为RETURN_GOODS_APPROVED,则退款留言中有卖家收货地址
    • └ owner_id
    • Number
    • 65754071
    • 留言者编号
    • └ owner_nick
    • String
    • tbtest1202
    • 留言者昵称
    • └ owner_role
    • String
    • 2
    • 留言者身份1代表买家,2代表卖家,3代表小二
    • └ refund_id
    • String
    • 127305
    • 退款编号。
    • └ refund_phase
    • String
    • onsale
    • 退款阶段,可选值:onsale(售中), aftersale(售后)
    • pic_urls
    • PicUrl []
    • http://img08.taobao.net/bao/uploaded/i8/T1jVXXXePbXXaoPB6a_091917.jpg
    • 图片链接
    • └ url
    • String
    • http://img03.daily.taobaocdn.net/refund/T1r.dbXn8tXXb1upjX.jpg
    • 图片链接地址
    • └ owner_open_uid
    • String
    • FJNKDK
    • 留言者openid
    total_results Number 100 查询到的退款留言/凭证总数

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    RefundMessagesGetRequest req = new RefundMessagesGetRequest();
    req.setFields("id,message_type,pic_urls");
    req.setPageNo(1L);
    req.setPageSize(40L);
    req.setRefundId(123456789L);
    req.setRefundPhase("onsale");
    RefundMessagesGetResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <refund_messages_get_response>
        <refund_messages>
            <refund_message>
                <content>测试信息</content>
                <created>2000-01-01 00:00:00</created>
                <id>127305</id>
                <message_type>NORMAL</message_type>
                <owner_id>65754071</owner_id>
                <owner_nick>tbtest1202</owner_nick>
                <owner_role>2</owner_role>
                <refund_id>127305</refund_id>
                <refund_phase>onsale</refund_phase>
                <pic_urls>
                    <pic_url>
                        <url>http://img03.daily.taobaocdn.net/refund/T1r.dbXn8tXXb1upjX.jpg</url>
                    </pic_url>
                </pic_urls>
                <owner_open_uid>FJNKDK</owner_open_uid>
            </refund_message>
        </refund_messages>
        <total_results>100</total_results>
    </refund_messages_get_response>

    异常示例

    • XML示例
    • JSON示例
    <error_response>
        <code>50</code>
        <msg>Remote service error</msg>
        <sub_code>isv.invalid-parameter</sub_code>
        <sub_msg>非法参数</sub_msg>
    </error_response>

    错误码解释

    错误码 错误描述 解决方案
    isv.refund-not-exist 退款不存在 检查退款id ,确认传人正确的退款id
    isv.missing-parameter 参数为空,如天猫订单凭,退款版本号,说明信息证以及售中或者售后参数等 按接口提示的 为空参数,补充完整后重试。
    isv.invalid-parameter 参数错误 参数错误,按报错提示的错误参数,修改后重试

    API工具

    如何获得此API

    FAQ

    返回
    顶部