聚水潭同步线下门店库存需五步：一、配置门店仓基础信息；二、POS系统API实时同步；三、Excel批量导入初始库存；四、部署收银插件实现扫码扣减；五、启用O2O库存池统一调度。
如果您已部署聚水潭ERP并拥有线下实体门店，但门店库存数据未在聚水潭中体现或无法与线上商城实时联动，则说明线下门店库存尚未完成接入同步。以下是实现聚水潭同步线下门店库存的具体操作路径：
一、配置门店基础信息与仓库映射
需在聚水潭系统中为每家线下门店单独创建对应仓库，并设定其类型为“门店仓”，确保后续库存单据可归属至正确物理位置。该步骤是所有同步动作的前提，否则系统无法识别门店库存来源。
1、登录聚水潭ERP后台，进入【基础资料】→【仓库管理】→【新增仓库】。
2、填写门店名称作为仓库名称，选择仓库类型为门店仓，启用状态设为“启用”。
3、在【仓库属性】中勾选“支持O2O门店自提”和“支持门店库存共享”选项。
4、保存后，记录该仓库的仓库编码，后续接口对接与库存导入均需引用此编码。
二、通过POS系统直连聚水潭API同步库存
若门店已部署支持API对接的POS系统（如思迅、商米、科脉等），可启用实时双向库存同步，POS端销售/退货即触发聚水潭库存变更，避免人工干预延迟。
1、在聚水潭【系统设置】→【API管理】中启用库存变更通知接口（inventory.update），获取Token及调用地址。
2、联系POS厂商，在其后台配置“聚水潭库存回传”模块，填入聚水潭提供的API地址、Token及对应门店仓库编码。
3、在POS端设置库存同步触发条件：勾选“销售出库”“退货入库”“盘点调整”三类操作后自动推送。
4、完成配置后，在POS执行一笔测试销售，登录聚水潭【库存查询】页面，筛选对应门店仓，验证库存数量是否实时扣减。
三、使用Excel批量导入门店初始库存
适用于尚未部署智能POS、或仅需一次性初始化库存的场景。该方式不支持后续自动更新，须配合定期手动补录或升级为API对接。
1、从聚水潭【数据工具】→【模板下载】中下载门店库存导入模板（store_inventory_import.xlsx）。
2、按模板要求填写：SKU编码、仓库编码（必须与步骤一中创建的门店仓编码完全一致）、期初库存数量、冻结库存（可填0）。
3、检查无空行、无合并单元格、SKU与仓库编码无全角字符，保存为Excel 97-2003格式（.xls）。
4、返回【数据工具】→【库存导入】，选择文件并指定目标仓库类型为门店仓，点击“开始导入”。
四、部署聚水潭轻量版门店收银插件
针对无专业POS但配备安卓收银平板的小微门店，聚水潭提供免开发的扫码收银插件，通过蓝牙连接扫码枪与小票打印机，直接调用聚水潭云端库存服务完成扣减与记录。
1、在聚水潭【应用市场】中搜索并安装“聚水潭门店收银助手”插件。
2、插件启动后，扫描管理员提供的门店绑定二维码，自动关联对应门店仓。
3、收银时扫描商品条码，插件实时向聚水潭发起库存校验请求，显示“库存充足”方可继续结算。
4、确认收款后，插件自动生成一条类型为“门店销售出库”的单据，并同步至聚水潭【库存流水】列表。
五、启用聚水潭O2O库存池统一调度
当多个门店接入后，可开启库存池模式，将各门店仓库存聚合为虚拟总仓，支撑“就近发货”“跨店调拨”“线上下单、附近门店发货”等新零售履约逻辑。
1、进入【O2O设置】→【库存池管理】，点击“新建库存池”，输入池名称（如“华东直营门店池”）。
2、在成员仓库中勾选已配置的所有门店仓，设置各仓权重（默认按库存量占比）。
3、启用“订单智能分仓”开关，并在【渠道对接】中将小程序/APP订单路由规则指向该库存池。
4、完成设置后，新产生的线上订单将由系统根据库存池内各门店实时库存、距离、运费等因子自动分配履约门店。
