库存同步与超卖防护

库存同步要区分实物、可售与预占，并在下单和释放时验证一致性；频繁刷新库存不能自动防止并发超卖。

本页目录

实物库存、可售库存和预占有什么区别？

仓库货架上的实物数量不一定都能销售。已分配给其他渠道、质检冻结、待报损或已经被订单占用的部分，需要在可售口径中体现。先请仓库和电商业务负责人画出数量之间的关系，再决定商城接收哪个字段。若直接将ERP的总余额当成可售量，消费者看到的可能包含当前不能履约的商品。

预占表示某个业务动作取得了数量使用资格，之后应转成确认或释放。它不是额外增加的库存，也不应因为支付页面刷新而反复累计。订单取消、支付超时、审核拒绝或退款等事件未必都有相同的释放规则。团队必须按实际流程逐项说明，避免以一个“减库存时机”覆盖所有状态。

多仓和多个销售渠道需要额外定义分配范围。总量可以满足需求，但具体仓库无法配送时，下单结果仍可能不可履约。若先由商城承诺销售再交给外部仓库分配，就应讨论分配失败后的处理；若仓库必须即时批准，要确认调用失败时能否继续销售。不同策略会产生不同业务风险，不能仅凭接口更新频率作选择。

共享同一余额时，需要清楚的写入责任。建议先列出收货、发货、盘点、订单预占、取消和人工修正等动作，说明每个动作在哪个系统执行。若ERP和商城都能直接覆盖余额，就可能把其他一侧刚完成的扣减覆盖掉。接口是否双向与数据是否双向拥有是两个不同问题。

一种方法是权威系统维护余额，其他系统发送带业务编号的操作并等待结果。另一种方法是按渠道分配额度，由各渠道在自己额度内交易。还有项目采用本地可售副本配合版本核对。方法应根据业务可接受的延迟、网络条件和对账能力沟通；

商品用例区分管理读取和公开读取，具有创建、修订、审核、上下架与带修订号的批量操作。

这条固定源码事实说明商品业务入口的范围。库存跨系统的一致性，还需检查订单路径、客户仓库接口与运行配置。商品管理支持数量维护不能自动证明跨仓预占、分布式扣减或外部WMS连接器已通过验收。项目应把标准入口和新增协调工程分别列清。

读取页面数量与真正提交订单之间，可能有其他请求完成购买。仅在前端判断“库存足够”无法保证提交阶段仍成立。工程检查应沿着报价、提交、预占、付款与取消追踪数量变化，确认业务操作是否在适当边界内完成条件判断，并能够识别同一个操作的重复执行。

对并发场景，可准备多个请求争用同一规格的隔离测试，观察成功订单、库存变化和失败原因之间是否一致。测试输入由项目实际规则决定，不使用未经验证的性能数值。重点是账目能解释，而非只看请求返回速度。若失败后仍留下预占，应能找到释放责任与恢复方式。

外部库存批准若发生超时，结果可能处于未知状态。不能一边向消费者返回失败，一边把原请求换编号重新提交，否则可能产生多次扣减。应先依据原业务编号查结果，再按照服务清单决定继续、释放或人工确认。消费者重复点击或网络重试也应参与同一语义检查。

“收到一条消息就覆盖余额”隐含消息永远按顺序到达。实际联调应主动交换到达顺序：新余额先到、旧余额后到，看接收方是否能识别旧版本。若接口没有修订或更新时间，需要与数据方确认可靠的排序方式；本地接收时间无法代表业务事件发生时间。

全量快照与增量混合时，要确定快照覆盖到哪个截止点。先应用新增量再用较旧全量覆盖，会让库存回到过去的数值。一个可检查的方案需要保存批次、截止游标、更新版本和处理状态，并说明如何从快照接续增量。记录存在本身不代表自动恢复成功，还需在隔离环境验证。

对更新缺口，先确认是数据源没有产生、传输没有到达，还是接收端校验失败。分别观察最近源版本、最近接收版本和最近应用版本，能比一个“同步时间”更准确定位责任。网络恢复后，也要检查是否仍有未处理或被隔离的记录，不能认为连接恢复就等于数据完整。

下面的检查表描述验证方法，结果列应填写实际证据；不会因为采用这份清单就承诺零超卖。

检查场景	需要观察的关系	留下的证据	未满足时要明确的处理
同规格竞争购买	成功交易、可售变化、预占归属相互对应	业务操作编号与前后数量	拒绝、排队或人工裁决规则
原请求超时后再次查询	查询能区分未处理、已处理与未知	原编号、查询结果、外部回执	不允许盲目换编号扣减
订单取消和支付晚到	付款与释放不会各自继续失控	两类事件的实际顺序和状态	冲突进入指定业务处理
新旧库存事件乱序	旧事件不能无条件覆盖新结果	版本、应用记录、当前余额	隔离或补查权威状态
盘点与在途订单并行	调整后仍能解释未完成预占	盘点依据与交易占用明细	重算或冻结操作的批准

除了正常发货，还应覆盖部分履约、退货重新入库和人工调整。退款不必然意味着商品已经返仓，业务上需要先确认是否应恢复可售量。所有自动动作都应有相应业务条件，避免财务退款回调直接增加库存而产生虚假可售。

先限定商城、规格、仓库或渠道，再选同一个截止时间。将两侧余额、未完成预占、已确认出库和被隔离的更新分别列出。若只比较一个总量，某个仓少记和另一个仓多记可能相互抵消；分组差异比全局总数更能揭示问题。

对账差异需要判断来源，不宜把外部数值一键覆盖回商城。覆盖可能抹掉正在进行的预占或刚收到的订单。修复前应保存差异依据、影响对象和执行时间，再由有权岗位决定处理。修复后回到同一口径复核，并确认未完成交易的后续动作仍有归属。

能接受延迟的展示数量与不能接受错误承诺的订单扣减，应分别设计。若业务要求即时确认外部仓库可用量，调用不可用时的销售策略也必须由业务批准。团队需要在体验、可履约性和运行复杂度之间作具体选择，不能由“实时同步”四个字替代工程方案。

可在系统集成专题核对数据责任，用ERP与WMS需求模板记录库存口径，并通过WMS对接服务讨论预占、状态和验收场景。库存联调属于实际项目工程，

把现状、目标与约束写清，便于核对项目范围。