zeicheck

e-Tax (xtx) 確定申告データの整合性チェッカー。ESLintのような使い心地で、個人事業主・給与所得者・マイクロ法人（資本金1,000万以下・一人法人）の税務申告データをルールベースで検証します。

インストール

npm install -g zeicheck

使い方

個人事業主（青色申告）

zeicheck check 申告データ.xtx

給与所得者（個人の確定申告）

zeicheck check 給与所得者申告データ.xtx

法人（マイクロ法人）

zeicheck check 法人申告データ.xtx --csv 決算書.csv

法人の検証には --csv オプションで決算書CSV（HOT010形式）の指定が必須です。

自動判別: XTXファイル内のフォームから申告種別を自動検出します。HOA110（法人税別表一）→法人、VCA（青色申告決算書）→個人事業主、それ以外→給与所得者。

出力例

/path/to/申告データ.xtx

  balance-sheet/equation        error    期末残高: 資産合計(3,500,000) ≠ 負債合計(0) + 資本合計(3,300,000)
  income-statement/pl-chain     error    経費合計(1,850,000) ≠ 各経費の合算(1,800,000)
  deductions/blue-deduction-cap warning  青色申告特別控除額(650,000) > 控除前所得(500,000)

✖ 3 件の問題 (2 errors, 1 warning)

コマンド

# xtxファイルの検証
zeicheck check <file.xtx>
  -f, --format <stylish|json>     # 出力形式（デフォルト: stylish）
  -c, --config <path>             # 設定ファイルパス
  --csv <file.csv>                # 法人決算書CSVファイル（HOT010形式、法人必須）
  --prior-year <file.xtx>         # 前年ファイル（継続性チェック用）
  --severity <error|warning|info> # 最低表示レベル
  --no-color                      # カラー出力を無効化

# ルール一覧の表示
zeicheck list-rules

# ルールの詳細説明
zeicheck explain <rule-id>

機能対応一覧

チェック項目	個人事業主	給与所得者	法人
貸借対照表
B/S等式（資産=負債+資本）	✅	—	✅
現金残高の非負チェック	✅	—	✅
事業主貸借 期首ゼロ	✅	—	—
元入金繰越計算	✅	—	—
損益計算書
P/L計算連鎖	✅	—	✅
経費合計チェック	✅	—	✅
売上原価計算	✅	—	✅
クロスチェック
B/S↔P/L整合性	✅	—	✅
決算書→申告書転記	✅	—	—
減価償却費合計一致	✅	—	—
別表四↔P/L整合性	—	—	✅
別表一↔別表四整合性	—	—	✅
控除・税額
青色申告特別控除	✅	—	—
軽減税率適用	—	—	✅
交際費損金算入限度	—	—	✅
減価償却
法定耐用年数	✅	—	✅
少額資産特例	✅	—	✅
継続性
期首=前期末一致	✅	—	✅
前年比変動	✅	—	✅
利益剰余金繰越	—	—	✅
その他
家事按分妥当性	✅	—	—
役員報酬妥当性	—	—	✅
資本金1000万以下	—	—	✅
給与所得者向け
基礎控除額確認	—	✅	—
所得控除合計チェック	—	✅	—
課税所得計算	—	✅	—
源泉徴収税額整合性	—	✅	—

ルール一覧

個人事業主ルール（applicableTo: ["sole-proprietor"]）

貸借対照表 (Balance Sheet)

ルールID	説明	重要度	備考
balance-sheet/equation	資産合計 = 負債合計 + 資本合計	error	※共有
balance-sheet/opening-owner-equity	事業主貸/借の期首残高が0	error
balance-sheet/motoire-kin-formula	元入金繰越計算の検証	error
balance-sheet/non-negative-cash	現金残高が負でないか	warning	※共有

損益計算書 (Income Statement)

ルールID	説明	重要度	備考
income-statement/pl-chain	P/L各段階の計算検証	error
income-statement/expense-total	経費合計の一致	error
income-statement/cogs	売上原価の計算検証	error	※共有

帳票間整合性 (Cross-Statement)

ルールID	説明	重要度
cross-statement/bs-pl-bridge	B/S⇔P/L所得金額一致	error
cross-statement/decision-to-return	決算書→申告書の転記一致	error
cross-statement/depreciation-sum	減価償却合計の一致	error

控除 (Deductions)

ルールID	説明	重要度
deductions/blue-deduction-cap	青色控除 ≦ 控除前所得	warning
deductions/blue-deduction-eligibility	65万円控除の適用要件	info

減価償却 (Depreciation)

ルールID	説明	重要度
depreciation/useful-life-rates	法定耐用年数テーブル照合	warning
depreciation/small-asset-threshold	少額資産の閾値チェック	warning

継続性 (Continuity)

ルールID	説明	重要度
continuity/opening-closing-match	期首=前年期末の一致	error
continuity/year-over-year-change	前年比大幅変動の警告	warning

家事按分 (Home Office)

ルールID	説明	重要度
home-office/reasonable-ratio	家事按分率の妥当性	warning

給与所得者ルール（applicableTo: ["individual"]）

ルールID	説明	重要度
individual/basic-deduction	基礎控除が標準額（48万円）か	info
individual/deduction-total	所得控除合計の一致	error
individual/taxable-income	課税所得 = 合計所得 − 控除合計	error
individual/withholding-total	源泉徴収税額の整合性	warning

法人ルール（applicableTo: ["corporate"]）

ルールID	説明	重要度
corporate/bs-equation	資産 = 負債 + 純資産	error
corporate/pl-chain	営業利益→経常利益→税引前→当期純利益	error
corporate/expense-total	販管費の合計検証	error
corporate/bs-pl-bridge	B/S当期純利益 = P/L当期純利益	error
corporate/betsu4-accounting-profit	別表四の当期利益 = P/L税引前利益	error
corporate/betsu4-taxable-income	別表四の所得金額計算検証	error
corporate/betsu1-match	別表一 = 別表四の所得金額	error
corporate/capital-under-10m	資本金1,000万以下チェック	warning
corporate/officer-compensation	役員報酬の妥当性	warning
corporate/entertainment-limit	交際費の損金算入限度	warning
corporate/small-corp-tax-rate	軽減税率適用チェック	info
corporate/retained-earnings-continuity	利益剰余金の繰越	error

設定

プロジェクトルートに .zeicheckrc.json を配置して、ルールの有効/無効やオプションをカスタマイズできます。

{
  "rules": {
    "balance-sheet/equation": "error",
    "home-office/reasonable-ratio": ["warning", { "maxRatio": 0.9 }],
    "continuity/opening-closing-match": "off"
  },
  "priorYearFile": "./prior-year.xtx",
  "format": "stylish",
  "warningsAsErrors": false
}

ルール設定

各ルールの重要度を変更できます:

• "error" — エラーとして報告（終了コード1）
• "warning" — 警告として報告
• "info" — 情報として報告
• "off" — ルールを無効化

一部のルールはオプション付きで設定できます:

{
  "rules": {
    "home-office/reasonable-ratio": ["warning", { "maxRatio": 0.5 }]
  }
}

出力形式

stylish（デフォルト）

ESLint風のカラー出力。ターミナルでの確認に適しています。

json

zeicheck check data.xtx -f json

CI/CDパイプラインやツール連携に適したJSON形式で出力します。

免責事項

本ツールは確定申告データの形式的な整合性チェックを目的としたものであり、税務上の正確性・適法性を保証するものではありません。

• 本ツールの検証結果をもって、申告内容が税法上正しいことの証明にはなりません
• 検証でエラーが検出されなくても、申告内容に誤りがないことを意味するものではありません
• 税制改正により、ルールが最新の法令に対応していない場合があります
• 実際の確定申告にあたっては、必ず税理士等の専門家にご相談いただくか、国税庁の公式資料をご確認ください

本ツールの使用によって生じたいかなる損害についても、開発者は一切の責任を負いません。

コントリビューション

zeicheckはコミュニティからの貢献を歓迎します！

貢献の方法

• バグ報告: Issues で報告してください。再現手順やエラーメッセージを添えていただけると助かります
• 機能提案: 新しいルールや機能の要望も Issues でお気軽にどうぞ
• プルリクエスト: バグ修正、新規ルール追加、ドキュメント改善など歓迎します

開発環境のセットアップ

git clone https://github.com/kalbi-org/zeicheck.git
cd zeicheck
npm install
npm test          # テスト実行
npm run build     # ビルド
npm run typecheck # 型チェック

プルリクエストのガイドライン

1. 既存のテストがすべて通ることを確認してください（npm test）
2. 新しいルールを追加する場合は、対応するユニットテストも追加してください
3. ルールのメッセージは日本語で記述してください
4. コミットメッセージは変更内容が分かるように簡潔に書いてください

新しいルールの追加方法

1. src/rules/<カテゴリ>/ にルールファイルを作成
2. Rule インターフェースを実装（meta + check メソッド）
3. src/rules/index.ts にルールを登録
4. tests/unit/rules/<カテゴリ>/ にテストを作成

import type { Rule, RuleContext, RuleDiagnostic } from "../types.js";

export const myRule: Rule = {
  meta: {
    id: "category/my-rule",
    name: "ルール名",
    description: "ルールの詳細説明",
    severity: "error",
    applicableTo: ["sole-proprietor"], // or ["corporate"] or ["sole-proprietor", "corporate"]
  },
  check(ctx: RuleContext): RuleDiagnostic[] {
    // 検証ロジック
    return [];
  },
};

ライセンス

MIT