2025年12月の更新情報

(12/01)[人事労務] 従業員のグループ所属情報の取得APIの追加および年末調整APIにおけるバリデーションの変更が行われました。

変更対象API: 従業員のグループ所属情報の取得 – /api/v1/employees/{employee_id}/group_memberships
変更種別: 新規追加
変更内容:従業員が所属するグループ(部門等)の情報を取得するエンドポイントが新規追加されました。

変更対象API: 年末調整(扶養家族・本人情報) – /api/v1/yearend_adjustments/...
変更種別: 破壊的変更なし
変更内容:

  • 以下のプロパティにおいて、最小値(min)が 0.00 から -999999999.00 に引き下げられ、マイナスの値を許容するようになりました。
  • 扶養家族情報:all_other_income(その他の所得合計額), employment_revenue(給与収入)
  • 本人情報:all_other_income(合計所得金額見積額), other_company_revenue(他社給与収入)

(12/10, 12/15, 12/22)[販売] freee販売 APIにおいて、ステータス定義の刷新を含む大幅な仕様変更が行われました。

変更対象API: 取引先・受注 – /businesses, /sales_orders
変更種別: 破壊的変更あり
変更内容:代わりに billed, delivered, not_billed, partially_billed など、より詳細な状態を示す値が追加されました。

  • ステータスEnumの大幅変更(12/15)各種ステータス(請求、納品、回収、売上)において、従来の todo / doing / done が削除されました。
  • リクエストパラメータの任意項目化・Null許容変更(12/10, 12/22)
    • 取引先作成時の name や、受注作成時の customer_id, sales_order_date, lines 等の多くの項目が必須から任意(Optional)に変更されました。
    • 取引先作成時、business_date と code がNull許容となった一方、prospect_sales_order はNull不可となりました。
  • レスポンス構造の変更(12/10, 12/15)
    • POST時のレスポンスに id, last_updated_at, registered_at が必須項目として含まれるようになりました。
    • 受注詳細取得において、明細行(lines)の id が必須ではなくなりました。
  • 新規プロパティの追加(12/22)
    • 受注情報に canceled(キャンセルフラグ)プロパティが追加されました。
    • 取引先情報に last_updated_by(最終更新者)などの監査用プロパティが追加されました。

(12/16)[会計] 事業所詳細取得APIにおいて、会計年度のIDが含まれるようになりました。
変更対象API: 事業所の詳細取得 – /api/1/companies/{id}
変更種別: 破壊的変更なし
変更内容:

レスポンスの fiscal_years(会計年度)オブジェクトに、年度を特定するための id プロパティが追加されました。

(12/23)[人事労務] 勤怠管理APIにおいて、所定休日労働時間に関するプロパティが追加されました。

変更対象API: 勤怠情報 – /api/v1/employees/{employee_id}/work_records, /work_record_summaries
変更種別: 破壊的変更なし
変更内容:

日次の勤怠および月次の勤怠要約情報において、total_prescribed_holiday_work_mins(所定休日労働時間)がリクエストおよびレスポンスに追加されました。これにより、API経由で所定休日の労働時間の取得・更新が可能になります。