文档中心 > API类目 > 淘宝交易API

taobao.trades.sold.query (根据收件人信息查询交易单号)

根据收件人信息查询交易单号。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
query_list OrderQuery [] 必须
  • 最大列表长度:999
  • 查询条件列表,多个条件之间是OR关系,最多支持20个。receiver_name、receiver_mobile、receiver_phone至少有一个值不为空。
    • └ receiver_phone
    • String
    • 可选
    • 010-12345678
    • 收件人电话号码
    • └ receiver_mobile
    • String
    • 可选
    • 13012345678
    • 收件人的手机号
    • └ receiver_name
    • String
    • 可选
    • 张三
    • 收件人的姓名
    • └ end_created
    • Date
    • 可选
    • 2000-01-01 23:59:59
    • 查询三个月内交易创建时间开始。格式:yyyy-MM-dd HH:mm:ss
    • └ start_created
    • Date
    • 可选
    • 2000-01-01 00:00:00
    • 查询交易创建时间结束。格式:yyyy-MM-dd HH:mm:ss
    scene String 可选 1002 业务场景编码。不同场景,策略不同。请根据产品功能选择相应的场景编号。可选的场景:1001(客服咨询)、1002(售后服务),详情点击
    order_type String 可选 1
  • 默认值:1
  • 订单类型,默认值为1,可选值为:交易(1),分销(2),换货(3)

    响应参数

    名称 类型 示例值 描述
    tid_list String [] [123,456] 订单ID列表。按照订单创建时间倒序,最多返回最近的100笔订单。

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    TradesSoldQueryRequest req = new TradesSoldQueryRequest();
    List<TradesSoldQueryRequest.OrderQuery> list2 = new ArrayList<TradesSoldQueryRequest.OrderQuery>();
    TradesSoldQueryRequest.OrderQuery obj3 = new TradesSoldQueryRequest.OrderQuery();
    list2.add(obj3);
    obj3.setReceiverPhone("010-12345678");
    obj3.setReceiverMobile("13012345678");
    obj3.setReceiverName("张三");
    obj3.setEndCreated(StringUtils.parseDateTime("2000-01-01 23:59:59"));
    obj3.setStartCreated(StringUtils.parseDateTime("2000-01-01 00:00:00"));
    req.setQueryList(list2);
    req.setScene("1002");
    req.setOrderType("1");
    TradesSoldQueryResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <trades_sold_query_response>
        <tid_list>
            <string>[123</string>
            <string>456]</string>
        </tid_list>
    </trades_sold_query_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

    返回
    顶部