概要
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
2026年以降の年末調整において、年末調整従業員住宅ローンの作成・更新 API で、
「住宅借入金等特別控除区分」（`category`）に `extension`（増: 特定増改築等）を指定できなくなります。
■ 変更内容
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
変更対象API：
– `POST /api/v1/yearend_adjustments/{year}/housing_loans/{employee_id}`
（年末調整従業員住宅ローンの作成）
– `PUT /api/v1/yearend_adjustments/{year}/housing_loans/{employee_id}/{id}`
（年末調整従業員住宅ローンの更新）
変更種別：Breaking Change
変更内容：
– year パラメータに2026年以降を指定した POST / PUT リクエストにおいて、リクエストボディの`category` に `extension` を指定した場合、400 エラーを返却します。
– year パラメータに2025年以前を指定した場合は、従来どおり `extension` を指定できます。
変更理由：
特定増改築等住宅借入金等特別控除は、2021 年（令和 3 年）12 月 31 日までに居住を開始した場合が適用対象で、控除期間は 5 年間のため、2025 年（令和 7 年）分が最終の適用年となります。2026 年（令和 8 年）分以降は制度上の適用対象者がいなくなり、国税庁の源泉徴収票の様式からも区分「増」が削除されました。これに伴い、freee人事労務においても 2026 年以降の年末調整では当該区分の入力を受け付けない仕様に変更します。
■ 変更スケジュール
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
アナウンス日：2026/10/9
変更リリース予定日：2026/10 中旬
■ 対応方法
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
2026年以降の年末調整の住宅ローン情報を作成・更新するアプリ開発者が影響を受けます。以下の対応・確認をお願いいたします。
#### POST / PUTリクエストの改修・確認（対応必須）
category に extension を指定して住宅ローン情報を作成・更新しているロジックがある場合、yearパラメータに2026年以降を指定するリクエストでは extension を送信しないようアプリ側での改修・ご確認をお願いいたします。2026年以降は制度上 extension に該当する住宅ローンは存在しないため、general / qualified / earthquake のいずれかを指定してください。
#### GETリクエストを利用している場合（対応不要）
レスポンスの内容・構造に変更はないため、アプリ側の改修は不要です。
#### 2025年以前のデータへの影響
yearパラメータに2025年以前を指定する場合は、本仕様変更の影響を受けません。
■ 変更後のAPI仕様
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
エンドポイント：
/api/v1/yearend_adjustments/{year}/housing_loans/{employee_id}
リクエスト：POST
エンドポイント：
/api/v1/yearend_adjustments/{year}/housing_loans/{employee_id}/{id}
リクエスト：PUT
POST / PUT ともにリクエストボディの構造に変更はありません。
yearパラメータに2026年以降を指定した場合、categoryにextension を指定するとエラーになり、住宅ローン情報は作成・更新されません。general / qualified / earthquake は従来どおり指定できます。
【リクエストボディ例】
{
"company_id": 1,
"housing_loan": {
"residence_start_date": "2021-06-01",
"remaining_balance_at_yearend": 5000000,
"category": "extension", // ← 2026年以降の場合、extension を指定するとエラーになります
"specific_case_type": "not_qualified"
}
}
レスポンス：上記リクエストに対するレスポンスが以下のとおり変わります。
【変更前】（yearパラメータが2025年以前の場合）
POST は 201 Created、PUT は 200 OK で住宅ローン情報が作成・更新されます。
{
"housing_loan_deduction": 500000,
"housing_loans": [
{
"id": 1,
"residence_start_date": "2021-06-01",
"remaining_balance_at_yearend": 5000000,
"category": "extension", // ← 2025年以前の場合は従来どおり登録されます
"specific_case_type": "not_qualified"
}
]
}
【変更後】（yearパラメータが2026年以降の場合）
POST / PUT ともに 400 Bad Request を返却し、住宅ローン情報は作成・更新されません。
{
"status_code": 400,
"errors": [
{
"type": "bad_request",
"messages": ["住宅借入金等特別控除区分は2026年以降「増: 特定増改築等」を選択できません"] // ← エラーメッセージが返却されます
}
]
}