天猫优仓项目实际是在ERP进行订单处理之前，由阿里的优仓系统进行分单和订单的前置处理，再根据是否为自流转订单分别给到ERP和天猫WMS进行发货处理，并针对订单退款时WMS与平台及ERP之间的交互提供了对应的解决方案。

      网店管家对接天猫优仓时，要先确认是自建仓发货模式，还是翱象发货单的发货模式 ，根据发货模式进行相应的设置，下边主要介绍翱象发货单发货模式 的操作说明。自建仓发货模式操作说明参考：

业务说明

简要说明ERP系统、天猫优仓（翱象供应链）、天猫平台三者关系

一、 基础设置

 基于淘宝/天猫要求，开启了优仓业务的商家需要把ERP内的货品、货品与平台货品的匹配关系、系统货品的初始化库存都上传至天猫优仓，并完成天猫优仓和系统仓库之间的匹配，才能进行正常的优仓订单业务流转。 

API中相关设置

1.启用天猫优仓供应链

在【系统】-【店铺目录】，订单下载-下载界面，勾选启用天猫优仓供应链，并勾选下载发货单，如下图所示：

2.自动流转订单设置

在esapi软件中，软件图标如下：

在【系统】-【店铺目录】-选择已开通“天猫优仓”业务的店铺，点击【修改】-【自动流转订单】-【添加菜鸟仓】，设置如下图所示

说明：

（1）这里添加菜鸟仓，只是复用一下之前菜鸟仓自流转业务的逻辑，也适用此次的天猫优仓业务

（2）仓库编码获取方式如下图，可咨询天猫优仓实施人员，由天猫优仓提供

3.库存同步设置

在esapi软件中，软件图标如下：

在【系统】-【店铺目录】，选择已开通天猫优仓业务的店铺，点击【修改】-【库存同步】界面，如图所示进行如下设置

设置仓库匹配如下选择进行设置

4. 商品下载导入网店管家

在esapi的【商品】-【匹配导入】界面，选择已开通天猫优仓业务的店铺

5.商品匹配（主要是为库存同步做准备）

下载并导入商品后，批量选中商品，点击【自动匹配】完成商品匹配 

特别说明：

如果管家货品档案里的部分货品在天猫店铺上没有出售链接，通过API的【匹配导入】无法实现商品匹配，则通过第1.4步的【货品同步】操作会自动把匹配关系添加进来，支持库存同步

管家仓储接口设置

1.天猫优仓基础设置

在菜单【设置】-【接口设置】-【仓储接口设置】里，接口列表选择天猫优仓，如下图所示

说明：

（1）选择翱象货主店铺：选择加入天猫优仓的店铺

（2）翱象货主编码：货主编码由天猫翱象那边提供

（3）发货仓库类型：选择含奇门仓发货

（4）和奇门2.3仓储接口设置里的货主编码填写一样，如下图

（5）商家行业根据店铺类目选择， 默认“综合”。

2.设置仓库匹配

选择需要与三方仓匹配的网店管家中的仓库名称，点击【仓库匹配】，填写仓库编码

WMS仓库编码：由天猫提供

3. 货品同步

1） 奇门2.3接口商品同步（仅新用户即之前未对接过奇门的需要操作此步骤）

在仓储接口列表的奇门2.3接口里操作商品同步，具体操作参考：http://xy.wdgj.com/news/show-297.html ，如果之前已经配置过奇门仓储货品的，略过此步骤

特别说明：

•仅新用户，之前从没对接过奇门的，才需要奇门2.3和天猫优仓里同时进行设置。

• 开通天猫优仓的商家一般都在之前使用奇门对接过委外仓，所以奇门2.3里基本都已经设置过，也有同步货品给自己的委外仓储

2） 单品同步

在天猫优仓的接口列表里【货品同步】界面，通过【刷新数据】筛选并选择需要同步给天猫翱象的货品，点击【货品同步】，把系统中货品档案里的单品同步给翱象。

3）组合货品同步

在天猫优仓的接口列表的【组合货品同步】界面，通过【刷新数据】筛选并选择需要同步给天猫翱象的组合装货品，点击【组合货品同步】，把系统里的组合装货品同步给翱象。

4）库存同步

库存同步实际是把库存同步给翱象，不是直接同步到天猫后台的“出售中的宝贝”，翱象自己会把库存关联到前端页面

在esAPI软件里，在【商品】-【库存同步】菜单的库存同步界面可以手动操作库存同步，或者系统里有库存变动后会自动同步库存。

说明：

• 如果匹配记录里有多个相同管家规格条码的商品，只会同步一条匹配记录的商品，其他匹配记录不需要同步

• 组合装货品不需要同步库存，只需要同步单品库存 

• 如果组合货品中的部分单品或者赠品没有在店铺上售卖，通过下载商品匹配就无法匹配，这种情况通过网店管家物流接口设置的第2步“货品同步”后，会自动往API库存同步界面写入一条匹配记录， 库存同步时同步该商品匹配记录

5） 货品关联和组合装关联

在仓储设置的天猫优仓设置中【货品关联】界面，可以根据管家货品编码或平台商品ID筛选货品，操作货品关联和组合货品关联，实现同步给翱象的货品和前端售卖商品关联。

二、天猫优仓订单处理

1. 下载订单

在API的【订单】-【订单下载】界面可以按条件下载订单，默认是会实时下载订单的

2. 原始单

订单下载后，如果天猫优仓没有第一次分单，订单会在原始单界面，订单状态为“天猫优仓未分单”，此次订单不需要处理，等待天猫优仓第一次分单后，订单状态会自动更新，更新会就会自动递交。

3. 预订单和委外发货

订单递交后，根据第一次分单后的结果，分两种情况

1) 如果是非自流转订单，订单会进入【销售】-【预订单】界面，其中订单类型是“天猫优仓”，且订单会处于冻结状态，等待天猫优仓第二次分单，日志中有记录。

2) 如果是自流转订单，订单会进入到【销售】-【委外发货】界面，订单类型“天猫优仓”

说明：

• 订单客服备注上会自动打上“天猫优仓自流转订单”的备注

• 自流转订单转到委外发货界面后委外状态是“已递交”

4.订单审核和委外发货

天猫优仓第二次分单后，系统会自动获取发货单，解析发货单信息后，订单会按照以下几种情况处理。

1) 如果是非自流转订单，即由商家自己处理发货的订单，订单解冻后会自动由预订单转入订单审核界面，由商家审核发货。

2) 如果是自流转订单，即由天猫翱象下发仓储发货的订单，订单解冻后会转入委外发货界面。商家无需操作。

说明：

• 在委外发货界面等待仓储发货后通过奇门回传发货状态会自动完成发货

• 委外状态是已递交的订单不能修改地址，要修改的话需要右键取消订单，取消成功后才能再修改

• 发生退款或者改地址通知，会自动发起请求翱象接口取消发货，也可以手动右键取消订单，取消成功后订单会变成非自流转订单，商家可以驳回审核对订单进行操作，重新审核再递交到自己的仓储进行发货

• 发生退款了，自流转订单会请求翱象接口重新计算赠品，接口返回的赠品如果和原来绑赠的赠品不一样，赠品取消

5. 订单发货

仓储发货后，通过奇门回传物流公司和物流单号，订单将自动发货完成，同时API将自动同步平台发货，把交易订单改成已发货状态。自流转和非自流转订单都会同步API完成发货。

三、常见问题

1、 原始单订单状态一直显示是“天猫优仓未分单”

原因：该商品缺少商货品关联

解决：在原始单商品里显示平台商品ID和平台规格ID,去API里下载商品并匹配，去设置-仓储接口设置-天猫优仓设置里检查下货品同步和货品关联，重新同步同步一下货品和货品关联。如果订单是非自流转的可以强制递交，由预订单转到订单审核，检查下商品信息直接审核发货。

2、 订单被拆单了

原因：翱象货品和管家系统货品不一致

解决：仓储接口设置里货品或者组合装要去同步一下，再做下货品关联