基础技术
本方案主要面向使用货品和区域仓进行库存/销售管理的商家。后台货品与前台销售的宝贝不同，一个后端货品可以关联多个前台宝贝，更多用于分销场景、多渠道售卖、新零售场景等。天猫支持商家在天猫后台维护自己的仓信息和区域销售的逻辑，解决不同渠道或区域的销售场景。
一、货品管理
货品管理，是指商家将售卖商品的仓储信息同步给天猫，生成货品（与前台销售的商品概念进行区分），同时为了将商家自有仓内的库存实时同步给前端销售商品，需要同步货品与商品的关联关系。
1. 货品初始化及新增
上线前，需要将商家现有仓储商品信息同步给天猫的货品；当新增货品时，调用天猫接口创建货品。创建成功，会返回天猫的货品ID。接口为：taobao.scitem.add
注：调用taobao.scitem.add 创建天猫货品，若是区域销售商品，is_area_sale字段维护成1。
2. 修改货品
上线后，当商家修改货品，同步修改对应的货品信息，调用天猫接口（taobao.scitem.update）修改天猫货品。目前提供按照商品编码或货品ID条件，修改货品。
3. 创建货品与店铺商品的关联
将货品与商品建立关联关系，方便仓储商品库存实时同步给店铺商品。通过接口scitem.map.add完成。
4. 删除货品与店铺商品的关联
货品与商品关联关系建立错误，需要先删除当前的关联关系，然后再建立正确的关联关系。通过接口scitem.map.delete删除关系。
5. 查询货品
当商家需要查询货品，调用天猫接口（taobao.scitem.query\taobao.scitem.get\taobao.scitem.outercode.get）。
6. 货品关联关系查询
需要查询货品与商品关联关系，通过接口scitem.map.query查询，传入商品ID，如果需要查询单个SKU则传入商品SKUID。接口会返回与商品关联的所有货品映射关系关系。
根据货品ID查货品：taobao.scitem.get。
根据查询条件查货品：taobao.scitem.query。
二、仓库基础管理
商家有自己的仓库基础资料，但是实际应用时，会将现实仓库的库存划分，划分为线上和线下，相当于建立了逻辑仓库。商家只需要将划分给大淘宝的逻辑仓的基础资料同步给天猫。
1. 建立仓库基础资料
商家将同步给大淘宝库存对应的仓库资料，同步给天猫，通过接口taobao.inventory.warehouse.manage创建。
注意：创建时仓库编码不允许重复，创建后也不允许再更改。也可走商家后台创建仓库：点击查看。
2. 更改仓库基础资料
创建后当仓库基础资料有变更时，比如当仓库的名称和地址有发生变化，可通过接口taobao.inventory.warehouse.manage修改。也可在仓库列表页选择对应的仓点击编辑仓库。
3. 查询仓库基础资料
创建后可按照仓库编码条件，通过taobao.inventory.store.query接口查询仓库基础资料。
4. 维护仓库覆盖范围
页面链接：点击此处跳转。
进入仓库列表页，创建仓库后，对于存在区域销售的情况，需要维护仓库的覆盖范围，且仓库的覆盖范围允许存在交叉的情况。
左侧选择需要编辑范围的仓库，右侧点击编辑覆盖范围，弹出如下窗口，勾选地址代表即可销售覆盖，最细可以维护至县区粒度；
三、库存管理
这里会介绍，当仓库发生采购收货、发货、退仓出库、退货入库、仓间调拨、盘点业务时，如何同步天猫库存。 商家仓库发生天猫交易时，如何同步天猫。天猫系统会将可用库存（商家仓库存-预扣库存-占用库存）同步给detail页面展示给消费者，同时客户下单付款时也会校验商家仓库存是否充足。商品关联货品后，商品的库存来自货品对应的仓库数据。
1. 货品库存调整
更新货品对应的仓库存接口:taobao.inventory.merchant.adjust 。
以仓库维度，即一次性只能修改单个仓库的若干个货品的库存。前台宝贝展示的销售库存以仓库中的货品库存数量做展示。
2. 库存交易调整
对于区域销售商品，库存中心会监听交易消息，若监听到交易订单的状态变更为卖家已发货，会自动确认之前已经占用的库存。
对于非区域销售的商品，需要商家自己通过货品库存调整接口来同步各个仓的库存变化情况。
3. 库存变化逻辑说明
示例：
步骤 |
操作 |
商家仓可用库存 |
预扣数量 |
占用数量 |
可售库存 |
备注 |
调用方 |
1.1 |
初始状态 |
100 |
0 |
0 |
100 |
天猫系统内部处理 |
|
1.2 |
买家拍下3件，订单A |
100 |
3 |
0 |
97 |
天猫系统内部处理 |
|
1.3 |
A超时15min未付款 |
100 |
0 |
0 |
100 |
天猫系统内部处理 |
|
1.4 |
A超时订单点击付款 |
100 |
3 |
0 |
97 |
重新预扣，延长超时时间 |
天猫系统内部处理 |
1.5 |
A关闭 |
100 |
0 |
0 |
100 |
天猫系统内部处理 |
|
2.1 |
买家拍下3件，订单B |
100 |
3 |
0 |
97 |
天猫系统内部处理 |
|
2.2 |
B付款成功 |
100 |
0 |
3 |
97 |
天猫系统内部处理 |
|
2.3 |
B发货完成 |
97 |
0 |
0 |
97 |
区域销售，库存中心完成； 商家仓的，商家调用交易调整接口 |
多仓场景
步骤 |
操作 |
商家仓可用库存 |
预扣数量 |
占用数量 |
可售库存 |
备注 |
调用方 |
1 |
买家拍下3件，订单B |
100（甲） 100（乙） |
3（甲） 0（乙） |
0（甲） 0（乙） |
97（甲） 100（乙） |
天猫系统内部处理 |
|
2 |
B付款成功，占用在甲仓库 |
100（甲） 100（乙） |
0（甲） 0（乙） |
3（甲） 0（乙） |
97（甲） 100（乙） |
天猫系统内部处理 |
|
3.1 |
商家正常甲仓库发货 | 100（甲） 100（乙） |
0（甲） 0（乙） |
0（甲） 0（乙） |
97（甲） 100（乙） |
天猫系统内部处理，库存中心完成； | |
3.2 |
如果商家线下用乙仓库发货 |
100（甲） 100（乙） |
0（甲） 0（乙） |
0（甲） 0（乙） |
97（甲） 100（乙） |
需要调用接口回传区域仓真实库存情况。 | 商家ERP系统调用接口，修改仓库存为 100（甲） 97（乙） |
4. 逆向流程
阶段一：付款成功卖家未发货，消费者退款成功。
对于区域销售的商品，库存中心监听交易系统的信息，取消该笔交易订单对应的占用库存。
对于非区域销售的商品，调用交易调整单接口（用换仓的方式进行，取消A仓的占用，B仓的发货数量为0）
阶段二：卖家已发货，消费者发起退款。退款成功以后平台系统不回补库存，需要商家系统自行处理是否要通过接口回补库存。
四、接口列表
接口涉及API权限包 分销 。
API接口名称 |
接口名描述 |
taobao.scitem.add |
发布货品 |
taobao.scitem.update |
根据货品ID或商家编码修改货品 |
taobao.scitem.query |
查询货品 |
taobao.scitem.get |
根据商品ID查询货品 |
taobao.scitem.outercode.get |
根据商家编码查询货品 |
taobao.scitem.map.add |
创建前端商品和货品映射关系 |
taobao.scitem.map.query |
查找IC商品和货品的关联信息 |
taobao.fenxiao.products.get |
查询产品列表 |
taobao.scitem.map.delete |
解除货品与IC商品关联 |
taobao.inventory.warehouse.manage |
创建仓库或者更新仓库信息 |
tmall.inventory.query.forstore |
查询后端商品仓库库存 |
taobao.inventory.merchant.adjust |
库存出入库、盘点 |
taobao.inventory.adjust.trade |
库存交易调整 |