一、业务背景介绍

业务背景 

同城零售共享库存业务为合作伙伴与天猫超市合作的寄售O2O业务，合作伙伴作为天
猫超市的供应商入驻天猫超市并给天猫超市供货，天猫超市作为销售主体给C端顾客销售。 
本文档主要为支持商家接入共享库存业务（主数据上行与订单下行）提供的接口和接入方案说明文档

二.商家接入流程

商家接入流程几大部分：商家合作意向确认、供应商入驻、方案评估确定接入方式、系统对接、线上商家setup、线上试单。

2.1商家合作意向确认 
商家与天猫超市合作模式（寄售）确认，签署合同确认合作。

2.2供应商入驻 
商家按照同城零售业务方的指导完成系统上的天猫供应商的入驻，包括签署框架协议、品牌
授权等操作。

2.3方案评估 
共享库存接入解决方案架构师和商家沟通接入方案，确定商家接入方案。

三、 系统对接 

同城零售技术接入框架

TOP接入流程 （开发者入驻）按照下面提供的文档链接进行入驻。

TOP开放指导：https://hema.open.taobao.com/doc.htm?docId=107424&docType=1

奇门接入流程

奇门入住指导：https://hema.open.taobao.com/doc.htm?docId=108926&docType=1

TMC接入流程

TMC接入流程：https://open.taobao.com/doc.htm?docId=101663&docType=1

接口介绍

3.1 类目对接，商品对应分类

类目最多支持四级目录 类目新建之后T+1生效 ,当天上传类目后需要等第二天8点后才能上传商品资料；

3.2商品对接

商家通过 ERP 对接共享库存提供商品发品接口把商品信息发布到同城零售商家后台，商家
同城零售共享库存接口说明文档 
补充共享库存所需必备属性后，发布商品到天猫超市商品后台，天猫超市商品运营小二审核
后把商品发布到天猫超市。

3.3 库存对接 
商家通过 ERP 对接共享库存提供库存发布接口把库存信息实时同步到天猫超市，注意，库
存信息一定要准确，否则很容易造成超卖。

3.4 采购价报价
商家通过 ERP 对接共享库存提供的采购价报价接口把采购价实时同步到天猫超市，采购价
为商家向天猫超市提报的结算报价，目前支持接口导入采购价和同城后台手动导入采购价。

3.5营销活动对接 
商家通过 ERP 对接共享库存提供的营销活动同步接口把营销活动实时同步到天猫超市，天
猫超市运营可参考该营销活动进行营销玩法设置。

3.6 正逆向单据对接 
商家使用同城零售提供的拣打系统（轻仓），需要感知订单打包出库与订单退仓入库，商家
可接受共享库存提供的正逆向单据消息，获取订单打包出库与订单退仓入库消息，实时处理
自己ERP内部库存数据并通过共享库存库存接口同步到天猫超市。 
注意正逆向单据中只存在商品的数量信息，不存在价格信息。

关键信息介绍

ReX开放平台与外部的商家对接的时候是使用.包含TOP网关、奇门网关、TMC消息三种模式

网关是指：阿里实现的一套系统，用于官方在网关上开放接口，三方通过网关获取数据。

TOP网关: 主要开放API接口服务，被外部商家ERP调用(ERP----->TOP API )

奇门网关: 主要开放API接口，用于调用外部商家服务(奇门API----->商家服务 )

TMC消息: 消息服务是开放平台为提高应用API调用效率而推出的一种主动推送服务（ From淘宝 ），推送内容包括（淘宝交易、商品、退款等信息），基于该推送服务，应用获取淘宝数据不需再不停轮询API，仅需在接收到淘宝推送的消息时调用API获取即可，大大提高API调用效率和降低API使用费用。同时还提供消息回流服务（ To淘宝 ），应用可将信息回流到淘宝，做商品数源服务等。

From淘宝：即淘宝向外推送淘宝（包括天猫）的交易、商品、退款等官方消息。

To淘宝：即向淘宝回流消息。

appkey&secret：

第三方开发者在开发应用调用ReX开放平台api接口的时候都需要在开放平台申请一个appkey作为应用的唯一标识。secret是与appkey一一对应，类似于个人密码，不能对外泄露。主要用途是在isv发起接口调用的时候对请求参数做md5，防止数据被篡改。

SDK: 淘宝开放平台SDK提供了API的请求封装、摘要签名、响应解释、消息监听等功能，使用SDK可以轻松完成API的调用，API结果的获取，消息的实时监听。

授权：

数据是商家的，而获取数据的应用APPKEY是第三方的。所以数据在给到三方的应用获取的时候需要得到商家的授权。

应用授权，需要登录到同城零售总店后访问授权链接后获取授权（有效期180天，到期前需要重新授权）同城零售中台登录总部

oauth.hemaos.com/authorize?response_type=token&sp=hema&op=topApp&client_id=商家APPKEY

FAQ