> **源文件**：仪陇表务管理系统-PRD-04-功能需求说明-03-采购管理-V1.0.docx
> **导出时间**：2026-05-26 10:34


**仪陇表务管理系统
产品需求说明书
04-功能需求说明
采购管理**

文档版本：V1.0

对应 01 版本：仪陇表务管理系统-PRD-01-总体说明-V1.0

模块序号：03

模块名称：采购管理

## 采购管理

本模块覆盖分公司采购申请、采购计划维护及到货登记，对应《PRD-01》采购管理能力。含 Web 菜单：采购申请、采购计划。审批在工单中心办理，到货后驱动落地检。

### **采购申请**

#### 功能描述

分公司发起采购申请，填写申请基础信息与采购需求明细，提交后自动生成采购类工单并完成逐级审核；通过后驱动采购计划生成。

#### 菜单权限

表务分公司库管员；表务分公司管理人员；表务系统管理员

#### 数据权限

表务分公司库管员：可见、可发起本分公司采购申请；「历史记录」Tab 仅展示本人发起的申请工单。

表务分公司管理人员：可见本分公司采购申请数据（只读，不可发起，除非兼岗库管员）。

表务系统管理员：可见、可操作全公司范围内采购申请数据。

其他角色通过工单中心查看与办理审批，无本菜单发起权限。

#### 核心逻辑

提交时生成采购申请主记录、采购需求明细及关联工单，对接 workflow 引擎。

终审通过后系统自动拆分生成采购计划及到货记录，不在本菜单维护计划与到货。

#### 业务流程

流程概要

分公司库管员发起 → 分公司综合办主任一级审核 → 分公司分管领导二级审核 → 水表管理中心主任/副主任三级审核 → 招采部部长/副部长四级审核 → 系统自动按规则拆分生成采购计划；后续采购履约与到货在「采购计划」菜单办理。

环节说明表

| 序号 | 环节名称 | 环节类型 | 责任岗位 | 须填写 / 处理内容 | 审核结果选项 | 通过后流向 | 驳回 / 其他结果流向 | 抄送 |
| --- | --- | --- | --- | --- | --- | --- | --- | --- |
| 1 | 采购申请发起 | 发起 | 分公司库管员 | 填报采购申请基础信息及采购需求明细（见「一级页面：采购申请-tab-工单发起」） | 提交 | 采购申请一级审核 | — | — |
| 2 | 采购申请一级审核 | 审核 | 分公司综合办主任 | 核查申请合理性与基础合规性；填写审核意见 | 通过；驳回 | 采购申请二级审核 | 退回采购申请发起 | — |
| 3 | 采购申请二级审核 | 审核 | 分公司分管领导 | 复核业务匹配度与审批合规性；填写审核意见 | 通过；驳回 | 采购申请三级审核 | 退回采购申请一级审核 | — |
| 4 | 采购申请三级审核 | 审核 | 水表管理中心主任 / 副主任 | 核验需求必要性、参数适配性；填写审核意见 | 通过；驳回 | 采购申请四级审核 | 退回采购申请二级审核 | — |
| 5 | 采购申请四级审核 | 审核 | 分公司招采部部长 / 副部长 | 审核预算及采购合规性；填写审核意见 | 通过；驳回 | 流程通过（系统自动） | 退回采购申请三级审核 | — |
| 6 | 自动生成采购计划 | 系统自动 | 系统 | 终审通过后按厂家、物资类型、口径、所属分公司自动拆分生成采购计划及到货记录 | — | 流程完结（待采购履约） | — | — |

审核通过后数据影响

更新采购申请记录及关联工单状态为「已通过」。

自动创建采购计划及到货主记录（可按一单申请拆分为多份计划）。

招采部在「采购计划」维护合同、预计到货日期等履约信息。

到货登记后创建水表主数据，状态为「待落地检」，并写入到货台账。

关联界面逻辑闭环

发起侧：「历史记录」Tab 展示工单状态、当前节点；通过后展示关联采购计划单号及到货状态。

办理侧：「去处理」跳转工单中心「二级页面：工单办理」。

计划侧：「采购计划」列表出现新计划记录，支持到货登记；状态与采购申请、工单中心一致。

检定侧：到货登记完成后，「落地检管理」可见待落地检水表。

审核界面说明

标准界面：工单中心「二级页面：工单办理」；含申请信息只读区、采购明细只读区、审批记录、审核意见、通过/驳回。

本业务差异：各审核环节只读展示完整申请信息及采购需求明细；无额外填报区块。

#### 功能需求

##### **一级页面：采购申请-tab-工单发起**

#整体布局

-- 菜单入口：Tab 页结构；Tab 列表：工单发起（本 Tab，默认选中）、历史记录

-- 本 Tab：采购申请表单 + 采购需求明细表格；底部「提交」「重置」

#信息展示

-- 申请部门：只读，默认当前用户所属部门

-- 申请人：只读，默认当前登录用户

-- 申请日期：只读，默认当前日期

-- 需求说明：选填，多行文本

-- 备注：选填，多行文本

-- 采购需求明细区：表格，支持新增行、删除行（至少 1 行）

-- 水表口径：必填，下拉

-- 水表类型：必填，下拉（物联网表 / 机械表等）

-- 申请数量：必填，正整数

-- 厂家：选填，下拉（可选范围来自厂家管理）

-- 明细备注：选填

#底部按钮

-- 提交：校验后提交，进入采购申请审批流程

-- 重置：清空表单；有内容时二次确认

#交互说明

-- 提交成功后切换至「历史记录」Tab 并刷新

##### **一级页面：采购申请-tab-历史记录**

#整体布局

-- Tab「历史记录」；查询区 + 列表；数据范围：仅当前账号发起的采购申请工单

#查询条件

-- 工单编号、申请单号、工单状态、申请日期范围；查询、重置

#数据列表

-- 表格字段：工单编号、申请单号、申请日期、申请总数量、当前节点、工单状态、关联计划单号、提交时间

-- 行内操作：详情

#交互说明

-- 打开「弹窗：采购申请工单详情」

##### **弹窗：采购申请工单详情**

#弹窗类型

-- 抽屉弹窗（右侧）；遮罩：有

#信息展示

-- Tab：申请信息 / 采购明细 / 审批记录；通过后展示关联采购计划单号

#底部按钮

-- 关闭；去处理：审批中且当前用户为处理人时显示

### **采购计划**

#### 功能描述

执行采购履约与到货管理；支持计划直接新建、关联已审批采购申请生成、合同录入、到货登记及台账查询；招采部可与检定中心协同到货签收。

#### 菜单权限

表务水表采购；表务总公司管理人员；表务水表管理中心；表务系统管理员

#### 数据权限

表务水表采购、表务总公司管理人员：可见、可操作全公司范围内采购计划及到货数据。

表务水表管理中心：可见全公司计划数据（协同到货签收场景，只读或按岗位授权登记）。

表务系统管理员：可见、可操作全公司数据。

表务分公司库管员：可见关联本分公司申请的计划数据（只读，不可维护履约）。

#### 核心逻辑

以采购计划及到货记录为业务主体；审批通过后自动创建计划，亦可无申请直接新建。

到货登记联动创建水表主数据、到货台账及生命周期记录，状态初始为待落地检。

#### 功能需求

##### **一级页面：采购计划**

#整体布局

-- 查询条件 + 采购计划列表；顶部「新建计划」「到货登记」

#查询条件

-- 采购计划单号、厂家、到货状态、预计到货日期范围、关联申请单号

-- 功能按钮：查询、重置、导出

#数据列表

-- 表格字段：计划单号、厂家、水表口径、水表类型、计划数量、合同编号、预计到货日期、实际到货日期、到货状态、关联申请单号

-- 行内操作：详情、到货登记（待到货/部分到货时）、编辑（履约信息）

#交互说明

-- 「新建计划」打开「弹窗：新建/编辑采购计划」（无采购申请时直建）

-- 「到货登记」打开「弹窗：到货登记」

-- 点击详情打开「弹窗：采购计划详情」

##### **弹窗：新建/编辑采购计划**

#弹窗类型

-- 居中模态弹窗；遮罩：有

#信息展示

-- 关联采购申请单号：选填（来源于已通过申请时系统带入；直建时为空）

-- 厂家：必填，下拉

-- 水表口径、水表类型：必填

-- 计划数量：必填，正整数

-- 所属分公司：必填（拆分维度）

-- 合同编号：选填

-- 采购时间、预计到货日期：选填，日期

-- 备注：选填

#底部按钮

-- 保存；取消

#交互说明

-- 保存后刷新列表；支持一单申请关联生成（审批通过自动创建时只读打开详情）

##### **弹窗：到货登记**

#弹窗类型

-- 居中模态弹窗；遮罩：有

#弹窗标题

-- 到货登记 - {采购计划单号}

#信息展示

-- 计划信息只读：计划单号、厂家、口径、类型、计划数量

-- 实际到货日期：必填

-- 到货数量：必填，正整数

-- 签收人：只读，默认当前用户

-- 到货水表明细：支持扫码/手工录入水表编号、出厂编号等（按到货数量）

-- 落地检完成时限：选填，日期

-- 附件：选填，上传签收凭证

-- 备注：选填

#底部按钮

-- 确认到货；取消

#交互说明

-- 确认后更新计划到货状态；自动创建水表主数据（状态待落地检）及到货台账、生命周期「到货」阶段

-- 驱动「落地检管理」待检清单

##### **弹窗：采购计划详情**

#弹窗类型

-- 抽屉弹窗（右侧）；只读 + 操作按钮

#信息展示

-- 计划主信息、到货记录、关联申请及审批摘要、到货水表明细

#底部按钮

-- 关闭；编辑；到货登记（按状态显示）

---

## 详细设计（研发）

> 以下内容合并自 `design/功能设计/`，与 PRD 需求章节配套使用。数据模型详见 `design/数据库设计-V1.0.md`。

### 仪陇表务-功能设计-03-采购管理-V1.0


## 1. 模块概述

| 项 | 说明 |
|----|------|
| 模块序号 | 03 |
| 模块名称 | 采购管理 |
| 后端包（建议） | `com.tofly.wm.manage.puachase` |
| 业务模式 | 申请工单+计划直办 |
| 工单 | PURCHASE_APPLY，四级审批 |

## 2. 功能范围

- 采购申请
- 采购计划
- 到货登记

## 3. 数据模型

### 3.1 涉及表

- `wssmet_purapply_w`
- `wssmet_purapplylist_w`
- `wssmet_purplan_w`
- `wssmet_purplanarr_w`
- `wssmet_purplanarrlist_w`

### 3.2 实体约定

- 所有实体 `extends BaseEntity`；逻辑删除 `Boolean deleted` ↔ `deleted`。
- 字典 `DictEntry` + `@DictDirectory(MeterConstant.*)` ↔ 库列 `VARCHAR2`；组织/用户 `OrganizationEntry`/`UserNameEntry` ↔ 库列 `NUMBER(19)`；附件 `FileEntryList`/`FileEntry` 用 `@TableField(exist = false)`，**无库列**。
- 申请类主表含 `process_instance_id / work_order_code / approve_status`；工单反查 `（无本地表，见 workflow）.TABLE_NAME` + `TABLE_ID`。

## 4. 业务流程

申请→四级审批→自动生成计划→履约/到货→创建 Meter(待落地检)。

## 5. 核心业务规则

- 终审按厂家/口径/类型/分公司拆分计划
- 到货附件为 `FileEntryList`，`@TableField(exist = false)`，无库列

## 6. 接口设计（概要）

| 方法 | 路径（示例前缀） | 说明 |
|------|------------------|------|
| — | `/purchaseApply/` | 见 PRD 界面 |
| — | `/purchaseApply/page` | 见 PRD 界面 |
| — | `/purchasePlan/` | 见 PRD 界面 |
| — | `/purchasePlan/arrive` | 见 PRD 界面 |

- 标准 CRUD 另含：`GET /page`、`GET /list`、`POST /update`、`DELETE /{id}`、`DELETE /deleteByIds`。
- 返回体：须为带**具体**泛型的 `ResultResponse<...>`，见下文 §接口设计（研发）各接口出参（**禁止** `T`/`Vo` 占位）。

## 7. 权限与数据范围

遵循 PRD-02：菜单角色 + 组织数据权限 + 工单岗位权限；具体角色见 PRD-04 各功能「菜单权限」「数据权限」章节。

## 8. 上下游依赖

| 上游 | 下游 |
|------|------|
| 见 PRD-03 流程说明 | 见 PRD-01 总体主流程 |

---

*本设计仅依据 `../demand/` PRD 与 [数据库设计-V1.0.md](../数据库设计-V1.0.md)；实现时遵循 `java6/java-ylsw-bw.md` 与 `database-design.mdc`（`wssmet_*` 表名），**不参照**存量业务表与接口。*



---

## 接口设计（研发）

> 统一前缀：`/api/wm/manage/purchase`；各接口 **出参** 须为具体泛型（见下文，**禁止** `T`/`Vo` 占位）；公共约定见 [仪陇表务-公共接口说明-V1.0.md](./仪陇表务-公共接口说明-V1.0.md)。

#### 采购申请-分页查询

| 项 | 内容 |
|----|------|
| 接口说明 | 分页查询采购申请 |
| 请求地址 | `GET /api/wm/manage/purchase/purchaseApply/page` |
| 请求类型 | GET |

**入参（Query（PageQuery））**

| 字段 | 类型 | 说明 |
|------|------|------|
| applyCode | String | 申请编号 |
| applyDate | Date | 申请日期 |
| demandDesc | String | 需求 |
| processStatusCode | String（枚举 code） | 流程状态 |
| remark | String | 备注 |
| workOrderCode | String | 工单编号（展示/台账查询） |
| approveStatus | String（枚举 code） | 审批状态 |

**出参**

- ResultResponse<PageInfo<PurchaseApplyVo>>

#### 采购申请-列表查询

| 项 | 内容 |
|----|------|
| 接口说明 | 列表查询采购申请 |
| 请求地址 | `GET /api/wm/manage/purchase/purchaseApply/list` |
| 请求类型 | GET |

**入参（Query）**

| 字段 | 类型 | 说明 |
|------|------|------|
| applyCode | String | 申请编号 |
| applyDate | Date | 申请日期 |
| demandDesc | String | 需求 |
| processStatusCode | String（枚举 code） | 流程状态 |
| remark | String | 备注 |
| workOrderCode | String | 工单编号（展示/台账查询） |
| approveStatus | String（枚举 code） | 审批状态 |

**出参**

- ResultResponse<List<PurchaseApplyVo>>

#### 采购申请-详情

| 项 | 内容 |
|----|------|
| 接口说明 | 查询采购申请详情 |
| 请求地址 | `GET /api/wm/manage/purchase/purchaseApply/{id}` |
| 请求类型 | GET |

**入参（Path: id）**

| 字段 | 类型 | 说明 |
|------|------|------|
| id | String | 主键 |

**出参**

- ResultResponse<PurchaseApplyVo>（含明细 list 若适用）

#### 采购申请-新增

| 项 | 内容 |
|----|------|
| 接口说明 | 新增采购申请；提交时同步发起 workflow，回写 process_instance_id / work_order_code / approve_status |
| 请求地址 | `POST /api/wm/manage/purchase/purchaseApply/` |
| 请求类型 | POST |

**入参（Body: Dto）**

| 字段 | 类型 | 说明 |
|------|------|------|
| applyCode | String | 申请编号 |
| applyDeptId | Long | 申请部门ID，关联tf_org表的id字段 |
| applyUserId | Long | 申请用户ID，关联tf_user表的id字段 |
| applyDate | Date | 申请日期 |
| demandDesc | String | 需求 |
| processStatusCode | String（枚举 code） | 流程状态 |
| remark | String | 备注 |
| processInstanceId | Long | workflow 流程实例ID（工单中心外挂，不落本地工单表） |
| workOrderCode | String | 工单编号（展示/台账查询） |
| approveStatus | String（枚举 code） | 审批状态 |

**出参**

- ResultResponse<Long>

#### 采购申请-修改

| 项 | 内容 |
|----|------|
| 接口说明 | 修改采购申请 |
| 请求地址 | `POST /api/wm/manage/purchase/purchaseApply/update` |
| 请求类型 | POST |

**入参（Body: Dto（含 id））**

| 字段 | 类型 | 说明 |
|------|------|------|
| applyCode | String | 申请编号 |
| applyDeptId | Long | 申请部门ID，关联tf_org表的id字段 |
| applyUserId | Long | 申请用户ID，关联tf_user表的id字段 |
| applyDate | Date | 申请日期 |
| demandDesc | String | 需求 |
| processStatusCode | String（枚举 code） | 流程状态 |
| remark | String | 备注 |
| processInstanceId | Long | workflow 流程实例ID（工单中心外挂，不落本地工单表） |
| workOrderCode | String | 工单编号（展示/台账查询） |
| approveStatus | String（枚举 code） | 审批状态 |

**出参**

- ResultResponse<Void>

#### 采购申请-删除

| 项 | 内容 |
|----|------|
| 接口说明 | 逻辑删除采购申请（支持批量） |
| 请求地址 | `DELETE /api/wm/manage/purchase/purchaseApply/deleteByIds?ids=1,2` |
| 请求类型 | DELETE |

**入参（Query: ids）**

| 字段 | 类型 | 说明 |
|------|------|------|
| ids | String | 主键，逗号分隔 |

**出参**

- ResultResponse<Void>

#### 采购申请明细-分页查询

| 项 | 内容 |
|----|------|
| 接口说明 | 分页查询采购申请明细 |
| 请求地址 | `GET /api/wm/manage/purchase/purchaseApplyList/page` |
| 请求类型 | GET |

**入参（Query（PageQuery））**

| 字段 | 类型 | 说明 |
|------|------|------|
| caliberCode | String（字典 code） | 口径编号 |
| meterTypeCode | String（字典 code） | 水表类型编号 |
| applyQty | Integer | 申请数量 |
| remark | String | 备注 |

**出参**

- ResultResponse<PageInfo<PurchaseApplyListVo>>

#### 采购申请明细-列表查询

| 项 | 内容 |
|----|------|
| 接口说明 | 列表查询采购申请明细 |
| 请求地址 | `GET /api/wm/manage/purchase/purchaseApplyList/list` |
| 请求类型 | GET |

**入参（Query）**

| 字段 | 类型 | 说明 |
|------|------|------|
| caliberCode | String（字典 code） | 口径编号 |
| meterTypeCode | String（字典 code） | 水表类型编号 |
| applyQty | Integer | 申请数量 |
| remark | String | 备注 |

**出参**

- ResultResponse<List<PurchaseApplyListVo>>

#### 采购申请明细-详情

| 项 | 内容 |
|----|------|
| 接口说明 | 查询采购申请明细详情 |
| 请求地址 | `GET /api/wm/manage/purchase/purchaseApplyList/{id}` |
| 请求类型 | GET |

**入参（Path: id）**

| 字段 | 类型 | 说明 |
|------|------|------|
| id | String | 主键 |

**出参**

- ResultResponse<PurchaseApplyListVo>（含明细 list 若适用）

#### 采购申请明细-新增

| 项 | 内容 |
|----|------|
| 接口说明 | 新增采购申请明细 |
| 请求地址 | `POST /api/wm/manage/purchase/purchaseApplyList/` |
| 请求类型 | POST |

**入参（Body: Dto）**

| 字段 | 类型 | 说明 |
|------|------|------|
| applyId | Long | 采购申请ID，关联wssmet_purapply_w表的id字段 |
| caliberCode | String（字典 code） | 口径编号 |
| meterTypeCode | String（字典 code） | 水表类型编号 |
| applyQty | Integer | 申请数量 |
| brandId | Long | 厂家ID，关联wssmet_meterbrand_w表的id字段 |
| remark | String | 备注 |

**出参**

- ResultResponse<Long>

#### 采购申请明细-修改

| 项 | 内容 |
|----|------|
| 接口说明 | 修改采购申请明细 |
| 请求地址 | `POST /api/wm/manage/purchase/purchaseApplyList/update` |
| 请求类型 | POST |

**入参（Body: Dto（含 id））**

| 字段 | 类型 | 说明 |
|------|------|------|
| applyId | Long | 采购申请ID，关联wssmet_purapply_w表的id字段 |
| caliberCode | String（字典 code） | 口径编号 |
| meterTypeCode | String（字典 code） | 水表类型编号 |
| applyQty | Integer | 申请数量 |
| brandId | Long | 厂家ID，关联wssmet_meterbrand_w表的id字段 |
| remark | String | 备注 |

**出参**

- ResultResponse<Void>

#### 采购申请明细-删除

| 项 | 内容 |
|----|------|
| 接口说明 | 逻辑删除采购申请明细（支持批量） |
| 请求地址 | `DELETE /api/wm/manage/purchase/purchaseApplyList/deleteByIds?ids=1,2` |
| 请求类型 | DELETE |

**入参（Query: ids）**

| 字段 | 类型 | 说明 |
|------|------|------|
| ids | String | 主键，逗号分隔 |

**出参**

- ResultResponse<Void>

#### 采购计划-分页查询

| 项 | 内容 |
|----|------|
| 接口说明 | 分页查询采购计划 |
| 请求地址 | `GET /api/wm/manage/purchase/purchasePlan/page` |
| 请求类型 | GET |

**入参（Query（PageQuery））**

| 字段 | 类型 | 说明 |
|------|------|------|
| planCode | String | 计划编号 |
| caliberCode | String（字典 code） | 口径编号 |
| meterTypeCode | String（字典 code） | 水表类型编号 |
| planQty | Integer | 计划数量 |
| contractNo | String | 合同 |
| purchaseDate | Date | 采购日期 |
| expectArriveDate | Date | 到货日期 |
| actualArriveDate | Date | 实际到货日期 |
| arriveStatusCode | String（枚举 code） | 到货状态 |
| remark | String | 备注 |

**出参**

- ResultResponse<PageInfo<PurchasePlanVo>>

#### 采购计划-列表查询

| 项 | 内容 |
|----|------|
| 接口说明 | 列表查询采购计划 |
| 请求地址 | `GET /api/wm/manage/purchase/purchasePlan/list` |
| 请求类型 | GET |

**入参（Query）**

| 字段 | 类型 | 说明 |
|------|------|------|
| planCode | String | 计划编号 |
| caliberCode | String（字典 code） | 口径编号 |
| meterTypeCode | String（字典 code） | 水表类型编号 |
| planQty | Integer | 计划数量 |
| contractNo | String | 合同 |
| purchaseDate | Date | 采购日期 |
| expectArriveDate | Date | 到货日期 |
| actualArriveDate | Date | 实际到货日期 |
| arriveStatusCode | String（枚举 code） | 到货状态 |
| remark | String | 备注 |

**出参**

- ResultResponse<List<PurchasePlanVo>>

#### 采购计划-详情

| 项 | 内容 |
|----|------|
| 接口说明 | 查询采购计划详情 |
| 请求地址 | `GET /api/wm/manage/purchase/purchasePlan/{id}` |
| 请求类型 | GET |

**入参（Path: id）**

| 字段 | 类型 | 说明 |
|------|------|------|
| id | String | 主键 |

**出参**

- ResultResponse<PurchasePlanVo>（含明细 list 若适用）

#### 采购计划-新增

| 项 | 内容 |
|----|------|
| 接口说明 | 新增采购计划 |
| 请求地址 | `POST /api/wm/manage/purchase/purchasePlan/` |
| 请求类型 | POST |

**入参（Body: Dto）**

| 字段 | 类型 | 说明 |
|------|------|------|
| planCode | String | 计划编号 |
| applyId | Long | 采购申请ID，关联wssmet_purapply_w表的id字段 |
| brandId | Long | 厂家ID，关联wssmet_meterbrand_w表的id字段 |
| caliberCode | String（字典 code） | 口径编号 |
| meterTypeCode | String（字典 code） | 水表类型编号 |
| planQty | Integer | 计划数量 |
| branchOrgId | Long | 分公司组织ID，关联tf_org表的id字段 |
| contractNo | String | 合同 |
| purchaseDate | Date | 采购日期 |
| expectArriveDate | Date | 到货日期 |
| actualArriveDate | Date | 实际到货日期 |
| arriveStatusCode | String（枚举 code） | 到货状态 |
| remark | String | 备注 |

**出参**

- ResultResponse<Long>

#### 采购计划-修改

| 项 | 内容 |
|----|------|
| 接口说明 | 修改采购计划 |
| 请求地址 | `POST /api/wm/manage/purchase/purchasePlan/update` |
| 请求类型 | POST |

**入参（Body: Dto（含 id））**

| 字段 | 类型 | 说明 |
|------|------|------|
| planCode | String | 计划编号 |
| applyId | Long | 采购申请ID，关联wssmet_purapply_w表的id字段 |
| brandId | Long | 厂家ID，关联wssmet_meterbrand_w表的id字段 |
| caliberCode | String（字典 code） | 口径编号 |
| meterTypeCode | String（字典 code） | 水表类型编号 |
| planQty | Integer | 计划数量 |
| branchOrgId | Long | 分公司组织ID，关联tf_org表的id字段 |
| contractNo | String | 合同 |
| purchaseDate | Date | 采购日期 |
| expectArriveDate | Date | 到货日期 |
| actualArriveDate | Date | 实际到货日期 |
| arriveStatusCode | String（枚举 code） | 到货状态 |
| remark | String | 备注 |

**出参**

- ResultResponse<Void>

#### 采购计划-删除

| 项 | 内容 |
|----|------|
| 接口说明 | 逻辑删除采购计划（支持批量） |
| 请求地址 | `DELETE /api/wm/manage/purchase/purchasePlan/deleteByIds?ids=1,2` |
| 请求类型 | DELETE |

**入参（Query: ids）**

| 字段 | 类型 | 说明 |
|------|------|------|
| ids | String | 主键，逗号分隔 |

**出参**

- ResultResponse<Void>

#### 采购计划-到货登记

| 项 | 内容 |
|----|------|
| 接口说明 | 登记到货批次与水表明细，创建水表主数据 |
| 请求地址 | `POST /api/wm/manage/purchase/purchasePlan/arrive` |
| 请求类型 | POST |

**入参（Body: Dto）**

| 字段 | 类型 | 说明 |
|------|------|------|
| arrId | Long | 到货批次ID，关联wssmet_purplanarr_w表的id字段 |
| meterId | Long | 水表ID，关联wssmet_meter_w表的id字段 |
| factoryCode | String | 出厂编码 |
| meterCode | String | 水表表号 |
| caliberCode | String（字典 code） | 口径编号 |
| meterTypeCode | String（字典 code） | 水表类型编号 |

**出参**

- ResultResponse<Void>

#### 采购到货批次-分页查询

| 项 | 内容 |
|----|------|
| 接口说明 | 分页查询采购到货批次 |
| 请求地址 | `GET /api/wm/manage/purchase/purchasePlanArr/page` |
| 请求类型 | GET |

**入参（Query（PageQuery））**

| 字段 | 类型 | 说明 |
|------|------|------|
| arriveDate | Date | 到货日期 |
| arriveQty | Integer | 到货数量 |
| verifyDeadline | String | 检定 |
| remark | String | 备注 |

**出参**

- ResultResponse<PageInfo<PurchasePlanArrVo>>

#### 采购到货批次-列表查询

| 项 | 内容 |
|----|------|
| 接口说明 | 列表查询采购到货批次 |
| 请求地址 | `GET /api/wm/manage/purchase/purchasePlanArr/list` |
| 请求类型 | GET |

**入参（Query）**

| 字段 | 类型 | 说明 |
|------|------|------|
| arriveDate | Date | 到货日期 |
| arriveQty | Integer | 到货数量 |
| verifyDeadline | String | 检定 |
| remark | String | 备注 |

**出参**

- ResultResponse<List<PurchasePlanArrVo>>

#### 采购到货批次-详情

| 项 | 内容 |
|----|------|
| 接口说明 | 查询采购到货批次详情 |
| 请求地址 | `GET /api/wm/manage/purchase/purchasePlanArr/{id}` |
| 请求类型 | GET |

**入参（Path: id）**

| 字段 | 类型 | 说明 |
|------|------|------|
| id | String | 主键 |

**出参**

- ResultResponse<PurchasePlanArrVo>（含明细 list 若适用）

#### 采购到货批次-新增

| 项 | 内容 |
|----|------|
| 接口说明 | 新增采购到货批次 |
| 请求地址 | `POST /api/wm/manage/purchase/purchasePlanArr/` |
| 请求类型 | POST |

**入参（Body: Dto）**

| 字段 | 类型 | 说明 |
|------|------|------|
| planId | Long | 采购计划ID，关联wssmet_purplan_w表的id字段 |
| arriveDate | Date | 到货日期 |
| arriveQty | Integer | 到货数量 |
| signUserId | Long | 签收用户ID，关联tf_user表的id字段 |
| verifyDeadline | String | 检定 |
| remark | String | 备注 |

**出参**

- ResultResponse<Long>

#### 采购到货批次-修改

| 项 | 内容 |
|----|------|
| 接口说明 | 修改采购到货批次 |
| 请求地址 | `POST /api/wm/manage/purchase/purchasePlanArr/update` |
| 请求类型 | POST |

**入参（Body: Dto（含 id））**

| 字段 | 类型 | 说明 |
|------|------|------|
| planId | Long | 采购计划ID，关联wssmet_purplan_w表的id字段 |
| arriveDate | Date | 到货日期 |
| arriveQty | Integer | 到货数量 |
| signUserId | Long | 签收用户ID，关联tf_user表的id字段 |
| verifyDeadline | String | 检定 |
| remark | String | 备注 |

**出参**

- ResultResponse<Void>

#### 采购到货批次-删除

| 项 | 内容 |
|----|------|
| 接口说明 | 逻辑删除采购到货批次（支持批量） |
| 请求地址 | `DELETE /api/wm/manage/purchase/purchasePlanArr/deleteByIds?ids=1,2` |
| 请求类型 | DELETE |

**入参（Query: ids）**

| 字段 | 类型 | 说明 |
|------|------|------|
| ids | String | 主键，逗号分隔 |

**出参**

- ResultResponse<Void>

#### 采购到货水表明细-分页查询

| 项 | 内容 |
|----|------|
| 接口说明 | 分页查询采购到货水表明细 |
| 请求地址 | `GET /api/wm/manage/purchase/purchasePlanArrList/page` |
| 请求类型 | GET |

**入参（Query（PageQuery））**

| 字段 | 类型 | 说明 |
|------|------|------|
| factoryCode | String | 出厂编码 |
| meterCode | String | 水表表号 |
| caliberCode | String（字典 code） | 口径编号 |
| meterTypeCode | String（字典 code） | 水表类型编号 |

**出参**

- ResultResponse<PageInfo<PurchasePlanArrListVo>>

#### 采购到货水表明细-列表查询

| 项 | 内容 |
|----|------|
| 接口说明 | 列表查询采购到货水表明细 |
| 请求地址 | `GET /api/wm/manage/purchase/purchasePlanArrList/list` |
| 请求类型 | GET |

**入参（Query）**

| 字段 | 类型 | 说明 |
|------|------|------|
| factoryCode | String | 出厂编码 |
| meterCode | String | 水表表号 |
| caliberCode | String（字典 code） | 口径编号 |
| meterTypeCode | String（字典 code） | 水表类型编号 |

**出参**

- ResultResponse<List<PurchasePlanArrListVo>>

#### 采购到货水表明细-详情

| 项 | 内容 |
|----|------|
| 接口说明 | 查询采购到货水表明细详情 |
| 请求地址 | `GET /api/wm/manage/purchase/purchasePlanArrList/{id}` |
| 请求类型 | GET |

**入参（Path: id）**

| 字段 | 类型 | 说明 |
|------|------|------|
| id | String | 主键 |

**出参**

- ResultResponse<PurchasePlanArrListVo>（含明细 list 若适用）

#### 采购到货水表明细-新增

| 项 | 内容 |
|----|------|
| 接口说明 | 新增采购到货水表明细 |
| 请求地址 | `POST /api/wm/manage/purchase/purchasePlanArrList/` |
| 请求类型 | POST |

**入参（Body: Dto）**

| 字段 | 类型 | 说明 |
|------|------|------|
| arrId | Long | 到货批次ID，关联wssmet_purplanarr_w表的id字段 |
| meterId | Long | 水表ID，关联wssmet_meter_w表的id字段 |
| factoryCode | String | 出厂编码 |
| meterCode | String | 水表表号 |
| caliberCode | String（字典 code） | 口径编号 |
| meterTypeCode | String（字典 code） | 水表类型编号 |

**出参**

- ResultResponse<Long>

#### 采购到货水表明细-修改

| 项 | 内容 |
|----|------|
| 接口说明 | 修改采购到货水表明细 |
| 请求地址 | `POST /api/wm/manage/purchase/purchasePlanArrList/update` |
| 请求类型 | POST |

**入参（Body: Dto（含 id））**

| 字段 | 类型 | 说明 |
|------|------|------|
| arrId | Long | 到货批次ID，关联wssmet_purplanarr_w表的id字段 |
| meterId | Long | 水表ID，关联wssmet_meter_w表的id字段 |
| factoryCode | String | 出厂编码 |
| meterCode | String | 水表表号 |
| caliberCode | String（字典 code） | 口径编号 |
| meterTypeCode | String（字典 code） | 水表类型编号 |

**出参**

- ResultResponse<Void>

#### 采购到货水表明细-删除

| 项 | 内容 |
|----|------|
| 接口说明 | 逻辑删除采购到货水表明细（支持批量） |
| 请求地址 | `DELETE /api/wm/manage/purchase/purchasePlanArrList/deleteByIds?ids=1,2` |
| 请求类型 | DELETE |

**入参（Query: ids）**

| 字段 | 类型 | 说明 |
|------|------|------|
| ids | String | 主键，逗号分隔 |

**出参**

- ResultResponse<Void>