【重要】[freee人事労務] 年末調整API 変更のお知らせ

概要

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

freee人事労務 年末調整API 家族情報の更新において、配偶者の「給与収入」に設定できる値の最小値を0円に変更します。

■ 変更内容

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

変更対象API:PUT /api/v1/yearend_adjustments/{year}/dependents/{employee_id}

変更種別:Breaking Change

変更内容:

  •  「employment_revenue(給与収入)」の最小値を-999999999から0円に変更します

変更理由:

給与収入にマイナスの値を設定することは業務上・仕様上不適切であるため

■ 変更スケジュール

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

アナウンス日:2026/10/08

変更リリース予定日:2026/10/09

■ 対応方法

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  • 給与収入として設定する場合:0円以上の正しい給与収入値を設定してください。
  • マイナスの値を設定したい場合:「all_other_income(給与以外の所得)」として登録してください。こちらは引き続き-999999999まで設定可能です。 

■ 変更後のAPI仕様

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

エンドポイント:/api/v1/yearend_adjustments/{year}/dependents/{employee_id}

リクエスト:PUT

[変更前] 

employment_revenue(給与収入)

  • minimum: -999999999
  • maximum: 999999999

[変更後] 

employment_revenue(給与収入)

  • minimum: 0
  • maximum: 999999999