finance-reconcile

财务审计

概述

全面的财务审计工具，可验证资产负债表和利润表。执行四项核心审计：资产负债表平衡性、利润表核验、科目变动追踪以及报表间关系验证。

快速开始

基本资产负债表审计

使用科目变动明细验证资产负债表：

scripts/reconcile.py \
    --balance-sheet balance_sheet.xlsx \
    --account-changes account_changes.xlsx \
    --output audit_report.xlsx

完整财务审计（资产负债表 + 利润表）

包含利润表的完整审计：

scripts/reconcile.py \
    --balance-sheet balance_sheet.xlsx \
    --account-changes account_changes.xlsx \
    --income-statement income_statement.xlsx \
    --income-details income_details.xlsx \
    --transactions transactions.xlsx \
    --output complete_audit.xlsx \
    --period "2024年1月"

使用自定义列名

使用 JSON 配置文件设置自定义列名：

scripts/reconcile.py \
    --balance-sheet bs.xlsx \
    --account-changes ac.xlsx \
    --config my_config.json

命令参数

参数	简写	必需	说明
--balance-sheet	-b	是	资产负债表文件路径
--account-changes	-a	是	科目变动明细文件路径
--income-statement	-i	否	利润表文件路径
--income-details	-d	否	利润明细文件路径
--transactions	-t	否	交易明细文件路径
--output	-o	否	输出的 Excel 审计报告路径
--period	-p	否	审计期间（默认：本期）
--tolerance	-	否	可接受差异的容差（默认：0.01）
--config	-c	否	用于指定列名的 JSON 配置文件
--bs-sheet	-	否	资产负债表工作表名称或索引
--ac-sheet	-	否	科目变动工作表名称或索引
--is-sheet	-	否	利润表工作表名称或索引
--id-sheet	-	否	利润明细工作表名称或索引
--trans-sheet	-	否	交易明细工作表名称或索引

必需的文件格式

1. 资产负债表（资产负债表）- 必需

列	说明
科目	科目名称
期初余额	期初余额
期末余额	期末余额
类型	科目类型（资产/负债/所有者权益）
金额	合计金额

2. 科目变动明细表（科目变动明细表）- 必需

列	说明
科目	科目名称
借方	借方金额
贷方	贷方金额

3. 利润表（利润表）- 可选

列	说明
项目	利润表项目
金额	金额

4. 利润明细表（利润明细表）- 可选

列	说明
项目	项目名称（必须与利润表一致）
金额	明细金额

5. 交易明细表（交易明细表）- 可选

列	说明
科目	受影响的科目
借方	借方金额
贷方	贷方金额
日期（可选）	交易日期
凭证号（可选）	凭证号

详细的格式规范和自定义列配置，请参阅 references/file_formats.md。

审计目标

该脚本执行四项核心审计目标：

1. 资产负债表平衡性验证

公式：资产总计 = 负债总计 + 所有者权益总计

验证资产负债表整体是否平衡。

2. 利润表核验

逻辑：利润表项目 = 对应明细汇总

根据明细记录验证每个利润表项目（收入、费用等）。

3. 科目变动追踪

逻辑：期初余额 + 变动 = 期末余额

对于每个科目：

• 资产类科目：期末余额 = 期初余额 + 借方 - 贷方
• 负债/权益类科目：期末余额 = 期初余额 + 贷方 - 借方

4. 报表间关系验证

逻辑：留存收益变动 ≈ 净利润

验证资产负债表与利润表之间的关系。

详细的审计逻辑和故障排查方法，请参阅 references/verification_rules.md。

审计输出

控制台报告

================================================================================
                              财务审计报告 - 本期
================================================================================

一、审计概述
--------------------------------------------------------------------------------
审计结果: 通过 ✓

二、资产负债表审计
--------------------------------------------------------------------------------
资产总计: ¥1,000,000.00
负债总计: ¥600,000.00
所有者权益总计: ¥400,000.00
资产负债平衡: 是 ✓

三、利润表审计
--------------------------------------------------------------------------------
利润项目匹配: 5/5

四、报表勾稽关系
--------------------------------------------------------------------------------
净利润: ¥100,000.00
未分配利润变动: ¥100,000.00
勾稽关系验证: 通过 ✓

五、不平衡项目清单
--------------------------------------------------------------------------------
  无不平衡项目

Excel 审计报告

指定 --output 后，将生成包含以下工作表的 Excel 文件：

工作表	内容
审计报告	完整的审计报告文本
科目变动分析	包含期初/期末余额的科目分析
交易影响追踪	交易影响追踪
利润表核对	利润表核验结果
不平衡项	不平衡项目列表

科目变动分析表

科目	科目类型	期初余额	借方变动	贷方变动	净变动	期末余额	是否平衡	差异
货币资金	资产	100000	20000	0	20000	120000	是	0

将脚本用作模块

from scripts.reconcile import (
    audit_financial_statements,
    generate_audit_report,
    export_audit_report
)

result, accounts = audit_financial_statements(
    balance_sheet_file='balance_sheet.xlsx',
    account_changes_file='account_changes.xlsx',
    income_statement_file='income_statement.xlsx',
    income_details_file='income_details.xlsx',
    transactions_file='transactions.xlsx',
    tolerance=0.01,
    period='2024年1月'
)

# Print console report
print(generate_audit_report(result, period='2024年1月'))

# Export Excel report
export_audit_report(result, 'audit_report.xlsx', accounts, period='2024年1月')

# Check audit result
if result.is_passed:
    print("Audit passed!")
else:
    print(f"Found {len(result.unbalanced_items)} unbalanced items")

容差设置

默认容差为 ±0.01 元。使用 --tolerance 调整：

scripts/reconcile.py \
    --balance-sheet bs.xlsx \
    --account-changes ac.xlsx \
    --tolerance 1.0

设置容差时请考虑以下因素：

• 汇率波动（适用于外币）
• 系统精度差异
• 舍入误差

故障排除

资产负债表不平衡

可能原因：

• 余额录入错误
• 合计计算错误
• 期初与期末不匹配

解决方案：

1. 检查资产负债表合计行
2. 核对科目余额
3. 检查科目类型分类

科目变动不平衡

可能原因：

• 缺少变动记录
• 借贷方向错误
• 科目名称不匹配

解决方案：

1. 确保科目名称完全一致
2. 核对借贷记录
3. 检查是否缺少变动记录

利润表不匹配

可能原因：

• 缺少明细项目
• 项目名称不一致
• 汇总计算错误

解决方案：

1. 确保明细表包含所有项目
2. 检查项目名称是否一致
3. 核对汇总计算

报表间勾稽关系验证失败

可能原因：

• 利润分配（股利、留存收益）
• 会计期间不匹配
• 净利润计算错误

解决方案：

1. 考虑利润分配事项
2. 核对利润表净利润
3. 确认期间一致

资源

scripts/reconcile.py

核心审计脚本，支持：

• 资产负债表平衡验证
• 利润表验证
• 科目变动跟踪
• 报表间勾稽关系验证
• 交易影响追踪
• 生成综合审计报告

references/file_formats.md

详细的文件格式规范、列名映射和配置选项。

references/verification_rules.md

全面的审计规则、验证逻辑、输出示例和故障排除指南。