亲爱的淘宝客，
为了提升淘宝客在PC/APP查看报表、或通过API获取推广订单明细的体验，淘宝联盟对推广订单明细的使用进行了全面升级！
本次升级主要表现
1、联盟PC电脑端/联盟APP/API的报表类型、字段概念进行统一，理解成本/追溯问题成本降低
2、PC/APP/API 本次增加付款时间查询：主要解决淘客，通过订单创建时间，需要不断回溯历史订单，容易拉不全或遗漏订单
3、PC/API 增加淘宝付款时间透出：尤其解决大促时淘宝端付款和淘客付款时间对不上，以为丢单的问题(下载Excel内有/API里有字段)
4、PC/API 增加淘宝子订单编号透出：解决淘客之前用“订单编号”，不能真正知道每个商品每笔订单的销售情况，尤其和退款订单匹配不上的问题
5、PC/API 增加“提成”概念：等于之前的收入比率*分成比率，直接帮淘客算好能获得收入的比率，简单概念
6、PC 联盟PC后台将老后台的”淘宝客推广明细“和”第三方服务商明细“整合到一起，解决淘客不能一次看全或下全订单的问题
7、优化底层性能，解决媒体每秒获取订单受限问题(能承受度变高极多)，日常、大促批量获取订单更顺畅
新升级注意点：
新报表从2019-04-23以后产生的订单开始查看，之前产生的订单，点击“历史报表”，还是看原来的几张明细报表
若在2019-04-23之前产生的订单，发生维权退款，则仍需在历史报表“淘宝客维权退款”明细中查看
订单查询API提供新API，注意是新的API。 API：taobao.tbk.order.details.get 淘宝客【推广者】所有订单查询
新报表上线，如体验上有疑问，欢迎在群里进行沟通（联盟特训营大本营（唯一淘宝客官方群）旺旺群号：361411709）
本次订单升级节奏
批量切换灰度期(5.10开始预计观察1周~10天)：
随机一定账户量，逐步切换。若被切换到新报表的淘客有问题可群内咨询：联盟特训营大本营（唯一淘宝客官方群） 旺旺群号：361411709
全量切换：
批量灰度结束后，没问题就ok，如有问题可能会延迟(有变动本帖中会通知大家！)
老报表计划下线时间：
pub/app90天以后老报表下掉(因报表最长可回溯时间是90天)
老订单查询API预计保留时间4个月，但从现在起开的是新订单API
本次升级优化具体说明
PC电脑端具体优化点：
1、联盟新后台将推广明细相关报表进行整合，统一升级至新后台“推广订单明细”中查看
联盟老后台（老报表） | 联盟新后台（新报表） | 说明 |
淘宝客推广 第三方服务商推广 | 所有订单 | 若还需要区分第三方推广的，则在“推广者身份”中进行标识 |
淘宝客维权退款 第三方服务商维权推广 | 维权退款订单 | |
 |  |
2、增加“付款时间”的查询。联盟订单明细，都是订单付款后，才会在报表中展现，故按付款时间获取订单，会更方便查询
3、下载报表内，增加“淘宝付款时间”字段的透出，方便与淘宝下单时间做比对
4、新增字段“提成”。提成=收入比率*分成比率，指实际获得收益的比率，可以快速对账
5、若订单发生维权退款，则也会在所有订单中，进行标识，点击可查看详细维权信息
更多字段的详细解释，可以看：推广订单明细旁边的“订单名词报表解释”https://mo.m.taobao.com/orderdiPC
联盟APP端具体优化点：
报表分类统一为：所有订单、维权推广订单
所有体验流程、名词解释与电脑端均保持一致，体验更佳
更多字段的详细解释，可以看：推广订单明细旁边的“？” https://mo.m.taobao.com/orderdi(相比PC会更精简一些字段，字段说明均相同)
【淘宝联盟APP下载：http://pub.alimama.com/app.htm (随时随地查看报表，获取消息)】
订单查询API具体优化点：
提供全新的API： taobao.tbk.order.details.get 淘宝客【推广者】所有订单查询/ 对应权限包：淘宝客【推广者】推广订单及数据查询 【点击查看API接入文档】
订单API如何获取：订单查询API获取规则【点击查看】 appkey若已有旧版API且近60天有调用的已经同步开通权限(每周会进行一轮校验，若有调用则同步开通权限)
注意：目前新api中，“order_scene”入参目前只支持1常规订单的透出，2和3的字段预估6月中上旬上线，到时候会通知，所以这部分还需要用老的订单API查询
核心优化点：
增加淘客付款时间维度拉取订单，遍历一次就可以筛选出某一段时间付款的订单，降低按其它时间维度无效的轮询成本；
一次性可以获取全二方、第三方订单
透出端pub、api响应字段进行了统一，且返回字段增加淘宝付款时间，便于对单；
拉取订单的实时性更高，618、双11等大促服务更加稳定、可靠；
翻页性能大幅度提升，可以非常平滑进行翻页拉取订单，不会出现60页以上调用超时或者服务不可用的现象；
字段变更说明：
变动说明 | 老订单查询API：taobao.tbk.order.get | 新订单查询API(本次提供的API)taobao.tbk.order.details.get | 字段说明 |
变更 | price | item_price | 商品价格 |
变更 | num_iid | item_id | 商品id |
变更 | commission | pub_share_fee | 结算预估收入 |
变更 | commission_rate | pub_share_rate | 推广者获得的佣金比率 |
变更 | create_time | tk_create_time | 订单创建的时间 |
变更 | earning_time | tk_earning_time | 订单确认收货后且商家完成佣金支付的时间 |
变更 | tk3rd_type | flow_source | 原第三方服务来源——>名称调整为：产品类型 |
变更 | tk3rd_pub_id | pub_id | 原第三方id——>名称调整为：第三方的账户id |
变更 | auction_category | item_category_name | 商品所属的根类目，即一级类目的名称 |
新增 | tb_paid_time | 订单在淘宝拍下付款的时间 | |
新增 | tk_paid_time | 订单付款的时间，该时间同步淘宝，可能会略晚于买家在淘宝的订单创建时间 | |
新增 | tk_order_role | 身份说明。二方：佣金收益的第一归属者； 三方：从其他淘宝客佣金中进行分成的推广者 | |
新增 | refund_tag | 维权标签，0 含义为非维权 1 含义为维权订单。即如果订单发生维权退款，会给予提示标识。所有的维权推广订单也能在维权推广订单API查询。本API只做提示 | |
新增 | tk_total_rate | 提成比例，提成比例=推广者获得的佣金比例*收入比例 | |
新增 | alimama_rate | 推广者赚取佣金后支付给阿里妈妈的技术服务费用的比率 | |
新增 | alimama_share_fee | 技术服务费=结算金额*收入比率*技术服务费率。推广者赚取佣金后支付给阿里妈妈的技术服务费用 | |
新增 | item_img | 商品图片 |
原文：https://tbk.bbs.taobao.com/detail.html?appId=45301&postId=9169586&qq-pf-to=pcqq.group
加微信咨询