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


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

文档版本：V1.0

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

模块序号：06

模块名称：领取管理

## 领取管理

本模块覆盖分公司领用申请、多级审批、领取登记、总仓出库及分仓扫码入库全链路，对应《PRD-01》领取管理能力。含 Web 菜单：领用申请、领取登记；App 菜单：领取入库（App）。与采购管理、落地检管理、入库管理、出库管理联动。

### **领用申请**

#### 功能描述

发起分公司水表领用需求，提供水表规格、数量、用途、项目等明细填报及提交审批工单能力，支持分公司库管员 / 业务岗在线发起，审批通过后驱动领取登记与总仓出库，实现领用申请与工单审批留痕。

#### 菜单权限

表务分公司库管员；表务分公司管理人员；表务营业办/供水站职员；表务系统管理员

#### 数据权限

表务分公司库管员、表务分公司管理人员、表务营业办/供水站职员：可见、可操作本分公司及下属营业办、供水站、仓库范围内领用申请数据；「历史记录」Tab 仅展示当前登录账号作为发起人提交的申请工单。

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

#### 核心逻辑

以领用申请工单为业务主体；本菜单仅负责发起与进度查询，审核在工单中心办理。

审批通过后系统自动下达出库指令并驱动「领取登记」；不在本菜单办理实物交接与分仓入库。

授权人员亦可在「领取登记」直接登记触发总仓出库（无需工单），与申请通过后自动衔接并存。

#### 业务流程

流程概要

分公司库管员 / 业务岗发起 → 分公司综合办主任一级审核 → 水表管理中心主任 / 副主任二级审核 → 水表管理中心主任三级审核 → 总仓库管员四级审核 → 系统自动驱动领取登记与总仓出库；分仓库管员在 App 完成领取入库。

环节说明表

| 序号 | 环节名称 | 环节类型 | 责任岗位 | 须填写 / 处理内容 | 审核结果选项 | 通过后流向 | 驳回 / 其他结果流向 | 抄送 |
| --- | --- | --- | --- | --- | --- | --- | --- | --- |
| 1 | 领用申请发起 | 发起 | 分公司库管员 / 业务岗 | 填报领用申请基础信息及需求明细（见「一级页面：领用申请-tab-工单发起」） | 提交 | 领用一级审核 | — | — |
| 2 | 领用一级审核 | 审核 | 分公司-综合办主任 | 核查领用真实性及分公司库存合理性；填写审核意见 | 通过；驳回 | 领用二级审核 | 退回领用申请发起 | — |
| 3 | 领用二级审核 | 审核 | 总公司-水表管理中心主任 / 副主任 | 核验物资匹配度与领用合规性；填写审核意见 | 通过；驳回 | 领用三级审核 | 退回领用一级审核 | — |
| 4 | 领用三级审核 | 审核 | 总公司-水表管理中心主任 | 复核领用业务合规性；填写审核意见 | 通过；驳回 | 领用四级审核 | 退回领用二级审核 | — |
| 5 | 领用四级审核 | 审核 | 总公司-总仓库管员 | 核对总仓库存余量及工单信息完整性；填写审核意见 | 通过；驳回 | 流程通过（系统自动） | 退回领用三级审核 | 总公司-水表管理中心主任 |
| 6 | 出库与后续衔接 | 系统自动 | 系统 | 下达出库指令、扣减总仓库存、驱动「领取登记」待办 | — | 流程完结 | — | — |

审核通过后数据影响

- 生成 / 更新领用申请记录及关联工单，工单状态为「已通过」。

- 总仓库存扣减，生成领取出库类型出入库台账。

- 「领取登记」菜单出现待领取清单，支持实物交接登记。

- 领取登记完成后，领取水表明细推送至「领取入库（App）」待扫码入库。

关联界面逻辑闭环

- 发起侧：「历史记录」Tab 展示工单状态、当前节点；通过后展示领取登记状态（待登记 / 已登记 / 已入库）。

- 办理侧：「去处理」仅在审批中且当前用户为当前节点处理人时显示，跳转工单中心「二级页面：工单办理」。

- 登记侧：「领取登记」列表展示关联申请单及待领取水表；工单通过或授权直办均可进入登记。

- 入库侧：App 领取入库状态与分仓库存、水表状态（分仓新表在库）一致。

审核界面说明

- 标准界面：复用工单中心「二级页面：工单办理」；含申请信息只读区、领用明细只读区、审批记录、审核意见（驳回时必填）、通过 / 驳回按钮。

- 本业务差异：各审核环节只读展示完整申请信息及领用需求明细；四级审核通过后系统自动下达出库指令。

#### 功能需求

##### **一级页面：领用申请-tab-工单发起**

#整体布局

-- Tab 列表：工单发起（默认）、历史记录

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

#信息展示

-- 申请部门、申请人、申请日期：只读默认

-- 领入分仓：必填，下拉（当前用户数据权限范围内分仓）

-- 用途：必填，下拉（新装领用、换表领用、轮换领用、其他）

-- 项目名称：选填；备注：选填

-- 需求明细：水表口径、水表类型、申请数量（至少 1 行）

#底部按钮

-- 提交；重置

#交互说明

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

##### **一级页面：领用申请-tab-历史记录**

#整体布局

-- 查询条件 + 历史工单列表

-- 数据范围：仅当前登录账号作为发起人提交的领用申请工单

#查询条件

-- 工单编号、申请单号、工单状态、申请日期

#数据列表

-- 字段：工单编号、申请单号、申请日期、领入分仓、用途、申请总数量、当前节点、工单状态、领取登记状态、提交时间

-- 行内操作：详情

#交互说明

-- 打开「弹窗：领用申请工单详情」

##### **弹窗：领用申请工单详情**

#弹窗类型

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

#整体布局

-- Tab：申请信息 / 领用明细 / 审批记录

#底部按钮

-- 关闭；去处理（审批中且当前用户为处理人时）

#交互说明

-- 只读跟踪；办理跳转工单中心

### **领取登记**

#### 功能描述

根据已完成落地检及铅封挂接的水表清单，分公司库管员查看待领取水表并办理领取登记；支持授权人员直接登记触发总仓出库，或领用审批工单通过后自动进入待领取状态并完成实物交接登记。

#### 菜单权限

表务水表管理中心；表务分公司库管员；表务分公司管理人员；表务总公司管理人员；表务系统管理员

#### 数据权限

表务水表管理中心、表务总公司管理人员、表务系统管理员：可见、可操作全公司范围内领取登记数据。

表务分公司库管员、表务分公司管理人员：可见、可操作本分公司及下属营业办、供水站、仓库范围内领取登记数据。

#### 核心逻辑

前置条件：水表已完成落地检、铅封绑定且总仓在库（可领用状态）。

领取登记完成后：水表状态为总仓新表出库；生成领取登记主记录及明细、领取出库台账、生命周期领取阶段记录。

明细推送至分仓库管员 App「领取入库」办理扫码入库。

#### 功能需求

##### **一级页面：领取登记**

#整体布局

-- 左右或上下结构：待领取清单 + 领取登记记录列表；顶部「新建领取登记」

#查询条件

-- 登记单号、关联申请单号、登记状态、登记日期

#数据列表

-- 待领取区：展示已完成落地检及铅封绑定、总仓在库且可领取的水表清单（可按口径、类型筛选）

-- 登记记录区：登记单号、关联申请单号、领入分仓、登记人、登记日期、明细数量、入库状态

-- 行内操作：领取确认；详情

#交互说明

-- 「领取确认」：勾选待领取水表，登记领用人、领用时间，保存后触发总仓领取出库

-- 工单审批通过后可自动进入待领取状态；亦支持授权人员直接新建登记

##### **弹窗：领取登记办理**

#弹窗类型

-- 居中弹窗

#信息展示

-- 领入分仓：必填；领用人、领用时间：必填

-- 领取水表明细：勾选或扫码录入水表编号

-- 关联申请单号：工单驱动时只读带入

#底部按钮

-- 确认领取；取消

#交互说明

-- 确认后推送明细至「领取入库（App）」

##### **弹窗：领取登记详情**

#弹窗类型

-- 抽屉；只读

#信息展示

-- 登记信息、领取明细、关联申请、入库进度

#底部按钮

-- 关闭

### **领取入库（App）**

#### 功能描述

根据领取登记信息，将领取水表明细推送到分仓库管员手机 App，进行扫码入库操作，同步产生分仓入库台账及生命周期记录。

#### 菜单权限

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

#### 数据权限

表务分公司库管员：可见、可操作本分公司及下属仓库范围内领取入库作业数据。

表务系统管理员：可见、可操作全公司范围内相关数据。

#### 核心逻辑

扫码入库完成后：水表状态更新为分仓新表在库，更新所在仓库；生成分仓领取入库类型出入库台账及生命周期分仓入库记录。

#### 功能需求

##### **一级页面：领取入库（App）**

#整体布局

-- 领取批次卡片列表 + 底部「扫码入库」

#信息展示

-- 卡片：登记单号、领入分仓、领取数量、待入库数量、登记日期

-- 点击进入待入库水表明细列表

#交互说明

-- 扫码入库完成后更新分仓库存及水表状态为分仓新表在库

##### **二级页面：领取入库明细（App）**

#页面标题

-- 领取入库；返回列表

#信息展示

-- 待入库水表列表：水表编号、口径、类型、铅封号

#底部按钮

-- 扫码入库

#交互说明

-- 逐台扫码确认入库，全部完成后批次状态为已入库

---

## 详细设计（研发）

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

### 仪陇表务-功能设计-06-领取管理-V1.0

# 仪陇表务 — 功能设计 06 领取管理 V1.0

> 需求来源：`../demand/功能需求说明/仪陇表务管理系统-PRD-04-功能需求说明-06-*.md`  
> 数据模型：见 [数据库设计-V1.0.md](../数据库设计-V1.0.md)  
> 接口约定：见本文 **§接口设计（研发）**、[仪陇表务-公共接口说明-V1.0.md](./仪陇表务-公共接口说明-V1.0.md)、[00-总体框架设计-V1.0.md](../../design/00-总体框架设计-V1.0.md)

## 1. 模块概述

| 项 | 说明 |
|----|------|
| 模块序号 | 06 |
| 模块名称 | 领取管理 |
| 后端包（建议） | `com.tofly.wm.manage.puachase.claim` |
| 业务模式 | 申请工单+登记直办 |
| 工单 | CLAIM_APPLY，四级审批 |

## 2. 功能范围

- 领用申请
- 领取登记
- App 领取入库

## 3. 数据模型

### 3.1 涉及表

- `wssmet_claimapply_w`
- `wssmet_claimapplylist_w`
- `wssmet_claimreg_w`
- `wssmet_claimregmeter_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. 业务流程

申请审批→总仓出库→实物交接→分仓入库(App)。

## 5. 核心业务规则

- 可授权直办登记
- 联动 INVENTORY_OUT/IN

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

| 方法 | 路径（示例前缀） | 说明 |
|------|------------------|------|
| — | `/claimApply/` | 见 PRD 界面 |
| — | `/claimRegister/` | 见 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/claim`；各接口 **出参** 须为具体泛型（见下文，**禁止** `T`/`Vo` 占位）；公共约定见 [仪陇表务-公共接口说明-V1.0.md](./仪陇表务-公共接口说明-V1.0.md)。

#### 领用申请-分页查询

| 项 | 内容 |
|----|------|
| 接口说明 | 分页查询领用申请 |
| 请求地址 | `GET /api/wm/manage/claim/claimApply/page` |
| 请求类型 | GET |

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

| 字段 | 类型 | 说明 |
|------|------|------|
| applyCode | String | 申请编号 |
| purposeCode | String（字典 code） | 用途编号 |
| projectName | String | 项目 |
| registerStatusCode | String（枚举 code） | 登记状态 |
| remark | String | 备注 |
| workOrderCode | String | 工单编号（展示/台账查询） |
| approveStatus | String（枚举 code） | 审批状态 |

**出参**

- ResultResponse<PageInfo<ClaimApplyVo>>

> 外层包装 ResultResponse 含 code、message、data，见 [公共接口说明](./仪陇表务-公共接口说明-V1.0.md) §1.3。

**data（PageInfo）字段**

| 字段 | 类型 | 说明 |
|------|------|------|
| pageNum | Integer | 当前页码 |
| pageSize | Integer | 每页条数 |
| total | Long | 总记录数 |
| pages | Integer | 总页数 |
| list | List<ClaimApplyVo> | 当前页数据列表 |

**`ClaimApplyVo` 字段**

| 字段 | 类型 | 说明 |
|------|------|------|
| id | String | 主键 |
| applyCode | String | 申请 |
| targetWarehouseId | Long | 目标仓库ID，关联wssmet_warehouse_w表的id字段 |
| purposeCode | String（字典 code） | 用途 |
| projectName | String | 项目 |
| registerStatusCode | String（枚举 code） | 登记状态 |
| remark | String | 备注 |
| processInstanceId | Long | workflow 流程实例ID（工单中心外挂，不落本地工单表） |
| workOrderCode | String | 工单编号（展示/台账查询） |
| approveStatus | String（枚举 code） | 审批状态 |
#### 领用申请-列表查询

| 项 | 内容 |
|----|------|
| 接口说明 | 列表查询领用申请 |
| 请求地址 | `GET /api/wm/manage/claim/claimApply/list` |
| 请求类型 | GET |

**入参（Query）**

| 字段 | 类型 | 说明 |
|------|------|------|
| applyCode | String | 申请编号 |
| purposeCode | String（字典 code） | 用途编号 |
| projectName | String | 项目 |
| registerStatusCode | String（枚举 code） | 登记状态 |
| remark | String | 备注 |
| workOrderCode | String | 工单编号（展示/台账查询） |
| approveStatus | String（枚举 code） | 审批状态 |

**出参**

- ResultResponse<List<ClaimApplyVo>>

> 外层包装 ResultResponse 含 code、message、data，见 [公共接口说明](./仪陇表务-公共接口说明-V1.0.md) §1.3。

**data（List<ClaimApplyVo>）元素字段**

**`ClaimApplyVo` 字段**

| 字段 | 类型 | 说明 |
|------|------|------|
| id | String | 主键 |
| applyCode | String | 申请 |
| targetWarehouseId | Long | 目标仓库ID，关联wssmet_warehouse_w表的id字段 |
| purposeCode | String（字典 code） | 用途 |
| projectName | String | 项目 |
| registerStatusCode | String（枚举 code） | 登记状态 |
| remark | String | 备注 |
| processInstanceId | Long | workflow 流程实例ID（工单中心外挂，不落本地工单表） |
| workOrderCode | String | 工单编号（展示/台账查询） |
| approveStatus | String（枚举 code） | 审批状态 |
#### 领用申请-详情

| 项 | 内容 |
|----|------|
| 接口说明 | 查询领用申请详情 |
| 请求地址 | `GET /api/wm/manage/claim/claimApply/{id}` |
| 请求类型 | GET |

**入参（Path: id）**

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

**出参**

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

> 外层包装 ResultResponse 含 code、message、data，见 [公共接口说明](./仪陇表务-公共接口说明-V1.0.md) §1.3。

**data（ClaimApplyVo）字段**

**`ClaimApplyVo` 字段**

| 字段 | 类型 | 说明 |
|------|------|------|
| id | String | 主键 |
| applyCode | String | 申请 |
| targetWarehouseId | Long | 目标仓库ID，关联wssmet_warehouse_w表的id字段 |
| purposeCode | String（字典 code） | 用途 |
| projectName | String | 项目 |
| registerStatusCode | String（枚举 code） | 登记状态 |
| remark | String | 备注 |
| processInstanceId | Long | workflow 流程实例ID（工单中心外挂，不落本地工单表） |
| workOrderCode | String | 工单编号（展示/台账查询） |
| approveStatus | String（枚举 code） | 审批状态 |

| detailList | List<ClaimApplyListVo> | 明细列表 |

**`ClaimApplyListVo` 字段**

| 字段 | 类型 | 说明 |
|------|------|------|
| id | String | 主键 |
| applyId | Long | 领用申请ID，关联wssmet_claimapply_w表的id字段 |
| caliberCode | String（字典 code） | 口径 |
| meterTypeCode | String（字典 code） | 水表类型 |
| applyQty | Integer | 申请数量 |

#### 领用申请-新增

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

**入参（Body: Dto）**

| 字段 | 类型 | 说明 |
|------|------|------|
| applyCode | String | 申请编号 |
| targetWarehouseId | Long | 目标仓库ID，关联wssmet_warehouse_w表的id字段 |
| purposeCode | String（字典 code） | 用途编号 |
| projectName | String | 项目 |
| registerStatusCode | String（枚举 code） | 登记状态 |
| remark | String | 备注 |
| processInstanceId | Long | workflow 流程实例ID（工单中心外挂，不落本地工单表） |
| workOrderCode | String | 工单编号（展示/台账查询） |
| approveStatus | String（枚举 code） | 审批状态 |

**出参**

- ResultResponse<Long>

**data 字段**

| 字段 | 类型 | 说明 |
|------|------|------|
| id | Long | 新增记录主键 |
#### 领用申请-修改

| 项 | 内容 |
|----|------|
| 接口说明 | 修改领用申请 |
| 请求地址 | `POST /api/wm/manage/claim/claimApply/update` |
| 请求类型 | POST |

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

| 字段 | 类型 | 说明 |
|------|------|------|
| applyCode | String | 申请编号 |
| targetWarehouseId | Long | 目标仓库ID，关联wssmet_warehouse_w表的id字段 |
| purposeCode | String（字典 code） | 用途编号 |
| projectName | String | 项目 |
| registerStatusCode | String（枚举 code） | 登记状态 |
| remark | String | 备注 |
| processInstanceId | Long | workflow 流程实例ID（工单中心外挂，不落本地工单表） |
| workOrderCode | String | 工单编号（展示/台账查询） |
| approveStatus | String（枚举 code） | 审批状态 |

**出参**

- ResultResponse<Void>

**data** 无业务字段（null）。
#### 领用申请-删除

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

**入参（Query: ids）**

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

**出参**

- ResultResponse<Void>

**data** 无业务字段（null）。
#### 领用申请明细-分页查询

| 项 | 内容 |
|----|------|
| 接口说明 | 分页查询领用申请明细 |
| 请求地址 | `GET /api/wm/manage/claim/claimApplyList/page` |
| 请求类型 | GET |

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

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

**出参**

- ResultResponse<PageInfo<ClaimApplyListVo>>

> 外层包装 ResultResponse 含 code、message、data，见 [公共接口说明](./仪陇表务-公共接口说明-V1.0.md) §1.3。

**data（PageInfo）字段**

| 字段 | 类型 | 说明 |
|------|------|------|
| pageNum | Integer | 当前页码 |
| pageSize | Integer | 每页条数 |
| total | Long | 总记录数 |
| pages | Integer | 总页数 |
| list | List<ClaimApplyListVo> | 当前页数据列表 |

**`ClaimApplyListVo` 字段**

| 字段 | 类型 | 说明 |
|------|------|------|
| id | String | 主键 |
| applyId | Long | 领用申请ID，关联wssmet_claimapply_w表的id字段 |
| caliberCode | String（字典 code） | 口径 |
| meterTypeCode | String（字典 code） | 水表类型 |
| applyQty | Integer | 申请数量 |
#### 领用申请明细-列表查询

| 项 | 内容 |
|----|------|
| 接口说明 | 列表查询领用申请明细 |
| 请求地址 | `GET /api/wm/manage/claim/claimApplyList/list` |
| 请求类型 | GET |

**入参（Query）**

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

**出参**

- ResultResponse<List<ClaimApplyListVo>>

> 外层包装 ResultResponse 含 code、message、data，见 [公共接口说明](./仪陇表务-公共接口说明-V1.0.md) §1.3。

**data（List<ClaimApplyListVo>）元素字段**

**`ClaimApplyListVo` 字段**

| 字段 | 类型 | 说明 |
|------|------|------|
| id | String | 主键 |
| applyId | Long | 领用申请ID，关联wssmet_claimapply_w表的id字段 |
| caliberCode | String（字典 code） | 口径 |
| meterTypeCode | String（字典 code） | 水表类型 |
| applyQty | Integer | 申请数量 |
#### 领用申请明细-详情

| 项 | 内容 |
|----|------|
| 接口说明 | 查询领用申请明细详情 |
| 请求地址 | `GET /api/wm/manage/claim/claimApplyList/{id}` |
| 请求类型 | GET |

**入参（Path: id）**

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

**出参**

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

> 外层包装 ResultResponse 含 code、message、data，见 [公共接口说明](./仪陇表务-公共接口说明-V1.0.md) §1.3。

**data（ClaimApplyListVo）字段**

**`ClaimApplyListVo` 字段**

| 字段 | 类型 | 说明 |
|------|------|------|
| id | String | 主键 |
| applyId | Long | 领用申请ID，关联wssmet_claimapply_w表的id字段 |
| caliberCode | String（字典 code） | 口径 |
| meterTypeCode | String（字典 code） | 水表类型 |
| applyQty | Integer | 申请数量 |

#### 领用申请明细-新增

| 项 | 内容 |
|----|------|
| 接口说明 | 新增领用申请明细 |
| 请求地址 | `POST /api/wm/manage/claim/claimApplyList/` |
| 请求类型 | POST |

**入参（Body: Dto）**

| 字段 | 类型 | 说明 |
|------|------|------|
| applyId | Long | 领用申请ID，关联wssmet_claimapply_w表的id字段 |
| caliberCode | String（字典 code） | 口径编号 |
| meterTypeCode | String（字典 code） | 水表类型编号 |
| applyQty | Integer | 申请数量 |

**出参**

- ResultResponse<Long>

**data 字段**

| 字段 | 类型 | 说明 |
|------|------|------|
| id | Long | 新增记录主键 |
#### 领用申请明细-修改

| 项 | 内容 |
|----|------|
| 接口说明 | 修改领用申请明细 |
| 请求地址 | `POST /api/wm/manage/claim/claimApplyList/update` |
| 请求类型 | POST |

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

| 字段 | 类型 | 说明 |
|------|------|------|
| applyId | Long | 领用申请ID，关联wssmet_claimapply_w表的id字段 |
| caliberCode | String（字典 code） | 口径编号 |
| meterTypeCode | String（字典 code） | 水表类型编号 |
| applyQty | Integer | 申请数量 |

**出参**

- ResultResponse<Void>

**data** 无业务字段（null）。
#### 领用申请明细-删除

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

**入参（Query: ids）**

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

**出参**

- ResultResponse<Void>

**data** 无业务字段（null）。
#### 领取登记-分页查询

| 项 | 内容 |
|----|------|
| 接口说明 | 分页查询领取登记 |
| 请求地址 | `GET /api/wm/manage/claim/claimRegister/page` |
| 请求类型 | GET |

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

| 字段 | 类型 | 说明 |
|------|------|------|
| registerCode | String | 登记编号 |
| receiverName | String | 领用人 |
| receiveTime | DateTime | 领用时间 |
| inboundStatusCode | String（枚举 code） | 入库状态 |
| registrantName | String | 登记人 |

**出参**

- ResultResponse<PageInfo<ClaimRegisterVo>>

> 外层包装 ResultResponse 含 code、message、data，见 [公共接口说明](./仪陇表务-公共接口说明-V1.0.md) §1.3。

**data（PageInfo）字段**

| 字段 | 类型 | 说明 |
|------|------|------|
| pageNum | Integer | 当前页码 |
| pageSize | Integer | 每页条数 |
| total | Long | 总记录数 |
| pages | Integer | 总页数 |
| list | List<ClaimRegisterVo> | 当前页数据列表 |

**`ClaimRegisterVo` 字段**

| 字段 | 类型 | 说明 |
|------|------|------|
| id | String | 主键 |
| registerCode | String | 登记 |
| applyId | Long | 领用申请ID，关联wssmet_claimapply_w表的id字段 |
| targetWarehouseId | Long | 目标仓库ID，关联wssmet_warehouse_w表的id字段 |
| receiverId | Long | 接收人ID，关联tf_user表的id字段 |
| receiverName | String | 领用人 |
| receiveTime | DateTime | 领用时间 |
| inboundStatusCode | String（枚举 code） | 入库状态 |
| registrantId | Long | 登记人ID，关联tf_user表的id字段 |
| registrantName | String | 登记人 |
#### 领取登记-列表查询

| 项 | 内容 |
|----|------|
| 接口说明 | 列表查询领取登记 |
| 请求地址 | `GET /api/wm/manage/claim/claimRegister/list` |
| 请求类型 | GET |

**入参（Query）**

| 字段 | 类型 | 说明 |
|------|------|------|
| registerCode | String | 登记编号 |
| receiverName | String | 领用人 |
| receiveTime | DateTime | 领用时间 |
| inboundStatusCode | String（枚举 code） | 入库状态 |
| registrantName | String | 登记人 |

**出参**

- ResultResponse<List<ClaimRegisterVo>>

> 外层包装 ResultResponse 含 code、message、data，见 [公共接口说明](./仪陇表务-公共接口说明-V1.0.md) §1.3。

**data（List<ClaimRegisterVo>）元素字段**

**`ClaimRegisterVo` 字段**

| 字段 | 类型 | 说明 |
|------|------|------|
| id | String | 主键 |
| registerCode | String | 登记 |
| applyId | Long | 领用申请ID，关联wssmet_claimapply_w表的id字段 |
| targetWarehouseId | Long | 目标仓库ID，关联wssmet_warehouse_w表的id字段 |
| receiverId | Long | 接收人ID，关联tf_user表的id字段 |
| receiverName | String | 领用人 |
| receiveTime | DateTime | 领用时间 |
| inboundStatusCode | String（枚举 code） | 入库状态 |
| registrantId | Long | 登记人ID，关联tf_user表的id字段 |
| registrantName | String | 登记人 |
#### 领取登记-详情

| 项 | 内容 |
|----|------|
| 接口说明 | 查询领取登记详情 |
| 请求地址 | `GET /api/wm/manage/claim/claimRegister/{id}` |
| 请求类型 | GET |

**入参（Path: id）**

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

**出参**

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

> 外层包装 ResultResponse 含 code、message、data，见 [公共接口说明](./仪陇表务-公共接口说明-V1.0.md) §1.3。

**data（ClaimRegisterVo）字段**

**`ClaimRegisterVo` 字段**

| 字段 | 类型 | 说明 |
|------|------|------|
| id | String | 主键 |
| registerCode | String | 登记 |
| applyId | Long | 领用申请ID，关联wssmet_claimapply_w表的id字段 |
| targetWarehouseId | Long | 目标仓库ID，关联wssmet_warehouse_w表的id字段 |
| receiverId | Long | 接收人ID，关联tf_user表的id字段 |
| receiverName | String | 领用人 |
| receiveTime | DateTime | 领用时间 |
| inboundStatusCode | String（枚举 code） | 入库状态 |
| registrantId | Long | 登记人ID，关联tf_user表的id字段 |
| registrantName | String | 登记人 |

#### 领取登记-新增

| 项 | 内容 |
|----|------|
| 接口说明 | 新增领取登记 |
| 请求地址 | `POST /api/wm/manage/claim/claimRegister/` |
| 请求类型 | POST |

**入参（Body: Dto）**

| 字段 | 类型 | 说明 |
|------|------|------|
| registerCode | String | 登记编号 |
| applyId | Long | 领用申请ID，关联wssmet_claimapply_w表的id字段 |
| targetWarehouseId | Long | 目标仓库ID，关联wssmet_warehouse_w表的id字段 |
| receiverId | Long | 接收人ID，关联tf_user表的id字段 |
| receiverName | String | 领用人 |
| receiveTime | DateTime | 领用时间 |
| inboundStatusCode | String（枚举 code） | 入库状态 |
| registrantId | Long | 登记人ID，关联tf_user表的id字段 |
| registrantName | String | 登记人 |

**出参**

- ResultResponse<Long>

**data 字段**

| 字段 | 类型 | 说明 |
|------|------|------|
| id | Long | 新增记录主键 |
#### 领取登记-修改

| 项 | 内容 |
|----|------|
| 接口说明 | 修改领取登记 |
| 请求地址 | `POST /api/wm/manage/claim/claimRegister/update` |
| 请求类型 | POST |

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

| 字段 | 类型 | 说明 |
|------|------|------|
| registerCode | String | 登记编号 |
| applyId | Long | 领用申请ID，关联wssmet_claimapply_w表的id字段 |
| targetWarehouseId | Long | 目标仓库ID，关联wssmet_warehouse_w表的id字段 |
| receiverId | Long | 接收人ID，关联tf_user表的id字段 |
| receiverName | String | 领用人 |
| receiveTime | DateTime | 领用时间 |
| inboundStatusCode | String（枚举 code） | 入库状态 |
| registrantId | Long | 登记人ID，关联tf_user表的id字段 |
| registrantName | String | 登记人 |

**出参**

- ResultResponse<Void>

**data** 无业务字段（null）。
#### 领取登记-删除

| 项 | 内容 |
|----|------|
| 接口说明 | 逻辑删除领取登记（支持批量） |
| 请求地址 | `DELETE /api/wm/manage/claim/claimRegister/deleteByIds?ids=1,2` |
| 请求类型 | DELETE |

**入参（Query: ids）**

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

**出参**

- ResultResponse<Void>

**data** 无业务字段（null）。
#### 待领取清单

| 项 | 内容 |
|----|------|
| 接口说明 | 分仓待扫码入库清单 |
| 请求地址 | `GET /api/wm/manage/claim/claimRegister/pending` |
| 请求类型 | GET |

**入参（Query）**

| 字段 | 类型 | 说明 |
|------|------|------|
| orgId | Long | 组织 |

**出参**

- ResultResponse<Void>

**data** 无业务字段（null）。
#### App分仓入库

| 项 | 内容 |
|----|------|
| 接口说明 | App 扫码确认分仓入库 |
| 请求地址 | `POST /api/wm/manage/claim/claimRegister/app/inbound` |
| 请求类型 | POST |

**入参（Body: InboundDto）**

| 字段 | 类型 | 说明 |
|------|------|------|
| meterCodes | String | 水表表号列表 |

**出参**

- ResultResponse<Void>

**data** 无业务字段（null）。