货品区域销售管理

更新时间：2023/04/03 访问次数：21830

一、货品管理
二、仓库基础管理
三、库存管理
四、接口列表

本方案主要面向使用货品和区域仓进行库存/销售管理的商家。后台货品与前台销售的宝贝不同，一个后端货品可以关联多个前台宝贝，更多用于分销场景、多渠道售卖、新零售场景等。天猫支持商家在天猫后台维护自己的仓信息和区域销售的逻辑，解决不同渠道或区域的销售场景。

一、货品管理

货品管理，是指商家将售卖商品的仓储信息同步给天猫，生成货品（与前台销售的商品概念进行区分），同时为了将商家自有仓内的库存实时同步给前端销售商品，需要同步货品与商品的关联关系。

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	库存交易调整

FAQ

关于此文档暂时还没有FAQ

有用(0) 我要提问

淘宝开放平台

商家经营工具-开发指引