taobao.shangou.refund.list (闪购退款列表查询接口)

闪购退款列表查询接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
fields String 可选 refund_id,total_fee,status,created,refund_fee,refund_type,tid,oid,reason,goods_status
  • 默认值:refund_id,total_fee,status,created,refund_fee,refund_type,tid,oid,reason,goods_status
  • 退款单需要返回的字段。不填则返回全部字段。目前支持的字段:refund_id,total_fee,status,created,refund_fee,refund_type,tid,oid,reason,goods_status
    status String 可选 10 退款状态,枚举值:10:等待卖家发货,20:待买家发货,30:待商家收货,40:退款关闭,50:退款成功,60:卖家拒绝退款
    buyer_open_id String 可选 AXADSASDSDSDSSS 买家OpenId
    buyer_nick String 可选 hz0799 买家昵称
    page_size Number 必须 40
  • 默认值:40
  • 每页条数。取值范围:大于零的整数; 默认值:40;最大值:50
    page_no Number 必须 1
  • 默认值:1
  • 页码。取值范围:大于零的整数; 默认值:1
    start_time Date 必须 2025-08-01 00:00:00 查询退款申请开始时间开始。格式: yyyy-MM-dd HH:mm:ss
    end_time Date 可选 2025-08-01 00:00:00 查询退款申请结束时间开始。格式: yyyy-MM-dd HH:mm:ss

    响应参数

    名称 类型 示例值 描述
    result ListRefundOrderResponse 搜索返回结果
    • └ total_results
    • Number
    • 400
    • 搜索到的总数
    • └ total_page
    • Number
    • 20
    • 总页数
    • trades
    • XsdOrderDTO []
    • 单次返回的所有明细数据。按照订单维度分组返回
    • └ tid
    • String
    • 4321212332322
    • 淘宝交易单号
    • └ trade_status
    • String
    • WAIT_SELLER_SEND_GOODS
    • 退款对应的订单交易状态,枚举值。 等待卖家发货:WAIT_SELLER_SEND_GOODS, 等待买家确认收货:WAIT_BUYER_CONFIRM_GOODS, 交易成功:TRADE_FINISHED, 交易关闭:TRADE_CLOSED
    • refunds
    • XsdReverseOrder []
    • 退款数据。可能有多个,对应一笔主订单下的多个售后单
    • └ refund_id
    • String
    • 83477
    • 退款单号
    • └ oid
    • String
    • 2231884277
    • 子订单号。如果是单笔交易oid会等于tid
    • └ tid
    • String
    • 2231884277
    • 淘宝交易单号
    • └ total_fee
    • String
    • 10.00
    • 交易总金额。精确到2位小数;单位:元。如:200.07,表示:200元7分
    • └ created
    • Date
    • 2000-01-01 00:00:00
    • 退款申请时间。格式:yyyy-MM-dd HH:mm:ss
    • └ status
    • String
    • 10
    • 10:等待卖家发货,20:待买家发货,30:待商家收货,40:退款关闭,50:退款成功,60:卖家拒绝退款
    • └ good_status
    • String
    • 1
    • 货物状态。4:未发货,6:已发货, 1:未收到货,2:已收到货, 3:已寄回,5:卖家确认收货
    • └ refund_fee
    • String
    • 10.00
    • 退还金额(退还给买家的金额)。精确到2位小数;单位:元。如:200.07,表示:200元7分
    • └ reason
    • String
    • 退还邮费
    • 退款原因
    • └ refund_type
    • String
    • "1"
    • 退款类型。枚举值说明:0:缺省值,1:仅退款,2:部分退款,11:自动退款,12:整单退,3:退货退款,4:换货,8:极速换货,5:维修,6:换货,7:售后服务,10:补寄,20:赔付,13:发票补寄,14:破损补寄,15:退货邮费单,16:仅退邮费, 17:零售合并退款,31:退运费
    • └ buyer_nick
    • String
    • 我**
    • 买家昵称
    • └ buyer_open_uid
    • String
    • AAHk5d-EAAeGwJedwSFu0XXX
    • 买家OpenUid
    • └ seller_nick
    • String
    • 我在测试
    • 卖家昵称
    • └ store_code
    • String
    • 123232_TBDDS
    • 门店编码
    • └ store_name
    • String
    • 测试门店名称
    • 门店名称

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    ShangouRefundListRequest req = new ShangouRefundListRequest();
    req.setFields("refund_id,total_fee,status,created,refund_fee,refund_type,tid,oid,reason,goods_status");
    req.setStatus("10");
    req.setBuyerOpenId("AXADSASDSDSDSSS");
    req.setBuyerNick("hz0799");
    req.setPageSize(40L);
    req.setPageNo(1L);
    req.setStartTime(StringUtils.parseDateTime("2025-08-01 00:00:00"));
    req.setEndTime(StringUtils.parseDateTime("2025-08-01 00:00:00"));
    ShangouRefundListResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <shangou_refund_list_response>
        <result>
            <total_results>400</total_results>
            <total_page>20</total_page>
            <trades>
                <xsd_order_d_t_o>
                    <tid>4321212332322</tid>
                    <trade_status>WAIT_SELLER_SEND_GOODS</trade_status>
                    <refunds>
                        <xsd_reverse_order>
                            <refund_id>83477</refund_id>
                            <oid>2231884277</oid>
                            <tid>2231884277</tid>
                            <total_fee>10.00</total_fee>
                            <created>2000-01-01 00:00:00</created>
                            <status>10</status>
                            <good_status>1</good_status>
                            <refund_fee>10.00</refund_fee>
                            <reason>退还邮费</reason>
                            <refund_type>&quot;1&quot;</refund_type>
                        </xsd_reverse_order>
                    </refunds>
                    <buyer_nick>我**</buyer_nick>
                    <buyer_open_uid>AAHk5d-EAAeGwJedwSFu0XXX</buyer_open_uid>
                    <seller_nick>我在测试</seller_nick>
                    <store_code>123232_TBDDS</store_code>
                    <store_name>测试门店名称</store_name>
                </xsd_order_d_t_o>
            </trades>
        </result>
    </shangou_refund_list_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>

    错误码解释

    错误码 错误描述 解决方案

    API工具

    如何获得此API

    FAQ

    返回
    顶部