注意：以下文档只适用于TOP接口，请谨慎使用！
注意：以下文档只适用于TOP接口，请谨慎使用！
本解决方案主要面向天猫旗舰店商家对接淘宝开放平台使用，基于开放平台提供商品同步，库存同步，订单同步，物流发货和退款管理等全链路API接口和稳定的云服务，帮助商家完成自有ERP系统的对接，实现商品运营管理，订单履约服务，提升天猫店铺运营效率，降低操作成本。 方案的接入需要商家具备自己的技术人员，并且有自主研发的ERP/电商系统。
平台整合了自研系统对接的所需要的各种方案文档，帮助商家自助快速接入，欢迎使用体验：点击体验 。
淘宝开放平台：获取淘宝天猫的店铺数据都通过开放平台提供的各种API能力完成。 需要在开放平台上创建应用（获得appeky）并申请相应的API权限才能获取数据。
聚石塔：为淘系商家系统提供安全云环境，底层都是使用的是阿里云现有云产品。 平台规则要求，对于获取商家或者消费者敏感数据的API接口会限制必须从聚石塔ECS中发起接口调用。
奇门：奇门网关可以让开发者在平台上封装自己的接口来实现不同软件之间的安全稳定的数据互通。 平台规则要求，聚石塔内的程序与商家外部系统传递数据需要通过奇门接口来实现。
创建商家后台系统应用：点击查看 ，这是专门提供给自研商家使用的应用类型。
需要天猫店铺账号才能进行申请，入驻申请还需要提供产品说明书和自己的研发软件著作权证书（网上搜索相关证书申请流程）。 申请流程由专门的运营同学审核，软著能提供且和企业主体一致基本能通过。
在创建应用之前，商家需要先完成开放平台生态伙伴入驻，具体步骤如下：
1） 打开淘宝开放平台官网首页 https://open.taobao.com，了解平台最新重点开放的业务类型、开放能力、以及各开放业务入驻规则和流程等信息，然后点击"立即入驻"进入伙伴工作台。
2） 登陆淘宝账号，完成"实名认证"：请先完成"登陆淘宝账号"对应的"支付宝账号"绑定，然后点击"企业身份入驻"进行身份选择。绑定的支付宝需与登陆淘宝账号注册的支付宝一致。
3） 选择"自研商家"身份进行入驻：若接入后是自主研系统对接商品、订单、售后管理及物流发货等场景，请选择此身份。
4） 根据流程指引，依次完成风控安全扫描、企业资料填写，即可完成入驻。
5） 入驻成功后，即可进入生态伙伴工作台。
1） 必须为公司身份（支付宝账号为公司认证）；
2） 仅限于具有开发能力的天猫卖家（淘宝集市卖家不支持接入，推荐在服务市场订购相关应用）；
3） 商家接入只能供自己店铺所用（自己店铺包括自己的一家或多家店铺，必须为同一家公司）；
4） 商家淘宝接口代码须部署在聚石塔的云服务上（入驻聚石塔说明）；
5） 申请入驻需要在产品说明书中提供自研发系统详细功能模块信息（调用API信息和系统架构说明、功能截图、国家软件著作权证书、自研发源代码片段）。
1） 商家接入所申请的应用只能供自己店铺使用，不得绑定他人店铺淘宝账号；
2） 商家接入所申请的APPKEY不得转让给他人使用；
3） 一个公司只能申请创建1个商家后台系统应用；
4） 同集团公司旗下店铺如需使用可以在控制台提交授权报备申请，具体说明请点击查看。
1） 运营商类商家申请调用API，请联系类目小二申请阿里通信应用标签。
2） 商家后台系统仅面向自研发OMS/ERP开放，软著必须是OMS/ERP软著。
3） 商家后台系统面向自研发OMS/ERP开放，系统需要包含订单处理（订单审核、订单发货）相关功能，包含但不限于订单转单、订单客审、通知配货环节。
4） 软件著作权人与支付宝实名认证不一致，如为同一集团，请附加在说明书内提供控股关系证明。
5） 系统与提供的软著需保持一致。
6） 不支持提供第三方服务商系统。
在生态伙伴工作台点击左侧"开发-创建应用"，按下述路径选择：
商家系统自研接入 -> 一站式电商后台 -> 天猫商家自研 -> 商家后台系统
根据要求提交"产品方案相关资料"申请类目权限，清晰完整的申请材料可提高审核通过率。等待平台小二审核，预计需要3-5个工作日，审核通过即可进入开发。
商家接入后出现以下情况的，平台将对相应商家做出删除当前APPKEY并收回商家接入权限的处罚：
1） 接入的工具/系统并非商家自开发；
2） 将接入的应用提供给他人店铺使用；
3） 将申请的APPKEY转让给他人使用；
4） 入驻申请提供的虚假信息。
注：若您不具备开发能力或者不符合身份要求，又希望使用第三方软件，可以在卖家服务市场订购您需要的软件，由平台三方软件服务商与商家线下软件实现对接打通。
平台详细的运营规则请点击查看。
接口调用基础技术说明：点击查看，推荐使用SDK来帮助接口调用实现。
API测试工具：点击使用 ，常见错误码排查工具：点击使用 ； 调用日志查询工具：点击使用 。
应用授权说明：点击查看， 建议自研商家可以直接通过授权工具来生成sessionkey
授权逻辑说明，三方应用需要通过交易接口获取某商家的订单数据，需要该商家对该应用进行授权，授权成功后平台会颁发唯一的sessionkey（又叫accesstoken），里面记录了商家与应用授权绑定关系， 三方应用调用接口传入这个sessionkey才可以获取该商家的数据。
商家后台系统授权一次有效时间是一年，只能通过重新授权的方式来刷新授权时长。
商家后台系统只允许账号主授权，如果品牌集团旗下多个天猫淘宝店铺，可以在控制台提交授权报备申请，具体说明请 点击查看； 报备成功以后，就可以用该账号进行应用授权生成sessionkey获取数据了。
应用基本信息设置：点击查看。
应用安全设置：点击查看。
API调用有两种方式，一种是基于HTTP协议来调用的，另一种是直接使用平台提供的官方SDK。针对自行封装HTTP请求进行API调用的原理详细解说请点击查看。
1） 登录开发者控制台 -> 开发 -> 我的应用 -> 应用管理；
2） 在证书页面里可以查看已经拥有的权限组数和可申请的权限组数；
3） 在功能场景下查看对应的权限组，可以点击权限组内场景介绍中的详情，查看每个权限组内的API明细。如有需要点击申请权限。
应用创建成功、API权限申请完成之后，进入开发测试阶段。前期开发测试用户可以使用平台API测试工具操作。
应用创建后的状态是"开发中"，开发对接完成后，需要将应用发布上线，否则会影响API调用。
未上线状态的应用API调用限5000次/日，授权用户50个，若三个月未上线将会被删除应用。
在开发者控制台的应用管理页面可看到"未发布上线"和"已发布上线"两种状态，完成对接后请及时提交发布上线。
1) 商品发布： 点击查看。
淘宝天猫的商品属性相对比较复杂，每个店铺都只能发布已授权类目的商品，并且淘宝店铺和天猫店铺发布商品是使用不同API，建议可以先通过卖家中心可视化界面进行商品发布，理解天猫产品，商品（宝贝），SKU，商品属性，sku与商品的价格、库存，商家编码等含义在做通过接口做商品发布功能开发。
新版商品发布/编辑API（推荐）：
| API名称 |
API中文名称 |
| 获取商品发布规则信息 |
|
| 商品发布接口 |
|
| 商品级联属性信息获取 |
|
| 商品编辑获取schema信息 |
|
| 商品编辑提交schema信息 |
|
| 商品编辑增量更新 |
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 |
获取单个商品详细信息 |
补充API（新版上下架 & 批量查询）：
| API名称 |
API中文名称 |
| 商品下架（新版） |
|
| 商品上架（新版） |
|
| 批量获取商品详细信息 |
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性能更高） |
天猫商品库存专用API：
| API名称 |
API中文名称 |
| 天猫商品/SKU库存更新接口 |
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 | 自己联系物流（线下物流）发货 |
新版物流API（推荐，支持一单多包裹）：
| API名称 |
API中文名称 |
| 新版自己联系物流（线下）发货接口，支持一单多包裹 |
|
| 确认发货通知接口（未传入运单号补偿使用） |
|
| 快递公司资源列表查询接口 |
|
| 新版修改已发货订单物流信息接口 |
6) 退款退货：点击查看。
会涉及具体的资金处理逻辑，设计具体逻辑需要严谨，建议初期商家还是在淘宝卖家中心后台进行退款相关操作，先不使用API。
| taobao.refunds.receive.get |
查询退款列表 |
| taobao.refund.get |
查询单笔退款 |
| taobao.rp.returngoods.refuse |
拒绝退货 |
| taobao.rp.returngoods.agree |
同意退货 |
补充退款/退货API：
| API名称 |
API中文名称 |
| 天猫商家回填退款物流单号 |
|
| 审核退款单 |
|
| 拒绝退款 |
|
| 同意退款 |
7) 订单发票
推荐两种方案，一种对接阿里发票平台：https://efapiao.taobao.com/ 使用平台功能开具电子发票。
另一种，商家自行开票，通过交易接口返回的实付金额，给消费者开票。
8) 换货管理：点击查看。
有换货处理功能的自主开发的商家可以对接。主要API列表：
| API名称 |
API中文名称 |
| 卖家查询换货列表 |
|
| 查看换货详情 |
|
| 查询换货留言列表 |
|
| 卖家创建换货留言 |
|
| 获取拒绝换货原因列表 |
|
| 卖家同意换货申请 |
|
| 卖家拒绝换货申请 |
|
| 换货商家确认收货并发货 |
|
| 卖家拒绝确认收货 |
9) 消息服务：点击查看。
消息服务是开放平台为提高应用API调用效率而推出的一种主动推送服务（From淘宝），推送内容包括淘宝交易、商品、退款等信息。基于该推送服务，应用获取淘宝数据不需再不停轮询API，仅需在接收到淘宝推送的消息时调用API获取即可，大大提高API调用效率和降低API使用费用。同时还提供消息回流服务（To淘宝），应用可将信息回流到淘宝，做商品数源服务等。
- From淘宝：即淘宝向外推送淘宝（包括天猫）的交易、商品、退款等官方消息。
- To淘宝：即向淘宝回流消息。
聚石塔为开发者的应用程序提供更稳定和安全的环境，从架构稳定性上建议是商家整套系统都托管在聚石塔云上。前期可以把淘系订单处理代码和接口调用代码部署在聚石塔ECS上，淘宝店铺相关的全部数据存放在聚石塔RDS上，后续再完全迁移。
购买聚石塔机器的账号要和创建应用的淘宝账号一致， 平台会校验应用与机器的绑定关联关系。
聚石塔机器购买流程完整说明：点击查看。
1）ECS快速入门 点击查看。
具体机器配置性能建议根据实际情况决定，参考值：请求量每秒20左右话，一般1-2台4核8G机器。
2）RDS快速了解 点击查看。
对商家来说，入驻聚石塔主要就是需要把交易订单获取和数据处理的代码托管在聚石塔ECS，数据存储在RDS上，这些涉及到订单数据获取的接口不能在聚石塔之外调用。
3）缓存快速了解 点击查看。
电商大促场景下会出现上十倍激增流量访问，或者秒级大量下单会对的库存和订单系统带来巨大压力，云数据库Redis能承载高QPS读取压力，满足电商高并发场景。
4）订单推送服务： 点击查看。
使用聚石塔RDS数据库服务，可以再开通订单推送服务，把订单数据以及状态变化同步推送到RDS数据库特殊表中，不用再轮询交易订单来查询订单。目前已经支持订单和商品数据推送。
数据推送前置准备与RDS版本白名单：
1） 数据推送服务必须拥有开放平台应用（如订单管理、ERP、商家后台系统），如果没有应用请先进行创建应用；
2） 考虑数据安全风险，目前对于无订单管理接口权限的应用暂时无法提供订单推送能力；
3） 数据推送服务目前支持聚石塔控制台购买的张家口地域的云数据库RDS，数据库版本仅且只支持：MySQL 5.5、MySQL 5.6、MySQL 5.7、POLARDB(MySQL 5.6)、SQLServer 2008r2、SQLServer 2012企业版/标准版、SQLServer 2016企业版/标准版、SQLServer 2017企业版/标准版、SQLServer 2019企业版/标准版、SQLServer 2022企业版/标准版。
4） 暂不支持：MySQL 8.0、POLARDB(MySQL 5.7)、POLARDB(MySQL 8.0)、SQLServer 2017/2019/2022 单机版。
如何使用数据推送服务详细说明请点击查看。
在聚石塔内实现一个奇门接口服务端，在外部独立系统里面发起奇门接口调用； 也可以在外部独立系统里面实现奇门接口服务端，聚石塔内发起调用。
第一种方式：使用奇门的塔内外数据互通，接入说明 ；可以使用线上ERP-线下ERP奇门官方场景 ， ERP-POS奇门官方场景 ，ERP-WMS奇门仓储场景 ；针对商家必须的场景，可以通过这种奇门方式来与商家本地自有系统做淘系电商数据互通，其他情况淘系敏感数据（交易订单信息，消费者姓名、手机、收货地址等个人信息）不允许拿出聚石塔。
第二种方式：使用奇门自定义场景：点击查看 ； 自定义接口，可以把商家需要的其他非敏感业务字段定义在奇门接口入参和返回参数上，来完成其他业务场景的数据互通同步。
1）开放平台技术服务费：点击查看 ，包括API调用费用和订单推送费用，按照实际产生的API和推送量收费。
发票申请， 在开发者控制台--个人中心—发票申请， 点击就可以申请API费用和订单推送费用的发票，当月可开发票金额等于扣款时间发生在当月的实扣金额。
2）聚石塔机器费用， 根据实际购买的云产品类型、型号和时间周期决定，在云资源购买的页面上会根据用户选择透出实际的云产品价格。
聚石塔发票申请，在聚石塔控制台点击费用中心，可以看到发票申请入口。
聚石塔发票申请入口：在聚石塔控制台点击"费用中心"，可以看到发票申请入口。详细聚石塔发票管理请点击查看。
淘宝小程序是淘宝提供的一种新开放模式，在手淘app上面向消费者提供服务，通过丰富的组件与开放能力，为商家提供链接消费者的新媒介，通过互动、娱乐、游戏等方式，提升消费者的品牌粘性和转化率。商家自研小程序接入详细说明：点击查看 。
官方服务登记工单功能，用于客服与买家的服务场景或者商家内部协同使用，提供了官方登记表模板和自定义表功能，还提供了API接口，实现三方软件数据与工单高效流转。 点击查看
为营造安全、规范、有序的开发环境，保障开发者（亦称"服务商"）及其用户（即开发者通过应用进行服务的淘宝平台其他用户）的合法权益，依据《淘宝合作伙伴开发协议》、《开放平台基础规范》、《商家服务市场管理规范》、淘宝平台相关规则等内容制定本规范，适用于淘宝开放平台（以下简称"开放平台"）所有开发者及所有应用。
本规范系对《淘宝合作伙伴开发协议》的有效补充。本规范与《淘宝合作伙伴开发协议》有冲突的，以本规范为准。
安全违规行为及处罚规范详情说明请点击查看。
可以走开放平台支持中心提交工单 ，点击访问 ； 也可以智能小开自助服务，点击使用。
接入相关咨询可以提交“平台接入” 类目， 具体接口调用问题可以提交“API调用”类目， 聚石塔机器相关问题可以提交“云服务器 ECS” 类目。
