finance-reconcile

財務監査

概要

貸借対照表と損益計算書を検証する包括的な財務監査ツールです。貸借対照表の均衡、損益計算書の検証、勘定科目の変動追跡、財務諸表間の関係の検証という、4つの主要な監査を実行します。

クイックスタート

基本的な貸借対照表の監査

勘定科目の変動を使って貸借対照表を検証します。

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 を参照してください。

監査の目的

このスクリプトは、4つの主要な監査を実行します。

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

包括的な監査ルール、検証ロジック、出力例、トラブルシューティングガイドを記載しています。