【重要】freee人事労務 API変更のお知らせ

■ 概要
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

2026年6月末頃より、freee人事労務のWeb版において休暇の同日取得機能が拡張され、同一日に特別休暇を含む以下の組み合わせの休暇申請が作成・登録できるようになります。

年次有給休暇 × 特別休暇
特別休暇 × 特別休暇

これに伴い、以下の休暇申請API（v1）において、上記の組み合わせで登録された休暇申請を含むリクエストを行った場合、操作によってエラー（status_code: 400）となります。

/api/v1/approval_requests/paid_holidays （年次有給休暇申請API）
/api/v1/approval_requests/special_holidays （特別休暇申請API）

なお、「勤怠」「勤怠情報サマリ」APIにおける同機能への未対応については、別途お知らせしている通りです。
API対応時期は未定です。決まり次第、改めてお知らせいたします。

■ 変更内容
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

変更対象API：freee人事労務 API（年次有給休暇申請API・特別休暇申請API / v1）

変更種別：Non-Breaking Change（既存のリクエストへの影響はありません。Web版で新たに登録可能となる同日取得の組み合わせデータに対してのみエラーとなります）

変更理由：Web版の機能拡張（休暇の同日取得機能）にpublic APIが追従していないため。

変更内容：
「年次有給休暇 × 特別休暇」または「特別休暇 × 特別休暇」が同一日に登録された休暇申請に対し、以下の挙動となります。

申請の作成：上記の組み合わせを含む申請は作成できません。
申請の詳細取得：エラー（status_code: 400）となります。
申請の一覧取得：該当の申請を一覧から除外して返却します。（エラーにはなりません）
申請の承認・差戻し等のアクション：エラー（status_code: 400）となります。
申請の更新：可能です。ただし作成と同様、リクエストに組み合わせを含めることはできません。
申請の削除：可能です。（制限なく削除できます）

エラー例

{
    "status_code": 400,
    "errors": [
        {
            "type": "bad_request",
            "messages": [
                "特別休暇が2つ登録されています。Webで確認してください。"
            ]
        }
    ]
}

対象APIリファレンス：

■ 対応方法
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

仕様（リクエスト/レスポンスの型）としての破壊的変更（Breaking Change）はありませんが、Web版で同日取得機能を利用して登録された休暇申請に対しては、API側でエラーまたは一覧からの除外が発生します。該当するデータを取り扱う可能性のあるアプリケーションをご開発の場合は、エラーハンドリング等のご考慮をお願いいたします。

API対応時期は未定（決定次第、改めて告知）です。それまでの間は、以下の対応をご検討ください。

申請の作成・詳細取得・承認等の操作でエラー（400 Bad Request）が発生した場合は、エラーメッセージ（例：「特別休暇が2つ登録されています。Webで確認してください。」）を元に、ユーザーへWeb画面側での確認・操作を促すよう、アプリケーション側でエラーハンドリングを追加してください。
「年次有給休暇 × 特別休暇」または「特別休暇 × 特別休暇」の同日取得となる申請を新規に登録したい場合は、Web版freee人事労務をご利用ください。
一覧取得では当該申請が結果から除外されるため、Web版で表示される件数との差異が生じる可能性があります。全件を確認したい場合はWeb版をご利用ください。

■ 変更スケジュール
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

アナウンス日：2026/06/11
変更リリース予定日：2026年6月末予定