WAREHOUSE TYPES
仓库分类
一套系统管好总部仓、门店本地仓、三方云仓全部库存。
总部仓（LOCAL）
总部自有仓库（merchant_id=0, shop_id=0），是电商发货与渠道供货的核心货源。
门店本地仓（LOCAL）
每个门店一个本地仓，shop_id 隔离。POS收银、即时零售必须依赖本地仓库存，有可用库存才能售卖。
系统云仓（CLOUD）
系统内云仓托管，商品入云仓发货，库存自动同步，适合多仓协同的轻资产商家。
京东云仓（JDYC）
京东云仓直连（仓配一体），库存实时同步，订单推仓执行 + 及时取回出库单，全程自动化。
吉客云（JKYYC）
第三方仓对接（吉客云），定时拉取出库回执，out_no 去重，库存商品自动建档同步。
供应商仓（代发）
供应商直接发货（300），商品在供应商仓库，订单推给供应商执行，无需自己备货。
STOCK LAYERS
库存三层体系
仓库 → 商品库存 → 批次库存，三层递进追踪，每一件商品"从哪来到哪去"。
ATOMIC LOCK
原子锁库 · 防超卖
锁定/释放/扣减全流程使用原子 UPDATE + 条件判断，彻底杜绝"先查后改"的并发问题，1件商品也不会多卖。
| 操作 | 前置条件 | 原子SQL动作 | 说明 |
|---|
| 订单锁定 | current_qty - locked_quantity >= qty | locked_quantity += qty | 锁定可用库存 |
| 总库存锁定 | usable_num - locked_quantity >= qty | usable_num -= qty, locked_quantity += qty | 锁定不占可用 |
| 释放 | — | locked_quantity = GREATEST(0, locked_quantity - qty) | 取消/关闭订单 |
| 扣减 | — | total_num -= qty, locked_quantity -= qty | 实际出库扣减 |
STOCK LIFECYCLE
库存生命周期
创建订单锁定库存，取消自动释放，发货出库扣减，全程不泄漏。
IN & OUT
出入库两层架构
业务层（erp-api）发起单据，仓库层（wms-api）实际执行，本地仓与三方云仓差异化处理。
业务层（erp-api）
- 采购收货 / 退货入库 / 盘盈入库 / 调拨入库
- 销售出库 / 采购退货 / 盘亏 / 调拨出库
- 统一通过接口生成仓库层单据或三方云仓API
仓库层（wms-api）
- 实际入库：erp_warehouse_stock_in 执行入库 + 库存回补
- 三方云仓：三方云仓API → 云仓执行后 → 回执取回写库存
- 批次明细与位置（position）记录
BATCH & FIFO
批次追溯 · FIFO · 一物一码
批次管理与高价值商品（如珠宝）的精细库存管理能力。
批次管理
入库自动生成批次，每批次记录生产日期、成本价、来源，出库按批次扣减，货源去向全程可追溯。
FIFO 先进先出
出库自动按入库时间顺序扣减批次，成本核算准确、先进先出，避免商品积压过期。
一物一码
单品级追溯（barcode/goldWeight/certificate_no），Excel导入自动创建商品与批次，适合珠宝等高价值品类。
TRANSFER
调拨一体化 · 三种场景
总部直调 + 门店申请双模式，无论总部仓、门店A还是门店B，全程状态机自动流转。
| 状态 | 含义 | 触发 |
|---|
| 1 | 待审核 | 门店申请创建（is_direct=0） |
| 2 | 已审核 / 已锁库 | 总部直调直接创建；门店申请经审核 |
| 3 | 已发货 | 调出方确认出库（面单可选） |
| 5 | 已完成 | 调入方确认入库（type=6 调拨入库） |
| 6 / 9 | 已取消 / 已驳回 | 取消或审核不通过 |
CLOUD SYNC
三方云仓协同
与京东云仓、吉客云自动协同，库存状态无需人工干预。
吉客云（JKYYC）
- JkyStockOutPullTask 定时任务自动拉取出库回执
- 按 out_no 去重，goodsNo 自动创建云仓商品
- 库存同步（JkyGoodsStockTask）
- 拉取批次自动推进库存状态
京东云仓（JDYC）
- 库存实时同步 + 商品建档（JdlGoodsStockTask）
- 订单推仓执行 + 及时取回出库单
- 仓配一体，全程自动化
STOCKTAKE & ALERT
盘点与预警
库存账实一致性与安全库存保障。
库存盘点
- 实盘录入实盘数 → 系统自动生成差异
- 审核后自动生成盘盈入库（type=3）或盘亏出库
- 差异明细可追溯，账实调整有据可查
库存预警
- 商品设置 low_qty / high_qty 安全库存阈值
- 低于阈值自动触发预警通知（Webhook）
- 预警驱动补货与调拨，避免缺货断货
库存精细，心中有数
原子锁库防超卖、批次FIFO、一物一码、调拨一体化、云仓协同，为经营提供全链路库存保障。
查看业务场景