注意：以下文档只适用于TOP接口，请谨慎使用！
注意：以下文档只适用于TOP接口，请谨慎使用！
1.淘宝商品库存是SKU维度，单个SKU售卖完不影响该商品的其他SKU售卖。对无SKU的商品，库存即商品数量。
2.淘宝库存扣减逻辑有两种，拍下减库存 和 付款减库存 ；因为消费者是可以先拍下商品生成订单而不付款的；库存扣减逻辑会从平台技术上尽量避免超卖，商家请根据商品库存的多少合理设置库存扣减方式。
3.淘宝店铺会存在短时间内大量消费者下单情况，如果是爆款活动或者秒杀类商品建议选择拍下减库存，设置的库存时可以预留少量安全库存。
4.平台有些大促活动会提前报名商品，进行库存锁定，这段期间内不允许再变更库存，接口的库存同步也失败，需要程序内先停止调用，具体禁改时间以平台活动规则为准。
此处主要针对多种销售渠道模式的库存同步给出解决方案。
一个实体仓库对应一个淘宝店铺。
优点：逻辑简单，不易超卖
淘宝店库存直接使用商家中台库存，中台库存背后映射多个仓，根据其他仓的库存情况对中台库存做变更。
建议参考一仓一店方案，建立虚拟库存，采用仓内调拨方式补货。如果直接通过接口把中台库存实时与淘宝同步。
方案1：多店采用同一套库存，即淘宝多个店显示相同的商品数量，需设置警戒值，当库存数量低于警戒值时，将所有商品下架处理。
优点：多店统一库存。
缺点：当店铺较多时，库存同步压力大，由于每次更新库存的销售点多，出错率相对增加，无法最大化销售库存。
方案2（推荐方案）：类似一仓一店，使用虚拟库存，采用库内调拨的方式补货。
优点：用API向淘宝同步ERP实时库存时，降低出错率。
缺点：当店铺较少时，管理相对较繁琐。
化繁为简，推荐结合前面两个场景的实现方法。
API名称 |
描述 |
tmall.item.quantity.update |
天猫商品/SKU库存更新接口 |
宝贝/SKU库存修改 |
|
SKU库存修改（一个商品多个SKU情况下使用该API性能更高） |
|
获取当前商家的在售商品列表 |
|
获取当前商家的库存中商品列表 |
|
taobao.item.seller.get |
获取单个商品详细信息 |
taobao.item.sku.get |
获取SKU详细信息 |
商品如果参加平台的官方营销活动，类似双十一大促活动，聚划算等，需要提前提报商品和库存，并且根据营销活动规则，商品将无法进行库存变更，或者只能做增量库存更新。 为了减少商家库存变更的错误影响，提供了接口 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.商家在更新商品库存时,必须保证当前可售库存-预扣库存=消费者可购买数量(页面能展示的库存量)
