天猫淘宝家装家居分销订单查询
| 名称 | 类型 | 是否必须 | 示例值 | 更多限制 | 描述 | 
|---|---|---|---|---|---|
| tc_order_id | Number | 可选 | 3438500868015245550 | 消费者交易单号(采购单下游买家订单id)。 当在代销、寄售交易中,此单号存在。 | |
| time_type | String | 可选 | trade_time_type | 时间类型: trade_time_type(默认类型,按照采购单创建时间范围查询,推荐按照此时间类型查询) update_time_type(采购单按照更新时间范围查询) | |
| page_size | Number | 可选 | 50 |  | 每页条数。(每页条数不超过50条) | 
| page_no | Number | 可选 | 1 |  | 页码。(大于0的整数。默认为1) | 
| purchase_order_id | Number | 可选 | 1680825885556350977 | 采购单编号或分销流水号。 当指定此参数后,其他可选参数可以为空 | |
| start_created | Date | 可选 | 2000-01-01 00:00:00 | 起始时间,格式 yyyy-MM-dd HH:mm:ss 支持到秒的查询。若不传时分秒,默认为0时0分0秒。当指定了purchase_order_id或者tc_order_id时,此值可选,否则此参数必传。 结束时间和开始时间的时间间隔不能超过7天,精确到秒。 | |
| end_created | Date | 可选 | 2000-01-01 23:59:59 | 结束时间,格式 yyyy-MM-dd HH:mm:ss 支持到秒的查询。若不传时分秒,默认为0时0分0秒。当指定了purchase_order_id或者tc_order_id时,此值可选,否则此参数必传。 结束时间和开始时间的时间间隔不能超过7天,精确到秒。 | |
| status | String | 可选 | WAIT_BUYER_PAY | 交易状态:WAIT_SELLER_SEND_GOODS(等待发货) WAIT_SELLER_SEND_GOODS(待确认收款) WAIT_BUYER_PAY(等待付款) WAIT_BUYER_CONFIRM_GOODS(已发货) TRADE_REFUNDING(退款中) TRADE_FINISHED(交易成功) TRADE_CLOSED(已关闭) TRADE_REFUNDED(已退款) WAIT_BUYER_PAY_DEPOSIT(待付定金) WAIT_BUYER_PAY_TAIL(已付定金,待付尾款) ONLY_DEPOSIT_TO_SELLER(尾款超时未付,收定金) | 
| 名称 | 类型 | 示例值 | 描述 | 
|---|---|---|---|
| total_results | Number | 9999 | 查询到的采购单记录总数 | 
| purchase_orders | TopDpOrderDo [] | 采购单及子采购单信息。 返回 PurchaseOrder 包含的字段信息。 | |
| 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 | 
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
JzfxOrdersQueryRequest req = new JzfxOrdersQueryRequest();
req.setTcOrderId(3438500868015245550L);
req.setTimeType("trade_time_type");
req.setPageSize(50L);
req.setPageNo(1L);
req.setPurchaseOrderId(1680825885556350977L);
req.setStartCreated(StringUtils.parseDateTime("2000-01-01 00:00:00"));
req.setEndCreated(StringUtils.parseDateTime("2000-01-01 23:59:59"));
req.setStatus("WAIT_BUYER_PAY");
JzfxOrdersQueryResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());
                <jzfx_orders_query_response>
    <total_results>9999</total_results>
    <purchase_orders>
        <top_dp_order_do>
            <logistics_id>123123</logistics_id>
            <distributor_username>zhangsan</distributor_username>
            <supplier_from>values: taobao</supplier_from>
            <pay_time>2000-01-01 00:00:00</pay_time>
            <tc_order_id>157026218599994214</tc_order_id>
            <memo>留言。</memo>
            <supplier_flag>1</supplier_flag>
            <buyer_payment>200.07</buyer_payment>
            <distributor_from>taobao</distributor_from>
            <consign_time>2000-01-01 00:00:00</consign_time>
            <pay_type>ALIPAY_SURETY</pay_type>
            <shipping>FAST</shipping>
            <logistics_company_name>EMS</logistics_company_name>
            <modified>2000-01-01 00:00:00</modified>
            <confirm_paid_fee_yuan>22.22</confirm_paid_fee_yuan>
            <id>555</id>
            <sub_purchase_orders>
                <sub_order_detail>
                    <refund_fee>12.23</refund_fee>
                    <discount_fee>11.11</discount_fee>
                    <tc_order_id>157026218599994214</tc_order_id>
                    <num>50</num>
                    <order_200_status>PAID_SEND_GOODS</order_200_status>
                    <buyer_payment>200.07</buyer_payment>
                    <title>裙子</title>
                    <bill_fee>100.10</bill_fee>
                    <price>50</price>
                    <tc_discount_fee>1000</tc_discount_fee>
                    <item_outer_id>OUT00001</item_outer_id>
                    <id>5552</id>
                    <sku_id>555</sku_id>
                    <sku_outer_id>5555</sku_outer_id>
                    <fenxiao_id>46467999930382</fenxiao_id>
                    <created>2000-01-01 00:00:00</created>
                    <sc_item_id>100000000</sc_item_id>
                    <tc_adjust_fee>1000</tc_adjust_fee>
                    <distributor_payment>200.07</distributor_payment>
                    <auction_id>100</auction_id>
                    <item_id>620019999537</item_id>
                    <sku_properties>颜色:红色</sku_properties>
                    <auction_sku_id>100</auction_sku_id>
                    <total_fee>200.07</total_fee>
                    <auction_price>100.10</auction_price>
                    <status>WAIT_BUYER_PAY(等待买家付款)</status>
                    <auction_pict_url>//img.alicdn.com/xxxx</auction_pict_url>
                </sub_order_detail>
            </sub_purchase_orders>
            <trade_type>AGENT</trade_type>
            <fenxiao_id>1001</fenxiao_id>
            <open_buyer_uid>44544541165</open_buyer_uid>
            <receiver>
                <zip>310000</zip>
                <oaid>xxxx</oaid>
                <address>文一西路969号</address>
                <mobile_phone>13812345678</mobile_phone>
                <phone>57188155188</phone>
                <city>杭州市</city>
                <district>余杭区</district>
                <name>zhangsan</name>
                <state>浙江省</state>
            </receiver>
            <created>2000-01-01 00:00:00</created>
            <post_fee>200.07</post_fee>
            <distributor_payment>200.07</distributor_payment>
            <supplier_username>zhangsan</supplier_username>
            <total_fee>200.07</total_fee>
            <order_messages>
                <order_messages>
                    <message_time>2000-01-01 00:00:00</message_time>
                    <pic_url>1</pic_url>
                    <message_title>分销商留言</message_title>
                    <message_content>留言内容</message_content>
                </order_messages>
            </order_messages>
            <end_time>2000-01-01 00:00:00</end_time>
            <status>TRADE_FINISHED(交易成功)</status>
            <warehouse_type>0</warehouse_type>
            <sn_code>111111</sn_code>
            <sn_tag_value>a_b_c</sn_tag_value>
            <need_imei>true</need_imei>
            <imei_code>11111</imei_code>
        </top_dp_order_do>
    </purchase_orders>
</jzfx_orders_query_response>
                    <error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>
                    | 错误码 | 错误描述 | 解决方案 | 
|---|---|---|
| CHECK:COMMON:CHECK_UNAUTHORIZED | 未授权 | 不调用 |