TASHIKA Docs

Appearance

国税庁 申告書XML定義書（第6.01版 / 2025-11-21） ​

出典: https://www.nta.go.jp/users/gensen/oshirase/0019004-159.htm ファイル: teigisho01.xlsx

XML様式一覧 ​

様式ID帳票名主な対応控除備考
NTAAPP001給与所得者の扶養控除等（異動）申告書扶養控除、障害者控除、寡婦控除、ひとり親控除、勤労学生控除メインの申告書。扶養親族は最大20名繰り返し
NTAAPP002従たる給与についての扶養控除等（異動）申告書副業等の給与に対する扶養控除2箇所以上から給与を受ける場合
NTAAPP002（翌年分）同上（翌年分）同上本年分と要素内容名のみ異なる
NTAAPP003給与所得者の保険料控除申告書生命保険料、地震保険料、社会保険料、小規模企業共済等掛金各保険は最大20件繰り返し
NTAAPP004給与所得者の配偶者控除等申告書配偶者控除、配偶者特別控除合計所得の見積額による区分判定含む
NTAAPP005住宅借入金等特別控除申告書住宅ローン控除（税額控除）新築/増改築、適用種別・取得種別あり
NTAAPP006給与所得者の基礎控除申告書基礎控除合計所得金額による12区分判定
NTAAPP007所得金額調整控除申告書所得金額調整控除給与収入850万円超で適用。3条件のうち1つ選択
NTAAPP008給与所得者の特定親族特別控除申告書特定親族特別控除最大20名繰り返し

紙の様式とXML様式の対応 ​

紙の様式                                          XML様式
──────────────────────────────                      ──────────
扶養控除申告書                                →    NTAAPP001 + NTAAPP002
保険料控除申告書                              →    NTAAPP003
基配特所申告書（4つの控除を兼ねる様式）        →    NTAAPP004 + NTAAPP006 + NTAAPP007 + NTAAPP008
住宅借入金等特別控除申告書                    →    NTAAPP005

注目: 紙の様式3（基配特所申告書）は1枚だが、XMLでは4つの独立した様式に分離されている。 これはデータモデル設計の参考になる — 紙の物理的制約がなければ、論理的に独立した控除は分離すべき。

NTAAPP001: 扶養控除等（異動）申告書 ​

構造概要 ​

NTAAPP001
├── ver (バージョン)
├── xml001_A00000 (各項目の件数)
├── xml001_B00000 (提出に関する情報)
│   ├── 対象年分 (西暦/元号/年)
│   ├── 所轄税務署
│   ├── 支払者 (名称/法人番号/郵便番号/所在地)
│   ├── 申告者 (フリガナ/氏名/個人番号/郵便番号/住所/生年月日)
│   ├── 世帯主 (氏名/続柄)
│   ├── 従たる給与の有無
│   └── 申告者のその他情報
│       ├── 障害者である事実 (区分/手帳/交付日/異動/内容)
│       ├── ひとり親・寡婦に該当する事実 (区分/異動)
│       ├── 勤労学生に該当する事実 (学校名/入学日/異動)
│       ├── 本年中の所得 (給与収入/給与所得/その他所得/合計所得/翌年見積)
│       └── ひとり親・寡婦(住民税)
├── xml001_C00000 (配偶者)
│   ├── 配偶者有無 (0:なし 1:あり 2:なし(異動あり))
│   ├── 配偶者の種別 (0～7: 同一生計/源泉控除対象/退職手当等の組み合わせ)
│   ├── 配偶者情報 (フリガナ/氏名/個人番号/生年月日/所得見積額/退職所得)
│   ├── 非居住者/住所/障害者/異動情報
│   └── 生計を一にする事実 (送金額/通貨)
├── xml001_D00000 (扶養親族 ×最大20名)
│   ├── 扶養親族の種別 (0:初期値 1:16歳以上 2:他の所得者 3:16歳未満 4～10:退職/特定親族等)
│   ├── 個人情報 (フリガナ/氏名/個人番号/続柄/生年月日)
│   ├── 老人扶養親族 (0:非該当 1:同居老親等 2:その他)
│   ├── 特定扶養親族/特定親族 (0:非該当 1:特定扶養 2:特定親族※令和8年以降)
│   ├── 所得見積額/退職所得/非居住者/住所/障害者/異動情報
│   └── 控除を受ける他の所得者 (氏名/続柄/住所)
└── xml001_F00000 (参考情報: 提出年月日/社員番号/異動申告/加工有無)

主要コード値 ​

  • 扶養親族の種別: 0:初期値 1:16歳以上 2:他の所得者 3:16歳未満 4:退職手当等あり 5:16歳以上+退職 6:16歳未満+退職 7:特定親族 8:退職+特定親族 9:それ以外 10:特定親族+退職
  • 障害者区分: 0:非該当 1:一般 2:特別 3:同居特別(扶養親族のみ)
  • 続柄コード: 0:初期値 1:本人 2:配偶者 3:子 4:親 5:孫 6:祖父母 7:曾祖父母 99:その他
  • 元号: 1:明治 2:大正 3:昭和 4:平成 5:令和

NTAAPP003: 保険料控除申告書 ​

構造概要 ​

NTAAPP003
├── 提出に関する情報 (年分/税務署/支払者/申告者)
├── 一般の生命保険料 (×最大20件)
│   ├── 保険会社名/保険種類/保険期間/契約者名/受取人
│   ├── 新・旧の区分 (0:旧 1:新)
│   ├── インポート情報 (ファイル名/出力名/SHA-256ハッシュ)
│   ├── 金額 (変更前/変更後)
│   └── 加工有無 (0:初期 1:読込有・修正無・個人 2:読込有・修正有・個人 3:読込無・個人 4:読込無・団体 5:読込有・修正無・団体 6:読込有・修正有・団体)
├── 介護医療保険料 (×最大20件, 同構造、新旧区分なし)
├── 個人年金保険料 (×最大20件, 支払開始日あり)
├── 生命保険料控除額 (合計)
├── 地震保険料控除 (×最大20件)
│   ├── 保険会社名/保険種類/保険期間/契約者名/利用者名
│   ├── 区分 (0:旧長期 1:地震)
│   └── 金額/インポート/加工有無
├── 社会保険料控除 (×最大20件)
│   ├── 社会保険の種類/支払先名称/負担者氏名
│   ├── インポート情報/金額/加工有無
│   └── 加工有無 (0～3, 団体扱なし)
└── 小規模企業共済等掛金控除
    ├── 中小企業基盤整備機構の掛金 (金額/インポート/加工有無)
    ├── 企業型年金加入者掛金
    ├── 個人型年金加入者掛金(iDeCo) (金額/インポート/加工有無)
    ├── 心身障害者扶養共済制度の掛金
    └── 控除額合計

設計上の注目点 ​

  • 証明書インポート機能がXMLに組み込まれている (ファイル名 + SHA-256ハッシュ)
  • 「加工有無」で証明書データの出自を追跡可能
  • 「変更前」「変更後」の2フィールドで修正を追跡
  • 小規模企業共済等掛金は4種類に細分化: 中小企業基盤整備機構 / 企業型DC / 個人型DC(iDeCo) / 心身障害者扶養共済

NTAAPP004: 配偶者控除等申告書 ​

構造概要 ​

NTAAPP004
├── 提出に関する情報
├── 合計所得の見積額
│   ├── あなたの本年中の合計所得金額の見積額
│   ├── あなたの本年中の給与所得金額の見積額
│   ├── あなたの本年中の給与所得以外の所得金額の見積額
│   └── 区分１ (1:900万円以下(A) 2:900万円超950万円以下(B) 3:950万円超1000万円以下(C))
├── 配偶者
│   ├── 個人情報 (フリガナ/氏名/個人番号/生年月日/住所)
│   ├── 非居住者/生計を一にする事実(送金額/通貨)
│   ├── 配偶者の合計所得金額の見積額
│   ├── 区分２ (1:58万円以下+70歳以上 2:58万円以下+70歳未満 3:58万円超95万円以下 4:95万円超133万円以下)
│   └── 老人控除対象配偶者
└── 控除の計算
    ├── 配偶者控除の額
    └── 配偶者特別控除の額

NTAAPP006: 基礎控除申告書 ​

構造概要 ​

NTAAPP006
├── 提出に関する情報
├── 合計所得の見積額
│   ├── 合計所得金額の見積額
│   ├── 給与所得金額の見積額
│   ├── 給与所得以外の所得金額の見積額
│   └── 区分１ (1～12の12区分、132万円以下～2500万円超)
└── 控除の計算
    └── 基礎控除の額

区分１の詳細（令和7年分～） ​

1:132万円以下(A) 2:132万円超336万円以下(A) 3:336万円超489万円以下(A) 4:489万円超655万円以下(A) 5:655万円超900万円以下(A) 6:900万円超950万円以下(B) 7:950万円超1000万円以下(C) 8:1000万円超2350万円以下 9:2350万円超2400万円以下 10:2400万円超2450万円以下 11:2450万円超2500万円以下 12:2500万円超

注: 令和7年度の基礎控除引き上げ（123万円の壁対応）により区分が大幅に細分化。

NTAAPP007: 所得金額調整控除申告書 ​

構造概要 ​

NTAAPP007
├── 提出に関する情報
└── 申告の条件 (3条件のうち1つのみ選択)
    ├── 申告者が特別障害者 (手帳種類/交付日/障害内容)
    ├── 23歳未満の扶養親族 (個人情報/所得見積/住所)
    └── 特別障害者である同一生計配偶者/扶養親族 (個人情報/障害手帳/住所)

NTAAPP008: 特定親族特別控除申告書 ​

構造概要 ​

NTAAPP008
├── 提出に関する情報
└── 特定親族情報 (×最大20名)
    ├── 個人情報 (フリガナ/氏名/個人番号/続柄/生年月日/住所)
    ├── 非居住者/生計を一にする事実(送金額/通貨)
    ├── 特定親族の本年中の合計所得金額の見積額
    └── 特定親族特別控除の額

共通パターン ​

全様式共通の要素 ​

  • バージョン (X.X.X)
  • 対象年分 (西暦/元号/年)
  • 所轄税務署
  • 支払者情報 (名称/法人番号/郵便番号/所在地)
  • 申告者情報 (フリガナ/氏名/郵便番号/住所)
  • 参考情報 (提出年月日/ID(社員番号等)/加工有無)

個人番号の扱い ​

  • 個人番号提供済み (0:未提供 1:提供済み) + 個人番号 (12桁)
  • 提供済みの場合、個人番号は空タグ（2回目以降は送信しない設計）

住所の構造 ​

  • 3分割: 都道府県 + 市区町村 + 丁番地以降
  • 海外住所対応: 市区町村・丁番地で全半角許容
  • 「申告者と同じ」フラグあり

異動情報の構造 ​

  • 異動月日 (月/日) ※年は年分から判明するため不要
  • 異動事由 (コード + その他事由テキスト)

データモデルへの示唆 ​

現行モデルの課題（XML定義書から判明） ​

  1. InsuranceDeduction (DM-403) の粒度が粗い

    • XMLでは生命保険(一般/介護医療/個人年金)、地震保険、社会保険、小規模企業共済は完全に別構造
    • 特に小規模企業共済は4種類に細分化（中小機構/企業型DC/個人型DC/心身障害者扶養共済）

  2. 証明書インポートのトレーサビリティ

    • XML定義にはファイル名・SHA-256ハッシュ・加工有無がある
    • UploadedEvidence (DM-407) との紐付け設計が必要

  3. 所得見積額の複数箇所での管理

    • 申告者の合計所得: NTAAPP001, NTAAPP004, NTAAPP006 に重複
    • 配偶者の合計所得: NTAAPP001, NTAAPP004 に重複
    • データモデルでは一元管理し、各様式出力時に参照する設計が望ましい

  4. NTAAPP002（従たる給与）への対応

    • 現行モデルにはこの概念がない
    • 2箇所以上から給与を受ける従業員のケースを検討する必要あり

  5. NTAAPP007（所得金額調整控除）への対応

    • 現行モデルにこのエンティティがない
    • 給与収入850万円超の場合に適用される控除で、3条件のうち1つを選択