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

以前よりご案内しておりました通り、以下のfreee会計APIを廃止いたします。

• DELETE /api/1/invoices/{id}：請求書の削除

• PUT /api/1/invoices/{id}：請求書の更新

• DELETE /api/1/quotations/{id}：見積書の削除

• PUT /api/1/quotations/{id}：見積書の更新

freee会計APIをご利用されている開発者の皆さまにおかれましては、freee請求書APIへの移行などの対応をご検討いただきますよう、よろしくお願い申し上げます。

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

変更対象 API：freee会計　請求書・見積書の更新・削除API

変更種別：Breaking Change

変更内容：

 – 上記4つのAPIの廃止をいたします。

変更理由：当社の「freee請求書」が2022年12月にリリースされ、従来「freee会計」で操作可能であった請求書・見積書の更新・削除機能を「freee請求書」へ移行いたしました。それに伴い以下の変更が行われ、インボイス制度対応は「freee請求書」APIのみで対応されます。

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

アナウンス日：2025/07/07
変更リリース予定日：2025/07/07
旧バージョン廃止予定日：2025/07/07（該当する場合）

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

「freee請求書」APIの仕様の詳細は、2023年4月に公開した、リファレンスにてご確認ください。
freee請求書 APIリファレンス

また、freee会計の請求書・見積書APIから、freee請求書の請求書・見積書APIへの移行に際しては、2023年5月に公開した、以下の移行ガイドをご活用ください。
freee会計 帳票API→freee請求書 帳票API移行ガイド

概要

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

取引先タグに加えて、品目、部門、セグメントタグ、勘定科目をコードを用いて、取引(収入・収支)の作成が可能になりました。

また、マスタ情報のメンテナンス利便性を目指し、各タグ・勘定科目データに対して、更新日を指定しての取得や、コードを利用した更新と新規作成が可能になりました。

■ 変更内容

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

変更対象API：freee会計

• 取引(収入・支出)の作成API・勘定科目一覧の取得
• 品目一覧の取得
• 部門一覧の取得API・取引先の更新
• 品目の更新
• 部門の更新
• セグメントタグの更新
• 勘定科目の更新API

変更種別：Non-Breaking Change

変更内容：

• POST /api/1/deals  に以下を追加
  • account_item_code（勘定科目コード）
  • item_code（品目コード）
  • section_code（部門コード）
  • segment_1_tag_code（セグメント１タグコード）
  • segment_2_tag_code（セグメント２タグコード）
  • segment_3_tag_code（セグメント３タグコード）
• 以下のAPIのParametersに、start_update_date、end_update_dateを追加
  • GET /api/1/account_items（勘定科目一覧の取得）
  • GET /api/1/walletables（口座一覧の取得）
  • GET /api/1/sections（部門一覧の取得）
  • GET /api/1/segments/{segment_id}/tags（セグメントタグ一覧の取得）
• マスタの更新と新規作成に関する以下のAPIの追加
  • PUT /api/1/partners/upsert_by_code(取引先の更新)
  • PUT /api/1/items/code/upsert（品目の更新）
  • PUT /api/1/sections/code/upsert（部門の更新）
  • PUT/api/1/segments/{segment_id}/tags/code/upsert（セグメントタグの更新）
  • PUT /api/1/account_items/code/upsert（勘定科目の更新）
    

変更理由：

取引の作成に関しては、これまで取引先タグのみコードを指定し、取引作成が可能になっていました。
一方で、その他のマスタはidでの指定が必要だったため、取引作成時にidの取得等が必要でした。

コードでの指定ができることで、より外部マスタと共通化して利用しやすくなりました。

また、付随してこれまで一部のタグで可能だった更新日の範囲指定による取得や、更新を行いやすくすることで、メンテナンス性の向上を目指しています。

■ 変更スケジュール

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

アナウンス日：2025/06/26

変更リリース日：2025/06/25

■ 対応方法

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

利用しているparameterの更新や、新規で作成されたAPIの利用。

■ 概要

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

以前こちらでご案内していたfreee会計 ファイルボックス(証憑ファイル)のアップロードAPIのrate limitの仕様変更につきまして、事前に告知していた通り5/19に実施致しましたので、再度ご案内致します。

【重要】freee会計 ファイルボックス(証憑ファイル)のアップロードAPI 変更のお知らせ

freee会計 ファイルボックス(証憑ファイル)のアップロードAPIをご利用の開発者の皆さまにおかれましては、変更点をご確認いただき、アプリ改修などの必要な対応をいただきますよう、よろしくお願い申し上げます。

■ 変更内容

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

変更対象API：freee会計 ファイルボックス(証憑ファイル)のアップロード

変更種別：Breaking Change

変更内容：

 – 上記エンドポイントの現在の rate limit は以下です。

【変更前】 600リクエスト/分

【変更後】 300リクエスト/分

• rate limitを超過した場合のエラー内容は以下のように変わります。

【変更前】

ステータスコード：400

エラーメッセージ：「ファイルのアップロードに失敗しました。1分間にアップロードできるファイル数の上限(600ファイル)を超えています。」

【変更後】

ステータスコード：400

エラーメッセージ：「ファイルのアップロードに失敗しました。1分間にアップロードできるファイル数の上限(300ファイル)を超えています。」

変更理由：[変更を行う背景・理由]

freee Public APIの可用性及びセキュリティ強化の一環のため

■ 対応方法

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

上記エンドポイントを利用するアプリが以下の2つの仕様を満たすことを推奨します。

1. APIの呼び出し回数の制御
   
   変更後のrate limit（300リクエスト/分）を超えないよう、呼び出し回数の調整をお願い致します。API処理時間は1秒程度のため、直列実行の場合は制限を超える可能性は低いですが、並列実行している場合はスレッド数の調整をご検討ください。※1
   
2. エラー発生に備えた制御
   
   以下のいずれかの機能を実装することをご検討ください。
   • rate limit制限超過時には、適切な間隔を設けた再試行処理
   • rate limit制限によりアップロードに失敗した証憑ファイルをユーザーが手動で再アップロードできる機能。※2

※1. 事業所単位でファイルアップロードのrate limit制限を設けているため、直列実行の場合でも複数のユーザーが同時にアップロードをすると制限を超える可能性があります。

※2. 並列実行時にrate limitに達した場合でも、制限前にアップロードされた証憑ファイルは既に登録済みとなっているため、再アップロードは不要です。

■ 変更後のAPI仕様

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

事業所単位で1分間に実行可能なAPIの呼び出し回数が300回までとなります。rate limitの仕様変更のため、エンドポイント及びリクエストの仕様に変更はありません。

■ 概要

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

freee会計APIにおいて、取引（収入・支出）一覧の取得APIの registered_from パラメータを廃止します。つきましては現在同パラメータをご利用いただいているアプリ以外ではご利用できなくなります。

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

■ 変更内容

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

変更対象API：freee会計 取引（収入・支出）一覧の取得API

変更種別：Breaking Change

変更内容：

 – リクエストパラメータ: registered_from を廃止致します。

 – 廃止までの期間は現在同パラメータをお使いのアプリ以外のアプリからの利用を制限致します。

 – なお、こちらのパラメータを利用しない場合については通常通りご利用頂けます。

変更理由：アプリ側での取引データ管理で代替でき、基盤変更により同パラメータのサポートを廃止するため。

■ 変更スケジュール

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

アナウンス日：2025/05/02

変更リリース予定日：2025/06/01

旧バージョン廃止予定日：2025/08/01

■ 対応方法

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

リクエストパラメータ: 現在registered_fromをお使いの皆様は廃止予定の2025/08/01までにfreee会計 取引（収入・支出）の作成APIで作成された取引をアプリにて管理いただくことで代替いただきますようご対応お願いいたします。

■ 概要
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
新しく発行される事業所の事業所番号(APIのリクエストに利用いただくIDではございません)のフォーマットが変更されます。

■ 変更内容
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
変更対象API：/api/1/companies
変更種別：Non-Breaking Change
変更内容：新しく発行される事業所の事業所番号を現在の数字10桁から数字10桁+abcdefの16文字での10桁に変更致します。桁数の変更はなく、数字に加えて文字も含まれるようになります。
変更理由：セキュリティの向上のため

■ 変更スケジュール
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
アナウンス日：2025/04/25
変更リリース予定日：2025/07/01

■ 対応方法
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
事業所番号を利用している、もしくは保存している場合に数字のみで扱うようにしていないかを確認いただき、必要であれば文字列として扱えるように修正をお願い致します。

概要

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

freee会計APIにおいて、ファイルボックス(証憑ファイル)のアップロードAPIの rate limit 仕様を変更します。

freee会計APIをご利用の開発者の皆様におかれましては、変更点をご確認いただき、アプリの改修などの必要な対応をいただきますよう、よろしくお願い申し上げます。
本お知らせでのrate limitは事業所単位で1分間に実行可能なAPIの呼び出し回数です。制限を超えると、呼び出しは一時的に制限されます。

■ 変更内容

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

変更対象API：freee会計 ファイルボックス(証憑ファイル)のアップロード

変更種別：Breaking Change

変更内容：

• 上記エンドポイントの現在の rate limit は以下のように変わります。

【現在】600リクエスト/分

【変更後】300リクエスト/分

• rate limitを超過した場合のエラー内容は以下のように変わります。

【現在】

ステータスコード：400

エラーメッセージ：「ファイルのアップロードに失敗しました。1分間にアップロードできるファイル数の上限(600ファイル)を超えています。」

【変更後】

ステータスコード：400

エラーメッセージ：「ファイルのアップロードに失敗しました。1分間にアップロードできるファイル数の上限(300ファイル)を超えています。」

変更理由：[変更を行う背景・理由]

freee Public APIの可用性及びセキュリティ強化の一環のため

■ 変更スケジュール

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

アナウンス日：2025/03/21

変更リリース予定日：2025/05/19

■ 対応方法

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

上記エンドポイントを利用するアプリが以下の2つの仕様を満たすことを推奨します。

1. APIの呼び出し回数の制御

変更後のrate limit（300リクエスト/分）を超えないよう、呼び出し回数の調整をお願い致します。API処理時間は1秒程度のため、直列実行の場合は制限を超える可能性は低いですが、並列実行している場合はスレッド数の調整をご検討ください。※1

2. エラー発生に備えた制御

以下のいずれかの機能を実装することをご検討ください。

• rate limit制限超過時には、適切な間隔を設けた再試行処理
• rate limit制限によりアップロードに失敗した証憑ファイルをユーザーが手動で再アップロードできる機能。※2
  

※1. 事業所単位でファイルアップロードのrate limit制限を設けているため、直列実行の場合でも複数のユーザーが同時にアップロードをすると制限を超える可能性があります。

※2. 並列実行時にrate limitに達した場合でも、制限前にアップロードされた証憑ファイルは既に登録済みとなっているため、再アップロードは不要です。

■ 変更後のAPI仕様

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

事業所単位で1分間に実行可能なAPIの呼び出し回数が300回までとなります。rate limitの仕様変更のため、エンドポイント及びリクエストの仕様に変更はありません。