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


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

文档版本：V1.0

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

模块序号：12

模块名称：入库管理

## 入库管理

本模块覆盖总仓与分仓的初始化入库、新表入库、旧表入库、领取入库、调拨入库、退回入库等全场景，含 Web 菜单：入库管理-总仓、入库确认-总仓、入库管理-分仓、入库登记-分仓。与出库管理、领取管理、退库管理、调拨管理联动。

### **入库管理-总仓**

#### 功能描述

承载总仓各类入库业务登记，提供初始化入库、新表入库、旧表入库等类型直接办理能力，支持总仓库管员无需工单即可登记入库；新表 / 初始化入库时自动创建水表主数据及生命周期记录。

#### 菜单权限

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

#### 数据权限

表务水表管理中心：可见、可操作全公司范围内总仓入库登记及明细数据。

表务总公司管理人员：可见全公司范围内总仓入库数据（只读）。

表务系统管理员：可见、可操作全公司范围内总仓入库数据。

#### 核心逻辑

总仓入库类型包括：初始化入库（系统上线前存量建档）、新表入库（采购到货检定后）、旧表入库（分仓退回、检定不合格等）。

本菜单为直接登记，无需工单；旧表入库须结合业务工单与现场情况办理。

入库完成后自动更新出入库台账，水表状态为「总公司在库」，在库属性按业务场景标记。

#### 功能需求

##### **一级页面：入库管理-总仓**

#整体布局

-- 上下结构：查询条件区 + 数据列表区；顶部「新建入库」按钮

#查询条件

-- 入库单号：文本，支持模糊搜索

-- 入库类型：下拉单选（全部、初始化入库、新表入库、旧表入库）

-- 入库日期：日期范围选择

-- 状态：下拉单选（全部、已入库、已作废）

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

#数据列表

-- 表格标题：总仓入库登记列表

-- 表格字段：入库单号、入库类型、入库日期、登记人、明细水表数、入库状态、关联业务单号

-- 行内操作：详情；编辑（草稿状态）；作废（无下游出库引用时可作废）

#交互说明

-- 点击「新建入库」打开「弹窗：新建/编辑总仓入库登记」

-- 新表 / 初始化入库保存时自动创建水表主数据及生命周期记录

-- 旧表入库须结合业务工单或现场情况手工登记，更新水表状态为总公司在库

##### **弹窗：新建/编辑总仓入库登记**

#弹窗类型

-- 居中模态弹窗；遮罩：有；主页面：不可操作

#整体布局

-- 宽度约 900px；表单区 + 入库水表明细表格

#信息展示

-- 入库类型：必填，单选（初始化入库、新表入库、旧表入库）

-- 登记部门：只读，默认当前用户所属部门

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

-- 入库日期：只读，默认当前日期

-- 关联业务单号：选填，旧表入库时建议关联退返 / 检定 / 调拨等业务单

-- 在库属性：必填，下拉（全新、旧表、超期、待检定、争议检定不合格等，随入库类型联动可选范围）

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

-- 入库水表明细：表格，支持扫码 / 手工录入；字段含水表编号、水表口径、水表类型、数量

#底部按钮

-- 保存：校验后保存并完成入库，更新库存台账与水表状态

-- 取消：关闭弹窗

#交互说明

-- 保存后刷新一级页面列表；水表状态更新为「总公司在库」，生命周期增加「总仓入库」阶段

##### **弹窗：总仓入库登记详情**

#弹窗类型

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

#信息展示

-- 入库单全部基础字段及入库水表明细只读

#底部按钮

-- 关闭

### **入库确认-总仓**

#### 功能描述

承载分公司送至总仓水表的接收确认，提供待确认记录查看及确认操作能力，支持总仓库管员核实实物接收，实现跨级退返入库闭环确认。

#### 菜单权限

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

#### 数据权限

表务水表管理中心：可见、可操作全公司范围内入库确认数据；待确认记录可对符合条件的单据执行「确认接收」。

表务总公司管理人员：可见全公司范围内入库确认数据（只读）。

表务系统管理员：可见、可操作全公司范围内入库确认数据。

#### 核心逻辑

待确认记录来源于分公司退返、调拨送达总仓等业务；本菜单仅办理接收确认，不重复录入水表明细。

确认完成后回写来源分公司业务状态，并驱动总仓后续入库登记或检定处置。

与「入库管理-总仓」衔接：已确认记录可在总仓入库办理中引用或自动带入。

#### 功能需求

##### **一级页面：入库确认-总仓**

#整体布局

-- 上下结构：查询条件区 + 待确认 / 已确认列表（Tab 或状态筛选）

#查询条件

-- 确认单号 / 关联退返单号：文本，支持模糊搜索

-- 来源分公司：组织下拉

-- 确认状态：下拉单选（全部、待确认、已确认）

-- 送达日期：日期范围选择

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

#数据列表

-- 表格标题：总仓入库确认列表

-- 表格字段：确认单号、来源分公司、关联业务单号、水表数量、送达时间、确认状态、确认人、确认时间

-- 行内操作：详情；确认接收（待确认且当前用户为总仓库管员时显示）

#交互说明

-- 分公司将水表送至总仓时，总仓库管员在本菜单核实实物并确认接收

-- 确认完成后驱动后续总仓入库或旧表处置流程，实现跨级退返入库闭环

##### **弹窗：入库确认详情**

#弹窗类型

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

#信息展示

-- 确认单基础信息、来源分公司、关联退返 / 调拨单号、水表明细列表（只读）

#底部按钮

-- 关闭

-- 确认接收：待确认状态时显示，确认后更新为已确认并回写来源方业务状态

#交互说明

-- 确认接收须二次确认；确认后不可撤销（异常须走冲正 / 备注流程，按全局规则）

### **入库管理-分仓**

#### 功能描述

承载分仓各类入库登记，提供领取入库、调拨入库、旧表入库、退回入库等类型直接办理能力，支持与退库 / 调拨工单或调拨入库确认联动后登记，亦支持授权人员直接登记。

#### 菜单权限

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

#### 数据权限

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

表务分公司管理人员：可见、可操作本分公司及下属分仓范围内的分仓入库登记数据。

表务系统管理员：可见、可操作全公司范围内分仓入库登记数据。

#### 核心逻辑

分仓入库类型：初始化入库、领取入库（总仓出库后分仓接收）、调拨入库、旧表入库（换表 / 改表 / 拆表 / 争议检等）、退回入库（退库审批通过后）。

与工单联动时引用已通过业务单，避免重复录入；无工单场景下授权人员可直接登记。

入库完成后更新分仓库存台账，水表状态为「分公司在库」。

#### 功能需求

##### **一级页面：入库管理-分仓**

#整体布局

-- 上下结构：查询条件区 + 数据列表区；顶部「新建入库」按钮

#查询条件

-- 入库单号：文本，支持模糊搜索

-- 入库类型：下拉单选（全部、初始化入库、领取入库、调拨入库、旧表入库、退回入库）

-- 所属分仓：组织下拉，默认当前用户所属分仓

-- 入库日期：日期范围选择

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

#数据列表

-- 表格标题：分仓入库登记列表

-- 表格字段：入库单号、入库类型、所属分仓、入库日期、登记人、明细水表数、关联业务单号、入库状态

-- 行内操作：详情；编辑（草稿状态）

#交互说明

-- 点击「新建入库」打开「弹窗：新建/编辑分仓入库登记」

-- 领取入库可与领取登记 / 领取入库（App）联动自动生成或引用

-- 调拨 / 退库 / 换表等旧表入库须关联对应已通过工单或业务单

##### **弹窗：新建/编辑分仓入库登记**

#弹窗类型

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

#整体布局

-- 宽度约 900px；表单 + 水表明细表格

#信息展示

-- 入库类型：必填，单选（初始化入库、领取入库、调拨入库、旧表入库、退回入库）

-- 所属分仓：只读，默认当前用户所属分仓

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

-- 入库日期：只读，默认当前日期

-- 关联业务单号：选填，领取 / 调拨 / 退库 / 换表 / 争议检等业务入库时须关联

-- 在库属性：必填，下拉（全新、旧表、超期等）

-- 入库水表明细：水表编号、口径、类型、数量；支持扫码录入

-- 备注：选填

#底部按钮

-- 保存；取消

#交互说明

-- 保存后水表状态更新为「分公司在库」，生命周期增加「分仓入库」阶段

##### **弹窗：分仓入库登记详情**

#弹窗类型

-- 抽屉弹窗（右侧）；只读

#信息展示

-- 展示入库单全部字段及明细

#底部按钮

-- 关闭

### **入库登记-分仓**

#### 功能描述

面向营业办 / 供水站退库场景的分仓入库登记，提供退库水表接收、返总仓标签标记能力，支持退库审批工单通过后登记或授权人员直接登记，实现退库入库规范留痕。

#### 菜单权限

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

#### 数据权限

表务分公司库管员：可见、可操作本分公司及下属分仓范围内的入库登记-分仓数据。

表务分公司管理人员：可见、可操作本分公司及下属分仓范围内的入库登记-分仓数据。

表务系统管理员：可见、可操作全公司范围内入库登记-分仓数据。

#### 核心逻辑

本菜单专用于营业所 / 供水站退库至分公司仓场景，入库类型为水表退库。

登记时应关联「水表退库申请」已通过工单；支持库管员通过标签标记是否返总仓。

与「入库管理-分仓」中退回入库类型衔接，保存后更新分仓库存及水表在库属性。

#### 功能需求

##### **一级页面：入库登记-分仓**

#整体布局

-- 上下结构：查询条件 + 列表；顶部「新建登记」

#查询条件

-- 登记单号：文本，模糊搜索

-- 关联退库申请单号：文本，模糊搜索

-- 入库类型：固定或默认「水表退库」

-- 登记日期：日期范围

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

#数据列表

-- 表格标题：营业所退库入库登记列表

-- 表格字段：登记单号、关联退库申请单号、所属分仓、登记人、登记日期、水表数量、标签（是否返总仓）、登记状态

-- 行内操作：详情

#交互说明

-- 面向营业办 / 供水站将水表送至分公司仓库的退库接收入库场景

-- 须关联「水表退库申请」已通过工单或授权直接登记

-- 标签字段用于标记水表是否需返回总仓

##### **弹窗：新建/编辑入库登记-分仓**

#弹窗类型

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

#信息展示

-- 入库类型：只读，默认「水表退库」

-- 关联退库申请单号：必填，选择已通过退库申请工单

-- 所属分仓：只读，默认当前用户所属分仓

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

-- 登记日期：只读，默认当前日期

-- 返总仓标签：必填，单选（是、否），用于标记该批水表是否需返回总仓

-- 入库水表明细：水表编号、口径、类型；支持扫码；须与退库申请明细一致或可解释差异

-- 备注：选填

#底部按钮

-- 保存；取消

#交互说明

-- 保存后更新水表分公司在库状态；标签为「是」的水表进入后续返总仓移送流程

##### **弹窗：入库登记-分仓详情**

#弹窗类型

-- 抽屉弹窗（右侧）；只读

#信息展示

-- 登记单及关联退库申请摘要、水表明细、标签信息

#底部按钮

-- 关闭

---

## 详细设计（研发）

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

### 仪陇表务-功能设计-12-入库管理-V1.0

# 仪陇表务 — 功能设计 12 入库管理 V1.0

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

## 1. 模块概述

| 项 | 说明 |
|----|------|
| 模块序号 | 12 |
| 模块名称 | 入库管理 |
| 后端包（建议） | `com.tofly.wm.manage.inventory.in` |
| 业务模式 | 登记直办 |
| 工单 | 可关联退库/调拨工单 REF |

## 2. 功能范围

- 总仓入库
- 总仓入库确认
- 分仓入库
- 退库入库登记

## 3. 数据模型

### 3.1 涉及表

- `wssmet_invin_w`
- `wssmet_invinmeter_w`
- `wssmet_invconfirm_w`
- `wssmet_stnreturnin_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. 核心业务规则

- IN_TYPE 字典区分场景

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

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

#### 入库主单-分页查询

| 项 | 内容 |
|----|------|
| 接口说明 | 分页查询入库主单 |
| 请求地址 | `GET /api/wm/manage/inventory/inventoryIn/page` |
| 请求类型 | GET |

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

| 字段 | 类型 | 说明 |
|------|------|------|
| inCode | String | 入库编号 |
| inTypeCode | String（枚举 code） | 入库类型 |
| inDate | Date | 入库日期 |
| inStockAttrCode | String（字典 code） | 入库库存属性编号 |
| refTableName | String | 关联表 |
| refBizCode | String | 关联业务编号 |
| registrantName | String | 登记人 |
| statusCode | String（枚举 code） | 状态 |
| remark | String | 备注 |

**出参**

- ResultResponse<PageInfo<InventoryInVo>>

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

**data（PageInfo）字段**

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

**`InventoryInVo` 字段**

| 字段 | 类型 | 说明 |
|------|------|------|
| id | String | 主键 |
| inCode | String | 入库 |
| warehouseId | Long | 仓库ID，关联wssmet_warehouse_w表的id字段 |
| inTypeCode | String（枚举 code） | 入库类型 |
| inDate | Date | 入库日期 |
| inStockAttrCode | String（字典 code） | 入库库存属性 |
| refTableName | String | 关联表 |
| refTableId | Long | ref_tableID，关联（待补充）表的id字段 |
| refBizCode | String | 关联业务 |
| registrantId | Long | 登记人ID，关联tf_user表的id字段 |
| registrantName | String | 登记人 |
| statusCode | String（枚举 code） | 状态 |
| remark | String | 备注 |
#### 入库主单-列表查询

| 项 | 内容 |
|----|------|
| 接口说明 | 列表查询入库主单 |
| 请求地址 | `GET /api/wm/manage/inventory/inventoryIn/list` |
| 请求类型 | GET |

**入参（Query）**

| 字段 | 类型 | 说明 |
|------|------|------|
| inCode | String | 入库编号 |
| inTypeCode | String（枚举 code） | 入库类型 |
| inDate | Date | 入库日期 |
| inStockAttrCode | String（字典 code） | 入库库存属性编号 |
| refTableName | String | 关联表 |
| refBizCode | String | 关联业务编号 |
| registrantName | String | 登记人 |
| statusCode | String（枚举 code） | 状态 |
| remark | String | 备注 |

**出参**

- ResultResponse<List<InventoryInVo>>

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

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

**`InventoryInVo` 字段**

| 字段 | 类型 | 说明 |
|------|------|------|
| id | String | 主键 |
| inCode | String | 入库 |
| warehouseId | Long | 仓库ID，关联wssmet_warehouse_w表的id字段 |
| inTypeCode | String（枚举 code） | 入库类型 |
| inDate | Date | 入库日期 |
| inStockAttrCode | String（字典 code） | 入库库存属性 |
| refTableName | String | 关联表 |
| refTableId | Long | ref_tableID，关联（待补充）表的id字段 |
| refBizCode | String | 关联业务 |
| registrantId | Long | 登记人ID，关联tf_user表的id字段 |
| registrantName | String | 登记人 |
| statusCode | String（枚举 code） | 状态 |
| remark | String | 备注 |
#### 入库主单-详情

| 项 | 内容 |
|----|------|
| 接口说明 | 查询入库主单详情 |
| 请求地址 | `GET /api/wm/manage/inventory/inventoryIn/{id}` |
| 请求类型 | GET |

**入参（Path: id）**

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

**出参**

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

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

**data（InventoryInVo）字段**

**`InventoryInVo` 字段**

| 字段 | 类型 | 说明 |
|------|------|------|
| id | String | 主键 |
| inCode | String | 入库 |
| warehouseId | Long | 仓库ID，关联wssmet_warehouse_w表的id字段 |
| inTypeCode | String（枚举 code） | 入库类型 |
| inDate | Date | 入库日期 |
| inStockAttrCode | String（字典 code） | 入库库存属性 |
| refTableName | String | 关联表 |
| refTableId | Long | ref_tableID，关联（待补充）表的id字段 |
| refBizCode | String | 关联业务 |
| registrantId | Long | 登记人ID，关联tf_user表的id字段 |
| registrantName | String | 登记人 |
| statusCode | String（枚举 code） | 状态 |
| remark | String | 备注 |

#### 入库主单-新增

| 项 | 内容 |
|----|------|
| 接口说明 | 新增入库主单 |
| 请求地址 | `POST /api/wm/manage/inventory/inventoryIn/` |
| 请求类型 | POST |

**入参（Body: Dto）**

| 字段 | 类型 | 说明 |
|------|------|------|
| inCode | String | 入库编号 |
| warehouseId | Long | 仓库ID，关联wssmet_warehouse_w表的id字段 |
| inTypeCode | String（枚举 code） | 入库类型 |
| inDate | Date | 入库日期 |
| inStockAttrCode | String（字典 code） | 入库库存属性编号 |
| refTableName | String | 关联表 |
| refTableId | Long | ref_tableID，关联（待补充）表的id字段 |
| refBizCode | String | 关联业务编号 |
| registrantId | Long | 登记人ID，关联tf_user表的id字段 |
| registrantName | String | 登记人 |
| statusCode | String（枚举 code） | 状态 |
| remark | String | 备注 |

**出参**

- ResultResponse<Long>

**data 字段**

| 字段 | 类型 | 说明 |
|------|------|------|
| id | Long | 新增记录主键 |
#### 入库主单-修改

| 项 | 内容 |
|----|------|
| 接口说明 | 修改入库主单 |
| 请求地址 | `POST /api/wm/manage/inventory/inventoryIn/update` |
| 请求类型 | POST |

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

| 字段 | 类型 | 说明 |
|------|------|------|
| inCode | String | 入库编号 |
| warehouseId | Long | 仓库ID，关联wssmet_warehouse_w表的id字段 |
| inTypeCode | String（枚举 code） | 入库类型 |
| inDate | Date | 入库日期 |
| inStockAttrCode | String（字典 code） | 入库库存属性编号 |
| refTableName | String | 关联表 |
| refTableId | Long | ref_tableID，关联（待补充）表的id字段 |
| refBizCode | String | 关联业务编号 |
| registrantId | Long | 登记人ID，关联tf_user表的id字段 |
| registrantName | String | 登记人 |
| statusCode | String（枚举 code） | 状态 |
| remark | String | 备注 |

**出参**

- ResultResponse<Void>

**data** 无业务字段（null）。
#### 入库主单-删除

| 项 | 内容 |
|----|------|
| 接口说明 | 逻辑删除入库主单（支持批量） |
| 请求地址 | `DELETE /api/wm/manage/inventory/inventoryIn/deleteByIds?ids=1,2` |
| 请求类型 | DELETE |

**入参（Query: ids）**

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

**出参**

- ResultResponse<Void>

**data** 无业务字段（null）。
#### 入库水表明细-分页查询

| 项 | 内容 |
|----|------|
| 接口说明 | 分页查询入库水表明细 |
| 请求地址 | `GET /api/wm/manage/inventory/inventoryInMeter/page` |
| 请求类型 | GET |

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

| 字段 | 类型 | 说明 |
|------|------|------|
| meterCode | String | 水表表号 |
| caliberCode | String（字典 code） | 口径编号 |
| meterTypeCode | String（字典 code） | 水表类型编号 |
| qty | String | 数量 |

**出参**

- ResultResponse<PageInfo<InventoryInMeterVo>>

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

**data（PageInfo）字段**

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

**`InventoryInMeterVo` 字段**

| 字段 | 类型 | 说明 |
|------|------|------|
| id | String | 主键 |
| inId | Long | 入库主单ID，关联wssmet_invin_w表的id字段 |
| meterId | Long | 水表ID，关联wssmet_meter_w表的id字段 |
| meterCode | String | 水表表号 |
| caliberCode | String（字典 code） | 口径 |
| meterTypeCode | String（字典 code） | 水表类型 |
| qty | String | 数量 |
#### 入库水表明细-列表查询

| 项 | 内容 |
|----|------|
| 接口说明 | 列表查询入库水表明细 |
| 请求地址 | `GET /api/wm/manage/inventory/inventoryInMeter/list` |
| 请求类型 | GET |

**入参（Query）**

| 字段 | 类型 | 说明 |
|------|------|------|
| meterCode | String | 水表表号 |
| caliberCode | String（字典 code） | 口径编号 |
| meterTypeCode | String（字典 code） | 水表类型编号 |
| qty | String | 数量 |

**出参**

- ResultResponse<List<InventoryInMeterVo>>

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

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

**`InventoryInMeterVo` 字段**

| 字段 | 类型 | 说明 |
|------|------|------|
| id | String | 主键 |
| inId | Long | 入库主单ID，关联wssmet_invin_w表的id字段 |
| meterId | Long | 水表ID，关联wssmet_meter_w表的id字段 |
| meterCode | String | 水表表号 |
| caliberCode | String（字典 code） | 口径 |
| meterTypeCode | String（字典 code） | 水表类型 |
| qty | String | 数量 |
#### 入库水表明细-详情

| 项 | 内容 |
|----|------|
| 接口说明 | 查询入库水表明细详情 |
| 请求地址 | `GET /api/wm/manage/inventory/inventoryInMeter/{id}` |
| 请求类型 | GET |

**入参（Path: id）**

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

**出参**

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

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

**data（InventoryInMeterVo）字段**

**`InventoryInMeterVo` 字段**

| 字段 | 类型 | 说明 |
|------|------|------|
| id | String | 主键 |
| inId | Long | 入库主单ID，关联wssmet_invin_w表的id字段 |
| meterId | Long | 水表ID，关联wssmet_meter_w表的id字段 |
| meterCode | String | 水表表号 |
| caliberCode | String（字典 code） | 口径 |
| meterTypeCode | String（字典 code） | 水表类型 |
| qty | String | 数量 |

#### 入库水表明细-新增

| 项 | 内容 |
|----|------|
| 接口说明 | 新增入库水表明细 |
| 请求地址 | `POST /api/wm/manage/inventory/inventoryInMeter/` |
| 请求类型 | POST |

**入参（Body: Dto）**

| 字段 | 类型 | 说明 |
|------|------|------|
| inId | Long | 入库主单ID，关联wssmet_invin_w表的id字段 |
| meterId | Long | 水表ID，关联wssmet_meter_w表的id字段 |
| meterCode | String | 水表表号 |
| caliberCode | String（字典 code） | 口径编号 |
| meterTypeCode | String（字典 code） | 水表类型编号 |
| qty | String | 数量 |

**出参**

- ResultResponse<Long>

**data 字段**

| 字段 | 类型 | 说明 |
|------|------|------|
| id | Long | 新增记录主键 |
#### 入库水表明细-修改

| 项 | 内容 |
|----|------|
| 接口说明 | 修改入库水表明细 |
| 请求地址 | `POST /api/wm/manage/inventory/inventoryInMeter/update` |
| 请求类型 | POST |

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

| 字段 | 类型 | 说明 |
|------|------|------|
| inId | Long | 入库主单ID，关联wssmet_invin_w表的id字段 |
| meterId | Long | 水表ID，关联wssmet_meter_w表的id字段 |
| meterCode | String | 水表表号 |
| caliberCode | String（字典 code） | 口径编号 |
| meterTypeCode | String（字典 code） | 水表类型编号 |
| qty | String | 数量 |

**出参**

- ResultResponse<Void>

**data** 无业务字段（null）。
#### 入库水表明细-删除

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

**入参（Query: ids）**

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

**出参**

- ResultResponse<Void>

**data** 无业务字段（null）。
#### 总仓入库确认-分页查询

| 项 | 内容 |
|----|------|
| 接口说明 | 分页查询总仓入库确认 |
| 请求地址 | `GET /api/wm/manage/inventory/inventoryConfirm/page` |
| 请求类型 | GET |

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

| 字段 | 类型 | 说明 |
|------|------|------|
| confirmCode | String | 确认编号 |
| refTableName | String | 关联表 |
| meterQty | Integer | 水表数量 |
| deliveryTime | DateTime | 送达时间 |
| confirmStatusCode | String（枚举 code） | 确认状态 |
| confirmUserName | String | 确认用户 |
| confirmTime | DateTime | 确认时间 |

**出参**

- ResultResponse<PageInfo<InventoryConfirmVo>>

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

**data（PageInfo）字段**

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

**`InventoryConfirmVo` 字段**

| 字段 | 类型 | 说明 |
|------|------|------|
| id | String | 主键 |
| confirmCode | String | 确认 |
| sourceOrgId | Long | 来源组织ID，关联tf_org表的id字段 |
| refTableName | String | 关联表 |
| refTableId | Long | ref_tableID，关联（待补充）表的id字段 |
| meterQty | Integer | 水表数量 |
| deliveryTime | DateTime | 送达时间 |
| confirmStatusCode | String（枚举 code） | 确认状态 |
| confirmUserId | Long | 确认用户ID，关联tf_user表的id字段 |
| confirmUserName | String | 确认用户 |
| confirmTime | DateTime | 确认时间 |
#### 总仓入库确认-列表查询

| 项 | 内容 |
|----|------|
| 接口说明 | 列表查询总仓入库确认 |
| 请求地址 | `GET /api/wm/manage/inventory/inventoryConfirm/list` |
| 请求类型 | GET |

**入参（Query）**

| 字段 | 类型 | 说明 |
|------|------|------|
| confirmCode | String | 确认编号 |
| refTableName | String | 关联表 |
| meterQty | Integer | 水表数量 |
| deliveryTime | DateTime | 送达时间 |
| confirmStatusCode | String（枚举 code） | 确认状态 |
| confirmUserName | String | 确认用户 |
| confirmTime | DateTime | 确认时间 |

**出参**

- ResultResponse<List<InventoryConfirmVo>>

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

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

**`InventoryConfirmVo` 字段**

| 字段 | 类型 | 说明 |
|------|------|------|
| id | String | 主键 |
| confirmCode | String | 确认 |
| sourceOrgId | Long | 来源组织ID，关联tf_org表的id字段 |
| refTableName | String | 关联表 |
| refTableId | Long | ref_tableID，关联（待补充）表的id字段 |
| meterQty | Integer | 水表数量 |
| deliveryTime | DateTime | 送达时间 |
| confirmStatusCode | String（枚举 code） | 确认状态 |
| confirmUserId | Long | 确认用户ID，关联tf_user表的id字段 |
| confirmUserName | String | 确认用户 |
| confirmTime | DateTime | 确认时间 |
#### 总仓入库确认-详情

| 项 | 内容 |
|----|------|
| 接口说明 | 查询总仓入库确认详情 |
| 请求地址 | `GET /api/wm/manage/inventory/inventoryConfirm/{id}` |
| 请求类型 | GET |

**入参（Path: id）**

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

**出参**

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

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

**data（InventoryConfirmVo）字段**

**`InventoryConfirmVo` 字段**

| 字段 | 类型 | 说明 |
|------|------|------|
| id | String | 主键 |
| confirmCode | String | 确认 |
| sourceOrgId | Long | 来源组织ID，关联tf_org表的id字段 |
| refTableName | String | 关联表 |
| refTableId | Long | ref_tableID，关联（待补充）表的id字段 |
| meterQty | Integer | 水表数量 |
| deliveryTime | DateTime | 送达时间 |
| confirmStatusCode | String（枚举 code） | 确认状态 |
| confirmUserId | Long | 确认用户ID，关联tf_user表的id字段 |
| confirmUserName | String | 确认用户 |
| confirmTime | DateTime | 确认时间 |

#### 总仓入库确认-新增

| 项 | 内容 |
|----|------|
| 接口说明 | 新增总仓入库确认 |
| 请求地址 | `POST /api/wm/manage/inventory/inventoryConfirm/` |
| 请求类型 | POST |

**入参（Body: Dto）**

| 字段 | 类型 | 说明 |
|------|------|------|
| confirmCode | String | 确认编号 |
| sourceOrgId | Long | 来源组织ID，关联tf_org表的id字段 |
| refTableName | String | 关联表 |
| refTableId | Long | ref_tableID，关联（待补充）表的id字段 |
| meterQty | Integer | 水表数量 |
| deliveryTime | DateTime | 送达时间 |
| confirmStatusCode | String（枚举 code） | 确认状态 |
| confirmUserId | Long | 确认用户ID，关联tf_user表的id字段 |
| confirmUserName | String | 确认用户 |
| confirmTime | DateTime | 确认时间 |

**出参**

- ResultResponse<Long>

**data 字段**

| 字段 | 类型 | 说明 |
|------|------|------|
| id | Long | 新增记录主键 |
#### 总仓入库确认-修改

| 项 | 内容 |
|----|------|
| 接口说明 | 修改总仓入库确认 |
| 请求地址 | `POST /api/wm/manage/inventory/inventoryConfirm/update` |
| 请求类型 | POST |

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

| 字段 | 类型 | 说明 |
|------|------|------|
| confirmCode | String | 确认编号 |
| sourceOrgId | Long | 来源组织ID，关联tf_org表的id字段 |
| refTableName | String | 关联表 |
| refTableId | Long | ref_tableID，关联（待补充）表的id字段 |
| meterQty | Integer | 水表数量 |
| deliveryTime | DateTime | 送达时间 |
| confirmStatusCode | String（枚举 code） | 确认状态 |
| confirmUserId | Long | 确认用户ID，关联tf_user表的id字段 |
| confirmUserName | String | 确认用户 |
| confirmTime | DateTime | 确认时间 |

**出参**

- ResultResponse<Void>

**data** 无业务字段（null）。
#### 总仓入库确认-删除

| 项 | 内容 |
|----|------|
| 接口说明 | 逻辑删除总仓入库确认（支持批量） |
| 请求地址 | `DELETE /api/wm/manage/inventory/inventoryConfirm/deleteByIds?ids=1,2` |
| 请求类型 | DELETE |

**入参（Query: ids）**

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

**出参**

- ResultResponse<Void>

**data** 无业务字段（null）。
#### 营业所退库入库-分页查询

| 项 | 内容 |
|----|------|
| 接口说明 | 分页查询营业所退库入库 |
| 请求地址 | `GET /api/wm/manage/inventory/stationReturnIn/page` |
| 请求类型 | GET |

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

| 字段 | 类型 | 说明 |
|------|------|------|
| registerCode | String | 登记编号 |
| returnHqTagCode | String（字典 code） | 退回总仓标签编号 |
| registrantName | String | 登记人 |
| registerDate | Date | 登记日期 |
| statusCode | String（枚举 code） | 状态 |

**出参**

- ResultResponse<PageInfo<StationReturnInVo>>

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

**data（PageInfo）字段**

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

**`StationReturnInVo` 字段**

| 字段 | 类型 | 说明 |
|------|------|------|
| id | String | 主键 |
| registerCode | String | 登记 |
| returnApplyId | Long | 营业所退库申请ID，关联wssmet_retstnapply_w表的id字段 |
| warehouseId | Long | 仓库ID，关联wssmet_warehouse_w表的id字段 |
| returnHqTagCode | String（字典 code） | 退回总仓标签 |
| registrantId | Long | 登记人ID，关联tf_user表的id字段 |
| registrantName | String | 登记人 |
| registerDate | Date | 登记日期 |
| statusCode | String（枚举 code） | 状态 |
#### 营业所退库入库-列表查询

| 项 | 内容 |
|----|------|
| 接口说明 | 列表查询营业所退库入库 |
| 请求地址 | `GET /api/wm/manage/inventory/stationReturnIn/list` |
| 请求类型 | GET |

**入参（Query）**

| 字段 | 类型 | 说明 |
|------|------|------|
| registerCode | String | 登记编号 |
| returnHqTagCode | String（字典 code） | 退回总仓标签编号 |
| registrantName | String | 登记人 |
| registerDate | Date | 登记日期 |
| statusCode | String（枚举 code） | 状态 |

**出参**

- ResultResponse<List<StationReturnInVo>>

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

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

**`StationReturnInVo` 字段**

| 字段 | 类型 | 说明 |
|------|------|------|
| id | String | 主键 |
| registerCode | String | 登记 |
| returnApplyId | Long | 营业所退库申请ID，关联wssmet_retstnapply_w表的id字段 |
| warehouseId | Long | 仓库ID，关联wssmet_warehouse_w表的id字段 |
| returnHqTagCode | String（字典 code） | 退回总仓标签 |
| registrantId | Long | 登记人ID，关联tf_user表的id字段 |
| registrantName | String | 登记人 |
| registerDate | Date | 登记日期 |
| statusCode | String（枚举 code） | 状态 |
#### 营业所退库入库-详情

| 项 | 内容 |
|----|------|
| 接口说明 | 查询营业所退库入库详情 |
| 请求地址 | `GET /api/wm/manage/inventory/stationReturnIn/{id}` |
| 请求类型 | GET |

**入参（Path: id）**

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

**出参**

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

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

**data（StationReturnInVo）字段**

**`StationReturnInVo` 字段**

| 字段 | 类型 | 说明 |
|------|------|------|
| id | String | 主键 |
| registerCode | String | 登记 |
| returnApplyId | Long | 营业所退库申请ID，关联wssmet_retstnapply_w表的id字段 |
| warehouseId | Long | 仓库ID，关联wssmet_warehouse_w表的id字段 |
| returnHqTagCode | String（字典 code） | 退回总仓标签 |
| registrantId | Long | 登记人ID，关联tf_user表的id字段 |
| registrantName | String | 登记人 |
| registerDate | Date | 登记日期 |
| statusCode | String（枚举 code） | 状态 |

#### 营业所退库入库-新增

| 项 | 内容 |
|----|------|
| 接口说明 | 新增营业所退库入库 |
| 请求地址 | `POST /api/wm/manage/inventory/stationReturnIn/` |
| 请求类型 | POST |

**入参（Body: Dto）**

| 字段 | 类型 | 说明 |
|------|------|------|
| registerCode | String | 登记编号 |
| returnApplyId | Long | 营业所退库申请ID，关联wssmet_retstnapply_w表的id字段 |
| warehouseId | Long | 仓库ID，关联wssmet_warehouse_w表的id字段 |
| returnHqTagCode | String（字典 code） | 退回总仓标签编号 |
| registrantId | Long | 登记人ID，关联tf_user表的id字段 |
| registrantName | String | 登记人 |
| registerDate | Date | 登记日期 |
| statusCode | String（枚举 code） | 状态 |

**出参**

- ResultResponse<Long>

**data 字段**

| 字段 | 类型 | 说明 |
|------|------|------|
| id | Long | 新增记录主键 |
#### 营业所退库入库-修改

| 项 | 内容 |
|----|------|
| 接口说明 | 修改营业所退库入库 |
| 请求地址 | `POST /api/wm/manage/inventory/stationReturnIn/update` |
| 请求类型 | POST |

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

| 字段 | 类型 | 说明 |
|------|------|------|
| registerCode | String | 登记编号 |
| returnApplyId | Long | 营业所退库申请ID，关联wssmet_retstnapply_w表的id字段 |
| warehouseId | Long | 仓库ID，关联wssmet_warehouse_w表的id字段 |
| returnHqTagCode | String（字典 code） | 退回总仓标签编号 |
| registrantId | Long | 登记人ID，关联tf_user表的id字段 |
| registrantName | String | 登记人 |
| registerDate | Date | 登记日期 |
| statusCode | String（枚举 code） | 状态 |

**出参**

- ResultResponse<Void>

**data** 无业务字段（null）。
#### 营业所退库入库-删除

| 项 | 内容 |
|----|------|
| 接口说明 | 逻辑删除营业所退库入库（支持批量） |
| 请求地址 | `DELETE /api/wm/manage/inventory/stationReturnIn/deleteByIds?ids=1,2` |
| 请求类型 | DELETE |

**入参（Query: ids）**

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

**出参**

- ResultResponse<Void>

**data** 无业务字段（null）。
#### 出库主单-分页查询

| 项 | 内容 |
|----|------|
| 接口说明 | 分页查询出库主单 |
| 请求地址 | `GET /api/wm/manage/inventory/inventoryOut/page` |
| 请求类型 | GET |

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

| 字段 | 类型 | 说明 |
|------|------|------|
| outCode | String | 出库编号 |
| outTypeCode | String（枚举 code） | 出库类型 |
| outDate | Date | 出库日期 |
| refTableName | String | 关联表 |
| refBizCode | String | 关联业务编号 |
| registrantName | String | 登记人 |
| statusCode | String（枚举 code） | 状态 |
| remark | String | 备注 |

**出参**

- ResultResponse<PageInfo<InventoryOutVo>>

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

**data（PageInfo）字段**

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

**`InventoryOutVo` 字段**

| 字段 | 类型 | 说明 |
|------|------|------|
| id | String | 主键 |
| outCode | String | 出库 |
| warehouseId | Long | 仓库ID，关联wssmet_warehouse_w表的id字段 |
| outTypeCode | String（枚举 code） | 出库类型 |
| outDate | Date | 出库日期 |
| refTableName | String | 关联表 |
| refTableId | Long | ref_tableID，关联（待补充）表的id字段 |
| refBizCode | String | 关联业务 |
| registrantId | Long | 登记人ID，关联tf_user表的id字段 |
| registrantName | String | 登记人 |
| statusCode | String（枚举 code） | 状态 |
| remark | String | 备注 |
#### 出库主单-列表查询

| 项 | 内容 |
|----|------|
| 接口说明 | 列表查询出库主单 |
| 请求地址 | `GET /api/wm/manage/inventory/inventoryOut/list` |
| 请求类型 | GET |

**入参（Query）**

| 字段 | 类型 | 说明 |
|------|------|------|
| outCode | String | 出库编号 |
| outTypeCode | String（枚举 code） | 出库类型 |
| outDate | Date | 出库日期 |
| refTableName | String | 关联表 |
| refBizCode | String | 关联业务编号 |
| registrantName | String | 登记人 |
| statusCode | String（枚举 code） | 状态 |
| remark | String | 备注 |

**出参**

- ResultResponse<List<InventoryOutVo>>

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

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

**`InventoryOutVo` 字段**

| 字段 | 类型 | 说明 |
|------|------|------|
| id | String | 主键 |
| outCode | String | 出库 |
| warehouseId | Long | 仓库ID，关联wssmet_warehouse_w表的id字段 |
| outTypeCode | String（枚举 code） | 出库类型 |
| outDate | Date | 出库日期 |
| refTableName | String | 关联表 |
| refTableId | Long | ref_tableID，关联（待补充）表的id字段 |
| refBizCode | String | 关联业务 |
| registrantId | Long | 登记人ID，关联tf_user表的id字段 |
| registrantName | String | 登记人 |
| statusCode | String（枚举 code） | 状态 |
| remark | String | 备注 |
#### 出库主单-详情

| 项 | 内容 |
|----|------|
| 接口说明 | 查询出库主单详情 |
| 请求地址 | `GET /api/wm/manage/inventory/inventoryOut/{id}` |
| 请求类型 | GET |

**入参（Path: id）**

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

**出参**

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

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

**data（InventoryOutVo）字段**

**`InventoryOutVo` 字段**

| 字段 | 类型 | 说明 |
|------|------|------|
| id | String | 主键 |
| outCode | String | 出库 |
| warehouseId | Long | 仓库ID，关联wssmet_warehouse_w表的id字段 |
| outTypeCode | String（枚举 code） | 出库类型 |
| outDate | Date | 出库日期 |
| refTableName | String | 关联表 |
| refTableId | Long | ref_tableID，关联（待补充）表的id字段 |
| refBizCode | String | 关联业务 |
| registrantId | Long | 登记人ID，关联tf_user表的id字段 |
| registrantName | String | 登记人 |
| statusCode | String（枚举 code） | 状态 |
| remark | String | 备注 |

#### 出库主单-新增

| 项 | 内容 |
|----|------|
| 接口说明 | 新增出库主单 |
| 请求地址 | `POST /api/wm/manage/inventory/inventoryOut/` |
| 请求类型 | POST |

**入参（Body: Dto）**

| 字段 | 类型 | 说明 |
|------|------|------|
| outCode | String | 出库编号 |
| warehouseId | Long | 仓库ID，关联wssmet_warehouse_w表的id字段 |
| outTypeCode | String（枚举 code） | 出库类型 |
| outDate | Date | 出库日期 |
| refTableName | String | 关联表 |
| refTableId | Long | ref_tableID，关联（待补充）表的id字段 |
| refBizCode | String | 关联业务编号 |
| registrantId | Long | 登记人ID，关联tf_user表的id字段 |
| registrantName | String | 登记人 |
| statusCode | String（枚举 code） | 状态 |
| remark | String | 备注 |

**出参**

- ResultResponse<Long>

**data 字段**

| 字段 | 类型 | 说明 |
|------|------|------|
| id | Long | 新增记录主键 |
#### 出库主单-修改

| 项 | 内容 |
|----|------|
| 接口说明 | 修改出库主单 |
| 请求地址 | `POST /api/wm/manage/inventory/inventoryOut/update` |
| 请求类型 | POST |

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

| 字段 | 类型 | 说明 |
|------|------|------|
| outCode | String | 出库编号 |
| warehouseId | Long | 仓库ID，关联wssmet_warehouse_w表的id字段 |
| outTypeCode | String（枚举 code） | 出库类型 |
| outDate | Date | 出库日期 |
| refTableName | String | 关联表 |
| refTableId | Long | ref_tableID，关联（待补充）表的id字段 |
| refBizCode | String | 关联业务编号 |
| registrantId | Long | 登记人ID，关联tf_user表的id字段 |
| registrantName | String | 登记人 |
| statusCode | String（枚举 code） | 状态 |
| remark | String | 备注 |

**出参**

- ResultResponse<Void>

**data** 无业务字段（null）。
#### 出库主单-删除

| 项 | 内容 |
|----|------|
| 接口说明 | 逻辑删除出库主单（支持批量） |
| 请求地址 | `DELETE /api/wm/manage/inventory/inventoryOut/deleteByIds?ids=1,2` |
| 请求类型 | DELETE |

**入参（Query: ids）**

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

**出参**

- ResultResponse<Void>

**data** 无业务字段（null）。
#### 出库水表明细-分页查询

| 项 | 内容 |
|----|------|
| 接口说明 | 分页查询出库水表明细 |
| 请求地址 | `GET /api/wm/manage/inventory/inventoryOutMeter/page` |
| 请求类型 | GET |

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

| 字段 | 类型 | 说明 |
|------|------|------|
| meterCode | String | 水表表号 |
| caliberCode | String（字典 code） | 口径编号 |
| meterTypeCode | String（字典 code） | 水表类型编号 |
| qty | String | 数量 |

**出参**

- ResultResponse<PageInfo<InventoryOutMeterVo>>

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

**data（PageInfo）字段**

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

> `InventoryOutMeterVo` 字段见关联业务表或平台 workflow 约定。
#### 出库水表明细-列表查询

| 项 | 内容 |
|----|------|
| 接口说明 | 列表查询出库水表明细 |
| 请求地址 | `GET /api/wm/manage/inventory/inventoryOutMeter/list` |
| 请求类型 | GET |

**入参（Query）**

| 字段 | 类型 | 说明 |
|------|------|------|
| meterCode | String | 水表表号 |
| caliberCode | String（字典 code） | 口径编号 |
| meterTypeCode | String（字典 code） | 水表类型编号 |
| qty | String | 数量 |

**出参**

- ResultResponse<List<InventoryOutMeterVo>>

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

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

> `InventoryOutMeterVo` 字段见关联业务表或平台 workflow 约定。
#### 出库水表明细-详情

| 项 | 内容 |
|----|------|
| 接口说明 | 查询出库水表明细详情 |
| 请求地址 | `GET /api/wm/manage/inventory/inventoryOutMeter/{id}` |
| 请求类型 | GET |

**入参（Path: id）**

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

**出参**

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

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

**data（InventoryOutMeterVo）字段**

> `InventoryOutMeterVo` 字段见关联业务表或平台 workflow 约定。

#### 出库水表明细-新增

| 项 | 内容 |
|----|------|
| 接口说明 | 新增出库水表明细 |
| 请求地址 | `POST /api/wm/manage/inventory/inventoryOutMeter/` |
| 请求类型 | POST |

**入参（Body: Dto）**

| 字段 | 类型 | 说明 |
|------|------|------|
| outId | Long | 出库主单ID，关联wssmet_invout_w表的id字段 |
| meterId | Long | 水表ID，关联wssmet_meter_w表的id字段 |
| meterCode | String | 水表表号 |
| caliberCode | String（字典 code） | 口径编号 |
| meterTypeCode | String（字典 code） | 水表类型编号 |
| qty | String | 数量 |

**出参**

- ResultResponse<Long>

**data 字段**

| 字段 | 类型 | 说明 |
|------|------|------|
| id | Long | 新增记录主键 |
#### 出库水表明细-修改

| 项 | 内容 |
|----|------|
| 接口说明 | 修改出库水表明细 |
| 请求地址 | `POST /api/wm/manage/inventory/inventoryOutMeter/update` |
| 请求类型 | POST |

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

| 字段 | 类型 | 说明 |
|------|------|------|
| outId | Long | 出库主单ID，关联wssmet_invout_w表的id字段 |
| meterId | Long | 水表ID，关联wssmet_meter_w表的id字段 |
| meterCode | String | 水表表号 |
| caliberCode | String（字典 code） | 口径编号 |
| meterTypeCode | String（字典 code） | 水表类型编号 |
| qty | String | 数量 |

**出参**

- ResultResponse<Void>

**data** 无业务字段（null）。
#### 出库水表明细-删除

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

**入参（Query: ids）**

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

**出参**

- ResultResponse<Void>

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