门店与网店库存怎么同步？先明确 SKU 和可售库存

先统一商品标识

同款不同颜色或尺码要使用独立 SKU。建立门店 SKU 与商城商品规格之间的映射，检查组合商品、赠品和停售商品。名称相同不能作为可靠的唯一标识，条码和外部商品编号也应核对唯一性与归属。

可售库存不是简单的现有数量

现有库存可能包含已预留、待质检或无法销售的商品。商家应写明可售库存的计算方法，哪些仓库供网店销售，以及门店是否保留安全库存。将规则用于一组真实商品，比较门店和网店看到的数量。

例如，Shopify 将在手库存分为可用、已承诺和不可用等状态。已被订单占用或暂不能出售的数量，不应当作可售数量再次推出；在途数量也要与到货后可售数量分开考虑。下方官方资料可帮助团队对照现有网店的库存口径。

选择更新方向并处理竞争

两边都可以修改库存时，要明确冲突时谁拥有优先权。下单、支付、取消和退货各在什么时候扣减或返还，也要有对应规则。批量同步如果覆盖了同步期间的新订单，可能造成错误库存；应保留事件或版本依据。

把失败当成正式流程

列出接口限流、授权失效、商品映射不存在和重复事件的处理方式。同步应能重试，重复执行应避免重复扣减。留出需要人工确认的记录，对照外部平台的库存变化核查，而不是只看内部任务显示成功。

根据经营流程规划商城接入

商城接入应从你的实际经营流程出发，明确商品、销售、取消和退货怎样在两个系统之间衔接。已有 OpenCart 或 Shopify 网店的商家，可以向我们提供平台版本与业务需求，一起规划商品映射、订单处理和库存更新的服务范围。

用一件两规格商品验证库存口径

以同款背包的两个颜色为例：仓库有灰色十件、绿色六件，其中灰色两件已被网店订单预留。若约定可售库存扣除预留，则灰色对外可售是八件；如果再为门店保留两件安全库存，网店展示的数量应是六件。这里的数字仅用于解释口径，不是系统默认计算规则。

让门店再卖出一件灰色背包，检查门店记录与网店数量各在什么时点改变。取消预留订单后，哪些数量应恢复，也应写成预期结果。

哪些异常最值得先测？

先测试没有映射的 SKU、同步期间的新订单、同一订单重复到达，以及外部平台授权失效。再考虑不同仓库、组合商品和退货入库。测试时保留原系统事件、内部处理记录和外部平台最终数量，才能定位是映射、库存计算还是接口调用出了问题。

任务日志显示成功但外部数量没有变化时，不应反复覆盖数据。应先核对调用是否真正执行、是否访问了正确商品与仓库、平台是否接受更新。同时对照网店的商品数量，确认更新结果符合门店设定的库存口径。

为什么要给人工核对留一个入口？

有些差异来自真实业务：商品破损、临时调货、店员盘点调整或退款后商品未回仓。这些情况不能靠“自动同步”一概解决。保留差异原因、来源订单号和处理人，有助于判断应修正业务记录还是重新执行接口任务。

门店推广前应安排一次对账：抽取不同规格、售后与库存调整的商品，比较实物、系统记录和网店可售数量。差异处理规则要让仓库、店长和技术人员都能理解，不能只存在于开发人员的代码注释中。

库存口径先约定

落地检查清单

• 给每个规格建立唯一映射
• 约定仓库与可售库存口径
• 确认扣减、退款和冲突规则
• 验证平台结果与异常重试

参考资料

• Shopify 帮助中心：了解库存状态

  区分在手、可用、已承诺与不可用库存，作为制定可售库存规则的参考。