概要
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
freee申告 年調・法定調書で、年末調整の申告書の作成方法に「インポート/手動入力」を選択している事業所（以下、「手動入力モードの事業所」）について、freee人事労務 年末調整APIのうちデータを作成・更新・削除するAPIを受け付けないように変更します。
手動入力モードの事業所に対してこれらのAPIを実行すると、403エラーを返します。
取得API（GET）は従来どおり利用できます。また、作成方法が「freee人事労務連携」の事業所と、freee申告 年調・法定調書を利用していない事業所には影響ありません。
■ 変更内容
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
変更対象API：freee人事労務の年末調整API のうち、データを作成・更新・削除する以下の12エンドポイント
| 対象 | メソッド | パス |
|---|---|---|
| 従業員の年末調整情報 | PUT | /api/v1/yearend_adjustments/{year}/employees/{employee_id} |
| 給与・賞与情報 | PUT | /api/v1/yearend_adjustments/{year}/payroll_and_bonus/{employee_id} |
| 家族情報 | PUT | /api/v1/yearend_adjustments/{year}/dependents/{employee_id} |
| 前職情報 | PUT / DELETE | /api/v1/yearend_adjustments/{year}/previous_jobs/{employee_id} |
| 保険料情報（作成） | POST | /api/v1/yearend_adjustments/{year}/insurances/{employee_id} |
| 保険料情報（更新・削除） | PUT / DELETE | /api/v1/yearend_adjustments/{year}/insurances/{employee_id}/{id} |
| 住宅ローン控除情報 | PUT | /api/v1/yearend_adjustments/{year}/housing_loan_deductions/{employee_id} |
| 住宅ローン情報（作成） | POST | /api/v1/yearend_adjustments/{year}/housing_loans/{employee_id} |
| 住宅ローン情報（更新・削除） | PUT / DELETE | /api/v1/yearend_adjustments/{year}/housing_loans/{employee_id}/{id} |
※変更の対象外（従来どおり利用できます）
| 対象 | メソッド | パス |
|---|---|---|
| 年末調整対象者の一覧 | GET | /api/v1/yearend_adjustments/{year}/employees |
| 従業員の年末調整情報 | GET | /api/v1/yearend_adjustments/{year}/employees/{employee_id} |
変更種別：Breaking Change
変更内容：
- 手動入力モードの事業所に対して上記のAPIを実行した場合、403 Forbidden を返します。データは作成・更新・削除されません。
- 判定は {year} ごとに行います。手動入力モードになっていない年度の年末調整は、従来どおり実行できます。
- 顧問税理士（アドバイザー）が freee申告 年調・法定調書で作成方法を「freee人事労務連携」に切り替えると、従来どおり実行できるようになります。
- 管理者のアクセストークンと従業員本人のアクセストークンのどちらで実行しても、同じ挙動です。
変更理由： 手動入力モードでは、顧問税理士（アドバイザー）が freee申告 年調・法定調書上で年末調整の内容を入力・編集します。その間に freee人事労務側からAPIで同じ従業員の年末調整データが変更されると、アドバイザーと事業所側の操作が競合し、相互に意図しない変更が起きるおそれがあります。これを防ぐため、freee人事労務の画面と同じく、APIからの変更も受け付けないようにします。
■ 変更スケジュール
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
アナウンス日：2026/11/9
変更リリース予定日：2026/11/30
旧バージョン廃止予定日：該当なし
■ 対応方法
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
影響を受けるのは、手動入力モードの事業所に対して、年末調整の作成・更新・削除API（POST / PUT / DELETE）を実行するアプリの開発者です。
- 作成・更新・削除API（POST / PUT / DELETE）をご利用の場合（対応必須）
- 403 Forbidden が返った場合にリトライを繰り返さず、エラーとして扱うようアプリ側の改修・確認をお願いします。
- 該当の事業所で freee人事労務側の年末調整データを変更する必要がある場合は、事業所の担当者から顧問税理士（アドバイザー）に確認のうえ、freee申告 年調・法定調書で作成方法を「freee人事労務連携」に切り替えてから再実行してください。
- 取得API（GET）のみご利用の場合（対応不要）
- レスポンスの内容・構造に変更はありません。
■ 変更後のAPI仕様
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
エンドポイント：上記「変更対象API」の12エンドポイント
リクエスト： リクエストボディの構造に変更はありません。手動入力モードの事業所に対して実行した場合のみ、以下のエラーを返します。
レスポンス：
■ 変更後（手動入力モードの事業所の場合）
403 Forbidden
{
"status_code": 403,
"errors": [
{
"type": "forbidden",
"messages": [
"現在、freee申告で年末調整を作成中のため、freee人事労務での編集に制限がかかっています。freee人事労務での作成に戻すには、アドバイザーに確認の後、freee申告に遷移して作成方法を「人事労務連携」に切り替えてください。また、アドバイザーがfreee申告で入力した内容により、こちらに表示されている情報が上書きされることがあります。"
]
}
]
}