■ 概要
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
従業員の作成・更新APIにおいて、締め日支払い日グループ名パラメータの文字数制限を15文字から20文字へ緩和します。
■ 変更内容
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
対象API:api/v1/employees(POST / PUT)
変更種別:Non-Breaking Change
変更内容:
従業員作成/更新時に指定可能な「締め日支払い日グループ名」パラメータの最大文字数制限を、従来の15文字から20文字へ拡張します。
変更理由:
締め日支払い日グループ名未指定時のデフォルト名変更に伴い、登録可能な文字数を拡張するため。
■ 変更スケジュール
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
アナウンス日:2026/11/17
変更リリース日:2026/11/23
旧バージョン廃止予定日:該当なし(後方互換性のある変更のため)
■ 対応方法
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
本変更はパラメータの上限緩和(後方互換性あり)のため、既存の連携アプリ側での必須の対応はございません。
20文字までの締め日支払い日グループ名を取り扱う場合のみ、必要に応じてクライアント側のバリデーション設定等の見直しをご検討ください。
■ 変更後のAPI仕様
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
対象エンドポイント:
- POST https://api.freee.co.jp/hr/api/v1/employees
- PUT https://api.freee.co.jp/hr/api/v1/employees/{id}
リクエスト変更詳細:
- Request bodyのフォーマット・構造自体に変更はありません。
- 対象パラメータの文字数制約を変更します:
- パラメータ名:company_reference_date_rule_name
- 変更前:maxLength: 15
- 変更後:maxLength: 20