From 8789cd1ff297556e76e0f641e3428b6717ab3990 Mon Sep 17 00:00:00 2001
From: YunaiV <zhijiantianya@gmail.com>
Date: Sun, 5 Oct 2025 11:12:19 +0800
Subject: [PATCH] =?UTF-8?q?feat=EF=BC=9A=E3=80=90antd=E3=80=91=E3=80=90erp?=
 =?UTF-8?q?=20=E7=B3=BB=E7=BB=9F=E3=80=91=E7=BB=9F=E4=B8=80=E5=AE=A1?=
 =?UTF-8?q?=E6=89=B9=E6=8E=A5=E5=8F=A3=E7=9A=84=E5=86=99=E6=B3=95=E4=B8=8E?=
 =?UTF-8?q?=E8=B0=83=E7=94=A8?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../src/api/erp/finance/account/index.ts      |  1 +
 .../src/api/erp/finance/payment/index.ts      | 40 +++--------
 .../src/api/erp/finance/receipt/index.ts      | 71 +++++++++++--------
 .../web-antd/src/api/erp/sale/return/index.ts | 13 +---
 .../web-antd/src/api/erp/stock/check/index.ts | 13 +---
 apps/web-antd/src/api/erp/stock/in/index.ts   | 10 +--
 apps/web-antd/src/api/erp/stock/move/index.ts | 13 +---
 apps/web-antd/src/api/erp/stock/out/index.ts  | 13 +---
 .../src/views/erp/stock/check/index.vue       |  2 +-
 .../web-antd/src/views/erp/stock/in/index.vue |  2 +-
 .../src/views/erp/stock/move/index.vue        |  2 +-
 .../src/views/erp/stock/out/index.vue         |  2 +-
 12 files changed, 66 insertions(+), 116 deletions(-)

diff --git a/apps/web-antd/src/api/erp/finance/account/index.ts b/apps/web-antd/src/api/erp/finance/account/index.ts
index e180af65f..9d5afaf49 100644
--- a/apps/web-antd/src/api/erp/finance/account/index.ts
+++ b/apps/web-antd/src/api/erp/finance/account/index.ts
@@ -51,6 +51,7 @@ export function updateAccount(data: ErpAccountApi.Account) {
 }
 
 /** 修改结算账户默认状态 */
+// TODO @芋艿：这里有少迁移的
 export function updateAccountDefaultStatus(id: number, defaultStatus: boolean) {
   return requestClient.put('/erp/account/update-default-status', null, {
     params: { id, defaultStatus },
diff --git a/apps/web-antd/src/api/erp/finance/payment/index.ts b/apps/web-antd/src/api/erp/finance/payment/index.ts
index 038ed5f20..e87abfe16 100644
--- a/apps/web-antd/src/api/erp/finance/payment/index.ts
+++ b/apps/web-antd/src/api/erp/finance/payment/index.ts
@@ -51,17 +51,9 @@ namespace ErpFinancePaymentApi {
     remark?: string;
     bizNo?: string;
   }
-
-  /** 付款单状态更新参数 */
-  export interface FinancePaymentStatusParams {
-    id: number;
-    status: number;
-  }
 }
 
-/**
- * 查询付款单分页
- */
+/** 查询付款单分页 */
 export function getFinancePaymentPage(
   params: ErpFinancePaymentApi.FinancePaymentPageParams,
 ) {
@@ -73,47 +65,35 @@ export function getFinancePaymentPage(
   );
 }
 
-/**
- * 查询付款单详情
- */
+/** 查询付款单详情 */
 export function getFinancePayment(id: number) {
   return requestClient.get<ErpFinancePaymentApi.FinancePayment>(
     `/erp/finance-payment/get?id=${id}`,
   );
 }
 
-/**
- * 新增付款单
- */
+/** 新增付款单 */
 export function createFinancePayment(
   data: ErpFinancePaymentApi.FinancePayment,
 ) {
   return requestClient.post('/erp/finance-payment/create', data);
 }
 
-/**
- * 修改付款单
- */
+/** 修改付款单 */
 export function updateFinancePayment(
   data: ErpFinancePaymentApi.FinancePayment,
 ) {
   return requestClient.put('/erp/finance-payment/update', data);
 }
 
-/**
- * 更新付款单的状态
- */
-export function updateFinancePaymentStatus(
-  params: ErpFinancePaymentApi.FinancePaymentStatusParams,
-) {
+/** 更新付款单的状态 */
+export function updateFinancePaymentStatus(id: number, status: number) {
   return requestClient.put('/erp/finance-payment/update-status', null, {
-    params,
+    params: { id, status },
   });
 }
 
-/**
- * 删除付款单
- */
+/** 删除付款单 */
 export function deleteFinancePayment(ids: number[]) {
   return requestClient.delete('/erp/finance-payment/delete', {
     params: {
@@ -122,9 +102,7 @@ export function deleteFinancePayment(ids: number[]) {
   });
 }
 
-/**
- * 导出付款单 Excel
- */
+/** 导出付款单 Excel */
 export function exportFinancePayment(
   params: ErpFinancePaymentApi.FinancePaymentPageParams,
 ) {
diff --git a/apps/web-antd/src/api/erp/finance/receipt/index.ts b/apps/web-antd/src/api/erp/finance/receipt/index.ts
index 37b70e764..a02f8c5e8 100644
--- a/apps/web-antd/src/api/erp/finance/receipt/index.ts
+++ b/apps/web-antd/src/api/erp/finance/receipt/index.ts
@@ -3,34 +3,57 @@ import type { PageParam, PageResult } from '@vben/request';
 import { requestClient } from '#/api/request';
 
 namespace ErpFinanceReceiptApi {
+  /** 收款单项 */
+  export interface FinanceReceiptItem {
+    id?: number;
+    row_id?: number; // 前端使用的临时ID
+    bizId: number; // 业务ID
+    bizType: number; // 业务类型
+    bizNo: string; // 业务编号
+    totalPrice: number; // 应收金额
+    receiptedPrice: number; // 已收金额
+    receiptPrice: number; // 本次收款
+    remark?: string; // 备注
+  }
+
   /** 收款单信息 */
   export interface FinanceReceipt {
     id?: number; // 收款单编号
     no: string; // 收款单号
     customerId: number; // 客户编号
+    customerName?: string; // 客户名称
     receiptTime: Date; // 收款时间
     totalPrice: number; // 合计金额，单位：元
+    discountPrice: number; // 优惠金额
+    receiptPrice: number; // 实际收款金额
     status: number; // 状态
     remark: string; // 备注
+    fileUrl?: string; // 附件
+    accountId?: number; // 收款账户
+    accountName?: string; // 账户名称
+    financeUserId?: number; // 财务人员
+    financeUserName?: string; // 财务人员姓名
+    creator?: string; // 创建人
+    creatorName?: string; // 创建人姓名
+    items?: FinanceReceiptItem[]; // 收款明细
+    bizNo?: string; // 业务单号
   }
 
   /** 收款单分页查询参数 */
   export interface FinanceReceiptPageParams extends PageParam {
     no?: string;
+    receiptTime?: [string, string];
     customerId?: number;
+    creator?: string;
+    financeUserId?: number;
+    accountId?: number;
     status?: number;
-  }
-
-  /** 收款单状态更新参数 */
-  export interface FinanceReceiptStatusParams {
-    id: number;
-    status: number;
+    remark?: string;
+    bizNo?: string;
   }
 }
 
-/**
- * 查询收款单分页
- */
+/** 查询收款单分页 */
 export function getFinanceReceiptPage(
   params: ErpFinanceReceiptApi.FinanceReceiptPageParams,
 ) {
@@ -42,47 +65,35 @@ export function getFinanceReceiptPage(
   );
 }
 
-/**
- * 查询收款单详情
- */
+/** 查询收款单详情 */
 export function getFinanceReceipt(id: number) {
   return requestClient.get<ErpFinanceReceiptApi.FinanceReceipt>(
     `/erp/finance-receipt/get?id=${id}`,
   );
 }
 
-/**
- * 新增收款单
- */
+/** 新增收款单 */
 export function createFinanceReceipt(
   data: ErpFinanceReceiptApi.FinanceReceipt,
 ) {
   return requestClient.post('/erp/finance-receipt/create', data);
 }
 
-/**
- * 修改收款单
- */
+/** 修改收款单 */
 export function updateFinanceReceipt(
   data: ErpFinanceReceiptApi.FinanceReceipt,
 ) {
   return requestClient.put('/erp/finance-receipt/update', data);
 }
 
-/**
- * 更新收款单的状态
- */
-export function updateFinanceReceiptStatus(
-  params: ErpFinanceReceiptApi.FinanceReceiptStatusParams,
-) {
+/** 更新收款单的状态 */
+export function updateFinanceReceiptStatus(id: number, status: number) {
   return requestClient.put('/erp/finance-receipt/update-status', null, {
-    params,
+    params: { id, status },
   });
 }
 
-/**
- * 删除收款单
- */
+/** 删除收款单 */
 export function deleteFinanceReceipt(ids: number[]) {
   return requestClient.delete('/erp/finance-receipt/delete', {
     params: {
@@ -91,9 +102,7 @@ export function deleteFinanceReceipt(ids: number[]) {
   });
 }
 
-/**
- * 导出收款单 Excel
- */
+/** 导出收款单 Excel */
 export function exportFinanceReceipt(
   params: ErpFinanceReceiptApi.FinanceReceiptPageParams,
 ) {
diff --git a/apps/web-antd/src/api/erp/sale/return/index.ts b/apps/web-antd/src/api/erp/sale/return/index.ts
index 91057f4df..adc718cc3 100644
--- a/apps/web-antd/src/api/erp/sale/return/index.ts
+++ b/apps/web-antd/src/api/erp/sale/return/index.ts
@@ -22,6 +22,7 @@ export namespace ErpSaleReturnApi {
     fileUrl?: string; // 附件地址
     items?: SaleReturnItem[];
   }
+
   export interface SaleReturnItem {
     count?: number;
     id?: number;
@@ -48,12 +49,6 @@ export namespace ErpSaleReturnApi {
     customerId?: number;
     status?: number;
   }
-
-  /** 销售退货状态更新参数 */
-  export interface SaleReturnStatusParams {
-    id: number;
-    status: number;
-  }
 }
 
 /**
@@ -96,11 +91,9 @@ export function updateSaleReturn(data: ErpSaleReturnApi.SaleReturn) {
 /**
  * 更新销售退货的状态
  */
-export function updateSaleReturnStatus(
-  params: ErpSaleReturnApi.SaleReturnStatusParams,
-) {
+export function updateSaleReturnStatus(id: number, status: number) {
   return requestClient.put('/erp/sale-return/update-status', null, {
-    params,
+    params: { id, status },
   });
 }
 
diff --git a/apps/web-antd/src/api/erp/stock/check/index.ts b/apps/web-antd/src/api/erp/stock/check/index.ts
index 60d581405..386948432 100644
--- a/apps/web-antd/src/api/erp/stock/check/index.ts
+++ b/apps/web-antd/src/api/erp/stock/check/index.ts
@@ -17,6 +17,7 @@ export namespace ErpStockCheckApi {
     creatorName?: string; // 创建人
     items?: StockCheckItem[]; // 盘点产品清单
   }
+
   export interface StockCheckItem {
     id?: number; // 编号
     warehouseId?: number; // 仓库编号
@@ -38,12 +39,6 @@ export namespace ErpStockCheckApi {
     no?: string;
     status?: number;
   }
-
-  /** 库存盘点单状态更新参数 */
-  export interface StockCheckStatusParams {
-    id: number;
-    status: number;
-  }
 }
 
 /**
@@ -86,11 +81,9 @@ export function updateStockCheck(data: ErpStockCheckApi.StockCheck) {
 /**
  * 更新库存盘点单的状态
  */
-export function updateStockCheckStatus(
-  params: ErpStockCheckApi.StockCheckStatusParams,
-) {
+export function updateStockCheckStatus(id: number, status: number) {
   return requestClient.put('/erp/stock-check/update-status', null, {
-    params,
+    params: { id, status },
   });
 }
 
diff --git a/apps/web-antd/src/api/erp/stock/in/index.ts b/apps/web-antd/src/api/erp/stock/in/index.ts
index 8fe9bafd4..18e109314 100644
--- a/apps/web-antd/src/api/erp/stock/in/index.ts
+++ b/apps/web-antd/src/api/erp/stock/in/index.ts
@@ -42,12 +42,6 @@ export namespace ErpStockInApi {
     supplierId?: number;
     status?: number;
   }
-
-  /** 其它入库单状态更新参数 */
-  export interface StockInStatusParams {
-    id: number;
-    status: number;
-  }
 }
 
 /**
@@ -86,9 +80,9 @@ export function updateStockIn(data: ErpStockInApi.StockIn) {
 /**
  * 更新其它入库单的状态
  */
-export function updateStockInStatus(params: ErpStockInApi.StockInStatusParams) {
+export function updateStockInStatus(id: number, status: number) {
   return requestClient.put('/erp/stock-in/update-status', null, {
-    params,
+    params: { id, status },
   });
 }
 
diff --git a/apps/web-antd/src/api/erp/stock/move/index.ts b/apps/web-antd/src/api/erp/stock/move/index.ts
index 33e49f299..409ca8f64 100644
--- a/apps/web-antd/src/api/erp/stock/move/index.ts
+++ b/apps/web-antd/src/api/erp/stock/move/index.ts
@@ -43,13 +43,6 @@ export namespace ErpStockMoveApi {
     status?: number;
   }
 
-  /** 库存调拨单状态更新参数 */
-  export interface StockMoveStatusParams {
-    id: number;
-    status: number;
-  }
-}
-
 /**
  * 查询库存调拨单分页
  */
@@ -88,11 +81,9 @@ export function updateStockMove(data: ErpStockMoveApi.StockMove) {
 /**
  * 更新库存调拨单的状态
  */
-export function updateStockMoveStatus(
-  params: ErpStockMoveApi.StockMoveStatusParams,
-) {
+export function updateStockMoveStatus(id: number, status: number) {
   return requestClient.put('/erp/stock-move/update-status', null, {
-    params,
+    params: { id, status },
   });
 }
 
diff --git a/apps/web-antd/src/api/erp/stock/out/index.ts b/apps/web-antd/src/api/erp/stock/out/index.ts
index a3873f948..5ee1a19fa 100644
--- a/apps/web-antd/src/api/erp/stock/out/index.ts
+++ b/apps/web-antd/src/api/erp/stock/out/index.ts
@@ -40,13 +40,6 @@ export namespace ErpStockOutApi {
     status?: number;
   }
 
-  /** 其它出库单状态更新参数 */
-  export interface StockOutStatusParams {
-    id: number;
-    status: number;
-  }
-}
-
 /**
  * 查询其它出库单分页
  */
@@ -85,11 +78,9 @@ export function updateStockOut(data: ErpStockOutApi.StockOut) {
 /**
  * 更新其它出库单的状态
  */
-export function updateStockOutStatus(
-  params: ErpStockOutApi.StockOutStatusParams,
-) {
+export function updateStockOutStatus(id: number, status: number) {
   return requestClient.put('/erp/stock-out/update-status', null, {
-    params,
+    params: { id, status },
   });
 }
 
diff --git a/apps/web-antd/src/views/erp/stock/check/index.vue b/apps/web-antd/src/views/erp/stock/check/index.vue
index e41dda017..c41d68332 100644
--- a/apps/web-antd/src/views/erp/stock/check/index.vue
+++ b/apps/web-antd/src/views/erp/stock/check/index.vue
@@ -75,7 +75,7 @@ async function handleUpdateStatus(
     duration: 0,
   });
   try {
-    await updateStockCheckStatus({ id: row.id!, status });
+    await updateStockCheckStatus(row.id!, status);
     message.success(`${status === 20 ? '审批' : '反审批'}成功`);
     handleRefresh();
   } finally {
diff --git a/apps/web-antd/src/views/erp/stock/in/index.vue b/apps/web-antd/src/views/erp/stock/in/index.vue
index cc1bb6ed2..4d6910f71 100644
--- a/apps/web-antd/src/views/erp/stock/in/index.vue
+++ b/apps/web-antd/src/views/erp/stock/in/index.vue
@@ -72,7 +72,7 @@ async function handleUpdateStatus(row: ErpStockInApi.StockIn, status: number) {
     duration: 0,
   });
   try {
-    await updateStockInStatus({ id: row.id!, status });
+    await updateStockInStatus(row.id!, status);
     message.success(`${status === 20 ? '审批' : '反审批'}成功`);
     handleRefresh();
   } finally {
diff --git a/apps/web-antd/src/views/erp/stock/move/index.vue b/apps/web-antd/src/views/erp/stock/move/index.vue
index 91f773b68..ad3214ac8 100644
--- a/apps/web-antd/src/views/erp/stock/move/index.vue
+++ b/apps/web-antd/src/views/erp/stock/move/index.vue
@@ -75,7 +75,7 @@ async function handleUpdateStatus(
     duration: 0,
   });
   try {
-    await updateStockMoveStatus({ id: row.id!, status });
+    await updateStockMoveStatus(row.id!, status);
     message.success(`${status === 20 ? '审批' : '反审批'}成功`);
     handleRefresh();
   } finally {
diff --git a/apps/web-antd/src/views/erp/stock/out/index.vue b/apps/web-antd/src/views/erp/stock/out/index.vue
index 73250a1c0..f323dec82 100644
--- a/apps/web-antd/src/views/erp/stock/out/index.vue
+++ b/apps/web-antd/src/views/erp/stock/out/index.vue
@@ -75,7 +75,7 @@ async function handleUpdateStatus(
     duration: 0,
   });
   try {
-    await updateStockOutStatus({ id: row.id!, status });
+    await updateStockOutStatus(row.id!, status);
     message.success(`${status === 20 ? '审批' : '反审批'}成功`);
     handleRefresh();
   } finally {