■ 概要
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
2026年以降の年末調整において、家族情報の「住民税のみの控除対象かどうか」の入力（保存・更新）受付を停止します。また、データ取得時のレスポンスからも同項目が削除されます。
■ 変更内容
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
対象API：
- GET /api/v1/yearend_adjustments/{year}/employees/{employee_id}
- PUT /api/v1/yearend_adjustments/{year}/dependents/{employee_id}
変更種別：Breaking Change
変更内容：
- yearパラメータに2026年以降を指定した場合、レスポンスから is_resident_tax_only_deduction が削除されます。
- yearパラメータに2026年以降を指定したPUTリクエストにおいて、is_resident_tax_only_deduction を指定しても値は無視され、保存されなくなります。
変更理由：
2026年以降の年末調整では、家族情報の「住民税のみの控除対象かどうか」の入力を受付停止し、入力された所得額から住民税の控除対象かどうかを自動判定する仕様に変更されるためです。
■ 変更スケジュール
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
アナウンス日：2026/09/14
変更リリース予定日：2026/10 中旬
■ 対応方法
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
2026年以降の年末調整データを取得・更新するアプリ開発者が影響を受けます。以下の対応・確認をお願いいたします。
GETリクエストの改修・確認（対応必須）
is_resident_tax_only_deduction の値を取得・参照してロジックを組んでいる場合、フィールドの欠損によるエラーが発生しないようアプリ側での改修・ご確認をお願いいたします。
PUTリクエストを利用している場合（対応不要）
同パラメータを送信している場合はパラメータが無視されるようになります。APIのリクエスト自体はエラーにはならないため、アプリ側の改修は不要です。
2025年以前のデータへの影響
yearパラメータに2025年以前を指定する場合は、本仕様変更の影響を受けません。
■ 変更後のAPI仕様
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
エンドポイント：/api/v1/yearend_adjustments/{year}/employees/{employee_id}
リクエスト：GET
【変更前】（yearパラメータが2025年以前の場合）
{
"employee": {
// ... (中略：変更はありません) ...
},
"dependents": [
{
"id": 1,
"last_name": "山田",
"first_name": "花子",
// ... (中略) ...
"annual_remittance_amount": 0,
"non_resident_dependents_reason": "none",
"is_resident_tax_only_deduction": true, // ← 2025年以前の場合は返却されます
"retirement_income": 0
}
],
"insurances": [
// ... (中略：変更はありません) ...
]
}【変更後】（yearパラメータに2026年以降を指定した場合）
{
"employee": {
// ... (中略：変更はありません) ...
},
"dependents": [
{
"id": 1,
"last_name": "山田",
"first_name": "花子",
// ... (中略) ...
"annual_remittance_amount": 0,
"non_resident_dependents_reason": "none",
// ← is_resident_tax_only_deduction フィールドは返却されません
"retirement_income": 0
}
],
"insurances": [
// ... (中略：変更はありません) ...
]
}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
エンドポイント：/api/v1/yearend_adjustments/{year}/dependents/{employee_id}
リクエスト：PUT
year が 2026年以降の場合、リクエストボディに is_resident_tax_only_deduction を含めても無視されます（API自体はエラーにならず、他の値は正常に保存されます）。
【リクエストボディ例】
{
"dependent": {
"last_name": "山田",
"first_name": "花子",
"relationship": "spouse",
// ... (中略：その他のパラメータ) ...
"is_resident_tax_only_deduction": true // ← 2026年以降の場合、送信しても無視（破棄）されます
}
}