注意:以下文档只适用于TOP接口,请谨慎使用!

文档中心 > 基础技术

货品区域销售管理

更新时间:2023/04/03 访问次数:15571

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


一、货品管理


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


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创建。

注意:创建时仓库编码不允许重复,创建后也不允许再更改。也可走商家后台创建仓库:点击查看


image.png

 

2. 更改仓库基础资料


创建后当仓库基础资料有变更时,比如当仓库的名称和地址有发生变化,可通过接口taobao.inventory.warehouse.manage修改。也可在仓库列表页选择对应的仓点击编辑仓库。


3. 查询仓库基础资料


创建后可按照仓库编码条件,通过taobao.inventory.store.query接口查询仓库基础资料。


4. 维护仓库覆盖范围


页面链接:点击此处跳转

进入仓库列表页,创建仓库后,对于存在区域销售的情况,需要维护仓库的覆盖范围,且仓库的覆盖范围允许存在交叉的情况。


image.png


左侧选择需要编辑范围的仓库,右侧点击编辑覆盖范围,弹出如下窗口,勾选地址代表即可销售覆盖,最细可以维护至县区粒度;


image.png


三、库存管理


这里会介绍,当仓库发生采购收货、发货、退仓出库、退货入库、仓间调拨、盘点业务时,如何同步天猫库存。 商家仓库发生天猫交易时,如何同步天猫。天猫系统会将可用库存(商家仓库存-预扣库存-占用库存)同步给detail页面展示给消费者,同时客户下单付款时也会校验商家仓库存是否充足。商品关联货品后,商品的库存来自货品对应的仓库数据。


1. 货品库存调整


更新货品对应的仓库存接口:taobao.inventory.merchant.adjust

以仓库维度,即一次性只能修改单个仓库的若干个货品的库存。前台宝贝展示的销售库存以仓库中的货品库存数量做展示。


2. 库存交易调整


对于区域销售商品,库存中心会监听交易消息,若监听到交易订单的状态变更为卖家已发货,会自动确认之前已经占用的库存。

对于非区域销售的商品,需要商家自己通过货品库存调整接口来同步各个仓的库存变化情况。


3. 库存变化逻辑说明


image.png


示例:


步骤

操作

商家仓可用库存

预扣数量

占用数量

可售库存

备注

调用方

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
返回
顶部