Home Explore Help
Sign In
zenghaiyang
/
ylsw-bw
1
0
Fork 0
Files Issues 0 Pull Requests 0 Wiki
Tree: 85a21dde45
Branches Tags
ylsw-bw
/
business
/
water-meter
/
doc
/
demand
/
功能需求说明
/
仪陇表务管理系统-PRD-04-功能需求说明-03-采购管理-V1.0.md

仪陇表务管理系统-PRD-04-功能需求说明-03-采购管理-V1.0.md 31 KB
History Raw

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

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

文档版本：V1.0

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

模块序号：03

模块名称：采购管理

采购管理

本模块覆盖分公司采购申请、采购计划维护及到货登记，对应《PRD-01》采购管理能力。含 Web 菜单：采购申请、采购计划。审批在工单中心办理，到货后驱动落地检。

采购申请

功能描述

分公司发起采购申请，填写申请基础信息与采购需求明细，提交后自动生成采购类工单并完成逐级审核；通过后驱动采购计划生成。

菜单权限

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

数据权限

表务分公司库管员：可见、可发起本分公司采购申请；「历史记录」Tab 仅展示本人发起的申请工单。

表务分公司管理人员：可见本分公司采购申请数据（只读，不可发起，除非兼岗库管员）。

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

其他角色通过工单中心查看与办理审批，无本菜单发起权限。

核心逻辑

提交时生成采购申请主记录、采购需求明细及关联工单，对接 workflow 引擎。

终审通过后系统自动拆分生成采购计划及到货记录，不在本菜单维护计划与到货。

业务流程

流程概要

分公司库管员发起 → 分公司综合办主任一级审核 → 分公司分管领导二级审核 → 水表管理中心主任/副主任三级审核 → 招采部部长/副部长四级审核 → 系统自动按规则拆分生成采购计划；后续采购履约与到货在「采购计划」菜单办理。

环节说明表

序号 环节名称 环节类型 责任岗位 须填写 / 处理内容 审核结果选项 通过后流向 驳回 / 其他结果流向 抄送
1 采购申请发起 发起 分公司库管员 填报采购申请基础信息及采购需求明细（见「一级页面：采购申请-tab-工单发起」） 提交 采购申请一级审核 — —
2 采购申请一级审核 审核 分公司综合办主任 核查申请合理性与基础合规性；填写审核意见 通过；驳回 采购申请二级审核 退回采购申请发起 —
3 采购申请二级审核 审核 分公司分管领导 复核业务匹配度与审批合规性；填写审核意见 通过；驳回 采购申请三级审核 退回采购申请一级审核 —
4 采购申请三级审核 审核 水表管理中心主任 / 副主任 核验需求必要性、参数适配性；填写审核意见 通过；驳回 采购申请四级审核 退回采购申请二级审核 —
5 采购申请四级审核 审核 分公司招采部部长 / 副部长 审核预算及采购合规性；填写审核意见 通过；驳回 流程通过（系统自动） 退回采购申请三级审核 —
6 自动生成采购计划 系统自动 系统 终审通过后按厂家、物资类型、口径、所属分公司自动拆分生成采购计划及到货记录 — 流程完结（待采购履约） — —

审核通过后数据影响

更新采购申请记录及关联工单状态为「已通过」。

自动创建采购计划及到货主记录（可按一单申请拆分为多份计划）。

招采部在「采购计划」维护合同、预计到货日期等履约信息。

到货登记后创建水表主数据，状态为「待落地检」，并写入到货台账。

关联界面逻辑闭环

发起侧：「历史记录」Tab 展示工单状态、当前节点；通过后展示关联采购计划单号及到货状态。

办理侧：「去处理」跳转工单中心「二级页面：工单办理」。

计划侧：「采购计划」列表出现新计划记录，支持到货登记；状态与采购申请、工单中心一致。

检定侧：到货登记完成后，「落地检管理」可见待落地检水表。

审核界面说明

标准界面：工单中心「二级页面：工单办理」；含申请信息只读区、采购明细只读区、审批记录、审核意见、通过/驳回。

本业务差异：各审核环节只读展示完整申请信息及采购需求明细；无额外填报区块。

功能需求

一级页面：采购申请-tab-工单发起

#整体布局

-- 菜单入口：Tab 页结构；Tab 列表：工单发起（本 Tab，默认选中）、历史记录

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

#信息展示

-- 申请部门：只读，默认当前用户所属部门

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

-- 申请日期：只读，默认当前日期

-- 需求说明：选填，多行文本

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

-- 采购需求明细区：表格，支持新增行、删除行（至少 1 行）

-- 水表口径：必填，下拉

-- 水表类型：必填，下拉（物联网表 / 机械表等）

-- 申请数量：必填，正整数

-- 厂家：选填，下拉（可选范围来自厂家管理）

-- 明细备注：选填

#底部按钮

-- 提交：校验后提交，进入采购申请审批流程

-- 重置：清空表单；有内容时二次确认

#交互说明

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

一级页面：采购申请-tab-历史记录

#整体布局

-- Tab「历史记录」；查询区 + 列表；数据范围：仅当前账号发起的采购申请工单

#查询条件

-- 工单编号、申请单号、工单状态、申请日期范围；查询、重置

#数据列表

-- 表格字段：工单编号、申请单号、申请日期、申请总数量、当前节点、工单状态、关联计划单号、提交时间

-- 行内操作：详情

#交互说明

-- 打开「弹窗：采购申请工单详情」

弹窗：采购申请工单详情

#弹窗类型

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

#信息展示

-- Tab：申请信息 / 采购明细 / 审批记录；通过后展示关联采购计划单号

#底部按钮

-- 关闭；去处理：审批中且当前用户为处理人时显示

采购计划

功能描述

执行采购履约与到货管理；支持计划直接新建、关联已审批采购申请生成、合同录入、到货登记及台账查询；招采部可与检定中心协同到货签收。

菜单权限

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

数据权限

表务水表采购、表务总公司管理人员：可见、可操作全公司范围内采购计划及到货数据。

表务水表管理中心：可见全公司计划数据（协同到货签收场景，只读或按岗位授权登记）。

表务系统管理员：可见、可操作全公司数据。

表务分公司库管员：可见关联本分公司申请的计划数据（只读，不可维护履约）。

核心逻辑

以采购计划及到货记录为业务主体；审批通过后自动创建计划，亦可无申请直接新建。

到货登记联动创建水表主数据、到货台账及生命周期记录，状态初始为待落地检。

功能需求

一级页面：采购计划

#整体布局

-- 查询条件 + 采购计划列表；顶部「新建计划」「到货登记」

#查询条件

-- 采购计划单号、厂家、到货状态、预计到货日期范围、关联申请单号

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

#数据列表

-- 表格字段：计划单号、厂家、水表口径、水表类型、计划数量、合同编号、预计到货日期、实际到货日期、到货状态、关联申请单号

-- 行内操作：详情、到货登记（待到货/部分到货时）、编辑（履约信息）

#交互说明

-- 「新建计划」打开「弹窗：新建/编辑采购计划」（无采购申请时直建）

-- 「到货登记」打开「弹窗：到货登记」

-- 点击详情打开「弹窗：采购计划详情」

弹窗：新建/编辑采购计划

#弹窗类型

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

#信息展示

-- 关联采购申请单号：选填（来源于已通过申请时系统带入；直建时为空）

-- 厂家：必填，下拉

-- 水表口径、水表类型：必填

-- 计划数量：必填，正整数

-- 所属分公司：必填（拆分维度）

-- 合同编号：选填

-- 采购时间、预计到货日期：选填，日期

-- 备注：选填

#底部按钮

-- 保存；取消

#交互说明

-- 保存后刷新列表；支持一单申请关联生成（审批通过自动创建时只读打开详情）

弹窗：到货登记

#弹窗类型

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

#弹窗标题

-- 到货登记 - {采购计划单号}

#信息展示

-- 计划信息只读：计划单号、厂家、口径、类型、计划数量

-- 实际到货日期：必填

-- 到货数量：必填，正整数

-- 签收人：只读，默认当前用户

-- 到货水表明细：支持扫码/手工录入水表编号、出厂编号等（按到货数量）

-- 落地检完成时限：选填，日期

-- 附件：选填，上传签收凭证

-- 备注：选填

#底部按钮

-- 确认到货；取消

#交互说明

-- 确认后更新计划到货状态；自动创建水表主数据（状态待落地检）及到货台账、生命周期「到货」阶段

-- 驱动「落地检管理」待检清单

弹窗：采购计划详情

#弹窗类型

-- 抽屉弹窗（右侧）；只读 + 操作按钮

#信息展示

-- 计划主信息、到货记录、关联申请及审批摘要、到货水表明细

#底部按钮

-- 关闭；编辑；到货登记（按状态显示）

详细设计（研发）

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

仪陇表务-功能设计-03-采购管理-V1.0

1. 模块概述

项 说明
模块序号 03
模块名称 采购管理
后端包（建议） com.tofly.wm.manage.puachase
业务模式 申请工单+计划直办
工单 PURCHASE_APPLY，四级审批

2. 功能范围

  • 采购申请
  • 采购计划
  • 到货登记

3. 数据模型

3.1 涉及表

  • wssmet_purapply_w
  • wssmet_purapplylist_w
  • wssmet_purplan_w
  • wssmet_purplanarr_w
  • wssmet_purplanarrlist_w

3.2 实体约定

  • 所有实体 extends BaseEntity；逻辑删除 Boolean deleted ↔ deleted。
  • 字典 DictEntry + @DictDirectory(MeterConstant.*) ↔ 库列 VARCHAR2；组织/用户 OrganizationEntry/UserNameEntry ↔ 库列 NUMBER(19)；附件 FileEntryList/FileEntry 用 @TableField(exist = false)，无库列。
  • 申请类主表含 process_instance_id / work_order_code / approve_status；工单反查 （无本地表，见 workflow）.TABLE_NAME + TABLE_ID。

4. 业务流程

申请→四级审批→自动生成计划→履约/到货→创建 Meter(待落地检)。

5. 核心业务规则

  • 终审按厂家/口径/类型/分公司拆分计划
  • 到货附件为 FileEntryList，@TableField(exist = false)，无库列

6. 接口设计（概要）

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

采购申请-分页查询

项 内容
接口说明 分页查询采购申请
请求地址 GET /api/wm/manage/purchase/purchaseApply/page
请求类型 GET

入参（Query（PageQuery））

字段 类型 说明
applyCode String 申请编号
applyDate Date 申请日期
demandDesc String 需求
processStatusCode String（枚举 code） 流程状态
remark String 备注
workOrderCode String 工单编号（展示/台账查询）
approveStatus String（枚举 code） 审批状态

出参

  • ResultResponse>

    • 采购申请-列表查询

    项 内容
    接口说明 列表查询采购申请
    请求地址 GET /api/wm/manage/purchase/purchaseApply/list
    请求类型 GET

    入参（Query）

    字段 类型 说明
    applyCode String 申请编号
    applyDate Date 申请日期
    demandDesc String 需求
    processStatusCode String（枚举 code） 流程状态
    remark String 备注
    workOrderCode String 工单编号（展示/台账查询）
    approveStatus String（枚举 code） 审批状态

    出参

    • ResultResponse>

      • 采购申请-详情

      项 内容
      接口说明 查询采购申请详情
      请求地址 GET /api/wm/manage/purchase/purchaseApply/{id}
      请求类型 GET

      入参（Path: id）

      字段 类型 说明
      id String 主键

      出参

      • ResultResponse（含明细 list 若适用）

        • 采购申请-新增

        项 内容
        接口说明 新增采购申请；提交时同步发起 workflow，回写 process_instance_id / work_order_code / approve_status
        请求地址 POST /api/wm/manage/purchase/purchaseApply/
        请求类型 POST

        入参（Body: Dto）

        字段 类型 说明
        applyCode String 申请编号
        applyDeptId Long 申请部门ID，关联tf_org表的id字段
        applyUserId Long 申请用户ID，关联tf_user表的id字段
        applyDate Date 申请日期
        demandDesc String 需求
        processStatusCode String（枚举 code） 流程状态
        remark String 备注
        processInstanceId Long workflow 流程实例ID（工单中心外挂，不落本地工单表）
        workOrderCode String 工单编号（展示/台账查询）
        approveStatus String（枚举 code） 审批状态

        出参

        • ResultResponse

          • 采购申请-修改

          项 内容
          接口说明 修改采购申请
          请求地址 POST /api/wm/manage/purchase/purchaseApply/update
          请求类型 POST

          入参（Body: Dto（含 id））

          字段 类型 说明
          applyCode String 申请编号
          applyDeptId Long 申请部门ID，关联tf_org表的id字段
          applyUserId Long 申请用户ID，关联tf_user表的id字段
          applyDate Date 申请日期
          demandDesc String 需求
          processStatusCode String（枚举 code） 流程状态
          remark String 备注
          processInstanceId Long workflow 流程实例ID（工单中心外挂，不落本地工单表）
          workOrderCode String 工单编号（展示/台账查询）
          approveStatus String（枚举 code） 审批状态

          出参

          • ResultResponse

            • 采购申请-删除

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

            入参（Query: ids）

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

            出参

            • ResultResponse

              • 采购申请明细-分页查询

              项 内容
              接口说明 分页查询采购申请明细
              请求地址 GET /api/wm/manage/purchase/purchaseApplyList/page
              请求类型 GET

              入参（Query（PageQuery））

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

              出参

              • ResultResponse>

                • 采购申请明细-列表查询

                项 内容
                接口说明 列表查询采购申请明细
                请求地址 GET /api/wm/manage/purchase/purchaseApplyList/list
                请求类型 GET

                入参（Query）

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

                出参

                • ResultResponse>

                  • 采购申请明细-详情

                  项 内容
                  接口说明 查询采购申请明细详情
                  请求地址 GET /api/wm/manage/purchase/purchaseApplyList/{id}
                  请求类型 GET

                  入参（Path: id）

                  字段 类型 说明
                  id String 主键

                  出参

                  • ResultResponse（含明细 list 若适用）

                    • 采购申请明细-新增

                    项 内容
                    接口说明 新增采购申请明细
                    请求地址 POST /api/wm/manage/purchase/purchaseApplyList/
                    请求类型 POST

                    入参（Body: Dto）

                    字段 类型 说明
                    applyId Long 采购申请ID，关联wssmet_purapply_w表的id字段
                    caliberCode String（字典 code） 口径编号
                    meterTypeCode String（字典 code） 水表类型编号
                    applyQty Integer 申请数量
                    brandId Long 厂家ID，关联wssmet_meterbrand_w表的id字段
                    remark String 备注

                    出参

                    • ResultResponse

                      • 采购申请明细-修改

                      项 内容
                      接口说明 修改采购申请明细
                      请求地址 POST /api/wm/manage/purchase/purchaseApplyList/update
                      请求类型 POST

                      入参（Body: Dto（含 id））

                      字段 类型 说明
                      applyId Long 采购申请ID，关联wssmet_purapply_w表的id字段
                      caliberCode String（字典 code） 口径编号
                      meterTypeCode String（字典 code） 水表类型编号
                      applyQty Integer 申请数量
                      brandId Long 厂家ID，关联wssmet_meterbrand_w表的id字段
                      remark String 备注

                      出参

                      • ResultResponse

                        • 采购申请明细-删除

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

                        入参（Query: ids）

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

                        出参

                        • ResultResponse

                          • 采购计划-分页查询

                          项 内容
                          接口说明 分页查询采购计划
                          请求地址 GET /api/wm/manage/purchase/purchasePlan/page
                          请求类型 GET

                          入参（Query（PageQuery））

                          字段 类型 说明
                          planCode String 计划编号
                          caliberCode String（字典 code） 口径编号
                          meterTypeCode String（字典 code） 水表类型编号
                          planQty Integer 计划数量
                          contractNo String 合同
                          purchaseDate Date 采购日期
                          expectArriveDate Date 到货日期
                          actualArriveDate Date 实际到货日期
                          arriveStatusCode String（枚举 code） 到货状态
                          remark String 备注

                          出参

                          • ResultResponse>

                            • 采购计划-列表查询

                            项 内容
                            接口说明 列表查询采购计划
                            请求地址 GET /api/wm/manage/purchase/purchasePlan/list
                            请求类型 GET

                            入参（Query）

                            字段 类型 说明
                            planCode String 计划编号
                            caliberCode String（字典 code） 口径编号
                            meterTypeCode String（字典 code） 水表类型编号
                            planQty Integer 计划数量
                            contractNo String 合同
                            purchaseDate Date 采购日期
                            expectArriveDate Date 到货日期
                            actualArriveDate Date 实际到货日期
                            arriveStatusCode String（枚举 code） 到货状态
                            remark String 备注

                            出参

                            • ResultResponse>

                              • 采购计划-详情

                              项 内容
                              接口说明 查询采购计划详情
                              请求地址 GET /api/wm/manage/purchase/purchasePlan/{id}
                              请求类型 GET

                              入参（Path: id）

                              字段 类型 说明
                              id String 主键

                              出参

                              • ResultResponse（含明细 list 若适用）

                                • 采购计划-新增

                                项 内容
                                接口说明 新增采购计划
                                请求地址 POST /api/wm/manage/purchase/purchasePlan/
                                请求类型 POST

                                入参（Body: Dto）

                                字段 类型 说明
                                planCode String 计划编号
                                applyId Long 采购申请ID，关联wssmet_purapply_w表的id字段
                                brandId Long 厂家ID，关联wssmet_meterbrand_w表的id字段
                                caliberCode String（字典 code） 口径编号
                                meterTypeCode String（字典 code） 水表类型编号
                                planQty Integer 计划数量
                                branchOrgId Long 分公司组织ID，关联tf_org表的id字段
                                contractNo String 合同
                                purchaseDate Date 采购日期
                                expectArriveDate Date 到货日期
                                actualArriveDate Date 实际到货日期
                                arriveStatusCode String（枚举 code） 到货状态
                                remark String 备注

                                出参

                                • ResultResponse

                                  • 采购计划-修改

                                  项 内容
                                  接口说明 修改采购计划
                                  请求地址 POST /api/wm/manage/purchase/purchasePlan/update
                                  请求类型 POST

                                  入参（Body: Dto（含 id））

                                  字段 类型 说明
                                  planCode String 计划编号
                                  applyId Long 采购申请ID，关联wssmet_purapply_w表的id字段
                                  brandId Long 厂家ID，关联wssmet_meterbrand_w表的id字段
                                  caliberCode String（字典 code） 口径编号
                                  meterTypeCode String（字典 code） 水表类型编号
                                  planQty Integer 计划数量
                                  branchOrgId Long 分公司组织ID，关联tf_org表的id字段
                                  contractNo String 合同
                                  purchaseDate Date 采购日期
                                  expectArriveDate Date 到货日期
                                  actualArriveDate Date 实际到货日期
                                  arriveStatusCode String（枚举 code） 到货状态
                                  remark String 备注

                                  出参

                                  • ResultResponse

                                    • 采购计划-删除

                                    项 内容
                                    接口说明 逻辑删除采购计划（支持批量）
                                    请求地址 DELETE /api/wm/manage/purchase/purchasePlan/deleteByIds?ids=1,2
                                    请求类型 DELETE

                                    入参（Query: ids）

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

                                    出参

                                    • ResultResponse

                                      • 采购计划-到货登记

                                      项 内容
                                      接口说明 登记到货批次与水表明细，创建水表主数据
                                      请求地址 POST /api/wm/manage/purchase/purchasePlan/arrive
                                      请求类型 POST

                                      入参（Body: Dto）

                                      字段 类型 说明
                                      arrId Long 到货批次ID，关联wssmet_purplanarr_w表的id字段
                                      meterId Long 水表ID，关联wssmet_meter_w表的id字段
                                      factoryCode String 出厂编码
                                      meterCode String 水表表号
                                      caliberCode String（字典 code） 口径编号
                                      meterTypeCode String（字典 code） 水表类型编号

                                      出参

                                      • ResultResponse

                                        • 采购到货批次-分页查询

                                        项 内容
                                        接口说明 分页查询采购到货批次
                                        请求地址 GET /api/wm/manage/purchase/purchasePlanArr/page
                                        请求类型 GET

                                        入参（Query（PageQuery））

                                        字段 类型 说明
                                        arriveDate Date 到货日期
                                        arriveQty Integer 到货数量
                                        verifyDeadline String 检定
                                        remark String 备注

                                        出参

                                        • ResultResponse>

                                          • 采购到货批次-列表查询

                                          项 内容
                                          接口说明 列表查询采购到货批次
                                          请求地址 GET /api/wm/manage/purchase/purchasePlanArr/list
                                          请求类型 GET

                                          入参（Query）

                                          字段 类型 说明
                                          arriveDate Date 到货日期
                                          arriveQty Integer 到货数量
                                          verifyDeadline String 检定
                                          remark String 备注

                                          出参

                                          • ResultResponse>

                                            • 采购到货批次-详情

                                            项 内容
                                            接口说明 查询采购到货批次详情
                                            请求地址 GET /api/wm/manage/purchase/purchasePlanArr/{id}
                                            请求类型 GET

                                            入参（Path: id）

                                            字段 类型 说明
                                            id String 主键

                                            出参

                                            • ResultResponse（含明细 list 若适用）

                                              • 采购到货批次-新增

                                              项 内容
                                              接口说明 新增采购到货批次
                                              请求地址 POST /api/wm/manage/purchase/purchasePlanArr/
                                              请求类型 POST

                                              入参（Body: Dto）

                                              字段 类型 说明
                                              planId Long 采购计划ID，关联wssmet_purplan_w表的id字段
                                              arriveDate Date 到货日期
                                              arriveQty Integer 到货数量
                                              signUserId Long 签收用户ID，关联tf_user表的id字段
                                              verifyDeadline String 检定
                                              remark String 备注

                                              出参

                                              • ResultResponse

                                                • 采购到货批次-修改

                                                项 内容
                                                接口说明 修改采购到货批次
                                                请求地址 POST /api/wm/manage/purchase/purchasePlanArr/update
                                                请求类型 POST

                                                入参（Body: Dto（含 id））

                                                字段 类型 说明
                                                planId Long 采购计划ID，关联wssmet_purplan_w表的id字段
                                                arriveDate Date 到货日期
                                                arriveQty Integer 到货数量
                                                signUserId Long 签收用户ID，关联tf_user表的id字段
                                                verifyDeadline String 检定
                                                remark String 备注

                                                出参

                                                • ResultResponse

                                                  • 采购到货批次-删除

                                                  项 内容
                                                  接口说明 逻辑删除采购到货批次（支持批量）
                                                  请求地址 DELETE /api/wm/manage/purchase/purchasePlanArr/deleteByIds?ids=1,2
                                                  请求类型 DELETE

                                                  入参（Query: ids）

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

                                                  出参

                                                  • ResultResponse

                                                    • 采购到货水表明细-分页查询

                                                    项 内容
                                                    接口说明 分页查询采购到货水表明细
                                                    请求地址 GET /api/wm/manage/purchase/purchasePlanArrList/page
                                                    请求类型 GET

                                                    入参（Query（PageQuery））

                                                    字段 类型 说明
                                                    factoryCode String 出厂编码
                                                    meterCode String 水表表号
                                                    caliberCode String（字典 code） 口径编号
                                                    meterTypeCode String（字典 code） 水表类型编号

                                                    出参

                                                    • ResultResponse>

                                                      • 采购到货水表明细-列表查询

                                                      项 内容
                                                      接口说明 列表查询采购到货水表明细
                                                      请求地址 GET /api/wm/manage/purchase/purchasePlanArrList/list
                                                      请求类型 GET

                                                      入参（Query）

                                                      字段 类型 说明
                                                      factoryCode String 出厂编码
                                                      meterCode String 水表表号
                                                      caliberCode String（字典 code） 口径编号
                                                      meterTypeCode String（字典 code） 水表类型编号

                                                      出参

                                                      • ResultResponse>

                                                        • 采购到货水表明细-详情

                                                        项 内容
                                                        接口说明 查询采购到货水表明细详情
                                                        请求地址 GET /api/wm/manage/purchase/purchasePlanArrList/{id}
                                                        请求类型 GET

                                                        入参（Path: id）

                                                        字段 类型 说明
                                                        id String 主键

                                                        出参

                                                        • ResultResponse（含明细 list 若适用）

                                                          • 采购到货水表明细-新增

                                                          项 内容
                                                          接口说明 新增采购到货水表明细
                                                          请求地址 POST /api/wm/manage/purchase/purchasePlanArrList/
                                                          请求类型 POST

                                                          入参（Body: Dto）

                                                          字段 类型 说明
                                                          arrId Long 到货批次ID，关联wssmet_purplanarr_w表的id字段
                                                          meterId Long 水表ID，关联wssmet_meter_w表的id字段
                                                          factoryCode String 出厂编码
                                                          meterCode String 水表表号
                                                          caliberCode String（字典 code） 口径编号
                                                          meterTypeCode String（字典 code） 水表类型编号

                                                          出参

                                                          • ResultResponse

                                                            • 采购到货水表明细-修改

                                                            项 内容
                                                            接口说明 修改采购到货水表明细
                                                            请求地址 POST /api/wm/manage/purchase/purchasePlanArrList/update
                                                            请求类型 POST

                                                            入参（Body: Dto（含 id））

                                                            字段 类型 说明
                                                            arrId Long 到货批次ID，关联wssmet_purplanarr_w表的id字段
                                                            meterId Long 水表ID，关联wssmet_meter_w表的id字段
                                                            factoryCode String 出厂编码
                                                            meterCode String 水表表号
                                                            caliberCode String（字典 code） 口径编号
                                                            meterTypeCode String（字典 code） 水表类型编号

                                                            出参

                                                            • ResultResponse

                                                              • 采购到货水表明细-删除

                                                              项 内容
                                                              接口说明 逻辑删除采购到货水表明细（支持批量）
                                                              请求地址 DELETE /api/wm/manage/purchase/purchasePlanArrList/deleteByIds?ids=1,2
                                                              请求类型 DELETE

                                                              入参（Query: ids）

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

                                                              出参

                                                              • ResultResponse