新增、编辑、删除费用后,都会根据费用明细重新汇总订单状态:

- 全部未出账:UNBILLED
- 部分已出账、部分未出账:PARTIAL
- 全部已出账:BILLED
3. 应收账单生成
   - 预览、统计、分页生成支持 UNBILLED 和 PARTIAL;
   - PARTIAL 订单只读取未出账费用;
   - 生成成功后,只将本次实际生成的费用更新为 BILLED;
   - 不会重复带入历史已出账费用;
   - 账单金额只统计本次未出账费用。
4. 作废、取消、失败清理
   - 只恢复当前账单关联的费用;
   - 如果费用仍被其他有效账单使用,则继续保持 BILLED;
   - 根据费用状态重新汇总订单状态;
   - 大账单清理使用批量 SQL,不组装几十万条费用 ID。
This commit is contained in:
caojia
2026-09-22 17:20:27 +08:00
parent cb50d2a258
commit 221d4721ee
11 changed files with 457 additions and 106 deletions
@@ -0,0 +1,124 @@
-- 应收账单来源费用状态迁移(统一脚本)
--
-- 目标:
-- 1. prc_order_bill.ar_bill_status:UNBILLED 未出账、PARTIAL 部分出账、BILLED 已出账;
-- 2. prc_income_bill_fee.ar_bill_status:UNBILLED 未生成、BILLED 已生成;
-- 3. 按现有有效应收账单关联回填费用状态,再由费用状态汇总回填订单状态。
--
-- 脚本可重复执行。执行前请备份数据库,并确认 ar_bill_detail_fee.prc_income_bill_fee_id
-- 已经正确保存来源费用 ID。
SET NAMES utf8mb4;
SET @db_name := DATABASE();
-- 1. 来源计费订单状态字段及索引
SET @has_order_status := (
SELECT COUNT(*)
FROM information_schema.COLUMNS
WHERE TABLE_SCHEMA = @db_name
AND TABLE_NAME = 'prc_order_bill'
AND COLUMN_NAME = 'ar_bill_status'
);
SET @sql := IF(@has_order_status = 0,
'ALTER TABLE prc_order_bill ADD COLUMN ar_bill_status VARCHAR(20) NOT NULL DEFAULT ''UNBILLED'' COMMENT ''应收账单状态:UNBILLED未出账/PARTIAL部分出账/BILLED已出账'' AFTER currency',
'SELECT 1');
PREPARE stmt FROM @sql;
EXECUTE stmt;
DEALLOCATE PREPARE stmt;
ALTER TABLE prc_order_bill
MODIFY COLUMN ar_bill_status VARCHAR(20) NOT NULL DEFAULT 'UNBILLED'
COMMENT '应收账单状态:UNBILLED未出账/PARTIAL部分出账/BILLED已出账';
SET @has_order_status_index := (
SELECT COUNT(*)
FROM information_schema.STATISTICS
WHERE TABLE_SCHEMA = @db_name
AND TABLE_NAME = 'prc_order_bill'
AND INDEX_NAME = 'idx_bill_ar_status'
);
SET @sql := IF(@has_order_status_index = 0,
'ALTER TABLE prc_order_bill ADD KEY idx_bill_ar_status (customer_id, currency, ar_bill_status, biz_date)',
'SELECT 1');
PREPARE stmt FROM @sql;
EXECUTE stmt;
DEALLOCATE PREPARE stmt;
-- 2. 来源费用状态字段及索引(兼容同事已提前加列的数据库)
SET @has_fee_status := (
SELECT COUNT(*)
FROM information_schema.COLUMNS
WHERE TABLE_SCHEMA = @db_name
AND TABLE_NAME = 'prc_income_bill_fee'
AND COLUMN_NAME = 'ar_bill_status'
);
SET @sql := IF(@has_fee_status = 0,
'ALTER TABLE prc_income_bill_fee ADD COLUMN ar_bill_status VARCHAR(20) NOT NULL DEFAULT ''UNBILLED'' COMMENT ''是否生成账单状态:UNBILLED未生成/BILLED已生成'' AFTER remark',
'SELECT 1');
PREPARE stmt FROM @sql;
EXECUTE stmt;
DEALLOCATE PREPARE stmt;
ALTER TABLE prc_income_bill_fee
MODIFY COLUMN ar_bill_status VARCHAR(20) NOT NULL DEFAULT 'UNBILLED'
COMMENT '是否生成账单状态:UNBILLED未生成/BILLED已生成';
SET @has_fee_status_index := (
SELECT COUNT(*)
FROM information_schema.STATISTICS
WHERE TABLE_SCHEMA = @db_name
AND TABLE_NAME = 'prc_income_bill_fee'
AND INDEX_NAME = 'idx_income_fee_ar_status'
);
SET @sql := IF(@has_fee_status_index = 0,
'ALTER TABLE prc_income_bill_fee ADD KEY idx_income_fee_ar_status (ar_bill_status)',
'SELECT 1');
PREPARE stmt FROM @sql;
EXECUTE stmt;
DEALLOCATE PREPARE stmt;
SET @has_fee_bill_status_index := (
SELECT COUNT(*)
FROM information_schema.STATISTICS
WHERE TABLE_SCHEMA = @db_name
AND TABLE_NAME = 'prc_income_bill_fee'
AND INDEX_NAME = 'idx_income_fee_bill_ar_status'
);
SET @sql := IF(@has_fee_bill_status_index = 0,
'ALTER TABLE prc_income_bill_fee ADD KEY idx_income_fee_bill_ar_status (bill_id, ar_bill_status)',
'SELECT 1');
PREPARE stmt FROM @sql;
EXECUTE stmt;
DEALLOCATE PREPARE stmt;
-- 3. 根据有效应收账单关联回填费用状态。
-- 作废账单不再占用来源费用;同一费用只要仍关联一张有效账单,就保持 BILLED。
UPDATE prc_income_bill_fee f
LEFT JOIN (
SELECT DISTINCT df.prc_income_bill_fee_id AS fee_id
FROM ar_bill_detail_fee df
INNER JOIN ar_bill_detail d ON d.detail_id = df.detail_id
INNER JOIN ar_bill b ON b.ar_bill_id = d.ar_bill_id
WHERE b.status <> 'VOID'
) active_fee ON active_fee.fee_id = f.fee_id
SET f.ar_bill_status = CASE
WHEN active_fee.fee_id IS NOT NULL THEN 'BILLED'
ELSE 'UNBILLED'
END;
-- 4. 根据费用状态回填订单状态。
UPDATE prc_order_bill o
LEFT JOIN (
SELECT bill_id,
COUNT(*) AS fee_count,
SUM(CASE WHEN ar_bill_status = 'BILLED' THEN 1 ELSE 0 END) AS billed_count,
SUM(CASE WHEN ar_bill_status = 'UNBILLED' THEN 1 ELSE 0 END) AS unbilled_count
FROM prc_income_bill_fee
GROUP BY bill_id
) fee_summary ON fee_summary.bill_id = o.bill_id
SET o.ar_bill_status = CASE
WHEN fee_summary.bill_id IS NULL THEN 'UNBILLED'
WHEN fee_summary.unbilled_count > 0 AND fee_summary.billed_count > 0 THEN 'PARTIAL'
WHEN fee_summary.unbilled_count > 0 THEN 'UNBILLED'
WHEN fee_summary.billed_count = fee_summary.fee_count THEN 'BILLED'
ELSE 'UNBILLED'
END;