本方案主要面向使用货品和区域仓进行库存/销售管理的商家。后台货品与前台销售的宝贝不同,一个后端货品可以关联多个前台宝贝,更多用于分销场景、多渠道售卖、新零售场景等。天猫支持商家在天猫后台维护自己的仓信息和区域销售的逻辑,解决不同渠道或区域的销售场景。
一、货品管理
货品管理,是指商家将售卖商品的仓储信息同步给天猫,生成货品(与前台销售的商品概念进行区分),同时为了将商家自有仓内的库存实时同步给前端销售商品,需要同步货品与商品的关联关系。
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. 逆向流程
阶段一:付款成功卖家未发货,消费者退款成功。
如果使用仓库存销售的商品,库存中心监听交易系统的信息,取消该笔交易订单对应仓占用的库存。 非使用仓库存销售的商品,遵循普通商品库存回补逻辑。
阶段二:卖家已发货,消费者发起退款。退款成功以后平台系统不回补库存,需要商家系统自行处理是否要通过接口回补库存。
四、接口列表
接口涉及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
库存出入库、盘点