文档中心 > 商家经营工具-开发指引

库存同步

更新时间：2024/07/31 访问次数：249922

一、基本库存逻辑
二、库存同步逻辑
三、预扣库存

一、基本库存逻辑

1.淘宝商品库存是SKU维度，单个SKU售卖完不影响该商品的其他SKU售卖。对无SKU的商品，库存即商品数量。

2.淘宝库存扣减逻辑有两种，拍下减库存和付款减库存；因为消费者是可以先拍下商品生成订单而不付款的；库存扣减逻辑会从平台技术上尽量避免超卖，商家请根据商品库存的多少合理设置库存扣减方式。

3.淘宝店铺会存在短时间内大量消费者下单情况，如果是爆款活动或者秒杀类商品建议选择拍下减库存，设置的库存时可以预留少量安全库存。

4.平台有些大促活动会提前报名商品，进行库存锁定，这段期间内不允许再变更库存，接口的库存同步也失败，需要程序内先停止调用，具体禁改时间以平台活动规则为准。

二、库存同步逻辑

此处主要针对多种销售渠道模式的库存同步给出解决方案。

1. 一仓一店

一个实体仓库对应一个淘宝店铺。

优点：逻辑简单，不易超卖

2. 多仓一店

淘宝店库存直接使用商家中台库存，中台库存背后映射多个仓，根据其他仓的库存情况对中台库存做变更。

建议参考一仓一店方案，建立虚拟库存，采用仓内调拨方式补货。如果直接通过接口把中台库存实时与淘宝同步。

3. 一仓多店

方案1：多店采用同一套库存，即淘宝多个店显示相同的商品数量，需设置警戒值，当库存数量低于警戒值时，将所有商品下架处理。

优点：多店统一库存。

缺点：当店铺较多时，库存同步压力大，由于每次更新库存的销售点多，出错率相对增加，无法最大化销售库存。

方案2（推荐方案）：类似一仓一店，使用虚拟库存，采用库内调拨的方式补货。

优点：用API向淘宝同步ERP实时库存时，降低出错率。

缺点：当店铺较少时，管理相对较繁琐。

4. 多仓多店

化繁为简，推荐结合前面两个场景的实现方法。

1）使用到的API

API名称	描述
tmall.item.quantity.update	天猫商品/SKU库存更新接口
taobao.item.quantity.update	宝贝/SKU库存修改
taobao.skus.quantity.update	SKU库存修改（一个商品多个SKU情况下使用该API性能更高）
taobao.items.onsale.get	获取当前商家的在售商品列表
taobao.items.inventory.get	获取当前商家的库存中商品列表
taobao.item.seller.get	获取单个商品详细信息
taobao.item.sku.get	获取SKU详细信息

2）库存变更限制

商品如果参加平台的官方营销活动，类似双十一大促活动，聚划算等，需要提前提报商品和库存，并且根据营销活动规则，商品将无法进行库存变更，或者只能做增量库存更新。为了减少商家库存变更的错误影响，提供了接口 taobao.item.promotion.rule.get 根据商品id获取该商品大促更新规则，需要注意接口中返回的 start_time，end_time，type的结果。因为随着时间推移，已生效的规则可能会失效。未生效的规则，可能会生效，因此遇到不允许修改的规则后，要调用这个API查询活动时间信息。常见规则有SKU锁定规则,下架锁定规则,库存减少锁定规则,库存禁止修改规则,一口价禁止修改规则。

三、预扣库存

预扣库存定义

商品发布时，可以选择扣减库存模式为拍下减库存，付款减库存。对应到库存模式，原先只有拍减和付减。但是拍减存在恶拍情况；付减存在超卖情况。所以库存有第三种模式，预扣库存模式。

拍下时预扣库存，库存从可售库存转为预扣库存。如果消费者在预扣超时时间内（如15分钟）不付款，则释放预扣，转为可售(前端页面库存)，其他消费者还可以购买。如果消费者付款了，那么预扣会被减下去，不会再释放（回补）。

业务限制：由于在15分钟内，消费者已经预定该部分库存，需要商家更改库存时不能低于预扣库存，确保消费者体验。

根据以上商品获取API获取字段with_hold_quantity(预扣库存，即付款减库存的商品现在有多少处于未付款状态的订单)

with_hold_quantity和skus. with_hold_quantity.商家在更新商品库存时,必须保证当前可售库存-预扣库存=消费者可购买数量(页面能展示的库存量)

FAQ

关于此文档暂时还没有FAQ

有用(7) 我要提问

淘宝开放平台

商家经营工具-开发指引