【说明】订单接口和高佣接口服务器各自独立，互不影响

淘宝客订单查询接口，是最新高级接口。本接口不是桌面软件挂机模拟登录抓取后台，而是直接使用淘宝联盟官方接口。

针对6-7月新规后，阿里妈妈订单查询越来越难，淘宝联盟保持在线越来越麻烦，使用订单查询接口是最佳选择，不需要再开软件保持登录，也不担心阿里网站修改，实时查到每次订单变化。也不需要模拟登录阿里联盟后台下载订单EXCEL，增加服务器负载了。

有了淘客订单查询接口，做返利，做代理，轻而易举。

本接口是直接调用 淘宝官方taobao.tbk.sc.order.get( 淘宝客订单查询 - 社交 ) 接口，因此该页的参数和本站接口通用。

参 http://open.taobao.com/api.htm?docId=38078&docType=2        （taobao.user.buyer.get）

【PS】如果你是新人，还不了解订单基础知识，可查看这里了解：http://wsd.591hufu.com/taokelianmeng/420.html 

新订单接口上线，请参考 http://wsd.591hufu.com/doc/xinbantaokedingdanapi

一、订单采集查询接口：

本接口使用联盟官方接口，独立负载均衡集群服务器，稳定好用。

淘宝客订单查询接口具体使用详解如下：

（一）基本概念：

接口查的订单是哪里的？它获取淘宝客推广栏目的订单，有两种淘客订单类型：

1、二方订单：就是你自己推广的订单，联盟后台的地址参图：

2、三方订单：就是拉新、或你的客户使用了红包的订单，它在淘宝联盟的位置如图：

（二）、订单查询接口调用频率：

在调用订单接口前，请了解一下 要如何安排订单查询频率？

（三）、使用订单查询接口：

接口地址如下，参数vekey和start_time是必备参数：

【注意】 本站订单接口和高佣接口是各自独立服务器，注意以下订单接口域名是“apiorder.vephp.com”

调用方式：GET 

http://apiorder.vephp.com/order?vekey=xxxx&start_time=查询起始日期

订单接口参数详解：

【特别说明】要查询渠道订单，请指定参数order_scene=2，参数含义参考下文。

start_time： 必须提供。指本次查询的开始时间，它和span参数共同限定了本次查询的订单时间段。格式如：2018-07-18 00:08:49，并做URL编码（即urlencode）后加入URL接口地址，如“2018-07-18+00%3A08%3A49”，本参数应精确到秒，才不会漏查你的订单。

【注意】start_time参数默认是指订单创建时间，它受下面参数order_query_type影响，可以设定order_query_type=settle_time则本参数表示结算时间。

span： 可选（默认值1200秒）， 订单查询时间范围, 单位:秒,最小60,最大1200, 建议使用1200秒。

示例： 假如你设置了start_time=2018-07-31 21:39:55，span=600秒。那么接口就返回以下这个时间段的订单：

 2018-07-31 21:39:55   ---  2018-07-31 21:49:55   即39分到49分这600秒时间的订单

（注意：前后包含，即包含49分在内）

如果你发现接口返回值中data为空或null，说明该时段没有订单。

page_no： 可选参数（默认值1），当前页码，默认是第一页，若您的订单多，要查第2页，请提供 page_no=2 参数，依次类推。

page_size： 可选参数（默认值100），每页记录数，不传递本参数则默认是最大一页100条订单数。

order_query_type：可选参数（默认值create_time），订单查询类型，提供创建时间“create_time”（默认），或结算时间“settle_time”，注意：当指定本参数为“settle_time”时，start_time是指结算时间，而非创建时间。

【订单结算怎么用？】每个月20-25号只扫描上个月已结算的订单，而不是全部扫描，可以大大节省扫描次数，提高效率，因此order_query_type设置为 settle_time只查结算订单，具体参考：http://wsd.591hufu.com/taokelianmeng/329.html 

tk_status： 可选参数（默认值1），订单状态值，分别有：1: 全部订单（默认值），3：订单结算，12：订单付款， 13：订单失效，14：订单成功；注意：若订单查询类型参数order_query_type为“结算时间 settle_time”时，则本值只能查订单结算状态（即值为3）

Tip:  

1、订单成功：表示买家确认收货，这时状态值是14.

2、订单结算：表示在买家确认收货后，联盟和卖家结算完佣金了。这时状态是3。也就是说14状态是在3前面。

注意这时的结算不是联盟和你结算，是和卖家结算。每个月20号联盟才跟你结算佣金。

 一般买家确认收货后就变成结算状态3，少数异常情形，比如淘宝卖家帐户余额不足等，会导致一直卡在14状态值。

3、订单失效：表示下了单但关闭订单等情形。

fields：（可选，一般不需要设置，默认返回全部字段），您想返回的订单查询字段，不带此参数则默认全部，有关字段参数官方taobao.tbk.sc.order.get( 淘宝客订单查询 - 社交 )接口说明，示例：

fields=tb_trade_parent_id,tb_trade_id,num_iid,item_title,item_num,price,pay_price,seller_nick,seller_shop_title,commission,commission_rate,unid,create_time,earning_time,tk3rd_pub_id,tk3rd_site_id,tk3rd_adzone_id,relation_id

本站默认不提供fields参数时，直接返回接口全部字段。

order_count_type （非必选，默认值1）： 订单数据统计类型，值1表示是2方订单（即你自己推广的订单，在效果报表中），值2表示第3方订单，如果不设置或者设置为1，表示二方订单。

如果你发现淘宝联盟APP中有一笔订单，在电脑端的淘宝联盟却没有，这类情形要么是订单延迟，要么你漏掉了第三方订单了。请检查第三方订单。

【TIP】什么是2方订单，什么是3方订单？

2方订单：就是你自己推广的订单，你自己拥有这笔订单完全佣金。

3方订单：就是你推广的客户，在领了你的淘口令或推广链接后，去下单过程中，在购物车上用了别的淘客的红包，导致订单变成别人的，而你只有这笔订单产品普通通用佣金的一半。

三方订单在联盟后台“效果报表——第三方服务商推广”项下。在用订单接口查询时，必须使用order_count_type=2来查。

order_scene（非必选，默认1） 订单场景类型，1:常规订单，2:渠道订单，3:会员运营订单。默认为1，通过设置订单场景类型，媒体可以查询指定场景下的订单信息，例如不设置，或者设置为1，表示查询常规订单，常规订单包含淘宝客所有的订单数据，含渠道，及会员运营订单，但不包含3方分成，及维权订单。

【特别提示】

order_scene默认值1是查常规订单，如果您想查渠道订单，务必设置order_scene=2，

同理，查会员订单order_scene=3。

否则不会返回relation_id和special_id值。

sessionkey：多用户专用。如果您的会员卡是多用户版订单查询接口，若要查不同的帐号，请提供该帐号授权的sessionkey值，

那么要如何安排订单查询频率？

（四）、如何知道要查几页订单？

如果订单数据量大，单页page_size最大是100条记录，那么要分若干页查询，每次轮询时，可以在程序中递增page_no参数查询，直到返回值中“data”字段条数不足100条（视你的page_size而定），或"data"为空或null，说明该时段内订单已查询完毕。

（五）、接口返回值含义：

对于PHP用户，因为订单返回值中的订单号是长整数，有的人会看到把返回值转成数组时，PHP把订单号转成科学计数法，解决办法：

转数组时用 json_decode($resp, true , 512 , JSON_BIGINT_AS_STRING); 同时，你的数据库保存订单号字段要用varchar类型。

（1）如果查询的时段内订单为空，或出错，则返回如下JSON内容：

其中error为0时，msg提示成功，表示该时段没有订单。

如果error不为0，msg带有提示信息，则表示出错，比如error=27表示sessionkey授权过期了，需要重新授权

{

    "error": 15,

    "msg": "start_time参数时间不能大于当前时间",

    "data": null

}

（2）如果没有出错，表示订单获取成功。这时error=0，分两种情况：

情形一：如果data不为空(null)，表示有订单，

情形二：如果data为空(null)，表示接口指定的start_time开始到20分钟内，是没有订单记录。

返回值完全和官方相同，参:

http://open.taobao.com/api.htm?docId=38078&docType=2

打开链接后，参考这节：

注意：只要没有走确认收货的订单状态，就不会有 total_commission_fee 和commission

开始你的测试吧，这个接口太好用啦。

二：关于Insufficient security level:R1 security authorize invalid的提示：

 {"error":53,"msg":"Insufficient security level:R1 security authorize invalid","data":[]}

这是因为订单接口升级过程中，原有sessionkey失效，需要更换，进入会员中心重新授权一下即可。

升级完成后就不会再出现此提示！

淘客订单接口相关参考：

《订单报表名词解释》http://wsd.591hufu.com/taokelianmeng/428.html

《有时淘宝联盟APP有订单而淘宝联盟PC端没有？》http://wsd.591hufu.com/taokelianmeng/432.html

《订单接口为什么有时获取的订单数量变少了？》http://wsd.591hufu.com/taokelianmeng/423.html 

《淘宝订单查询接口的返回值中，哪个是付款字段？》http://wsd.591hufu.com/taokelianmeng/264.html 

《淘宝联盟订单查询接口的子订单号和父订单号是什么区别？怎样区分每个订单》http://wsd.591hufu.com/taokelianmeng/273.html 

《如何区分订单是哪个客户下单的？如何用PID绑定订单和客户？》http://wsd.591hufu.com/taokelianmeng/265.html

《淘宝联盟APP中订单预估收入和详情页预估收入有误差？》http://wsd.591hufu.com/taokelianmeng/348.html

《淘宝客维权订单接口在退款过程状态值怎么变？》http://wsd.591hufu.com/taokelianmeng/373.html