维易淘客联盟接口开发文档:淘客订单查询

淘宝联盟订单查询,返利计算(9.20下线)

【说明】本订单接口为旧版,2019-9-20下线,

请切换到新订单接口http://wsd.591hufu.com/doc/xinbantaokedingdanapi


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


针对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是必备参数:


调用方式:GET 

http://api.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类型。

其它语言也存在这个问题,比如node.js,请自行百度该语言处理长整型数据。

tip:在浏览器显示时,请使用 json-handle 插件,才能正确显示订单号,其它插件不能正确显示订单号。


(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 

 

客服

关注