淘宝开放平台

登录
文档中心 > API类目 > 千牛接口

千牛接口

taobao.qianniu.sellerorder.buyer.query (买家在卖家的店铺产生的订单查询接口)

根据买家nick批量查询在指定店铺的一段时间内的订单信息

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
buyer_nick_list String 必须 tbtest01,tbtest02 批量查询的买家nick列表，最多支持一次查询100个买家nick
start_time_str String 必须 2014-12-11 09:00:00 查询订单的时间范围
end_time_str String 必须 2014-12-18 16:00:00 批量查询订单信息的结束时间
client_info String 可选 platform=pc&v=1.01.00N 客户端的版本信息

响应参数

名称 类型 示例值 描述
trade_order_list TradeOrder [] 买家订单里列表
  • └ buyer_nick
  • String
  • tbtest01
  • 买家用户nick
  • └ buyer_id
  • Number
  • 12345
  • 买家ID
  • └ buyer_memo
  • String
  • 开发票
  • 买家备注
  • detail_order_list
  • DetailTradeOrder []
  • 子订单信息列表
  • └ buyer_nick
  • String
  • tbtest01
  • 买家用户nick
  • └ buyer_id
  • Number
  • 12345
  • 买家ID
  • └ buyer_memo
  • String
  • 开发票
  • 买家备注
  • └ seller_memo
  • String
  • 送赠品
  • 卖家的备注信息
  • └ order_id
  • Number
  • 12324
  • 交易订单ID
  • └ pay_status
  • Number
  • 2
  • 订单的支付状态，1：未付款；2：已付款；4: 已退款；6：交易完成；8：交易被淘宝关闭；9：不可付款
  • └ buyer
  • String
  • openid
  • └ seller_memo
  • String
  • 送赠品
  • 卖家的备注信息
  • └ order_id
  • Number
  • 12324
  • 交易订单ID
  • └ pay_status
  • Number
  • 2
  • 订单的支付状态，1：未付款；2：已付款；4: 已退款；6：交易完成；8：交易被淘宝关闭；9：不可付款
  • └ buyer
  • String
  • openid

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
1
2
3
4
5
6
7
8
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
QianniuSellerorderBuyerQueryRequest req = new QianniuSellerorderBuyerQueryRequest();
req.setBuyerNickList("tbtest01,tbtest02");
req.setStartTimeStr("2014-12-11 09:00:00");
req.setEndTimeStr("2014-12-18 16:00:00");
req.setClientInfo("platform=pc&v=1.01.00N");
QianniuSellerorderBuyerQueryResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
<qianniu_sellerorder_buyer_query_response>
    <trade_order_list>
        <trade_order>
            <buyer_nick>tbtest01</buyer_nick>
            <buyer_id>12345</buyer_id>
            <buyer_memo>开发票</buyer_memo>
            <detail_order_list>
                <detail_trade_order>
                    <buyer_nick>tbtest01</buyer_nick>
                    <buyer_id>12345</buyer_id>
                    <buyer_memo>开发票</buyer_memo>
                    <seller_memo>送赠品</seller_memo>
                    <order_id>12324</order_id>
                    <pay_status>2</pay_status>
                    <buyer></buyer>
                </detail_trade_order>
            </detail_order_list>
            <seller_memo>送赠品</seller_memo>
            <order_id>12324</order_id>
            <pay_status>2</pay_status>
            <buyer></buyer>
        </trade_order>
    </trade_order_list>
</qianniu_sellerorder_buyer_query_response>

异常示例

  • XML示例
  • JSON示例
1
2
3
4
5
6
<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测试工具 错误码查询工具 SDK下载

如何获得此API

FAQ

我要提问
返回
顶部