天猫淘宝家装家居分销订单查询
| 名称 | 类型 | 是否必须 | 示例值 | 更多限制 | 描述 |
|---|---|---|---|---|---|
| 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 | 未授权 | 不调用 |