第6章 商品管理场景
商品是系统的地基。没有 SKU 和价格，采购和销售都开不了单。本章讲怎么把货「上架」到系统里。
入口：左侧菜单 商品（分类管理 / 商品管理 / 商品明细）与 品牌（品牌看板 / 品牌管理 / 品牌类别管理）。
商品主数据的搭建顺序——先分类、品牌，再建 SKU，最后维护价格，然后才能开单：
st=>start: 商品主数据
a=>operation: ① 分类管理（分类树/拖拽排序）
b=>operation: ② 品牌管理（品牌类别→品牌→Logo→年度目标）
c=>operation: ③ 新建 SKU（编码/规格/体积/税/条码）
d=>inputoutput: ④ 维护价格（采购价/销售价/折扣价）
e=>end: 采购开单 / 销售开单 / 商户选购
st->a->b->c->d->e
6.1 维护商品分类
- 商品 → 分类管理，页面是分类树，支持「展开全部 / 收起全部」。
- 顶部 新增分类；树节点行内可 新增子分类 / 编辑 / 删除。
- 分类表单字段：分类名称、英文名、编码、父分类、排序号。
- 支持拖拽调整分类顺序与层级。
分类是 SKU 的归属维度之一，建 SKU 前先有分类。删除分类前先确认其下没有商品在用。
6.2 维护品牌与品牌类别、品牌年度目标
- 品牌 → 品牌类别管理：先建品牌下的细分类目（品牌类别），支持新增/编辑/删除。
- 品牌 → 品牌管理 → 新增品牌：分两步——先填品牌名称，再上传品牌 Logo。
- 品牌卡片行内可 编辑 / 删除；支持按名称搜索。
- 编辑品牌时可维护年度采购目标子表：新增/编辑/删除目标行，每行填年度目标及 Q1–Q4 季度目标。
- 品牌看板会自动汇总各品牌的年销售额、退货率、利润、季度完成度。
品牌年度目标用于品牌看板的目标完成率分析，建议年初就设好。
6.3 新建商品（SKU）与规格
说明：本系统的商品以 SKU（规格）为最小管理单元，没有独立的 SPU 父级。新建一个商品就是新建一个 SKU。
商品列表页的常用操作：
- 顶部 添加商品；搜索框按商品名称搜。
- 筛选条件：分类（多选）、上/下架状态、国家码、自定义分类 1/2/3，点查询过滤。
- 表格行操作：编辑 / 价格 / 折扣 / 删除（价格与折扣打开抽屉，见 6.4）。
新建/编辑商品：
- 商品 → 商品管理 → 添加商品（抽屉表单）。
- 填写字段（以下为关键字段，来自系统数据模型）：
| 字段 | 说明 | 注意 |
|---|---|---|
| SKU 编码 (sku_code) | 业务唯一编码，库存/订单/财务对账的关联键 | 录入后尽量不改 |
| 商品编码 (code) | 系统内部唯一编码 | 自动/手填，唯一 |
| 品牌 (brand_id) | 归属品牌 | 先建好品牌 |
| 规格名称 (spec_name) | 商品名，支持中/繁/英三语 | 多语言分别填 |
| 国家/地区码 (country_code) | 原产国 | 跨境必备 |
| 海关编码 (custom_code) | 报关用编码 | 跨境必备 |
| 自定义分类 1/2/3 | 报关自定义归类 | 按需 |
| UPC / 条码 (upc, barcodes) | 扫码作业用 | 可多个 |
| 单位 (unit) / 计量 (uom) | 售卖单位 | — |
| 单件数量 (unit_count) | 该规格含最小可售单品数 | 默认 1 |
| 体积 (size_value, m³) | 单件体积，立方米 | 必填且要准，运费分摊与装载测算依赖它 |
| 长/宽/高 (cm) | 表单里的体积计算器，填尺寸自动换算体积 | 与体积二选一精确填 |
| 是否含税 (has_tax) | 销售时是否按商户地区税率计税 | 0无税 / 1有税 |
| 默认供应商 (default_supplier_id) | 采购时推荐供应商 | 可选 |
| 状态 (status) | 1上架 / 0下架 | 新建后上架才可被售卖 |
- 保存并上架（状态置 1），商品才会出现在选购/开单可选项中。
⚠️ 体积是最容易填错、后果最严重的字段。运费按各 SKU 体积占比分摊，装载测算也按体积算。填错 → 运费分摊失真、装柜算错。务必填真实单件体积（m³）。
6.4 维护价格
价格有三层，维护位置不同：
| 价格 | 维护位置 | 说明 |
|---|---|---|
| 采购价 | 开供应链订单时录入 | 随订单走，订单结算按此算成本 |
| 销售价 | 商品列表行 → 价格（抽屉） | 标准售价，可按客户等级/商户分层 |
| 折扣价 | 商品列表行 → 折扣（抽屉） | 优惠价，可按等级/商户设置 |
价格维护的决策流程——定售价前先看成本，再决定是否按客户分层：
st=>start: 定售价
a=>operation: 打开「价格」抽屉
b=>inputoutput: 查看采购成本（批次/平均成本）
c=>condition: 按客户等级/商户分层？
d1=>operation: 设通用售价
d2=>operation: 按等级/商户分别设
e=>operation: 可选：折扣抽屉设折扣
f=>end: 商户下单自动取价
st->a->b->c
c(yes)->d2->e->f
c(no)->d1->e
价格抽屉（商品列表行点「价格」）：
- 新增售价：填售价，可选客户等级、可指定商户（不指定则为通用价）。同一 SKU 可以给不同商户/等级设不同售价。
- 行内 编辑 / 删除 已有售价。
- 查看采购成本：打开嵌套抽屉，按批次列出 仓库 / 创建时间 / 过期时间 / 采购价 / 库存，底部有平均成本汇总——定售价前先看成本。
折扣抽屉（商品列表行点「折扣」）：
- 新增折扣：选客户等级/商户，设直接折扣或自定义金额，可填备注。
- 行内 编辑 / 删除 已有折扣。
客户等级与取价规则：
- 客户等级：每个商户都有客户等级（默认 1 级，为最低等级）。在「商户」档案中可调整等级（如 2 级、3 级……等级越高，权益越多）。
- 价格档位：售价与折扣都带一个等级（默认 1 级）。同一 SKU 可以给不同商户、不同等级设不同的价（指定商户为专属价；不指定商户为通用价，对所有商户可见）。
- 取价规则（商户下单时自动生效）：
- 商户能看到自身等级及以下的全部价格档位（例如 2 级商户能看到 level 1、level 2 的价格；1 级商户只能看到 level 1 的价格）。
- 专属价与通用价混合比较：取价时，商户专属价（指定了该商户）和通用价（未指定商户）放在一起参与比价。
- 取最低价：在商户可见的全部候选价格中，自动取最低的那个作为成交价。
举例：某 SKU 只有 level 1 的通用价 100 元，没有 level 2 价；2 级商户下单时，因可见 level 1 及以下，仍按 100 元成交（而非"无价"）。
历史价格由系统自动记录历次变动，可回溯比价。
价格字段受权限控制：无采购价读权限看到*（见 4.4）。
6.5 商品图片维护与批量导入
- 单张维护：商品管理 → 行「编辑」→ 抽屉里的图片区上传（可覆盖/删除）。
- 批量导入：系统管理相关入口提供「商品图片导入」，按模板批量上传图片并匹配 SKU 编码。
图片导入属于上线/迁移类操作，模板细节见附录 G。
6.6 商品下架 / 删除与回收站恢复
- 下架：商品明细把 SKU 状态改为「下架(0)」，停止售卖但不丢数据。
- 删除：系统标记
hide=1（软删除），进入回收站，不下真正抹掉。 - 恢复：回收站里可把商品恢复为正常。
删除是软删除，仍可恢复；但已有关联订单的 SKU 不建议删，会影响历史单据追溯。
6.7 查询商品库存分布
- 仓库 → 仓库查看：按 SKU / 仓库 / 货架查看库存分布（五维：SKU×仓库×过期日×供应链订单×货架位）。
- 商品明细里也能看到该 SKU 的总体库存与可用情况。
本章小结
- 商品以 SKU 为最小单元；先建分类、品牌、品牌类别，再建 SKU。
- 新建 SKU 关键字段：SKU 编码、品牌、规格名（多语）、原产国、海关编码、条码、体积（m³，必准）、是否含税、默认供应商。
- 价格三层：采购价（订单录入）、销售价（商品明细）、折扣价（商品明细）。
- 下架/删除均为可恢复操作，删除进回收站。
- 库存分布可在仓库查看按五维查询。
下一章进入 供应链（采购）场景。