mcpbeat

E Tax

kazukinagata/e-tax

> This skill should be used when the user wants to file their tax return electronically via the 確定申告書等作成コーナー (NTA Tax Return Preparation Corner) using Claude in Chrome, Antigravity Browser Sub-Agent, or Playwright CLI (fallback). It guides the "e-Tax提出", "電子申告", "e-Taxで申告", "作成コーナーに入力", "確定申告書等作成コーナー", "作成コーナー", "申告書を提出".

44k tokens
context cost
the whole folder, loaded on every use
35
files
ships runnable scripts
0
copies elsewhere
how many repositories repackaged it
352
stars on the repo
on the repository, not the skill itself

Install

one command, takes just this skill from the repository 
npx skills add https://github.com/kazukinagata/shinkoku --skill e-tax

The instruction itself

58 sections, as written by the author

e-Tax 電子申告 — ブラウザ自動化による確定申告書等作成コーナー入力

shinkoku で計算した確定申告データを、確定申告書等作成コーナー（https://www.keisan.nta.go.jp/）に

Claude in Chrome を使ってブラウザ上で入力・提出するためのスキル。

前提条件

  • /income-tax スキルで所得税の計算が完了していること
  • /settlement スキルで決算書（PL/BS）の作成が完了していること
  • /consumption-tax スキルで消費税の計算が完了していること（該当者のみ）
  • shinkoku.config.yaml が設定済みであること
  • ブラウザ自動化ツールがいずれか利用可能であること（下記「ブラウザ自動化方式の選択」参照）

ブラウザ自動化方式の選択

確定申告書等作成コーナーへの入力には、以下の3つの方式がある。

方式 A: Claude in Chrome（推奨）

| 項目 | 内容 |

|-----|------|

| 対象環境 | Windows / macOS のネイティブ Chrome |

| 前提 | Claude in Chrome 拡張機能がインストール済み |

| 利点 | OS 検出の問題なし。追加設定不要 |

方式 B: Antigravity Browser Sub-Agent

| 項目 | 内容 |

|-----|------|

| 対象環境 | Windows / macOS / Linux（Antigravity IDE） |

| 前提 | Antigravity IDE がインストール済みで browser_subagent ツールが利用可能 |

| 利点 | ネイティブ Chrome を使用するため OS 偽装不要。Linux でも動作 |

方式 C: Playwright CLI（フォールバック）

| 項目 | 内容 |

|-----|------|

| 対象環境 | WSL / Linux、または Claude in Chrome・Antigravity が利用できない環境 |

| 前提 | @playwright/cli + Playwright CLI スキル + etax-stealth.js（OS 偽装スクリプト） |

| 制限 | headed モード必須（QR コード認証に物理操作が必要） |

判定ロジック

1. Claude in Chrome のツール（browser_navigate 等）が利用可能か？
   → はい: 方式 A を使用
   → いいえ: 次へ

2. Antigravity の browser_subagent ツールが利用可能か？
   → はい: 方式 B を使用
   → いいえ: 次へ

3. Bash ツールで `playwright-cli` コマンドが利用可能か？
   → はい: 方式 C を使用（headed モードで起動）
   → いいえ: エラー表示

   エラーメッセージ:
   「確定申告書等作成コーナーへの入力には、Claude in Chrome、
    Antigravity Browser Sub-Agent、または Playwright CLI が必要です。
    セットアップ方法は README.md の『ブラウザ自動化』セクションを参照してください。」

方式 B 使用時の操作方法

Antigravity の browser_subagent は高レベルなタスク記述で操作する。

各ステップの入力操作を自然言語で記述し、browser_subagent に委任する。

例:

  • 「https://www.keisan.nta.go.jp/kyoutu/ky/sm/top_web#bsctrl を開く」
  • 「『マイナンバーカードをお持ちですか』で『はい』のラジオボタンをクリック」
  • 「name='sonekiKeisansyoFromMonth' の入力欄に '1' を入力」

※ Antigravity はネイティブ Chrome を使用するため、etax-stealth.js による OS 偽装は不要。

方式 C 使用時のセッション開始手順

Playwright CLI でブラウザを開く際の手順:

  • 環境変数を設定: PLAYWRIGHT_MCP_INIT_SCRIPT=skills/e-tax/scripts/etax-stealth.js
  • ブラウザ起動: playwright-cli -s=etax open <url> --headed --browser=chrome
  • 以降のコマンドは -s=etax セッション指定で実行

設定の読み込み（最初に実行）

  • shinkoku.config.yaml を Read ツールで読み込む
  • ファイルが存在しない場合は /setup スキルの実行を案内して終了する
  • 設定値を把握する:
  • 納税者プロファイル（氏名・住所・マイナンバー等）
  • 事業情報（屋号・業種等）
  • 申告方法（e-Tax/郵送/窓口）

進捗情報の読み込み

  • .shinkoku/progress/progress-summary.md を Read ツールで読み込む（存在する場合）
  • 以下の引継書を Read ツールで読み込む（存在する場合）:
  • .shinkoku/progress/06-settlement.md — 決算結果（PL/BS データ）
  • .shinkoku/progress/07-income-tax.md — 所得税計算結果
  • .shinkoku/progress/08-consumption-tax.md — 消費税計算結果
  • .shinkoku/progress/02-assess.md — 課税判定結果
  • .shinkoku/progress/10-etax.md の status を確認する:
  • status: interrupted の場合 → 下記「中断・再開プロトコル」の 再開手順 に従う
  • status: completed の場合 → ユーザーに完了済みである旨を伝え、再実行の意図を確認する
  • 計算結果がまだ存在しない場合は、先に /income-tax や /settlement の実行を案内する

中断・再開プロトコル

全ステップ共通のルール。ユーザーが中断を要求した場合（「中断したい」「今日はここまで」「また続きから」等）、以下の手順に従う。

中断手順

  • 現在のステップの入力内容を確認する — 未保存の入力がないか確認
  • .data ファイルのダウンロードを案内する — AskUserQuestion で以下を表示:
作成コーナーの入力データを .data ファイルとして保存することを推奨します。
画面上部の「入力データの一時保存」ボタン（またはページ下部の「ここまでの入力データを保存する」リンク）
をクリックし、ファイルをダウンロードしてください。

ダウンロードが完了したら「ダウンロード済み」を選択してください。
  • 選択肢: 「ダウンロード済み」 / 「スキップ（保存しない）」
  • 「スキップ」が選ばれた場合は、次回は最初からやり直しになる可能性がある旨を警告する
  • 進捗ファイルを記録する — .shinkoku/progress/10-etax.md に以下の形式で Write ツールで出力:
---
step: 10
skill: e-tax
status: interrupted
last_completed_step: "{最後に完了したステップ番号（例: 3）}"
last_url: "{中断時のブラウザURL}"
data_file_saved: {true/false}
interrupted_at: "{当日日付 YYYY-MM-DD}"
fiscal_year: {tax_year}
---

# e-Tax 電子申告（中断）

## 中断時点の状況

- 最後に完了したステップ: ステップ{N}
- 中断時のURL: {URL}
- .data ファイル保存: {済/未}

## 次回の再開方法

1. `/e-tax` スキルを再実行する
2. .data ファイルがある場合は「保存データを利用して作成」から再開する
3. .data ファイルがない場合はステップ0からやり直す
  • ユーザーに中断完了を報告 — 次回の再開方法を案内して終了する

再開手順

.shinkoku/progress/10-etax.md で status: interrupted を検出した場合:

  • 中断時の情報（last_completed_step, data_file_saved）を読み取る
  • AskUserQuestion で以下を表示:
前回の e-Tax 入力はステップ{N}で中断されています。

再開方法を選択してください。
  • 選択肢:
  • 「.data ファイルから再開する」（data_file_saved: true の場合のみ表示）
  • 「最初からやり直す」
  • 「中断記録を破棄して終了する」
  • .data ファイルから再開する場合:
  • 確定申告書等作成コーナーのトップページにアクセス
  • 「保存データを利用して作成」→「作成再開」を選択
  • .data ファイルのアップロードを案内
  • 読み込み完了後、last_completed_step の次のステップから再開する
  • 最初からやり直す場合:
  • ステップ0 から通常通り開始する

ステップ0: 必須データの検証

確定申告書等作成コーナーへの入力に必要なデータが揃っているか検証する。

検証項目

[1] 税額計算済み
    - .shinkoku/progress/07-income-tax.md が存在し、status: completed であること

[2] プロファイル完備
    - 氏名（姓・名）が登録されているか
    - 住所が登録されているか
    - 所轄税務署名が登録されているか

[3] 決算書データ
    - PL/BS の計算結果が取得可能であること

[4] 消費税（該当者のみ）
    - .shinkoku/progress/08-consumption-tax.md が存在し、status: completed であること

[5] サニティチェック
    - `tax_calc.py sanity-check` を実行する
    - error > 0 の場合: 入力を中止し、`/income-tax` スキルで修正を促す
    - warning > 0 の場合: ユーザーに確認してから続行する

画面遷移フロー全体像

┌─────────────────────────────────────────────────────┐
│ CC-AA-010 税務署への提出方法の選択                      │
│   マイナンバーカード: はい → スマホ: はい               │
│   → 「スマートフォンを使用する」                        │
└──────────────┬──────────────────────────────────────┘
               ▼
┌─────────────────────────────────────────────────────┐
│ CC-AE-090 作成する申告書等の選択                        │
│   「決算書・収支内訳書（＋所得税）」を選択              │
│   → doSubmitCMW0900(2,'25')                           │
│                                                         │
│   ※ 消費税のみ別途作成する場合:                        │
│   → doSubmitCMW0900(3,'25')                           │
└──────────────┬──────────────────────────────────────┘
               ▼
┌─────────────────────────────────────────────────────┐
│ CC-AE-600 マイナポータル連携の選択                      │
│   → 「マイナポータル連携を利用しない」                  │
└──────────────┬──────────────────────────────────────┘
               ▼
┌─────────────────────────────────────────────────────┐
│ CC-AA-024 e-Taxを行う前の確認                           │
│   → 「利用規約に同意して次へ」                          │
└──────────────┬──────────────────────────────────────┘
               ▼
┌─────────────────────────────────────────────────────┐
│ CC-AA-440 QRコード認証                                  │
│   ★ ユーザーの物理的認証が必要                         │
│   スマートフォンでQRコード読み取り                      │
│   → マイナンバーカード認証完了後、自動遷移              │
└──────────────┬──────────────────────────────────────┘
               ▼
       ┌───────┴───────┐
       ▼               ▼
  決算書コーナー    所得税コーナー
  (事業所得あり)    (給与のみ等)

決算書コーナーのフロー

/kessan/ac/r7/top → ac0300（種類選択）→ aa0200（P/L入力）
  → aa0100（青色特別控除）→ preAoiroCalc（B/S入力）
  → aa0700（所得確認）→ ac0500（住所氏名）→ 印刷/保存
  → 所得税コーナーへ遷移

所得税コーナーのフロー

SS-AA-010a（所得選択）→ SS-AA-050（収入入力ハブ）
  → SS-CA-010（給与入力） / SS-CB-xxx（事業所得） / 雑所得
  → SS-AA-070a（控除1/2）→ SS-AA-080（控除2/2）
  → SS-AA-090（計算結果確認）
  → SS-AC-010a（納付方法）→ SS-AC-020a（住民税等）
  → SS-AC-030（基本情報）→ SS-AC-040（マイナンバー）
  → ステップ5.5（意思決定ゲート）→ ステップ6（電子署名・送信プロトコル）

消費税コーナーのフロー（所得税完了後）

所得税完了 → 「消費税の申告書作成はこちら」

2割特例:
  ac0100(条件判定) → ac0250(所得区分選択) → 売上入力hub → 売上入力detail
  → 売上入力hub → 中間納付 → ac0300(計算結果) → 納税地等
  → ステップ6.5（電子署名・送信プロトコル）

簡易課税:
  ac0100(条件判定) → ac0250(所得区分・事業区分選択) → 売上入力hub → 売上入力detail
  → 売上入力hub → ak2140(仕入税額控除方式選択)※ → 中間納付 → ac0300(計算結果)
  → 納税地等 → ステップ6.5（電子署名・送信プロトコル）
  ※ 2種以上の事業がある場合のみ

一般課税:
  ac0100(条件判定) → ac0250(所得区分選択) → 売上・仕入入力hub → 売上入力detail
  → ai3610(決算額テーブル)※ → 売上・仕入入力hub → 中間納付 → ac0300(計算結果)
  → 納税地等 → ステップ6.5（電子署名・送信プロトコル）
  ※ 積上げ計算選択時のみ

ステップ1: 確定申告書等作成コーナーへのアクセス

開始URL

https://www.keisan.nta.go.jp/kyoutu/ky/sm/top_web#bsctrl

CC-AA-010: 税務署への提出方法の選択

画面番号: CC-AA-010

  • 「マイナンバーカードをお持ちですか」→ 「はい」 ラジオボタンをクリック
  • 「マイナンバーカード読み取りに対応したスマートフォン又はICカードリーダライタをお持ちですか」→ 「はい」 をクリック
  • 「スマートフォンを使用する」 をクリック
  • JS: doSubmitCSW0100('1','3','/ky/sm/csw0100_myno_qr')

CC-AE-090: 作成する申告書等の選択

画面番号: CC-AE-090

選択肢（令和7年分）:

  • 所得税 → doSubmitCMW0900(1,'25')
  • 決算書・収支内訳書（＋所得税） → doSubmitCMW0900(2,'25') ← 事業所得ありの場合
  • 消費税 → doSubmitCMW0900(3,'25')
  • 贈与税 → doSubmitCMW0900(4,'25')

判断基準:

  • 事業所得あり → 「決算書・収支内訳書（＋所得税）」
  • 事業所得なし（給与のみ等）→ 「所得税」
  • 消費税は所得税完了後に別途作成

CC-AE-600: マイナポータル連携の選択

→ 「マイナポータル連携を利用しない」 をクリック

CC-AA-024: e-Taxを行う前の確認

→ 「利用規約に同意して次へ」 をクリック

※ 環境チェック termnalInfomationCheckOS_myNumberLinkage() が実行される。

Windows/macOS の Chrome/Edge であれば問題なし。

CC-AA-440: QRコード認証

★ ユーザー操作待ち — ブラウザ操作を一時停止

この画面ではエージェントがブラウザを操作してはならない。

AskUserQuestion ツールで一時停止し、ユーザーが認証完了を報告するまで絶対に次のステップに進まないこと。

AskUserQuestion で以下を表示する:

QRコード認証画面が表示されました。
スマートフォンのマイナポータルアプリでQRコードを読み取り、
マイナンバーカードで認証してください。

認証が完了したら「認証完了」を選択してください。
  • 選択肢: 「認証完了」 / 「QRコードが表示されない」
  • 「QRコードが表示されない」が選ばれた場合は下記の ⚠️ Playwright CLI 使用時の注意 を参照して対処する
  • ユーザーが「認証完了」を選択するまで、一切のブラウザ操作・画面遷移を行わない

認証完了後、自動的に次の画面に遷移する。

⚠️ Playwright CLI 使用時の注意: PLAYWRIGHT_MCP_INIT_SCRIPT 環境変数で etax-stealth.js を指定することで

サーバーベイク関数パッチが自動適用されるが、QR コードが表示されない場合はコンソールで getClientOS() の

戻り値を確認し、'Windows' でなければ以下を手動実行する:

window.getClientOS = function() { return 'Windows'; };
displayQrcode();

ステップ2: 青色申告決算書の入力（事業所得がある場合）

> ⚠️ ネイティブダイアログ注意: 「次へ」クリック後に画面が遷移しない場合、ネイティブダイアログ（alert/confirm）が表示されている可能性がある。技術的な知見の「ネイティブダイアログの検知と対処」を参照。

/kessan/ac/pre/ac0300: 決算書の種類選択

ラジオボタン:

  • 青色申告決算書 ← 青色申告の場合
  • 収支内訳書（白色申告の場合）
  • 青色申告決算書（現金主義用）

/kessan/ac/aa0200: 損益計算書（P/L）の入力

URL: https://www.keisan.nta.go.jp/kessan/ac/aa0200#bsctrl

期間の入力

| フィールド | name | デフォルト |

|-----------|------|-----------|

| 開始月 | sonekiKeisansyoFromMonth | 1 |

| 開始日 | sonekiKeisansyoFromDay | 1 |

| 終了月 | sonekiKeisansyoToMonth | 12 |

| 終了日 | sonekiKeisansyoToDay | 31 |

売上（収入）金額

「入力」ボタン → /kessan/ac/aa0201 売上仕入月別入力サブページに遷移。

aa0201 のフィールド:

  • uriageKingaku1〜uriageKingaku12: 月別売上
  • siireKingaku1〜siireKingaku12: 月別仕入
  • kajisyohi: 家事消費等
  • zatusyunyu: 雑収入

合計: uriageKingakuGokei, siireKingakuGokei

経費（行8〜31）

| 行 | 科目 | name（直接入力） | 備考 |

|----|------|-------------------|------|

| 8 | 租税公課 | sozeiKoka | |

| 9 | 荷造運賃 | nidukuriUntin | |

| 10 | 水道光熱費 | suidoKonetuhi | |

| 11 | 旅費交通費 | ryohiKotuhi | |

| 12 | 通信費 | tusinhi | |

| 13 | 広告宣伝費 | kokokuSendenhi | |

| 14 | 接待交際費 | settaiKosaihi | |

| 15 | 損害保険料 | songaiHokenryo | |

| 16 | 修繕費 | syuzenhi | |

| 17 | 消耗品費 | syomohinhi | |

| 18 | 減価償却費 | — | 「入力」→ /kessan/ac/init/aa0203 |

| 19 | 福利厚生費 | fukuriKoseihi | |

| 20 | 給料賃金 | — | 「入力」→ /kessan/ac/aa0205 |

| 21 | 外注工賃 | gaichukotin | |

| 22 | 利子割引料 | — | 「入力」→ /kessan/ac/aa0206 |

| 23 | 地代家賃 | — | 「入力」→ /kessan/ac/aa0207 |

| 24 | 貸倒金 | kasidaorekin | |

| 25 | 税理士等の報酬 | keihiNiniKingaku1 | 科目名: keihiNiniKamoku1 |

| 26 | 震災関連経費 | keihiNiniKingaku2 | 科目名: keihiNiniKamoku2 |

| 27-30 | 任意科目 | keihiNiniKingaku3〜6 | 科目名: keihiNiniKamoku3〜6 |

| 31 | 雑費 | zappi | |

集計 hidden フィールド: keihiSannyugakuGokei, kyuryoTinginTotalGokei, risiWaribikiryoGokei, tidaiYatinGokei

繰戻額等
  • kurimodosiNiniKamoku1/kurimodosiNiniKingaku1
  • kurimodosiNiniKamoku2/kurimodosiNiniKingaku2
専従者給与
  • senjusyaKyuyoTotalGokei (hidden、「入力」ボタンで別画面)
  • kasidaoreKuriireGokei (hidden)
計算結果（自動）
  • disp_aoiroKojomaeSyotokuKingaku = 売上 - 売上原価 - 経費 + 繰戻額 - 専従者給与等

/kessan/ac/submit/aa0100: 青色申告特別控除

Q&A形式で控除額を選択:

| 選択肢 | value | 条件 |

|--------|-------|------|

| 10万円 | 2 | |

| 55万円 | 3 | |

| 65万円 | 1 | e-Tax送信が必須。書面提出ではエラー KS-E10089 |

フィールド: aoiroTokubetuKojoSentakugaku

65万円を選択する場合、電子帳簿保存または e-Tax 送信が条件。

> ⚠️ ネイティブダイアログ注意: 65万円を選択して次へ進むと、書面提出の場合は KS-E10089（e-Tax送信が必要）のネイティブダイアログが表示される。画面が遷移しない場合はダイアログの有無をユーザーに確認すること。

貸借対照表（B/S）の入力

URL: /kessan/ac/preAoiroCalc

資産の部

配列形式: sisannobuTaisyohyoDetailDataList[N].kisyuKingaku / .kimatuKingaku

| index | 勘定科目 |

|-------|----------|

| 0 | 現金 |

| 1 | 当座預金 |

| 2 | 定期預金 |

| 3 | その他の預金 |

| 4 | 受取手形 |

| 5 | 売掛金 |

| 6 | 有価証券 |

| 7 | 棚卸資産 |

| 8 | 前払金 |

| 9 | 貸付金 |

| 10 | 建物 |

| 11 | 建物附属設備 |

| 12 | 機械装置 |

| 13 | 車両運搬具 |

| 14 | 工具器具備品 |

| 15 | 土地 |

| 16-23 | 任意科目 |

負債・資本の部

配列形式: fusainobuTaisyohyoDetailDataList[N].kisyuKingaku / .kimatuKingaku

| index | 勘定科目 |

|-------|----------|

| 0 | 支払手形 |

| 1 | 買掛金 |

| 2 | 借入金 |

| 3 | 未払金 |

| 4 | 前受金 |

| 5 | 預り金 |

| 6 | 貸倒引当金 |

| 7-15 | 任意科目 |

| 16 | 元入金 |

| 17 | 事業主借 |

| 18 | 事業主貸 |

| 19 | 青色申告特別控除前の所得金額（P/Lから自動） |

重要: 資産期末合計 = 負債期末合計 が必須（KS-E40003）

> ⚠️ ネイティブダイアログ注意: 資産期末合計と負債期末合計が一致しない状態で「次へ」を押すと、KS-E40003 のネイティブダイアログが表示される。画面が遷移しない場合はダイアログの有無をユーザーに確認すること。

/kessan/ac/ac0500: 住所・氏名等の入力

| フィールド | name |

|-----------|------|

| 郵便番号 | jitakuZip |

| 都道府県 | jitakuPrefectureId |

| 市区町村以下 | jitakuAddress |

| 事業所住所（該当者） | jimusyoAddress |

| 提出先税務署 | zeimusyoName |

| 氏名漢字（姓） | nameKanjiSei |

| 氏名漢字（名） | nameKanjiMei |

| 業種名 | gyosyuName |

| 屋号 | yago |

| 提出年月日 | teisyutuYear/teisyutuMonth/teisyutuDay |

決算書完了 → 所得税コーナーへ

印刷・データ保存画面（/kessan/ac/submit/ac0600）の

「所得税の申告書作成はこちら」ボタンで所得税コーナーに遷移（住所氏名引継ぎ）。

> ⚠️ ネイティブダイアログ注意: このボタンをクリックすると KS-W10035（印刷を確認したか）のネイティブダイアログが表示される場合がある。画面が遷移しない場合はダイアログの有無をユーザーに確認し、「OK」をクリックするよう案内すること。

ステップ3: 所得税の申告書入力

> ⚠️ ネイティブダイアログ注意: 「次へ」クリック後に画面が遷移しない場合、ネイティブダイアログ（alert/confirm）が表示されている可能性がある。技術的な知見の「ネイティブダイアログの検知と対処」を参照。

SS-AA-010a: 申告する所得の選択等

URL: https://www.keisan.nta.go.jp/r7/syotoku/taM010a40_doInitialDisplay#bbctrl

生年月日

| フィールド | name |

|-----------|------|

| 年 | inOutDto.shnkkBirthymdYy |

| 月 | inOutDto.shnkkBirthymdMm |

| 日 | inOutDto.shnkkBirthymdDd |

所得種類の選択（チェックボックス）

| 所得 | name | 典型的な選択 |

|------|------|-------------|

| 給与 | inOutDto.kyuy | 会社員: checked |

| 事業（営業等） | inOutDto.jgyoEgyoTo | 個人事業主: checked |

| 事業（農業） | inOutDto.jgyoNogyo | |

| 不動産 | inOutDto.fdosn | |

| 雑（業務・その他） | inOutDto.ztsGyomSnt | 暗号資産等: checked |

| 公的年金等 | inOutDto.kotkNnknKgyoNnknEtc | |

| 退職金 | inOutDto.tasyku | |

| 株式等 | inOutDto.hatoKbshkJyotRsh | |

| 先物取引 | inOutDto.skmnTrhk | |

| 一時 | inOutDto.ichj | |

shinkoku 対象の典型パターン:

  • 会社員＋副業（事業所得）: kyuy + jgyoEgyoTo + ztsGyomSnt（暗号資産あれば）
  • 給与所得のみ: kyuy

SS-AA-050: 収入・所得の入力ハブ

選択した所得種類ごとに入力リンクが表示される。各リンクをクリックして個別入力画面へ遷移。

SS-CA-010: 給与所得の源泉徴収票の入力

> 物理的な源泉徴収票との対応: 年末調整済みと年末調整未済で別フォーム・別ラベル体系。

> 年末調整済み = A〜L（12項目）、年末調整未済 = A〜E（5項目）。

> 物理的な源泉徴収票の「給与所得控除後の金額」「所得控除の額の合計額」欄は、

> 年末調整済みフォームでは入力不要だが、年末調整未済フォームでは B(自動)・C(入力) として存在する。

年末調整済みフォーム

URL: https://www.keisan.nta.go.jp/r7/syotoku/taS510a10_doAdd_nncyzm#bbctrl

主要入力フィールド

| ラベル | name | 備考 |

|--------|------|------|

| A: 支払金額 | inOutDto.shhraKngk | 必須 |

| B: 源泉徴収税額 | inOutDto.gnsnTyosyuZegk | 2段記載時は下段 |

| E: 社会保険料等の金額 | inOutDto.sykaHknryoToKngk | |

| K: 支払者の住所 | inOutDto.shhrasyJysyKysyOrSyzach | 28文字以内 |

| L: 支払者の氏名又は名称 | inOutDto.shhrasyNameOrMesyo | 28文字以内 |

ラジオボタン（記載有無の選択）

| フィールド | ラベル | name | 値 |

|-----------|--------|------|-----|

| 控除対象配偶者の記載 | C | inOutDto.kojyTashoHagsyKsaUm | 1(あり)/2(なし) |

| 控除対象扶養親族の記載 | D | inOutDto.kojyTashoFyoShnzkKsaUm | 1(あり)/2(なし) |

| 生命保険料控除額の記載 | F※ | inOutDto.semeHknryoKojygkKsaUm | 1(あり)/2(なし) |

| 地震保険料控除額の記載 | G※ | inOutDto.jshnHknryoKojygkKsaUm | 1(あり)/2(なし) |

| 住宅借入金等特別控除額の記載 | H※ | inOutDto.jyutkKrirknToTkbtsKojyGkKsaUm | 1(あり)/0(なし) |

| 所得金額調整控除額の記載 | I※ | inOutDto.sytkKngkTyoseKojygkKsaUm | 1(あり)/0(なし) |

| 本人が障害者・寡婦等 | J※ | inOutDto.hnninSygsyKfHtriyKnroGkseKsaUm | 1(あり)/2(なし) |

> ※ F〜J のラベルはフォーム上の並び順からの推定（スクリーンショット未確認）

条件付きフィールド（ラジオ/チェックで「記載あり」選択時に表示）

| ラベル | name | 表示条件 |

|--------|------|----------|

| B': 源泉徴収税額（内書き） | inOutDto.gnsnTyosyuZegkUchgk | チェック時 |

| 社会保険料等（内書き） | inOutDto.sykaHknryoToUchgk | チェック時 |

| 生命保険料控除額 | inOutDto.semeHknryoKojygk | F「記載あり」時 |

| 新生命保険料金額 | inOutDto.shnSemeHknryoKngk | F「記載あり」時 |

| 旧生命保険料金額 | inOutDto.kyuSemeHknryoKngk | F「記載あり」時 |

| 介護医療保険料金額 | inOutDto.kagIryoHknryoKngk | F「記載あり」時 |

| 新個人年金保険料金額 | inOutDto.shnKjnNnknHknryoKngk | F「記載あり」時 |

| 旧個人年金保険料金額 | inOutDto.kyuKjnNnknHknryoKngk | F「記載あり」時 |

| 地震保険料控除額 | inOutDto.jshnHknryoKojygk | G「記載あり」時 |

| 旧長期損害保険料金額 | inOutDto.kyuCyokSngaHknryoKngk | G「記載あり」時 |

| H: 住宅借入金等特別控除額 | inOutDto.jyutkKrirknToTkbtsKojyGk | H「記載あり」時 |

| H': 住宅借入金等特別控除可能額 | inOutDto.jyutkKrirknToTkbtsKojyknoGk | H「記載あり」時 |

| H'': 住宅借入金年末残高1回目 | inOutDto.jyutkKrirknToNnmtszndkIkkam | H「記載あり」時 |

| H''': 住宅借入金年末残高2回目 | inOutDto.jyutkKrirknToNnmtszndkNkam | チェック時 |

| 寡婦チェック | inOutDto.ksaArKforkf | J「記載あり」時 |

| 勤労学生チェック | inOutDto.ksaArKnroGkse | J「記載あり」時 |

年末調整未済フォーム

URL: 要確認

入力フィールド

| ラベル | name | 備考 |

|--------|------|------|

| A: 支払金額 | inOutDto.shhraKngk | 必須 |

| B: 給与所得控除後の金額 | （自動計算） | 入力不可。A から自動算出 |

| C: 所得控除の額の合計額 | 要確認 | 入力欄あり。源泉徴収票に記載があれば入力 |

| D: 源泉徴収税額 | inOutDto.gnsnTyosyuZegk | |

| E: 住宅借入金等特別控除額 | inOutDto.jyutkKrirknToTkbtsKojyGk | |

SS-AA-070a: 控除の入力（1/2）— 支出系控除

入力リンクのハブ画面。各控除をクリックして個別入力画面に遷移。

対応控除:

  • 社会保険料控除（源泉徴収票入力済みの場合「入力あり」表示）
  • 小規模企業共済等掛金控除（iDeCo等）
  • 生命保険料控除
  • 地震保険料控除
  • 雑損控除・災害減免
  • 医療費控除
  • 寄附金控除（ふるさと納税含む — ワンストップ特例分も要入力）

SS-AA-080: 控除の入力（2/2）— 人的控除・住宅控除等

対応控除:

  • 配偶者（特別）控除
  • 扶養控除・特定親族特別控除
  • 寡婦・ひとり親控除
  • 勤労学生控除
  • 障害者控除
  • 基礎控除（自動計算表示）
  • 住宅借入金等特別控除
  • 住宅耐震改修特別控除等
  • 予定納税額
  • 繰越損失額

SS-AA-090: 計算結果の確認

入力内容から計算された所得税額の確認画面。

表示項目:

  • 収入金額・所得金額（所得種類別）
  • 所得控除合計
  • 課税される所得金額（1,000円未満切捨て）
  • 上記に対する税額（速算表適用）
  • 差引所得税額
  • 復興特別所得税額（基準所得税額の2.1%）
  • 所得税及び復興特別所得税の額
  • 源泉徴収税額
  • 申告納税額（100円未満切捨て）/ 還付される税金

ここで shinkoku の計算結果と照合する（後述「ステップ5: 申告内容の確認」参照）。

各セクションに「訂正する」ボタンがあり、前画面に戻れる。

SS-AC-010a: 納付方法等の入力

納付金額が発生した場合に表示。還付の場合は還付口座入力画面（SS-AB-010a）が表示される。

| フィールド | type | name | 備考 |

|-----------|------|------|------|

| 延納を届け出る | checkbox | — | 利子税がかかる旨の注意あり |

| 納付方法 | select | inOutDto.nofHoho | 必須 |

納付方法の選択肢:

| value | 方法 |

|-------|------|

| 1 | 振替納税（期限内申告の場合に利用可） |

| 2 | 電子納税（ダイレクト納付/インターネットバンキング） |

| 3 | クレジットカード納付 |

| 5 | コンビニ納付 |

| 6 | 金融機関等での窓口納付 |

還付の場合は還付口座情報の入力:

  • 金融機関名、支店名、口座番号、口座名義

SS-AC-020a: 財産債務・住民税等

住民税に関する設定（給与からの特別徴収 or 自分で納付 等）。

SS-AC-030: 基本情報の入力

| ラベル | name | 備考 |

|--------|------|------|

| 氏名フリガナ（姓） | inOutDto.nameKnSe | 11文字以内 |

| 氏名フリガナ（名） | inOutDto.nameKnMe | |

| 氏名漢字（姓） | inOutDto.nameKnjSe | 10文字以内 |

| 氏名漢字（名） | inOutDto.nameKnjMe | |

| 電話番号（種別） | inOutDto.rnrkSkKbn | 自宅/勤務先/携帯 |

| 電話番号（市外） | inOutDto.shgaKykbn | |

| 電話番号（市内） | inOutDto.shnaKykbn | |

| 電話番号（番号） | inOutDto.knyusyBngo | |

| 納税地区分 | inOutDto.nozeCh | 1=住所地, 2=事業所等 |

| 郵便番号 | inOutDto.yubnBngoGnzaAddress | 7桁 |

| 都道府県 | inOutDto.tdofknGnzaAddress | select |

| 市区町村 | inOutDto.shkcyosnGnzaAddress | 都道府県連動 select |

| 丁目番地等 | inOutDto.cyomBnchToGnzaAddress | 28文字以内 |

| 建物名 | inOutDto.ttmnMeGoshtsGnzaAddress | 28文字以内 |

| 提出先税務署（県） | inOutDto.tesytSkZemsyTdofkn | select |

| 提出先税務署 | inOutDto.tesytSkZemsyZemsy | 県連動 select |

| 職業 | inOutDto.job | 11文字以内 |

| 屋号・雅号 | inOutDto.ygoGgo | 30文字以内 |

| 世帯主の氏名 | inOutDto.stanshNameKnj | |

| 続柄 | inOutDto.stanshKrTsdkgr | select |

| 提出年月日 | inOutDto.tesytYmdYy/Mm/Dd | |

SS-AC-040: マイナンバーの入力

マイナンバー（12桁）を入力する画面。チェックディジットアルゴリズムによる検証あり。

ステップ4: 消費税の申告書入力（該当者のみ）

> ⚠️ ネイティブダイアログ注意: 「次へ」クリック後に画面が遷移しない場合、ネイティブダイアログ（alert/confirm）が表示されている可能性がある。技術的な知見の「ネイティブダイアログの検知と対処」を参照。

所得税申告書の完了後、「他の申告書等を作成する」→ doSubmitCSW0900(3,'25') で消費税コーナーに遷移。

ac0100: 条件判定等

URL: https://www.keisan.nta.go.jp/syouhi/ac0100/submit.htmj#bsctrl

| フィールド | name | 備考 |

|-----------|------|------|

| 基準期間の課税売上高 | kijunKazeiUriage | R5年分 |

| インボイス発行事業者 | invoice | true/false |

| 簡易課税制度選択 | kani | true/false |

| 経理方式 | zeikomi | 税込/税抜 |

インボイス=はい の場合に追加表示

| フィールド | name | 備考 |

|-----------|------|------|

| 新たに課税事業者か | newKazeiJigyosya | true/false |

| 2割特例を適用するか | niwariTokurei | true/false |

一般課税の場合に追加表示

| フィールド | name | 備考 |

|-----------|------|------|

| 仕入税額の計算方法 | siireKeisanHouhou | warimodosi/tumiage |

条件判定画面の表示ロジック（基準期間による分岐）

kijunKazeiUriage（基準期間の課税売上高）の値によって表示される選択肢が変化する:

| 条件 | 新規課税事業者? | 2割特例? | 簡易課税? |

|------|---------------|---------|---------|

| 基準期間=0, invoice=はい | 表示 | 表示 | 非表示 |

| 基準期間=3,000,000, invoice=はい | 表示 | 表示 | 表示 |

| 基準期間=60,000,000, invoice=はい | 非表示 | 非表示 | 表示 |

一般課税のみ: 「税額の計算方法として積上げ計算を選択する方」ボタン（折りたたみセクション内）

分岐ロジック

| 条件 | 遷移先ルート |

|------|-------------|

| インボイス=はい & 2割特例=はい | 2割特例 |

| 簡易課税=はい | 簡易課税 |

| 上記以外 | 一般課税 |

ac0250: 所得区分の選択

URL: https://www.keisan.nta.go.jp/syouhi/ac0250/submit.htmj#bsctrl

該当する所得区分を全て選択する。ヘッダに課税方式（一般課税/簡易課税）と経理方式（税込/税抜）が表示される。

| ラベル | name | 備考 |

|--------|------|------|

| 事業所得（営業等） | jigyoSyotokuEigyo | メインターゲット |

| 事業所得（農業） | jigyoSyotokuNogyo | |

| 不動産所得 | fudosanSyotoku | |

| 雑所得（原稿料等） | zatuSyotoku | |

| 業務用固定資産等の譲渡所得 | jotoSyotoku | 一般課税のみ表示 |

簡易課税のみ: 事業区分の選択

簡易課税の場合、各所得区分に対して事業区分（第1種〜第6種）のサブ選択がある:

| フィールド | name | 備考 |

|-----------|------|------|

| 事業区分（第1種） | jigyoSyotokuEigyoJigyoKubun1 | 卸売業 |

| 事業区分（第2種） | jigyoSyotokuEigyoJigyoKubun2 | 小売業 |

| 事業区分（第3種） | jigyoSyotokuEigyoJigyoKubun3 | 製造業等 |

| 事業区分（第4種） | jigyoSyotokuEigyoJigyoKubun4 | その他 |

| 事業区分（第5種） | jigyoSyotokuEigyoJigyoKubun5 | サービス業等 |

| 事業区分（第6種） | jigyoSyotokuEigyoJigyoKubun6 | 不動産業 |

一般課税のみ: 業務用固定資産等

| フィールド | name | 備考 |

|-----------|------|------|

| 業務用固定資産等の購入がある | gyomuyosisanKonyu | checkbox |

売上入力（全ルート共通フォーム）

URL パターン:

  • 2割特例: /syouhi/at3600/inputEigyo.htmj
  • 簡易課税: /syouhi/ak3600/inputEigyo.htmj
  • 一般課税: /syouhi/ai3600/inputEigyo.htmj

| フィールド | name | 備考 |

|-----------|------|------|

| 売上（収入）金額 | uriageWari | 必須。税込総額 |

| 免税売上 | menzeiUriageWari | |

| 非課税売上 | hikazeiUriageWari | |

| 不課税取引 | jigyoFukazeiUriageWari | |

| 軽減税率（6.24%）適用分 | kazeiUriage624PercentWari | |

| 返還等対価（軽減） | uriageTaikaKeigen.uriageTaika624Percent | |

| 返還等対価（標準） | uriageTaikaKeigen.uriageTaika78Percent | |

| 貸倒れ発生（軽減） | kasidaoreKeigen.occurredKasidaore624Percent | 2割特例・簡易課税のみ |

| 貸倒れ発生（標準） | kasidaoreKeigen.occurredKasidaore78Percent | 2割特例・簡易課税のみ |

| 貸倒れ回収（軽減） | kasidaoreKeigen.recoveredKasidaore624Percent | 2割特例・簡易課税のみ |

| 貸倒れ回収（標準） | kasidaoreKeigen.recoveredKasidaore78Percent | 2割特例・簡易課税のみ |

| 貸倒れ発生有無 | kasidaore.occurredKasidaoreAns | 2割特例・簡易課税のみ (radio) |

一般課税のみの追加フィールド

| フィールド | name | 備考 |

|-----------|------|------|

| 非課税返還 | uriageTaikaKeigen.hikazeiHenkan | |

| 非課税資産の輸出等返還 | uriageTaikaKeigen.hikazeiSisanHenkan | |

中間納付税額等の入力（全ルート共通）

| name | 備考 |

|------|------|

| chukanNofuZei | 中間納付消費税額 |

| chukanNofuJotoWari | 中間納付譲渡割額 |

一般課税（積上げ計算）専用: 決算額テーブル

URL: /syouhi/ai3610/submit.htmj

積上げ計算選択時のみ表示される大規模フォーム（194項目）。

青色申告決算書の各勘定科目に対して、決算額・課税取引金額・軽減税率分・免税事業者等取引分を入力。

フィールド名パターン: {科目略称}{列略称}Wari (割戻し) / {科目略称}{列略称}Tumi (積上げ)

列略称: Kessan(決算額), KazeiIgai(課税取引にならないもの), Keigen624(軽減税率分), MenzeiKeigen(免税事業者等/軽減), Menzei(免税事業者等/標準)

| 科目 | プレフィックス |

|------|---------------|

| 仕入金額 | siire |

| 租税公課 | sozeiKoka |

| 荷造運賃 | nidukuri |

| 水道光熱費 | suido |

| 旅費交通費 | ryohi |

| 通信費 | tusin |

| 広告宣伝費 | kokoku |

| 接待交際費 | settai |

| 損害保険料 | songai |

| 修繕費 | syuzen |

| 消耗品費 | syomohin |

| 減価償却費 | genkasyokyaku |

| 福利厚生費 | fukurikosei |

| 給料賃金 | kyuryo |

| 外注工賃 | gaichu |

| 利子割引料 | risiWaribiki |

| 地代家賃 | jidai |

| 貸倒金 | kasidaore |

| 任意科目 | niniKamoku25〜30 |

| 雑費 | zappi |

テーブル下の Yes/No 質問（一般課税のみ）

| フィールド | name | 内容 |

|-----------|------|------|

| 発生した貸倒金 | kasidaoreKeigen.occurredKasidaoreAns | radio |

| 回収した貸倒金 | kasidaoreKeigen.recoveredKasidaoreAns | radio |

| 保税地域からの引取貨物 | hozeiKeigenIppan.hozeiAns | radio |

| 課税仕入れに係る対価の返還等 | siireTaikaKeigenIppan.siireTaikaAns | radio |

| 課税事業者になった方の棚卸高調整 | tanaorosiKeigenIppan.oldMenzeiJigyoshaAns | radio |

| 免税事業者になる方の棚卸高調整 | tanaorosiKeigenIppan.newMenzeiJigyoshaAns | radio |

簡易課税のみ: 仕入税額控除の控除方式の選択

URL: /syouhi/ak2140/submit.htmj

2種以上の事業を営む場合に表示される。以下から選択:

  • 原則計算
  • 特例計算（2種特例/3種特例/75%特例）

ac0300: 消費税計算結果の確認

全ルート共通の結果画面。ヘッダ部で「2割特例」「簡易課税」「一般課税」を表示。

表示項目:

  • 課税標準額
  • 消費税額
  • 控除税額小計
  • 差引税額（100円未満切捨て）
  • 中間納付税額
  • 納付税額
  • 地方消費税 譲渡割額（= 差引税額 × 22/78、100円未満切捨て）
  • 中間納付譲渡割額
  • 合計納付税額
一般課税のみの追加表示項目
  • 「控除過大調整税額」
  • 「課税売上割合」セクション（課税資産の譲渡等の対価の額 / 資産の譲渡等の対価の額）

消費税 納税地等の入力

URL パターン（ルートごとに異なる）:

  • 2割特例: /syouhi/at1400/submit.htmj
  • 簡易課税: /syouhi/ak1400/submit.htmj
  • 一般課税: /syouhi/ai1400/submit.htmj

画面は全ルートで同一構造（pageId=ac0400）。

| フィールド | name | type | 備考 |

|-----------|------|------|------|

| 納付方法 | nofuHohoType | select | |

| 納税地区分 | nozeitiKubun | radio | |

| 郵便番号1 | nozeitiZipCode1 | text | |

| 郵便番号2 | nozeitiZipCode2 | text | |

| 都道府県 | nozeitiPrefectureCode | select | 住所用コード: 13=東京都 |

| 市区町村 | municipalityCode | select | |

| 丁目番地等 | nozeiti1ElaseMunicipal | text | |

| 税務署都道府県 | prefectureCode | select | 税務署用コード: 15=東京都 ← 住所と異なるコード体系! |

| 税務署 | sinkokuZeimusyoCode | select | |

| 氏名カナ（姓） | simeiKanaSei | text | |

| 氏名カナ（名） | simeiKanaMei | text | |

| 氏名漢字（姓） | simeiKanjiSei | text | |

| 氏名漢字（名） | simeiKanjiMei | text | |

| マイナンバー1 | myNumber1 | password | |

| マイナンバー2 | myNumber2 | password | |

| マイナンバー3 | myNumber3 | password | |

| 電話番号1 | telNumber1 | text | |

| 電話番号2 | telNumber2 | text | |

| 電話番号3 | telNumber3 | text | |

⚠️ 注意: 住所の都道府県コード（nozeitiPrefectureCode: 13=東京都）と税務署の都道府県コード（prefectureCode: 15=東京都）で異なるコード体系が使用されている。

消費税 計算結果のテストデータ

| 項目 | 2割特例 (売上5M) | 簡易課税 第5種 (売上5M) | 一般課税 (売上66M, 仕入0) |

|-----|----------------|----------------------|------------------------|

| 課税標準額 | 4,545,000円 | 4,545,000円 | 60,000,000円 |

| 消費税額 | 354,510円 | 354,510円 | 4,680,000円 |

| 控除税額 | 283,608円 (×80%) | 177,255円 (×50%) | 0円 |

| 差引税額 | 70,900円 | 177,200円 | 4,680,000円 |

| 地方消費税譲渡割額 | 19,900円 | 49,900円 | 1,320,000円 |

| 合計納付 | 90,800円 | 227,100円 | 6,000,000円 |

3ルートの計算方式の違い

| 項目 | 2割特例 | 簡易課税 | 一般課税 |

|------|---------|----------|----------|

| 控除税額 | 消費税額×80% | みなし仕入率 | 実額（割戻し or 積上げ） |

| 仕入入力 | 不要 | 不要 | 割戻し: 不要 / 積上げ: 決算額テーブル |

| URL prefix | /at | /ak | /ai |

> ⚠️ ネイティブダイアログ注意: 消費税コーナー終了時は 2段階のネイティブダイアログが表示される — #otherTax（他の申告書等を作成しますか？）と #end（終了してもよろしいですか？）。画面が遷移しない場合はダイアログの有無をユーザーに確認し、それぞれ適切にクリックするよう案内すること。

ステップ5: 申告内容の確認

作成コーナーの確認画面で、shinkoku の計算結果と一致しているか検証する。

検証項目

□ 合計所得金額が一致するか
□ 所得控除合計が一致するか
□ 課税所得金額が一致するか
□ 算出税額が一致するか
□ 税額控除が一致するか
□ 復興特別所得税が一致するか
□ 申告納税額（または還付額）が一致するか
□ 消費税の納付税額が一致するか（該当者のみ）

不一致がある場合は、差異の原因を調査し、ユーザーに報告する。

ステップ5.5: .data ファイルの保存と次ステップの選択（意思決定ゲート）

★ ユーザー確認待ち — 明示的な指示なくステップ6（電子署名・送信）に進んではならない

> 2段階ゲート構造: ステップ5.5 は「送信フェーズに進むかどうかの意思決定ゲート」。

> ステップ6-3 は「送信ボタン直前の操作ゲート（AI は送信しない、ユーザーが手動で送信する）」。

> 両方のゲートを通過しない限り、送信は実行されない。

申告内容の確認が完了した時点で、以下の手順を実行する。

.data ファイルのダウンロード案内

ユーザーに .data ファイルの保存を案内する:

申告内容の入力と確認が完了しました。

電子署名・送信に進む前に、入力データを .data ファイルとして保存することを強く推奨します。
画面上部の「入力データの一時保存」ボタン（またはページ下部の「ここまでの入力データを保存する」リンク）
をクリックし、ファイルをダウンロードしてください。

次の操作の選択

AskUserQuestion で以下を表示する:

次の操作を選択してください。
  • 選択肢:
  • 「電子署名・送信に進む」→ ステップ6 へ
  • 「入力内容を見直す」→ 見直したいステップを確認し、該当ステップに戻る
  • 「ここで中断する」→ 中断・再開プロトコルの中断手順に従い終了する

重要: ユーザーが「電子署名・送信に進む」を明示的に選択するまで、絶対にステップ6に進まないこと。

ステップ6: 電子署名と送信（所得税）

前提: ステップ5.5 でユーザーが「電子署名・送信に進む」を選択済みであること。この前提が満たされていない場合はステップ5.5 に戻る。

6-1: 電子署名（ユーザーの手動操作）

マイナンバーカードで電子署名する。署名用パスワード（6〜16桁の英数字）が必要。

★ ユーザー操作待ち — ブラウザ操作を一時停止

AskUserQuestion で以下を表示する:

電子署名の画面に進みます。
マイナンバーカードで電子署名を行ってください。

署名が完了したら「署名完了」を選択してください。
  • 選択肢: 「署名完了」 / 「署名で問題が発生した」
  • ユーザーが「署名完了」を選択するまで、一切のブラウザ操作を行わない

6-2: 送信前確認ページでの一次確認

電子署名完了後、送信前の最終確認ページが表示される。

  • ブラウザ上の確認ページの内容を読み取る
  • 主要項目をユーザーに報告する（収入・所得・税額・納付/還付額など）
  • shinkoku の計算結果との照合結果を報告する

6-3: ブラウザ操作の一時停止（送信はユーザー操作）

★★★ 絶対に AI が送信ボタンをクリックしてはならない ★★★

★★★ ユーザーが「送信完了」を選択するまで、一切のブラウザ操作を行わない ★★★

★ ユーザー操作待ち — ブラウザ操作を一時停止

AskUserQuestion で以下を表示する:

送信前の申告内容確認ページが表示されています。
上記の内容をご確認ください。

問題がなければ、ご自身の操作で画面上の「送信を実行する」ボタンを
クリックしてください。

送信が完了したら「送信完了」を選択してください。
  • 選択肢: 「送信完了」 / 「入力内容を見直したい」
  • 「入力内容を見直したい」が選ばれた場合は、見直したい箇所を確認し、該当ステップに戻る

6-4: 送信後の処理（Claude 再開）

ユーザーが「送信完了」を選択したら:

  • 受付番号の記録 — 画面から受付番号を読み取って記録する
  • 受信通知の確認 — メッセージボックスで受信通知を確認する
  • 消費税の申告 — 消費税の申告が必要な場合はステップ6.5 に進む。不要な場合はステップ7 に進む

注意事項

  • 送信後の修正は「修正申告」として再提出が必要
  • ★★★ 送信操作は必ずユーザーの手動操作で行う — エージェントが送信ボタンを自動クリックすることは絶対に禁止 ★★★

ステップ6.5: 消費税の電子署名と送信（該当者のみ）

消費税の申告が必要な場合、所得税の送信完了後に消費税コーナーで申告書を作成する（ステップ4）。

消費税の入力・確認が完了したら、以下の送信プロトコルに従う。

6.5-1: 消費税の送信フェーズに進む前の確認

消費税の計算結果確認（ac0300）と納税地等の入力が完了した時点で、以下を実行する。

★ ユーザー確認待ち — 明示的な指示なく電子署名・送信に進んではならない

AskUserQuestion で以下を表示する:

消費税の申告内容の入力と確認が完了しました。

電子署名・送信に進む前に、入力データを .data ファイルとして保存することを強く推奨します。
画面上部の「入力データの一時保存」ボタンをクリックし、ファイルをダウンロードしてください。

次の操作を選択してください。
  • 選択肢:
  • 「電子署名・送信に進む」→ 6.5-2 へ
  • 「入力内容を見直す」→ 見直したい箇所を確認し、該当ステップに戻る
  • 「ここで中断する」→ 中断・再開プロトコルの中断手順に従い終了する

重要: ユーザーが「電子署名・送信に進む」を明示的に選択するまで、絶対に送信フェーズに進まないこと。

6.5-2: 電子署名（ユーザーの手動操作）

マイナンバーカードで電子署名する。

★ ユーザー操作待ち — ブラウザ操作を一時停止

AskUserQuestion で以下を表示する:

消費税の電子署名の画面に進みます。
マイナンバーカードで電子署名を行ってください。

署名が完了したら「署名完了」を選択してください。
  • 選択肢: 「署名完了」 / 「署名で問題が発生した」
  • ユーザーが「署名完了」を選択するまで、一切のブラウザ操作を行わない

6.5-3: 送信前確認ページでの一次確認

電子署名完了後、送信前の最終確認ページが表示される。

  • ブラウザ上の確認ページの内容を読み取る
  • 主要項目をユーザーに報告する（課税標準額・消費税額・差引税額・地方消費税・合計納付税額など）
  • shinkoku の計算結果との照合結果を報告する

6.5-4: ブラウザ操作の一時停止（送信はユーザー操作）

★★★ 絶対に AI が送信ボタンをクリックしてはならない ★★★

★★★ ユーザーが「送信完了」を選択するまで、一切のブラウザ操作を行わない ★★★

★ ユーザー操作待ち — ブラウザ操作を一時停止

AskUserQuestion で以下を表示する:

消費税の送信前確認ページが表示されています。
上記の内容をご確認ください。

問題がなければ、ご自身の操作で画面上の「送信を実行する」ボタンを
クリックしてください。

送信が完了したら「送信完了」を選択してください。
  • 選択肢: 「送信完了」 / 「入力内容を見直したい」
  • 「入力内容を見直したい」が選ばれた場合は、見直したい箇所を確認し、該当ステップに戻る

6.5-5: 送信後の処理（Claude 再開）

ユーザーが「送信完了」を選択したら:

  • 受付番号の記録 — 画面から受付番号を読み取って記録する
  • 受信通知の確認 — メッセージボックスで受信通知を確認する
  • ステップ7 の .data ファイル保存案内に進む

ステップ7: .data ファイルの保存案内

作成コーナーでは申告データを .data ファイルとして保存できる。

送信後の .data ファイル再保存（推奨）

送信完了後の .data ファイルには受付番号・送信日時等の追加情報が含まれる。

ステップ5.5 で保存済みであっても、送信後に改めて .data ファイルを再保存することを推奨する。

AskUserQuestion で以下を表示する:

送信が完了しました。送信後の .data ファイルには受付番号等の情報が追加されています。
「入力データを保存する」で .data ファイルを再度ダウンロードすることを推奨します。

ダウンロードが完了したら「ダウンロード済み」を選択してください。
  • 選択肢: 「ダウンロード済み」 / 「スキップ」

.data ファイルの用途

  • .data ファイルがあれば、次回は「保存データを利用して作成」から途中再開できる
  • 控えとしても有用（来年の申告時に前年データとして参照可能）
  • 修正申告が必要になった場合、.data ファイルから入力データを復元できる

技術的な知見

SPA構造

  • jQuery 3 + jQuery UI ベース
  • ページ遷移はフォーム POST（document.forms[formName].submit()）
  • ハッシュ #bsctrl（決算書コーナー）/ #bbctrl（所得税コーナー）はページ管理用
  • <input type="button"> が多用されており、id="input_xxx" で JS .click() 操作

URL体系

| コーナー | URL パターン |

|---------|-------------|

| 共通（認証等） | /kyoutu/ky/sm/*** |

| 決算書 | /kessan/ac/*** |

| 所得税 | /r7/syotoku/*** |

| 消費税（共通） | /syouhi/ac |

| 消費税（2割特例） | /syouhi/at |

| 消費税（一般課税） | /syouhi/ai |

| 消費税（簡易課税） | /syouhi/ak |

主要ナビゲーション関数

  • doSubmitCSW0100(qrCodeReadingFlag, reportType, url) — 認証方法選択
  • doSubmitCMW0900(zeimokuType, year) — 申告書種類選択（1=所得税, 2=決算書, 3=消費税, 4=贈与税）

確認ダイアログ

| コード | 内容 | 対応 |

|--------|------|------|

| KS-W90011 | 入力データが初期化される | OK で続行 |

| KS-W90006 | 入力データをクリアする | OK で続行 |

| KS-W10035 | 印刷を確認したか | OK で続行 |

| KS-E10089 | e-Tax送信が必要（65万円控除） | e-Tax ルートで再実行 |

| KS-E10001 | 必須入力チェック | 入力漏れを修正 |

| KS-E40003 | B/S 資産期末合計 ≠ 負債期末合計 | 金額を修正 |

終了ダイアログフロー

消費税コーナー終了時は2段階のダイアログが表示される:

  • #otherTax — 「他の申告書等を作成しますか？」
  • #end — 「終了してもよろしいですか？」

※ 書面提出選択時はサーベイダイアログが毎回表示される（セッション間で記憶されない）

ネイティブダイアログの検知と対処

Claude in Chrome は alert() / confirm() / prompt() によるネイティブダイアログを検知できない。

ダイアログが表示されている間、ブラウザの DOM 操作はブロックされるため、エージェントの操作が無応答になる。

検知ヒューリスティック

ボタンクリック後に以下の状態が続く場合、ネイティブダイアログが表示されている可能性がある:

  • URL が変化しない
  • DOM の内容が変化しない（新しい画面に遷移しない）
  • ボタンのクリックが何も起こさないように見える
対処手順
  • ダイアログの可能性を検知したら、AskUserQuestion で以下を表示する:
ボタンをクリックしましたが、画面が遷移しません。
ブラウザにポップアップ（確認ダイアログ）が表示されていませんか？

表示されている場合は、ダイアログの内容（コード番号がある場合はそれも）を教えてください。
  • 選択肢: 「ダイアログが表示されている」 / 「ダイアログは表示されていない」
  • ダイアログが表示されている場合:
  • ユーザーにダイアログのメッセージ内容を確認する
  • 既知のコード（上記「確認ダイアログ」テーブルの KS-W*, KS-E* 等）に該当するか照合する
  • KS-W 系（警告）: ユーザーに「OK」をクリックするよう案内
  • KS-E 系（エラー）: エラー内容に応じた修正を案内
  • 不明なダイアログ: ユーザーにメッセージ全文を共有してもらい、対処を判断
  • ダイアログが表示されていない場合:
  • ネットワークエラーやページ読み込み中の可能性を調査する
  • ページの再読み込みを試みる
ダイアログが発生しやすい操作

| 操作 | 想定ダイアログ | ステップ |

|------|--------------|---------|

| 「次へ進む」クリック全般 | KS-E10001（必須入力チェック） | 2, 3, 4 |

| 65万円控除の選択 | KS-E10089（e-Tax送信必須） | 2 |

| B/S 入力後の「次へ」 | KS-E40003（資産≠負債） | 2 |

| 決算書完了→所得税遷移 | KS-W10035（印刷確認） | 2→3 |

| 消費税コーナー終了 | #otherTax + #end（2段階） | 4 |

| データクリア・初期化操作 | KS-W90011, KS-W90006 | 全般 |

環境チェック（参考）

確定申告書等作成コーナーの推奨環境:

  • Windows 11 + Chrome / Edge
  • macOS + Safari

Linux は公式非対応。OS 検出は 2層 で行われるため、回避にも2層の偽装が必要:

  • クライアントサイド検出: CC-AA-024 の画面遷移時に termnalInfomationCheckOS_myNumberLinkage() が

navigator.platform / navigator.userAgent を検査し、Linux 環境では isTransition=false となり

QR コード認証画面（CC-AA-440）への遷移がブロックされる。

  • サーバーサイド OS ベイク: サーバーが HTTP リクエストの User-Agent / sec-ch-ua-platform ヘッダ

から OS を判定し、レスポンス内の getClientOS() 関数に const os = "Linux" のようにハードコードする

（サーバーサイドレンダリング）。addInitScript による navigator プロパティ偽装ではこのベイク値は変わらない。

CC-AA-440 の displayQrcode() でも getClientOS() が呼ばれ、oStUseType を決定する

（Win='3', Mac='4'）。Linux だと undefined になり QR コードが描画されない。

etax-stealth.js の2層偽装

PLAYWRIGHT_MCP_INIT_SCRIPT 環境変数で etax-stealth.js を指定して回避可能:

PLAYWRIGHT_MCP_INIT_SCRIPT=skills/e-tax/scripts/etax-stealth.js \
  playwright-cli -s=etax open https://www.keisan.nta.go.jp/ --headed --browser=chrome

層 1: navigator プロパティ偽装（addInitScript で実行、ページ読み込み前）

| プロパティ | 偽装値 |

|-----------|--------|

| navigator.platform | 'Win32' |

| navigator.userAgent | Windows Chrome 131 UA |

| navigator.userAgentData | Windows Chrome Client Hints |

How to use it

Copy the folder

Take kazukinagata/e-tax from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.