维易淘客联盟接口开发文档:新版淘客订单API

新版淘客订单API

新版淘客订单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,方便我们跟进并提交给联盟官方。


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

【权限】全能接口和订单接口会员卡
【调用方法】

http://api.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的订单查询结束时间,中间时间段跨度日常要求不超过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 

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


【特别强调】为什么我的获取的订单号和联盟后台不一致?

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

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

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

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


返回值如下:



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

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

 

客服

关注