MAS-061: キャッシュ実効税率（Cash ETR）トラッキング機能（合法節税範囲・税負担抑制案サジェスト）

概要

目的

法定実効税率（約 34%）と実際のキャッシュアウト税率（中小法人軽減税率・税額控除・繰越欠損金等の効果反映後）の乖離を継続トラッキングする。

直接の用途 2 つ:

1. 節税設計の効果測定 — 小規模企業共済・経営セーフティ共済・賃上げ促進税制・研究開発税制等の各施策が Cash ETR をどれだけ圧縮できているかを定量化
2. ランウェイ計算の精度向上 — 月次キャッシュアウトに税金支払を組み込み、より現実的な残月数を算出（MAS-008 連携）

加えて、bizlp の管理会計支援サービスとして顧客向けに Cash ETR ダッシュボードを提供可能なテンプレート資産化を視野（PH-4 商用化期）。脱税範囲は絶対に提示しない（合法節税のみ・Disclaimer 必須）。

現在のコード

本案件は既存の税務関連エンジンを順次呼び出して統合指標を算出するアグリゲータ。新規ロジックは Cash ETR 算出 + 節税優先順位サジェスト + ガードレールのみで、税率計算・節税効果計算は既存関数を流用する。

MAS-049 賃上げ税制（✅ 完了）の利用関数

Constants.TAX_RATES（既存）の法人税ブラケット

MAS-003 KPI ダッシュボード（✅ 完了）

93_kpi_dashboard の条件付き書式は Utils.applyTrafficLight_(range, thresholds) を共通ヘルパとして既に持つ。本案件は同関数を呼び出して Cash ETR 信号機（🟢/🟡/🔴）を統一描画する。

MAS-008 Cash Runway（既存）

ランウェイ計算は既存。本案件で算出した予測 Cash ETR を使い、月次キャッシュアウトの税金部分を予測ベースで織り込む拡張は MAS-008 spec への変更が必要なため別 PR 推奨。

MAS-141 共済シミュレーター / MAS-041 繰越欠損金（📝 仕様書完了・未実装）

両者の出力（節税効果額）を本案件の優先順位サジェストに統合。実装着手は両者の実装完了後。

修正方針

Step 0 — 税目分類マスタ整備（前提タスク・着手前必須）

12_mst_tax_classification を新設（spec 推奨・案 A）。11_mst_account への列追加（案 B）も選択肢だが、税目は会計科目とは独立した次元のため別マスタが筋。

// 12_mst_tax_classification の DDL
{ name: '有効FLG', type: 'boolean' },
{ name: '科目ID', type: 'string' },                // 11_mst_account との外部キー
{ name: '税目区分', type: 'enum',
  values: ['corporate_tax','local_corp_tax','enterprise_tax','special_enterprise_tax',
           'inhabitant_tax','consumption_tax','withholding_tax','other'] },
{ name: '所得課税フラグ', type: 'boolean' },        // Cash ETR 分子算入対象か
{ name: '備考', type: 'string' },

消費税（預り金性質）と源泉所得税（前払法人税）は所得課税フラグ false で初期化し、Cash ETR 分子から自動除外。マイグレーション 8XX_migration_f61_tax_classification.js で既存「法人税等」「租税公課」「未払法人税等」科目を一括分類。

Step 1 — 計算式の二系統実装

F61_CASH_ETR_DEFAULT_VARIANT で切替可（default accrual = 系統 B）。

Step 2 — 仕訳データからの自動抽出

// 200_data/202_repository.js に TaxPaymentRepository 追加

var TaxPaymentRepository = (function () {
  /**
   * @param {string} fiscalYear  会計年度（"2026" 等）
   * @returns {Array<{date, taxType, amount, fiscalYearApplied, isIncomeTax}>}
   */
  function findByFiscalYear(fiscalYear) {
    var jnlRows = JournalRepository.findAll();
    return jnlRows
      .filter(_isTaxJournal_)
      .map(_normalizeAsTaxPayment_)
      .filter(function (r) { return r.fiscalYearApplied === fiscalYear; });
  }

  function _isTaxJournal_(row) {
    var subCat = TaxClassificationRepository.findByAccountId(row.accountId);
    return subCat && subCat.taxCategory && subCat.isIncomeTax === true;
  }

  return { findByFiscalYear: findByFiscalYear };
})();

tax_payment フラグまたは勘定科目（法人税等 / 租税公課のうち所得課税分）でフィルタし、TaxPayment レコード（date, taxType, amount, fiscalYearApplied）として正規化。

Step 3 — 3 年移動平均（Normalized Cash ETR）+ 期ズレ補正

function calcNormalizedCashEtr(fiscalYear, years) {
  years = years || Constants.getParam('F61_NORMALIZATION_YEARS', 3);
  var startYear = parseInt(fiscalYear, 10) - years + 1;
  var totalTax = 0, totalProfit = 0;
  for (var y = startYear; y <= parseInt(fiscalYear, 10); y++) {
    totalTax += _sumTaxPayments_(String(y));
    totalProfit += _sumPretaxProfit_(String(y));
  }
  if (totalProfit <= 0) return null;  // 累計赤字は算出不能
  return totalTax / totalProfit;
}

創業初期は単年運用（4 年目以降に有効化）。中間納付と確定納付の期ズレ（X1 期確定分が X2 期 5 月納付等）は fiscalYearApplied フィールドで明示管理。

Step 4 — ダッシュボード統合（93_kpi_dashboard 拡張・信号機）

既存 MAS-003 ダッシュボードに以下フィールドを追加（または新設 40_KPIMonthly シートに分離・仕様化時に判断・spec は前者推奨）:

信号機:

極端に低い期は翌期反動の警告アノテーション（繰越欠損金食い潰しの跳ね返り検知 = Cash ETR < F61_NOL_PHASE_DETECTION_THRESHOLD で 🟡 + 翌期警告）。GCP 移行後（PH-4）は Looker Studio スコアカードでも同等表示。

Step 5 — 予測 Cash ETR + 合法節税の優先順位サジェスト

翌期の予想 Cash ETR を節税施策プランから逆算するシミュレーション機能（共済掛金額・役員報酬水準・税額控除見込みをパラメータに）。MAS-058/MAS-059 と連携して意思決定ツリーの一要素化。

合法節税の優先順位サジェスト: 当期想定 PL + 個人 B/S + ライフイベントを入力に、節税策の優先順位付きリスト（合法範囲のみ）を出力。

各策の 節税効果額 / 実施コスト / リスク（後述ガードレール参照） を集計し、優先順位付きで提示。

Step 6 — ガードレール（脱税範囲を絶対提示しない）

ガードレールは spec の最重要要件。法的に灰色の手法は実装しないことを明文化。

影響範囲

注意事項

1. 消費税・源泉所得税は分子から除外: 消費税は預り金性質・源泉所得税は前払法人税の性質を持つため Cash ETR 分子に含めない。12_mst_tax_classification の isIncomeTax = false で自動除外。マイグレーション 8XX で既存「仮払消費税」「仮受消費税」「源泉所得税預り金」を明示的に除外フラグ設定。

2. 租税回避行為（法人税法 132 条）警告: 同族会社の行為計算否認規定に該当しうる手法（経済合理性のない高額役員報酬・個人資産の不当な法人帰属移転 等）は提案しない。MAS-141 役員報酬最適化や MAS-057 法人/個人移転は 既存判例の安全範囲内 に限定。

3. 重加算税相当（国税通則法 68 条）警告: 隠蔽・仮装に該当する手法（売上除外・架空経費計上 等）は当然提案しない。ガードレール違反検知時はダイアログで即停止 + ログ記録。

4. 過大役員給与認定リスク（MAS-057 既存ロジック延長）: 役員給与不相当高額部分の損金不算入リスクを MAS-057 spec から流用。役員報酬最適化提案時に「不相当高額のリスク段階」を併記。

5. Disclaimer 必須: 「本提案は税理士の個別助言に代わるものではない」を全画面・全レポートのフッタに明示。法的責任の最小化は spec の最重要法的設計（MAS-058 注意事項 #12 と同パターン）。

6. 業務委託の偽装請負リスク（MAS-060 連携）: 業務委託活用で社保コスト削減を提案する際、MAS-060 のリスクスコア参照 を必須化。労働者性 6 要素で偽装請負認定リスクが高ければ警告。

7. 海外移転価格・タックスヘイブン回避はスコープ外として明示: 移転価格税制・タックスヘイブン対策税制は専門領域につき本案件の対象外。商用化時に顧客が海外展開を始めたら税理士紹介を促す UI を将来検討。

8. failure_patterns #25 遵守（並列実装対称性）: MAS-049 賃上げ税制 / MAS-058 必要年商シミュレーター と純粋関数 + Constants.getParam パターンで対称。Cash ETR の Tax 略称を NOT 使う（CashEtrSimulator 命名統一）。

9. failure_patterns #18-#20 遵守（命名造語禁止）: 関数名 calculate / calcNormalizedCashEtr は既存命名と整合（動詞 + 目的語）。ETR は世界標準略称・新語ではない。Read で既存ファイルに同名関数がないことを着手時に裏取り。

10. failure_patterns #26 遵守: appsscript.json の OAuth スコープは変更不要（既存スコープ内で完結）。

11. 顧客向けサービス化を視野に汎用ライブラリ化: Cash ETR 算出ロジックは仕訳データ + 勘定科目マスタ + 税目分類で完結する独立ライブラリとして切り出し可能。商用化時のテンプレート資産化を視野（PH-4）。

12. 税目分類マスタの DDL 拡張判断: 案 A 12_mst_tax_classification 新設（spec 推奨）vs 案 B 11_mst_account 列追加（MAS-063 と統合可能性）。MAS-063 は「営業外サブ分類」で別の属性次元のため、本案件は別マスタが筋。

13. MAS-041 繰越欠損金フェーズ判定の依存: NOL フェーズ判定（Cash ETR < F61_NOL_PHASE_DETECTION_THRESHOLD）は MAS-041 実装後に精度向上。MAS-041 未実装時は閾値ベースの簡易判定で運用。

14. 世帯ベース実効税率の扱い: 「法人税 + 個人所得税 + 住民税 + 社会保険料 ÷ 法人税引前利益 + 役員報酬」を併設するか否か。default OFF（F61_HOUSEHOLD_ETR_ENABLED = false）とし、MAS-057 Phase 3 完了後に ON 検討。個人税務情報の取込でスコープ拡大のため慎重判断。

エッジケース

実データ検証

1. 齋藤 Baseline 当期想定（法人税軽減税率 + MAS-049 賃上げ控除）

実装完了後に以下を 901_test_runner.js で自動検証し、±5% 以内で一致を合格基準とする。

2. MAS-049 賃上げ控除前後の乖離率検証

控除前 Cash ETR と控除後 Cash ETR の差が MAS-049 計算結果 ÷ 税引前利益 と一致することを確認。

3. 系統 A（Cash Tax Rate）vs 系統 B（Effective Tax Rate）の差異

期ズレ中間納付ケースで、系統 A は X2 期に算入・系統 B は X1 期に算入されることを単体テスト F61-03 で網羅。

4. NOL フェーズ判定の精度

繰越欠損金 1,000 万 + 当期利益 800 万 → 課税所得ゼロ → Cash ETR 0% で 🟡 + 翌期反動警告が表示されることを確認。

5. エッジケース検証（単体テスト F61-01〜F61-13）

エッジケースセクションの 13 項目それぞれを 1 テストケースとして 901_test_runner.js に追加。

関連ドキュメント

人間が検討すべき事項

1. 「世帯ベース実効税率」併設の判断: 一人法人特有の最適化視点として有用だが個人税務情報の取込でスコープ拡大。F61_HOUSEHOLD_ETR_ENABLED = false を default とし、MAS-057 Phase 3 完了後に ON 検討。

2. 系統 A・系統 B のどちらをデフォルト表示にするか: 推奨は 系統 B（accrual）。系統 A（cash）はドリルダウンで提供。F61_CASH_ETR_DEFAULT_VARIANT で切替可。

3. Cash ETR 信号機 🟢 (< 20%) の閾値: 繰越欠損金フェーズの「人為的な低 Cash ETR」を健全と誤判定しないためのコンテキスト判定ロジック設計。NOL 検出と連動した 2 段階判定が必要。

4. 税額控除（賃上げ・R&D 等）の控除前後の両方を表示するか: 控除後のみだと節税効果が見えない。breakdown.beforeCredits と breakdown.afterCredits を両方出力する spec 採用。

5. 顧客向けサービス化を視野に汎用ライブラリ化: 仕訳データ + 勘定科目マスタ + 税目分類で完結する形にする。商用化時の SKU 設計に直結。

6. 勘定科目マスタへの「税目分類」属性追加 vs 別マスタ 12_mst_tax_classification 新設の判断: 後者は DDL 拡張が必要・前提タスク化。spec は 案 A 別マスタ推奨（MAS-063 営業外サブ分類とは別の次元のため）。

7. 予測 Cash ETR の信頼区間表示: 点推定 vs 範囲推定。MAS-054 Monte Carlo（P3）連携で範囲推定への拡張余地。

8. ID 採番の整合性: 税務系新規プレフィックス（TAX-XX/FIN-XX）を切らず F-* 系列継承（MAS-040/MAS-041/MAS-049 と並列）の方針継続可否。

9. 節税優先順位サジェストのアルゴリズム: 単純な節税効果額ベース vs リスク × 効果のスコアリング。spec は前者を default、Phase 2 で後者に拡張。

10. MAS-008 Cash Runway 連携の深度: 予測 Cash ETR を MAS-008 に織込むか、MAS-061 内で完結するか。Runway 拡張は MAS-008 spec への変更が必要なため別 PR 推奨（注意事項 #で明記）。

11. 税理士・会計士向け監査ログ: Cash ETR 算出根拠の仕訳明細をエクスポートする機能を v1 で含めるか v2 で追加するか（顧客向けサービス化時に必須）。

実装プロンプト（Claude Code 用）

Claude Opus 4.7（1M context）推奨。多数の既存税務エンジン結合 + ガードレール法的設計 + 節税優先順位サジェストの複合判断。

## 案件
MAS-061 — キャッシュ実効税率（Cash ETR）トラッキング機能

## 事前調査（必ず Read する）
1. `docs/dev/dev_mas-061_cash_etr_tracking.md` 全文（本仕様書）
2. `docs/dev/dev_mas-049_wage_increase_tax_credit_simulator.md` 全文（節税策連携手本）
3. `docs/dev/dev_mas-003_kpi_dashboard.md` — 93_kpi_dashboard 拡張方法
4. `docs/dev/dev_mas-008_cash_runway.md` — 予測連携先
5. `docs/dev/dev_mas-058_required_revenue_solver.md` — 純粋関数 + Constants.getParam パターン
6. `400_domain/414_wage_tax_credit_simulator.js` 全文（MAS-049 実装）
7. `200_data/202_repository.js` — Repository パターン手本
8. `100_config/101_sys_config.js` — DDL 拡張箇所（12_mst_tax_classification 新設）
9. `000_infra/002_constants.js` — TAX_RATES / getParam
10. `docs/_internal/failure_patterns.md` #18-#20 / #25 / #26

## 実装対象（Step 0 = 前提タスク）

Step 0. `100_config/101_sys_config.js` に `12_mst_tax_classification` DDL 追加
        + `8XX_migration_f61_tax_classification.js` で既存科目を一括分類

Step 1. `400_domain/448_cash_etr_simulator.js` 新規（IIFE 名前空間 CashEtrSimulator）:
        - calculate(input) — メイン API（系統 A/B 二系統）
        - calcNormalizedCashEtr(fiscalYear, years) — 3 年移動平均
        - simulateForecast(input) — 予測 Cash ETR
        - suggestTaxOptimizations(input) — 合法節税優先順位
        - 内部ヘルパ群（_loadParamsFromSysParams_ / _diagnoseNolPhase_ / 等）

Step 2. `200_data/202_repository.js` に `TaxPaymentRepository` + `TaxClassificationRepository` 追加

Step 3. `93_kpi_dashboard` セル追加（5 セル）+ 条件付き書式（信号機）

Step 4. `03_sys_params` の 6 キー追加（default は Constants.getParam の第 2 引数）

Step 5. `000_infra/002_constants.js` の MENU_DEFINITION + F03_CASH_ETR_THRESHOLDS 追加

Step 6. `900_test/901_test_runner.js` に F61-01〜F61-13 単体テスト

## 動作確認
1. 齋藤 Baseline で Cash ETR 22% / 26% / 18% の 3 ケース ±5% 一致
2. MAS-049 控除前後の乖離率検証
3. 系統 A vs 系統 B の期ズレケース
4. NOL フェーズ判定の翌期反動警告
5. エッジケース 13 項目すべて想定通り

## デプロイ
1. dev で push:dev → メニュー「💰 Cash ETR シミュレーション」実行 → 93_kpi_dashboard 確認
2. Go なら push:prod
3. コミット: feat(MAS-061): Cash ETR トラッキング (合法節税優先順位サジェスト + ガードレール)

## failure_patterns チェック
- #18-#20: CashEtrSimulator / TaxPaymentRepository を Read で裏取り
- #25: MAS-049/MAS-058 と純粋関数 + Constants.getParam パターンで対称
- #26: appsscript.json は変更なし

推奨実行モデル

変更履歴