仪陇表务管理系统-PRD-04-功能需求说明-12-入库管理-V1.0.md 51 KB

源文件:仪陇表务管理系统-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.md00-总体框架设计-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 deleteddeleted
  • 字典 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 /pageGET /listPOST /updateDELETE /{id}DELETE /deleteByIds
  • 返回体:须为带具体泛型的 ResultResponse<...>,见下文 §接口设计(研发)各接口出参(禁止 T/Vo 占位)。

7. 权限与数据范围

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

8. 上下游依赖

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

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


接口设计(研发)

统一前缀:/api/wm/manage/inventory;各接口 出参 须为具体泛型(见下文,禁止 T/Vo 占位);公共约定见 仪陇表务-公共接口说明-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>
  • 外层包装 ResultResponse 含 code、message、data,见 公共接口说明 §1.3。

    data(PageInfo)字段

    InventoryInVo 字段

    字段 类型 说明
    pageNum Integer 当前页码
    pageSize Integer 每页条数
    total Long 总记录数
    pages Integer 总页数
    list List 当前页数据列表
    字段 类型 说明
    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>
    • 外层包装 ResultResponse 含 code、message、data,见 公共接口说明 §1.3。

      data(List)元素字段

      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(含明细 list 若适用)
      • 外层包装 ResultResponse 含 code、message、data,见 公共接口说明 §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
        • 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
          • data 无业务字段(null)。

            入库主单-删除

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

            入参(Query: ids)

            字段 类型 说明
            ids String 主键,逗号分隔

            出参

            • ResultResponse
            • data 无业务字段(null)。

              入库水表明细-分页查询

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

              入参(Query(PageQuery))

              字段 类型 说明
              meterCode String 水表表号
              caliberCode String(字典 code) 口径编号
              meterTypeCode String(字典 code) 水表类型编号
              qty String 数量

              出参

              • ResultResponse>
              • 外层包装 ResultResponse 含 code、message、data,见 公共接口说明 §1.3。

                data(PageInfo)字段

                InventoryInMeterVo 字段

                字段 类型 说明
                pageNum Integer 当前页码
                pageSize Integer 每页条数
                total Long 总记录数
                pages Integer 总页数
                list List 当前页数据列表
                字段 类型 说明
                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>
                • 外层包装 ResultResponse 含 code、message、data,见 公共接口说明 §1.3。

                  data(List)元素字段

                  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(含明细 list 若适用)
                  • 外层包装 ResultResponse 含 code、message、data,见 公共接口说明 §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
                    • 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
                      • data 无业务字段(null)。

                        入库水表明细-删除

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

                        入参(Query: ids)

                        字段 类型 说明
                        ids String 主键,逗号分隔

                        出参

                        • ResultResponse
                        • 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>
                          • 外层包装 ResultResponse 含 code、message、data,见 公共接口说明 §1.3。

                            data(PageInfo)字段

                            InventoryConfirmVo 字段

                            字段 类型 说明
                            pageNum Integer 当前页码
                            pageSize Integer 每页条数
                            total Long 总记录数
                            pages Integer 总页数
                            list List 当前页数据列表
                            字段 类型 说明
                            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>
                            • 外层包装 ResultResponse 含 code、message、data,见 公共接口说明 §1.3。

                              data(List)元素字段

                              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(含明细 list 若适用)
                              • 外层包装 ResultResponse 含 code、message、data,见 公共接口说明 §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
                                • 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
                                  • data 无业务字段(null)。

                                    总仓入库确认-删除

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

                                    入参(Query: ids)

                                    字段 类型 说明
                                    ids String 主键,逗号分隔

                                    出参

                                    • ResultResponse
                                    • 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>
                                      • 外层包装 ResultResponse 含 code、message、data,见 公共接口说明 §1.3。

                                        data(PageInfo)字段

                                        StationReturnInVo 字段

                                        字段 类型 说明
                                        pageNum Integer 当前页码
                                        pageSize Integer 每页条数
                                        total Long 总记录数
                                        pages Integer 总页数
                                        list List 当前页数据列表
                                        字段 类型 说明
                                        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>
                                        • 外层包装 ResultResponse 含 code、message、data,见 公共接口说明 §1.3。

                                          data(List)元素字段

                                          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(含明细 list 若适用)
                                          • 外层包装 ResultResponse 含 code、message、data,见 公共接口说明 §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
                                            • 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
                                              • data 无业务字段(null)。

                                                营业所退库入库-删除

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

                                                入参(Query: ids)

                                                字段 类型 说明
                                                ids String 主键,逗号分隔

                                                出参

                                                • ResultResponse
                                                • 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>
                                                  • 外层包装 ResultResponse 含 code、message、data,见 公共接口说明 §1.3。

                                                    data(PageInfo)字段

                                                    InventoryOutVo 字段

                                                    字段 类型 说明
                                                    pageNum Integer 当前页码
                                                    pageSize Integer 每页条数
                                                    total Long 总记录数
                                                    pages Integer 总页数
                                                    list List 当前页数据列表
                                                    字段 类型 说明
                                                    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>
                                                    • 外层包装 ResultResponse 含 code、message、data,见 公共接口说明 §1.3。

                                                      data(List)元素字段

                                                      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(含明细 list 若适用)
                                                      • 外层包装 ResultResponse 含 code、message、data,见 公共接口说明 §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
                                                        • 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
                                                          • data 无业务字段(null)。

                                                            出库主单-删除

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

                                                            入参(Query: ids)

                                                            字段 类型 说明
                                                            ids String 主键,逗号分隔

                                                            出参

                                                            • ResultResponse
                                                            • data 无业务字段(null)。

                                                              出库水表明细-分页查询

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

                                                              入参(Query(PageQuery))

                                                              字段 类型 说明
                                                              meterCode String 水表表号
                                                              caliberCode String(字典 code) 口径编号
                                                              meterTypeCode String(字典 code) 水表类型编号
                                                              qty String 数量

                                                              出参

                                                              • ResultResponse>
                                                              • 外层包装 ResultResponse 含 code、message、data,见 公共接口说明 §1.3。

                                                                data(PageInfo)字段

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

                                                                出库水表明细-列表查询

                                                                字段 类型 说明
                                                                pageNum Integer 当前页码
                                                                pageSize Integer 每页条数
                                                                total Long 总记录数
                                                                pages Integer 总页数
                                                                list List 当前页数据列表
                                                                内容
                                                                接口说明 列表查询出库水表明细
                                                                请求地址 GET /api/wm/manage/inventory/inventoryOutMeter/list
                                                                请求类型 GET

                                                                入参(Query)

                                                                字段 类型 说明
                                                                meterCode String 水表表号
                                                                caliberCode String(字典 code) 口径编号
                                                                meterTypeCode String(字典 code) 水表类型编号
                                                                qty String 数量

                                                                出参

                                                                • ResultResponse>
                                                                • 外层包装 ResultResponse 含 code、message、data,见 公共接口说明 §1.3。

                                                                  data(List)元素字段

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

                                                                  出库水表明细-详情

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

                                                                  入参(Path: id)

                                                                  字段 类型 说明
                                                                  id String 主键

                                                                  出参

                                                                  • ResultResponse(含明细 list 若适用)
                                                                  • 外层包装 ResultResponse 含 code、message、data,见 公共接口说明 §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
                                                                    • 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
                                                                      • data 无业务字段(null)。

                                                                        出库水表明细-删除

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

                                                                        入参(Query: ids)

                                                                        字段 类型 说明
                                                                        ids String 主键,逗号分隔

                                                                        出参

                                                                        • ResultResponse
                                                                        • data 无业务字段(null)。