e-Tax/eLTAX XTX形式 技術仕様調査結果

調査計画に基づいて実施した技術調査の結果をまとめる。

1. XTX形式の基本仕様

1.1 XTXとは

• ファイル形式: XML（Extensible Markup Language）ベース
• 拡張子: .xtx（e-Tax用）、.xml（eLTAX用）
• エンコーディング: UTF-8
• 特徴: 申告書が完成した後に出力される最終形式（編集不可）

1.2 ファイル構造

<?xml version="1.0" encoding="UTF-8" standalone="no" ?>

• standalone="no" は外部参照ファイル（国税庁サーバーの読替表）が存在することを示す
• データ項目は <ABB01060> のようなコード形式で記述される
• 実際の申告データの意味は国税庁サーバー側のスキーマ定義と照合して解釈される

1.3 関連ファイル形式

2. e-Tax（国税）の技術仕様

2.1 開発者向け情報の入手先

2.2 仕様書のダウンロード

• 仕様書は CAB形式 で圧縮されて提供
• 帳票ごとにXMLスキーマ定義が存在
• 毎年の税制改正に合わせて更新される

2.3 法人税申告に必要な形式

2.4 e-Tax API

• プロトコル: HTTP/HTTPS
• 認証: APIキーが必要（申請制）
• 申請先: [email protected]
• 制限事項:
  • ログイン・申告データ送信はAPI非対応
  • 送信には「受付システムインターフェイス仕様書」に従う必要あり

注意: レート制限・使用割当について

公式ドキュメントではレート制限（Rate Limit）や使用割当（Quota）の明示的な記載は確認できていない。APIキー発行申請時に個別に説明される可能性があるため、実装前に国税庁への確認を推奨。大量リクエストを想定する場合は特に事前確認が必要。

2.5 電子署名の要件

2.6 テスト環境

• 送信試験環境: 基幹システム刷新に伴い、令和7年中旬から順次公開予定
• 現行環境: 本番環境のみ（テスト専用環境なし）
• 注意: 送信試験は実際のe-Tax環境で行う必要がある

本番環境テストのエラーハンドリング戦略

テスト専用環境がないため、以下の戦略を推奨:

1. 段階的検証
   • ローカルでXMLスキーマバリデーション実施
   • e-Taxソフトでの読み込みテスト（送信前確認）
   • 最小限のテストデータで本番送信試行
2. エラー発生時の対応
   • 送信エラーはe-Taxソフトでエラーコード確認
   • 国税庁の「よくある質問」でエラー対処法を確認
   • 重大なエラーは国税庁ヘルプデスクへ問い合わせ
3. ロールバック計画
   • 送信済みデータの訂正は「訂正申告」として再送信
   • 電子申告の取り消しは原則不可（書面での対応が必要）

3. eLTAX（地方税）の技術仕様

3.1 仕様開示の申請方法

eLTAXの技術仕様は申請制で開示される。

申請先: 地方税共同機構 必要書類:

1. eLTAX対応ソフトウェア公開仕様開示申込書
2. 開発概要（審査対象となる場合あり）
3. API方式利用の場合は同意書

公式ページ: eltax.lta.go.jp/support/software/

3.2 e-Taxとの差異

3.3 PCdeskとの関係

• PCdesk: eLTAXの公式クライアントソフト
• 連携方式:
  • 直接API連携（仕様開示が必要）
  • XMLファイル出力 → PCdeskで読み込み

4. 既存ライブラリ・ツールの調査

4.1 OSSライブラリの状況

結論: 日本のe-Tax/eLTAX向けOSSライブラリは存在しない

調査実施日: 2026年1月10日

※ 状況は変化する可能性があるため、実装開始時に再調査を推奨

GitHub検索結果:

• 日本のe-Tax向けXTX生成ライブラリ: 発見できず
• 米国IRS向けe-Fileライブラリ: 複数存在（参考にはなる）

参考リポジトリ（米国IRS向け）:

• IRS-Public/direct-file - IRS公式のダイレクトファイル
• moov-io/1120x - Form 1120のMeF対応
• jsfenfen/990-xml-reader - Form 990のXML解析

4.2 商用ソフトの実装方式

主要な会計ソフトのe-Tax対応:

4.3 国税庁提供のツール

5. 年次更新の負担

5.1 税制改正の影響

• 改正頻度: 毎年（12月に税制改正大綱発表）
• 仕様公開時期: 翌年1月頃（受付開始前）
• ドラフト版: 前年秋頃から順次公開

5.2 令和8年の大規模変更

基幹システム刷新（令和8年度導入予定）:

• AI-OCR導入による様式改定
• 仕様書は令和6年度から順次ドラフト公開
• 通信プロトコル・認証シーケンスは変更なし

5.3 後方互換性

• スキーマバージョン管理: 年度ごとにスキーマが更新
• 過去年度データ: 過去のスキーマで送信可能（修正申告等）
• 互換性保証: 明示的な保証なし（仕様書を都度確認）

5.4 年次対応の工数目安

前提条件

• チーム規模: 1名（専任）または2名（兼任）
• e-Tax/eLTAX両対応の場合
• QA/テスト工数を含む

※ 大規模な税制改正がある年度は追加工数が必要

6. 実装難易度の評価

6.1 技術的ハードル

6.2 総合評価

実装難易度: 高

理由:

1. 仕様書の量が膨大: 法人税だけでも数百ページの仕様書
2. OSSがない: スクラッチ開発が必要
3. 電子署名の実装: 暗号技術の知識が必要
4. テスト環境がない: 本番環境でしかテストできない
5. 年次更新の負担: 毎年1-3ヶ月の対応工数

6.3 全力法人税の事例との比較

全力法人税の調査によると:

• 初回リリース（2015年）からe-Tax対応（2018年）まで約3年
• 専任開発者が複数年かけて実装

7. 推奨方針

7.1 MVPでの対応案

7.2 段階的アプローチ（推奨）

flowchart LR
    subgraph Phase1["Phase 1: MVP"]
        P1A[PDF出力] --> P1B[手動提出]
    end

    subgraph Phase2["Phase 2: ファイル出力"]
        P2A[XTX/XML生成] --> P2B[e-Taxソフトで送信]
    end

    subgraph Phase3["Phase 3: 完全対応"]
        P3A[直接送信] --> P3B[電子署名内蔵]
    end

    Phase1 --> Phase2 --> Phase3

    style Phase1 fill:#e8f5e9
    style Phase2 fill:#fff3e0
    style Phase3 fill:#e3f2fd

Phase 1（MVP）: PDF出力対応

実装内容:

• 申告書イメージのPDF出力
• 手動で税務署/eLTAXに提出

成功指標・受入基準:

Phase 2: XTX/XML出力対応

実装内容:

• e-Tax/eLTAX読み込み可能なファイル出力
• 電子署名は外部ツール（e-Taxソフト）で実施

成功指標・受入基準:

Phase 3: 完全電子申告対応

実装内容:

• 直接送信機能の実装
• 電子署名の内部実装

成功指標・受入基準:

8. セキュリティ・データプライバシー要件

8.1 データの機密性

税務データは個人情報保護法および法人税法の対象となる機密情報。

8.2 実装時のセキュリティ要件

Phase 3（完全電子申告）での必須要件:

1. 秘密鍵の安全な保管
   • ブラウザのWeb Crypto API活用（秘密鍵がJavaScriptに露出しない）
   • または外部署名デバイス（ICカードリーダー）連携
2. 通信の暗号化
   • e-Tax/eLTAXとの通信はTLS 1.2以上必須
   • 証明書ピンニングの検討
3. 監査ログ
   • 申告データへのアクセスログ保持
   • 送信履歴の改ざん防止
4. 第三者監査
   • Phase 3リリース前にセキュリティ監査実施
   • ペネトレーションテストの実施

8.3 コンプライアンス

• 電子帳簿保存法: 電子データの保存要件に準拠
• e-Tax利用規約: 国税庁の利用規約を遵守
• ISMAP: クラウドサービスの場合は取得を検討

9. コスト見積もり

9.1 電子証明書の取得コスト

9.2 開発・運用コスト概算

9.3 外部サービス利用時のコスト

e-Tax/eLTAX APIの利用:

• e-Tax API: 無料（APIキー申請のみ）
• eLTAX API: 無料（仕様開示申請が必要）
• クラウド署名サービス: 1署名あたり数十円〜数百円（サービスによる）

10. 用語集

11. 次のアクション

1. e-Tax仕様書一覧から法人税関連のスキーマをダウンロード・解析
2. eLTAXへの仕様開示申請の検討
3. Phase 1（PDF出力）の実装検討
4. 将来のXTX出力に向けたアーキテクチャ設計

参考リンク

e-Tax関連

• ソフトウェア開発業者の方へ
• e-Tax仕様書一覧
• e-Tax API
• 基幹システム刷新情報

eLTAX関連

• eLTAX対応ソフトウェア開発
• 仕様書・様式集

その他

• 日本税理士会連合会 電子申告Q&A
• 日本税理士会連合会 用語説明
• freee e-Tax対応ヘルプ
• freee eLTAX利用ヘルプ
• 全力法人税 e-Tax電子申告の方法
• TKCエクスプレス PCdesk改修情報