Files
GX.O3.WMS/WebApi/docs/采购申请管理_功能需求文档.md
T

508 lines
22 KiB
Markdown
Executable File
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 采购申请管理 功能需求文档
> 范围:GX-WMS 左侧菜单 **采购管理 › 采购申请管理** 下的 4 个功能
> ① 采购申请管理 ② 研发采购看板 ③ 研发采购全链路看板 ④ 研发订单考核时效看板
> 数据来源:泛微 OA 采购申请流程(研发采购申请单)、金蝶云星空采购订单/收料通知、GXWMS 采购执行数据
| 项目 | 内容 |
| --- | --- |
| 文档类型 | 业务需求文档(PRD) |
| 版本 | V1.0 |
| 编写日期 | 2026-10-09 |
| 依据 | `View/common/nav.js` 菜单配置 + 各功能页面实际交互 |
---
## 一、文档概述
### 1.1 业务背景
研发项目的物料采购由研发人员在 OA 发起「研发采购申请单」,经项目经理审批后流转至采购执行。实际业务中存在三个痛点:
1. **维护分散**:物料的标准交期、报价、供应商、负责人、业务状态等信息需要人工逐条维护,缺少统一入口;
2. **进度看不见**:申请单转采购订单(PO)、再收料入库(RN)的过程跨 OA 与 ERP 两套系统,无法一屏看全;
3. **责任难界定**:审批通过多久才转单、物料是否按承诺到料,缺少量化考核口径,问题定位不到项目和责任人。
本模块围绕上述痛点提供**维护 + 查询 + 追溯 + 考核**四类能力。
### 1.2 功能清单
| 序号 | 功能名称 | 定位 | 适用角色 | 页面入口 |
| --- | --- | --- | --- | --- |
| ① | 采购申请管理 | **单据级**查询与维护(一张申请单一行) | 采购(Purchase01) | `procurement.html` |
| ② | 研发采购看板 | **物料级**查询与维护(一条物料一行) | 研发(YF01) | `dashboard.html` |
| ③ | 研发采购全链路看板 | **物料级 + 执行结果**一屏看全(含 PO/收料) | 研发(YF01)、采购(Purchase01) | `procurement_board_list.html` |
| ④ | 研发订单考核时效看板 | **时效考核**与风险下钻 | 研发(YF01)、采购(Purchase01) | `procurement_audit_leadtime.html` |
### 1.3 角色与权限
| 角色编号 | 角色 | 可见功能 |
| --- | --- | --- |
| `Purchase01` | 采购 | ①②③④ |
| `YF01` | 研发 | ②③④ |
> 权限要求:菜单按角色自动过滤,无权限的菜单项不展示;未登录自动跳转登录页。
---
## 二、公共业务规则(4 个功能共用)
### 2.1 数据范围
| 规则项 | 说明 |
| --- | --- |
| 时间范围 | 仅统计**当前年度**提交的采购申请单 |
| 单据范围 | 仅取「研发采购申请流程」单据(流程编号以 YFCGSQ 开头) |
| 统计粒度 | ① 为**单据级**;②③④ 为**物料明细级**(一行一物料) |
| 去重规则 | 时效考核按「申请单 + 行号」去重,同一行物料不重复计数 |
### 2.2 业务状态字典
| 编码 | 状态名称 | 归属 |
| --- | --- | --- |
| 空 / 0 | -- | 未维护 |
| 1 | 采购订单-转单追踪 | 采购订单 |
| 2 | 供应链-待供应商报价 | 供应链 |
| 3 | 供应链-待ED审批 | 供应链 |
| 4 | 供应链-ED驳回,重新议价 | 供应链 |
| 5 | 供应链-ED已审批 | 供应链 |
| 6 | 研发-采购申请驳回(无图纸/方案没确认) | 研发 |
| 7 | 研发-采购申请撤回(改需求) | 研发 |
| 8 | 研发-采购申请取消 | 研发 |
| 9 | 研发-量产复用件 | 研发 |
### 2.3 交付风险等级字典
| 编码 | 名称 | 展示颜色 |
| --- | --- | --- |
| 空 / 0 | 不展示 | — |
| 1 | 超高 | — |
| 2 | 高 | — |
| 3 | 中 | — |
| 4 | 低 | — |
| 5 | 已完成 | 绿 |
| 6 | 取消 | — |
### 2.4 交付节奏字典
| 编码 | 名称 |
| --- | --- |
| 1 | 整批交付 |
| 2 | 分批交付 |
| 3 | 取消 |
### 2.5 单据用途字典
| 编码 | 名称 |
| --- | --- |
| 0 | 生产 |
| 1 | 研发(用途为空时默认研发) |
| 2 | 售后 |
### 2.6 时效考核阈值
| 考核项 | 高/超高阈值 | 低阈值 | 适用功能 |
| --- | --- | --- | --- |
| 审批与转单时效 | > 5 天 | ≤ 2 天 | ④ 区域① |
| 到料时效 | > 4 天 | ≤ 2 天 | ④ 区域② |
> 阈值支持后台配置调整,页面顶部需明示当前生效的阈值说明。
### 2.7 通用交互约定
| 项目 | 约定 |
| --- | --- |
| 分页 | 默认每页 50 条;支持切换每页条数;显示总条数与总页数 |
| 筛选记忆 | 查询条件在浏览器会话内记忆,刷新/返回后自动还原 |
| 空值筛选 | 负责人、供应商等字段支持输入「空」专门筛出未填写的数据 |
| 无数据 | 列表区显示「暂无数据」占位,不报错 |
| 排序 | 默认按申请日期倒序,其次流程编号倒序 |
| 加载与提示 | 查询期间显示加载遮罩;操作结果以顶部浮动提示反馈 |
---
## 三、功能①:采购申请管理
### 3.1 功能概述
面向采购人员,提供研发采购申请单的**检索、逐条物料维护、追溯与批量处理**能力。是研发采购数据的主维护入口。
### 3.2 业务流程
```
按条件检索申请单 → 定位到单张申请单 → 打开详情
├─ 物料维护:补充报价/供应商/负责人/状态/交期 → 保存
├─ 采购订单:查看已转出的 PO 及转单时效
├─ 收料通知:查看已收料记录
└─ 收货汇总:查看每行物料的收货进度与延期
勾选多张申请单 → 批量汇总(多单物料合并查看 + 金额合计)
勾选申请单 → 导出 Excel 模板 → 线下批量填写 → 导入回写
```
### 3.3 页面一:申请单列表
#### 3.3.1 筛选条件(11 项)
| 筛选项 | 控件 | 匹配方式 |
| --- | --- | --- |
| 流程编号 | 文本 | 模糊 |
| 单据编号 | 文本 | 模糊 |
| 申请日期 | 日期 | 精确 |
| 研发项目 | 文本 | 模糊 |
| 专项名称 | 文本 | 模糊 |
| 申请人 | 文本 | 模糊 |
| 物料编码 | 文本 | 按明细模糊(命中一张单任意一行即返回整单) |
| 策略采购负责人 | 文本 | 按明细模糊,可输入「空」 |
| 研发采购负责人 | 文本 | 按明细模糊,可输入「空」 |
| 供应商 | 文本 | 按明细模糊,可输入「空」 |
| 业务状态 | 下拉 | 精确,含「全部 / -- / 1~9」 |
**操作按钮**:查询、重置、批量汇总、导出 Excel、导入 Excel
#### 3.3.2 列表字段
| 列 | 说明 |
| --- | --- |
| 勾选框 | 支持单行勾选与全选本页 |
| 序号 | 跨页连续编号 |
| 流程编号 | OA 流程编号 |
| 单据编号 | 采购申请单号(关联 ERP 的凭证) |
| 申请日期 | 单据提交日期 |
| 研发项目 | 所属研发项目名称 |
| 专项名称 | OA 流程标题 |
| 申请人 | 提出人 |
| 单据状态 | 取该单**第一行物料**的业务状态 |
| 项目经理审批时间 | 审批节点完成时间,作为时效计算起点 |
#### 3.3.3 每页条数
可选 50 / 100 / 200 / 1000 / 2000 条。
### 3.4 页面二:申请单详情
点击列表任意一行进入。顶部固定展示单据主信息:**流程编号、单据编号、申请日期、研发项目、专项名称、申请人、项目经理审批时间**。
详情页含 **4 个页签**。
#### 3.4.1 页签① 物料维护(核心)
按物料逐行维护,可维护字段:
| 类别 | 字段 |
| --- | --- |
| 交期 | 物料标准 L/T、计划交付日期(策略采购)、计划交付日期(研发采购) |
| 价格 | 第一轮报价、第一轮总金额、第二轮报价、第二轮总金额 |
| 责任与供应 | 供应商、策略采购负责人、研发采购负责人 |
| 状态与风险 | 业务状态、交付风险等级、交付节奏 |
**业务规则:**
- **总金额自动计算** = 报价 × 申请数量,不可手工填写;修改报价后总金额实时重算;
- 表格顶部实时展示**第一轮总金额合计**与**第二轮总金额合计**;
- 支持前端快捷筛选:供应商、策略采购负责人可按「全部 / 为空 / 不为空 / 指定值」过滤,便于批量定位待处理行;
- 提供**块复制物料编码**按钮:按当前筛选结果导出全部物料编码(换行分隔),可直接整块粘贴到金蝶云星空物料编码列;
- 保存后即时提示保存结果;日期字段留空时不覆盖原有值。
#### 3.4.2 页签② 采购订单
| 列 | 说明 |
| --- | --- |
| 采购订单号 | 该申请单已转出的 PO 单号 |
| 单据日期 | PO 日期 |
| 转单时效(天) | 采购订单日期 − 项目经理审批时间 |
| 对应申请单物料(行号) | 该 PO 行对应的申请单行号 |
#### 3.4.3 页签③ 收料通知
| 列 | 说明 |
| --- | --- |
| 通知单号 | 收料通知单号 |
| 单据日期 | 收料日期 |
| 对应申请单物料(行号) | 对应申请单行号 |
#### 3.4.4 页签④ 收货汇总
| 列 | 说明 |
| --- | --- |
| 行号 | 申请单物料行号 |
| 物料编码 / 物料名称 | 物料标识 |
| 申请数量 / 已收数量 / 剩余数量 | 收货进度 |
| 最近到货日期 | 最后一次收料日期 |
| 状态 | 已完成(已收≥申请)/ 部分收货 / 未收货 |
| 项目目标交付延期 | 策略计划交付日期 − 最近到货日期 |
| 标准交付延期 | 要求交付日期 − 最近到货日期 |
### 3.5 页面三:批量汇总
- 在列表中勾选多张申请单后点击「批量汇总」,进入汇总页;
- 汇总展示所选申请单的**全部物料明细**,并给出**第一轮总金额合计**与**第二轮总金额合计**;
- 支持分页浏览与**页面截图**(便于直接贴到汇报材料或群里同步)。
### 3.6 Excel 导出
- 勾选申请单后导出,未勾选时不导出并提示;
- 导出内容为**维护模板**(含全部可维护字段 + 单据基础信息),文件命名格式:`采购申请维护数据_YYYY-MM-DD.xls`;
- 业务状态、交付风险、交付节奏等字典字段**导出为中文文本**,便于线下选择与填写。
### 3.7 Excel 导入
- 上传填好的 Excel 回写系统,支持 `.xls / .xlsx`;
- **匹配主键**:流程编号 + 明细序号 + 物料编号,三者齐全才能定位到行;
- **业务规则**:
- 三项主键任一为空 → 该行计入失败,不影响其他行;
- **总金额列以系统重算为准**(报价 × 申请数量),忽略 Excel 中填写的金额;
- 中文状态/风险/节奏自动反查编码,匹配不到则置为「未维护」;
- 日期支持「2026-07-24」文本格式与 Excel 数字序列两种写法;
- 导入完成后提示:`导入完成:成功 X 条,失败 Y 条`,并列出失败明细。
---
## 四、功能②:研发采购看板
### 4.1 功能概述
面向研发人员,从**物料维度**查看自己发起的采购申请进展,并直接维护物料的执行信息。与功能①的差异:① 是「一张单一行」,② 是「一条物料一行」。
### 4.2 筛选条件(9 项)
| 筛选项 | 控件 | 说明 |
| --- | --- | --- |
| 流程编号 | 文本 | 模糊 |
| 申请人 | 文本 | 模糊 |
| 专项名称 | 文本 | 模糊 |
| 研发项目 | 文本 | 模糊 |
| 物料编码 | 文本 | 模糊 |
| 物料名称 | 文本 | 模糊 |
| 策略采购负责人 | 文本 | 模糊 |
| 研发采购负责人 | 文本 | 模糊 |
| 业务状态 | **多选下拉** | 可同时勾选多个状态,如「待报价 + 待ED审批」 |
**操作按钮**:查询、重置、导出 Excel
### 4.3 列表字段
| 列 | 说明 |
| --- | --- |
| 勾选框 | 支持单行勾选与全选本页 |
| 序号 | 跨页连续编号 |
| 流程编号 | — |
| 申请日期 | — |
| 物料编码 | 研发物料编码 |
| 物料名称 | — |
| 申请数量 | — |
| 研发项目 | — |
| 申请人 | — |
| 专项名称 | — |
| 业务状态 | 中文简称展示(转单追踪/待报价/待ED审批/ED驳回/ED已审批/驳回/撤回/取消/量产复用) |
| 策略采购负责人 | — |
| 研发采购负责人 | — |
| 计划交付日期(策略采购) | — |
| 计划交付日期(研发采购) | — |
**每页条数**:20 / 50 / 100 / 200,默认 20。
### 4.4 导出
勾选行后导出为 `.xlsx`,含 13 列:流程编号、申请日期、研发项目、申请人、专项名称、物料编码、物料名称、申请数量、业务状态、策略采购负责人、研发采购负责人、计划交付日期(策略采购)、计划交付日期(研发采购)。列宽自适应。
### 4.5 下钻
点击任意一行进入**采购看板详情页**,页签结构与功能①详情页一致:物料明细(可保存维护)、采购订单、收料通知、收货汇总。
### 4.6 权限
仅研发角色(YF01)可见,无该角色的账号访问时提示无权限并退回登录页。
---
## 五、功能③:研发采购全链路看板
### 5.1 功能概述
把**申请 → 采购订单 → 收料入库**三段数据拼在一行里展示,回答"这颗料现在到哪一步了、卡了多久"。是四个功能中字段最全、唯一覆盖采购执行结果的一张表。
### 5.2 筛选条件(4 项)
| 筛选项 | 控件 | 说明 |
| --- | --- | --- |
| 关键词 | 文本 | 全局模糊:申请单号 / 物料编码 / 物料名称 / 采购员 |
| 业务状态 | 下拉 | 带编码 + 名称(如「2 - 供应链-待供应商报价」) |
| 交付风险 | 下拉 | 超高/高/中/低/已完成/取消 |
| 采购员 | 文本 | 研发采购员或策略采购员 |
**操作按钮**:查询、重置、刷新。支持关键词/采购员输入框回车直接查询。
**每页条数**:20 / 50 / 100 / 200,默认 50。
### 5.3 列表字段(32 列,分五组)
**A 组|申请信息**
序号、流程编号、申请日期、物料编码、物料名称、申请数量、单据编号、专项名称、申请人、研发项目、项目经理审批时间
**B 组|价格与交期**
物料标准 L/T、第一轮报价、第一轮总金额、第二轮报价、第二轮总金额、研发采购计划到货、策略采购计划到货
**C 组|状态与责任**
业务状态(彩色标签:待报价/待ED审批=黄,ED驳回/研发驳回/撤回/取消=红,ED已审批=绿)、交付风险、交付节奏、规格、策略采购员、研发采购员、供应商
**D 组|采购订单**
采购订单号、采购订单日期、转单超期时间(天)、采购数量
**E 组|收料**
收料通知单号、收料通知日期、收料数量
**交互特性**:
- 表头冻结,列宽可鼠标拖动调整;
- 无数据的单元格统一显示「-」;
- 业务状态以彩色标签区分紧急程度。
### 5.4 关键指标:转单超期时间
> **转单超期时间(天)= 最早采购订单日期 − 项目经理审批时间**
> - 尚未转出采购订单:以**当前日期**代替采购订单日期继续计算,天数持续累积;
> - 项目经理审批时间为空:不计算,显示「-」。
这是衡量"审批通过后采购多久才下单"的核心指标,也是功能④区域①的明细数据来源。
### 5.5 业务规则
- 采购订单、收料通知均只统计**已审核**状态的单据;
- 一张申请单可能拆成多张 PO、多张收料单,多单号在单元格内合并展示,数量为合计值;
- 采购订单与收料数据按**物料行号**精确匹配到申请单行。
---
## 六、功能④:研发订单考核时效看板
### 6.1 功能概述
分**两个考核区域**,对研发采购的两个关键时效做风险分级,并支持下钻到项目、采购负责人、明细行,实现"发现问题 → 定位项目 → 落地到责任人"。
| 区域 | 考核内容 | 回答的问题 |
| --- | --- | --- |
| ① 审批与转单考核时效 | 审批通过 → 转成采购订单 用了多久 | 采购**下单**慢不慢 |
| ② 到料考核时效 | 实际收料 相对承诺/标准交期 差多少 | 物料**到货**准不准 |
两个区域均为**三级下钻**:一级看整体分布 → 二级看研发项目与采购负责人 → 三级看单据明细。
### 6.2 区域①:审批与转单考核时效
#### 6.2.1 一级看板
- 按**单据用途**分 4 张卡片:**生产 / 研发 / 售后 / 总计**;
- 每张卡片展示 4 档风险的数量及合计单数,并按颜色区分:超高(红)、高(橙)、中(黄)、低(绿);
- 「超高」档标注说明:**(无采购订单)**,即审批通过超过阈值仍未转单;
- 顶部明示阈值说明:`高 > 5 天,中 > 2 且 ≤ 5,低 ≤ 2;无采购订单超过 5 天为超高(无采购订单)`。
#### 6.2.2 风险判定规则
| 风险档位 | 判定条件 |
| --- | --- |
| 超高 | 未转出采购订单 且 超过高阈值(>5 天) |
| 高 | 已转采购订单 且 时效 > 高阈值(>5 天) |
| 中 | 已转采购订单 且 低阈值 < 时效 ≤ 高阈值 |
| 低 | 其余(含未转单但 ≤ 高阈值) |
> 时效 = 最早采购订单日期 − 项目经理审批时间;未转单时以当前日期计算。
> 项目经理审批时间为空的单据**不参与统计**。
#### 6.2.3 二级看板(点击一级数字下钻,新窗口打开)
- 口径:按**研发项目**分行,列 = 该项目的**各策略采购负责人** + 「未分配」;
- 「未分配」列固定排在最后;无项目的单据归入「(未指定项目)」;
- 表头展示当前筛选条件(用途 + 风险等级)。
#### 6.2.4 三级明细
| 列 | 说明 |
| --- | --- |
| 流程编号 / 单据编号 | 定位单据 |
| 研发项目 / 采购负责人 | 定位责任 |
| 行号 / 物料名称 / 规格 | 定位物料 |
| 项目经理审批时间 | 计时起点 |
| 最早采购订单日期 | 计时终点(无则为空) |
| 时效(天) | 计算结果 |
| 风险等级 | 超高/高/中/低 |
三级支持分页浏览。
### 6.3 区域②:到料考核时效
#### 6.3.1 三种考核分类
| 分类 | 名称 | 考核基准(承诺该到的日期) | 回答的问题 |
| --- | --- | --- | --- |
| `project` | 项目需求达成风险 | 要求交付日期 | 按项目原本要求,到货晚不晚 |
| `promise` | 采购承诺达成风险 | 计划交付日期(研发采购) | 按采购自己承诺的日期,兑现没有 |
| `std` | 标准采购周期达成风险 | 标准交付日期 = 要求交付日期 + 物料标准 L/T | 按物料标准周期,是否合理 |
#### 6.3.2 一级看板
- 按**三个考核分类**分别成块展示,每块内再按用途分 4 张卡片(生产/研发/售后/总计);
- 每张卡片展示 4 档风险数量与合计;
- 「超高」档标注说明:**(未到料)**;
- 顶部明示阈值说明:`高 > 4 天,中 > 2 且 ≤ 4,低 ≤ 2;未收料为超高(未到料)`。
#### 6.3.3 风险判定规则
| 风险档位 | 判定条件 |
| --- | --- |
| 超高 | 尚未收料(无论超期多久) |
| 高 | 已收料 且 时效 > 高阈值(>4 天) |
| 中 | 已收料 且 低阈值 < 时效 ≤ 高阈值 |
| 低 | 已收料 且 时效 ≤ 低阈值(≤2 天) |
> 时效 = 最早收料日期 − 基准交付日期。
> **基准交付日期为空的行不参与统计。**
#### 6.3.4 二级 / 三级
- 二级:按研发项目分行,列 = 各策略采购负责人 + 「未分配」,与区域①结构一致,但需指定考核分类;
- 三级:明细列表,除单据与责任人信息外,额外展示**本次考核使用的基准字段、基准交付日期、最早收料日期、时效天数、风险等级**(未收料时效显示为空)。
### 6.4 交互约定
- 一级看板默认进入即加载,提供「刷新」按钮;
- 二级、三级均以**新窗口**打开,便于对照查看;
- 三级支持分页。
---
## 七、四个功能的定位对比
| 维度 | ① 采购申请管理 | ② 研发采购看板 | ③ 研发采购全链路看板 | ④ 研发订单考核时效看板 |
| --- | --- | --- | --- | --- |
| 数据粒度 | 单据级 | 物料级 | 物料级 | 物料级(考核口径) |
| 核心用途 | 维护 + 追溯 | 查询 + 维护 | 一屏看全过程 | 时效考核 + 责任下钻 |
| 是否可维护 | ✅ 支持保存 | ✅ 支持保存 | ❌ 只读 | ❌ 只读 |
| 是否含 PO/收料 | ✅ 详情页签 | ✅ 详情页签 | ✅ 主表直出 | ✅(作为计算依据) |
| 导入导出 | ✅ 导出模板 + 导入回写 | ✅ 仅导出 | ❌ | ❌ |
| 使用角色 | 采购 | 研发 | 研发 + 采购 | 研发 + 采购 |
| 输出形态 | 列表 + 详情页 | 列表 + 详情页 | 单张宽表 | 卡片 + 下钻三层 |
**典型使用路径:**
- 采购日常维护 → ① 检索申请单 → 详情页维护 → 批量 Excel 处理
- 研发跟进进度 → ② 按项目/负责人查物料 → 补充交期与状态
- 周会看全貌 → ③ 一张表看完申请、下单、收料与转单超期
- 月度考核 → ④ 看风险分布 → 下钻到项目 → 落地到采购负责人
---
## 八、待确认的业务问题
| # | 问题 | 影响 | 建议确认方 |
| --- | --- | --- | --- |
| 1 | 采购申请单与 ERP 采购订单按**单据编号**还是**流程编号**关联?研发采购流程存在单据编号为空的情况 | 影响全链路看板与所有时效计算的准确性 | 采购 + IT |
| 2 | 时效阈值(转单 5/2 天、到料 4/2 天)是否符合当前管理要求,是否需按物料类别差异化 | 影响风险等级分布与考核结果 | 采购负责人 |
| 3 | 「未转单」场景下持续用当前日期累计天数,是否需要在单据关闭/取消后停止计算 | 影响超高风险数量是否虚高 | 采购 + 研发 |
| 4 | 到料考核三种分类是否需要全部保留,还是固定一种作为主口径 | 影响看板复杂度与解读成本 | 研发 + 采购 |
| 5 | 所有看板仅统计当年数据,跨年项目如何跟踪?是否需要放开年度筛选 | 影响跨年项目的可见性 | 业务方 |
| 6 | 「未分配」(无采购负责人)的物料由谁跟进、如何认领 | 影响责任闭环 | 采购负责人 |
| 7 | 业务状态字典中「6/7/8/9」四类研发侧状态是否应从时效考核中剔除 | 影响考核基数是否合理 | 采购 + 研发 |
| 8 | 全链路看板 32 列是否需按角色裁剪(研发看申请+交期,采购看订单+收料) | 影响易用性 | 研发 + 采购 |