Головна сторінка Огляд Довідка
Увійти
zenghaiyang
/
ylsw-bw
1
0
Відгалуження 0
Файли Проблеми 0 Запити на злиття 0 Wiki
Дерево: 85a21dde45
Гілки Теги
ylsw-bw
/
business
/
water-meter
/
doc
/
demand
/
功能需求说明
/
仪陇表务管理系统-PRD-04-功能需求说明-06-领取管理-V1.0.md

仪陇表务管理系统-PRD-04-功能需求说明-06-领取管理-V1.0.md 32 KB
Історія Запис

源文件：仪陇表务管理系统-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、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；实现时遵循 java6/java-ylsw-bw.md 与 database-design.mdc（`wssmet_` 表名），不参照存量业务表与接口。*

接口设计（研发）

统一前缀：/api/wm/manage/claim；各接口 出参 须为具体泛型（见下文，禁止 T/Vo 占位）；公共约定见 仪陇表务-公共接口说明-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>

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

    data（PageInfo）字段

    ClaimApplyVo 字段

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

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

      data（List）元素字段

      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（含明细 list 若适用）

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

        字段 类型 说明
        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

          • 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

            • data 无业务字段（null）。

            领用申请-删除

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

            入参（Query: ids）

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

            出参

            • ResultResponse

              • data 无业务字段（null）。

              领用申请明细-分页查询

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

              入参（Query（PageQuery））

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

              出参

              • ResultResponse>

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

                data（PageInfo）字段

                ClaimApplyListVo 字段

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

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

                  data（List）元素字段

                  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（含明细 list 若适用）

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

                      • 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

                        • data 无业务字段（null）。

                        领用申请明细-删除

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

                        入参（Query: ids）

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

                        出参

                        • ResultResponse

                          • data 无业务字段（null）。

                          领取登记-分页查询

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

                          入参（Query（PageQuery））

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

                          出参

                          • ResultResponse>

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

                            data（PageInfo）字段

                            ClaimRegisterVo 字段

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

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

                              data（List）元素字段

                              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（含明细 list 若适用）

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

                                  • 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

                                    • data 无业务字段（null）。

                                    领取登记-删除

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

                                    入参（Query: ids）

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

                                    出参

                                    • ResultResponse

                                      • data 无业务字段（null）。

                                      待领取清单

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

                                      入参（Query）

                                      字段 类型 说明
                                      orgId Long 组织

                                      出参

                                      • ResultResponse

                                        • data 无业务字段（null）。

                                        App分仓入库

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

                                        入参（Body: InboundDto）

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

                                        出参

                                        • ResultResponse

                                          • data 无业务字段（null）。