仪陇表务管理系统-PRD-04-功能需求说明-07-调拨管理-V1.0.md 35 KB

源文件:仪陇表务管理系统-PRD-04-功能需求说明-07-调拨管理-V1.0.docx 导出时间:2026-05-26 10:34

仪陇表务管理系统 产品需求说明书 04-功能需求说明 调拨管理

文档版本:V1.0

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

模块序号:07

模块名称:调拨管理

调拨管理

本模块覆盖跨分公司水表调拨申请、双方多级审批、调出方出库登记及调入方入库确认全链路,对应《PRD-01》调拨管理能力。含 Web 菜单:调拨申请、调拨出库登记、调拨入库确认。与出库管理、入库管理、水表台账联动。

调拨申请

功能描述

发起跨分公司水表调拨申请并提交审批工单,提供在线查看各分公司实时库存、选择调拨来源及填报项目名称、口径、类型、数量、用途等能力,支持调入方分公司库管员在线发起,审批通过后驱动调拨出库及入库确认,实现调拨申请与工单审批留痕。

菜单权限

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

数据权限

表务分公司库管员、表务分公司管理人员:可见、可操作本分公司及下属机构范围内调拨申请数据;「历史记录」Tab 仅展示当前登录账号作为发起人提交的工单。

表务系统管理员:可见、可操作全公司范围内调拨申请数据。

核心逻辑

发起方为调入方(分公司 B);调出方(分公司 A)在审批环节审核库存与合规性。

工单生效后由调出方在「调拨出库登记」、调入方在「调拨入库确认」分别办理,不在本菜单重复录入。

业务流程

流程概要

调入方库管员发起 → 调入方综合办 / 领导两级审核 → 调出方领导及综合办两级审核 → 调出方办理调拨出库登记 → 调入方办理调拨入库确认 → 双方库存台账自动更新。

环节说明表

序号 环节名称 环节类型 责任岗位 须填写 / 处理内容 审核结果选项 通过后流向 驳回 / 其他结果流向 抄送
1 调拨申请发起 发起 调入方分公司库管员 填报调拨申请并选择调出方分公司及库存来源(见「一级页面:调拨申请-tab-工单发起」) 提交 调入方一级审核
2 调入方一级审核 审核 调入方分公司-综合办主任 / 副主任 核查申请真实性、项目匹配度、字段完整性 通过;驳回 调入方二级审核 退回调拨申请发起
3 调入方二级审核 审核 调入方分公司-领导班子 复核业务合规性、资源匹配合理性 通过;驳回 调出方三级审核 退回调入方一级审核
4 调出方三级审核 审核 调出方分公司-领导班子 审核调出方库存充足性及跨分公司调配合理性 通过;驳回 调出方四级审核 退回调入方二级审核
5 调出方四级审核 审核 调出方分公司-综合办主任 / 副主任 复核库存匹配度、执行可行性 通过;驳回 流程通过(工单生效) 退回调出方三级审核
6 调拨出库登记 执行 调出方分公司库管员 凭生效工单办理调拨出库(见「调拨出库登记」) 调入方入库确认
7 调拨入库确认 执行 调入方分公司库管员 核对到货与工单一致后确认入库(见「调拨入库确认」) 流程完结

审核通过后数据影响

  • 生成调拨申请记录及关联工单;工单生效后调出方可在「调拨出库登记」办理出库。

  • 出库登记完成:调出方生成跨分公司调拨出库记录并扣减库存。

  • 入库确认完成:调入方生成跨分公司调拨入库记录并增加库存。

关联界面逻辑闭环

  • 申请侧:历史 Tab 展示工单状态;通过后展示出库 / 入库办理状态(待出库 / 已出库 / 待入库 / 已入库)。

  • 出库侧:仅工单生效且当前用户为调出方库管员时可办理;出库后调入方「调拨入库确认」出现待办。

  • 入库侧:须核对水表型号、数量、编号与工单一致后方可确认。

审核界面说明

  • 标准界面:工单中心「二级页面:工单办理」;只读展示申请信息、调拨来源库存快照、调拨明细。

  • 本业务差异:发起时可查看全部分公司实时库存并选择调拨来源分公司。

功能需求

一级页面:调拨申请-tab-工单发起

#整体布局

-- Tab:工单发起、历史记录

#信息展示

-- 调出方分公司:必填,下拉(可查看该分公司实时库存后选择)

-- 项目名称:必填;水表口径、水表类型:必填

-- 调拨数量:必填,正整数;调拨用途:必填;备注:选填

-- 库存参考区:只读展示所选调出方分仓库存汇总(口径、类型、在库数量)

#底部按钮

-- 提交;重置

一级页面:调拨申请-tab-历史记录

#整体布局

-- 仅当前登录账号发起的调拨申请工单

#数据列表

-- 字段:工单编号、申请单号、调出方、调入方、口径、类型、数量、工单状态、出库状态、入库状态

-- 行内操作:详情

弹窗:调拨申请工单详情

#弹窗类型

-- 抽屉;只读 + 去处理

#信息展示

-- 申请信息、库存快照、审批记录、出库 / 入库状态

调拨出库登记

功能描述

承载调出方调拨执行登记,提供凭生效调拨工单或授权直办办理跨分公司调拨出库能力,登记领用人、领用时间及水表编号,自动生成分公司调出方跨分公司调拨出库记录并扣减库存,实现调拨出库标准化与库存联动。

菜单权限

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

数据权限

表务分公司库管员、表务分公司管理人员:可见、可操作本分公司(调出方)范围内调拨出库登记数据。

表务系统管理员:可见、可操作全公司范围内调拨出库数据。

核心逻辑

仅调出方库管员可办理本分公司调出登记;须关联已生效调拨工单(或授权直办规则与 01 一致)。

登记完成自动生成跨分公司调拨出库类型出入库台账并扣减调出方库存。

功能需求

一级页面:调拨出库登记

#整体布局

-- 查询条件 + 待出库 / 已出库列表

#查询条件

-- 调拨工单号、调出方、调入方、办理状态、登记日期

#数据列表

-- 待出库:关联已生效调拨工单的待登记记录

-- 字段:工单编号、项目名称、口径、类型、计划数量、已登记数量、办理状态

-- 行内操作:办理出库;详情

#交互说明

-- 办理出库:录入领用人、领用时间、水表编号(扫码),保存后扣减调出方库存

弹窗:调拨出库办理

#弹窗类型

-- 居中弹窗

#信息展示

-- 关联调拨工单信息:只读

-- 领用人、领用时间:必填

-- 水表编号明细:扫码 / 手工录入,须与工单口径类型一致

#底部按钮

-- 确认出库;取消

#交互说明

-- 支持授权人员凭生效工单直办;保存后驱动调入方入库待办

调拨入库确认

功能描述

承载调入方到货接收确认,提供核对到货物资与调拨工单信息、系统确认入库能力,支持调拨审批工单通过后登记或授权人员直接确认,自动生成分公司调入方跨分公司调拨入库记录并更新库存,实现跨分公司调拨入库闭环。

菜单权限

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

数据权限

表务分公司库管员、表务分公司管理人员:可见、可操作本分公司(调入方)范围内调拨入库确认数据。

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

核心逻辑

调入方须核对到货物资与工单(型号、数量、编号)完全一致后方可确认。

确认完成自动生成跨分公司调拨入库类型出入库台账并增加调入方库存,双方台账实时更新。

功能需求

一级页面:调拨入库确认

#整体布局

-- 查询条件 + 待确认 / 已确认列表

#查询条件

-- 调拨工单号、调出方、调入方、确认状态

#数据列表

-- 待确认:调出方已出库、待调入方核对的记录

-- 字段:工单编号、出库登记单号、计划数量、已出库数量、确认状态

-- 行内操作:入库确认;详情

弹窗:调拨入库确认办理

#弹窗类型

-- 居中弹窗

#信息展示

-- 工单信息、出库明细:只读

-- 到货核对:逐条核对水表编号、型号、数量与工单一致

-- 确认人、确认时间:只读默认

#底部按钮

-- 确认入库;驳回(实物不符时,须填写原因并联系调出方)

#交互说明

-- 确认后生成跨分公司调拨入库记录并增加调入方库存


详细设计(研发)

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

仪陇表务-功能设计-07-调拨管理-V1.0

# 仪陇表务 — 功能设计 07 调拨管理 V1.0

需求来源:../demand/功能需求说明/仪陇表务管理系统-PRD-04-功能需求说明-07-*.md
数据模型:见 数据库设计-V1.0.md
接口约定:见本文 §接口设计(研发)仪陇表务-公共接口说明-V1.0.md00-总体框架设计-V1.0.md

1. 模块概述

说明
模块序号 07
模块名称 调拨管理
后端包(建议) com.tofly.wm.manage.transfer
业务模式 申请工单+出入库登记
工单 TRANSFER_APPLY,双方四级审批

2. 功能范围

  • 调拨申请
  • 调拨出库登记
  • 调拨入库确认

3. 数据模型

3.1 涉及表

  • wssmet_transferapply_w
  • wssmet_transferout_w
  • wssmet_transferoutmeter_w
  • wssmet_transferin_w
  • wssmet_transferinmeter_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. 业务流程

B 申请查库存→审批→A 出库→B 入库确认。

5. 核心业务规则

  • 出库类型跨分公司调拨出库
  • 入库类型跨分公司调拨入库

6. 接口设计(概要)

方法 路径(示例前缀) 说明
/transferApply/ 见 PRD 界面
/transferOut/ 见 PRD 界面
/transferIn/ 见 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/transfer;各接口 出参 须为具体泛型(见下文,禁止 T/Vo 占位);公共约定见 仪陇表务-公共接口说明-V1.0.md

调拨申请-分页查询

内容
接口说明 分页查询调拨申请
请求地址 GET /api/wm/manage/transfer/transferApply/page
请求类型 GET

入参(Query(PageQuery))

字段 类型 说明
applyCode String 申请编号
projectName String 项目
caliberCode String(字典 code) 口径编号
meterTypeCode String(字典 code) 水表类型编号
transferQty Integer 调拨数量
purpose String 用途
stockSnapshot String 库存快照
outStatusCode String(枚举 code) 出库状态
inStatusCode String(枚举 code) 入库状态
remark String 备注
workOrderCode String 工单编号(展示/台账查询)
approveStatus String(枚举 code) 审批状态

出参

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

    data(PageInfo)字段

    TransferApplyVo 字段

    字段 类型 说明
    pageNum Integer 当前页码
    pageSize Integer 每页条数
    total Long 总记录数
    pages Integer 总页数
    list List 当前页数据列表
    字段 类型 说明
    id String 主键
    applyCode String 申请
    outOrgId Long 出库组织ID,关联tf_org表的id字段
    inOrgId Long 入库组织ID,关联tf_org表的id字段
    projectName String 项目
    caliberCode String(字典 code) 口径
    meterTypeCode String(字典 code) 水表类型
    transferQty Integer 调拨数量
    purpose String 用途
    stockSnapshot String 库存快照
    outStatusCode String(枚举 code) 出库状态
    inStatusCode String(枚举 code) 入库状态
    remark String 备注
    processInstanceId Long workflow 流程实例ID(工单中心外挂,不落本地工单表)
    workOrderCode String 工单编号(展示/台账查询)
    approveStatus String(枚举 code) 审批状态

    调拨申请-列表查询

    内容
    接口说明 列表查询调拨申请
    请求地址 GET /api/wm/manage/transfer/transferApply/list
    请求类型 GET

    入参(Query)

    字段 类型 说明
    applyCode String 申请编号
    projectName String 项目
    caliberCode String(字典 code) 口径编号
    meterTypeCode String(字典 code) 水表类型编号
    transferQty Integer 调拨数量
    purpose String 用途
    stockSnapshot String 库存快照
    outStatusCode String(枚举 code) 出库状态
    inStatusCode String(枚举 code) 入库状态
    remark String 备注
    workOrderCode String 工单编号(展示/台账查询)
    approveStatus String(枚举 code) 审批状态

    出参

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

      data(List)元素字段

      TransferApplyVo 字段

      字段 类型 说明
      id String 主键
      applyCode String 申请
      outOrgId Long 出库组织ID,关联tf_org表的id字段
      inOrgId Long 入库组织ID,关联tf_org表的id字段
      projectName String 项目
      caliberCode String(字典 code) 口径
      meterTypeCode String(字典 code) 水表类型
      transferQty Integer 调拨数量
      purpose String 用途
      stockSnapshot String 库存快照
      outStatusCode String(枚举 code) 出库状态
      inStatusCode String(枚举 code) 入库状态
      remark String 备注
      processInstanceId Long workflow 流程实例ID(工单中心外挂,不落本地工单表)
      workOrderCode String 工单编号(展示/台账查询)
      approveStatus String(枚举 code) 审批状态

      调拨申请-详情

      内容
      接口说明 查询调拨申请详情
      请求地址 GET /api/wm/manage/transfer/transferApply/{id}
      请求类型 GET

      入参(Path: id)

      字段 类型 说明
      id String 主键

      出参

      • ResultResponse(含明细 list 若适用)
      • 外层包装 ResultResponse 含 code、message、data,见 公共接口说明 §1.3。

        data(TransferApplyVo)字段

        TransferApplyVo 字段

        字段 类型 说明
        id String 主键
        applyCode String 申请
        outOrgId Long 出库组织ID,关联tf_org表的id字段
        inOrgId Long 入库组织ID,关联tf_org表的id字段
        projectName String 项目
        caliberCode String(字典 code) 口径
        meterTypeCode String(字典 code) 水表类型
        transferQty Integer 调拨数量
        purpose String 用途
        stockSnapshot String 库存快照
        outStatusCode String(枚举 code) 出库状态
        inStatusCode String(枚举 code) 入库状态
        remark String 备注
        processInstanceId Long workflow 流程实例ID(工单中心外挂,不落本地工单表)
        workOrderCode String 工单编号(展示/台账查询)
        approveStatus String(枚举 code) 审批状态

        调拨申请-新增

        内容
        接口说明 新增调拨申请;提交时同步发起 workflow,回写 process_instance_id / work_order_code / approve_status
        请求地址 POST /api/wm/manage/transfer/transferApply/
        请求类型 POST

        入参(Body: Dto)

        字段 类型 说明
        applyCode String 申请编号
        outOrgId Long 出库组织ID,关联tf_org表的id字段
        inOrgId Long 入库组织ID,关联tf_org表的id字段
        projectName String 项目
        caliberCode String(字典 code) 口径编号
        meterTypeCode String(字典 code) 水表类型编号
        transferQty Integer 调拨数量
        purpose String 用途
        stockSnapshot String 库存快照
        outStatusCode String(枚举 code) 出库状态
        inStatusCode String(枚举 code) 入库状态
        remark String 备注
        processInstanceId Long workflow 流程实例ID(工单中心外挂,不落本地工单表)
        workOrderCode String 工单编号(展示/台账查询)
        approveStatus String(枚举 code) 审批状态

        出参

        • ResultResponse
        • data 字段

          字段 类型 说明
          id Long 新增记录主键

          调拨申请-修改

          内容
          接口说明 修改调拨申请
          请求地址 POST /api/wm/manage/transfer/transferApply/update
          请求类型 POST

          入参(Body: Dto(含 id))

          字段 类型 说明
          applyCode String 申请编号
          outOrgId Long 出库组织ID,关联tf_org表的id字段
          inOrgId Long 入库组织ID,关联tf_org表的id字段
          projectName String 项目
          caliberCode String(字典 code) 口径编号
          meterTypeCode String(字典 code) 水表类型编号
          transferQty Integer 调拨数量
          purpose String 用途
          stockSnapshot String 库存快照
          outStatusCode String(枚举 code) 出库状态
          inStatusCode String(枚举 code) 入库状态
          remark String 备注
          processInstanceId Long workflow 流程实例ID(工单中心外挂,不落本地工单表)
          workOrderCode String 工单编号(展示/台账查询)
          approveStatus String(枚举 code) 审批状态

          出参

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

            调拨申请-删除

            内容
            接口说明 逻辑删除调拨申请(支持批量)
            请求地址 DELETE /api/wm/manage/transfer/transferApply/deleteByIds?ids=1,2
            请求类型 DELETE

            入参(Query: ids)

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

            出参

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

              调拨出库登记-分页查询

              内容
              接口说明 分页查询调拨出库登记
              请求地址 GET /api/wm/manage/transfer/transferOut/page
              请求类型 GET

              入参(Query(PageQuery))

              字段 类型 说明
              outCode String 出库编号
              receiverName String 领用人
              receiveTime DateTime 领用时间
              outStatusCode String(枚举 code) 出库状态

              出参

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

                data(PageInfo)字段

                TransferOutVo 字段

                字段 类型 说明
                pageNum Integer 当前页码
                pageSize Integer 每页条数
                total Long 总记录数
                pages Integer 总页数
                list List 当前页数据列表
                字段 类型 说明
                id String 主键
                applyId Long 调拨申请ID,关联wssmet_transferapply_w表的id字段
                outCode String 出库
                receiverId Long 接收人ID,关联tf_user表的id字段
                receiverName String 领用人
                receiveTime DateTime 领用时间
                outStatusCode String(枚举 code) 出库状态

                调拨出库登记-列表查询

                内容
                接口说明 列表查询调拨出库登记
                请求地址 GET /api/wm/manage/transfer/transferOut/list
                请求类型 GET

                入参(Query)

                字段 类型 说明
                outCode String 出库编号
                receiverName String 领用人
                receiveTime DateTime 领用时间
                outStatusCode String(枚举 code) 出库状态

                出参

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

                  data(List)元素字段

                  TransferOutVo 字段

                  字段 类型 说明
                  id String 主键
                  applyId Long 调拨申请ID,关联wssmet_transferapply_w表的id字段
                  outCode String 出库
                  receiverId Long 接收人ID,关联tf_user表的id字段
                  receiverName String 领用人
                  receiveTime DateTime 领用时间
                  outStatusCode String(枚举 code) 出库状态

                  调拨出库登记-详情

                  内容
                  接口说明 查询调拨出库登记详情
                  请求地址 GET /api/wm/manage/transfer/transferOut/{id}
                  请求类型 GET

                  入参(Path: id)

                  字段 类型 说明
                  id String 主键

                  出参

                  • ResultResponse(含明细 list 若适用)
                  • 外层包装 ResultResponse 含 code、message、data,见 公共接口说明 §1.3。

                    data(TransferOutVo)字段

                    TransferOutVo 字段

                    字段 类型 说明
                    id String 主键
                    applyId Long 调拨申请ID,关联wssmet_transferapply_w表的id字段
                    outCode String 出库
                    receiverId Long 接收人ID,关联tf_user表的id字段
                    receiverName String 领用人
                    receiveTime DateTime 领用时间
                    outStatusCode String(枚举 code) 出库状态

                    调拨出库登记-新增

                    内容
                    接口说明 新增调拨出库登记
                    请求地址 POST /api/wm/manage/transfer/transferOut/
                    请求类型 POST

                    入参(Body: Dto)

                    字段 类型 说明
                    applyId Long 调拨申请ID,关联wssmet_transferapply_w表的id字段
                    outCode String 出库编号
                    receiverId Long 接收人ID,关联tf_user表的id字段
                    receiverName String 领用人
                    receiveTime DateTime 领用时间
                    outStatusCode String(枚举 code) 出库状态

                    出参

                    • ResultResponse
                    • data 字段

                      字段 类型 说明
                      id Long 新增记录主键

                      调拨出库登记-修改

                      内容
                      接口说明 修改调拨出库登记
                      请求地址 POST /api/wm/manage/transfer/transferOut/update
                      请求类型 POST

                      入参(Body: Dto(含 id))

                      字段 类型 说明
                      applyId Long 调拨申请ID,关联wssmet_transferapply_w表的id字段
                      outCode String 出库编号
                      receiverId Long 接收人ID,关联tf_user表的id字段
                      receiverName String 领用人
                      receiveTime DateTime 领用时间
                      outStatusCode String(枚举 code) 出库状态

                      出参

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

                        调拨出库登记-删除

                        内容
                        接口说明 逻辑删除调拨出库登记(支持批量)
                        请求地址 DELETE /api/wm/manage/transfer/transferOut/deleteByIds?ids=1,2
                        请求类型 DELETE

                        入参(Query: ids)

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

                        出参

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

                          分公司库存查询

                          内容
                          接口说明 调拨申请时各分公司库存
                          请求地址 GET /api/wm/manage/transfer/transferApply/stock
                          请求类型 GET

                          入参(Query)

                          字段 类型 说明
                          caliberCode String 口径
                          meterTypeCode String 水表类型

                          出参

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

                            调拨入库确认-分页查询

                            内容
                            接口说明 分页查询调拨入库确认
                            请求地址 GET /api/wm/manage/transfer/transferIn/page
                            请求类型 GET

                            入参(Query(PageQuery))

                            字段 类型 说明
                            applyCode String 申请编号
                            projectName String 项目
                            caliberCode String(字典 code) 口径编号
                            meterTypeCode String(字典 code) 水表类型编号
                            transferQty Integer 调拨数量
                            purpose String 用途
                            stockSnapshot String 库存快照
                            outStatusCode String(枚举 code) 出库状态
                            inStatusCode String(枚举 code) 入库状态
                            remark String 备注
                            workOrderCode String 工单编号(展示/台账查询)
                            approveStatus String(枚举 code) 审批状态

                            出参

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

                              data(PageInfo)字段

                              TransferInVo 字段

                              字段 类型 说明
                              pageNum Integer 当前页码
                              pageSize Integer 每页条数
                              total Long 总记录数
                              pages Integer 总页数
                              list List 当前页数据列表
                              字段 类型 说明
                              id String 主键
                              applyCode String 申请
                              outOrgId Long 出库组织ID,关联tf_org表的id字段
                              inOrgId Long 入库组织ID,关联tf_org表的id字段
                              projectName String 项目
                              caliberCode String(字典 code) 口径
                              meterTypeCode String(字典 code) 水表类型
                              transferQty Integer 调拨数量
                              purpose String 用途
                              stockSnapshot String 库存快照
                              outStatusCode String(枚举 code) 出库状态
                              inStatusCode String(枚举 code) 入库状态
                              remark String 备注
                              processInstanceId Long workflow 流程实例ID(工单中心外挂,不落本地工单表)
                              workOrderCode String 工单编号(展示/台账查询)
                              approveStatus String(枚举 code) 审批状态

                              调拨入库确认-列表查询

                              内容
                              接口说明 列表查询调拨入库确认
                              请求地址 GET /api/wm/manage/transfer/transferIn/list
                              请求类型 GET

                              入参(Query)

                              字段 类型 说明
                              applyCode String 申请编号
                              projectName String 项目
                              caliberCode String(字典 code) 口径编号
                              meterTypeCode String(字典 code) 水表类型编号
                              transferQty Integer 调拨数量
                              purpose String 用途
                              stockSnapshot String 库存快照
                              outStatusCode String(枚举 code) 出库状态
                              inStatusCode String(枚举 code) 入库状态
                              remark String 备注
                              workOrderCode String 工单编号(展示/台账查询)
                              approveStatus String(枚举 code) 审批状态

                              出参

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

                                data(List)元素字段

                                TransferInVo 字段

                                字段 类型 说明
                                id String 主键
                                applyCode String 申请
                                outOrgId Long 出库组织ID,关联tf_org表的id字段
                                inOrgId Long 入库组织ID,关联tf_org表的id字段
                                projectName String 项目
                                caliberCode String(字典 code) 口径
                                meterTypeCode String(字典 code) 水表类型
                                transferQty Integer 调拨数量
                                purpose String 用途
                                stockSnapshot String 库存快照
                                outStatusCode String(枚举 code) 出库状态
                                inStatusCode String(枚举 code) 入库状态
                                remark String 备注
                                processInstanceId Long workflow 流程实例ID(工单中心外挂,不落本地工单表)
                                workOrderCode String 工单编号(展示/台账查询)
                                approveStatus String(枚举 code) 审批状态

                                调拨入库确认-详情

                                内容
                                接口说明 查询调拨入库确认详情
                                请求地址 GET /api/wm/manage/transfer/transferIn/{id}
                                请求类型 GET

                                入参(Path: id)

                                字段 类型 说明
                                id String 主键

                                出参

                                • ResultResponse(含明细 list 若适用)
                                • 外层包装 ResultResponse 含 code、message、data,见 公共接口说明 §1.3。

                                  data(TransferInVo)字段

                                  TransferInVo 字段

                                  字段 类型 说明
                                  id String 主键
                                  applyCode String 申请
                                  outOrgId Long 出库组织ID,关联tf_org表的id字段
                                  inOrgId Long 入库组织ID,关联tf_org表的id字段
                                  projectName String 项目
                                  caliberCode String(字典 code) 口径
                                  meterTypeCode String(字典 code) 水表类型
                                  transferQty Integer 调拨数量
                                  purpose String 用途
                                  stockSnapshot String 库存快照
                                  outStatusCode String(枚举 code) 出库状态
                                  inStatusCode String(枚举 code) 入库状态
                                  remark String 备注
                                  processInstanceId Long workflow 流程实例ID(工单中心外挂,不落本地工单表)
                                  workOrderCode String 工单编号(展示/台账查询)
                                  approveStatus String(枚举 code) 审批状态

                                  调拨入库确认-新增

                                  内容
                                  接口说明 新增调拨入库确认
                                  请求地址 POST /api/wm/manage/transfer/transferIn/
                                  请求类型 POST

                                  入参(Body: Dto)

                                  字段 类型 说明
                                  applyCode String 申请编号
                                  outOrgId Long 出库组织ID,关联tf_org表的id字段
                                  inOrgId Long 入库组织ID,关联tf_org表的id字段
                                  projectName String 项目
                                  caliberCode String(字典 code) 口径编号
                                  meterTypeCode String(字典 code) 水表类型编号
                                  transferQty Integer 调拨数量
                                  purpose String 用途
                                  stockSnapshot String 库存快照
                                  outStatusCode String(枚举 code) 出库状态
                                  inStatusCode String(枚举 code) 入库状态
                                  remark String 备注
                                  processInstanceId Long workflow 流程实例ID(工单中心外挂,不落本地工单表)
                                  workOrderCode String 工单编号(展示/台账查询)
                                  approveStatus String(枚举 code) 审批状态

                                  出参

                                  • ResultResponse
                                  • data 字段

                                    字段 类型 说明
                                    id Long 新增记录主键

                                    调拨入库确认-修改

                                    内容
                                    接口说明 修改调拨入库确认
                                    请求地址 POST /api/wm/manage/transfer/transferIn/update
                                    请求类型 POST

                                    入参(Body: Dto(含 id))

                                    字段 类型 说明
                                    applyCode String 申请编号
                                    outOrgId Long 出库组织ID,关联tf_org表的id字段
                                    inOrgId Long 入库组织ID,关联tf_org表的id字段
                                    projectName String 项目
                                    caliberCode String(字典 code) 口径编号
                                    meterTypeCode String(字典 code) 水表类型编号
                                    transferQty Integer 调拨数量
                                    purpose String 用途
                                    stockSnapshot String 库存快照
                                    outStatusCode String(枚举 code) 出库状态
                                    inStatusCode String(枚举 code) 入库状态
                                    remark String 备注
                                    processInstanceId Long workflow 流程实例ID(工单中心外挂,不落本地工单表)
                                    workOrderCode String 工单编号(展示/台账查询)
                                    approveStatus String(枚举 code) 审批状态

                                    出参

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

                                      调拨入库确认-删除

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

                                      入参(Query: ids)

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

                                      出参

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

                                        调拨入库确认

                                        内容
                                        接口说明 调入方确认入库
                                        请求地址 POST /api/wm/manage/transfer/transferIn/confirm
                                        请求类型 POST

                                        入参(Body: ConfirmDto)

                                        字段 类型 说明
                                        applyId Long 调拨申请ID

                                        出参

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