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