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 browser-based input of calculated tax data. Trigger phrases include: "e-Tax提出", "電子申告", "e-Taxで申告", "作成コーナーに入力", "確定申告書等作成コーナー", "作成コーナー", "申告書を提出".

Zur Installation springen

Repository: majiayu000/claude-skill-registry
Letzte Quellaktivität: 23. Juni 2026 um 12:15
Erkannte Sprache von SKILL.md: Japanisch
Sterne: 543
Forks: 85

Installationsoptionen

Standardmäßig ist der Prompt ausgewählt, der zuerst die Quelle prüft. Sie können zu einem direkten Befehl wechseln oder eine lokale Kopie herunterladen.

Mit Codex oder Claude installieren Kopieren Sie diesen Prompt, fügen Sie ihn in Codex, Claude oder einen anderen Assistant ein und lassen Sie die Skill-Seite prüfen und installieren.

Ein direkter Befehl überspringt den Prüf-Prompt. Prüfen Sie die Quelle, bevor Sie ihn ausführen.

npx skills add https://github.com/majiayu000/claude-skill-registry --skill e-tax

Der Befehl bleibt in einer Zeile. Scrollen Sie horizontal, um ihn vor dem Kopieren vollständig zu prüfen.

Sie bevorzugen eine lokale Kopie? Laden Sie die Dateien herunter, die SkillsMP derzeit vorliegen.

Quelldateien prüfen

Lesen Sie SKILL.md und alle von SkillsMP angezeigten Begleitdateien, bevor Sie sich für eine Installation entscheiden.

Datei-Explorer

2 Dateien

SKILL.md

Quellanweisungen · Schreibgeschützte Vorschau

Zurück zur Suche Zurück zur Installation

llm-calibration-logprobs

LLM token logprobs and calibration. Per-decision confidence, ECE, Brier, reliability diagrams, low-confidence triage.

2026-07-13

llm-calibration-logprobs

Analyze LLM token logprobs and calibration. Use for per-decision confidence, ECE, Brier scores, reliability diagrams, and low-confidence triage.

2026-07-13

recap

回顾最近 N 天的 Claude Code 使用记录——扫描原始会话数据，按主题分组汇总"我都做了什么"，并从个人操作系统视角输出模式、风险与增删建议。当用户说 /recap、"看看我这几天做了什么"、"回顾一下我最近的会话"、"这两天我用 claude 干了啥"、"活动回顾" 时使用。

2026-07-13

Alle aus diesem Repository ansehen

Datei-Explorer

2 Dateien

SKILL.md

Quellanweisungen · Schreibgeschützte Vorschau

name

e-tax

description

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`	科目名: 〜

集計 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: 給与所得の源泉徴収票の入力

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

主要入力フィールド

ラベル	name	備考
A: 支払金額	`inOutDto.shhraKngk`	必須
D: 源泉徴収税額	`inOutDto.gnsnTyosyuZegk`
社会保険料等の金額	`inOutDto.sykaHknryoToKngk`
G: 支払者の住所	`inOutDto.shhrasyJysyKysyOrSyzach`	28文字以内
H: 支払者の氏名又は名称	`inOutDto.shhrasyNameOrMesyo`	28文字以内

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

ラベル	name	表示条件
生命保険料控除額	`inOutDto.semeHknryoKojygk`	`semeHknryoKojygkKsaUm=1`
新生命保険料金額	`inOutDto.shnSemeHknryoKngk`	上記あり
旧生命保険料金額	`inOutDto.kyuSemeHknryoKngk`	上記あり
介護医療保険料金額	`inOutDto.kagIryoHknryoKngk`	上記あり
新個人年金保険料金額	`inOutDto.shnKjnNnknHknryoKngk`	上記あり
旧個人年金保険料金額	`inOutDto.kyuKjnNnknHknryoKngk`	上記あり
地震保険料控除額	`inOutDto.jshnHknryoKojygk`	`jshnHknryoKojygkKsaUm=1`
住宅借入金等特別控除額	`inOutDto.jyutkKrirknToTkbtsKojyGk`	`jyutkKrirknToTkbtsKojyGkKsaUm=1`

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

フィールド	name	値
控除対象配偶者の記載	`inOutDto.kojyTashoHagsyKsaUm`	1(あり)/2(なし)
控除対象扶養親族の記載	`inOutDto.kojyTashoFyoShnzkKsaUm`	1(あり)/2(なし)
生命保険料控除額の記載	`inOutDto.semeHknryoKojygkKsaUm`	1(あり)/2(なし)
地震保険料控除額の記載	`inOutDto.jshnHknryoKojygkKsaUm`	1(あり)/2(なし)
住宅借入金等特別控除額の記載	`inOutDto.jyutkKrirknToTkbtsKojyGkKsaUm`	1(あり)/0(なし)

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 — 消費税一般課税（条件判定、所得区分、売上入力、決算額テーブル、計算結果）

name

e-tax

description

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

前提条件

/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 で以下を表示する:

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

認証が完了したら「認証完了」を選択してください。

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

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

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`	科目名: 〜

集計 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: 給与所得の源泉徴収票の入力

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

主要入力フィールド

ラベル	name	備考
A: 支払金額	`inOutDto.shhraKngk`	必須
D: 源泉徴収税額	`inOutDto.gnsnTyosyuZegk`
社会保険料等の金額	`inOutDto.sykaHknryoToKngk`
G: 支払者の住所	`inOutDto.shhrasyJysyKysyOrSyzach`	28文字以内
H: 支払者の氏名又は名称	`inOutDto.shhrasyNameOrMesyo`	28文字以内

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

ラベル	name	表示条件
生命保険料控除額	`inOutDto.semeHknryoKojygk`	`semeHknryoKojygkKsaUm=1`
新生命保険料金額	`inOutDto.shnSemeHknryoKngk`	上記あり
旧生命保険料金額	`inOutDto.kyuSemeHknryoKngk`	上記あり
介護医療保険料金額	`inOutDto.kagIryoHknryoKngk`	上記あり
新個人年金保険料金額	`inOutDto.shnKjnNnknHknryoKngk`	上記あり
旧個人年金保険料金額	`inOutDto.kyuKjnNnknHknryoKngk`	上記あり
地震保険料控除額	`inOutDto.jshnHknryoKojygk`	`jshnHknryoKojygkKsaUm=1`
住宅借入金等特別控除額	`inOutDto.jyutkKrirknToTkbtsKojyGk`	`jyutkKrirknToTkbtsKojyGkKsaUm=1`

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

フィールド	name	値
控除対象配偶者の記載	`inOutDto.kojyTashoHagsyKsaUm`	1(あり)/2(なし)
控除対象扶養親族の記載	`inOutDto.kojyTashoFyoShnzkKsaUm`	1(あり)/2(なし)
生命保険料控除額の記載	`inOutDto.semeHknryoKojygkKsaUm`	1(あり)/2(なし)
地震保険料控除額の記載	`inOutDto.jshnHknryoKojygkKsaUm`	1(あり)/2(なし)
住宅借入金等特別控除額の記載	`inOutDto.jyutkKrirknToTkbtsKojyGkKsaUm`	1(あり)/0(なし)

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

フィールド名パターン: {科目略称}{列略称}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

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

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

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

AskUserQuestion で以下を表示する:

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

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

送信が完了したら「送信完了」を選択してください。

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

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

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

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

注意事項

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

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

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 ファイル再保存（推奨）

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 — 「終了してもよろしいですか？」

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

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

検知ヒューリスティック

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

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 — 消費税一般課税（条件判定、所得区分、売上入力、決算額テーブル、計算結果）

keihiNiniKamoku3

6

e-tax

Quellinformationen

Installationsoptionen

Quelldateien prüfen

Mehr aus diesem Repository

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層偽装