tangxh/ForgeFlow-ERP
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Initial commit

Browse Source
This commit is contained in:
汤学会
2026-06-12 16:00:56 +08:00
commit c927886888
337 changed files with 160396 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/user-manuals/procurement-manual.md
+323
View File
@@ -0,0 +1,323 @@
# 采购使用说明手册
适用模块：`采购与库存 -> 采购订单`、`采购与库存 -> 到货入库`、`采购与库存 -> 质量检验`、`采购与库存 -> 嘉恒仓库`。
本手册面向采购专员、仓库管理人员和管理人员，用于说明从采购下单、锁单、到货、质检、入库、退货到合同生成的完整操作方式。
## 1. 采购业务总览
采购模块负责把公司需要采购的原材料或辅料形成采购订单，并推动后续到货、质检和入库。
采购订单目前分两类仓库目标：
| 采购到货库 | 采购来源 | 计量口径 | 说明 |
| --- | --- | --- | --- |
| 原材料库 | 备料采购、销售订单采购 | 重量，主单位 kg，辅助显示 t | 钢板、卷料等进入原材料库，后续用于生产出库。 |
| 辅料库 | 备料采购 | 数量 | 手套、薄膜、纸箱、螺丝钉等生产消耗品。 |
采购单号由系统自动生成，规则为：
```text
采购{年份}-00001
```
例如：
```text
采购2026-00001
```
## 2. 标准采购流程图
```mermaid
flowchart TD
A["维护基础资料"] --> B["新增采购订单"]
B --> C{"选择采购到货库"}
C --> D["原材料库"]
C --> E["辅料库"]
D --> F{"选择采购来源"}
F --> G["备料采购"]
F --> H["销售订单采购"]
E --> I["辅料备料采购"]
G --> J["填写供应商、预计到货、采购明细"]
H --> K["选择一个或多个销售订单"]
K --> L["系统按产品需规带出原材料需求"]
I --> M["填写辅料、数量、用途"]
J --> N["保存采购订单"]
L --> N
M --> N
N --> O["锁单"]
O --> P["到货入库"]
P --> Q["质量检验"]
Q --> R{"质检结果"}
R --> S["放行入库"]
R --> T["拒收/异常处理"]
S --> U["形成库存批次或辅料库存"]
```
## 3. 使用前准备
采购前建议先确认以下基础资料已经维护完整。
| 前置资料 | 所属模块 | 用途 |
| --- | --- | --- |
| 供应商名录 | 基础资料 -> 供应商名录 | 新增采购订单时选择供应商，导入导出供应商数据。 |
| 原材料名录 | 基础资料 -> 原材料名录 | 原材料采购明细的选择来源，维护原材料编码、名称、材质、规格、性能要求等。 |
| 产品需规清单 | 基础资料 -> 产品需规清单 | 销售订单采购时，系统按产品需规自动带出所需原材料。 |
| 销售订单 | 订单与计划 -> 销售订单列表 | 销售订单采购时作为需求来源。 |
如果是辅料采购，需确认辅料主数据已经存在，且采购时按数量填写。
## 4. 新增采购订单
入口：
```text
采购与库存 -> 采购订单 -> 新增采购订单
```
### 4.1 第一步：选择采购到货库
新增采购订单时，系统会先让用户选择采购到货库：
| 选择项 | 后续规则 |
| --- | --- |
| 原材料库 | 可以选择备料采购或销售订单采购。 |
| 辅料库 | 只能选择备料采购，不能关联销售订单采购。 |
### 4.2 第二步：选择采购来源
原材料库采购时，有两种采购来源。
| 采购来源 | 适用场景 | 系统行为 |
| --- | --- | --- |
| 备料采购 | 不直接绑定某张销售订单，只是按库存或经验备料。 | 用户手动选择原材料，填写采购重量和单价。 |
| 销售订单采购 | 为一个或多个销售订单采购原材料。 | 用户选择销售订单后，系统按产品需规清单自动带出原材料需求，用户可以删除不需要采购的明细。 |
辅料库采购只支持备料采购。
### 4.3 销售订单采购的自动带出逻辑
销售订单采购时，用户可以选择多个销售订单。系统会根据销售订单中的产品，到 `产品需规清单` 中查找该产品默认使用的原材料，并自动生成采购明细。
生成后用户仍然可以调整：
- 如果某个供应商不能供应某种材料，可以删除该行。
- 如果本次采购只买一部分材料，可以调整采购重量。
- 如果库存已足够，系统可能提示缺口为 0，用户可改为备料采购。
### 4.4 采购重量、吨和单价显示
原材料采购统一以 kg 为主单位。为了方便采购人员看吨位，系统会在涉及重量的地方辅助显示 t。
示例：
```text
采购重量：2500 kg
辅助显示：2.5 t
```
单价主口径为：
```text
元/kg
```
系统会辅助显示：
```text
元/t
```
示例：
```text
4.20 元/kg = 4200 元/t
```
### 4.5 预计到货和提前预警
采购订单需要填写预计到货时间，并可填写提前预警时间，单位为天。
示例：
```text
预计到货：2026-06-10
提前预警时间：3 天
```
则从 `2026-06-07` 开始，采购订单会进入到货提醒状态，页面上会用提醒色提示用户关注。
## 5. 采购订单状态和锁单
采购订单保存后，并不代表已经通知供应商供货。正式通知供应商前，应点击 `锁单`。
| 状态/标记 | 含义 | 用户应做什么 |
| --- | --- | --- |
| 未锁单 | 采购订单仍可修改和删除。 | 继续检查供应商、交期、明细、单价。 |
| 已锁单 | 表示已经通知供应商供货。 | 后续不能随意修改或删除，可进入到货入库。 |
| 到货预警 | 预计到货日前进入提醒期。 | 联系供应商确认到货进度。 |
| 部分收货 | 采购订单只有部分明细或部分重量到货。 | 等待后续到货。 |
| 待质检 | 到货已登记，但还未完成质检放行。 | 质检人员处理质量检验。 |
| 已放行/已收货 | 质检通过并进入库存。 | 仓库可以使用该库存。 |
| 存在退货 | 该采购订单关联的库存批次发生过退货出库。 | 采购需跟进供应商补货、换货或扣款。 |
重要规则：
```text
锁单是采购执行控制，不等于收货完成。
质检放行前，材料不应被视为可用库存。
```
## 6. 生成采购合同
入口：
```text
采购与库存 -> 采购订单
```
操作步骤：
1. 在采购订单列表中勾选需要生成合同的采购订单。
2. 点击列表上方的 `生成合同`。
3. 系统按基础采购合同模板生成合同。
4. 生成合同前请确认供应商、采购明细、单价、预计到货时间正确。
限制规则：
```text
采购合同只能按同一供应商生成，不要混选不同供应商的采购订单。
```
## 7. 到货入库
入口：
```text
采购与库存 -> 到货入库 -> 新增到货入库单
```
到货入库用于登记供应商送到公司的货物。系统只允许选择已经锁单的采购订单。
操作流程：
```mermaid
flowchart TD
A["供应商到货"] --> B["新增到货入库单"]
B --> C["选择已锁单采购订单"]
C --> D["选择采购明细"]
D --> E{"采购到货库"}
E --> F["原材料库：填写到货重量 kg、单价"]
E --> G["辅料库：填写到货数量、单位"]
F --> H["保存入库单"]
G --> H
H --> I["进入质量检验"]
I --> J["质检放行后进入库存"]
```
原材料到货时，每一次到货都会生成新的库存批次号。即便同一个采购订单、同一种原材料分多次到货，每次也会形成新的库存批次。
示例：
```text
采购订单 A 采购原材料 a
第一次到货 -> JH_材料名00001_0001
第二次到货 -> JH_材料名00001_0002
第三次到货 -> JH_材料名00001_0003
```
入库单号由系统自动生成，规则为：
```text
入库{年份}-00001
```
## 8. 质量检验
入口：
```text
采购与库存 -> 质量检验
```
质检用于判断到货材料或辅料是否可以进入库存。
常见处理结果：
| 质检结果 | 后续影响 |
| --- | --- |
| 已放行 | 进入对应仓库库存，原材料形成可用库存批次。 |
| 已拒收 | 不进入可用库存，采购和仓库需要协同处理。 |
| 待质检 | 暂时不可用，不能当作可生产库存。 |
如果材料入仓后才发现质量或性能问题，应在嘉恒仓库的 `原材料库 -> 退货出库` 中办理退货。
## 9. 原材料退货出库
入口：
```text
采购与库存 -> 嘉恒仓库 -> 原材料库 -> 出库 -> 退货出库
```
适用场景：
```text
原材料已经入仓，但后续发现质量、规格或性能不合格，需要退回供应商。
```
操作要点：
- 选择要退货的原材料库存批次。
- 填写退货重量。
- 填写运单号或上传辅助照片。
- 保存后系统会减少对应库存批次的可用重量。
- 对应采购订单会显示 `存在退货` 警示标记。
## 10. 查询和核对
采购人员常用核对路径：
| 想核对的内容 | 推荐入口 |
| --- | --- |
| 某张采购订单是否锁单 | 采购与库存 -> 采购订单 |
| 某采购订单到了多少 | 采购与库存 -> 到货入库 |
| 到货是否质检放行 | 采购与库存 -> 质量检验 |
| 材料是否形成库存批次 | 采购与库存 -> 嘉恒仓库 -> 原材料库 |
| 某采购订单是否存在退货 | 采购与库存 -> 采购订单，查看警示标记 |
| 某材料批次来源采购单 | 嘉恒仓库 -> 原材料库 -> 批次明细 |
## 11. 常见问题
### 11.1 为什么到货入库下拉框里看不到采购订单？
通常原因：
- 采购订单还没有锁单。
- 采购订单已经全部收货完成。
- 当前选择的到货仓库类型与采购订单仓库类型不一致。
### 11.2 为什么辅料库不能选择销售订单采购？
辅料通常不是按某个销售订单的产品需规直接计算出来的主材需求，而是生产过程中的消耗品，因此只允许备料采购。
### 11.3 为什么原材料采购页面既显示 kg 又显示 t？
系统主口径是 kg，方便库存、生产、成本统一计算；采购沟通时常用吨，因此辅助显示 t。
### 11.4 采购订单锁单后还能修改吗？
不能。锁单表示已经通知供应商供货，避免采购内容被随意改变。若确实要调整，需要走业务管理确认后再处理。
### 11.5 采购订单显示“存在退货”是什么意思？
说明该采购订单关联的某个原材料库存批次发生过退货出库。采购人员需要跟供应商确认补货、换货、退款或扣款。
## 12. 采购员每日建议检查清单
- 检查即将到货或已经到货预警的采购订单。
- 检查已锁单但长时间未到货的采购订单。
- 检查到货后仍处于待质检状态的记录。
- 检查存在退货的采购订单，并跟进供应商处理。
- 检查销售订单采购是否已覆盖相关销售订单的原材料需求。
docs/user-manuals/sales-manual.md
+301
View File
@@ -0,0 +1,301 @@
# 销售使用说明手册
适用模块：`基础资料 -> 客户名录`、`订单与计划 -> 销售订单列表`、`采购与库存 -> 采购订单`、`采购与库存 -> 嘉恒仓库 -> 成品库 -> 销售出库`、`发货概览 -> 发货台账`。
本手册面向销售人员、管理人员和仓库发货人员，用于说明客户维护、销售订单创建、合同生成、采购联动、成品发货、发货追溯和客户退货处理。
## 1. 销售业务总览
销售模块的核心是销售订单。销售订单创建后，可以联动采购、生产、成品入库、销售出库和发货台账。
完整链路如下：
```mermaid
flowchart TD
A["客户名录"] --> B["新增销售订单"]
B --> C["销售订单明细：产品、数量、单价、交期"]
C --> D{"是否需要采购原材料"}
D --> E["采购订单：销售订单采购"]
D --> F["使用现有库存生产"]
E --> G["到货入库与质检"]
F --> H["生产出库生成工单"]
G --> H
H --> I["小程序工序报工"]
I --> J["成品库：生产入库"]
J --> K["成品库：销售出库"]
K --> L["发货概览：按销售订单查看发货台账"]
L --> M{"客户是否退货"}
M --> N["退货库：退货入库，后续返工"]
M --> O["废料库：退货废料入库，直接报废"]
```
## 2. 客户名录
入口：
```text
基础资料 -> 客户名录
```
客户名录用于维护销售订单所需的客户基础信息。新增销售订单前，应先确认客户已经存在。
支持能力：
- 新增客户。
- 编辑客户。
- 导入客户。
- 导出客户。
- 每个客户允许维护多位联系人，最多 3 位。
建议维护字段：
| 字段 | 用途 |
| --- | --- |
| 客户名称 | 销售订单和合同的客户主体。 |
| 联系人 | 发货、对账、合同沟通使用。 |
| 电话 | 销售联系和发货联系。 |
| 地址 | 发货地址或合同地址。 |
| 备注 | 记录客户特殊要求。 |
## 3. 销售订单列表
入口：
```text
订单与计划 -> 销售订单列表
```
销售订单用于记录客户订购的产品、数量、单价和交期。
销售订单号由系统自动生成，规则为：
```text
销售{年份}-00001
```
例如：
```text
销售2026-00001
```
## 4. 新增销售订单
操作步骤：
1. 进入 `订单与计划 -> 销售订单列表`。
2. 点击 `新增销售订单`。
3. 选择客户。
4. 确认销售订单号，系统会自动生成。
5. 填写销售订单主信息。
6. 添加销售明细。
7. 每条明细选择产品、填写销售数量、销售单价和明细交期。
8. 保存销售订单。
明细交期规则：
```text
销售订单明细的交期默认等于销售订单交期，用户可以单独修改每条明细交期。
```
## 5. 销售订单删除规则
销售订单不是任何时候都可以删除。
| 状态 | 是否可删除 | 说明 |
| --- | --- | --- |
| 未关联采购、未发货 | 可以删除 | 说明订单还没有进入后续业务。 |
| 已关联采购订单 | 不可删除 | 采购已经基于该订单产生需求。 |
| 已发货或部分发货 | 不可删除 | 已经形成库存和发货流水。 |
如果订单已经进入采购或发货环节，应通过业务调整方式处理，而不是直接删除。
## 6. 生成销售合同
入口：
```text
订单与计划 -> 销售订单列表
```
操作步骤：
1. 在销售订单列表中勾选需要生成合同的销售订单。
2. 点击列表上方的 `生成合同`。
3. 系统按基础销售合同模板生成合同。
4. 用户下载或打印后，与客户确认合同内容。
限制规则：
```text
销售合同只能按同一客户生成，不要混选不同客户的销售订单。
```
合同中会包含：
- 销售订单号。
- 客户信息。
- 产品明细。
- 销售数量。
- 销售单价。
- 金额。
- 约定交期。
- 基础质量和交付条款。
## 7. 销售订单与采购联动
如果销售订单需要采购原材料，可以在采购订单中选择 `销售订单采购`。
入口：
```text
采购与库存 -> 采购订单 -> 新增采购订单 -> 原材料库 -> 销售订单采购
```
联动逻辑：
```mermaid
flowchart TD
A["销售订单"] --> B["采购订单选择销售订单采购"]
B --> C["选择一个或多个销售订单"]
C --> D["系统读取销售订单产品"]
D --> E["系统读取产品需规清单"]
E --> F["自动生成原材料采购明细"]
F --> G["采购人员删除供应商不能供应的材料"]
G --> H["保存并锁单"]
```
注意事项：
- 一个采购订单可以关联多个销售订单。
- 系统会按销售订单产品的需规清单自动带出原材料。
- 采购人员可以删除本供应商不能供应的材料。
- 采购订单锁单后，销售订单会被视为已经进入采购联动流程。
## 8. 销售出库
销售出库目前在嘉恒仓库的成品库中办理。
入口：
```text
采购与库存 -> 嘉恒仓库 -> 成品库 -> 出库 -> 销售出库
```
销售出库用于把成品库存发给客户，并回写销售订单已发数量。
操作步骤：
1. 进入嘉恒仓库。
2. 选择 `成品库`。
3. 点击出库区的 `销售出库`。
4. 选择是否关联销售订单。
5. 如果关联销售订单，选择销售订单和销售订单明细。
6. 填写发货数量。
7. 填写运单号或上传辅助照片。
8. 填写包装备注，例如有无提供篮子等。
9. 保存后系统自动从成品库存中扣减，并生成销售出库单。
销售出库时，系统会自动拆分可用成品库存批次，并追溯其来源原材料库存批次。
如果库存不足，系统应阻止创建销售出库单，并提示缺少数量。
## 9. 发货概览
入口：
```text
发货概览 -> 发货台账
```
发货台账按销售订单聚合展示，而不是只看一张张发货单。
推荐查看方式：
| 想查看 | 操作 |
| --- | --- |
| 某销售订单总共发了多少 | 搜索销售订单号，查看聚合行。 |
| 发货单号和发货明细 | 点开销售订单后的流水信息。 |
| 发货产品来自哪些成品批次 | 查看发货明细中的成品库存批次。 |
| 成品批次用了哪些原材料 | 查看来源原材料库存批次号。 |
| 客户、收货人、运单 | 查看发货流水详情。 |
发货概览的业务意义：
```text
销售人员看客户订单履约；
仓库人员看发货流水；
管理人员看销售订单、成品库存和原材料来源追溯。
```
## 10. 客户退货处理
客户退货不再放在旧的 `发货与售后 -> 退货处理` 中，而是在嘉恒仓库中按退回品去向处理。
| 客户退货判断 | 操作入口 | 说明 |
| --- | --- | --- |
| 可返工 | 嘉恒仓库 -> 退货库 -> 入库 -> 退货入库 | 退货品进入退货库，后续可返工出库。 |
| 不可返工，直接报废 | 嘉恒仓库 -> 废料库 -> 入库 -> 退货废料入库 | 退货品直接进入废料库。 |
退货入库时，应选择原发货批次或发货明细，系统会追溯到原销售订单、产品和原材料库存批次。
退货流程图：
```mermaid
flowchart TD
A["客户退回产品"] --> B{"业务判断"}
B --> C["可返工"]
B --> D["不可返工"]
C --> E["退货库：退货入库"]
E --> F["退货库：返工出库"]
F --> G["后续返工生产"]
D --> H["废料库：退货废料入库"]
H --> I["废料库：售卖出库"]
```
## 11. 销售人员常用核对路径
| 目标 | 推荐入口 |
| --- | --- |
| 新增客户 | 基础资料 -> 客户名录 |
| 创建销售订单 | 订单与计划 -> 销售订单列表 |
| 生成销售合同 | 订单与计划 -> 销售订单列表 |
| 看销售订单是否采购联动 | 订单与计划 -> 销售订单列表，或采购与库存 -> 采购订单 |
| 看销售订单是否发货 | 发货概览 -> 发货台账 |
| 办理销售发货 | 采购与库存 -> 嘉恒仓库 -> 成品库 -> 销售出库 |
| 办理客户退货 | 采购与库存 -> 嘉恒仓库 -> 退货库或废料库 |
## 12. 常见问题
### 12.1 为什么销售订单不能删除？
通常是该销售订单已经关联采购订单，或已经发生销售出库。系统不允许删除已经影响后续业务的数据。
### 12.2 为什么生成销售合同失败？
常见原因：
- 没有勾选销售订单。
- 混选了不同客户的销售订单。
- 所选销售订单没有明细。
### 12.3 为什么销售出库时看不到库存？
可能原因：
- 成品还没有生产入库。
- 成品库存已被发完。
- 选择的销售订单明细产品与成品库存产品不一致。
### 12.4 发货台账为什么按销售订单聚合？
销售人员最关心的是某张销售订单履约了多少，而不是孤立的一张发货单。因此系统按销售订单聚合，发货单号和发货明细作为点开后的流水信息展示。
## 13. 销售每日建议检查清单
- 检查新增销售订单是否录入产品、数量、单价和交期。
- 检查需要采购的销售订单是否已经被采购订单关联。
- 检查即将到交期的销售订单是否已生产入库。
- 检查可发货销售订单是否已在成品库办理销售出库。
- 检查发货台账中的发货数量和客户要求是否一致。
- 检查客户退货是否已进入退货库或废料库。
docs/user-manuals/warehouse-manual.md
+408
View File
@@ -0,0 +1,408 @@
# 仓库使用说明手册
适用模块：`采购与库存 -> 嘉恒仓库`、`生产执行 -> 工单台账`、`采购与库存 -> 到货入库`、`采购与库存 -> 质量检验`、`发货概览 -> 发货台账`。
本手册面向仓库管理人员、生产管理人员和管理人员，用于说明嘉恒仓库六大库的库存口径、出入库操作、库存批次、流水、盘库和追溯方式。
## 1. 嘉恒仓库总览
嘉恒仓库目前包含六大库：
| 仓库 | 主要对象 | 主计量口径 | 说明 |
| --- | --- | --- | --- |
| 原材料库 | 钢板、卷料等原材料 | 重量 kg | 原材料只有重量概念，不使用数量概念。 |
| 半成品库 | 做完部分工序的产品 | 按件或按重二选一 | 半成品是产品加已完成工序，不是普通物料。 |
| 成品库 | 完工产品 | 数量为主，重量辅助 | 销售出库推动业务的是数量。 |
| 辅料库 | 手套、薄膜、纸箱、螺丝钉等 | 数量 | 辅料采购、入库、出库统一按数量。 |
| 废料库 | 边角料、报废品、废料 | 重量 kg | 废料只有重量概念。 |
| 退货库 | 客户退回且可返工的产品 | 数量/追溯信息 | 用于存放待返工退货品。 |
仓库页面由三块组成：
```text
仓库选择区：选择原材料库、半成品库、成品库、辅料库、废料库、退货库。
出入库操作区：根据当前仓库显示对应的入库和出库操作。
库存展示区：查看库存总览、批次明细和流水。
```
## 2. 仓库出入库总流程
```mermaid
flowchart TD
A["进入嘉恒仓库"] --> B["选择仓库"]
B --> C["查看库存总览"]
B --> D["选择入库操作"]
B --> E["选择出库操作"]
D --> F["填写业务信息"]
E --> G["选择库存或来源批次"]
F --> H["保存"]
G --> H
H --> I["生成库存变化"]
I --> J["写入库级流水"]
J --> K["可在库存明细和流水中追溯"]
```
## 3. 原材料库
### 3.1 原材料库业务口径
原材料库只使用重量口径。
```text
原材料物料 -> 库存批次号
```
系统不再使用“材料分批次号”这个业务概念。每个原材料库存批次号就是后续生产、余料归还、废料追溯、销售追溯的核心来源。
库存批次号规则：
```text
JH_{原材料名称 + 原材料编码后5位}_0001
```
示例：
```text
JH_冷轧板00001_0001
JH_冷轧板00001_0002
```
每一次采购到货入库都会产生新的库存批次号。即便是同一个采购订单、同一种原材料，第二次到货也会递增为新的库存批次。
### 3.2 原材料库入库操作
| 入库类型 | 用途 | 关键规则 |
| --- | --- | --- |
| 期初入库 | 仓库初始化时导入初始材料。 | 支持导出模板和导入初始数据。 |
| 客料入库 | 客户提供的原材料直接入库。 | 成本按 0 处理；系统自动生成新库存批次号。 |
| 生产余料入库 | 生产结束后剩余原材料归还。 | 归还到原来源库存批次，不另起新批次。 |
| 委外余料入库 | 委外加工结束后剩余原材料退回。 | 归还到原来源库存批次，不另起新批次。 |
生产余料入库流程：
```mermaid
flowchart TD
A["选择生产工单"] --> B["系统显示可归还重量"]
B --> C["选择来源库存批次号，可多选"]
C --> D["按每个来源库存批次填写归还重量"]
D --> E{"是否勾选该工单结单"}
E --> F["未结单：保存本次余料归还"]
E --> G["结单：校验累计归还是否在允许范围"]
G --> H{"是否超出范围"}
H --> I["未超出：正常结单"]
H --> J["超出：填写说明后结单"]
```
重要规则：
```text
余料归还是还到原库存批次里，不生成新的 SCSY 之类独立批次。
```
### 3.3 原材料库出库操作
| 出库类型 | 用途 | 关键规则 |
| --- | --- | --- |
| 生产出库 | 原材料出库给生产使用。 | 选择原材料库存批次，多选；每次生产出库自动生成生产工单。 |
| 委外出库 | 原材料出库给第三方加工。 | 选择来源库存批次，多选；需填写运单号或上传辅助照片。 |
| 退货出库 | 入仓后发现不合格，退回供应商。 | 选择来源库存批次；会联动采购订单显示存在退货。 |
| 报废出库 | 原材料报废。 | 选择来源库存批次，多选；减少原材料库存。 |
生产出库与工单关系：
```mermaid
flowchart TD
A["原材料库：生产出库"] --> B["选择产品"]
B --> C["选择一个或多个原材料库存批次"]
C --> D["填写出库重量"]
D --> E["系统生成生产工单"]
E --> F["小程序按工单报工"]
F --> G["成品库生产入库"]
F --> H["废料库生产废料入库"]
F --> I["原材料库生产余料入库"]
```
## 4. 半成品库
### 4.1 半成品库业务口径
半成品不是普通物料，而是：
```text
产品 + 已完成工序
```
例如一个产品有 5 道工序，当前完成第 3 道工序后暂时入库，那么半成品对象应是：
```text
产品名称 + 第3道已完成工序
```
页面展示时，标题尽量简洁显示产品名称，已完成工序在明细卡片或字段中展示。
### 4.2 半成品入库计量规则
半成品入库时必须选择入库类型：
| 入库类型 | 填写字段 |
| --- | --- |
| 按件入库 | 填写件数 |
| 按重入库 | 填写重量 |
二者只能选一个，不能同时填写。
如果某种半成品在库中已经存在，再次入库时沿用已有半成品的入库类型。
示例：
```text
某半成品第一次按件入库，后续同种半成品继续按件入库。
某半成品第一次按重入库，后续同种半成品继续按重入库。
```
### 4.3 半成品库操作
| 类型 | 操作 | 说明 |
| --- | --- | --- |
| 入库 | 产中入库 | 生产过程中需要暂时入库的半成品。 |
| 入库 | 期初入库 | 仓库初始化时导入历史半成品。 |
| 入库 | 委外入库 | 委外某道工序完成后入库，等待后续继续加工。 |
| 出库 | 产中出库 | 暂存半成品出库，继续完成后续生产。 |
| 出库 | 委外出库 | 半成品出库委外加工后续工序，需填写委外方。 |
来源库存批次规则：
```text
入库时，来源库存批次根据所选半成品对应产品使用的原材料，带出该原材料现有库存批次。
出库时，来源库存批次由所选半成品库存自动确定，不让用户手填。
```
## 5. 成品库
### 5.1 成品库业务口径
成品库以数量为主，重量只是辅助显示。
```text
推动销售、发货和库存扣减的是成品数量。
```
成品的入库材料成本可以按原材料库存批次成本和产品毛重估算，用于辅助成本参考，不等同于销售单价。
### 5.2 成品库操作
| 类型 | 操作 | 说明 |
| --- | --- | --- |
| 入库 | 生产入库 | 选择生产工单，把完工成品入库。 |
| 入库 | 委外入库 | 委外加工完成后的成品入库。 |
| 入库 | 期初入库 | 仓库初始化时导入初始成品。 |
| 出库 | 销售出库 | 按销售订单或客户需求发货出库。 |
生产入库流程：
```mermaid
flowchart TD
A["选择生产工单"] --> B["系统计算可入库成品数量"]
B --> C["填写本次入库数量"]
C --> D{"是否勾选工单结单"}
D --> E["不结单：保存本次成品入库"]
D --> F["结单：生产工单进入成品结单状态"]
E --> G["成品库增加库存"]
F --> G
```
销售出库流程：
```mermaid
flowchart TD
A["成品库：销售出库"] --> B{"是否关联销售订单"}
B --> C["关联销售订单"]
B --> D["不关联销售订单"]
C --> E["选择销售订单和明细"]
D --> F["选择客户和产品"]
E --> G["填写发货数量、运单号或辅助照片、包装备注"]
F --> G
G --> H["系统检查成品库存是否足够"]
H --> I{"库存是否足够"}
I --> J["足够：创建销售出库单"]
I --> K["不足：提示缺少数量，不创建"]
J --> L["回写销售订单已发数量"]
J --> M["写入发货台账"]
```
## 6. 辅料库
辅料库用于存放生产过程中消耗的辅料，例如手套、薄膜、纸箱、螺丝钉等。
辅料库统一按数量管理。
| 类型 | 操作 | 说明 |
| --- | --- | --- |
| 入库 | 期初入库 | 仓库初始化时导入初始辅料。 |
| 出库 | 生产出库 | 辅料用于生产消耗出库，需填写用途。 |
辅料通过采购入库时，也应统一按数量口径，不走原材料重量逻辑。
## 7. 废料库
废料库用于存放生产中的边角料、报废品、退货报废品和委外产生的废料。
废料库只使用重量口径。
| 类型 | 操作 | 说明 |
| --- | --- | --- |
| 入库 | 生产废料入库 | 生产过程产生的废料入库，选择生产工单。 |
| 入库 | 期初入库 | 仓库初始化时导入初始废料。 |
| 入库 | 委外废料入库 | 委外加工产生的废料入库。 |
| 入库 | 退货废料入库 | 客户退回后判定报废的产品直接进入废料库。 |
| 出库 | 售卖出库 | 废料称重售卖出库。 |
生产废料入库会根据生产工单计算可入库废料重量。废料由两部分组成：
```text
边角废料 = 合格生产数量 * (毛重 - 净重)
报废品废料 = 报废数量 * 毛重
```
系统会按工单已报工和已入库废料计算本次可参考入库重量。
## 8. 退货库
退货库用于存放客户退回且判定可返工的产品。
| 类型 | 操作 | 说明 |
| --- | --- | --- |
| 入库 | 期初入库 | 仓库初始化时导入历史退货待返工品。 |
| 入库 | 退货入库 | 客户退回且判定可返工的产品入退货库。 |
| 出库 | 返工出库 | 退货库待返工品出库，后续返工处理。 |
如果客户退回品判定为不可返工，不进入退货库，应进入：
```text
废料库 -> 退货废料入库
```
退货库中的退货明细应能追溯：
- 原销售订单。
- 原发货明细。
- 产品。
- 原材料库存批次号。
## 9. 运单号和辅助照片
以下业务需要填写运单号或上传辅助照片，二者至少提供一种即可：
| 仓库 | 操作 |
| --- | --- |
| 原材料库 | 客料入库、委外余料入库、委外出库、退货出库 |
| 半成品库 | 委外入库、委外出库 |
| 成品库 | 委外入库、销售出库 |
| 废料库 | 委外废料入库、售卖出库 |
说明：
```text
辅助照片可以是运单照片、现场照片、交接照片或其他能辅助说明业务事实的图片。
```
## 10. 库存流水
每个仓库都应查看对应库的出入库流水。
入口：
```text
嘉恒仓库 -> 选择仓库 -> 点击流水图标
```
流水用于回答：
| 问题 | 通过流水查看 |
| --- | --- |
| 这批库存从哪里来？ | 来源单据、来源库存批次、采购单、生产工单。 |
| 这批库存去了哪里？ | 出库类型、销售出库、生产出库、报废出库等。 |
| 谁在什么时候操作？ | 流水时间和操作记录。 |
| 库存为什么增加或减少？ | 流水类型和变动数量/重量。 |
## 11. 盘库
盘库用于把系统库存与真实仓库清点结果对齐。
入口：
```text
嘉恒仓库 -> 选择仓库 -> 盘库
```
盘库规则：
```text
当前选中哪个仓库，就盘哪个仓库。
盘库期间该仓库会锁库，不能继续出入库。
```
盘库流程：
```mermaid
flowchart TD
A["选择仓库"] --> B["点击盘库"]
B --> C["确认盘库并导出仓库清单"]
C --> D["系统锁定当前仓库"]
D --> E["用户按 Excel 清单清点真实仓库"]
E --> F["用户修改 Excel 后导入"]
F --> G["系统校验是否为本次盘库清单"]
G --> H{"校验通过"}
H --> I["弹窗展示左右差异对比"]
H --> J["拒绝导入并提示原因"]
I --> K{"用户确认盘库"}
K --> L["按清单重置库存"]
K --> M["取消，继续修改后重新导入"]
L --> N["写入盘库记录和调整流水"]
N --> O["解锁仓库"]
```
注意事项：
- 只能导入本次盘库导出的清单。
- 清单内有盘库单号校验标志。
- 空库盘库导出为空、导入为空时，确认后只解锁仓库，不生成库存调整流水。
- 差异对比确认前，不会重置库存。
## 12. 仓库常见问题
### 12.1 为什么原材料库没有数量？
当前业务规则是原材料一律按重量管理。采购、库存、生产出库、余料归还和报废都围绕 kg 进行。
### 12.2 为什么每次采购入库都生成新库存批次？
这样可以清楚追踪不同到货批次的单价、采购订单、入库时间和后续使用情况。即使同一个采购单分多批到货，也应形成不同库存批次。
### 12.3 为什么生产余料入库不是新批次？
余料是从原库存批次领出去后剩余归还，因此业务上应回到原来源库存批次，而不是生成新库存批次。
### 12.4 为什么半成品不是物料？
半成品是某个产品完成了部分工序后的状态。它必须带产品和已完成工序，否则无法判断后续该继续哪道工序。
### 12.5 为什么成品库以数量为主？
成品销售和发货是按件数履约，重量只是辅助显示或成本参考。销售出库扣减的是成品数量。
### 12.6 仓库被锁了怎么办？
先检查是否有正在进行的盘库单。盘库确认或取消后，仓库才会解锁。不要绕过盘库流程直接改库存。
## 13. 仓库每日建议检查清单
- 检查原材料库可用库存批次是否充足。
- 检查是否有待质检到货未放行。
- 检查生产出库是否已生成对应生产工单。
- 检查生产余料是否及时归还到来源库存批次。
- 检查成品生产入库是否与工单报工匹配。
- 检查销售出库是否已填写运单号或辅助照片。
- 检查废料入库和售卖出库是否有完整流水。
- 检查退货库是否有长期未返工的退货品。
- 定期进行盘库，确保系统库存和真实库存一致。