下記の通り、freeeの全サービス (電子公告サービス除く、freeeサイン除く) のメンテナンスを実施します。

• 日時: 2024/05/23 (木) 1:00 – 5:00
• 対象: freee 全サービス

メンテナンス中は該当サービスをご利用いただけません。

ご迷惑をおかけしますが、ご理解の程よろしくお願い致します。

本事象については復旧対応が完了しております。

ご迷惑をおかけし、大変申し訳ございません。

発生日時

• 2024年05月11日(土)　08時02分頃　〜　2024年05月11日(土)　8時40分頃

発生事象

• 「freeeの各種サービスの一部機能」の動作が不安定な状況が確認されておりました。
• この間、アクセストークンの発行やAPIコールが正しく実行されないことが確認できています。
• https://status.freee.co.jp/issues/663eb1a5386fb34969b80323

ご対応いただきたいこと

• 発生事象をご確認の上、APIの実行結果の確認、必要に応じてAPIの再実行等のご案内をお願い申し上げます。

本事象については復旧対応が完了し、現在は解消しております。

2023年10月25日のリリースノートにてお知らせしたfreee工数管理のPublic_APIにおける仕様変更につきまして、スケジュールを詳細化しましたのでご連絡いたします。

対象エンドポイント

• GET /projects プロジェクト一覧の取得
• GET /projects/{id} プロジェクト詳細の取得
• POST /projects プロジェクトの登録

変更内容

freee工数管理のPublic APIにおいて、一部エンドポイントのパラメーターを廃止します。
※詳細は既報のリリースノートをご参照ください。

リリース時期

• 2024年8月1日以降（予定）
• その他の機能削減については、ヘルプページをご参照ください。

本事象について、2024年05月09日 18時20分頃に復旧対応が完了し、現在は解消しております。

ご迷惑をおかけし、大変申し訳ございません。

発生日時

• 2024年04月23日(火) 03:00頃　〜　2024年05月09日(木)　 18:20頃

発生事象

• 取引の一覧取得のエンドポイントにおいて、offsetを用いて取引を複数リクエストで取得している場合、オフセット処理が正しく実施されず、同一の情報が繰り返し取得できてしまう場合がありました。
  • 例）
  • GET /api/1/deals「 取引（収入・支出）一覧の取得」で、取引の一覧を取得したとき、offsetを1,2と別ページで取得しても、同じIDの取引がそれぞれのリクエストで出現してしまう。
• この事象は以下の条件で発生しうることがわかっています。
  • 「発生日（issue_date）」が同日の取引が多数存在していて、limitで指定した「1リクエストで取得する取引の個数」の値より、issue_dateが同日の取引が多かった場合。
  • 例）
    • limit: 20
    • issue_date: 2024-05-01の取引の件数が20(limit)より多い
    • offset: 0, 20, 40, ・・・と指定していた場合
• 但し上記の条件下であっても、発生する場合と発生しない場合があります。
• また、上記の条件に当てはまらないリクエストでは発生し得ません。
• （2024/05/13追記）
  • 上記の事象について、同様の発生条件で 「取引が取得できない」ケースがあることを確認しています。（重複して取得されていると同時に、一部の取引が取得できていない）

対象エンドポイント

• GET　/api/1/deals　取引（収入・支出）一覧の取得

ご対応いただきたいこと

• 発生事象をご確認の上、取引の取得結果の確認・必要に応じて取引の再取得の実施の操作、ご案内をお願い申し上げます。

本事象について、2024年05月09日(木)18:20頃に復旧対応が完了し、現在は解消しております。

ご迷惑をおかけし、大変申し訳ございません。

freee会計のdeal_idの最大値が、intの上限値（2,147,483,647）を超過しました。

上記に伴い、freee会計APIで指定できる、deal_idの上限値を引き上げました。(bigintの上限値）

多くの開発者におかれましては、変更の影響はございませんが、変更前のSchemaを用いてSDK（クライアントコード）の生成を行っている場合、バリデーションによってリクエストが失敗する場合があることを確認しています。

ご迷惑をおかけし大変申し訳ございません。

お手数をお掛けしますが、クライアントコードの生成等をされている開発者は、再度最新のSchemaでクライアントコードの再生成を行っていただきますようお願いいたします。

対象エンドポイント

• deals.id（取引ID）を利用する全てのエンドポイント

変更内容

• deals.id(取引ID)の上限を以下の通り変更しました。
• 変更前
  　・2,147,483,647 （intデータ型最大値）
• 変更後
  　・9,223,372,036,854,775,807（bigintデータ型最大値）

改修を伴う内容にも関わらず、事前に十分な告知を行えず申し訳ございません。

freee会計APIをご利用の開発者の皆様におかれましては、変更点をご確認いただき、アプリの改修などの必要な対応をいただきますよう、よろしくお願い申し上げます。

リリース時期

• 2024/04/25（Schemaの変更タイミング）

下記の通り、freeeの全サービス (電子公告サービス除く) のメンテナンスを実施します。

日時：2023/12/21 (木) 1:00 – 5:00

対象：freee 全サービス(電子公告サービス除く)

メンテナンス中は該当サービスをご利用いただけません。

ご迷惑をおかけしますが、ご理解の程よろしくお願い致します。

下記の通り、freeeの全サービス (電子公告サービス除く) のメンテナンスを実施します。

日時：2023/11/21 (火) 1:00 – 5:00

対象：freee 全サービス（電子公告サービス除く）

メンテナンス中は該当サービスをご利用いただけません。

ご迷惑をおかけしますが、ご理解の程よろしくお願い致します。

freee人事労務APIにおいて、以下の仕様変更があります。

• 勤怠APIのリクエストボディとレスポンス、勤怠情報サマリAPIのレスポンスに変更があります。
• 勤怠APIで特別休暇および有給休暇（時間休）の勤怠登録が可能になります。
• 勤怠APIでの有給休暇（半休）の勤怠登録に変更があります。

この変更は2段階に分けて行います。

変更内容①は11月中旬に、破壊的な変更を含む変更②は2024年2月上旬に行います。

freee人事労務APIをご利用の開発者の皆様におかれましては、変更点をご確認いただき、アプリの改修などの必要な対応をいただきますよう、よろしくお願い申し上げます。

変更内容①:

freee人事労務 勤怠の取得API、勤怠の更新APIのリクエストボディとレスポンス、および勤怠情報月次サマリの取得API（work_records=trueの場合）のレスポンスに以下の項目を追加します。

• half_paid_holiday_mins ：有給休暇の半休を利用した時間（分単位）
• special_holiday ：この日の特別休暇取得数
• special_holiday_setting_id ：特別休暇設定ID
• half_special_holiday_mins ：特別休暇の半休を利用した時間（分単位）
• hourly_special_holiday_mins ：特別休暇の時間休を利用した時間（分単位）

freee人事労務 勤怠の更新APIにおいて、特別休暇の登録が可能になります。

• 特別休暇（全休）は、special_holiday_setting_idとspecial_holiday=1を指定してください。
• 特別休暇（半休）は、special_holiday_setting_idとhalf_special_holiday_minsを指定してください。
• 特別休暇（時間休）は、special_holiday_setting_idとhourly_special_holiday_minsを指定してください。

freee人事労務 勤怠の更新APIにおいて、有給休暇（時間休）の登録が可能になります。

• hourly_paid_holiday_minsを指定してください。

freee人事労務 勤怠の更新APIにおいて、有給休暇（半休）の登録方法に変更があります。

• half_paid_holiday_minsを指定してください。
• なお非推奨ではありますが、現行の有給休暇（半休）登録方法も引き続き使用できます。
  • normal_work_mins_by_paid_holiday（有給によって計上される所定労働時間（分））を指定します。paid_holiday（この日の有給休暇取得数）=0.5は入力不要です（入力してもエラーにはなりません）。

対象エンドポイント:

• 勤怠の取得API（PUT /api/v1/employees/{employee_id}/work_records/{date}）
• 勤怠の更新API（PUT /api/v1/employees/{employee_id}/work_records/{date}）
• 勤怠情報月次サマリの取得API（/api/v1/employees/{employee_id}/work_record_summaries/{year}/{month}）

変更理由:

• freee人事労務の特別休暇をAPIで登録できるようにするためです。
• freee人事労務の有給休暇（時間休）をAPIで登録できるようにするためです。
• 有給休暇（半休）登録方法の移行期間を設けます。現行の登録方法も利用可能とするこの期間内に、アプリの改修など必要な対応を完了していただくためです。

変更の実施時期:

• 2023年11月中旬

変更内容②:（破壊的な変更を含む）

freee人事労務 勤怠の取得API、勤怠の更新API、勤怠情報月次サマリの取得API(work_records)のレスポンスから、以下の項目を廃止します。

• normal_work_mins_by_paid_holiday：有給によって計上される所定労働時間（分）

freee人事労務 勤怠の更新APIのリクエストボディから、以下の項目を廃止します。

• normal_work_mins_by_paid_holiday：有給によって計上される所定労働時間（分）
• このため、現行の有給休暇（半休）登録方法が使用できなくなります。
• normal_work_mins_by_paid_holidayに時間を指定しても、有給休暇（半休）の登録はできなくなります。
• paid_holiday（この日の有給休暇取得数）は1（全休）以外を指定するとエラーになります。

対象エンドポイント:

• 勤怠の取得API（PUT /api/v1/employees/{employee_id}/work_records/{date}）
• 勤怠の更新API（PUT /api/v1/employees/{employee_id}/work_records/{date}）
• 勤怠情報月次サマリの取得API（/api/v1/employees/{employee_id}/work_record_summaries/{year}/{month}）

変更理由:

• 勤怠APIの有給休暇（半休）登録方法の変更に伴う移行対応期間を終了します。
• ※変更の実施時期までに、アプリの改修など必要な対応を完了してください。

変更の実施時期:

• 2024年2月上旬

下記2点、freee請求書 請求書API・見積書APIの仕様変更があります。
freee請求書APIをご利用の開発者の皆様におかれましては、変更点をご確認いただき、アプリの改修などの必要な対応をいただきますよう、よろしくお願い申し上げます。

変更内容①：

• POST・PUT時のリクエストパラメーター「partner_title（敬称）」について、敬称なしとする場合は、これまで全角のカッコを用いた “（空白）”で受け付けていました。今後、半角のカッコを用いた “(空白)”でもリクエストを受けることとします。

対象エンドポイント：

• POST /invoices 請求書の作成
• POST /quotations 見積書の作成
• PUT /invoices/{id} 請求書の更新
• PUT /quotations/{id} 見積書の更新

変更理由：

• freee会計の取引先API・請求書API・見積書APIと敬称についての仕様を揃えるためです。
• ※なお非推奨ではありますが、全角のカッコを用いた “（空白）”でも指定は可能です。

変更の実施時期：

• 2023年9月初旬

変更内容②：

• GET時、またPOST/PUT後のレスポンスパラメーター「partner_title（敬称）」について、敬称なしの場合は、これまで全角のカッコを用いた “（空白）”で返却していました。今後、半角のカッコを用いた “(空白)”でのみレスポンスすることとします。

対象エンドポイント：

• GET /invoices/{id} 請求書の取得
• GET /quotations/{id} 見積書の取得

変更理由：

• freee会計の取引先API・請求書API・見積書APIと仕様を揃えるためです。
• ※なおPOST/PUT時の指定が全角/半角であったかに関わらず、半角のカッコを用いた “(空白)”でのみレスポンスすることとします。

変更の実施時期：

• 2023年9月初旬（変更①実施後）

下記の通り、freeeの全サービス (電子公告サービス除く) 、freeeサインのメンテナンスを実施します。

日時：2023/8/23 (水) 1:00 – 5:00

対象：freee 全サービス（電子公告サービス除く）、freeeサイン

メンテナンス中は該当サービスをご利用いただけません。

ご迷惑をおかけしますが、ご理解の程よろしくお願い致します。