只讲核心硬规则，快速上手不迷路。详细操作请查阅各子系统独立手册。
0=总部 20=商户 40=门店/店铺 ·
核心链路：商品→库存→订单→财务 ·
跨店三前提：同商户 + 总部商品 + 本地仓
| 身份 | 编码 | 一句话定位 | 典型用户 |
|---|---|---|---|
| 总部 | 0 | 所有数据可见，统一配置中心 | 运营总监 / 系统管理员 |
| 商户 | 20 | 管理旗下门店/店铺，不可见其他商户 | 加盟商老板 / 连锁区域总监 / 品牌代理商 |
| 门店/店铺 | 40 | 末端销售单元，仅处理本店业务 | 门店店长 / 店铺客服 |
| 维度 | 门店（线下） | 店铺（线上平台） |
|---|---|---|
| 场景 | 到店顾客 · POS开单 | 淘宝/抖店/拼多多等 · 线上订单 |
| 平台编码 | 999（线下） | 100/200/300/400/500/600/700 |
| 必须本地仓 | ✅ 是，强制 | ❌ 否（可云仓代发） |
| 库存校验 | 下单时强校验 | 不强校验 |
| 商品来源表 | erp_warehouse_goods_stock | shop_goods_sku |
| 身份 | 可见范围 | 绝对不可见 |
|---|---|---|
| 门店/店铺 | 本店订单、本店库存、本店营收、共享库存 | 其他门店/店铺数据（共享授权除外） |
| 商户 | 旗下全部门店/店铺数据汇总 + 明细 | 其他商户的任何数据 |
| 总部 | 所有商户、所有门店的全部数据 | —（无死角） |
| 层级 | 维护方 | 能改什么 | 不能改什么 |
|---|---|---|---|
| 总部商品库 | 总部 | SPU/SKU、克重、工费、条码、分类、计价模式 | — |
| 商户定价层 | 总部/商户 | 采购价、建议零售价、金价加成、门店差异化定价 | SPU/SKU规格、克重、条码 |
| 门店/店铺副本 | 系统自动 | 上下架状态、门店零售价（限区间内） | 任何商品基础属性 |
| 属性 | 模式0 | 模式1 |
|---|---|---|
| 计价模式 priceType | 实时计价 = 当日金价×克重+工费 | 一口价 = 固定售价 |
| 库存模式 inventoryMode | 传统SKU共用库存 | 一物一码（每件唯一码） |
| 字段 | 含义 | 判断下单公式 |
|---|---|---|
| usableNum | 可用库存（可销售的实际数量） | usableNum ≥ 下单数量 （只看可用，不看其他） |
| lockedQty | 锁定库存（已下单未出库的占用量） | |
| transitQty | 在途库存（调拨发出未收货） |
| 步骤 | 操作 | usableNum | lockedQty |
|---|---|---|---|
| ① | 创建门店订单 | -N | +N |
| ② | 待发货状态 | 锁定持续占用 | |
| ③A | 取消订单 → 释放 | +N | -N |
| ③B | 发货出库 → 扣减 | 不变 | -N（永久消失） |
| 步骤 | 操作方 | A（调出方） | B（调入方） |
|---|---|---|---|
| ① B申请调拨X要10件 | 门店B | — | transitQty +10 |
| ② A确认发货 | 门店A | usable -10；transit +10 | — |
| ③ B确认收货 | 门店B | transit -10 | transit -10；usable +10 |
| 订单来源 | 平台码 | 库存校验 | 归属 |
|---|---|---|---|
| 线下门店订单（POS） | 999 | ✅ 强制校验 | 创建门店 |
| 线上平台店铺订单 | 100/300/400等 | ❌ 不强校验 | 创建店铺 |
| 码 | 含义 | 可流转到 | 禁止 |
|---|---|---|---|
| 0 | 待付款 | →1待发货 / →11已取消 | — |
| 1 | 待发货 | →2已发货 / →101部分发货 / →11已取消 | — |
| 2 | 已发货 | →3已完成 / →31售后中 | ❌ 不可取消 |
| 3 | 已完成 | →31售后中 | ❌ 不可取消 |
| 11 | 已取消 | 终态 | — |
| 13 | 已关闭 | 终态 | — |
| 阶段 | 操作 | 库存变化 | 财务处理 |
|---|---|---|---|
| ① 调拨申请 | B门店向同商户A门店发起SKU-X调拨申请10件 | B：transit +10 | — |
| ② A发货 | A确认、打包发货给B | A：usable -10，transit +10 | — |
| ③ B入库 | B收货清点、本地仓入库 | A：transit -10 B：transit -10，usable +10 | 商户层按采购价生成内部调货台账（仅做账，不真实转账） |
| ④ B销售 | B用自己本地仓库存正常开单给顾客 | B：usable -N，locked +N | 销售100%归B门店（与普通门店订单完全一致） |
refund_no 为幂等键，同一单号重复回调只处理一次。| 价格层级 | 维护方 | 作用 |
|---|---|---|
| 总部基准价（吊牌价） | 总部 | 所有价格的参照基准 |
| 商户采购价 | 总部→按商户 | 商户从总部"进货"的成本价，各商户可不同 |
| 门店建议零售价 | 总部下发 / 商户在区间调 | 按"门店-SKU"维度，门店导购的标准卖价 |
| 实际成交价 | 开单时确定 | 顾客实付，落库后不可改 |
setScale(2, HALF_UP)。| 类型 | 归属规则 |
|---|---|
| 营收 | 订单创建在哪个门店/店铺 → 归谁（不随发货方变） |
| 成本 | 商品实际从哪个仓库出库 → 归哪个仓所在门店 |
| 费用（快递/包装） | 记在订单归属门店头上，代发则后续内部划转 |
| 售后损失 | 谁的订单谁承担；发货方过错导致的由发货门店承担 |
| 层级 | 能看到 | 核心操作 |
|---|---|---|
| 门店级 | 本店日报、业绩、提成、费用 | 对账、查单、申请退款 |
| 商户级 | 旗下门店营收/成本/毛利汇总 | 审批折扣、内部成本划转、商户对账 |
| 总部级 | 全商户财务总览、资金流水 | 商户结算、平台对账、费用分摊、报表导出 |