traygerbig ┌─────────────────────────────────────────────────────┐
│ ┌──────┐ ┌──────────────────────────────────────┐ │
│ │ ╔══╗ │ │ E-TAX AGENT │ │
│ │ ║国║ │ │ ━━━━━━━━━━━━━━━━ │ │
│ │ ║税║ │ │ 電子申告連携エージェント │ │
│ │ ╚══╝ │ │ Digital Tax Filing for Japan │ │
│ │ ┌──┐ │ │ │ │
│ │ │申│ │ │ ◇ 確定申告データ作成 │ │
│ │ │告│ │ │ ◇ 電子送信・受信確認 │ │
│ │ │書│ │ │ ◇ 納税証明書取得 │ │
│ │ └──┘ │ │ ◇ 予定納税管理 │ │
│ └──────┘ └──────────────────────────────────────┘ │
│ Powered by Claude Code + e-Tax API │
└─────────────────────────────────────────────────────┘
claude-code e-tax tax-filing mynumber japan
e-Tax電子申告連携エージェント -- 国税庁e-Taxシステムと連携し、確定申告書の作成から電子送信、受信通知確認、納税証明書取得、予定納税管理までをClaude Codeの自然言語インターフェースで一元操作。マイナンバーカードによる電子署名にも対応し、税務手続きのデジタル化を完全にサポートします。
Overview
E-Tax Agentは、国税庁が提供するe-Tax（国税電子申告・納税システム）のAPIと連携し、個人事業主・法人の税務手続きをClaude Code上で完結させるスキルです。確定申告書（所得税、消費税、法人税）の作成、電子署名、送信、受信通知の確認、各種証明書の取得、予定納税の管理、更正の請求まで、税務に関するあらゆる操作を自然言語コマンドで実行できます。
e-Tax APIの仕様に準拠したXTX形式のデータ生成、マイナポータルAPIを経由したマイナンバーカード連携、JPKI（公的個人認証サービス）による電子署名を統合しています。
アーキテクチャ図
┌────────────────────────────────────────────────────────────────┐
│ Claude Code CLI │
│ ┌──────────────────────────────────────────────────────────┐ │
│ │ E-Tax Agent Core │ │
│ │ ┌────────────┐ ┌────────────┐ ┌──────────────────────┐ │ │
│ │ │ 申告書 │ │ 電子署名 │ │ 受信通知 │ │ │
│ │ │ ジェネレータ│ │ ハンドラ │ │ マネージャー │ │ │
│ │ └─────┬──────┘ └─────┬──────┘ └──────────┬───────────┘ │ │
│ │ │ │ │ │ │
│ │ ┌─────▼──────────────▼────────────────────▼───────────┐ │ │
│ │ │ 税務計算エンジン │ │ │
│ │ │ ┌──────────┐ ┌──────────┐ ┌──────────────────────┐ │ │ │
│ │ │ │ 所得税 │ │ 消費税 │ │ 青色申告 │ │ │ │
│ │ │ │ 計算 │ │ 計算 │ │ 特別控除 │ │ │ │
│ │ │ └────┬─────┘ └────┬─────┘ └──────────┬───────────┘ │ │ │
│ │ └───────┼────────────┼──────────────────┼─────────────┘ │ │
│ └──────────┼────────────┼──────────────────┼────────────────┘ │
│ │ │ │ │
│ ┌──────────▼────────────▼──────────────────▼─────────────────┐ │
│ │ 外部システム連携 │ │
│ │ ┌──────────┐ ┌──────────┐ ┌──────────────────────────┐ │ │
│ │ │ e-Tax │ │ マイナ │ │ JPKI │ │ │
│ │ │ API │ │ ポータル │ │ (公的個人認証) │ │ │
│ │ └──────────┘ └──────────┘ └──────────────────────────┘ │ │
│ └────────────────────────────────────────────────────────────┘ │
└────────────────────────────────────────────────────────────────┘
System Prompt / Behavioral Guidelines
このスキルを使用する際、エージェントは以下のガイドラインに従います。
- すべての税務データは国税庁のe-Tax仕様（XTX形式）に準拠して生成し、送信前に必ずバリデーションを実行する
- マイナンバー（個人番号）は暗号化して保持し、ログファイルやコンソール出力には絶対に平文表示しない（先頭4桁のみマスク表示を許容）
- 電子署名はJPKI（公的個人認証サービス）の仕様に従い、SHA-256によるハッシュ値を使用する
- 申告書データの送信前に必ず金額の整合性チェック（収入-経費=所得、税額計算の検算）を実施する
- e-Tax APIへの通信はすべてTLS 1.2以上で暗号化し、証明書の有効性を検証する
- 申告期限（所得税: 3月15日、消費税: 3月31日、法人税: 事業年度終了後2ヶ月）を常に表示し、期限間近の場合は警告を発する
- 税額計算は最新の税率テーブル（所得税率、住民税率、事業税率、消費税率）を使用し、年度ごとの改正に対応する
- 青色申告特別控除（65万円/55万円/10万円）の適用要件を自動判定し、最適な控除額を提案する
- 予定納税の通知時期（6月、11月）と納期限を管理し、事前にリマインド通知を行う
- 更正の請求は法定申告期限から5年以内であることを確認し、期限外の場合はエラーを返す
- 操作ログは税務調査対応として7年間保持し、タイムスタンプ付きで全操作を記録する
- 消費税の計算は標準税率（10%）と軽減税率（8%）を正確に区分し、仕入税額控除の計算を行う
- 住民税・事業税の申告データは確定申告データから自動生成し、地方税ポータルへの連携をサポートする
- 電子納税（ダイレクト納付、インターネットバンキング、クレジットカード）の手続き案内を提供する
- API障害時はe-Taxの稼働状況ページを確認し、メンテナンス情報を表示する
- 確定申告書等作成コーナーとの互換性を維持し、途中データのインポート/エクスポートに対応する
- すべての金額表示は日本円（円単位、3桁カンマ区切り）で統一し、端数処理は国税通則法に従う
Environment Variables
| 変数名 | 必須 | 説明 | 取得方法 |
|---|---|---|---|
ETAX_USER_ID |
はい | e-Tax利用者識別番号（16桁） | e-Tax開始届出書の提出後に発行される利用者識別番号 |
ETAX_PASSWORD |
はい | e-Taxログインパスワード | e-Tax初期設定時に自身で設定したパスワード |
ETAX_CERT_PATH |
はい | 電子証明書ファイルのパス（.pfx/.p12形式） | マイナンバーカードから書き出した電子証明書ファイル |
MYNUMBER_CARD_PIN |
はい | マイナンバーカードの署名用パスワード（6～16桁英数字） | マイナンバーカード交付時に設定した署名用パスワード |
ETAX_TAX_OFFICE_CODE |
いいえ | 所轄税務署コード（5桁） | 国税庁サイトの税務署検索ページで確認 |
ETAX_FISCAL_YEAR |
いいえ | 対象事業年度（デフォルト: 前年） | YYYY形式（例: 2025） |
ETAX_BLUE_RETURN |
いいえ | 青色申告フラグ（true/false） | デフォルト: false |
ETAX_LOG_RETENTION_YEARS |
いいえ | ログ保持年数 | デフォルト: 7（税務調査対応） |
Commands
1. etax file
確定申告書の作成・送信を行います。
# 所得税確定申告書の作成
etax file create --type "income-tax" --year 2025 --blue-return
# 出力:
# ✅ 確定申告書作成完了（令和7年分 所得税及び復興特別所得税）
# ┌──────────────────────────────────────────────────┐
# │ 申告種別: 所得税確定申告書B │
# │ 対象年度: 令和7年（2025年） │
# │ 申告区分: 青色申告 │
# │ │
# │ ■ 収入金額 │
# │ 事業所得（営業等）: ¥12,500,000 │
# │ 雑所得（その他）: ¥350,000 │
# │ │
# │ ■ 所得金額 │
# │ 事業所得: ¥8,200,000 │
# │ 青色申告特別控除: ¥650,000 │
# │ 所得合計: ¥7,900,000 │
# │ │
# │ ■ 所得控除 │
# │ 基礎控除: ¥480,000 │
# │ 社会保険料控除: ¥920,000 │
# │ 小規模企業共済等控除: ¥840,000 │
# │ 控除合計: ¥2,240,000 │
# │ │
# │ ■ 税額 │
# │ 課税所得金額: ¥5,660,000 │
# │ 所得税額: ¥579,200 │
# │ 復興特別所得税: ¥12,163 │
# │ 納付税額: ¥591,300 │
# │ │
# │ ファイル: ~/.etax-agent/returns/2025/income-tax.xtx│
# │ ステータス: 作成完了（未送信） │
# └──────────────────────────────────────────────────┘
# 申告書の電子送信
etax file submit --year 2025 --type "income-tax" --sign
# 出力:
# 🔐 電子署名処理中...
# ✅ 電子署名完了（JPKI SHA-256）
#
# 📤 e-Taxサーバーへ送信中...
# ✅ 送信完了
# ┌──────────────────────────────────────────────────┐
# │ 受付番号: 20260301-1234-5678-9012 │
# │ 送信日時: 2026-03-01 14:30:00 JST │
# │ 申告種別: 令和7年分所得税確定申告書B │
# │ 納付税額: ¥591,300 │
# │ 納期限: 2026-03-16 │
# │ ステータス: 受付完了 │
# │ │
# │ 受信通知は1～2営業日以内にメッセージボックスに │
# │ 届きます。「etax status」で確認できます。 │
# └──────────────────────────────────────────────────┘
2. etax status
申告の受付状況・受信通知を確認します。
# 受信通知の確認
etax status check --year 2025
# 出力:
# 📬 受信通知確認
# ┌──────────────────────────────────────────────────┐
# │ 受付番号: 20260301-1234-5678-9012 │
# │ 申告種別: 令和7年分所得税確定申告書B │
# │ 送信日時: 2026-03-01 14:30:00 JST │
# │ 受付日時: 2026-03-01 14:30:05 JST │
# │ 処理状況: 正常受付 │
# │ │
# │ メッセージ: │
# │ 「令和7年分の所得税及び復興特別所得税の確定申告書 │
# │ を正常に受け付けました。」 │
# │ │
# │ 添付書類: 追加提出不要 │
# │ 還付予定: 該当なし（納付申告） │
# └──────────────────────────────────────────────────┘
3. etax receipt
電子申告の受領証を取得します。
# 受領証の取得・保存
etax receipt download --year 2025 --format pdf
# 出力:
# 📄 受領証ダウンロード完了
# ┌──────────────────────────────────────────────────┐
# │ ファイル名: receipt_2025_income-tax.pdf │
# │ 保存先: ~/.etax-agent/receipts/2025/ │
# │ 受付番号: 20260301-1234-5678-9012 │
# │ ファイルサイズ: 245 KB │
# │ │
# │ この受領証は確定申告の控えとして │
# │ 各種手続き（融資、補助金申請等）に使用できます。 │
# └──────────────────────────────────────────────────┘
4. etax payment
納税の手続き・確認を行います。
# 納税方法の確認と手続き
etax payment options --year 2025
# 出力:
# 💴 納税方法一覧（令和7年分 所得税）
# ┌──────────────────────────────────────────────────┐
# │ 納付税額: ¥591,300 │
# │ 納期限: 2026-03-16 │
# │ │
# │ ■ 利用可能な納税方法 │
# │ │
# │ 1. ダイレクト納付（推奨） │
# │ 事前届出済みの預貯金口座から即時引落し │
# │ 手数料: 無料 │
# │ │
# │ 2. インターネットバンキング │
# │ Pay-easy対応のネットバンキングから納付 │
# │ 手数料: 金融機関による │
# │ │
# │ 3. クレジットカード納付 │
# │ 国税クレジットカードお支払サイトから納付 │
# │ 手数料: ¥5,918（税額に応じた決済手数料） │
# │ │
# │ 4. スマートフォンアプリ納付 │
# │ 30万円以下の場合利用可能 │
# │ ※今回の税額では利用不可 │
# │ │
# │ 5. 振替納税 │
# │ 届出済み口座から4月中旬に自動引落し │
# │ 手数料: 無料 │
# └──────────────────────────────────────────────────┘
5. etax certificate
納税証明書の取得を行います。
# 納税証明書の請求
etax certificate request --type "sono1" --year 2025
# 出力:
# 📜 納税証明書請求完了
# ┌──────────────────────────────────────────────────┐
# │ 証明書種類: 納税証明書（その1） │
# │ ─ 納付すべき税額と納付済額の証明 │
# │ 対象年度: 令和7年（2025年） │
# │ 税目: 所得税及び復興特別所得税 │
# │ 請求日: 2026-03-01 │
# │ │
# │ 発行方法: 電子発行（PDF） │
# │ 手数料: ¥370（電子納付） │
# │ 発行予定: 即日～3営業日 │
# │ │
# │ ステータス: 請求受付済み │
# └──────────────────────────────────────────────────┘
6. etax amendment
更正の請求・修正申告を行います。
# 更正の請求書作成
etax amendment create --year 2024 --reason "医療費控除の計上漏れ" --amount 180000
# 出力:
# ✅ 更正の請求書作成完了
# ┌──────────────────────────────────────────────────┐
# │ 種別: 更正の請求 │
# │ 対象年度: 令和6年（2024年） │
# │ 請求理由: 医療費控除の計上漏れ │
# │ │
# │ ■ 変更内容 │
# │ 当初申告 医療費控除: ¥0 │
# │ 更正後 医療費控除: ¥180,000 │
# │ 控除増加額: ¥180,000 │
# │ │
# │ ■ 税額変更 │
# │ 当初税額: ¥620,500 │
# │ 更正後税額: ¥602,500 │
# │ 還付予定額: ¥18,000 │
# │ │
# │ 請求期限: 2030-03-15（法定期限から5年） │
# │ ステータス: 作成完了（未送信） │
# └──────────────────────────────────────────────────┘
7. etax schedule
申告・納税スケジュールの管理を行います。
# 年間スケジュール表示
etax schedule show --year 2026
# 出力:
# 📅 税務スケジュール（2026年）
# ┌──────────┬────────────────────────────┬──────────┐
# │ 期限 │ 内容 │ ステータス│
# ├──────────┼────────────────────────────┼──────────┤
# │ 01/31 │ 法定調書の提出 │ ✅ 完了 │
# │ 01/31 │ 給与支払報告書の提出 │ ✅ 完了 │
# │ 03/16 │ 所得税確定申告・納付 │ ⏳ 対応中 │
# │ 03/31 │ 消費税確定申告・納付 │ ○ 未着手 │
# │ 04/15 │ 振替納税日（所得税） │ ○ 未着手 │
# │ 04/20 │ 振替納税日（消費税） │ ○ 未着手 │
# │ 06/30 │ 予定納税第1期納付 │ ○ 未着手 │
# │ 07/10 │ 源泉所得税（上半期分）納付 │ ○ 未着手 │
# │ 08/31 │ 個人事業税第1期納付 │ ○ 未着手 │
# │ 11/30 │ 予定納税第2期納付 │ ○ 未着手 │
# │ 11/30 │ 個人事業税第2期納付 │ ○ 未着手 │
# │ 01/20 │ 源泉所得税（下半期分）納付 │ ○ 未着手 │
# └──────────┴────────────────────────────┴──────────┘
# ⚠️ 所得税確定申告の期限まであと15日です
8. etax history
過去の申告履歴・納税履歴を確認します。
# 申告履歴一覧
etax history list --years 3
# 出力:
# 📋 申告履歴（直近3年分）
# ┌──────┬─────────────┬────────────┬────────────┬─────────┐
# │ 年度 │ 申告種別 │ 納付税額 │ 送信日 │ ステータス│
# ├──────┼─────────────┼────────────┼────────────┼─────────┤
# │ R7 │ 所得税(B) │ ¥591,300 │ 2026-03-01 │ 受付済 │
# │ R7 │ 消費税 │ 未申告 │ - │ 未着手 │
# │ R6 │ 所得税(B) │ ¥520,800 │ 2025-03-10 │ 受付済 │
# │ R6 │ 消費税 │ ¥284,600 │ 2025-03-25 │ 受付済 │
# │ R5 │ 所得税(B) │ ¥480,200 │ 2024-03-12 │ 受付済 │
# │ R5 │ 消費税 │ ¥256,300 │ 2024-03-28 │ 受付済 │
# └──────┴─────────────┴────────────┴────────────┴─────────┘
# 合計納付額（3年間）: ¥2,133,200
Workflow Diagram
┌─────────────────────────────────────────────────────────────────┐
│ E-Tax Agent 確定申告ワークフロー │
├─────────────────────────────────────────────────────────────────┤
│ │
│ データ準備 │
│ │ │
│ ▼ │
│ ┌─────────────┐ ┌──────────────┐ ┌───────────────────┐ │
│ │ 収支データ │───→│ 勘定科目 │───→│ 決算書作成 │ │
│ │ インポート │ │ 仕訳・集計 │ │ (青色/白色) │ │
│ └─────────────┘ └──────────────┘ └────────┬──────────┘ │
│ │ │
│ ▼ │
│ ┌──────────────┐ │
│ │ 確定申告書 │ │
│ │ 自動生成 │ │
│ └──────┬───────┘ │
│ │ │
│ ┌──────────────────────┤ │
│ │ │ │
│ ▼ ▼ │
│ ┌──────────────┐ ┌──────────────┐ │
│ │ バリデーション│ │ 税額検算 │ │
│ │ (XTX形式) │ │ (整合性) │ │
│ └──────┬───────┘ └──────┬───────┘ │
│ │ │ │
│ └──────────┬───────────┘ │
│ │ │
│ ▼ │
│ ┌──────────────┐ │
│ │ 電子署名 │ │
│ │ (JPKI) │ │
│ └──────┬───────┘ │
│ │ │
│ ▼ │
│ ┌──────────────┐ │
│ │ e-Tax送信 │ │
│ └──────┬───────┘ │
│ │ │
│ ┌──────────┼──────────┐ │
│ │ │ │ │
│ ▼ ▼ ▼ │
│ ┌────────┐ ┌────────┐ ┌────────┐ │
│ │ 受付 │ │ エラー │ │ 再送信 │ │
│ │ 完了 │ │ 返却 │ │ 待機 │ │
│ └───┬────┘ └────────┘ └────────┘ │
│ │ │
│ ▼ │
│ ┌──────────┐ │
│ │ 受信通知 │───→ 納税手続き │
│ │ 確認 │ │
│ └──────────┘ │
└─────────────────────────────────────────────────────────────────┘
Error Handling
1. e-Tax認証エラー
❌ エラー: e-Taxログインに失敗しました
┌──────────────────────────────────────────────────┐
│ エラーコード: ETAX_AUTH_001 │
│ 原因: 利用者識別番号またはパスワードが不正です │
│ │
│ 対処方法: │
│ 1. ETAX_USER_IDが16桁であることを確認 │
│ 2. ETAX_PASSWORDが正しいことを確認 │
│ 3. パスワードを忘れた場合は税務署窓口で │
│ 再発行手続きを行ってください │
│ 4. ロックアウトされた場合は30分後に再試行 │
└──────────────────────────────────────────────────┘
2. 電子証明書エラー
❌ エラー: 電子証明書の読み込みに失敗しました
┌──────────────────────────────────────────────────┐
│ エラーコード: CERT_INVALID_002 │
│ 証明書パス: ~/.etax-agent/certs/mynumber.pfx │
│ │
│ 考えられる原因: │
│ ・証明書ファイルが破損している │
│ ・証明書の有効期限が切れている │
│ ・マイナンバーカードの電子証明書更新が必要 │
│ │
│ 対処方法: │
│ 1. マイナンバーカードの有効期限を確認 │
│ （署名用電子証明書: 発行から5年） │
│ 2. 市区町村窓口で電子証明書の更新手続き │
│ 3. 更新後、証明書を再エクスポートしてください │
└──────────────────────────────────────────────────┘
3. 申告データ不整合エラー
❌ エラー: 申告データの整合性チェックに失敗しました
┌──────────────────────────────────────────────────┐
│ エラーコード: VALIDATION_003 │
│ │
│ 不整合箇所: │
│ ・収入金額合計と所得金額の差額が経費合計と不一致 │
│ 収入: ¥12,500,000 - 所得: ¥8,200,000 │
│ = ¥4,300,000 ≠ 経費合計: ¥4,250,000 │
│ 差額: ¥50,000 │
│ │
│ 対処方法: │
│ 1. 経費の入力漏れがないか確認してください │
│ 2. 「etax file validate」で詳細な検証を │
│ 実行してください │
│ 3. 減価償却費の計算を再確認してください │
└──────────────────────────────────────────────────┘
4. e-Taxサーバー障害エラー
❌ エラー: e-Taxサーバーに接続できません
┌──────────────────────────────────────────────────┐
│ エラーコード: SERVER_UNAVAILABLE_004 │
│ │
│ 現在のe-Tax稼働状況: │
│ ・メンテナンス中（毎週月曜日 0:00-8:30） │
│ ・次回利用可能時刻: 2026-03-02 08:30 JST │
│ │
│ 対処方法: │
│ 1. メンテナンス終了後に再試行してください │
│ 2. e-Tax稼働状況ページで最新情報を確認 │
│ https://www.e-tax.nta.go.jp/info_center/ │
│ 3. 確定申告期間中（2-3月）は24時間稼働です │
└──────────────────────────────────────────────────┘
5. 申告期限超過エラー
❌ エラー: 申告期限を超過しています
┌──────────────────────────────────────────────────┐
│ エラーコード: DEADLINE_EXCEEDED_005 │
│ │
│ 申告種別: 令和7年分 所得税確定申告 │
│ 法定期限: 2026-03-16 │
│ 現在日: 2026-03-20 │
│ 超過日数: 4日 │
│ │
│ ⚠️ 期限後申告について: │
│ ・期限後申告は可能ですが、以下のペナルティが │
│ 発生する可能性があります │
│ ・無申告加算税: 税額の5%～15% │
│ ・延滞税: 年7.3%～14.6%（日割計算） │
│ ・青色申告特別控除が65万円→10万円に減額 │
│ │
│ 対処方法: │
│ ・速やかに「etax file submit」で申告してください │
│ ・税務署への相談も検討してください │
└──────────────────────────────────────────────────┘
FAQ
Q1: e-Taxの利用者識別番号はどうやって取得しますか？ A1: e-Tax公式サイト（https://www.e-tax.nta.go.jp/）から「開始届出書」をオンラインで提出すると、即時に16桁の利用者識別番号が発行されます。マイナンバーカードがあれば、マイナポータル経由でも取得可能です。
Q2: マイナンバーカードなしでも電子申告できますか？
A2: ID・パスワード方式を利用すれば、マイナンバーカードなしでも電子申告が可能です。ただし、事前に税務署での本人確認が必要です。ETAX_AUTH_METHOD=id-password を設定してください。
Q3: 青色申告の65万円控除を受けるための要件は？ A3: 複式簿記による記帳、貸借対照表・損益計算書の添付、e-Taxによる電子申告（または電子帳簿保存）が必要です。本スキルのe-Tax送信機能を使用すれば電子申告要件を満たせます。
Q4: 消費税のインボイス制度にも対応していますか？ A4: 消費税の確定申告書作成に対応しています。インボイス制度（適格請求書等保存方式）に関する詳細な機能は、別途japan-invoiceスキルをご利用ください。
Q5: 過去の申告を修正したい場合は？
A5: etax amendment create コマンドで更正の請求書（税額が減る場合）または修正申告書（税額が増える場合）を作成できます。法定申告期限から5年以内が対象です。
Q6: 予定納税の減額申請はできますか？
A6: はい。etax payment reduce-request コマンドで予定納税の減額申請書を作成・送信できます。事業の廃止・休止、業績不振等の理由が必要です。
Q7: 住民税の申告も連動しますか？
A7: 確定申告データから住民税に関する事項が自動反映されます。確定申告を行えば原則として住民税の申告は不要です。特別徴収/普通徴収の選択は etax file create --residence-tax ordinary で設定できます。
Q8: データのバックアップはどうなっていますか？
A8: すべての申告データは ~/.etax-agent/returns/ にXTX形式で保存されます。また、送信済みデータは ~/.etax-agent/submitted/ に自動バックアップされます。7年間の保持が税務調査対応として推奨されます。
Q9: 法人税の申告にも対応していますか？
A9: 法人税確定申告書（別表一～十六）の作成に対応しています。etax file create --type corporate-tax --fiscal-end 2026-03-31 で法人税申告書を作成できます。
Q10: e-Tax APIの利用時間に制限はありますか？
A10: 通常期は火曜日～金曜日の24時間、土日月曜日はメンテナンスのため利用不可です。ただし、確定申告期間（1月上旬～3月中旬）は全日24時間利用可能です。最新の稼働状況は etax status server で確認できます。
Data Storage
~/.etax-agent/
├── config/
│ ├── settings.json # 基本設定（税務署コード、申告区分等）
│ ├── tax-rates.json # 税率テーブル（年度別）
│ └── deductions.json # 控除設定（社会保険、生命保険等）
├── certs/
│ ├── mynumber.pfx # マイナンバーカード電子証明書
│ └── ca-bundle.pem # e-Tax CA証明書チェーン
├── returns/
│ ├── 2025/
│ │ ├── income-tax.xtx # 所得税申告書データ
│ │ ├── consumption-tax.xtx # 消費税申告書データ
│ │ ├── blue-return.xtx # 青色申告決算書
│ │ └── financial-stmt.xtx # 貸借対照表・損益計算書
│ └── 2024/
│ └── ...
├── submitted/
│ ├── 2025/
│ │ ├── income-tax_signed.xtx # 署名済み送信データ
│ │ └── receipt.json # 受付情報
│ └── 2024/
│ └── ...
├── receipts/
│ ├── 2025/
│ │ └── receipt_2025_income-tax.pdf # 受領証PDF
│ └── 2024/
│ └── ...
├── certificates/
│ └── tax-cert-2025.pdf # 納税証明書
├── amendments/
│ └── 2024/
│ └── amendment-request.xtx # 更正の請求書
├── schedules/
│ └── 2026-schedule.json # 年間税務スケジュール
├── logs/
│ ├── audit.log # 操作監査ログ（7年保持）
│ ├── api-calls.log # API通信ログ
│ └── errors.log # エラーログ
└── cache/
├── tax-office-codes.json # 税務署コードキャッシュ
└── mynumber-portal.json # マイナポータル連携キャッシュ
Comparison vs Competitors
| 機能 | E-Tax Agent | freee確定申告 | マネーフォワード確定申告 | やよいの確定申告 |
|---|---|---|---|---|
| Claude Code統合 | 自然言語で全操作可能 | 非対応 | 非対応 | 非対応 |
| 申告書作成 | XTX形式自動生成、所得税・消費税・法人税 | 質問形式GUI | ステップ式GUI | ウィザード形式GUI |
| 電子送信 | e-Tax API直接送信 | e-Tax連携 | e-Tax連携 | e-Tax連携 |
| 電子署名 | JPKI統合（自動署名） | マイナンバーカード読取 | マイナンバーカード読取 | マイナンバーカード読取 |
| 青色申告対応 | 65万円控除自動判定 | 対応（有料プラン） | 対応（有料プラン） | 対応（有料プラン） |
| 更正の請求 | コマンドで即時作成・送信 | 非対応（別途手続き） | 非対応（別途手続き） | 非対応（別途手続き） |
| 予定納税管理 | スケジュール管理・リマインド | 通知機能あり | 通知機能あり | カレンダー表示 |
| 納税証明書取得 | 電子請求・ダウンロード | 非対応 | 非対応 | 非対応 |
| 料金 | 無料（Claude API費用のみ） | 年額26,136円～ | 年額11,760円～ | 年額8,800円～ |
| 会計連携 | CSV/JSON/freee/MF連携可能 | freee会計と一体 | MF会計と一体 | やよい会計と一体 |
| 操作方式 | CLI（自然言語コマンド） | Webブラウザ | Webブラウザ | デスクトップ/Web |
| 拡張性 | 他スキルとの連携（invoice等） | API提供（有料） | API提供（有料） | API限定的 |
E-Tax Agentの優位性
- コスト効率: 本スキル自体は無料で利用でき、既存の会計ソフトのサブスクリプション費用を削減できます。Claude API費用のみで運用可能です
- 自動化の深度: 申告書作成から電子署名、送信、受信通知確認、納税手続きまでを完全にCLI上で完結させることができます
- 他スキルとの連携: japan-invoice（インボイス制度）、freee-agent（会計連携）等の他スキルと組み合わせることで、税務業務全体を統合管理できます
- プログラマブルな税務処理: シェルスクリプトやCIパイプラインに組み込むことで、税務処理の完全自動化が実現可能です
Advanced Features
会計ソフト連携
E-Tax Agentは主要な会計ソフトからのデータインポートに対応しています。freee会計、マネーフォワードクラウド会計、やよいの青色申告からCSVまたはAPI経由で仕訳データを取得し、確定申告書に必要な勘定科目の集計を自動で行います。
インポート対応フォーマットは以下の通りです。freee会計のエクスポートCSV形式、マネーフォワードクラウドの仕訳帳CSV形式、やよいの青色申告の仕訳データCSV形式、および汎用の勘定科目別集計CSV形式です。インポート時にはデータの整合性チェックが自動的に実行され、貸借不一致や不正な勘定科目コードなどの問題がある場合は修正案を提示します。
減価償却資産の自動計算
固定資産の減価償却計算を自動化します。定額法、定率法、生産高比例法に対応し、耐用年数省令に基づいた法定耐用年数テーブルを内蔵しています。取得価額、取得日、資産区分を入力するだけで、当期の償却費を自動計算し、確定申告書の減価償却明細に反映します。
中小企業者の少額減価償却資産の特例（取得価額30万円未満、年間合計300万円まで即時償却可能）にも対応しており、適用要件を自動判定して最適な償却方法を提案します。一括償却資産（取得価額20万円未満）の3年均等償却計算にも対応しています。
所得控除の自動適用
確定申告における各種所得控除の適用判定を自動化します。対応する所得控除は以下の通りです。基礎控除（合計所得金額に応じた段階的控除）、配偶者控除・配偶者特別控除（配偶者の所得に応じた自動計算）、扶養控除（特定扶養親族、老人扶養親族等の区分判定）、社会保険料控除、小規模企業共済等掛金控除（iDeCo含む）、生命保険料控除（一般・介護医療・個人年金の区分計算）、地震保険料控除、医療費控除（通常の医療費控除とセルフメディケーション税制の有利判定）、寄附金控除（ふるさと納税の控除上限額計算含む）。
ふるさと納税の控除上限額シミュレーション機能も搭載しており、etax simulate furusato --income 8000000 で年間の控除上限額を即座に計算できます。ワンストップ特例との比較も自動で行い、確定申告が有利なケースをアドバイスします。
電子帳簿保存法対応
2024年1月から義務化された電子取引データの電子保存に対応しています。電子取引（メール添付の請求書、Webダウンロードの領収書等）のデータを取得日時とともに自動保存し、検索要件（日付、金額、取引先名での検索）を満たすインデックスを自動生成します。
JIIMA認証のタイムスタンプサービスとの連携にも対応しており、保存したデータに真正性を付与することが可能です。また、スキャナ保存制度に対応した紙書類のPDFスキャンデータの管理機能も提供しています。
セキュリティとプライバシー
マイナンバーの取り扱いには最高レベルのセキュリティ対策を適用しています。マイナンバーはAES-256-GCMで暗号化して保存し、メモリ上でも暗号化状態を維持します。復号は電子署名時のみ一時的に行い、処理完了後は即座にメモリから消去します。ログファイルにはマイナンバーの先頭4桁のみがマスク表示され、完全な番号は一切記録されません。
パスワードや証明書のPINコードについても同様に暗号化保存され、平文での保存や表示は行いません。環境変数からの読み取り時にもセキュアな処理を行い、プロセスリストやシェルヒストリーへの漏洩を防止します。
確定申告シミュレーション
申告書を作成する前に、税額のシミュレーションを実行できます。収入金額、経費、各種控除の金額を入力すると、所得税・復興特別所得税・住民税・事業税の概算額を即座に計算します。複数のシナリオを比較する機能も搭載しており、例えば「青色申告65万円控除 vs 白色申告」「簡易課税 vs 本則課税」「ふるさと納税の最適額」などのシミュレーションを並列で実行し、最も有利な選択肢を提案します。
シミュレーション結果はJSON形式で保存され、過年度のシミュレーション結果との比較も可能です。税制改正の影響を事前に把握するために、次年度の改正案に基づく仮想シミュレーションも実行できます。
税務カレンダーと通知システム
年間の税務スケジュールを一元管理し、各種期限のリマインダーを提供します。Slack、Lark、メール、デスクトップ通知など複数の通知チャネルに対応しており、期限の7日前、3日前、前日、当日の段階的通知をデフォルトで設定しています。
通知内容には期限情報だけでなく、必要な準備事項（例: 消費税確定申告の前に、課税売上割合の確認と仕入税額控除の集計を完了させること）や参考リンクも含まれます。税務署の窓口混雑予測情報と連動し、確定申告期間中は混雑が少ない時間帯の来署を推奨する機能も搭載しています。
Data Import and Export Capabilities
The E-Tax Agent supports a comprehensive range of data import formats for seamless integration with existing accounting workflows. CSV files from major Japanese accounting platforms are automatically detected and parsed, with column mapping handled intelligently based on header names and data patterns. JSON format is also supported for programmatic data exchange with custom accounting systems or third-party APIs.
Export capabilities include generating standardized XTX files for e-Tax submission, PDF reports for physical archival, and CSV summaries for further analysis in spreadsheet applications. The agent can also generate XML files compatible with the eLTAX system for local tax filing, enabling a unified approach to both national and local tax obligations from a single command-line interface.
For businesses that operate across multiple fiscal periods or manage multiple entities, the agent supports profile-based configuration. Each profile maintains its own set of credentials, tax office codes, and filing history, allowing accountants and tax professionals to efficiently manage multiple clients from a single installation. Profile switching is instantaneous and does not require restarting the agent or reconfiguring environment variables.
Batch processing mode enables the submission of multiple tax returns in sequence, with automatic error handling and retry logic for each submission. This is particularly useful for tax professionals managing dozens or hundreds of client filings during the busy March filing season.
License
MIT License - hanabi-jpn