注意:以下文档只适用于TOP接口,请谨慎使用!

taobao.retrieve.record.search (商家挽单工具批量查询挽单记录接口)

商家挽单工具批量查询挽单记录接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
page_size Number 必须 20
  • 默认值:20
  • 分页大小
    page_no Number 必须 1
  • 默认值:1
  • 页面索引
    start_time Date 可选 2000-01-01 00:00:00 发送开始时间
    end_time Date 可选 2000-01-01 00:00:00 发送结束时间
    strategy_id String 可选 134 关联的策略id
    tid Number 可选 412212212122 关联的主订单id
    refund_id Number 可选 43434343434 关联的退款单id
    buyer_nick String 可选 张三 买家昵称

    响应参数

    名称 类型 示例值 描述
    record_list RetrieveRecord [] 挽单记录列表
    • └ strategy_name
    • String
    • 测试策略
    • 关联的策略名称
    • └ strategy_id
    • String
    • 134
    • 关联的策略id
    • └ biz_status
    • Number
    • 20
    • 挽回状态,20-成功,30-失败,10-挽回中
    • └ retrieve_fee_yuan
    • String
    • 20
    • 挽回成功的金额,单位:元
    • └ failed_reason
    • String
    • 券过期了
    • 挽回失败的原因
    • └ record_id
    • Number
    • 43434
    • 挽回记录id
    • └ tid
    • Number
    • 21233434
    • 关联的主订单id
    • └ strategy_type
    • String
    • SMART
    • 策略类型,DEFAULT-自定义挽单,SMART-智能挽单
    • └ refund_id
    • Number
    • 2323232
    • 关联的退款单编号
    • └ selected_code
    • String
    • 3
    • 买家选择的方案code,可能为空
    • └ buyer_open_uid
    • String
    • demo
    • 消费者oaid
    • └ send_time
    • Date
    • 2000-01-01 00:00:00
    • 买家选择方案的时间,可能为空
    • └ oid
    • Number
    • 23434343
    • 子订单id
    total_count Number 100 挽单记录总数

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    RetrieveRecordSearchRequest req = new RetrieveRecordSearchRequest();
    req.setPageSize(20L);
    req.setPageNo(1L);
    req.setStartTime(StringUtils.parseDateTime("2000-01-01 00:00:00"));
    req.setEndTime(StringUtils.parseDateTime("2000-01-01 00:00:00"));
    req.setStrategyId("134");
    req.setTid(412212212122L);
    req.setRefundId(43434343434L);
    req.setBuyerNick("张三");
    RetrieveRecordSearchResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <retrieve_record_search_response>
        <record_list>
            <retrieve_record>
                <strategy_name>测试策略</strategy_name>
                <strategy_id>134</strategy_id>
                <biz_status>20</biz_status>
                <retrieve_fee_yuan>20</retrieve_fee_yuan>
                <failed_reason>券过期了</failed_reason>
                <record_id>43434</record_id>
                <tid>21233434</tid>
                <strategy_type>SMART</strategy_type>
                <refund_id>2323232</refund_id>
                <selected_code>3</selected_code>
                <buyer_open_uid>demo</buyer_open_uid>
                <send_time>2000-01-01 00:00:00</send_time>
                <oid>23434343</oid>
            </retrieve_record>
        </record_list>
        <total_count>100</total_count>
    </retrieve_record_search_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

    返回
    顶部