From 3ae8d536cd4f4fc082084e239c2292950ed0389f Mon Sep 17 00:00:00 2001
From: luojiaquan <1583622118@qq.com>
Date: Tue, 13 Oct 2026 10:38:50 +0800
Subject: [PATCH] =?UTF-8?q?=E6=94=B6=E6=AC=BE=E7=AE=A1=E7=90=86?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../controller/ar/ArReceiptController.java    |  164 ++
 .../customermoney/domain/CustomerReceipt.java |    6 +
 .../mapper/ar/ArBalanceWriteoffMapper.xml     |    7 +
 .../mapper/customer/CustomerMoneyMapper.xml   |   17 +-
 bms-back/sql/20261013_ar_receipt_menu.sql     |   44 +
 bms-front/src/api/ar/receipt.js               |   50 +
 bms-front/src/views/ar/receipt/index.vue      | 1371 +++++++++++++++++
 7 files changed, 1655 insertions(+), 4 deletions(-)
 create mode 100644 bms-back/bms-admin/src/main/java/com/bms/web/controller/ar/ArReceiptController.java
 create mode 100644 bms-back/sql/20261013_ar_receipt_menu.sql
 create mode 100644 bms-front/src/api/ar/receipt.js
 create mode 100644 bms-front/src/views/ar/receipt/index.vue

diff --git a/bms-back/bms-admin/src/main/java/com/bms/web/controller/ar/ArReceiptController.java b/bms-back/bms-admin/src/main/java/com/bms/web/controller/ar/ArReceiptController.java
new file mode 100644
index 00000000..59a66ffa
--- /dev/null
+++ b/bms-back/bms-admin/src/main/java/com/bms/web/controller/ar/ArReceiptController.java
@@ -0,0 +1,164 @@
+package com.bms.web.controller.ar;
+
+import java.time.LocalDate;
+import java.time.format.DateTimeFormatter;
+import java.util.List;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+import com.bms.ar.domain.ArBalanceWriteoff;
+import com.bms.ar.domain.ArBill;
+import com.bms.ar.service.IArBalanceWriteoffService;
+import com.bms.common.annotation.Log;
+import com.bms.common.core.controller.BaseController;
+import com.bms.common.core.domain.AjaxResult;
+import com.bms.common.core.page.TableDataInfo;
+import com.bms.common.enums.BusinessType;
+import com.bms.customer.customermoney.domain.CustomerReceipt;
+import com.bms.customer.customermoney.service.ICustomerMoneyService;
+
+/**
+ * 收款管理 Controller（账单管理-收款管理）
+ * <p>
+ * 收款登记/审核/取消与「客户余额-登记收款」复用同一套 Service 逻辑；
+ * 账单核销同样复用余额核销 Service：登记收款时可携带核销计划（审核通过后联动核销），
+ * 本页「账单核销」页签可直接对账单发起核销/反核销。
+ *
+ * @author bms
+ * @date 2026-10-13
+ */
+@RestController
+@RequestMapping("/ar/receipt")
+public class ArReceiptController extends BaseController
+{
+    @Autowired
+    private ICustomerMoneyService customerMoneyService;
+
+    @Autowired
+    private IArBalanceWriteoffService balanceWriteoffService;
+
+    /** 收款时间查询/默认范围格式：精确到秒 */
+    private static final DateTimeFormatter DATE_TIME_FORMATTER =
+            DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");
+
+    /**
+     * 查询收款记录（跨客户）。支持按客户、收款时间（精确到时分秒）等维度查询，未传时间范围时默认查当天。
+     */
+    @PreAuthorize("@ss.hasPermi('ar:receipt:list')")
+    @GetMapping("/list")
+    public TableDataInfo list(CustomerReceipt query)
+    {
+        if (query != null)
+        {
+            Object begin = query.getParams() == null ? null : query.getParams().get("beginTime");
+            Object end = query.getParams() == null ? null : query.getParams().get("endTime");
+            if (begin == null && end == null)
+            {
+                // 默认当天 00:00:00 ~ 23:59:59
+                LocalDate today = LocalDate.now();
+                query.getParams().put("beginTime", today.atStartOfDay().format(DATE_TIME_FORMATTER));
+                query.getParams().put("endTime", today.atTime(23, 59, 59).format(DATE_TIME_FORMATTER));
+            }
+        }
+        startPage();
+        List<CustomerReceipt> list = customerMoneyService.selectReceiptList(query);
+        return getDataTable(list);
+    }
+
+    /**
+     * 获取收款单详情（含核销计划与收款附件）
+     */
+    @PreAuthorize("@ss.hasPermi('ar:receipt:query')")
+    @GetMapping("/{id}")
+    public AjaxResult getInfo(@PathVariable("id") Long id)
+    {
+        return success(customerMoneyService.selectReceiptById(id));
+    }
+
+    /**
+     * 登记收款（必须选择客户；默认待确认，审核通过后入账并执行登记时选择的核销计划）
+     */
+    @PreAuthorize("@ss.hasPermi('ar:receipt:add')")
+    @Log(title = "收款管理-登记收款", businessType = BusinessType.INSERT)
+    @PostMapping
+    public AjaxResult add(@RequestBody CustomerReceipt receipt)
+    {
+        receipt.setCreateBy(getUsername());
+        return toAjax(customerMoneyService.insertReceipt(receipt));
+    }
+
+    /**
+     * 审核通过收款单：确认后金额计入客户余额，登记时选择的账单一并核销
+     */
+    @PreAuthorize("@ss.hasPermi('ar:receipt:review')")
+    @Log(title = "收款管理-收款审核", businessType = BusinessType.UPDATE)
+    @PutMapping("/confirm/{id}")
+    public AjaxResult confirm(@PathVariable("id") Long id)
+    {
+        return toAjax(customerMoneyService.confirmReceipt(id));
+    }
+
+    /**
+     * 取消收款单（仅待确认可取消）
+     */
+    @PreAuthorize("@ss.hasPermi('ar:receipt:edit')")
+    @Log(title = "收款管理-取消收款", businessType = BusinessType.UPDATE)
+    @PutMapping("/cancel/{id}")
+    public AjaxResult cancel(@PathVariable("id") Long id)
+    {
+        return toAjax(customerMoneyService.cancelReceipt(id));
+    }
+
+    /**
+     * 查询客户可核销账单（已确认/部分核销，未核销额大于0），登记收款选账单与核销页签共用
+     */
+    @PreAuthorize("@ss.hasPermi('ar:receipt:list')")
+    @GetMapping("/bill/unsettled/{customerId}")
+    public AjaxResult unsettledBills(@PathVariable("customerId") Long customerId)
+    {
+        return success(balanceWriteoffService.selectUnsettledBills(customerId));
+    }
+
+    /**
+     * 查询核销记录（跨客户，支持客户/账单号/状态/核销日期范围）
+     */
+    @PreAuthorize("@ss.hasPermi('ar:receipt:list')")
+    @GetMapping("/writeoff/list")
+    public TableDataInfo writeoffList(ArBalanceWriteoff query)
+    {
+        startPage();
+        List<ArBalanceWriteoff> list = balanceWriteoffService.selectWriteoffList(query);
+        return getDataTable(list);
+    }
+
+    /**
+     * 账单核销（账单核销页签直接核销；与客户余额页核销同一套逻辑）
+     */
+    @PreAuthorize("@ss.hasPermi('ar:receipt:writeoff')")
+    @Log(title = "收款管理-账单核销", businessType = BusinessType.UPDATE)
+    @PostMapping("/writeoff")
+    public AjaxResult writeoff(@RequestBody ArBalanceWriteoff cmd)
+    {
+        cmd.setCreateBy(getUsername());
+        return success(balanceWriteoffService.writeoff(cmd));
+    }
+
+    /**
+     * 反核销（取消一笔有效核销，账单恢复未核销金额）
+     */
+    @PreAuthorize("@ss.hasPermi('ar:receipt:writeoff:cancel')")
+    @Log(title = "收款管理-反核销", businessType = BusinessType.UPDATE)
+    @PutMapping("/writeoff/{writeoffId}/cancel")
+    public AjaxResult cancelWriteoff(@PathVariable("writeoffId") Long writeoffId,
+                                     @RequestBody(required = false) ArBalanceWriteoff body)
+    {
+        balanceWriteoffService.cancelWriteoff(writeoffId, body == null ? null : body.getCancelRemark());
+        return success();
+    }
+}
diff --git a/bms-back/bms-system/src/main/java/com/bms/customer/customermoney/domain/CustomerReceipt.java b/bms-back/bms-system/src/main/java/com/bms/customer/customermoney/domain/CustomerReceipt.java
index 8f6012a7..ebfc1722 100644
--- a/bms-back/bms-system/src/main/java/com/bms/customer/customermoney/domain/CustomerReceipt.java
+++ b/bms-back/bms-system/src/main/java/com/bms/customer/customermoney/domain/CustomerReceipt.java
@@ -51,6 +51,12 @@ public class CustomerReceipt extends BaseEntity
     /** 客户ID */
     private Long customerId;
 
+    /** 客户编码（列表关联查询，仅展示） */
+    private String customerCode;
+
+    /** 客户名称（列表关联查询，仅展示） */
+    private String customerName;
+
     /** 客户账户ID（预留） */
     private Long accountId;
 
diff --git a/bms-back/bms-system/src/main/resources/mapper/ar/ArBalanceWriteoffMapper.xml b/bms-back/bms-system/src/main/resources/mapper/ar/ArBalanceWriteoffMapper.xml
index f13a6fb6..59f0ac57 100644
--- a/bms-back/bms-system/src/main/resources/mapper/ar/ArBalanceWriteoffMapper.xml
+++ b/bms-back/bms-system/src/main/resources/mapper/ar/ArBalanceWriteoffMapper.xml
@@ -83,6 +83,13 @@ PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
             <if test="currency != null and currency != ''">and w.currency = #{currency}</if>
             <if test="writeoffNo != null and writeoffNo != ''">and w.writeoff_no like concat('%', #{writeoffNo}, '%')</if>
             <if test="billNo != null and billNo != ''">and w.bill_no like concat('%', #{billNo}, '%')</if>
+            <if test="receiptId != null">and w.receipt_id = #{receiptId}</if>
+            <if test="params != null and params.beginTime != null and params.beginTime != ''">
+                and date_format(w.writeoff_date,'%y%m%d') &gt;= date_format(#{params.beginTime},'%y%m%d')
+            </if>
+            <if test="params != null and params.endTime != null and params.endTime != ''">
+                and date_format(w.writeoff_date,'%y%m%d') &lt;= date_format(#{params.endTime},'%y%m%d')
+            </if>
         </where>
         order by w.create_time desc, w.writeoff_id desc
     </select>
diff --git a/bms-back/bms-system/src/main/resources/mapper/customer/CustomerMoneyMapper.xml b/bms-back/bms-system/src/main/resources/mapper/customer/CustomerMoneyMapper.xml
index d26b1cd0..1e082cc1 100644
--- a/bms-back/bms-system/src/main/resources/mapper/customer/CustomerMoneyMapper.xml
+++ b/bms-back/bms-system/src/main/resources/mapper/customer/CustomerMoneyMapper.xml
@@ -236,6 +236,8 @@ PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
         <id     property="id"                  column="id"                    />
         <result property="receiptNo"           column="receipt_no"            />
         <result property="customerId"          column="customer_id"           />
+        <result property="customerCode"        column="customer_code"         />
+        <result property="customerName"        column="customer_name"         />
         <result property="accountId"           column="account_id"            />
         <result property="receiptType"         column="receipt_type"          />
         <result property="amount"              column="amount"                />
@@ -268,7 +270,8 @@ PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
     </resultMap>
 
     <sql id="selectCustomerReceiptVo">
-        select r.id, r.receipt_no, r.customer_id, r.account_id, r.receipt_type, r.amount, r.allocated_amount,
+        select r.id, r.receipt_no, r.customer_id, c.customer_code, c.customer_name, r.account_id, r.receipt_type,
+               r.amount, r.allocated_amount,
                r.unallocated_amount, r.currency, r.exchange_rate, r.rate_source, r.rate_source_desc,
                r.base_amount, r.pay_method, r.bank_account_id, r.bank_account_name,
                r.bank_account_no, r.bank_name, r.bank_transaction_no,
@@ -278,6 +281,7 @@ PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
                (select count(1) from ctr_customer_attachment a
                  where a.biz_id = r.id and a.attachment_type = '3' and a.del_flag = '0') as attachment_count
         from ctr_customer_receipt r
+        left join ctr_customer c on c.customer_id = r.customer_id
     </sql>
 
     <select id="selectReceiptList" parameterType="com.bms.customer.customermoney.domain.CustomerReceipt"
@@ -286,7 +290,8 @@ PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
         <where>
             r.del_flag = '0'
             <if test="customerId != null"> and r.customer_id = #{customerId}</if>
-            
+            <if test="customerCode != null and customerCode != ''"> and c.customer_code like concat('%', #{customerCode}, '%')</if>
+            <if test="customerName != null and customerName != ''"> and c.customer_name like concat('%', #{customerName}, '%')</if>
             <if test="receiptNo != null and receiptNo != ''"> and r.receipt_no like concat('%', #{receiptNo}, '%')</if>
             <if test="receiptType != null and receiptType != ''"> and r.receipt_type = #{receiptType}</if>
             <if test="status != null and status != ''"> and r.status = #{status}</if>
@@ -295,11 +300,15 @@ PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
             <if test="bankTransactionNo != null and bankTransactionNo != ''">
                 and r.bank_transaction_no like concat('%', #{bankTransactionNo}, '%')
             </if>
+            <!-- 收款时间精确到时分秒：入参为 yyyy-MM-dd HH:mm:ss 直接比较；
+                 兼容客户余额页传入的纯日期 yyyy-MM-dd（开始补 00:00:00、结束补 23:59:59） -->
             <if test="params != null and params.beginTime != null and params.beginTime != ''">
-                and date_format(r.received_at,'%y%m%d') &gt;= date_format(#{params.beginTime},'%y%m%d')
+                and r.received_at &gt;= concat(#{params.beginTime},
+                    case when char_length(#{params.beginTime}) = 10 then ' 00:00:00' else '' end)
             </if>
             <if test="params != null and params.endTime != null and params.endTime != ''">
-                and date_format(r.received_at,'%y%m%d') &lt;= date_format(#{params.endTime},'%y%m%d')
+                and r.received_at &lt;= concat(#{params.endTime},
+                    case when char_length(#{params.endTime}) = 10 then ' 23:59:59' else '' end)
             </if>
         </where>
         order by r.received_at desc, r.id desc
diff --git a/bms-back/sql/20261013_ar_receipt_menu.sql b/bms-back/sql/20261013_ar_receipt_menu.sql
new file mode 100644
index 00000000..c7db5fbf
--- /dev/null
+++ b/bms-back/sql/20261013_ar_receipt_menu.sql
@@ -0,0 +1,44 @@
+-- ============================================================
+-- 账单管理 - 收款管理 菜单及权限
+-- 日期：2026-10-13
+-- 说明：
+--   1) 在「账单管理」(menu_id=2400) 下新增「收款管理」页面（应收账单 order=1 之后，应收日志 order=3 之前）；
+--   2) 页面含两个页签：收款记录（跨客户查询/默认当天/勾选汇总收款总额/登记收款/审核/取消/查看）、
+--      账单核销（账单查询并直接核销、核销记录查询与反核销；登记收款时同样可携带核销计划，审核后联动核销）；
+--   3) 收款登记/审核/取消与「客户余额-登记收款」复用同一套后端 Service 逻辑（ctr_customer_receipt）；
+--   4) 角色授权与「应收账单」(2401) 当前可见角色保持一致（role_id=6040 销售经理）；
+--      超级管理员(admin)默认拥有全部权限；其他角色可在 系统管理-角色 中勾选「收款管理」。
+-- ============================================================
+
+-- 1. 收款管理 页面菜单
+insert into sys_menu(menu_id, menu_name, parent_id, order_num, path, component, query, route_name,
+                     is_frame, is_cache, menu_type, visible, status, perms, icon,
+                     create_by, create_time, remark)
+values (2461, '收款管理', 2400, 2, 'receipt', 'ar/receipt/index', null, 'ArReceipt',
+        1, 0, 'C', '0', '0', 'ar:receipt:list', 'validCode',
+        'admin', sysdate(), '收款记录查询、登记收款与账单核销');
+
+-- 2. 按钮权限
+insert into sys_menu(menu_id, menu_name, parent_id, order_num, path, component, query, route_name,
+                     is_frame, is_cache, menu_type, visible, status, perms, icon,
+                     create_by, create_time, remark)
+values
+(2462, '收款查看',     2461, 1, '', null, null, '', 1, 0, 'F', '0', '0', 'ar:receipt:query',           '#', 'admin', sysdate(), '收款单详情（含核销计划与凭证）'),
+(2463, '登记收款',     2461, 2, '', null, null, '', 1, 0, 'F', '0', '0', 'ar:receipt:add',             '#', 'admin', sysdate(), '登记客户收款（必选客户，可同时选择核销账单）'),
+(2464, '收款审核',     2461, 3, '', null, null, '', 1, 0, 'F', '0', '0', 'ar:receipt:review',          '#', 'admin', sysdate(), '审核通过收款单，入账并联动核销'),
+(2465, '取消收款',     2461, 4, '', null, null, '', 1, 0, 'F', '0', '0', 'ar:receipt:edit',            '#', 'admin', sysdate(), '取消待确认收款单'),
+(2466, '账单核销',     2461, 5, '', null, null, '', 1, 0, 'F', '0', '0', 'ar:receipt:writeoff',        '#', 'admin', sysdate(), '账单核销页签直接核销应收账单'),
+(2467, '核销反核销',   2461, 6, '', null, null, '', 1, 0, 'F', '0', '0', 'ar:receipt:writeoff:cancel', '#', 'admin', sysdate(), '反核销账单核销记录');
+
+-- 3. 授权给拥有「应收账单」菜单的角色（当前为 role_id=6040 销售经理）
+insert into sys_role_menu(role_id, menu_id)
+select r.role_id, m.menu_id
+from sys_role r
+cross join (
+    select 2461 as menu_id union all select 2462 union all select 2463 union all
+    select 2464 union all select 2465 union all select 2466 union all select 2467
+) m
+where r.role_id in (select role_id from sys_role_menu where menu_id = 2401)
+  and not exists (
+      select 1 from sys_role_menu rm where rm.role_id = r.role_id and rm.menu_id = m.menu_id
+  );
diff --git a/bms-front/src/api/ar/receipt.js b/bms-front/src/api/ar/receipt.js
new file mode 100644
index 00000000..e7d95994
--- /dev/null
+++ b/bms-front/src/api/ar/receipt.js
@@ -0,0 +1,50 @@
+import request from '@/utils/request'
+
+/** 查询收款记录（跨客户，未传收款时间时后端默认当天） */
+export function listReceipt(query) {
+  return request({ url: '/ar/receipt/list', method: 'get', params: query })
+}
+
+/** 收款单详情（含核销计划与凭证附件） */
+export function getReceipt(id) {
+  return request({ url: '/ar/receipt/' + id, method: 'get' })
+}
+
+/** 登记收款（必须选择客户，与客户余额-登记收款同一套逻辑） */
+export function addReceipt(data) {
+  return request({ url: '/ar/receipt', method: 'post', data })
+}
+
+/** 审核通过收款单 */
+export function confirmReceipt(id) {
+  return request({ url: '/ar/receipt/confirm/' + id, method: 'put' })
+}
+
+/** 取消收款单 */
+export function cancelReceipt(id) {
+  return request({ url: '/ar/receipt/cancel/' + id, method: 'put' })
+}
+
+/** 查询客户可核销账单（已确认/部分核销） */
+export function listUnsettledBill(customerId) {
+  return request({ url: '/ar/receipt/bill/unsettled/' + customerId, method: 'get' })
+}
+
+/** 查询核销记录（跨客户） */
+export function listReceiptWriteoff(query) {
+  return request({ url: '/ar/receipt/writeoff/list', method: 'get', params: query })
+}
+
+/** 账单核销（账单核销页签直接核销） */
+export function receiptWriteoff(data) {
+  return request({ url: '/ar/receipt/writeoff', method: 'post', data })
+}
+
+/** 反核销 */
+export function cancelReceiptWriteoff(writeoffId, cancelRemark) {
+  return request({
+    url: '/ar/receipt/writeoff/' + writeoffId + '/cancel',
+    method: 'put',
+    data: { cancelRemark }
+  })
+}
diff --git a/bms-front/src/views/ar/receipt/index.vue b/bms-front/src/views/ar/receipt/index.vue
new file mode 100644
index 00000000..a826c7e8
--- /dev/null
+++ b/bms-front/src/views/ar/receipt/index.vue
@@ -0,0 +1,1371 @@
+<template>
+  <div class="app-container ar-receipt-page">
+    <el-card shadow="never">
+      <el-tabs v-model="activeTab">
+        <!-- ====================== 收款记录 ====================== -->
+        <el-tab-pane label="收款记录" name="receipt">
+          <el-form :model="receiptQuery" :inline="true" class="search-form">
+            <el-form-item label="客户">
+              <customer-select
+                v-model="receiptQuery.customerId"
+                placeholder="客户名称/代码搜索"
+                :page-size="1000"
+                style="width: 220px;"
+              />
+            </el-form-item>
+            <el-form-item label="收款时间">
+              <el-date-picker
+                v-model="receiptDateRange"
+                value-format="YYYY-MM-DD HH:mm:ss"
+                type="datetimerange"
+                range-separator="-"
+                start-placeholder="开始时间"
+                end-placeholder="结束时间"
+                :default-time="defaultTimeRange"
+                style="width: 360px;"
+              />
+            </el-form-item>
+            <el-form-item label="收款单号">
+              <el-input v-model="receiptQuery.receiptNo" placeholder="收款单号" clearable style="width: 170px;" @keyup.enter="getReceiptList" />
+            </el-form-item>
+            <el-form-item label="收款类型">
+              <el-select v-model="receiptQuery.receiptType" placeholder="全部" clearable style="width: 130px;">
+                <el-option v-for="opt in receiptTypeOptions" :key="opt.value" :label="opt.label" :value="opt.value" />
+              </el-select>
+            </el-form-item>
+            <el-form-item label="状态">
+              <el-select v-model="receiptQuery.status" placeholder="全部" clearable style="width: 120px;">
+                <el-option v-for="opt in receiptStatusOptions" :key="opt.value" :label="opt.label" :value="opt.value" />
+              </el-select>
+            </el-form-item>
+            <el-form-item>
+              <el-button type="primary" icon="Search" @click="getReceiptList">搜索</el-button>
+              <el-button icon="Refresh" @click="resetReceiptQuery">重置</el-button>
+              <el-button type="success" icon="Plus" v-hasPermi="['ar:receipt:add']" @click="handleAddReceipt">登记收款</el-button>
+            </el-form-item>
+          </el-form>
+
+          <div class="select-summary">
+            已选 <b>{{ selectedReceipts.length }}</b> 笔收款，
+            收款总额（本位币）：<b class="money-in">CNY {{ selectedCnyTotal }}</b>
+            <template v-if="selectedCurrencyText">，原币合计：{{ selectedCurrencyText }}</template>
+          </div>
+
+          <el-table :data="receiptList" border v-loading="receiptLoading" @selection-change="onReceiptSelectionChange">
+            <el-table-column type="selection" width="42" align="center" />
+            <el-table-column label="收款单号" align="center" prop="receiptNo" width="180" show-overflow-tooltip />
+            <el-table-column label="客户" align="center" min-width="180" show-overflow-tooltip>
+              <template #default="scope">
+                <div>{{ scope.row.customerName || '-' }}</div>
+                <div class="cell-sub">{{ scope.row.customerCode }}</div>
+              </template>
+            </el-table-column>
+            <el-table-column label="收款时间" align="center" prop="receivedAt" width="170">
+              <template #default="scope">{{ formatDateTime(scope.row.receivedAt) }}</template>
+            </el-table-column>
+            <el-table-column label="收款类型" align="center" prop="receiptType" width="95">
+              <template #default="scope">
+                <el-tag :type="receiptTypeTag(scope.row.receiptType)" size="small">
+                  {{ formatOption(receiptTypeOptions, scope.row.receiptType) }}
+                </el-tag>
+              </template>
+            </el-table-column>
+            <el-table-column label="原币金额" align="center" width="130">
+              <template #default="scope">
+                <span>{{ scope.row.currency }} {{ formatMoney(scope.row.amount) }}</span>
+              </template>
+            </el-table-column>
+            <el-table-column label="汇率" align="center" width="90">
+              <template #default="scope">{{ formatRate(scope.row.exchangeRate) }}</template>
+            </el-table-column>
+            <el-table-column label="本位币金额(CNY)" align="center" width="140">
+              <template #default="scope"><span class="money-in">{{ formatMoney(scope.row.baseAmount) }}</span></template>
+            </el-table-column>
+            <el-table-column label="收款方式" align="center" prop="payMethod" width="100">
+              <template #default="scope">{{ formatOption(payMethodOptions, scope.row.payMethod) }}</template>
+            </el-table-column>
+            <el-table-column label="流水号" align="center" prop="bankTransactionNo" width="150" show-overflow-tooltip />
+            <el-table-column label="状态" align="center" prop="status" width="90">
+              <template #default="scope">
+                <el-tag :type="receiptStatusTag(scope.row.status)" size="small">
+                  {{ formatOption(receiptStatusOptions, scope.row.status) }}
+                </el-tag>
+              </template>
+            </el-table-column>
+            <el-table-column label="登记人" align="center" prop="createBy" width="95" />
+            <el-table-column label="操作" align="center" width="200" fixed="right">
+              <template #default="scope">
+                <el-button v-if="scope.row.status === 'PENDING'" link type="success" size="small"
+                  v-hasPermi="['ar:receipt:review']" @click="handleConfirmReceipt(scope.row)">审核通过</el-button>
+                <el-button v-if="scope.row.status === 'PENDING'" link type="warning" size="small"
+                  v-hasPermi="['ar:receipt:edit']" @click="handleCancelReceipt(scope.row)">取消</el-button>
+                <el-button link type="primary" size="small"
+                  v-hasPermi="['ar:receipt:query']" @click="handleViewReceipt(scope.row)">查看</el-button>
+              </template>
+            </el-table-column>
+          </el-table>
+
+          <pagination
+            v-show="receiptTotal > 0"
+            :total="receiptTotal"
+            v-model:page="receiptQuery.pageNum"
+            v-model:limit="receiptQuery.pageSize"
+            @pagination="getReceiptList"
+          />
+        </el-tab-pane>
+
+        <!-- ====================== 账单核销 ====================== -->
+        <el-tab-pane label="账单核销" name="writeoff">
+          <div class="wo-section-title">账单查询与核销</div>
+          <el-form :model="billQuery" :inline="true" class="search-form">
+            <el-form-item label="客户">
+              <customer-select
+                v-model="billQuery.customerId"
+                placeholder="客户名称/代码搜索"
+                :page-size="1000"
+                style="width: 220px;"
+              />
+            </el-form-item>
+            <el-form-item label="账单号">
+              <el-input v-model="billQuery.billNo" placeholder="账单号" clearable style="width: 170px;" @keyup.enter="getBillList" />
+            </el-form-item>
+            <el-form-item label="状态">
+              <el-select v-model="billQuery.status" placeholder="全部状态" clearable style="width: 130px;">
+                <el-option v-for="opt in AR_BILL_STATUS_OPTIONS" :key="opt.value" :label="opt.label" :value="opt.value" />
+              </el-select>
+            </el-form-item>
+            <el-form-item label="账单日期">
+              <el-date-picker
+                v-model="billDateRange"
+                value-format="YYYY-MM-DD"
+                type="daterange"
+                range-separator="-"
+                start-placeholder="开始日期"
+                end-placeholder="结束日期"
+              />
+            </el-form-item>
+            <el-form-item>
+              <el-button type="primary" icon="Search" @click="getBillList">搜索</el-button>
+              <el-button icon="Refresh" @click="resetBillQuery">重置</el-button>
+            </el-form-item>
+          </el-form>
+
+          <el-table :data="billList" border size="small" v-loading="billLoading">
+            <el-table-column label="账单号" align="center" prop="billNo" width="170" show-overflow-tooltip />
+            <el-table-column label="账单名称" align="center" prop="billName" min-width="150" show-overflow-tooltip />
+            <el-table-column label="客户" align="center" min-width="170" show-overflow-tooltip>
+              <template #default="scope">
+                <div>{{ scope.row.customerName || '-' }}</div>
+                <div class="cell-sub">{{ scope.row.customerCode }}</div>
+              </template>
+            </el-table-column>
+            <el-table-column label="账单日期" align="center" prop="billDate" width="105">
+              <template #default="scope">{{ formatDate(scope.row.billDate) }}</template>
+            </el-table-column>
+            <el-table-column label="应收金额" align="center" width="120">
+              <template #default="scope">{{ scope.row.currency }} {{ formatMoney(scope.row.totalAmount) }}</template>
+            </el-table-column>
+            <el-table-column label="已核销" align="center" width="110">
+              <template #default="scope"><span class="money-in">{{ formatMoney(scope.row.writtenOffAmount) }}</span></template>
+            </el-table-column>
+            <el-table-column label="未核销" align="center" width="110">
+              <template #default="scope"><span class="money-out">{{ formatMoney(scope.row.unwrittenAmount) }}</span></template>
+            </el-table-column>
+            <el-table-column label="状态" align="center" width="100">
+              <template #default="scope">
+                <el-tag :type="AR_BILL_STATUS_TYPES[scope.row.status] || 'info'" size="small">
+                  {{ billStatusLabel(scope.row.status) }}
+                </el-tag>
+              </template>
+            </el-table-column>
+            <el-table-column label="操作" align="center" width="90" fixed="right">
+              <template #default="scope">
+                <el-button v-if="canWriteoffBill(scope.row)" link type="primary" size="small"
+                  v-hasPermi="['ar:receipt:writeoff']" @click="openWriteoffDialog(scope.row)">核销</el-button>
+                <span v-else>-</span>
+              </template>
+            </el-table-column>
+            <template #empty>
+              <el-empty description="暂无账单" :image-size="70" />
+            </template>
+          </el-table>
+          <pagination
+            v-show="billTotal > 0"
+            :total="billTotal"
+            v-model:page="billQuery.pageNum"
+            v-model:limit="billQuery.pageSize"
+            @pagination="getBillList"
+          />
+
+          <div class="wo-section-title" style="margin-top: 18px;">核销记录</div>
+          <el-form :model="woQuery" :inline="true" class="search-form">
+            <el-form-item label="客户">
+              <customer-select
+                v-model="woQuery.customerId"
+                placeholder="客户名称/代码搜索"
+                :page-size="1000"
+                style="width: 220px;"
+              />
+            </el-form-item>
+            <el-form-item label="账单号">
+              <el-input v-model="woQuery.billNo" placeholder="账单号" clearable style="width: 160px;" @keyup.enter="getWriteoffList" />
+            </el-form-item>
+            <el-form-item label="状态">
+              <el-select v-model="woQuery.status" placeholder="全部" clearable style="width: 120px;">
+                <el-option v-for="item in AR_BALANCE_WRITEOFF_STATUS_OPTIONS" :key="item.value" :label="item.label" :value="item.value" />
+              </el-select>
+            </el-form-item>
+            <el-form-item label="核销日期">
+              <el-date-picker
+                v-model="woDateRange"
+                value-format="YYYY-MM-DD"
+                type="daterange"
+                range-separator="-"
+                start-placeholder="开始日期"
+                end-placeholder="结束日期"
+              />
+            </el-form-item>
+            <el-form-item>
+              <el-button type="primary" icon="Search" @click="getWriteoffList">搜索</el-button>
+              <el-button icon="Refresh" @click="resetWriteoffQuery">重置</el-button>
+            </el-form-item>
+          </el-form>
+          <el-table :data="writeoffList" border size="small" v-loading="writeoffLoading">
+            <el-table-column label="核销单号" align="center" width="190">
+              <template #default="scope">
+                <div>{{ scope.row.writeoffNo }}</div>
+                <el-tag v-if="scope.row.receiptId" type="primary" size="small" effect="plain" style="margin-top: 2px;">收款联动</el-tag>
+              </template>
+            </el-table-column>
+            <el-table-column label="账单号" align="center" prop="billNo" width="170" show-overflow-tooltip />
+            <el-table-column label="账单名称" align="center" prop="billName" min-width="140" show-overflow-tooltip />
+            <el-table-column label="客户" align="center" min-width="150" show-overflow-tooltip>
+              <template #default="scope">{{ scope.row.customerName || '-' }}</template>
+            </el-table-column>
+            <el-table-column label="核销金额" align="center" width="120">
+              <template #default="scope">
+                <span class="money-out">-{{ formatMoney(scope.row.writeoffAmount) }} {{ scope.row.currency }}</span>
+              </template>
+            </el-table-column>
+            <el-table-column label="核销日期" align="center" prop="writeoffDate" width="105">
+              <template #default="scope">{{ formatDate(scope.row.writeoffDate) }}</template>
+            </el-table-column>
+            <el-table-column label="状态" align="center" width="90">
+              <template #default="scope">
+                <el-tag :type="AR_BALANCE_WRITEOFF_STATUS_TYPES[scope.row.status] || 'info'" size="small">
+                  {{ formatOption(AR_BALANCE_WRITEOFF_STATUS_OPTIONS, scope.row.status) }}
+                </el-tag>
+              </template>
+            </el-table-column>
+            <el-table-column label="备注" align="center" prop="remark" min-width="130" show-overflow-tooltip />
+            <el-table-column label="登记人" align="center" prop="createBy" width="90" />
+            <el-table-column label="登记时间" align="center" prop="createTime" width="140">
+              <template #default="scope">{{ formatDateTime(scope.row.createTime) }}</template>
+            </el-table-column>
+            <el-table-column label="反核销原因" align="center" prop="cancelRemark" min-width="120" show-overflow-tooltip />
+            <el-table-column label="操作" align="center" width="90" fixed="right">
+              <template #default="scope">
+                <el-button v-if="scope.row.status === AR_BALANCE_WRITEOFF_STATUS.EFFECTIVE" link type="warning" size="small"
+                  v-hasPermi="['ar:receipt:writeoff:cancel']" @click="openCancelWriteoffDialog(scope.row)">反核销</el-button>
+                <span v-else>-</span>
+              </template>
+            </el-table-column>
+          </el-table>
+          <pagination
+            v-show="writeoffTotal > 0"
+            :total="writeoffTotal"
+            v-model:page="woQuery.pageNum"
+            v-model:limit="woQuery.pageSize"
+            @pagination="getWriteoffList"
+          />
+        </el-tab-pane>
+      </el-tabs>
+    </el-card>
+
+    <!-- ====================== 登记收款弹窗 ====================== -->
+    <el-dialog title="登记收款" v-model="receiptDialog.visible" width="780px" append-to-body @closed="onReceiptDialogClosed">
+      <el-form ref="receiptFormRef" :model="receiptDialog.form" :rules="receiptRules" label-width="110px">
+        <el-row>
+          <el-col :span="12">
+            <el-form-item label="客户" prop="customerId">
+              <customer-select
+                v-model="receiptDialog.form.customerId"
+                placeholder="请选择客户（必选）"
+                :page-size="1000"
+                @change="handleReceiptCustomerChange"
+              />
+            </el-form-item>
+          </el-col>
+          <el-col :span="12">
+            <el-form-item label="收款时间" prop="receivedAt">
+              <el-date-picker
+                v-model="receiptDialog.form.receivedAt"
+                type="datetime"
+                value-format="YYYY-MM-DD HH:mm:ss"
+                placeholder="选择收款日期时间"
+                style="width: 100%;"
+              />
+            </el-form-item>
+          </el-col>
+          <el-col :span="12">
+            <el-form-item label="收款金额" prop="amount">
+              <el-input v-model="receiptDialog.form.amount" placeholder="请输入原币金额" type="number">
+                <template #prepend>{{ receiptDialog.form.currency || 'CNY' }}</template>
+              </el-input>
+            </el-form-item>
+          </el-col>
+          <el-col :span="12">
+            <el-form-item label="收款类型" prop="receiptType">
+              <el-select v-model="receiptDialog.form.receiptType" placeholder="请选择" style="width: 100%;">
+                <el-option v-for="opt in receiptTypeOptions" :key="opt.value" :label="opt.label" :value="opt.value" />
+              </el-select>
+            </el-form-item>
+          </el-col>
+          <el-col :span="12">
+            <el-form-item label="币种" prop="currency">
+              <el-select v-model="receiptDialog.form.currency" placeholder="请选择" style="width: 100%;" @change="handleCurrencyChange">
+                <el-option v-for="c in currencyOptions" :key="c.value" :label="c.label" :value="c.value" />
+              </el-select>
+            </el-form-item>
+          </el-col>
+          <el-col :span="12">
+            <el-form-item label="汇率" prop="exchangeRate">
+              <el-input-number
+                v-model="receiptDialog.form.exchangeRate"
+                :precision="8"
+                :step="0.0001"
+                :min="0"
+                :disabled="receiptDialog.form.currency === 'CNY'"
+                controls-position="right"
+                style="width: 100%;"
+                @input="handleRateInput"
+              />
+              <div class="rate-tip">
+                1 {{ receiptDialog.form.currency || 'CNY' }} = {{ formatRate(receiptDialog.form.exchangeRate) }} CNY
+                <el-tag v-if="receiptDialog.form.currency === 'CNY'" size="small" type="info" effect="plain" style="margin-left: 6px;">系统默认</el-tag>
+                <el-tag v-else-if="rateEdited" size="small" type="warning" effect="dark" style="margin-left: 6px;">手工修改</el-tag>
+                <el-tag v-else-if="receiptDialog.form.exchangeRate" size="small" type="success" effect="plain" style="margin-left: 6px;">汇率表{{ rateSourceInfo.source ? '·' + rateSourceInfo.source : '' }}</el-tag>
+                <span v-else style="color: var(--el-color-warning);"> 汇率表未配置，请手工录入</span>
+                <span v-if="receiptDialog.form.currency !== 'CNY'">，默认取汇率表，可手工修改</span>
+              </div>
+            </el-form-item>
+          </el-col>
+          <el-col :span="12">
+            <el-form-item label="本位币金额">
+              <el-input :model-value="'CNY ' + baseAmountPreview" disabled>
+                <template #prepend>≈</template>
+              </el-input>
+            </el-form-item>
+          </el-col>
+          <el-col :span="12">
+            <el-form-item label="收款方式" prop="payMethod">
+              <el-select v-model="receiptDialog.form.payMethod" placeholder="请选择" style="width: 100%;" clearable>
+                <el-option v-for="opt in payMethodOptions" :key="opt.value" :label="opt.label" :value="opt.value" />
+              </el-select>
+            </el-form-item>
+          </el-col>
+          <el-col :span="12">
+            <el-form-item label="客户银行账号" prop="bankAccountNo">
+              <el-input v-model="receiptDialog.form.bankAccountNo" placeholder="客户付款银行账号（选填）" maxlength="64" clearable />
+            </el-form-item>
+          </el-col>
+          <el-col :span="12">
+            <el-form-item label="流水号" prop="bankTransactionNo">
+              <el-input v-model="receiptDialog.form.bankTransactionNo" placeholder="银行/支付平台流水号" />
+            </el-form-item>
+          </el-col>
+          <el-col :span="24">
+            <el-form-item label="备注" prop="remark">
+              <el-input v-model="receiptDialog.form.remark" type="textarea" :rows="2" placeholder="请输入备注" />
+            </el-form-item>
+          </el-col>
+          <el-col :span="24">
+            <el-form-item label="核销账单">
+              <div class="receipt-wo-toolbar">
+                <el-button type="primary" plain icon="Plus" @click="openBillPicker">选择账单核销</el-button>
+                <span class="receipt-wo-summary">
+                  本次核销合计：<b class="money-out">{{ formatMoney(receiptWriteoffTotal) }} CNY</b>
+                  ，收款折算本位币：<b>{{ formatMoney(receiptBaseCny) }} CNY</b>
+                </span>
+              </div>
+              <el-table :data="receiptDialog.form.writeoffPlans" border size="small" max-height="220">
+                <el-table-column label="账单号" prop="billNo" align="center" width="170" show-overflow-tooltip />
+                <el-table-column label="账单名称" prop="billName" align="center" min-width="150" show-overflow-tooltip />
+                <el-table-column label="未核销金额" align="center" width="120">
+                  <template #default="scope">{{ formatMoney(scope.row.unwrittenAmount) }} {{ scope.row.currency }}</template>
+                </el-table-column>
+                <el-table-column label="本次核销金额(CNY)" align="center" width="160">
+                  <template #default="scope">
+                    <el-input-number
+                      v-model="scope.row.writeoffAmount"
+                      :min="0"
+                      :max="Number(scope.row.unwrittenAmount)"
+                      :precision="2"
+                      :step="1"
+                      :controls="false"
+                      size="small"
+                      style="width: 130px;"
+                    />
+                  </template>
+                </el-table-column>
+                <el-table-column label="操作" align="center" width="70">
+                  <template #default="scope">
+                    <el-button link type="danger" icon="Delete" @click="removeReceiptBill(scope.$index)" />
+                  </template>
+                </el-table-column>
+                <template #empty>
+                  <span style="color: var(--el-text-color-secondary);">不选账单则整笔计入客户余额，可在“账单核销”页手工核销</span>
+                </template>
+              </el-table>
+              <div class="upload-tip">
+                当前仅支持<strong>人民币（CNY）账单</strong>核销；所选账单在收款单<strong>审核通过</strong>后一并核销，
+                核销合计不能超过收款金额按汇率折算的本位币金额（{{ formatMoney(receiptBaseCny) }} CNY）；
+                <strong>核销不扣减客户余额</strong>，正常计入客户余额。
+              </div>
+            </el-form-item>
+          </el-col>
+          <el-col :span="24">
+            <el-form-item label="收款凭证">
+              <el-upload
+                drag
+                class="receipt-upload"
+                :show-file-list="false"
+                :action="uploadFileUrl"
+                :headers="uploadHeaders"
+                :before-upload="handleBeforeUpload"
+                :on-success="handleUploadSuccess"
+                :on-error="handleUploadError"
+                multiple
+              >
+                <el-icon class="el-icon--upload"><upload-filled /></el-icon>
+                <div class="el-upload__text">将文件拖到此处，或<em>点击选择</em>（支持一次拖入多个文件）</div>
+              </el-upload>
+              <el-table :data="receiptDialog.form.attachmentList" border size="small" max-height="220">
+                <el-table-column label="序号" type="index" width="55" align="center" />
+                <el-table-column label="文件名称" prop="fileName" align="center" show-overflow-tooltip min-width="180" />
+                <el-table-column label="大小" align="center" width="100">
+                  <template #default="scope">{{ formatFileSize(scope.row.fileSize) }}</template>
+                </el-table-column>
+                <el-table-column label="类型" prop="fileExtension" align="center" width="80" />
+                <el-table-column label="操作" align="center" width="80">
+                  <template #default="scope">
+                    <el-button link type="danger" icon="Delete" @click="handleRemoveUpload(scope.$index)" />
+                    <el-button link type="primary" icon="Download" @click="handleDownload(scope.row)">下载</el-button>
+                  </template>
+                </el-table-column>
+              </el-table>
+              <div class="upload-tip">支持 PDF/图片/Office/压缩包，单个不超过 50MB</div>
+            </el-form-item>
+          </el-col>
+        </el-row>
+      </el-form>
+      <template #footer>
+        <el-button type="primary" :loading="submitLoading" @click="submitReceipt">确 定</el-button>
+        <el-button @click="receiptDialog.visible = false">取 消</el-button>
+      </template>
+    </el-dialog>
+
+    <!-- ====================== 选择核销账单弹窗 ====================== -->
+    <el-dialog title="选择待核销账单" v-model="billPicker.visible" width="860px" append-to-body>
+      <el-alert type="info" :closable="false" class="writeoff-summary">
+        当前仅支持人民币（CNY）账单核销，以下为状态已确认/部分核销的 CNY 账单；
+        已选 {{ billPicker.selected.length }} 张，合计未核销
+        <b class="money-out">{{ formatMoney(billPickerSelectedTotal) }} CNY</b>，
+        本收款单折算可核销上限 <b>{{ formatMoney(receiptBaseCny) }} CNY</b>
+      </el-alert>
+      <el-table
+        ref="billPickerTableRef"
+        :data="billPicker.rows"
+        border
+        size="small"
+        max-height="380"
+        row-key="arBillId"
+        v-loading="billPicker.loading"
+        @selection-change="onPickerSelectionChange"
+      >
+        <el-table-column type="selection" width="42" align="center" reserve-selection />
+        <el-table-column label="账单号" prop="billNo" align="center" width="160" show-overflow-tooltip />
+        <el-table-column label="账单名称" prop="billName" align="center" min-width="150" show-overflow-tooltip />
+        <el-table-column label="账单日期" prop="billDate" align="center" width="105">
+          <template #default="scope">{{ formatDate(scope.row.billDate) }}</template>
+        </el-table-column>
+        <el-table-column label="应收金额" align="center" width="110">
+          <template #default="scope">{{ formatMoney(scope.row.totalAmount) }} {{ scope.row.currency }}</template>
+        </el-table-column>
+        <el-table-column label="已核销" align="center" width="100">
+          <template #default="scope"><span class="money-in">{{ formatMoney(scope.row.writtenOffAmount) }}</span></template>
+        </el-table-column>
+        <el-table-column label="未核销" align="center" width="100">
+          <template #default="scope"><span class="money-out">{{ formatMoney(scope.row.unwrittenAmount) }}</span></template>
+        </el-table-column>
+        <template #empty>
+          <el-empty description="该客户暂无可核销账单" :image-size="70" />
+        </template>
+      </el-table>
+      <template #footer>
+        <el-button type="primary" @click="confirmBillPicker">确 定（{{ billPicker.selected.length }}）</el-button>
+        <el-button @click="billPicker.visible = false">取 消</el-button>
+      </template>
+    </el-dialog>
+
+    <!-- ====================== 收款单详情弹窗 ====================== -->
+    <el-dialog title="收款单详情" v-model="viewDialog.visible" width="720px" append-to-body>
+      <el-descriptions :column="2" border v-if="viewDialog.data" size="small">
+        <el-descriptions-item label="收款单号">{{ viewDialog.data.receiptNo }}</el-descriptions-item>
+        <el-descriptions-item label="状态">
+          <el-tag :type="receiptStatusTag(viewDialog.data.status)">{{ formatOption(receiptStatusOptions, viewDialog.data.status) }}</el-tag>
+        </el-descriptions-item>
+        <el-descriptions-item label="客户">{{ viewDialog.data.customerName || '-' }}</el-descriptions-item>
+        <el-descriptions-item label="收款时间">{{ formatDateTime(viewDialog.data.receivedAt) }}</el-descriptions-item>
+        <el-descriptions-item label="收款类型">
+          <el-tag :type="receiptTypeTag(viewDialog.data.receiptType)">{{ formatOption(receiptTypeOptions, viewDialog.data.receiptType) }}</el-tag>
+        </el-descriptions-item>
+        <el-descriptions-item label="原币金额">
+          <span class="money-in">{{ viewDialog.data.currency }} {{ formatMoney(viewDialog.data.amount) }}</span>
+        </el-descriptions-item>
+        <el-descriptions-item label="对CNY汇率">{{ formatRate(viewDialog.data.exchangeRate) }}</el-descriptions-item>
+        <el-descriptions-item label="汇率来源">
+          <el-tag :type="receiptRateSourceTag(viewDialog.data.rateSource)" size="small">
+            {{ receiptRateSourceLabel(viewDialog.data.rateSource) }}
+          </el-tag>
+          <span v-if="viewDialog.data.rateSourceDesc" style="margin-left: 8px; color: var(--el-text-color-secondary);">
+            {{ viewDialog.data.rateSourceDesc }}
+          </span>
+        </el-descriptions-item>
+        <el-descriptions-item label="本位币金额">
+          <span class="money-in">CNY {{ formatMoney(viewDialog.data.baseAmount) }}</span>
+        </el-descriptions-item>
+        <el-descriptions-item label="待核销金额">CNY {{ formatMoney(viewDialog.data.unallocatedAmount) }}</el-descriptions-item>
+        <el-descriptions-item label="收款方式">{{ formatOption(payMethodOptions, viewDialog.data.payMethod) }}</el-descriptions-item>
+        <el-descriptions-item label="客户银行账号">
+          <span v-if="viewDialog.data.bankAccountNo">
+            {{ viewDialog.data.bankName ? viewDialog.data.bankName + ' ' : '' }}{{ viewDialog.data.bankAccountNo }}
+            <span v-if="viewDialog.data.bankAccountName">（{{ viewDialog.data.bankAccountName }}）</span>
+          </span>
+          <span v-else>-</span>
+        </el-descriptions-item>
+        <el-descriptions-item label="银行流水号">{{ viewDialog.data.bankTransactionNo || '-' }}</el-descriptions-item>
+        <el-descriptions-item label="确认时间">{{ formatDateTime(viewDialog.data.confirmedAt) }}</el-descriptions-item>
+        <el-descriptions-item label="登记人">{{ viewDialog.data.createBy || '-' }}</el-descriptions-item>
+        <el-descriptions-item label="备注" :span="2">{{ viewDialog.data.remark || '-' }}</el-descriptions-item>
+      </el-descriptions>
+
+      <template v-if="viewDialog.data && viewDialog.data.writeoffPlans && viewDialog.data.writeoffPlans.length">
+        <div class="attach-title">关联核销账单（{{ viewDialog.data.writeoffPlans.length }}）</div>
+        <el-table :data="viewDialog.data.writeoffPlans" border size="small" max-height="220" style="margin-bottom: 12px;">
+          <el-table-column label="账单号" prop="billNo" align="center" width="170" show-overflow-tooltip />
+          <el-table-column label="账单名称" prop="billName" align="center" min-width="150" show-overflow-tooltip />
+          <el-table-column label="本次核销金额" align="center" width="140">
+            <template #default="scope">{{ formatMoney(scope.row.writeoffAmount) }} {{ scope.row.currency }}</template>
+          </el-table-column>
+          <el-table-column label="状态" align="center" width="100">
+            <template #default="scope">
+              <el-tag :type="receiptPlanStatusTag(scope.row.status)" size="small">
+                {{ receiptPlanStatusLabel(scope.row.status) }}
+              </el-tag>
+            </template>
+          </el-table-column>
+          <el-table-column label="核销日期" align="center" width="110">
+            <template #default="scope">{{ scope.row.writeoffDate ? formatDate(scope.row.writeoffDate) : '-' }}</template>
+          </el-table-column>
+        </el-table>
+      </template>
+
+      <div class="attach-title">收款凭证附件</div>
+      <el-table :data="viewDialog.attachments" border size="small" max-height="240" v-loading="viewDialog.loading">
+        <el-table-column label="序号" type="index" width="55" align="center" />
+        <el-table-column label="文件名称" prop="fileName" align="center" show-overflow-tooltip min-width="200">
+          <template #default="scope">
+            <el-button link type="primary" @click="handleDownload(scope.row)">{{ scope.row.fileName }}</el-button>
+          </template>
+        </el-table-column>
+        <el-table-column label="大小" align="center" width="100">
+          <template #default="scope">{{ formatFileSize(scope.row.fileSize) }}</template>
+        </el-table-column>
+        <el-table-column label="类型" prop="fileExtension" align="center" width="80" />
+        <el-table-column label="上传人" align="center" prop="createBy" width="100" />
+        <el-table-column label="操作" align="center" width="100">
+          <template #default="scope">
+            <el-button link type="primary" icon="Download" @click="handleDownload(scope.row)">下载</el-button>
+          </template>
+        </el-table-column>
+        <template #empty>
+          <el-empty description="暂无收款凭证附件" :image-size="70" />
+        </template>
+      </el-table>
+
+      <template #footer>
+        <el-button
+          v-if="viewDialog.data && viewDialog.data.status === 'PENDING'"
+          type="success"
+          v-hasPermi="['ar:receipt:review']"
+          @click="handleConfirmFromView"
+        >审核通过</el-button>
+        <el-button @click="viewDialog.visible = false">关 闭</el-button>
+      </template>
+    </el-dialog>
+
+    <!-- ====================== 账单核销弹窗 ====================== -->
+    <el-dialog title="账单核销" v-model="woDialog.visible" width="560px" append-to-body>
+      <el-descriptions :column="1" border size="small" v-if="woDialog.bill">
+        <el-descriptions-item label="客户">{{ woDialog.bill.customerName || '-' }}</el-descriptions-item>
+        <el-descriptions-item label="账单号">{{ woDialog.bill.billNo }}</el-descriptions-item>
+        <el-descriptions-item label="账单名称">{{ woDialog.bill.billName || '-' }}</el-descriptions-item>
+        <el-descriptions-item label="账单未核销金额">
+          <span class="money-out">CNY {{ formatMoney(woDialog.bill.unwrittenAmount) }}</span>
+        </el-descriptions-item>
+      </el-descriptions>
+      <el-form :model="woDialog.form" label-width="110px" class="wo-form">
+        <el-form-item label="本次核销金额" required>
+          <el-input v-model="woDialog.form.writeoffAmount" inputmode="decimal" clearable style="width: 220px;" placeholder="请输入核销金额" />
+          <span class="wo-form-unit">CNY</span>
+        </el-form-item>
+        <el-form-item label="核销日期">
+          <el-date-picker v-model="woDialog.form.writeoffDate" type="date" value-format="YYYY-MM-DD" placeholder="默认今天" style="width: 220px;" />
+        </el-form-item>
+        <el-form-item label="备注">
+          <el-input v-model="woDialog.form.remark" type="textarea" :rows="2" maxlength="255" show-word-limit placeholder="选填，最多255字" />
+        </el-form-item>
+      </el-form>
+      <el-alert type="info" :closable="false">
+        <template title>核销仅更新账单已核销/未核销金额与状态，不扣减账户余额；资金变动由收款/计费入口产生。</template>
+      </el-alert>
+      <template #footer>
+        <el-button type="primary" :loading="woSubmitLoading" @click="submitWriteoff">确认核销</el-button>
+        <el-button @click="woDialog.visible = false">取 消</el-button>
+      </template>
+    </el-dialog>
+
+    <!-- ====================== 反核销弹窗 ====================== -->
+    <el-dialog title="反核销（取消核销）" v-model="cancelWoDialog.visible" width="480px" append-to-body>
+      <el-alert type="warning" :closable="false">
+        <span v-if="cancelWoDialog.row">
+          反核销后，账单「{{ cancelWoDialog.row.billNo }}」恢复为未核销状态（核销金额 CNY {{ formatMoney(cancelWoDialog.row.writeoffAmount) }}）；
+          不回补账户余额、不变动已用额度。
+          <template v-if="cancelWoDialog.row.receiptId">
+            <br />该核销由收款单审核<strong>联动产生</strong>，反核销后收款单中本笔将回到“未分配”金额，可重新核销其他账单，已入账余额不受影响。
+          </template>
+        </span>
+      </el-alert>
+      <el-form label-width="100px" class="wo-form">
+        <el-form-item label="反核销原因" required>
+          <el-input v-model="cancelWoDialog.cancelRemark" type="textarea" :rows="3" maxlength="255" show-word-limit placeholder="请填写反核销原因（必填）" />
+        </el-form-item>
+      </el-form>
+      <template #footer>
+        <el-button type="warning" :loading="cancelWoLoading" @click="submitCancelWriteoff">确认反核销</el-button>
+        <el-button @click="cancelWoDialog.visible = false">取 消</el-button>
+      </template>
+    </el-dialog>
+  </div>
+</template>
+
+<script setup name="ArReceipt">
+import axios from 'axios'
+import { saveAs } from 'file-saver'
+import {
+  listReceipt, getReceipt, addReceipt, confirmReceipt, cancelReceipt,
+  listUnsettledBill, listReceiptWriteoff, receiptWriteoff, cancelReceiptWriteoff
+} from '@/api/ar/receipt'
+import { listArBill } from '@/api/ar/bill'
+import { convertToBase } from '@/api/data/exchangeRate'
+import { getToken } from '@/utils/auth'
+import {
+  AR_BILL_STATUS, AR_BILL_STATUS_OPTIONS, AR_BILL_STATUS_TYPES,
+  AR_BALANCE_WRITEOFF_STATUS, AR_BALANCE_WRITEOFF_STATUS_OPTIONS,
+  AR_BALANCE_WRITEOFF_STATUS_TYPES, arEnumLabel
+} from '@/constants/ar/enums'
+
+const { proxy } = getCurrentInstance()
+const baseUrl = import.meta.env.VITE_APP_BASE_API
+
+const activeTab = ref('receipt')
+
+/* ================= 枚举与格式化 ================= */
+const receiptTypeOptions = [
+  { value: 'PREPAY', label: '预充值' },
+  { value: 'REPAY', label: '还款核销' },
+  { value: 'MIXED', label: '混合' }
+]
+const receiptStatusOptions = [
+  { value: 'PENDING', label: '待确认' },
+  { value: 'CONFIRMED', label: '已确认' },
+  { value: 'CANCELLED', label: '已取消' }
+]
+const payMethodOptions = [
+  { value: 'BANK_TRANSFER', label: '银行转账' },
+  { value: 'ALIPAY', label: '支付宝' },
+  { value: 'WECHAT', label: '微信' },
+  { value: 'CASH', label: '现金' },
+  { value: 'OTHER', label: '其他' }
+]
+const currencyOptions = [
+  { value: 'CNY', label: '人民币 CNY' },
+  { value: 'USD', label: '美元 USD' },
+  { value: 'EUR', label: '欧元 EUR' },
+  { value: 'GBP', label: '英镑 GBP' },
+  { value: 'HKD', label: '港币 HKD' },
+  { value: 'JPY', label: '日元 JPY' }
+]
+
+function formatOption(options, value) {
+  if (value === null || value === undefined || value === '') return '-'
+  const opt = options.find(o => String(o.value) === String(value))
+  return opt ? opt.label : value
+}
+function receiptTypeTag(v) {
+  return { PREPAY: '', REPAY: 'warning', MIXED: 'info' }[v] || 'info'
+}
+function receiptStatusTag(v) {
+  return { PENDING: 'warning', CONFIRMED: 'success', CANCELLED: 'danger' }[v] || 'info'
+}
+function receiptRateSourceLabel(v) {
+  return { RATE_TABLE: '汇率表', MANUAL: '手工修改', SYSTEM: '系统默认' }[v] || '系统默认'
+}
+function receiptRateSourceTag(v) {
+  return { RATE_TABLE: 'success', MANUAL: 'warning', SYSTEM: 'info' }[v] || 'info'
+}
+function formatMoney(val) {
+  const num = Number(val)
+  return isNaN(num) ? '0.00' : num.toFixed(2)
+}
+function formatRate(val) {
+  if (val === null || val === undefined || val === '') return '1'
+  const num = Number(val)
+  return isNaN(num) ? String(val) : String(num)
+}
+function formatDateTime(val) {
+  if (!val) return '-'
+  // 精确到秒：yyyy-MM-dd HH:mm:ss
+  return String(val).length > 19 ? String(val).substring(0, 19) : val
+}
+function formatDate(val) {
+  if (!val) return '-'
+  return String(val).substring(0, 10)
+}
+function billStatusLabel(v) {
+  return arEnumLabel(AR_BILL_STATUS_OPTIONS, v)
+}
+
+/* ================= 收款记录列表 ================= */
+function todayStr() {
+  return proxy.parseTime(new Date(), '{y}-{m}-{d}')
+}
+/** 收款时间精确到时分秒，默认查询当天 00:00:00 ~ 23:59:59 */
+function todayStartTime() {
+  return proxy.parseTime(new Date(), '{y}-{m}-{d}') + ' 00:00:00'
+}
+function todayEndTime() {
+  return proxy.parseTime(new Date(), '{y}-{m}-{d}') + ' 23:59:59'
+}
+function todayTimeRange() {
+  return [todayStartTime(), todayEndTime()]
+}
+// 日期时间范围面板内只选日期时，开始/结束默认补齐的时分秒
+const defaultTimeRange = [
+  new Date(2000, 0, 1, 0, 0, 0),
+  new Date(2000, 0, 1, 23, 59, 59)
+]
+
+const receiptList = ref([])
+const receiptTotal = ref(0)
+const receiptLoading = ref(false)
+const receiptDateRange = ref(todayTimeRange())
+const receiptQuery = reactive({
+  pageNum: 1,
+  pageSize: 10,
+  customerId: '',
+  receiptNo: '',
+  receiptType: '',
+  status: ''
+})
+const selectedReceipts = ref([])
+
+function onReceiptSelectionChange(rows) {
+  selectedReceipts.value = rows || []
+}
+
+/** 选中收款的本位币总额（CNY） */
+const selectedCnyTotal = computed(() => {
+  const sum = selectedReceipts.value.reduce((s, r) => s + (Number(r.baseAmount) || 0), 0)
+  return formatMoney(sum)
+})
+/** 选中收款按原币币种分组的合计 */
+const selectedCurrencyText = computed(() => {
+  const map = new Map()
+  selectedReceipts.value.forEach(r => {
+    const cur = r.currency || 'CNY'
+    map.set(cur, (map.get(cur) || 0) + (Number(r.amount) || 0))
+  })
+  return Array.from(map.entries()).map(([cur, amt]) => `${cur} ${formatMoney(amt)}`).join('，')
+})
+
+function getReceiptList() {
+  receiptLoading.value = true
+  receiptQuery.pageNum = receiptQuery.pageNum || 1
+  const params = proxy.addDateRange({ ...receiptQuery }, receiptDateRange.value)
+  listReceipt(params).then(res => {
+    receiptList.value = res.rows || []
+    receiptTotal.value = res.total || 0
+  }).finally(() => {
+    receiptLoading.value = false
+  })
+}
+
+function resetReceiptQuery() {
+  receiptQuery.customerId = ''
+  receiptQuery.receiptNo = ''
+  receiptQuery.receiptType = ''
+  receiptQuery.status = ''
+  receiptQuery.pageNum = 1
+  // 默认查询当天数据（00:00:00 ~ 23:59:59）
+  receiptDateRange.value = todayTimeRange()
+  getReceiptList()
+}
+
+/** 审核通过 */
+function handleConfirmReceipt(row) {
+  proxy.$modal.confirm(`是否确认审核通过收款单「${row.receiptNo}」？审核通过后金额计入客户余额，登记时选择的账单将一并核销。`).then(() => {
+    return confirmReceipt(row.id)
+  }).then(() => {
+    proxy.$modal.msgSuccess('审核通过，余额与账单核销已更新')
+    getReceiptList()
+    if (writeoffLoaded) {
+      getBillList()
+      getWriteoffList()
+    }
+  }).catch(() => {})
+}
+
+/** 取消收款单 */
+function handleCancelReceipt(row) {
+  proxy.$modal.confirm(`是否确认取消收款单「${row.receiptNo}」？取消后不可恢复。`).then(() => {
+    return cancelReceipt(row.id)
+  }).then(() => {
+    proxy.$modal.msgSuccess('已取消')
+    getReceiptList()
+  }).catch(() => {})
+}
+
+/* ================= 登记收款弹窗 ================= */
+const receiptFormRef = ref(null)
+const submitLoading = ref(false)
+const receiptDialog = reactive({ visible: false, form: {} })
+const receiptRules = {
+  customerId: [{ required: true, message: '请选择客户', trigger: 'change' }],
+  receivedAt: [{ required: true, message: '收款时间不能为空', trigger: 'change' }],
+  amount: [{ required: true, message: '收款金额不能为空', trigger: 'blur' }],
+  receiptType: [{ required: true, message: '请选择收款类型', trigger: 'change' }],
+  currency: [{ required: true, message: '请选择币种', trigger: 'change' }]
+}
+
+function resetReceiptForm() {
+  rateEdited.value = false
+  rateSourceInfo.value = { source: '', ratePath: '' }
+  receiptDialog.form = {
+    customerId: '',
+    receivedAt: proxy.parseTime(new Date(), '{y}-{m}-{d} {h}:{i}:{s}'),
+    amount: '',
+    receiptType: 'PREPAY',
+    currency: 'CNY',
+    exchangeRate: 1,
+    payMethod: 'BANK_TRANSFER',
+    bankAccountNo: '',
+    bankTransactionNo: '',
+    remark: '',
+    attachmentList: [],
+    writeoffPlans: []
+  }
+  proxy.resetForm('receiptFormRef')
+}
+
+function handleAddReceipt() {
+  resetReceiptForm()
+  receiptDialog.visible = true
+}
+
+/** 切换客户：核销账单归属于客户，已选账单需清空重选 */
+function handleReceiptCustomerChange() {
+  const plans = receiptDialog.form.writeoffPlans || []
+  if (plans.length) {
+    plans.splice(0, plans.length)
+  }
+}
+
+const rateEdited = ref(false)
+const rateSourceInfo = ref({ source: '', ratePath: '' })
+
+function fetchDefaultRate() {
+  const cur = receiptDialog.form.currency
+  if (!cur || cur === 'CNY') {
+    receiptDialog.form.exchangeRate = 1
+    rateSourceInfo.value = { source: '', ratePath: 'SAME' }
+    return
+  }
+  const bizDate = receiptDialog.form.receivedAt
+    ? String(receiptDialog.form.receivedAt).substring(0, 10)
+    : todayStr()
+  convertToBase({ amount: 1, currency: cur, rateType: '0', bizDate })
+    .then(res => {
+      if (!rateEdited.value) {
+        receiptDialog.form.exchangeRate = Number(res.data.rate)
+        rateSourceInfo.value = { source: res.data.source || '', ratePath: res.data.ratePath || 'DIRECT' }
+      }
+    })
+    .catch(() => {
+      if (!rateEdited.value) {
+        receiptDialog.form.exchangeRate = undefined
+        rateSourceInfo.value = { source: '', ratePath: '' }
+        proxy.$modal.msgWarning(`汇率表中未维护 ${cur} 对 CNY 的汇率，请手工录入汇率`)
+      }
+    })
+}
+
+function handleCurrencyChange() {
+  rateEdited.value = false
+  rateSourceInfo.value = { source: '', ratePath: '' }
+  fetchDefaultRate()
+}
+
+function handleRateInput() {
+  if (receiptDialog.form.currency !== 'CNY') rateEdited.value = true
+}
+
+const baseAmountPreview = computed(() => {
+  const amount = Number(receiptDialog.form.amount) || 0
+  const rate = Number(receiptDialog.form.exchangeRate) || 0
+  return formatMoney(amount * rate)
+})
+
+watch(() => receiptDialog.form.receivedAt, () => {
+  if (receiptDialog.visible && receiptDialog.form.currency !== 'CNY' && !rateEdited.value) {
+    fetchDefaultRate()
+  }
+})
+
+/* ============ 选择核销账单 ============ */
+const billPickerTableRef = ref(null)
+const billPicker = reactive({ visible: false, loading: false, rows: [], selected: [] })
+
+const receiptBaseCny = computed(() => {
+  const amt = Number(receiptDialog.form.amount) || 0
+  const rate = Number(receiptDialog.form.exchangeRate) || 0
+  return Math.round(amt * rate * 100) / 100
+})
+const receiptWriteoffTotal = computed(() => {
+  return (receiptDialog.form.writeoffPlans || []).reduce((s, r) => s + (Number(r.writeoffAmount) || 0), 0)
+})
+const billPickerSelectedTotal = computed(() => {
+  return billPicker.selected.reduce((s, r) => s + (Number(r.unwrittenAmount) || 0), 0)
+})
+
+const RECEIPT_PLAN_STATUS_MAP = {
+  PENDING: { label: '待核销', type: 'warning' },
+  EFFECTIVE: { label: '已核销', type: 'success' },
+  CANCELLED: { label: '已作废', type: 'info' },
+  REVERSED: { label: '已反核销', type: 'danger' }
+}
+function receiptPlanStatusLabel(s) {
+  return RECEIPT_PLAN_STATUS_MAP[s]?.label || s || '-'
+}
+function receiptPlanStatusTag(s) {
+  return RECEIPT_PLAN_STATUS_MAP[s]?.type || 'info'
+}
+
+function openBillPicker() {
+  const customerId = receiptDialog.form.customerId
+  if (!customerId) {
+    proxy.$modal.msgError('请先选择客户')
+    return
+  }
+  billPicker.visible = true
+  billPicker.loading = true
+  billPicker.rows = []
+  billPicker.selected = []
+  listUnsettledBill(customerId).then(res => {
+    billPicker.rows = (res.data || []).filter(r => (r.currency || 'CNY') === 'CNY')
+    nextTick(() => {
+      billPickerTableRef.value?.clearSelection()
+      const chosen = receiptDialog.form.writeoffPlans || []
+      billPicker.rows.forEach(r => {
+        if (chosen.some(p => p.arBillId === r.arBillId)) {
+          billPickerTableRef.value?.toggleRowSelection(r, true)
+        }
+      })
+    })
+  }).finally(() => {
+    billPicker.loading = false
+  })
+}
+
+function onPickerSelectionChange(rows) {
+  billPicker.selected = rows || []
+}
+
+function confirmBillPicker() {
+  const oldMap = new Map((receiptDialog.form.writeoffPlans || []).map(p => [p.arBillId, p]))
+  receiptDialog.form.writeoffPlans = billPicker.selected.map(r => {
+    const existed = oldMap.get(r.arBillId)
+    const unwritten = Number(r.unwrittenAmount) || 0
+    const usedByOthers = (receiptDialog.form.writeoffPlans || [])
+      .filter(p => p.arBillId !== r.arBillId)
+      .reduce((s, p) => s + (Number(p.writeoffAmount) || 0), 0)
+    const remainCny = Math.max(receiptBaseCny.value - usedByOthers, 0)
+    return {
+      arBillId: r.arBillId,
+      billNo: r.billNo,
+      billName: r.billName,
+      currency: 'CNY',
+      unwrittenAmount: unwritten,
+      writeoffAmount: existed ? Number(existed.writeoffAmount) : Math.round(Math.min(unwritten, remainCny) * 100) / 100
+    }
+  })
+  billPicker.visible = false
+}
+
+function removeReceiptBill(index) {
+  receiptDialog.form.writeoffPlans.splice(index, 1)
+}
+
+function validateReceiptWriteoffPlans() {
+  const cap = receiptBaseCny.value
+  const list = receiptDialog.form.writeoffPlans || []
+  let total = 0
+  for (const p of list) {
+    const amt = Number(p.writeoffAmount)
+    if (!amt || amt <= 0) {
+      proxy.$modal.msgError(`账单【${p.billNo}】本次核销金额必须大于0`)
+      return false
+    }
+    if (amt > Number(p.unwrittenAmount)) {
+      proxy.$modal.msgError(`账单【${p.billNo}】核销金额超过其未核销金额`)
+      return false
+    }
+    total += amt
+  }
+  if (Math.round(total * 100) > Math.round(cap * 100)) {
+    proxy.$modal.msgError(`核销金额合计 ${total.toFixed(2)} CNY 超过收款折算本位币金额 ${cap.toFixed(2)} CNY`)
+    return false
+  }
+  return true
+}
+
+function submitReceipt() {
+  receiptFormRef.value.validate(valid => {
+    if (!valid) return
+    const cur = receiptDialog.form.currency
+    const rate = Number(receiptDialog.form.exchangeRate)
+    if (cur !== 'CNY' && (!rate || rate <= 0)) {
+      proxy.$modal.msgError(`请录入 ${cur} 对 CNY 的汇率（汇率表未配置时可手工填写）`)
+      return
+    }
+    if (!validateReceiptWriteoffPlans()) return
+    submitLoading.value = true
+    addReceipt(receiptDialog.form).then(() => {
+      proxy.$modal.msgSuccess('登记成功，等待审核')
+      receiptDialog.visible = false
+      receiptQuery.pageNum = 1
+      receiptDateRange.value = todayTimeRange()
+      getReceiptList()
+    }).finally(() => {
+      submitLoading.value = false
+    })
+  })
+}
+
+function onReceiptDialogClosed() {
+  resetReceiptForm()
+}
+
+/* ================= 收款单详情 ================= */
+const viewDialog = reactive({ visible: false, data: null, attachments: [], loading: false })
+let viewReceiptId = null
+
+function handleViewReceipt(row) {
+  viewReceiptId = row.id
+  viewDialog.visible = true
+  viewDialog.loading = true
+  viewDialog.data = null
+  viewDialog.attachments = []
+  getReceipt(row.id).then(res => {
+    viewDialog.data = res.data || null
+    viewDialog.attachments = res.data?.attachmentList || []
+  }).finally(() => {
+    viewDialog.loading = false
+  })
+}
+
+function handleConfirmFromView() {
+  if (!viewReceiptId) return
+  viewDialog.visible = false
+  handleConfirmReceipt({ id: viewReceiptId, receiptNo: viewDialog.data?.receiptNo })
+}
+
+/* ================= 账单查询与核销 ================= */
+const billList = ref([])
+const billTotal = ref(0)
+const billLoading = ref(false)
+const billDateRange = ref([])
+const billQuery = reactive({ pageNum: 1, pageSize: 10, customerId: '', billNo: '', status: '' })
+
+function getBillList() {
+  billLoading.value = true
+  const params = { ...billQuery }
+  if (billDateRange.value?.length === 2) {
+    params.billDateStart = billDateRange.value[0]
+    params.billDateEnd = billDateRange.value[1]
+  }
+  listArBill(params).then(res => {
+    billList.value = res.rows || []
+    billTotal.value = res.total || 0
+  }).finally(() => {
+    billLoading.value = false
+  })
+}
+
+function resetBillQuery() {
+  billQuery.customerId = ''
+  billQuery.billNo = ''
+  billQuery.status = ''
+  billQuery.pageNum = 1
+  billDateRange.value = []
+  getBillList()
+}
+
+function canWriteoffBill(row) {
+  if (!row?.customerId) return false
+  return (row.status === AR_BILL_STATUS.CONFIRMED || row.status === AR_BILL_STATUS.PARTIAL_WRITTEN_OFF)
+    && Number(row.unwrittenAmount) > 0
+}
+
+const woSubmitLoading = ref(false)
+const woDialog = reactive({ visible: false, bill: null, form: {} })
+
+function openWriteoffDialog(row) {
+  if (!row.customerId) {
+    proxy.$modal.msgError('账单缺少客户信息，无法核销')
+    return
+  }
+  woDialog.bill = row
+  woDialog.form = {
+    arBillId: row.arBillId,
+    customerId: row.customerId,
+    writeoffAmount: Number(row.unwrittenAmount) || 0,
+    writeoffDate: todayStr(),
+    remark: ''
+  }
+  woDialog.visible = true
+}
+
+function submitWriteoff() {
+  const bill = woDialog.bill
+  const rawAmount = typeof woDialog.form.writeoffAmount === 'string'
+    ? woDialog.form.writeoffAmount.trim()
+    : woDialog.form.writeoffAmount
+  const amount = Number(rawAmount)
+  if (!(amount > 0)) {
+    proxy.$modal.msgError('核销金额必须大于0')
+    return
+  }
+  const unwritten = Number(bill.unwrittenAmount) || 0
+  if (amount > unwritten) {
+    proxy.$modal.msgError('核销金额不能超过账单未核销金额 ' + formatMoney(unwritten))
+    return
+  }
+  woSubmitLoading.value = true
+  receiptWriteoff(woDialog.form).then(() => {
+    proxy.$modal.msgSuccess('核销成功：账单已核销 CNY ' + formatMoney(amount))
+    woDialog.visible = false
+    getBillList()
+    getWriteoffList()
+  }).finally(() => {
+    woSubmitLoading.value = false
+  })
+}
+
+/* ================= 核销记录 ================= */
+const writeoffList = ref([])
+const writeoffTotal = ref(0)
+const writeoffLoading = ref(false)
+const woDateRange = ref([])
+const woQuery = reactive({ pageNum: 1, pageSize: 10, customerId: '', billNo: '', status: '' })
+let writeoffLoaded = false
+
+function getWriteoffList() {
+  writeoffLoading.value = true
+  const params = proxy.addDateRange({ ...woQuery }, woDateRange.value)
+  listReceiptWriteoff(params).then(res => {
+    writeoffList.value = res.rows || []
+    writeoffTotal.value = res.total || 0
+  }).finally(() => {
+    writeoffLoading.value = false
+  })
+}
+
+function resetWriteoffQuery() {
+  woQuery.customerId = ''
+  woQuery.billNo = ''
+  woQuery.status = ''
+  woQuery.pageNum = 1
+  woDateRange.value = []
+  getWriteoffList()
+}
+
+const cancelWoLoading = ref(false)
+const cancelWoDialog = reactive({ visible: false, row: null, cancelRemark: '' })
+
+function openCancelWriteoffDialog(row) {
+  cancelWoDialog.row = row
+  cancelWoDialog.cancelRemark = ''
+  cancelWoDialog.visible = true
+}
+
+function submitCancelWriteoff() {
+  const remark = cancelWoDialog.cancelRemark?.trim()
+  if (!remark) {
+    proxy.$modal.msgError('请填写反核销原因')
+    return
+  }
+  cancelWoLoading.value = true
+  cancelReceiptWriteoff(cancelWoDialog.row.writeoffId, remark).then(() => {
+    proxy.$modal.msgSuccess('反核销成功，账单已恢复未核销')
+    cancelWoDialog.visible = false
+    getBillList()
+    getWriteoffList()
+  }).finally(() => {
+    cancelWoLoading.value = false
+  })
+}
+
+watch(activeTab, (tab) => {
+  if (tab === 'writeoff' && !writeoffLoaded) {
+    writeoffLoaded = true
+    getBillList()
+    getWriteoffList()
+  }
+})
+
+/* ================= 附件上传/下载 ================= */
+const uploadFileUrl = ref(baseUrl + '/common/upload')
+const uploadHeaders = ref({ Authorization: 'Bearer ' + getToken() })
+const ATTACHMENT_SIZE_LIMIT = 50
+const ATTACHMENT_EXTENSIONS = ['pdf', 'jpg', 'jpeg', 'png', 'gif', 'doc', 'docx', 'xls', 'xlsx', 'zip', 'rar']
+
+function formatFileSize(bytes) {
+  if (!bytes) return '0 B'
+  const k = 1024
+  const sizes = ['B', 'KB', 'MB', 'GB']
+  const i = Math.floor(Math.log(bytes) / Math.log(k))
+  return parseFloat((bytes / Math.pow(k, i)).toFixed(2)) + ' ' + sizes[i]
+}
+
+function handleBeforeUpload(file) {
+  const ext = (file.name.split('.').pop() || '').toLowerCase()
+  if (ATTACHMENT_EXTENSIONS.indexOf(ext) < 0) {
+    proxy.$modal.msgError(`不支持的文件格式：${ext}`)
+    return false
+  }
+  if (file.name.includes(',')) {
+    proxy.$modal.msgError('文件名不正确，不能包含英文逗号!')
+    return false
+  }
+  if (file.size / 1024 / 1024 >= ATTACHMENT_SIZE_LIMIT) {
+    proxy.$modal.msgError(`上传文件大小不能超过 ${ATTACHMENT_SIZE_LIMIT} MB!`)
+    return false
+  }
+  proxy.$modal.loading('正在上传文件，请稍候...')
+  return true
+}
+
+function handleUploadSuccess(res, file) {
+  proxy.$modal.closeLoading()
+  if (res.code === 200) {
+    const list = receiptDialog.form.attachmentList
+    list.push({
+      attachmentId: null,
+      customerId: receiptDialog.form.customerId || null,
+      bizType: 'customer_receipt',
+      bizId: null,
+      fileName: file.name,
+      filePath: res.fileName,
+      fileSize: file.size,
+      fileType: file.type || '',
+      fileExtension: (file.name.split('.').pop() || '').toLowerCase(),
+      attachmentType: '0',
+      isLogo: '0',
+      sortOrder: list.length,
+      remark: '',
+      delFlag: '0'
+    })
+  } else {
+    proxy.$modal.msgError(res.msg || '上传文件失败')
+  }
+}
+
+function handleUploadError() {
+  proxy.$modal.closeLoading()
+  proxy.$modal.msgError('上传文件失败')
+}
+
+function handleRemoveUpload(index) {
+  receiptDialog.form.attachmentList.splice(index, 1)
+}
+
+function handleDownload(file) {
+  proxy.$modal.loading('正在下载文件，请稍候...')
+  axios({
+    method: 'get',
+    url: baseUrl + '/common/download/resource?resource=' + encodeURIComponent(file.filePath),
+    responseType: 'blob',
+    headers: { Authorization: 'Bearer ' + getToken() }
+  }).then(res => {
+    saveAs(new Blob([res.data]), file.fileName)
+  }).catch(() => {
+    proxy.$modal.msgError('下载失败')
+  }).finally(() => {
+    proxy.$modal.closeLoading()
+  })
+}
+
+/* 首次进入默认查询当天收款 */
+getReceiptList()
+</script>
+
+<style scoped>
+.ar-receipt-page :deep(.cell-sub) {
+  color: var(--el-text-color-secondary);
+  font-size: 12px;
+  line-height: 1.4;
+}
+.select-summary {
+  margin: 4px 0 10px;
+  padding: 8px 12px;
+  background: var(--el-color-primary-light-9);
+  border-radius: 4px;
+  font-size: 13px;
+}
+.wo-section-title {
+  font-weight: 600;
+  margin: 4px 0 12px;
+  padding-left: 8px;
+  border-left: 3px solid var(--el-color-primary);
+}
+.money-in { color: var(--el-color-success); font-weight: 600; }
+.money-out { color: var(--el-color-danger); font-weight: 600; }
+.rate-tip,
+.upload-tip {
+  color: var(--el-text-color-secondary);
+  font-size: 12px;
+  line-height: 1.6;
+}
+.receipt-wo-toolbar {
+  display: flex;
+  align-items: center;
+  gap: 12px;
+  margin-bottom: 8px;
+}
+.attach-title {
+  font-weight: 600;
+  margin: 12px 0 8px;
+}
+</style>