(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不可となりました。
- 取引先作成時の name や、受注作成時の
- レスポンス構造の変更(12/10, 12/15)
- POST時のレスポンスに
id,last_updated_at,registered_atが必須項目として含まれるようになりました。 - 受注詳細取得において、明細行(lines)の id が必須ではなくなりました。
- POST時のレスポンスに
- 新規プロパティの追加(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経由で所定休日の労働時間の取得・更新が可能になります。