新版淘客订单API【需token】

新版淘客订单API是2019年5月24号上线最新的淘宝客订单查询接口，对新版订单接口有问题可以反馈给管理员。

以下pub端是指淘宝联盟官网）

以下是联盟官方汇总的优化点：

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

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

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

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

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

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

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

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

新版订单查询API注意点：

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

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

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

请求URL：http://qjqapi.ybiaos.com/TaoBaoApi/tbk_orderNew

返回格式：json

请求方式：get

请求参数说明：

名称	类型	是否必须	示例值	描述
appkey	String	必填	123456	appkey
session	String	必填		授权后，再授权页面获取。（有效期30天）
query_type	Number	选填	1	查询时间类型，1：按照订单淘客创建时间查询，2:按照订单淘客付款时间查询，3:按照订单淘客结算时间查询
position_index	String	选填	2222_334666	位点，除第一页之外，都需要传递；前端原样返回。
page_size	Number	选填	20	页大小，默认20，1~100
member_type	Number	选填	2	推广者角色类型,2:二方，3:三方，不传，表示所有角色
tk_status	Number	选填	12	淘客订单状态，12-付款，13-关闭，14-确认收货，3-结算成功;不传，表示所有状态
end_time	String	必填	2019-04-23 12:28:22	订单查询结束时间，订单开始时间至订单结束时间，中间时间段日常要求不超过3个小时，但如618、双11、年货节等大促期间预估时间段不可超过20分钟，超过会提示错误，调用时请务必注意时间段的选择，以保证亲能正常调用！
start_time	String	必填	2019-04-05 12:18:22	订单查询开始时间，需进行urlencode编码
jump_type	Number	选填	1	跳转类型，当向前或者向后翻页必须提供,-1: 向前翻页,1：向后翻页
page_no	Number	选填	1	第几页，默认1，1~100
order_scene	Number	选填	1	场景订单场景类型，1:常规订单，2:渠道订单，3:会员运营订单，默认为1

返回参数

名称	类型	示例值	描述
results	PublisherOrderDto[]	PublisherOrderDto	PublisherOrderDto
├　tb_paid_time	String	2019-04-22 15:15:05	订单在淘宝拍下付款的时间
├　tk_paid_time	String	2019-04-22 15:15:05	订单付款的时间，该时间同步淘宝，可能会略晚于买家在淘宝的订单创建时间
├　pay_price	String	9.11	买家确认收货的付款金额（不包含运费金额）
├　pub_share_fee	String	0	结算预估收入=结算金额*提成。以买家确认收货的付款金额为基数，预估您可能获得的收入。因买家退款、您违规推广等原因，可能与您最终收入不一致。最终收入以月结后您实际收到的为准
├　trade_id	String	294159887445064307	买家通过购物车购买的每个商品对应的订单编号，此订单编号并未在淘宝买家后台透出
├　tk_order_role	Number	2	二方：佣金收益的第一归属者；三方：从其他淘宝客佣金中进行分成的推广者
├　tk_earning_time	String	2019-04-22 15:15:05	订单确认收货后且商家完成佣金支付的时间
├　adzone_id	Number	11	推广位管理下的推广位名称对应的ID，同时也是pid=mm_1_2_3中的"3"这段数字
├　pub_share_rate	String	100	从结算佣金中分得的收益比率
├　refund_tag	Number	0	维权标签，0 含义为非维权 1 含义为维权订单
├　subsidy_rate	String	0	平台给与的补贴比率，如天猫、淘宝、聚划算等
├　tk_total_rate	String	9.99	提成=收入比率*分成比率。指实际获得收益的比率
├　item_category_name	String	淘小铺	商品所属的根类目，即一级类目的名称
├　seller_nick	String	--	掌柜旺旺
├　pub_id	Number	98836808	推广者的会员id
├　alimama_rate	String	0	推广者赚取佣金后支付给阿里妈妈的技术服务费用的比率
├　subsidy_type	String	--	平台出资方，如天猫、淘宝、或聚划算等
├　item_img	String	//img.alicdn.com/b2419.jpg	商品图片
├　pub_share_pre_fee	String	0	付款预估收入=付款金额*提成。指买家付款金额为基数，预估您可能获得的收入。因买家退款等原因，可能与结算预估收入不一致
├　alipay_total_price	String	11.22	买家拍下付款的金额（不包含运费金额）
├　item_title	String	tsh_rj_测试请不要拍_阶佣11.1	商品标题
├　site_name	String	合伙人	媒体管理下的对应ID的自定义名称
├　item_num	Number	2	商品数量
├　subsidy_fee	String	0	补贴金额=结算金额*补贴比率
├　alimama_share_fee	String	0	技术服务费=结算金额收入比率技术服务费率。推广者赚取佣金后支付给阿里妈妈的技术服务费用
├　trade_parent_id	String	294159887445064307	买家在淘宝后台显示的订单编号
├　order_type	String	如意淘	订单所属平台类型，包括天猫、淘宝、聚划算等
├　tk_create_time	String	2019-04-22 15:15:05	订单创建的时间，该时间同步淘宝，可能会略晚于买家在淘宝的订单创建时间
├　flow_source	String	--	产品类型
├　terminal_type	String	无线	成交平台
├　click_time	String	2019-04-22 15:14:55	通过推广链接达到商品、店铺详情页的点击时间
├　tk_status	Number	13	已付款：指订单已付款，但还未确认收货已收货：指订单已确认收货，但商家佣金未支付已结算：指订单已确认收货，且商家佣金已支付成功已失效：指订单关闭/订单佣金小于0.01元，订单关闭主要有：1）买家超时未付款； 2）买家付款前，买家/卖家取消了订单；3）订单付款后发起售中退款成功；3：订单结算，12：订单付款， 13：订单失效，14：订单成功
├　item_price	String	2.1	商品单价
├　item_id	Number	590141576510	商品id
├　adzone_name	String		推广位管理下的自定义推广位名称
├　total_commission_rate	String	9.9	佣金比率
├　item_link	String		商品链接
├　site_id	Number	45598009	媒体管理下的ID，同时也是pid=mm_1_2_3中的"2"这段数字
├　seller_shop_title	String	--	店铺名称
├　income_rate	String	9.99	订单结算的佣金比率+平台的补贴比率
├　total_commission_fee	String	0	佣金金额=结算金额*佣金比率
├　tk_commission_pre_fee_for_media_platform	String	1.05	预估专项服务费：内容场景专项技术服务费，内容推广者在内容场景进行推广需要支付给阿里妈妈专项的技术服务费用。专项服务费＝付款金额＊专项服务费率。
├　tk_commission_fee_for_media_platform	String	1.05	结算专项服务费：内容场景专项技术服务费，内容推广者在内容场景进行推广需要支付给阿里妈妈专项的技术服务费用。专项服务费＝结算金额＊专项服务费率
├　tk_commission_rate_for_media_platform	String	0.01	专项服务费率：内容场景专项技术服务费率，内容推广者在内容场景进行推广需要按结算金额支付一定比例给阿里妈妈作为内容场景专项技术服务费，用于提供与内容平台实现产品技术对接等服务。
├　special_id	Number	2323	会员运营id
├　relation_id	Number	2323	渠道关系id
has_pre	Boolean	false	是否还有上一页
position_index	String	1555904214_lGltNdNvSX2\|1555917305_lJfPMeFmdt2	位点字段，由调用方原样传递
has_next	Boolean	true	是否还有下一页
page_no	Number	1	页码
page_size	Number	20	页大小

如需AppKey 可点击下方链接

青椒券API开放平台