vue3-element-plus-app-chu 0.0.24 → 0.0.26

package/README.md

@@ -23,15 +23,19 @@ pnpm dev:backend  # 只启动后端（backend/ 目录，tsx watch）
 默认入口为数字人民币头寸预报（`/forecast`），侧边菜单可切换至其他数字人民币页面。
 
 - 列表页只保留筛选卡片和表格卡片；筛选条件压在一行，窗口过窄时才换行。
-- 新增、修改、详情不使用弹窗，分别对应 `/forecast/create`、`/forecast/:predRefNo/edit`、`/forecast/:predRefNo` 独立路由，页面顶部提供“返回列表”按钮；返回后列表的筛选和分页状态不变。
+- 新增、修改、详情与列表共用 `/forecast` 入口，以当前页面状态切换完整视图，页面顶部提供“返回列表”按钮；返回后列表的筛选和分页状态不变。
 - 支持交易日期、客户、交易对手、机构、金额范围及业务代码筛选，分页、详情、新增、修改和批量删除。
-- 金额、账号及流水号使用字符串处理。业务状态与类型代码保留接口原值，待服务端提供字典后再接入中文选项。
+- 金额、账号及流水号使用字符串处理。业务类型使用文档明确的中文选项，其余未提供字典的代码保留接口原值。
 - 导入、导出按钮保留在列表工具栏，文件由后端接口生成和解析，页面不再在前端拼装 CSV。
-- 模块目录与授权页面保持一致：`api.ts` 只放接口定义，`utils.ts` 放日期、金额、表单校验等共用工具，`typs.ts` 类型，`runtime.ts` 默认交易日期，`index.vue` 为入口，`components/` 放页面外壳和列表、新增修改、详情页面。接口定义只维护在各自模块下，不再集中到 `src/api`。
+- 模块目录与授权页面保持一致：`api.ts` 放接口定义，`typs.ts` 放类型，`index.vue` 包含列表、表单、详情和页面内工具函数。默认交易日期通过共用的 `src/view/dcps/runtime.ts` 获取，接口定义只维护在各自模块下，不再集中到 `src/api`。
 - 新增、修改、详情页面每行四列展示，窗口变窄后依次降为三列、两列、一列。
 
 本地后端已接入 MongoDB 业务模拟，预报增删改查、核销、注资余额、匡算历史和参数均可持久化。JSON 响应统一为 `{ code, data, message }`，TAM 的 `head/body` 位于 `data` 中，前端公共请求层自动解包。服务端导入协议尚未实现时明确返回 `501`。完整运行说明见 [后端 README](backend/README.md)。
 
+数字人民币相关接口已按 2026-10-26 最新 Swagger 同步：新增预报的业务类型必填并使用 `201/202/203` 字典，移除 `predName`；核销预报方向使用 `1/2`，待核销查询包含状态 `1/3`，补充交易对手账号；流水增加业务类型筛选并改用 `tranStatus`；注资明细支持起止交易日期；授权页展示业务类型中文名称。匡算明细同步展示部分核销状态。部分核销的继续处理金额语义尚未定义，当前支持查询展示，操作仍沿用原有未核销/已核销流程。字段及本地实现说明见 [数字人民币接口摘录](docs/digital-rmb-apis.md)。
+
+2026-10-27 新增 `/TAM/0001/140504002` 实时流水查询。独立页面 `/flow-query` 改为调用该接口，按 `txnLists` 展示平台流水、交易金额、时间、收付款人、钱包及机构信息，支持分页和刷新。该接口的业务请求体为空，页面不再提交旧核销流水的日期、姓名、金额等筛选；核销页面继续使用 `/140502002`。新接口未声明的业务类型、方向和状态字典保留原值。
+
 ## 城银清头寸参数接口
 
 参数管理接口已支持持久化增删改查、关键词筛选和分页。数币页面位于 `src/view/dcps/parameters/`，使用 `moduleCode: '5'`；页面详情直接取表格行数据，不再请求详情接口。同一后端也支持城银清模块 `'3'`。参数名称全局唯一，修改和删除按名称定位；接口字段和示例见 [城银清头寸参数接口说明](docs/city-clearing-parameters-apis.md)，Scalar 文档入口为后端 `/docs`。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vue3-element-plus-app-chu",
-  "version": "0.0.24",
+  "version": "0.0.26",
   "private": false,
   "type": "module",
   "files": [

package/src/router/index.ts

@@ -6,6 +6,7 @@ import DigitalRmbForecast from '@/view/dcps/forecast/index.vue'
 import DigitalRmbInjection from '@/view/dcps/funding/injection/index.vue'
 import DigitalRmbWriteOff from '@/view/dcps/write-off/index.vue'
 import DigitalRmbPositionEstimation from '@/view/dcps/estimation/index.vue'
+import DigitalRmbFlowQuery from '@/view/dcps/flow-query/index.vue'
 import DigitalRmbParameters from '@/view/dcps/parameters/index.vue'
 
 declare module 'vue-router' {
@@ -57,6 +58,12 @@ const routes: RouteRecordRaw[] = [
           },
         ],
       },
+      {
+        path: 'flow-query',
+        name: 'flow-query',
+        component: DigitalRmbFlowQuery,
+        meta: { menu: 'flow-query', title: '数字人民币流水查询' },
+      },
       {
         path: 'auth',
         name: 'auth',

package/src/router/menus.ts

@@ -23,6 +23,7 @@ export const layoutMenus: LayoutMenu[] = [
       { name: 'balance', title: '数字人民币账户行余额查询申请', compactTitle: '余额查询' },
     ],
   },
+  { name: 'flow-query', title: '数字人民币流水查询', compactTitle: '流水查询' },
   { name: 'auth', title: '数字人民币授权', compactTitle: '授权' },
   { name: 'write-off', title: '数字人民币核销', compactTitle: '核销' },
   { name: 'parameters', title: '数字人民币参数管理', compactTitle: '参数管理' },

package/src/view/dcps/README.md

@@ -2,7 +2,7 @@
 
 `src/view/dcps` 下每个业务页面统一保持三个文件，不再拆分子组件、工具文件：
 
-跨页面共用的运行时配置统一放在 `src/view/dcps/runtime.ts`，仅默认导出一个对象，包含 `date`（共用业务日期，格式为 `YYYYMMDD`）、`approverId`（工号）和 `approverName`（姓名）。日期在模块加载时按上海时区生成一次，预报、匡算、核销及授权查询的默认日期均使用同一个 `date`；授权日期范围的开始和结束默认都取该值。页面通过 `import dcpsRuntime from '../runtime'`（分组子页面为 `../../runtime`）引入，不再单独导出日期工具或模块配置。
+跨页面共用的运行时配置统一放在 `src/view/dcps/runtime.ts`，通过具名对象 `dcpsRuntime` 导出，包含 `date`（共用业务日期，格式为 `YYYYMMDD`）、`approverId`（工号）和 `approverName`（姓名）。日期在模块加载时按上海时区生成一次，预报、匡算、核销及授权查询的默认日期均使用同一个 `date`；授权日期范围的开始和结束默认都取该值。页面通过 `import { dcpsRuntime } from '../runtime'`（分组子页面为 `../../runtime`）引入，不再单独导出日期工具或模块配置。
 
 一级菜单为分组时，页面放在该分组目录下。例如“注资/预注资管理”的两个页面分别位于 `funding/injection/` 和 `funding/balance/`，各自保留下面三个文件。
 
@@ -14,6 +14,12 @@
 
 公共样式变量仍放在 `common.css`，由 `src/main.ts` 统一引入。
 
+## 当前接口契约
+
+数字人民币接口及递归引用模型以 `docs/digital-rmb.openapi.json` 的 2026-10-27 附件为准。预报新增移除 `predName`，`busiType` 为必填，字典为 `201` 兑回、`202` 兑出、`203` 付现。核销预报查询使用方向 `1/2`，待核销传 `verifyStatusList: ['1', '3']`，已核销传 `['2']`；预报管理和流水方向保持各自原协议。核销页流水查询增加 `busiType`，返回 `tranStatus`（`S/P/F`），核销状态支持 `3` 部分核销。注资明细支持 `txnDtStart`、`txnDtEnd` 单边或双边日期筛选。完整字段及本地业务限制见 `docs/digital-rmb-apis.md`。
+
+独立流水查询页面 `/flow-query` 使用新增的 `140504002`：业务请求体为空，公共请求头分页；读取 `txnLists` 和数字类型的 `totalCount`、`totalPage`，显示新模型的 16 个字符串字段。页面的 `api.ts`、`typs.ts` 独立维护该契约，不再复用核销页的 `140502002` 模型。业务类型、收支方向及交易状态未提供字典，按原值显示。
+
 ## 命名约定
 
 - 所有页面组件的 `defineOptions({ name })` 统一以 `Dcps` 开头（PascalCase）。
@@ -29,13 +35,11 @@
 | 路由路径 | 路由 name | 页面文件 | 页面形态 | 页面标题（meta.title） |
 | --- | --- | --- | --- | --- |
 | `/forecast` | `forecast` | `forecast/index.vue` | 列表 | 数字人民币头寸预报 |
-| `/forecast/create` | `forecast-create` | `forecast/index.vue` | 新增（`mode: 'create'`） | 新增数字人民币头寸预报 |
-| `/forecast/:predRefNo/edit` | `forecast-edit` | `forecast/index.vue` | 修改（`mode: 'edit'`） | 修改数字人民币头寸预报 |
-| `/forecast/:predRefNo` | `forecast-detail` | `forecast/index.vue` | 详情（`mode: 'detail'`） | 数字人民币头寸预报详情 |
 | `/estimation` | `estimation` | `estimation/index.vue` | 页面 | 数字人民币头寸匡算 |
 | `/funding` | `funding` | — | 重定向到 `injection` | 注资/预注资管理 |
 | `/funding/injection` | `injection` | `funding/injection/index.vue` | 页面 | 数字人民币注资明细查询 |
 | `/funding/balance` | `balance` | `funding/balance/index.vue` | 页面 | 数字人民币账户行余额查询申请 |
+| `/flow-query` | `flow-query` | `flow-query/index.vue` | 页面 | 数字人民币流水查询 |
 | `/auth` | `auth` | `auth/index.vue` | 页面 | 数字人民币授权 |
 | `/write-off` | `write-off` | `write-off/index.vue` | 页面 | 数字人民币核销 |
 | `/parameters` | `parameters` | `parameters/index.vue` | 列表、详情、新增和修改弹窗 | 数字人民币参数管理 |
@@ -44,13 +48,13 @@
 
 补充说明：
 
-- 头寸预报的列表、新增、修改、详情共用 `forecast/index.vue`，通过路由 `props.mode` 切换页面形态；修改和详情通过 `props.predRefNo` 接收路由参数。
-- `forecast/index.vue` 顶部使用一个普通 `<script>` 块保存列表记录缓存，跳转修改或详情前暂存列表行，用于补齐详情接口未返回的字段。
+- 头寸预报的列表、新增、修改、详情共用 `/forecast` 与 `forecast/index.vue`，通过当前组件的视图状态切换；修改和详情使用所选记录的 `predRefNo` 请求数据，返回列表保留筛选和分页。
+- `forecast/index.vue` 顶部使用一个普通 `<script>` 块保存列表记录缓存，打开修改或详情前暂存列表行，用于补齐详情接口未返回的字段。
 - 侧边菜单配置在 `src/router/menus.ts`，其中 `name` 必须与对应路由的 `name` 保持一致；分组菜单通过 `children` 配置二级页面，页面的 `meta.menu` 指向自己的菜单项。
 - “注资/预注资管理”对应 `funding` 分组，包含注资明细查询和账户行余额查询申请两个页面；访问子页面时自动展开父菜单。旧地址 `/injection`、`/balance` 保留为对应页面的别名。
-- 数字人民币参数管理为末尾的独立菜单，页面文件为 `parameters/index.vue`、`parameters/api.ts`、`parameters/typs.ts`，接口与类型均独立定义在该目录，不再依赖或保留 `city-clearing/` 目录。页面复用“城银清算头寸管理－头寸参数”的列表、新增、修改、删除四个接口，详情直接取表格行数据，不再请求详情接口；`api.ts` 参照授权页面直接向 `@chic/http` 平铺传参，由 Axios 公共封装拆分为服务端所需的 `body`、`head` 等字段，不手动包装信封。页面查询调用只传 `keywords`、数字类型的 `pageIndex` 和 `pageSize`，`moduleCode: '5'` 由 API 内部固定添加，分页数字由封装层转换为字符串；新增传六个字符串表单字段，模块代码也由 API 固定添加。本次用户确认以 `paraName` 定位修改和删除：修改时锁定原参数名称、参数标志只读；删除向 API 传名称数组，由 API 转为平铺的 `sysParaList`。页面类型使用 `DigitalRmbParameter` 等独立类型，原始 Swagger 契约及 `docs/city-clearing-parameters*` 文档文件名保留。当前本地后端仍返回模拟结果，不保存参数。
+- 数字人民币参数管理为末尾的独立菜单，页面文件为 `parameters/index.vue`、`parameters/api.ts`、`parameters/typs.ts`，接口与类型均独立定义在该目录，不再依赖或保留 `city-clearing/` 目录。页面复用“城银清算头寸管理－头寸参数”的列表、新增、修改、删除四个接口，详情直接取表格行数据，不再请求详情接口；`api.ts` 参照授权页面直接向 `@chic/http` 平铺传参，由 Axios 公共封装拆分为服务端所需的 `body`、`head` 等字段，不手动包装信封。页面查询调用只传 `keywords`、数字类型的 `pageIndex` 和 `pageSize`，`moduleCode: '5'` 由 API 内部固定添加，分页数字由封装层转换为字符串；新增传六个字符串表单字段，模块代码也由 API 固定添加。本次用户确认以 `paraName` 定位修改和删除：修改时锁定原参数名称、参数标志只读；删除向 API 传名称数组，由 API 转为平铺的 `sysParaList`。页面类型使用 `DigitalRmbParameter` 等独立类型，原始 Swagger 契约及 `docs/city-clearing-parameters*` 文档文件名保留。当前本地后端将业务模拟参数持久化至 MongoDB。
 - 数字人民币参数管理以数字人民币授权页面为布局参考，统一筛选区、填满剩余高度的表格以及包含摘要和分组字段的详情弹窗样式。
-- `src/layout/index.vue` 使用 `<KeepAlive include="DcpsForecastPage">` 缓存头寸预报页面；新增、修改、详情按路由 `key` 分别缓存，返回列表时自动重新查询。
+- `src/layout/index.vue` 使用 `<KeepAlive include="DcpsForecastPage">` 缓存头寸预报页面；新增、修改、详情在同一实例内切换，返回列表时自动重新查询。
 
 ## 新增页面检查清单
 

package/src/view/dcps/auth/index.vue

@@ -34,6 +34,12 @@ const filterFields = [
 ] as const
 // 任务状态字典：01 待审批、02 已通过、03 已拒绝。
 const statusLabels: Record<string, string> = { '01': '待审批', '02': '已通过', '03': '已拒绝' }
+// 业务类型按更新后的接口字典展示，未登记的代码保留原值。
+const businessTypeLabels: Record<string, string> = { '201': '兑回', '202': '兑出', '203': '付现' }
+const formatBusinessType = (value?: string) => {
+  const code = value?.trim() || ''
+  return code ? businessTypeLabels[code] || code : '—'
+}
 // 审批按钮配置：value 为操作标识，label 为按钮文字，type 为按钮样式。
 const decisionActions = [
   { value: 'reject', label: '拒绝', type: 'danger' },
@@ -221,7 +227,7 @@ const tableColumns: ColumnOption[] = [
   { key: 'sequence', type: 'globalIndex', label: '序号', width: 80, align: 'center' },
   textColumn('platfSeqNo', '平台流水号', 190),
   textColumn('id', '任务ID', 180),
-  textColumn('bizType', '业务类型', 140),
+  textColumn('bizType', '业务类型', 140, formatBusinessType),
   textColumn('collePayerName', '付款人名称', 160),
   textColumn('payeeName', '收款人名称', 160),
   {
@@ -254,6 +260,7 @@ const detailValues = computed(() => {
 
   return {
     ...task,
+    bizType: formatBusinessType(task.bizType),
     txnAmt: formatAmount(task.txnAmt),
     taskSts: formatStatus(task.taskSts),
     txnTm: formatDateTime(task.txnTm),

package/src/view/dcps/auth/typs.ts

@@ -20,7 +20,7 @@ export interface AuthorizationQueryParams extends AuthorizationFilters {
 export interface AuthorizationTask {
   id?: string // 任务 ID。
   platfSeqNo?: string // 平台流水号，用于定位审批任务。
-  bizType?: string // 业务类型。
+  bizType?: string // 业务类型：201 兑回、202 兑出、203 付现；未知代码保留原值。
   authoOrgName?: string // 授权机构名称。
   authoOrgNo?: string // 授权机构编号。
   collePayerName?: string // 付款人名称。

package/src/view/dcps/estimation/index.vue

@@ -116,8 +116,8 @@ const calcGapAmount = (inAmt: string, outAmt: string, emptyAsZero = false): stri
 const payDirecLabels: Record<string, string> = { I: '来账', O: '往账' }
 /** 支付渠道：预报与流水的数字人民币分别为 8、5；其余渠道保留原文。 */
 const payChannelLabels: Record<string, string> = { '5': '数字人民币', '8': '数字人民币' }
-/** 核销状态字典：1 未核销、2 已核销。 */
-const verifyStatusLabels: Record<string, string> = { '1': '未核销', '2': '已核销' }
+/** 与核销页面统一展示核销状态；部分核销记录仍可能出现在匡算明细中。 */
+const verifyStatusLabels: Record<string, string> = { '1': '未核销', '2': '已核销', '3': '部分核销' }
 /** 业务类型字典：201 兑回、202 兑出、203 付现；与核销预报使用同一套枚举。 */
 const busiTypeLabels: Record<string, string> = { '201': '兑回', '202': '兑出', '203': '付现' }
 

package/src/view/dcps/flow-query/api.ts

@@ -0,0 +1,12 @@
+import baseHttpClient from '@chic/http'
+import type { FlowQueryParams } from './typs'
+
+export default {
+  /**
+   * 分页查询数字人民币实时流水（140504002）。
+   * 接口业务 body 为空，不声明日期、姓名、金额或核销状态筛选。
+   * @param params 公共分页参数，由请求层放入 head 并转换为字符串。
+   */
+  queryFlowApi: (params: FlowQueryParams) =>
+    baseHttpClient.post<any>('/TAM/0001/140504002', params),
+}

package/src/view/dcps/flow-query/index.vue

@@ -0,0 +1,249 @@
+<script setup lang="ts">
+import { onBeforeUnmount, onMounted, reactive, ref } from 'vue'
+import { ElMessageBox } from 'element-plus'
+import API from './api'
+import { ArtDataTable, type ColumnOption, type PaginationOptions, type TableSettings } from '@/components/table'
+import type { FlowRow, Tam140504002OutBody } from './typs'
+
+defineOptions({ name: 'DcpsFlowQueryPage' })
+
+/** 列表查询结果：当前页记录、总记录数和可访问的最后一页。 */
+interface FlowPage {
+  data: FlowRow[]
+  total: number
+  lastPage: number
+}
+
+/** 校验 TAM 公共响应头，返回实时流水业务数据。 */
+const ensureSuccess = (response: any): Tam140504002OutBody | null => {
+  if (response?.head?.retCode !== '00000') {
+    throw new Error(response?.head?.retMsg?.trim() || '实时流水查询失败')
+  }
+  return response.body
+}
+
+/** 计数字段为 integer，明确拒绝字符串、小数、负数和超过安全精度的数字。 */
+const readCount = (value: unknown, label: string): number | undefined => {
+  if (value === undefined) return undefined
+  if (typeof value !== 'number' || !Number.isSafeInteger(value) || value < 0) {
+    throw new Error(`查询返回的${label}无效`)
+  }
+  return value
+}
+
+/** 按 txnLists 读取列表，分页数据不完整或相互矛盾时展示明确错误。 */
+const readPage = (body: Tam140504002OutBody | null, pageIndex: number, pageSize: number): FlowPage => {
+  if (!body || typeof body !== 'object') throw new Error('查询结果缺少实时流水数据')
+  if (body.txnLists !== undefined && !Array.isArray(body.txnLists)) {
+    throw new Error('查询返回的实时流水列表格式异常')
+  }
+  const data = body.txnLists ?? []
+  const declaredTotal = readCount(body.totalCount, '总记录数')
+  const declaredPages = readCount(body.totalPage, '总页数')
+  // 单页且未提供计数时可按实际条数展示，多页结果需要真实总数以保证分页准确。
+  if (declaredTotal === undefined && (pageIndex > 1 || (declaredPages !== undefined && declaredPages > 1))) {
+    throw new Error('查询结果缺少总记录数，无法读取分页数据')
+  }
+  const total = declaredTotal ?? data.length
+  const pages = Math.ceil(total / pageSize)
+  if (total < data.length || (body.txnLists === undefined && total > 0)) {
+    throw new Error('查询返回的实时流水列表与总记录数不一致')
+  }
+  // 无记录时允许服务端返回 0 或 1 页，页面均停留在第 1 页。
+  if (declaredPages !== undefined && declaredPages !== pages && !(total === 0 && declaredPages === 1)) {
+    throw new Error('查询返回的总页数与总记录数不一致')
+  }
+  return { data, total, lastPage: Math.max(1, pages) }
+}
+
+const getErrorMessage = (error: unknown): string => {
+  if (error instanceof Error && error.message.trim()) return error.message
+  if (typeof error === 'string' && error.trim()) return error
+  return '实时流水查询失败，请稍后重试'
+}
+
+/** 仅用字符串处理金额，不做浮点转换或舍入。 */
+const formatAmount = (value?: string): string => {
+  const original = value?.trim() || ''
+  if (!original) return '—'
+  let text = original
+  if (text.includes(',')) {
+    if (!/^[+-]?\d{1,3}(?:,\d{3})+(?:\.\d*)?$/.test(text)) return original
+    text = text.replace(/,/g, '')
+  }
+  const match = /^([+-]?)(\d*)(?:\.(\d*))?$/.exec(text)
+  if (!match || (!match[2] && !match[3])) return original
+  const integer = (match[2] || '0').replace(/^0+(?=\d)/, '')
+  const fraction = match[3] || ''
+  const negative = match[1] === '-' && /[1-9]/.test(integer + fraction)
+  return `${negative ? '-' : ''}${integer.replace(/\B(?=(\d{3})+(?!\d))/g, ',')}.${fraction.padEnd(2, '0')}`
+}
+
+const flowRows = ref<FlowRow[]>([])
+const flowPagination = reactive({ current: 1, size: 15, total: 0 })
+const flowPaginationOptions: PaginationOptions = { align: 'right', pageSizes: [15, 30, 50, 100], background: false }
+const flowTableSettings = ref<TableSettings>({ size: 'small', stripe: true, border: true, headerBackground: true })
+const flowLoading = ref(false)
+const flowQueryError = ref('')
+let disposed = false
+let flowRequestId = 0 // 仅最新请求可以写入列表；离开页面时使未完成请求失效。
+
+/** 所有代码字段保留接口原值，不套用核销接口的方向、业务类型或状态字典。 */
+const flowTextColumn = (prop: keyof FlowRow, label: string, width: number, visible = true): ColumnOption<FlowRow> => ({
+  prop, label, width, visible, showOverflowTooltip: true,
+  formatter: (row) => row[prop]?.trim() || '—',
+})
+
+// 覆盖实时流水的 16 个字段；钱包和机构编号默认在列设置中按需开启。
+const flowColumns: ColumnOption<FlowRow>[] = [
+  { type: 'globalIndex', label: '序号', width: 60, align: 'center' },
+  flowTextColumn('consumerSeqNo', '平台流水号', 200),
+  flowTextColumn('txnTmStamp', '交易时间', 190),
+  flowTextColumn('txnDirection', '收支方向', 100),
+  flowTextColumn('dbtrNm', '付款人名称', 170),
+  flowTextColumn('cdtrNm', '收款人名称', 170),
+  { prop: 'txnAmt', label: '交易金额', width: 170, align: 'right', useSlot: true, slotName: 'txnAmount' },
+  flowTextColumn('bizType', '业务类型', 100),
+  flowTextColumn('txnSts', '交易状态', 100),
+  flowTextColumn('payerFinOrgName', '付款机构名称', 170),
+  flowTextColumn('payeeFinOrgName', '收款机构名称', 170),
+  flowTextColumn('subBrchName', '落地支行名称', 170),
+  flowTextColumn('dbtrWltId', '付款钱包 ID', 190, false),
+  flowTextColumn('cdtrWltId', '收款钱包 ID', 190, false),
+  flowTextColumn('payerFinOrgNo', '付款机构编号', 170, false),
+  flowTextColumn('payeeFinOrgNo', '收款机构编号', 170, false),
+  flowTextColumn('subBrchBankNo', '落地支行行号', 170, false),
+]
+
+/** 公共 head 承载分页，140504002 的业务 body 不发送旧核销筛选条件。 */
+const loadFlowList = async () => {
+  if (disposed) return
+  const currentId = ++flowRequestId
+  const pageSize = flowPagination.size
+  let pageIndex = flowPagination.current
+  flowLoading.value = true
+  flowQueryError.value = ''
+  try {
+    for (let attempt = 0; attempt < 2; attempt += 1) {
+      const response = await API.queryFlowApi({ pageIndex, pageSize })
+      if (disposed || currentId !== flowRequestId) return
+      const page = readPage(ensureSuccess(response), pageIndex, pageSize)
+      if (pageIndex > page.lastPage) {
+        if (attempt === 0) {
+          pageIndex = page.lastPage
+          continue
+        }
+        throw new Error('实时流水列表已变化，请重新查询')
+      }
+      flowPagination.current = pageIndex
+      flowPagination.total = page.total
+      flowRows.value = page.data
+      return
+    }
+  } catch (error) {
+    if (disposed || currentId !== flowRequestId) return
+    flowRows.value = []
+    flowPagination.total = 0
+    flowQueryError.value = getErrorMessage(error)
+  } finally {
+    if (!disposed && currentId === flowRequestId) flowLoading.value = false
+  }
+}
+
+/** 查询从第一页开始；工具栏刷新和错误重试保留当前页。 */
+const searchFlow = () => {
+  if (disposed || flowLoading.value) return
+  flowPagination.current = 1
+  void loadFlowList()
+}
+
+const realtimeChecking = ref(false)
+
+/** 「实时查询流水」仅调用 140504002 确认实时链路；返回成功后弹窗提示，不改动表格与分页。 */
+const checkRealtimeFlow = async () => {
+  if (disposed || realtimeChecking.value) return
+  realtimeChecking.value = true
+  try {
+    const response = await API.queryFlowApi({ pageIndex: 1, pageSize: 1 })
+    if (disposed) return
+    if (response?.head?.retCode !== '00000') {
+      throw new Error(response?.head?.retMsg?.trim() || '实时查询流水失败')
+    }
+    ElMessageBox.alert('操作成功', '提示', { type: 'success', confirmButtonText: '确定' }).catch(() => {})
+  } catch (error) {
+    if (disposed) return
+    ElMessageBox.alert(getErrorMessage(error), '提示', { type: 'error', confirmButtonText: '确定' }).catch(() => {})
+  } finally {
+    if (!disposed) realtimeChecking.value = false
+  }
+}
+
+const changeFlowPage = (current: number, size = flowPagination.size) => {
+  if (disposed || (current === flowPagination.current && size === flowPagination.size)) return
+  if (!Number.isSafeInteger(current) || current < 1 || !Number.isSafeInteger(size) || size < 1) return
+  flowPagination.current = current
+  flowPagination.size = size
+  void loadFlowList()
+}
+
+onMounted(() => { void loadFlowList() })
+onBeforeUnmount(() => {
+  disposed = true
+  flowRequestId += 1
+})
+</script>
+
+<template>
+  <main class="dcps-page">
+    <el-alert v-if="flowQueryError" :title="flowQueryError" type="error" show-icon :closable="false">
+      <el-button link type="primary" :disabled="flowLoading" @click="void loadFlowList()">重新查询</el-button>
+    </el-alert>
+
+    <div class="table-region">
+      <ArtDataTable
+        v-model:settings="flowTableSettings"
+        class="flow-table"
+        fill
+        title="数字人民币实时流水"
+        toolbar-layout="refresh,size,fullscreen,columns,settings"
+        :data="flowRows"
+        :columns="flowColumns"
+        :loading="flowLoading"
+        :pagination="flowPagination"
+        :pagination-options="flowPaginationOptions"
+        row-key="consumerSeqNo"
+        :empty-text="flowQueryError ? '查询失败，请重新查询' : '暂无实时流水信息'"
+        @pagination:current-change="changeFlowPage"
+        @pagination:size-change="(size: number) => changeFlowPage(1, size)"
+        @refresh="void loadFlowList()"
+      >
+        <template #toolbar-left>
+          <el-button type="primary" :size="flowTableSettings.size" :loading="flowLoading" @click="searchFlow">查询</el-button>
+          <el-button type="primary" plain :size="flowTableSettings.size" :loading="realtimeChecking" @click="void checkRealtimeFlow()">实时查询流水</el-button>
+        </template>
+        <template #txnAmount="{ row }"><span class="amount-cell">{{ formatAmount(row.txnAmt) }}</span></template>
+      </ArtDataTable>
+    </div>
+  </main>
+</template>
+
+<style scoped>
+.dcps-page {
+  box-sizing: border-box;
+  display: flex;
+  width: 100%;
+  max-width: 100%;
+  flex-direction: column;
+  gap: 5px;
+  height: calc(100vh - var(--dpcs-host-layout-height));
+  height: calc(100dvh - var(--dpcs-host-layout-height));
+  min-height: 0;
+  min-width: 0;
+  padding: 5px;
+  overflow: hidden;
+  background: var(--el-bg-color-page, #f7f8fa);
+}
+.table-region { flex: 1; min-width: 0; min-height: 0; }
+.flow-table { padding: 10px; }
+.amount-cell { color: var(--el-text-color-primary); font-variant-numeric: tabular-nums; }
+</style>

package/src/view/dcps/flow-query/typs.ts

@@ -0,0 +1,38 @@
+/** 数字人民币实时流水查询（140504002）的业务 body 为空。 */
+export type Tam140504002InBody = Record<string, never>
+
+/** 平铺的公共分页参数；请求层将其放入 head，业务 body 保持为空。 */
+export interface FlowQueryParams {
+  pageIndex: number // 页码，从 1 开始。
+  pageSize: number // 每页条数。
+}
+
+/** Tam140504002Out.Body：计数字段遵循接口 integer 类型。 */
+export interface Tam140504002OutBody {
+  txnLists?: Tam140504002OutBodyTxnLists[] // 当前页的交易流水。
+  totalCount?: number // 总记录数。
+  totalPage?: number // 总页数。
+}
+
+/** 实时流水原始记录；金额、流水号、钱包 ID 和代码均保留字符串。 */
+export interface Tam140504002OutBodyTxnLists {
+  bizType?: string // 业务类型，接口未提供枚举。
+  cdtrNm?: string // 收款人名称。
+  cdtrWltId?: string // 收款钱包 ID。
+  consumerSeqNo?: string // 平台流水号。
+  dbtrNm?: string // 付款人名称。
+  dbtrWltId?: string // 付款钱包 ID。
+  payeeFinOrgName?: string // 收款机构名称。
+  payeeFinOrgNo?: string // 收款机构编号。
+  payerFinOrgName?: string // 付款机构名称。
+  payerFinOrgNo?: string // 付款机构编号。
+  subBrchBankNo?: string // 落地支行行号。
+  subBrchName?: string // 落地支行名称。
+  txnAmt?: string // 交易金额。
+  txnDirection?: string // 收支方向，接口未提供枚举。
+  txnSts?: string // 交易状态，接口未提供枚举。
+  txnTmStamp?: string // 交易时间，保留接口原始时间文本。
+}
+
+/** 独立实时流水页面的单行记录。 */
+export type FlowRow = Tam140504002OutBodyTxnLists

package/src/view/dcps/forecast/api.ts

@@ -12,7 +12,8 @@ export default {
   queryListApi: (params: unknown) => baseHttpClient.post<any>("/TAM/0001/140501001", params),
   /**
    * 新增一条数字人民币头寸预报。
-   * @param params 新增参数：tranDate 为交易日期，predDate 为预报日期，predAmt 为预报金额；
+   * @param params 新增参数：busiType 必填（201 兑回、202 兑出、203 付现）；
+   * tranDate 为交易日期，predDate 为预报日期，predAmt 为预报金额；
    * 其余为客户、机构、渠道、用途、备注等业务字段，未填写的字段可不传。
    */
   addApi: (params: unknown) => baseHttpClient.post<any>("/TAM/0001/120501001", params),

package/src/view/dcps/forecast/index.vue

@@ -40,7 +40,7 @@ defineOptions({ name: 'DcpsForecastPage' })
 
 /**
  * 预报页面：列表、新增/修改、详情共用一个入口文件。
- * 新增/修改/详情直接在当前页面以对话框打开，不跳转新页面。
+ * 新增、修改和详情在当前入口切换视图，返回列表后保留筛选和分页。
  */
 
 // ---------- 页面内工具函数 ----------
@@ -141,23 +141,24 @@ const createFormValues = (): ForecastFormValues => {
     billDate: '', billNo: '', busiType: '', clientName: '', clientType: '',
     competAcct: '', competName: '', custInfoSeq: '', groundBranch: '', groundBranchName: '',
     linkMan: '', payChannel: '', payDirec: '', phoneNo: '', predAmt: '', predDate: dcpsRuntime.date,
-    predName: '', predOrgName: '', purpose: '', remark: '', tranDate: dcpsRuntime.date,
+    predOrgName: '', purpose: '', remark: '', tranDate: dcpsRuntime.date,
   }
 }
 
 /**
- * 校验表单；新增校验全部必填项，修改只校验已填写的字段。
+ * 接口要求新增业务类型必填，同时保留现有预报业务所需的客户、机构、方向、日期与金额校验。
  * @param values 表单值。
  * @param mode create 为新增，edit 为修改。
  * @returns 错误提示文本，空字符串表示校验通过。
  */
 const validateForm = (values: ForecastFormValues, mode: 'create' | 'edit' = 'create'): string => {
-  const requiredFields = [
-    ['clientName', '客户名称'], ['payDirec', '收支方向'], ['busiType', '业务类型'],
+  const businessRequiredFields = [
+    ['clientName', '客户名称'], ['payDirec', '收支方向'],
     ['payChannel', '支付渠道'], ['groundBranch', '落地机构'],
   ] as const
   if (mode === 'create') {
-    for (const [key, label] of requiredFields) {
+    if (!values.busiType.trim()) return '请选择业务类型'
+    for (const [key, label] of businessRequiredFields) {
       if (!values[key].trim()) return `请填写${label}`
     }
   }
@@ -213,13 +214,15 @@ const listTextFilters = [
   ['clientName', '客户名称'],
   ['competName', '交易对手名称'],
   ['payDirec', '收支方向'],
-  ['busiType', '业务类型'],
   ['payChannel', '支付渠道'],
   ['groundBranch', '落地机构'],
   ['predStatus', '预报状态'],
   ['verifyStatus', '核销状态'],
   ['sortRule', '排序规则'],
 ] as const
+/** 新接口明确给出的业务类型；未登记代码保留接口原值。 */
+const busiTypeLabels: Record<string, string> = { '201': '兑回', '202': '兑出', '203': '付现' }
+const busiTypeOptions = Object.entries(busiTypeLabels).map(([value, label]) => ({ value, label }))
 const listRows = ref<ForecastRow[]>([])
 const listSelectedRows = ref<ForecastRow[]>([])
 const listPagination = reactive({ current: 1, size: 15, total: 0 })
@@ -233,12 +236,14 @@ const listBusy = computed(() => listMutation.value !== null)
 const listTableRef = ref<InstanceType<typeof ArtDataTable> | null>(null)
 let listRequestId = 0
 
-// ---------- 对话框状态 ----------
-const editorDialogVisible = ref(false) // 新增/修改对话框是否显示。
-const editorDialogMode = ref<'create' | 'edit'>('create') // 当前对话框形态。
+// ---------- 当前视图状态 ----------
+const editorDialogVisible = ref(false) // 新增/修改视图是否显示。
+const editorDialogMode = ref<'create' | 'edit'>('create') // 当前编辑模式。
 const editorDialogPredRefNo = ref('') // 修改模式的预报流水号。
-const detailDialogVisible = ref(false) // 详情对话框是否显示。
+const detailDialogVisible = ref(false) // 详情视图是否显示。
 const detailDialogPredRefNo = ref('') // 详情模式的预报流水号。
+const isEditor = computed(() => editorDialogVisible.value)
+const isDetail = computed(() => detailDialogVisible.value)
 
 const listHasReference = (row: ForecastRow) => Boolean(row.predRefNo?.trim())
 const listTextColumn = (prop: keyof ForecastRow, label: string, width: number, visible = true): ColumnOption<ForecastRow> => ({
@@ -252,7 +257,7 @@ const listColumns: ColumnOption<ForecastRow>[] = [
   { ...listTextColumn('tranDate', '交易日期', 110), formatter: (row) => formatDate(row.tranDate) },
   listTextColumn('clientName', '客户名称', 180),
   listTextColumn('payDirec', '收支方向', 95),
-  listTextColumn('busiType', '业务类型', 110),
+  { ...listTextColumn('busiType', '业务类型', 110), formatter: (row) => busiTypeLabels[row.busiType ?? ''] ?? row.busiType ?? '—' },
   listTextColumn('payChannel', '支付渠道', 110),
   { prop: 'predAmt', label: '预报金额（元）', width: 180, align: 'right', useSlot: true, slotName: 'amount' },
   { prop: 'verifyAmt', label: '已核销金额（元）', width: 180, align: 'right', useSlot: true, slotName: 'verifiedAmount' },
@@ -339,7 +344,7 @@ const changeListPage = (current: number, size = listPagination.size) => {
   void loadList()
 }
 
-// 行内操作交给对话框处理，整行记录用于补齐详情接口没有返回的字段。
+// 行内操作切换当前视图，整行记录用于补齐详情接口没有返回的字段。
 const openEdit = (row: ForecastRow) => {
   if (listBusy.value || !listHasReference(row)) return
   const predRefNo = row.predRefNo?.trim()
@@ -351,7 +356,7 @@ const openEdit = (row: ForecastRow) => {
 }
 const openDetail = (row: ForecastRow) => {
   if (listBusy.value || !listHasReference(row)) return
-  const predRefNo = row.prefRefNo ?? row.predRefNo?.trim()
+  const predRefNo = row.predRefNo?.trim()
   if (!predRefNo) return
   rememberForecastRow(row)
   detailDialogPredRefNo.value = predRefNo
@@ -397,7 +402,7 @@ type FieldKey = Exclude<keyof ForecastFormValues, 'custRefSeq'>
 type EditorField = {
   key: FieldKey
   label: string
-  kind?: 'date' | 'amount' | 'textarea'
+  kind?: 'date' | 'amount' | 'textarea' | 'businessType'
   placeholder?: string
   createOnly?: boolean
 }
@@ -420,7 +425,7 @@ const fieldGroups: { title: string; fields: EditorField[] }[] = [
       { key: 'predDate', label: '预报日期', kind: 'date' },
       { key: 'predAmt', label: '预报金额（元）', kind: 'amount', placeholder: '请输入金额，最多两位小数' },
       { key: 'payDirec', label: '收支方向代码', placeholder: '请输入收支方向代码' },
-      { key: 'busiType', label: '业务类型代码', placeholder: '请输入业务类型代码' },
+      { key: 'busiType', label: '业务类型', kind: 'businessType' },
       { key: 'payChannel', label: '支付渠道代码', placeholder: '请输入支付渠道代码' },
       { key: 'clientName', label: '客户名称' },
       { key: 'clientType', label: '客户类型代码', placeholder: '请输入客户类型代码' },
@@ -441,7 +446,6 @@ const fieldGroups: { title: string; fields: EditorField[] }[] = [
   {
     title: '其他信息',
     fields: [
-      { key: 'predName', label: '预报人员姓名', createOnly: true },
       { key: 'predOrgName', label: '预报机构名称', createOnly: true },
       { key: 'billNo', label: '票号' },
       { key: 'billDate', label: '出票日期', kind: 'date' },
@@ -454,6 +458,7 @@ const fieldGroups: { title: string; fields: EditorField[] }[] = [
 const form = reactive<ForecastFormValues>(createFormValues())
 const formError = ref('')
 const editorLoading = ref(false) // 读取修改前的原始数据。
+let editorRequestId = 0 // 切换记录或关闭视图后，旧详情请求不再回填表单。
 const submitting = ref(false) // 提交新增或修改。
 const loadError = ref('')
 const initialValues = ref<Partial<ForecastFormValues>>({})
@@ -511,33 +516,55 @@ const buildInitialValues = (detail: ForecastDetail): Partial<ForecastFormValues>
   return initial
 }
 
-// 修改模式先读取原始数据，再回填表单；读取失败时停留在页面提示原因。
+// 修改模式先读取原始数据；仅当前视图、当前记录的最新请求可以回填。
 const loadEditorDetail = async () => {
-  if (editorMode.value !== 'edit') return
-  if (!editorPredRefNo.value) {
+  if (!editorDialogVisible.value || editorMode.value !== 'edit') return
+  const currentId = ++editorRequestId
+  const predRefNo = editorPredRefNo.value
+  const isCurrentRequest = () => !disposed
+    && currentId === editorRequestId
+    && editorDialogVisible.value
+    && editorMode.value === 'edit'
+    && editorPredRefNo.value === predRefNo
+  if (!predRefNo) {
+    editorLoading.value = false
     loadError.value = '预报流水号缺失，无法修改'
     return
   }
   editorLoading.value = true
   loadError.value = ''
   try {
-    const cachedRow = recallForecastRow(editorPredRefNo.value)
-    const detailRow: ForecastRow = { ...cachedRow, predRefNo: editorPredRefNo.value }
-    initialValues.value = buildInitialValues(await fetchDetail(detailRow))
-    if (disposed) return
+    const cachedRow = recallForecastRow(predRefNo)
+    const detailRow: ForecastRow = { ...cachedRow, predRefNo }
+    const nextValues = buildInitialValues(await fetchDetail(detailRow))
+    if (!isCurrentRequest()) return
+    initialValues.value = nextValues
     initializeForm()
   } catch (error) {
-    if (!disposed) loadError.value = getErrorMessage(error)
+    if (isCurrentRequest()) loadError.value = getErrorMessage(error)
   } finally {
-    if (!disposed) editorLoading.value = false
+    if (isCurrentRequest()) editorLoading.value = false
   }
 }
 
-// 新增或修改每次打开对话框时重新初始化。
+// 切换状态时同步使旧请求失效；新增表单不受此前修改详情请求影响。
+watch([editorDialogVisible, editorDialogPredRefNo, editorDialogMode], ([visible]) => {
+  editorRequestId += 1
+  editorLoading.value = false
+  if (!visible) return
+  initialValues.value = {}
+  loadError.value = ''
+  initializeForm()
+  if (editorMode.value === 'edit') void loadEditorDetail()
+}, { flush: 'sync' })
 
 watch(form, () => { formError.value = '' }, { deep: true })
 
-const backToList = () => void router.replace({ name: 'forecast' })
+const backToList = () => {
+  editorDialogVisible.value = false
+  detailDialogVisible.value = false
+  void loadList()
+}
 
 // 日期控件清空时可能产生 null，提交前统一回到协议要求的字符串。
 const submit = async () => {
@@ -555,7 +582,7 @@ const submit = async () => {
   submitting.value = true
   try {
     if (editorMode.value === 'create') {
-      const body: ForecastCreateBody = {}
+      const body: ForecastCreateBody = { busiType: values.busiType }
       for (const [key, value] of Object.entries(values)) {
         if (key !== 'custRefSeq' && value?.trim()) Object.assign(body, { [key]: value.trim() })
       }
@@ -577,7 +604,7 @@ const submit = async () => {
     }
     if (disposed) return
     ElMessage.success(editorMode.value === 'create' ? '新增请求已处理' : '修改请求已处理')
-    await router.replace({ name: 'forecast' })
+    backToList()
   } catch (error) {
     if (!disposed) ElMessage.error(getErrorMessage(error))
   } finally {
@@ -641,7 +668,8 @@ const openEditFromDetail = () => {
   if (!predRefNo) return
   const row = recallForecastRow(predRefNo)
   if (row) rememberForecastRow(row)
-  void router.push({ name: 'forecast-edit', params: { predRefNo } })
+  detailDialogVisible.value = false
+  openEdit({ ...row, predRefNo })
 }
 
 const displayValue = (field: DetailField) => {
@@ -649,6 +677,7 @@ const displayValue = (field: DetailField) => {
   if (value === undefined || value === null || value === '') return '—'
   if (field.kind === 'amount') return formatAmount(value)
   if (field.kind === 'date') return formatDate(value)
+  if (field.key === 'busiType') return busiTypeLabels[value] ?? value
   return String(value)
 }
 
@@ -667,9 +696,9 @@ const loadDetail = async () => {
   }
 }
 
-// 详情页每次进入都按预报流水号读取最新数据（页面实例由 KeepAlive 缓存）。
-onActivated(() => {
-  if (isDetail.value) void loadDetail()
+// 每次进入详情视图都按预报流水号读取最新数据。
+watch([detailDialogVisible, detailDialogPredRefNo], ([visible]) => {
+  if (visible) void loadDetail()
 })
 </script>
 
@@ -696,7 +725,7 @@ onActivated(() => {
             <el-button link type="primary" :disabled="editorDisabled" @click="backToList">返回列表</el-button>
           </el-alert>
           <template v-else>
-            <p class="editor-note">金额单位为元，方向、业务类型、支付渠道和客户类型按业务代码填写。</p>
+            <p class="editor-note">金额单位为元；业务类型按接口提供的选项选择，其他未提供字典的字段按业务代码填写。</p>
             <el-form :model="form" label-position="top" :disabled="editorDisabled" @submit.prevent="submit">
               <section v-for="group in visibleGroups" :key="group.title" class="editor-group" :aria-label="group.title">
                 <h3>{{ group.title }}</h3>
@@ -722,6 +751,14 @@ onActivated(() => {
                       :editable="false"
                       clearable
                     />
+                    <el-select
+                      v-else-if="field.kind === 'businessType'"
+                      v-model="form.busiType"
+                      placeholder="请选择业务类型"
+                      clearable
+                    >
+                      <el-option v-for="option in busiTypeOptions" :key="option.value" :label="option.label" :value="option.value" />
+                    </el-select>
                     <el-input
                       v-else-if="field.kind === 'textarea'"
                       v-model="form[field.key]"
@@ -804,6 +841,11 @@ onActivated(() => {
         <el-form-item class="filter-date" label="交易日期" required>
           <el-date-picker v-model="listFilters.tranDate" type="date" format="YYYY-MM-DD" value-format="YYYYMMDD" :clearable="false" :editable="false" />
         </el-form-item>
+        <el-form-item label="业务类型">
+          <el-select v-model="listFilters.busiType" clearable placeholder="不限">
+            <el-option v-for="option in busiTypeOptions" :key="option.value" :label="option.label" :value="option.value" />
+          </el-select>
+        </el-form-item>
         <!-- label 为查询字段名称，输入框较窄，占位文案统一为简短提示。 -->
         <el-form-item v-for="[key, label] in listTextFilters" :key="key" :label="label">
           <el-input v-model="listFilters[key]" placeholder="请输入" :maxlength="200" clearable />
@@ -909,7 +951,7 @@ onActivated(() => {
 .filter-form :deep(.filter-date) { flex: 1.5 0 116px; }
 .filter-form :deep(.filter-amount) { flex: 1.2 0 92px; }
 .filter-form :deep(.el-form-item__label) { height: auto; margin-bottom: 4px; padding: 0; font-size: 12px; line-height: 16px; }
-.filter-form :deep(.el-date-editor) { width: 100%; min-width: 0; }
+.filter-form :deep(.el-date-editor), .filter-form :deep(.el-select) { width: 100%; min-width: 0; }
 .filter-actions { flex: 0 0 auto; }
 .forecast-table-region { flex: 1; min-width: 0; min-height: 0; }
 .forecast-table { padding: 10px; }
@@ -954,7 +996,7 @@ onActivated(() => {
 .editor-fields { display: grid; grid-template-columns: repeat(4, minmax(0, 1fr)); column-gap: 18px; }
 .editor-fields :deep(.el-form-item) { min-width: 0; margin-bottom: 14px; }
 .editor-fields :deep(.el-form-item__label) { display: flex; align-items: center; gap: 6px; margin-bottom: 5px; padding: 0; line-height: 20px; }
-.editor-fields :deep(.el-date-editor.el-input) { width: 100%; }
+.editor-fields :deep(.el-date-editor.el-input), .editor-fields :deep(.el-select) { width: 100%; }
 .editor-field--wide { grid-column: 1 / -1; }
 .field-unavailable { color: var(--el-text-color-secondary); font-size: 11px; font-weight: 400; }
 .editor-footer { display: flex; align-items: center; justify-content: space-between; flex-wrap: wrap; gap: 8px 12px; padding-top: 10px; border-top: 1px solid var(--el-border-color-lighter); }

package/src/view/dcps/forecast/typs.ts

@@ -9,8 +9,8 @@ export interface Tam120501001InBody {
   billDate?: string
   /** 票号 */
   billNo?: string
-  /** 业务类型 */
-  busiType?: string
+  /** 业务类型：201 兑回、202 兑出、203 付现（新增必填）。 */
+  busiType: string
   /** 客户名称 */
   clientName?: string
   /** 客户类型 */
@@ -37,8 +37,6 @@ export interface Tam120501001InBody {
   predAmt?: string
   /** 预报日期 */
   predDate?: string
-  /** 预报人员姓名 */
-  predName?: string
   /** 预报机构名称 */
   predOrgName?: string
   /** 用途 */

package/src/view/dcps/funding/injection/api.ts

@@ -1,11 +1,13 @@
 import baseHttpClient from "@chic/http"
+import type { InjectionQueryParams } from './typs'
 
 export default {
   /**
    * 头寸-数字人民币注资明细查询。
    * @param params 查询参数：capAdjustType 为调整类型，txnProceSts 为交易处理状态；
+   * txnDtStart、txnDtEnd 为交易日期起止范围，格式为 YYYYMMDD，可分别填写。
    * 空值字段不发送，表示不限制该条件。
    * 接口未声明分页请求参数，列表在页面内按返回结果本地分页。
    */
-  queryListApi: (params: unknown) => baseHttpClient.post<any>("/TAM/0001/140504001", params)
+  queryListApi: (params: InjectionQueryParams) => baseHttpClient.post<any>("/TAM/0001/140504001", params)
 }

package/src/view/dcps/funding/injection/index.vue

@@ -14,6 +14,8 @@ type AmountSortOrder = 'ascending' | 'descending' | null
 const defaultFilters: InjectionFilters = {
   capAdjustType: '', // 调整类型。
   txnProceSts: '', // 交易处理状态。
+  txnDtStart: '', // 交易开始日期，不填时不限制。
+  txnDtEnd: '', // 交易结束日期，不填时不限制。
 }
 
 // 重复输入项共用一份配置，依次为字段、名称和长度限制。
@@ -241,13 +243,25 @@ const detailValues = computed(() => {
   }
 })
 
+// 校验 YYYYMMDD 日期，避免只检查位数后放过不存在的日期。
+const isValidDate = (value: string): boolean => {
+  if (!/^\d{8}$/.test(value)) return false
+  const year = Number(value.slice(0, 4))
+  const month = Number(value.slice(4, 6))
+  const day = Number(value.slice(6, 8))
+  if (year < 1 || month < 1 || month > 12 || day < 1) return false
+  const leap = year % 400 === 0 || (year % 4 === 0 && year % 100 !== 0)
+  const monthDays = [31, leap ? 29 : 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31]
+  return day <= (monthDays[month - 1] || 0)
+}
+
 // 读取表单并组装请求参数；空值字段不发送，表示不限制该条件。
 const getQueryParams = (): InjectionQueryParams => {
-  const params: InjectionQueryParams = { ...defaultFilters }
-  const capAdjustType = filters.value.capAdjustType.trim() // 去除首尾空白后的调整类型。
-  const txnProceSts = filters.value.txnProceSts.trim() // 去除首尾空白后的交易处理状态。
-  if (capAdjustType) params.capAdjustType = capAdjustType
-  if (txnProceSts) params.txnProceSts = txnProceSts
+  const params: InjectionQueryParams = {}
+  for (const key of Object.keys(defaultFilters) as (keyof InjectionFilters)[]) {
+    const value = filters.value[key]?.trim()
+    if (value) params[key] = value
+  }
   return params
 }
 // 仅查询、重置时更新；翻页和刷新沿用这份条件。
@@ -261,7 +275,7 @@ const loadList = async () => {
   try {
     // head 为公共响应头，body 为包含明细列表的业务数据；
     // body 内的 totalCount、totalPage 供服务端分页时使用，当前接按返回的完整列表本地分页。
-    const { head, body } = await API.queryListApi(appliedQuery) as any
+    const { head, body } = await API.queryListApi(appliedQuery)
     if (currentRequestId !== requestId) return
     if (head?.retCode !== '00000') {
       throw new Error(head?.retMsg || '查询失败')
@@ -285,7 +299,13 @@ const loadList = async () => {
 
 // 新查询从第一页开始；重置后复用同一查询流程。
 const search = () => {
-  appliedQuery = getQueryParams()
+  const query = getQueryParams()
+  if (query.txnDtStart && !isValidDate(query.txnDtStart)) return void ElMessage.warning('请选择有效的交易开始日期')
+  if (query.txnDtEnd && !isValidDate(query.txnDtEnd)) return void ElMessage.warning('请选择有效的交易结束日期')
+  if (query.txnDtStart && query.txnDtEnd && query.txnDtStart > query.txnDtEnd) {
+    return void ElMessage.warning('交易开始日期不能晚于结束日期')
+  }
+  appliedQuery = query
   pagination.current = 1
   void loadList()
 }
@@ -323,6 +343,12 @@ onBeforeUnmount(() => {
     <!-- 查询条件：控件尺寸跟随表格设置，卡片内边距为 10px，点击查询生效。 -->
     <el-card v-show="showSearchBar" class="injection-search" shadow="never" :body-style="{ padding: '10px' }">
       <el-form class="filter-form" :model="filters" :size="tableSettings.size" label-position="top" @submit.prevent="search()">
+        <el-form-item class="filter-date" label="交易开始日期">
+          <el-date-picker v-model="filters.txnDtStart" type="date" format="YYYY-MM-DD" value-format="YYYYMMDD" placeholder="不限" :editable="false" clearable />
+        </el-form-item>
+        <el-form-item class="filter-date" label="交易结束日期">
+          <el-date-picker v-model="filters.txnDtEnd" type="date" format="YYYY-MM-DD" value-format="YYYYMMDD" placeholder="不限" :editable="false" clearable />
+        </el-form-item>
         <!-- prop 为查询字段，label 为字段名称，maxlength 为允许输入的最大字符数。 -->
         <el-form-item
           v-for="[prop, label, maxlength] in filterFields"
@@ -448,7 +474,9 @@ onBeforeUnmount(() => {
 .filter-form { display: flex; flex-wrap: wrap; align-items: flex-end; gap: 10px 12px; }
 /* 筛选项较窄时换行，宽屏时封顶 280px，输入框不至于无限拉长。 */
 .filter-form :deep(.el-form-item) { flex: 1 0 105px; max-width: 280px; min-width: 0; margin: 0; }
+.filter-form :deep(.filter-date) { flex-basis: 160px; }
 .filter-form :deep(.el-form-item__label) { margin-bottom: 4px; }
+.filter-form :deep(.el-date-editor) { width: 100%; min-width: 0; }
 .filter-actions { flex-shrink: 0; margin-left: auto; }
 .amount-cell { color: var(--el-color-primary-dark-2); font-variant-numeric: tabular-nums; font-weight: 600; }
 

package/src/view/dcps/funding/injection/typs.ts

@@ -2,11 +2,12 @@
 export interface InjectionFilters {
   capAdjustType: string // 调整类型。
   txnProceSts: string // 交易处理状态。
+  txnDtStart: string // 交易开始日期，格式为 YYYYMMDD。
+  txnDtEnd: string // 交易结束日期，格式为 YYYYMMDD。
 }
 
 /** 列表查询参数；空字段在提交前剔除，表示不限制。 */
-export interface InjectionQueryParams extends InjectionFilters {
-}
+export type InjectionQueryParams = Partial<InjectionFilters>
 
 /** 接口返回的数字人民币注资明细字段。 */
 export interface InjectionRecord {

package/src/view/dcps/write-off/api.ts

@@ -23,14 +23,15 @@ export default {
    * 分页查询核销预报信息。
    * @param params 查询参数：tranDate 为交易日期（必填，YYYYMMDD）；pageIndex、pageSize 为页码和每页条数。
    * 业务筛选：acctNo 为我方账号，banchPre 为机构关键字，busiType 为业务类型，
-   * clientName 为客户名称，competName 为交易对手名称，payDirec 为收支方向，
-   * startTransAmt、endTransAmt 为金额范围，verifyStatusList 为核销状态列表。
+   * clientName 为客户名称，competName 为交易对手名称，payDirec 为收支方向（1 收入、2 支出），
+   * startTransAmt、endTransAmt 为金额范围，verifyStatusList 待核销传 [1,3]、已核销传 [2]。
    */
   queryForecastApi: (params: unknown) => baseHttpClient.post<any>("/TAM/0001/140502001", params),
   /**
    * 分页查询核销流水信息。
    * @param params 查询参数：tranDate 为交易日期（必填，YYYYMMDD）；pageIndex、pageSize 为页码和每页条数。
-   * 业务筛选：orgName 为我方机构，payerName、payeeName 为付款人和收款人名称，
+   * 业务筛选：busiType 为业务类型（201 兑回、202 兑出、203 付现），orgName 为我方机构，
+   * payerName、payeeName 为付款人和收款人名称，
    * payDirec 为收支方向，startTransAmt、endTransAmt 为金额范围，verifyStatus 为核销状态。
    */
   queryFlowApi: (params: unknown) => baseHttpClient.post<any>("/TAM/0001/140502002", params)

package/src/view/dcps/write-off/index.vue

@@ -123,12 +123,14 @@ const compareAmounts = (left: string, right: string): number => {
 
 /** 业务类型字典：201 兑回、202 兑出、203 付现；超出字典的值保留原文。 */
 const busiTypeLabels: Record<string, string> = { '201': '兑回', '202': '兑出', '203': '付现' }
-/** 收支方向字典：I 来账、O 往账。 */
-const payDirecLabels: Record<string, string> = { I: '来账', O: '往账' }
+/** 核销预报使用 1 收入、2 支出；流水接口仍使用 I 来账、O 往账。 */
+const forecastPayDirecLabels: Record<string, string> = { '1': '收入', '2': '支出' }
+const flowPayDirecLabels: Record<string, string> = { I: '来账', O: '往账' }
 /** 支付渠道：核销预报为 8、流水为 5，均表示数字人民币；其余渠道保留原文。 */
 const payChannelLabels: Record<string, string> = { '5': '数字人民币', '8': '数字人民币' }
-/** 核销状态字典：1 未核销、2 已核销。 */
-const verifyStatusLabels: Record<string, string> = { '1': '未核销', '2': '已核销' }
+/** 响应核销状态字典；流水筛选仍按请求协议仅提供 1、2。 */
+const verifyStatusLabels: Record<string, string> = { '1': '未核销', '2': '已核销', '3': '部分核销' }
+const tranStatusLabels: Record<string, string> = { S: '成功', P: '处理中', F: '失败' }
 
 /** 读取字典文案；空值显示横线，未登记的代码保留原文展示。 */
 const dictLabel = (labels: Record<string, string>, value?: string): string => {
@@ -171,6 +173,9 @@ const openWriteOff = () => {
   if (busy.value) return
   const predRows = predSelection.value.filter((row) => row.predRefNo?.trim())
   if (!predRows.length) return void ElMessage.warning('请先勾选带预报流水号的预报记录')
+  const selected = [...predRows, ...flowSelection.value]
+  if (selected.some(row => row.verifyStatus === '3')) return void ElMessage.warning('部分核销记录暂不支持继续核销')
+  if (selected.some(row => row.verifyStatus !== '1')) return void ElMessage.warning('请仅勾选未核销记录')
   writeOffPredItems.value = predRows.map((row, index) => ({
     // 预报流水号可能重复，追加下标保证弹窗表格的渲染键唯一。
     key: `${row.predRefNo?.trim()}-${index}`,
@@ -239,6 +244,9 @@ const cancelWriteOff = async () => {
   const predRows = predSelection.value.filter((row) => row.predRefNo?.trim())
   const flowRows = flowSelection.value.filter(hasRefNo)
   if (!predRows.length && !flowRows.length) return void ElMessage.warning('请先勾选要撤销核销的预报或流水')
+  const selected = [...predRows, ...flowRows]
+  if (selected.some(row => row.verifyStatus === '3')) return void ElMessage.warning('部分核销记录暂不支持撤销核销')
+  if (selected.some(row => row.verifyStatus !== '2')) return void ElMessage.warning('请仅勾选已核销记录')
   const summaryParts: string[] = []
   if (predRows.length) summaryParts.push(`预报 ${predRows.length} 条`)
   if (flowRows.length) summaryParts.push(`流水 ${flowRows.length} 条`)
@@ -300,7 +308,7 @@ type ForecastAppliedQuery = {
   busiType?: string // 业务类型：201 兑回、202 兑出、203 付现。
   clientName?: string // 客户名称。
   competName?: string // 交易对手名称。
-  payDirec?: string // 收支方向：I 来账、O 往账。
+  payDirec?: string // 收支方向：1 收入、2 支出。
   startTransAmt?: string // 起始金额。
   endTransAmt?: string // 截止金额。
   verifyStatusList?: string[] // 核销状态列表。
@@ -317,7 +325,7 @@ const createForecastFilters = () => ({
   payDirec: '',
   startTransAmt: '',
   endTransAmt: '',
-  verifyStatusList: [] as string[],
+  verifyStatusGroup: '', // 待核销包含未核销和部分核销两种状态。
 })
 const forecastFilters = ref(createForecastFilters())
 let forecastAppliedQuery: ForecastAppliedQuery = { tranDate: dcpsRuntime.date }
@@ -331,8 +339,10 @@ const forecastTextFilters = [
 ] as const
 // 已在接口附件声明的枚举，直接生成下拉选项；缺省字典的状态不猜测。
 const busiTypeOptions = Object.entries(busiTypeLabels).map(([value, label]) => ({ value, label }))
-const payDirecOptions = Object.entries(payDirecLabels).map(([value, label]) => ({ value, label }))
-const verifyStatusOptions = Object.entries(verifyStatusLabels).map(([value, label]) => ({ value, label }))
+const forecastPayDirecOptions = Object.entries(forecastPayDirecLabels).map(([value, label]) => ({ value, label }))
+const flowPayDirecOptions = Object.entries(flowPayDirecLabels).map(([value, label]) => ({ value, label }))
+const flowVerifyStatusOptions = ['1', '2'].map(value => ({ value, label: verifyStatusLabels[value] }))
+const forecastVerifyStatusOptions = [{ value: 'pending', label: '待核销' }, { value: 'verified', label: '已核销' }]
 
 // 列表、分页与请求状态；请求序号防止旧响应覆盖新结果。
 const forecastRows = ref<ForecastRow[]>([])
@@ -372,7 +382,8 @@ const forecastColumns: ColumnOption<ForecastRow>[] = [
   forecastDictColumn('busiType', '业务类型', 95, busiTypeLabels),
   forecastTextColumn('clientName', '客户名称', 170),
   forecastTextColumn('competName', '交易对手名称', 170),
-  forecastDictColumn('payDirec', '收支方向', 90, payDirecLabels),
+  forecastTextColumn('competAcct', '交易对手账号', 190),
+  forecastDictColumn('payDirec', '收支方向', 90, forecastPayDirecLabels),
   forecastDictColumn('payChannel', '支付渠道', 110, payChannelLabels),
   { prop: 'predAmt', label: '预报金额（元）', width: 160, align: 'right', useSlot: true, slotName: 'predAmount' },
   { prop: 'verifyAmt', label: '已核销金额（元）', width: 160, align: 'right', useSlot: true, slotName: 'verifyAmount' },
@@ -445,7 +456,8 @@ const searchForecast = () => {
   if (source.payDirec.trim()) query.payDirec = source.payDirec.trim()
   if (startTransAmt) query.startTransAmt = startTransAmt
   if (endTransAmt) query.endTransAmt = endTransAmt
-  if (source.verifyStatusList.length) query.verifyStatusList = [...source.verifyStatusList]
+  if (source.verifyStatusGroup === 'pending') query.verifyStatusList = ['1', '3']
+  if (source.verifyStatusGroup === 'verified') query.verifyStatusList = ['2']
   forecastAppliedQuery = query
   forecastPagination.current = 1
   void loadForecastList()
@@ -468,6 +480,8 @@ const changeForecastPage = (current: number, size = forecastPagination.size) =>
  */
 const openEdit = (row: ForecastRow) => {
   if (busy.value || !forecastHasReference(row)) return
+  if (row.verifyStatus === '3') return void ElMessage.warning('部分核销记录暂不支持修改核销金额')
+  if (row.verifyStatus !== '1') return void ElMessage.warning('请先撤销核销后再修改核销金额')
   editForm.value = {
     predRefNo: row.predRefNo?.trim() || '',
     predAmt: row.predAmt?.trim() || '',
@@ -507,6 +521,7 @@ const submitEdit = async () => {
 type FlowAppliedQuery = {
   tranDate: string // 必填交易日期，格式为 YYYYMMDD。
   orgName?: string // 我方机构。
+  busiType?: string // 业务类型：201 兑回、202 兑出、203 付现。
   payerName?: string // 付款人名称。
   payeeName?: string // 收款人名称。
   payDirec?: string // 收支方向：I 来账、O 往账。
@@ -519,6 +534,7 @@ type FlowAppliedQuery = {
 const createFlowFilters = () => ({
   tranDate: dcpsRuntime.date,
   orgName: '',
+  busiType: '',
   payerName: '',
   payeeName: '',
   payDirec: '',
@@ -571,13 +587,13 @@ const flowColumns: ColumnOption<FlowRow>[] = [
   flowDictColumn('busiType', '业务类型', 95, busiTypeLabels),
   flowTextColumn('payerName', '付款人名称', 170),
   flowTextColumn('payeeName', '收款人名称', 170),
-  flowDictColumn('payDirec', '收支方向', 90, payDirecLabels),
+  flowDictColumn('payDirec', '收支方向', 90, flowPayDirecLabels),
   { prop: 'tranAmt', label: '交易金额（元）', width: 160, align: 'right', useSlot: true, slotName: 'tranAmount' },
   flowDictColumn('verifyStatus', '核销状态', 95, verifyStatusLabels),
   flowTextColumn('branchName', '我方机构', 150),
   flowTextColumn('collBankName', '收款行名称', 160),
   flowTextColumn('payBankName', '付款行名称', 160),
-  flowTextColumn('busiStatus', '业务状态', 110),
+  flowDictColumn('tranStatus', '交易状态', 110, tranStatusLabels),
   flowTextColumn('remark', '备注', 160),
   flowTextColumn('branchCode', '机构行号', 150, false),
   flowTextColumn('collBankNo', '收款行行号', 170, false),
@@ -643,6 +659,7 @@ const searchFlow = () => {
     const value = source[key].trim()
     if (value) query[key] = value
   }
+  if (source.busiType.trim()) query.busiType = source.busiType.trim()
   if (source.payDirec.trim()) query.payDirec = source.payDirec.trim()
   if (source.verifyStatus.trim()) query.verifyStatus = source.verifyStatus.trim()
   if (startTransAmt) query.startTransAmt = startTransAmt
@@ -662,6 +679,11 @@ const changeFlowPage = (current: number, size = flowPagination.size) => {
   void loadFlowList()
 }
 
+/** 未定义部分核销的继续处理契约，操作仅允许原协议的未核销/已核销记录。 */
+const canWriteOff = computed(() => predSelection.value.length > 0 && [...predSelection.value, ...flowSelection.value].every(row => row.verifyStatus === '1'))
+const canCancelWriteOff = computed(() => (predSelection.value.length + flowSelection.value.length) > 0 && [...predSelection.value, ...flowSelection.value].every(row => row.verifyStatus === '2'))
+const hasPartialRows = computed(() => [...forecastRows.value, ...flowRows.value].some(row => row.verifyStatus === '3'))
+
 /** 核销、撤销核销成功后统一刷新两个列表；勾选在各自的刷新流程中清空。 */
 const refreshBoth = async () => {
   await Promise.all([loadForecastList(), loadFlowList()])
@@ -683,6 +705,7 @@ onBeforeUnmount(() => {
 <template>
   <ElConfigProvider :size="forecastTableSettings.size">
   <main class="dcps-page">
+    <el-alert v-if="hasPartialRows" title="部分核销记录可查询，暂不支持继续核销、修改或撤销操作。" type="info" :closable="false" show-icon />
     <!-- 上方：预报信息表格，核销、撤销核销按钮统一放在本表格工具栏。 -->
     <section class="view-region">
       <!-- 查询条件：控件尺寸跟随表格设置，卡片内边距为 10px，点击查询生效。 -->
@@ -692,8 +715,8 @@ onBeforeUnmount(() => {
             <el-date-picker v-model="forecastFilters.tranDate" type="date" format="YYYY-MM-DD" value-format="YYYYMMDD" :clearable="false" :editable="false" />
           </el-form-item>
           <el-form-item class="filter-status" label="核销状态">
-            <el-select v-model="forecastFilters.verifyStatusList" multiple collapse-tags collapse-tags-tooltip clearable placeholder="不限">
-              <el-option v-for="option in verifyStatusOptions" :key="option.value" :label="option.label" :value="option.value" />
+            <el-select v-model="forecastFilters.verifyStatusGroup" clearable placeholder="不限">
+              <el-option v-for="option in forecastVerifyStatusOptions" :key="option.value" :label="option.label" :value="option.value" />
             </el-select>
           </el-form-item>
           <el-form-item class="filter-status" label="业务类型">
@@ -703,7 +726,7 @@ onBeforeUnmount(() => {
           </el-form-item>
           <el-form-item class="filter-status" label="收支方向">
             <el-select v-model="forecastFilters.payDirec" clearable placeholder="不限">
-              <el-option v-for="option in payDirecOptions" :key="option.value" :label="option.label" :value="option.value" />
+              <el-option v-for="option in forecastPayDirecOptions" :key="option.value" :label="option.label" :value="option.value" />
             </el-select>
           </el-form-item>
           <!-- prop 为查询字段，label 为字段名称，maxlength 为允许输入的最大字符数。 -->
@@ -754,13 +777,15 @@ onBeforeUnmount(() => {
               <!-- 核销必选预报，单独勾选流水时按钮保持禁用；按钮文案带上两个表格的勾选总数。 -->
               <el-button
                 type="primary"
-                :disabled="busy || !predSelection.length"
+                :disabled="busy || !canWriteOff"
+                title="仅支持未核销记录"
                 @click="openWriteOff"
               >核销（{{ predSelection.length + flowSelection.length }}）</el-button>
               <el-button
                 type="warning"
                 plain
-                :disabled="busy || !(predSelection.length || flowSelection.length)"
+                :disabled="busy || !canCancelWriteOff"
+                title="仅支持已核销记录"
                 @click="cancelWriteOff"
               >撤销核销（{{ predSelection.length + flowSelection.length }}）</el-button>
             </div>
@@ -770,7 +795,7 @@ onBeforeUnmount(() => {
           <template #verifyAmount="{ row }"><span class="amount-cell">{{ formatAmount(row.verifyAmt) }}</span></template>
           <template #actions="{ row }">
             <div class="row-actions" @dblclick.stop>
-              <el-button link type="primary" :disabled="busy || !forecastHasReference(row)" @click.stop="openEdit(row)">修改</el-button>
+              <el-button link type="primary" :disabled="busy || !forecastHasReference(row) || row.verifyStatus !== '1'" title="仅未核销记录可修改核销金额" @click.stop="openEdit(row)">修改</el-button>
             </div>
           </template>
         </ArtDataTable>
@@ -824,12 +849,17 @@ onBeforeUnmount(() => {
           </el-form-item>
           <el-form-item class="filter-status" label="核销状态">
             <el-select v-model="flowFilters.verifyStatus" clearable placeholder="不限">
-              <el-option v-for="option in verifyStatusOptions" :key="option.value" :label="option.label" :value="option.value" />
+              <el-option v-for="option in flowVerifyStatusOptions" :key="option.value" :label="option.label" :value="option.value" />
+            </el-select>
+          </el-form-item>
+          <el-form-item class="filter-status" label="业务类型">
+            <el-select v-model="flowFilters.busiType" clearable placeholder="不限">
+              <el-option v-for="option in busiTypeOptions" :key="option.value" :label="option.label" :value="option.value" />
             </el-select>
           </el-form-item>
           <el-form-item class="filter-status" label="收支方向">
             <el-select v-model="flowFilters.payDirec" clearable placeholder="不限">
-              <el-option v-for="option in payDirecOptions" :key="option.value" :label="option.label" :value="option.value" />
+              <el-option v-for="option in flowPayDirecOptions" :key="option.value" :label="option.label" :value="option.value" />
             </el-select>
           </el-form-item>
           <!-- prop 为查询字段，label 为字段名称，maxlength 为允许输入的最大字符数。 -->

package/src/view/dcps/write-off/typs.ts

@@ -93,13 +93,13 @@ export interface Tam140502001InBody {
   endTransAmt?: string
   /** 支付渠道,8:数字人民币 */
   payChannel?: string
-  /** 收支方向,I=来账 O=往账 */
+  /** 收支方向：1 收入、2 支出。 */
   payDirec?: string
   /** 起始金额 */
   startTransAmt?: string
   /** 交易日期 */
   tranDate: string
-  /** 核销状态列表 */
+  /** 核销状态列表：待核销 [1, 3]、已核销 [2]。 */
   verifyStatusList?: Array<string>
 }
 
@@ -117,6 +117,8 @@ export interface Tam140502001OutBodyResultList {
   busiType?: string
   /** 客户名称 */
   clientName?: string
+  /** 交易对手账号 */
+  competAcct?: string
   /** 交易对手名称 */
   competName?: string
   /** 释放状态 */
@@ -125,7 +127,7 @@ export interface Tam140502001OutBodyResultList {
   groundBranchName?: string
   /** 支付渠道,8:数字人民币 */
   payChannel?: string
-  /** 收支方向 */
+  /** 收支方向：1 收入、2 支出。 */
   payDirec?: string
   /** 预报金额 */
   predAmt?: string
@@ -143,6 +145,8 @@ export interface Tam140502001OutBodyResultList {
 
 /** Tam140502002In.Body */
 export interface Tam140502002InBody {
+  /** 业务类型：201 兑回、202 兑出、203 付现。 */
+  busiType?: string
   /** 截止金额 */
   endTransAmt?: string
   /** 我方机构 */
@@ -177,8 +181,8 @@ export interface Tam140502002OutBodyResultList {
   branchCode?: string
   /** 机构名称 */
   branchName?: string
-  /** 业务状态 */
-  busiStatus?: string
+  /** 交易状态：S 成功、P 处理中、F 失败。 */
+  tranStatus?: string
   /** 业务类型,201：兑回 ，202：兑出，203：付现 */
   busiType?: string
   /** 收款行行名称 */
@@ -210,7 +214,7 @@ export interface Tam140502002OutBodyResultList {
   tranDate?: string
   /** 交易时间 */
   tranTime?: string
-  /** 核销状态 */
+  /** 核销状态：1 未核销、2 已核销、3 部分核销。 */
   verifyStatus?: string
 }