淘宝卖家订单商品oAuth2.0接口解决方案

为了进行淘宝/天猫平台卖家订单商品oAuth2.0开发，首先我们需要做下面几件事情。
1、注册一个开发者账号
2、然后为每个淘宝应用注册一个应用程序键（App Key)
3、下载淘宝/天猫API的SDK并掌握基本的API基础知识和调用
4、利用SDK接口和对象，传入AppKey或者必要的时候获取并传入SessionKey来进行程序开发。
5、利用淘宝开放平台的文档中心和API测试工具，对接口进行测试。从而了解返回信息，方便程序获取。
6 、无需以上五点，可点击注册获取Key和secret

方式一：卖家接口（cookie方式）
商品接口
上下架
商品信息
商品发步
商品编辑（未公开）
订单接口
订单列表
订单详情
PC端安装Chrome插
手机端安装App（未公开）

方式二：卖家接口（oAuth2.0方式）

1. 订单接口列表
   物流管理包 https://open.taobao.com/api.htm?docId=10915&docType=2&scopeId=11860
   退款流程接入 https://open.taobao.com/api.htm?docId=28206&docType=2&scopeId=12503
   物流基础信息查询 https://open.taobao.com/api.htm?docId=59&docType=2&scopeId=14878
   卖家地址库管理 https://open.taobao.com/api.htm?docId=10683&docType=2&scopeId=14876
   商品类目属性 https://open.taobao.com/api.htm?docId=13&docType=2&scopeId=383
   获取单笔交易信息 https://open.taobao.com/api.htm?docId=47&docType=2&scopeId=14943
   退款管理包 https://open.taobao.com/api.htm?docId=51&docType=2&scopeId=11850
   物流订单查询 https://open.taobao.com/api.htm?docId=234&docType=2&scopeId=12141
   物流发货 https://open.taobao.com/api.htm?docId=10687&docType=2&scopeId=12139
   订单编辑 https://open.taobao.com/api.htm?docId=48&docType=2&scopeId=12147
   订单信息查询 https://open.taobao.com/api.htm?docId=46&docType=2&scopeId=12146
   退款退货 https://open.taobao.com/api.htm?docId=22465&docType=2&scopeId=11527
   评价信息更新 https://open.taobao.com/api.htm?docId=56&docType=2&scopeId=12137
   评价信息查询 https://open.taobao.com/api.htm?docId=55&docType=2&scopeId=12136
   电子面单 https://open.taobao.com/api.htm?docId=23869&docType=2&scopeId=12142
   卖家信息查询 https://open.taobao.com/api.htm?docId=21349&docType=2&scopeId=12145
2. 商品接口列表
   产品管理包 https://open.taobao.com/api.htm?docId=4&docType=2&scopeId=14894
   商品类目属性 https://open.taobao.com/api.htm?docId=13&docType=2&scopeId=383
   店铺信息查询 https://open.taobao.com/api.htm?docId=64&docType=2&scopeId=386
   店铺信息更新 https://open.taobao.com/api.htm?docId=66&docType=2&scopeId=11400
   退款管理包https://open.taobao.com/api.htm?docId=51&docType=2&scopeId=11850
   Schema商品发布 https://open.taobao.com/api.htm?docId=23255&docType=2&scopeId=11430
   商品价格更新 https://open.taobao.com/api.htm?docId=10927&docType=2&scopeId=14276
   商品上下架 https://open.taobao.com/api.htm?docId=31&docType=2&scopeId=12165
   卖家商品查询 https://open.taobao.com/api.htm?docId=18&docType=2&scopeId=382
   商品同步 https://open.taobao.com/api.htm?docId=24625&docType=2&scopeId=12138
   商品编辑 https://open.taobao.com/api.htm?docId=21&docType=2&scopeId=12166
   卖家信息查询 https://open.taobao.com/api.htm?docId=21349&docType=2&scopeId=12145
   图片管理 https://open.taobao.com/api.htm?docId=137&docType=2&scopeId=12161
   3.交易API
   taobao.trades.sold.get 查询卖家已卖出的交易数据
   taobao.trade.get 获取单笔交易的部分信息(性能高)
   taobao.trade.memo.add 对一笔交易添加备注
   taobao.trade.memo.update 修改交易备注
   taobao.trade.fullinfo.get 获取单笔交易的详细信息
   taobao.trade.close 卖家关闭一笔交易
   taobao.trades.sold.increment.get 查询卖家已卖出的增量交易数据
   taobao.trade.shippingaddress.update 更改交易的收货地址
   taobao.trade.receivetime.delay 延长交易收货时间
   taobao.trade.postage.update 修改交易邮费价格
   taobao.trades.sold.incrementv.get 查询卖家已卖出的增量交易数据
   4.物流API
   taobao.logistics.online.send 在线订单发货处理（支持货到付款）
   taobao.logistics.offline.send 自己联系物流（线下物流）发货
   taobao.logistics.companies.get 查询物流公司信息
   需要开通服务（按年）
   需要订购（淘宝服务市场）/每个店铺
   R2权限可以读取未脱敏的数据
   类目接口
   可点击注册获取key和secret

应用场景
运营淘宝、提高宝贝权重、对接erp系统、对接品牌卖家、自动下单、批量处理订单、订单信息同步、代购业务
买家接口（ cookie方式）
购物车接口
生成订单接口（未公开）
支付订单接口（未公开）
修改订单留言
收货地址接口
买家订单列表、详情、物流
买家接口（ oAuth2.0方式【不提供】，cookie方式实现）
背景
订单是卖家的核心数据，卖家的很多日常工作都是围绕着订单展开，应用的基本功能就是要保证订单实时、完整的展示在卖家面前。由于API请求依赖于网络，存在 着网络不稳定和同步时间长的问题，所以应用必须把淘宝的订单数据同步到本地。如何才能快速、完整的把订单同步到本地是本方案将要讨论的问题。
在线订单：卖家三个月内已卖出的订单。
增量订单：相对已经同步到本地的订单，凡是在淘宝上发生了变更的订单就是增量订单。
消息服务：一种通过HTTP长连接实时向客户端（应用）推送数据（交易）变更的渠道。
经验分享
漏单问题：
1、 通过taobao.trades.sold.get和taobao.trades.sold.increment.get获取订单时，交易类型type入参默认只查询部分类型的订单，要查询所有类型的订单，必须显式提供所有交易类型作为type入参。

2、 通过taobao.trades.sold.increment.get获取增量订单时，返回结果是按订单修改时间倒序排序的，分页必须从后往前翻，防止正向翻页过程中订单发生变更而导致漏单。

3、通过taobao.trades.sold.increment.get获取增量订单时，每次获取的起始时间适当前移10分钟左右（双11大促时建议前移30分钟左右），防止极端情况下由于淘宝系统压力而导致订单延迟更新到数据库而产生的漏单。
4、 通过主动通知接收订单变更消息时，需要处理服务器重启或网络断开连接而导致的消息丢失问题，详细内容请查看消息服务。

性能问题：

taobao.trades.sold.get获取三个月已卖家的订单

1、采用入参use_has_next=true的分页方式可以避免每次API请求对淘宝数据库产生的count(*)，从而显著提升速度和稳定性。

2、由于获取三个月内的订单接口是用创建时间过滤的，而创建时间是不可变的，所以从前往后翻页也不会导致漏单，因而可以省掉第一步的count(*)，而直接采用入参use_has_next=true的方式分页获取，直到返回结果中has_next=false时终止翻页。

3、如果接口返回的字段无法满足应用的需要，则强烈建议只获取fields=tid这一个字段，然后再通过taobao.trade.fullinfo.get获取订单详情。

4、由于卖家三个月订单量比较大，建议把三个月的订单切分成按天获取，减少单次请求对淘宝数据库的记录扫描量，以提升效率。

taobao.trades.sold.increment.get获取增量订单

1、采用入参use_has_next=true的分页方式可以避免每次API请求时对淘宝数据库产生的count(*)，从而显著提升速度和稳定性。

2、由 于获取增量订单接口是用修改时间过滤的，而修改时间是可变的，所以需要从后往前翻页才能避免漏单。从后往前翻页必须要知道最后一页，所以必须在首次API 请求时采用use_has_next=false方式统计订单总数，计算出总页数，然后再设置use_has_next=true终止订单统计，从后往前 翻页。

3、 如果接口返回的字段无法满足应用的需要，则强烈建议只获取fields=tid这一个字段，然后再通过taobao.trade.fullinfo.get获取订单详情。

4、使 用taobao.trades.sold.get/taobao.trades.sold.increment.get只获取tid字段时，建议设置 page_size为最大值，减少API请求次数，提升效率。获取多个字段时可根据自身的网络情况设置page_size，建议设置为50左右。

异常处理：

1、同步订单一般会采用多线程处理，由于API请求对APP是有频率限制的，所以设置线程池大小时，需要根据TOP允许的API调用频率来设置，避免限流后导致应用长时间无法调用API。

2、对于API返回的ISP类型的错误或网络连接错误，应用线程应该在休眠片刻中自动重试。而对于API返回的ISV类型的错误，应用需要记录日志以便日后排查，同时不要重试。