新版淘客订单API是2019年5月24号上线最新的淘宝客订单查询接口，目前仍需观察一小段时间，请会员仍先使用旧版接口，但同时做好新版接口功能预备随时切换，暂时不要急忙忙换到新接口，以免影响业务。同时，对新版订单接口有问题可以反馈到群里。

和旧版的订单查询接口（http://wsd.591hufu.com/doc/dingdanchaxunxiazai）相比，有以下特点：

（以下pub端是指淘宝联盟官网pub.alimama.com）

以下是联盟官方汇总的优化点，有些点还未体现在新订单接口中，需要等联盟进一步优化：

1、pub/app/api报表类型、字段概念进行统一，理解成本/追溯问题成本降低

2、本次增加付款时间查询：主要解决淘客诟病，通过订单创建时间，要不断回查历史订单，容易拉不全或遗漏订单

3、增加淘宝付款时间透出：尤其解决大促时淘宝端付款和淘客付款时间对不上，以为丢单的问题

4、增加淘宝子订单编号透出：解决淘客之前用“父订单编号”，不能真正知道每个商品每笔订单的销售情况，尤其和退款订单匹配不上的问题

5、增加“提成”概念：等于之前的收入比率*分成比率，直接帮淘客算好能获得的比率，简单概念

6、pub端将”淘宝客推广明细“和”第三方服务商明细“整合到一起，解决淘客不能一次看全或下全订单的问题

7、切换底层数据表，解决之前订单明细加起来和效果统计数据对不上的问题

8、优化底层性能，解决媒体每秒获取订单受限问题(能承受度变高极多)，日常、大促批量获取订单更顺畅。

新版订单查询API注意点：

新报表从2019-04-23以后产生的订单开始查看，之前产生的订单，可点击“历史报表”，还是看原来的几张明细报表

若在2019-04-23之前产生的订单，发生维权退款，则仍需在历史报表“淘宝客维权退款”明细中查看。

新版订单接口如果在使用中有遇到请提交给VIP群或技术QQ，方便我们跟进并提交给联盟官方。

一、新订单查询接口调用方法：

【权限】全能接口和订单接口会员卡
【调用方法】负载均衡域名apiorder.vephp.com

http://apiorder.vephp.com/orderdetails?vekey=xx&start_time=...&end_time=.....

【参数详解】

具体参数可以参考官方文档：https://open.taobao.com/api.htm?docId=43755&docType=2&scopeId=16322 

本文档和淘宝联盟官方文档在参数名及其大小写上保持一致。

注意：订单开始时间start_time至订单结束时间end_time的时间段是38134分钟（约26天），时间段日常要求不超过3个小时，但如618、双11、年货节等大促期间预估时间段不可超过20分钟，超过会提示错误，

调用时请务必注意时间段的选择，以保证能正常调用！

start_time 必需参数，订单查询开始时间。需2019-04-23之后的时间点，并且必须小于end_time时间。

end_time 必须参数：订单查询结束时间。需2019-04-23之后的时间点，且必须大于start_time时间。

query_type 可选参数（默认值为1）：指查询时间类型，可选值：1-按照订单淘客创建时间查询，2-按照订单淘客付款时间查询，3-按照订单淘客结算时间查询。

position_index 可选参数（默认值为空）：位点，除第1页之外，其它页都需要传递本参数；前端原样返回。

page_no 可选参数（默认值1）：页码

page_size 可选参数（默认值20，最大值100）：每页返回的订单最大笔数

member_type 可选参数（默认值为空，表示所有角色）：推广者角色类型,2:二方，3:三方，不传则表示所有角色。

tk_status 可选参数（默认值为空，表示所有状态）：淘客订单状态，12-付款，13-关闭，14-确认收货，15-结算成功;不传，表示所有状态

jump_type 可选参数（默认值1）：跳转类型，当向前或者向后翻页必须提供,-1: 向前翻页,1：向后翻页

order_scene 可选参数（默认值1）：场景订单场景类型，1:常规订单，2:渠道订单，3:会员运营订单，默认为1

目前接口尚未返回渠道ID（relaitonId值），对接入到渠道ID的应用，暂时不适合新接口，

二、新订单接口返回值：

返回值字段类型参考官方文档：https://open.taobao.com/api.htm?docId=43755&docType=2&scopeId=16322 

注意新旧订单接口部分订单字段名有变动。

返回值如下：

附：淘客订单接口相关参考：

《订单报表名词解释》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