基础技术
品牌商自研系统对接简介
本解决方案主要面向天猫旗舰店商家对接淘宝开放平台使用，基于开放平台提供商品同步，库存同步，订单同步，物流发货和退款管理等全链路API接口和稳定的云服务，帮助商家完成自有ERP系统的对接，实现商品运营管理，订单履约服务，提升天猫店铺运营效率，降低操作成本。 方案的接入需要商家具备自己的技术人员，并且有自主研发的ERP/电商系统。
平台整合了自研系统对接的所需要的各种方案文档，帮助商家自助快速接入，欢迎使用体验：点击体验 。
一、平台介绍
淘宝开放平台：获取淘宝天猫的店铺数据都通过开放平台提供的各种API能力完成。 需要在开放平台上创建应用（获得appeky）并申请相应的API权限才能获取数据。
聚石塔：为淘系商家系统提供安全云环境，底层都是使用的是阿里云现有云产品。 平台规则要求，对于获取商家或者消费者敏感数据的API接口会限制必须从聚石塔ECS中发起接口调用。
奇门：奇门网关可以让开发者在平台上封装自己的接口来实现不同软件之间的安全稳定的数据互通。 平台规则要求，聚石塔内的程序与商家外部系统传递数据需要通过奇门接口来实现。
二、创建应用
创建商家后台系统应用：点击查看 ，这是专门提供给自研商家使用的应用类型。
需要天猫店铺账号才能进行申请，入驻申请还需要提供产品说明书和自己的研发软件著作权证书（网上搜索相关证书申请流程）。 申请流程由专门的运营同学审核，软著能提供且和企业主体一致基本能通过。
三、基础技术说明
1）API调用说明
接口调用基础技术说明：点击查看，推荐使用SDK来帮助接口调用实现。
API测试工具：点击使用 ，常见错误码排查工具：点击使用 ； 调用日志查询工具：点击使用 。
2）登陆授权
应用授权说明：点击查看， 建议自研商家可以直接通过授权工具来生成sessionkey
授权逻辑说明，三方应用需要通过交易接口获取某商家的订单数据，需要该商家对该应用进行授权，授权成功后平台会颁发唯一的sessionkey（又叫accesstoken），里面记录了商家与应用授权绑定关系， 三方应用调用接口传入这个sessionkey才可以获取该商家的数据。
商家后台系统授权一次有效时间是一年，只能通过重新授权的方式来刷新授权时长。
商家后台系统只允许账号主授权，如果品牌集团旗下多个天猫淘宝店铺，可以在控制台提交授权报备申请，具体说明请 点击查看； 报备成功以后，就可以用该账号进行应用授权生成sessionkey获取数据了。
3）控制台设置
应用基本信息设置：点击查看。
应用安全设置：点击查看。
四、接口调用场景
1) 商品发布： 点击查看。
淘宝天猫的商品属性相对比较复杂，每个店铺都只能发布已授权类目的商品，并且淘宝店铺和天猫店铺发布商品是使用不同API，建议可以先通过卖家中心可视化界面进行商品发布，理解天猫产品，商品（宝贝），SKU，商品属性，sku与商品的价格、库存，商家编码等含义在做通过接口做商品发布功能开发。
2) 商品获取：点击查看。
品牌有自己的一套商品编码id，所以在淘宝后台发布商品的时候通过填写商品编码来标识与之的对应关系。而通过API接口获取到商品数据中，outer_id字段就是传入的商家编码，在item和sku结构中都能有。
taobao.items.onsale.get |
获取当前会话用户出售中的商品列表 |
taobao.items.inventory.get |
得到当前会话用户库存中的商品列表 |
taobao.items.custom.get |
根据商家编码取商品 |
taobao.skus.custom.get |
根据sku的商家编码取商品sku |
taobao.item.update |
更新商品信息 |
taobao.item.sku.update |
更新SKU信息 |
taobao.item.seller.get |
获取单个商品详细信息 |
3) 库存同步：点击查看。
商品库存的扣减可以选择 付款减库存（推荐）或者拍下减库存。注意：对于大促活动期间，注意留有安全库存，避免出现超卖。淘宝订单退款也会回补商品库存。
taobao.items.onsale.get |
获取当前会话用户出售中的商品列表 |
taobao.items.inventory.get |
得到当前会话用户库存中的商品列表 |
taobao.item.update.delisting |
商品下架 |
taobao.item.update.listing |
一口价商品上架 |
taobao.item.seller.get |
获取单个商品详细信息 |
taobao.item.quantity.update |
宝贝/SKU库存修改 |
taobao.skus.quantity.update |
SKU库存修改（一个商品多个SKU情况下使用该API性能更高） |
4) 订单同步：点击查看。
淘宝交易整体流程熟悉，对主要的几个交易状态链路了解；需要注意一些特殊订单类型还会有其他的处理逻辑。 以及订单获取的两种方式，使用交易API主动轮询查，和 使用RDS订单推送平台推。
taobao.trades.sold.get |
获取三个月内已卖出的在线订单 |
taobao.trades.sold.increment.get |
增量获取三个月内已卖出的在线订单 |
taobao.trade.fullinfo.get |
获取单笔订单详情品 |
4.1) 订单敏感信息保护：点击查看。
订单中涉及消费者的敏感信息进行脱敏处理，具体脱敏信息字段包含：收件人姓名、收件人手机号、收件人电话(固定号码)、收件人详细地址（不包含省市区）。为了确保商家订单履约正常运行，平台将新增收件人ID字段【简称OAID】 。
5) 物流发货：点击查看。
对等待卖家发货状态的订单可以调用接口进行发货，接口调用成功后淘宝交易订单状态会自动推进到卖家已发货状态。
| taobao.logistics.online.send | 在线订单发货处理（支持货到付款） |
| taobao.logistics.offline.send | 自己联系物流（线下物流）发货 |
6) 退款退货：点击查看。
会涉及具体的资金处理逻辑，设计具体逻辑需要严谨，建议初期商家还是在淘宝卖家中心后台进行退款相关操作，先不使用API。
taobao.refunds.receive.get |
查询退款列表 |
taobao.refund.get |
查询单笔退款 |
taobao.rp.returngoods.refuse |
拒绝退货 |
taobao.rp.returngoods.agree |
同意退货 |
7) 订单发票
推荐两种方案，一种对接阿里发票平台：https://efapiao.taobao.com/ 使用平台功能开具电子发票。
另一种，商家自行开票，通过交易接口返回的实付金额，给消费者开票。
五、聚石塔机器
聚石塔为开发者的应用程序提供更稳定和安全的环境，从架构稳定性上建议是商家整套系统都托管在聚石塔云上。前期可以把淘系订单处理代码和接口调用代码部署在聚石塔ECS上，淘宝店铺相关的全部数据存放在聚石塔RDS上，后续再完全迁移。
购买聚石塔机器的账号要和创建应用的淘宝账号一致， 平台会校验应用与机器的绑定关联关系。
聚石塔机器购买流程完整说明：点击查看。
1）ECS快速入门 点击查看。
具体机器配置性能建议根据实际情况决定，参考值：请求量每秒20左右话，一般1-2台4核8G机器。
2）RDS快速了解 点击查看。
对商家来说，入驻聚石塔主要就是需要把交易订单获取和数据处理的代码托管在聚石塔ECS，数据存储在RDS上，这些涉及到订单数据获取的接口不能在聚石塔之外调用。
3）缓存快速了解 点击查看。
电商大促场景下会出现上十倍激增流量访问，或者秒级大量下单会对的库存和订单系统带来巨大压力，云数据库Redis能承载高QPS读取压力，满足电商高并发场景。
4）订单推送服务： 点击查看。
使用聚石塔RDS数据库服务，可以再开通订单推送服务，把订单数据以及状态变化同步推送到RDS数据库特殊表中，不用再轮询交易订单来查询订单。目前已经支持订单和商品数据推送。
六、自有系统的数据互通
在聚石塔内实现一个奇门接口服务端，在外部独立系统里面发起奇门接口调用； 也可以在外部独立系统里面实现奇门接口服务端，聚石塔内发起调用。
第一种方式：使用奇门的塔内外数据互通，接入说明 ；可以使用线上ERP-线下ERP奇门官方场景 ， ERP-POS奇门官方场景 ，ERP-WMS奇门仓储场景 ；针对商家必须的场景，可以通过这种奇门方式来与商家本地自有系统做淘系电商数据互通，其他情况淘系敏感数据（交易订单信息，消费者姓名、手机、收货地址等个人信息）不允许拿出聚石塔。
第二种方式：使用奇门自定义场景：点击查看 ； 自定义接口，可以把商家需要的其他非敏感业务字段定义在奇门接口入参和返回参数上，来完成其他业务场景的数据互通同步。
七、涉及费用说明
1）开放平台技术服务费：点击查看 ，包括API调用费用和订单推送费用，按照实际产生的API和推送量收费。
发票申请， 在开发者控制台--个人中心—发票申请， 点击就可以申请API费用和订单推送费用的发票，当月可开发票金额等于扣款时间发生在当月的实扣金额。
2）聚石塔机器费用， 根据实际购买的云产品类型、型号和时间周期决定，在云资源购买的页面上会根据用户选择透出实际的云产品价格。
聚石塔发票申请，在聚石塔控制台点击费用中心，可以看到发票申请入口。
八、更多场景
淘宝小程序是淘宝提供的一种新开放模式，在手淘app上面向消费者提供服务，通过丰富的组件与开放能力，为商家提供链接消费者的新媒介，通过互动、娱乐、游戏等方式，提升消费者的品牌粘性和转化率。商家自研小程序接入详细说明：点击查看 。
九、服务咨询
可以走开放平台支持中心提交工单 ，点击访问 ； 也可以智能小开自助服务，点击使用。
接入相关咨询可以提交“平台接入” 类目， 具体接口调用问题可以提交“API调用”类目， 聚石塔机器相关问题可以提交“云服务器 ECS” 类目。