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: ブラウザ操作の一時停止（送信はユーザー操作）

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

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
`navigator.webdriver`	`false`
`navigator.plugins`	Chrome 標準プラグイン
`navigator.languages`	`['ja', 'en-US', 'en']`

層 2: サーバーベイク関数のパッチ（DOMContentLoaded で実行、ページスクリプト後）

パッチ対象	偽装値	目的
`getClientOS()`	`'Windows'`	サーバーベイク値の上書き
`getClientOSVersionAsync()`	`'Windows 11'`	OS バージョン判定の回避
`isRecommendedOsAsEtaxAsync()`	`true`	推奨 OS 判定の回避
`isRecommendedBrowserAsEtaxAsync()`	`'OK'`	推奨ブラウザ判定の回避

トラブルシューティング: QR コードが表示されない

CC-AA-440 で QR コードが表示されない場合、displayQrcode() 内で getClientOS() が 'Linux' 等を返し、 oStUseType が undefined になっている可能性がある。

確認方法: ブラウザコンソールで getClientOS() の戻り値を確認。'Windows' でなければパッチが適用されていない。

手動対処（Playwright CLI の場合）:

playwright-cli -s=etax run-code 'window.getClientOS = function() { return "Windows"; }; displayQrcode();'

検証済み画面遷移フロー

CC-AA-010 → CC-AE-090 → CC-AE-600 → CC-AA-024 → CC-AA-440（QR 表示確認済み）

詳細は docs/wsl-os-detection-workaround.md を参照。

引継書の出力

全ステップ完了後、以下のファイルを Write ツールで出力する。

ステップ別ファイルの出力

.shinkoku/progress/10-etax.md に以下の形式で出力する:

---
step: 10
skill: e-tax
status: completed
completed_at: "{当日日付 YYYY-MM-DD}"
fiscal_year: {tax_year}
---

# e-Tax 電子申告の結果

## 提出方法

- 確定申告書等作成コーナー（Claude in Chrome 入力代行）

## 税額サマリー

- 事業所得: {金額}円
- 課税所得: {金額}円
- 所得税額: {金額}円
- 申告納税額: {金額}円（{納付/還付}）
- 消費税納付額: {金額}円（該当者のみ）

## 送信結果

- 受付番号: {受付番号}
- 送信日時: {日時}

## 次のステップ

/submit で提出後のチェックリストを確認する

進捗サマリーの更新

.shinkoku/progress/progress-summary.md を更新する（存在しない場合は新規作成）:

YAML frontmatter: fiscal_year、last_updated（当日日付）、current_step: e-tax
テーブル: 全ステップの状態を更新（e-tax を completed に）

免責事項

確定申告書等作成コーナーの画面構成・フォーム要素は国税庁の更新により変更される可能性がある
Claude in Chrome の入力代行はユーザーの目視確認を前提とする — 自動送信は行わない
マイナンバーカードの操作（電子署名）はユーザーの手動操作が必要
最終的な申告内容は税理士等の専門家に確認することを推奨する

調査資料

詳細なセレクタ情報・スクリーンショットは skills/e-tax/research/ ディレクトリを参照:

00-screen-flow-summary.md — 画面遷移マップ
01〜05 — 認証フロー画面
06〜14 — 決算書コーナー画面
30〜41 — 所得税コーナー画面
50〜55 — 消費税コーナー画面（初期調査）
84〜87 — 消費税 2割特例（条件判定、売上入力、計算結果）
89〜93 — 消費税簡易課税（条件判定、事業区分、売上入力、控除方式、計算結果）
94〜98 — 消費税一般課税（条件判定、所得区分、売上入力、決算額テーブル、計算結果）

e-tax

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

前提条件

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

方式 A: Claude in Chrome（推奨）

方式 B: Antigravity Browser Sub-Agent

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

判定ロジック

方式 B 使用時の操作方法

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

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

進捗情報の読み込み

中断・再開プロトコル

中断手順

再開手順

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

検証項目

画面遷移フロー全体像

決算書コーナーのフロー

所得税コーナーのフロー

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

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

開始URL

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

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

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

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

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

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

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

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

期間の入力

売上（収入）金額

経費（行8〜31）

繰戻額等

専従者給与

計算結果（自動）

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

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

資産の部

負債・資本の部

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

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

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

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

生年月日

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

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

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

年末調整済みフォーム

主要入力フィールド

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

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

年末調整未済フォーム

入力フィールド

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: マイナンバーの入力

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

ac0100: 条件判定等

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

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

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

分岐ロジック

ac0250: 所得区分の選択

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

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

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

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

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

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

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

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

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

一般課税のみの追加表示項目

消費税 納税地等の入力

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

消費税納税地等の入力

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

`etax-stealth.js` の2層偽装