All posts by freee

【重要】[freee販売 前受金API] 公開のお知らせ

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

前受金の操作が可能なAPIを新規公開しました。

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

変更対象API:
前受金

  • 前受金一覧の取得(GET /advance_receipts)
  • 前受金の取得(GET /advance_receipts/{id})
  • 前受金を作成(POST /advance_receipts)
  • 前受金の更新(PATCH /advance_receipts/{id})
  • 前受金の取消(POST /advance_receipts/{id}/cancellation)
  • 前受金から売上の登録(POST /advance_receipts/{id}/reduction)
  • 前受金から定期売上の登録(POST /advance_receipts/{id}/periodic_reduction)

変更種別:[Non-Breaking Change]

変更内容:

  • 前受金の参照・登録・更新・取消が可能になりました。
  • 前受金から売上、定期売上の登録が可能になりました。

変更理由:API経由での前受金の利用を可能にし、他システムとの連携利便性を向上させるため。

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

アナウンス日:2026/08/14
変更リリース日:2026/07/29

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

特に必要な対応はありません。 新機能を利用される場合は、APIリファレンスをご確認ください。

【重要】[freee販売 売上予定API] 公開のお知らせ

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

売上予定の操作が可能なAPIを新規公開しました。

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

変更対象API:[API名とバージョン]
売上予定

  • 売上予定一覧の取得(GET /sales_schedules)
  • 売上予定の取得(GET /sales_schedules/{id})
  • 売上予定の更新(PATCH /sales_schedules/{id})
  • 売上予定の削除(DELETE /sales_schedules/{id})
  • 売上予定の売上計上(POST /sales_schedules/{id}/actualization)

変更種別:[Non-Breaking Change]

変更内容:

  • 売上予定の参照・更新・削除が可能になりました。
  • 売上予定から売上計上が可能になりました。

変更理由:API経由での売上予定の利用を可能にし、他システムとの連携利便性を向上させるため。

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

アナウンス日:2026/08/13
変更リリース日:2026/07/15

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

特に必要な対応はありません。 新機能を利用される場合は、APIリファレンスをご確認ください。

【重要】[freee販売 定期売上API] 公開のお知らせ

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

定期売上の操作が可能なAPIを新規公開しました。

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

変更対象API:[API名とバージョン]
定期売上

  • 定期売上一覧の取得(GET /periodic_sales)
  • 定期売上の取得(GET /periodic_sales/{id})
  • 売上計上状況の取得(GET /periodic_sales/{id}/sales_entries)
  • 定期売上の登録(POST /periodic_sales)
  • 定期売上の更新(PATCH/periodic_sales/{id})
  • 定期売上の取消(POST /periodic_sales/{id}/cancellation)

変更種別:[Non-Breaking Change]

変更内容:

  • 定期売上の参照・登録・更新・取消が可能になりました。

変更理由:API経由での定期売上の利用を可能にし、他システムとの連携利便性を向上させるため。

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

アナウンス日:2026/08/12
変更リリース日:2026/07/15

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

特に必要な対応はありません。 新機能を利用される場合は、APIリファレンスをご確認ください。

サービスメンテナンス(8/19)のお知らせ

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

  • 日時: 2026/08/19 (水) 1:00 – 5:00
  • 対象: freee 全サービス(電子公告サービス除く)

メンテナンス中は該当サービスをご利用いただけません。
ご迷惑をおかけしますが、ご理解の程よろしくお願い致します。

【重要】freee会計 口座振替APIに振替先複数指定フィールドを追加します

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

下記の通り、freee会計 口座振替API(/api/1/transfers)の仕様変更を予定しております。

freee会計Web画面と同様に、1件の口座振替に対して複数の振替先口座を指定できる新フィールドto_walletablesを追加いたします。

既存の単数指定フィールド(to_walletable_id / to_walletable_type / amount / description)は引き続きご利用いただけるため、本リリース時点で必須の対応はございません。ただし、既存の単数指定フィールドは将来的な廃止を予定しております。本お知らせを機に、to_walletablesへの移行のご検討をお願いいたします。

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

変更対象API:freee会計 口座振替API

  • GET /api/1/transfers: 口座振替一覧の取得
  • GET /api/1/transfers/{id}: 口座振替の取得
  • POST /api/1/transfers: 口座振替の作成
  • PUT /api/1/transfers/{id}: 口座振替の更新

変更種別:Non-Breaking Change

変更内容:

  • リクエスト・レスポンスに、複数の振替先口座を配列で扱う新フィールド(to_walletables)を追加いたします。
  • 既存の単数指定フィールド(to_walletable_id / to_walletable_type / amount / description)は、引き続きご利用いただけます。既存のご利用アプリケーションの挙動に変更はございません。
  • 既存の単数指定フィールドは、将来的な廃止を予定しております。具体的なスケジュールは、決定次第あらためてお知らせいたします。

変更理由:freee会計Web画面とPublic APIの機能差を解消し、Public API経由でも複数の振替先を含む口座振替を扱えるようにするため。

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

アナウンス日:2026/08/03
変更リリース予定日:2026/08/03

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

既存の単数指定フィールド(to_walletable_id / to_walletable_type / amount / description)をご利用のアプリケーションにつきましては、本リリース時点でのコード修正は不要です。既存のリクエスト・レスポンスの挙動に変更はございません。なお、単数指定フィールドの必須属性(required)はto_walletables追加に伴い外れますが、単数指定フィールドで従来どおりリクエストを送信いただく場合、これまでの必須項目は引き続きすべて指定いただく必要があります。

既存の単数指定フィールドは、将来的な廃止を予定しております(廃止スケジュールは別途お知らせいたします)。今後の新規実装および既存アプリケーションの更新時には、to_walletables配列形式でのご利用をご検討ください。

to_walletablesを利用したご実装の際は、単数指定フィールドとto_walletablesの同時指定はエラー(400 Bad Request)となりますので、いずれか一方の形式に統一してご指定ください。また、単一の振替先の場合も、to_walletablesに要素数1の配列としてご指定いただけます。

新フィールドの詳細な仕様につきましては、リリース後に更新されるfreee 会計 Public API リファレンスをご参照ください。

【重要】[freee工数管理] 工数タグ一覧の取得が可能になりました

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

freee工数管理APIにおいて、工数タグ一覧の取得ができるエンドポイントをリリースしました。

あわせて、プロジェクト詳細の取得APIとプロジェクトの登録APIでも工数タグを扱えるようになりました。

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

変更対象API:

  • 工数タグ一覧の取得API(GET /workload_tag_groups)
  • プロジェクト詳細の取得API(GET /projects/{id})
  • プロジェクトの登録API(POST /projects)

変更種別:[Non-Breaking Change]

変更内容:

  • 工数タグ一覧の取得API(GET /workload_tag_groups)を追加しました。工数タグを取得することができます。
  • プロジェクト詳細の取得API(GET /projects/{id})を変更しました。工数タグをレスポンスとして取得することができるようになります。
  • プロジェクトの登録API(POST /projects)を変更しました。工数タグを指定して登録することができるようになります。
  • ご利用方法の詳細はfreee工数管理APIのリファレンスページをご確認ください。
    工数管理APIリファレンス-freee Developers Community

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

変更リリース予定日:2026/07/29

【重要】freee販売 API仕様変更およびメンバーID追加のお知らせ

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

freeeにおける「メンバー管理方法」の変更に伴い、freee販売APIにおいてプロダクト共通の「メンバーID」の追加、および関連するAPI仕様の変更を行います

■ 変更・追加内容
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

対象API:freee販売 公開API(全12ドメイン、および新規マスタAPI)

変更種別:Breaking Change

内容:

  • 共通のメンバー情報を取得するためのAPI GET /api/public/master/members を新設します。
  • 既存の従業員情報を取得するAPI GET /api/public/master/employees は非推奨(廃止時期未定)となります。
  • freee販売の各ドメインAPIのリクエストに、charge_member_id および charge_member_ids[] 等を追加します。
  • freee販売の各ドメインAPIのレスポンスに、charge_member / registered_by_member / last_updated_by_member を追加します。
  • 既存の従業員IDに関連するリクエストおよびレスポンスフィールド(charge_employee_id 等)は非推奨(廃止時期未定)となります。

▼ 背景・理由

表示名・従業員番号・所属といったメンバーの「基本情報」をプロダクト共通で利用・管理できるようにするための変更です。

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

アナウンス日:2026/07/23

リリース予定日:2026年9月上旬~中旬(予定)

旧バージョン廃止予定日:未定(旧パラメータの完全廃止時期は、決定次第追ってお知らせいたします)

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

本リリース以降に新しく招待・追加されたメンバーには、従来の「旧従業員ID(employee_id)」が発番されなくなります。

そのため、新しく追加されたメンバーに対してAPI経由で「担当者の割り当て(POST/PATCH)」や「担当者での絞り込み(GET)」を行う場合、旧API仕様のままでは対象者が表示されないといった影響が発生します。

開発者の皆様におかれましては、リリース予定日以降、以下の通りシステム改修をお願いいたします。

  1. 新設される GET /api/public/master/members より「メンバーID(id)」を取得するように処理を変更してください。
  2. 各業務APIへのリクエスト時、従来の charge_employee_id に代わり、新設される charge_member_id (および一覧取得時は charge_member_ids[] )にメンバーIDを指定するように実装を変更してください。

※既存メンバーのデータのみを参照・更新し、新しく追加されるメンバーを考慮しない場合は、直ちに影響はありません。ただし、今後の新規メンバー追加に対応するため、お早めにメンバーIDへの移行をお願いいたします。

■ 変更・追加後のAPI仕様
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

各ドメインAPI(GET/POST/PATCH)において、以下の通りパラメータが追加・変更されます 。

  1. 新規追加されるAPI
    • マスタAPI(メンバー)
      • GET /api/public/master/members (新設)
  2. 仕様が変更されるドメインAPI(計12ドメイン)
    ※GET(一覧)のリクエストに charge_member_ids[] が追加されます。
    また、GET(一覧/詳細)のレスポンスに charge_member / registered_by_member / last_updated_by_member が追加されます。
    POST / PATCHのリクエストには charge_member_id が追加されます。
    • 案件API(Businesses)
      • 案件一覧 GET /api/public/businesses
      • 案件登録 POST /api/public/businesses
      • 案件詳細取得 GET /api/public/businesses/{id}
      • 案件更新 PATCH /api/public/businesses/{id}
    • 原価予算API(Cost Budgets)
      • 原価予算一覧 GET /api/public/cost_budgets
      • 原価予算登録 POST /api/public/cost_budgets
      • 原価予算詳細取得 GET /api/public/cost_budgets/{id}
      • 原価予算更新 PATCH /api/public/cost_budgets/{id}
    • 納品API(Deliveries)
      • 納品一覧 GET /api/public/deliveries
      • 納品登録 POST /api/public/deliveries
      • 納品詳細取得 GET /api/public/deliveries/{id}
      • 納品更新 PATCH /api/public/deliveries/{id}
    • 関連マスタAPI(Master)
      • 案件カスタム項目定義一覧 GET /api/public/master/custom_fields/business/definitions (input形式として「member」が設定されたカスタム項目が登録されている場合、レスポンスにその項目が含まれるようになります )
    • その他原価API(Other Costs)
      • その他原価一覧 GET /api/public/other_costs (レスポンスに registered_by_member 他を追加)
      • その他原価詳細取得 GET /api/public/other_costs/{id}
    • 定期売上API(Periodic Sales)
      • 定期売上一覧 GET /api/public/periodic_sales
      • 定期売上登録 POST /api/public/periodic_sales
      • 定期売上取得 GET /api/public/periodic_sales/{id}
      • 定期売上更新 PATCH /api/public/periodic_sales/{id}
      • 売上計上状況取得 GET /api/public/periodic_sales/{id}/sales_entries
    • 仕入API(Procurements)
      • 仕入一覧 GET /api/public/procurements
      • 仕入登録 POST /api/public/procurements
      • 仕入詳細取得 GET /api/public/procurements/{id}
      • 仕入更新 PATCH /api/public/procurements/{id}
    • 発注API(Purchase Orders)
      • 発注一覧 GET /api/public/purchase_orders
      • 発注登録 POST /api/public/purchase_orders
      • 発注詳細取得 GET /api/public/purchase_orders/{id}
      • 発注更新 PATCH /api/public/purchase_orders/{id}
    • 見積API(Quotations)
      • 見積一覧 GET /api/public/quotations
      • 見積登録 POST /api/public/quotations
      • 見積詳細取得 GET /api/public/quotations/{id}
      • 見積更新 PATCH /api/public/quotations/{id}
    • 売上API(Sales)
      • 売上一覧 GET /api/public/sales
      • 売上一覧 POST /api/public/sales
      • 売上詳細取得 GET /api/public/sales/{id}
      • 売上更新 PATCH /api/public/sales/{id}
    • 受注API(Sales Orders)
      • 受注一覧 GET /api/public/sales_orders
      • 受注一覧 POST /api/public/sales_orders
      • 受注詳細取得 GET /api/public/sales_orders/{id}
      • 受注更新 PATCH /api/public/sales_orders/{id}
    • 売上予定API(Sales Schedules)
      • 売上予定一覧 GET /api/public/sales_schedules
      • 売上予定詳細取得 GET /api/public/sales_schedules/{id}
      • 売上予定更新 PATCH /api/public/sales_schedules/{id}
    • 前受金API(Advance Receipts)★2026年7月末リリース予定
      • GET /api/public/advance_receipts
      • POST /api/public/advance_receipts
      • GET /api/public/advance_receipts/{id}
      • PATCH /api/public/advance_receipts/{id}
      • POST /api/public/advance_receipts/{id}/reduction
      • POST /api/public/advance_receipts/{id}/periodic_reduction
  3. 【参考】新規追加されるレスポンスの構造イメージ(charge_member 等)
    【参考】案件詳細取得API(GET /api/public/businesses/{id})などのレスポンス追加イメージ

    JSON
"charge_member": {
  "id": "DSDDDRWTNKL...",
  "display_name": "田中太郎"
}

【重要】[freee会計] API仕様の変更について(税区分)

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

令和8年の税制改正への対応として、freee会計APIの仕様変更を予定しています。
その一環として、税区分コード48件を新規に追加します。

新しい税区分は2026年7月より利用いただけます。

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

変更対象API:freee会計API

変更種別:Non-Breaking Change

変更内容:
令和8年の税制改正への対応に伴い、以下12種類の税区分(計48件の税区分コード)が追加されます。

新税区分の概要

令和8年の税制改正への対応に伴い、以下12種類の税区分がWeb上で追加されます。(それぞれ4通りの税率を持つため、48件の税区分コードが追加されます。)

課税売上に対応する免税事業者からの仕入
課対仕入(控70)、課対仕入(控30)
課対仕返(控70)、課対仕返(控30)

非課税売上に対応する免税事業者からの仕入
非対仕入(控70)、非対仕入(控30)
非対仕返(控70)、非対仕返(控30)

課税・非課税売上に共通対応する免税事業者からの仕入
共対仕入(控70)、共対仕入(控30)
共対仕返(控70)、共対仕返(控30)

控70、控30の税区分については、免税事業者からの仕入れや適格請求書の要件を満たさない仕訳で、仕訳の発生日が経過措置期間である場合に選択してください。

すでにある控80、控50の税区分を含めた経過措置期間は以下のようになります。

2023年10月~2026年9月:80%
2026年10月~2028年9月:70%
2028年10月~2030年9月:50%
2030年10月~2031年9月:30%
2031年10月~:0%(税区分としては対象外となります)

新税区分の税区分コード一覧

税区分コード
(code)
税区分名
(name)
日本語税区分名
(name_ja)
231purchase_with_tax_exempt_70課対仕入(控70)
232purchase_with_tax_8_exempt_70課対仕入(控70) 8%
233purchase_with_tax_reduced_8_exempt_70課対仕入(控70) 8%(軽)
234purchase_with_tax_10_exempt_70課対仕入(控70) 10%
235purchase_with_no_tax_exempt_70非対仕入(控70)
236purchase_with_no_tax_8_exempt_70非対仕入(控70) 8%
237purchase_with_no_tax_reduced_8_exempt_70非対仕入(控70) 8%(軽)
238purchase_with_no_tax_10_exempt_70非対仕入(控70) 10%
239purchase_with_common_exempt_70共対仕入(控70)
240purchase_with_common_8_exempt_70共対仕入(控70) 8%
241purchase_with_common_reduced_8_exempt_70共対仕入(控70) 8%(軽)
242purchase_with_common_10_exempt_70共対仕入(控70) 10%
243return_of_purchase_with_tax_exempt_70課対仕返(控70)
244return_of_purchase_with_tax_8_exempt_70課対仕返(控70) 8%
245return_of_purchase_with_tax_reduced_8_exempt_70課対仕返(控70) 8%(軽)
246return_of_purchase_with_tax_10_exempt_70課対仕返(控70) 10%
247return_of_purchase_with_no_tax_exempt_70非対仕返(控70)
248return_of_purchase_with_no_tax_8_exempt_70非対仕返(控70) 8%
249return_of_purchase_with_no_tax_reduced_8_exempt_70非対仕返(控70) 8%(軽)
250return_of_purchase_with_no_tax_10_exempt_70非対仕返(控70) 10%
251return_of_purchase_with_common_exempt_70共対仕返(控70)
252return_of_purchase_with_common_8_exempt_70共対仕返(控70) 8%
253return_of_purchase_with_common_reduced_8_exempt_70共対仕返(控70) 8%(軽)
254return_of_purchase_with_common_10_exempt_70共対仕返(控70) 10%
255purchase_with_tax_exempt_30課対仕入(控30)
256purchase_with_tax_8_exempt_30課対仕入(控30) 8%
257purchase_with_tax_reduced_8_exempt_30課対仕入(控30) 8%(軽)
258purchase_with_tax_10_exempt_30課対仕入(控30) 10%
259purchase_with_no_tax_exempt_30非対仕入(控30)
260purchase_with_no_tax_8_exempt_30非対仕入(控30) 8%
261purchase_with_no_tax_reduced_8_exempt_30非対仕入(控30) 8%(軽)
262purchase_with_no_tax_10_exempt_30非対仕入(控30) 10%
263purchase_with_common_exempt_30共対仕入(控30)
264purchase_with_common_8_exempt_30共対仕入(控30) 8%
265purchase_with_common_reduced_8_exempt_30共対仕入(控30) 8%(軽)
266purchase_with_common_10_exempt_30共対仕入(控30) 10%
267return_of_purchase_with_tax_exempt_30課対仕返(控30)
268return_of_purchase_with_tax_8_exempt_30課対仕返(控30) 8%
269return_of_purchase_with_tax_reduced_8_exempt_30課対仕返(控30) 8%(軽)
270return_of_purchase_with_tax_10_exempt_30課対仕返(控30) 10%
271return_of_purchase_with_no_tax_exempt_30非対仕返(控30)
272return_of_purchase_with_no_tax_8_exempt_30非対仕返(控30) 8%
273return_of_purchase_with_no_tax_reduced_8_exempt_30非対仕返(控30) 8%(軽)
274return_of_purchase_with_no_tax_10_exempt_30非対仕返(控30) 10%
275return_of_purchase_with_common_exempt_30共対仕返(控30)
276return_of_purchase_with_common_8_exempt_30共対仕返(控30) 8%
277return_of_purchase_with_common_reduced_8_exempt_30共対仕返(控30) 8%(軽)
278return_of_purchase_with_common_10_exempt_30共対仕返(控30) 10%

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

アナウンス日:2026/07/17
変更リリース日:2026/07/16

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

本変更に伴う既存機能への影響はありません。追加される新税区分を利用しない場合は、開発者様側での対応は不要です。

新税区分を利用される場合は、リリース後にAPIリファレンス(https://developer.freee.co.jp/reference/accounting/reference#/)をご確認ください。

【重要】[freee工数管理] 人件費予算の取得、編集が可能になりました

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

freee工数管理APIにおいて、人件費予算の取得と編集ができるエンドポイントをリリースしました。

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

変更対象API:

  • 人件費予算の取得API (GET /labor_budgets)
  • 人件費予算の編集API (PUT /labor_budgets/projects/{project_id}/people/{person_id}/year_month/{year_month})

変更種別:[Non-Breaking Change]

変更内容:

  • 人件費予算の取得API (GET /labor_budgets)を追加しました。人件費予算を取得することができます。
  • 人件費予算の編集API (PUT /labor_budgets/projects/{project_id}/people/{person_id}/year_month/{year_month})を追加しました。プロジェクトIDと従業員IDと年月を指定して人件費予算を編集することができます。
  • ご利用方法の詳細はfreee工数管理APIのリファレンスページをご確認ください。工数管理APIリファレンス-freee Developers Community

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

変更リリース予定日:2026/07/21

サービスメンテナンス(7/23)のお知らせ

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

・日時: 2026/07/23 (木) 1:00 – 5:00
・対象: freee 全サービス(電子公告サービス除く)

メンテナンス中は該当サービスをご利用いただけません。
ご迷惑をおかけしますが、ご理解の程よろしくお願い致します。

【重要】freee販売APIにおける一覧取得APIの更新日検索条件追加のお知らせ

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

各種データの検索クエリについて、更新日による検索が可能になりました。

更新日から更新された差分データを取得したい場合に有効です。

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

変更対象API:

  • GET /businesses
  • GET /sales_orders
  • GET /deliveries
  • GET /sales
  • GET /cost_budgets
  • GET /other_costs

変更種別:[Non-Breaking Change]

変更内容:
それぞれのAPIのクエリパラメータとして、start_last_updated_date および、end_last_updated_date に対応しました。

売上一覧については他のデータの検索に合わせ、案件による検索 (business_ids) に対応しました。

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

アナウンス日:2026/07/10
変更リリース日:2026/06/24

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

新規パラメータ追加のため、既存のAPIの利用に影響はありません

新たなパラメーターをアプリに組み込む場合は、APIリファレンスをご参照ください。

【重要】[freee販売 仕入API] 公開のお知らせ

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

仕入の操作が可能なAPIを新規公開しました。

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

変更対象API:
仕入

  • 仕入一覧の取得(GET /procurements)
  • 仕入の取得(GET /procurements/{id})
  • 仕入を作成(POST /procurements)
  • 仕入の更新(PATCH /procurements/{id})
  • 仕入の取消(POST /procurements/{id}/cancellation)

変更種別:Non-Breaking Change

変更内容:

  • 仕入の参照・登録・更新・取消が可能になりました。

変更理由:

API経由での仕入の利用を可能にし、他システムとの連携利便性を向上させるため。

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

アナウンス日:2026/07/09
変更リリース日:2026/06/24
旧バージョン廃止予定日:なし

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

特に必要な対応はありません。 新機能を利用される場合は、APIリファレンスをご確認ください。

【重要】[freee販売 発注API] 公開のお知らせ

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

発注の操作が可能なAPIを新規公開しました。

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

変更対象API:

発注

  • 発注一覧の取得(GET /purchase_orders)
  • 発注の取得(GET /purchase_orders/{id})
  • 発注を作成(POST /purchase_orders)
  • 発注の更新(PATCH /purchase_orders/{id})
  • 発注の取消(POST /purchase_orders/{id}/cancellation)

変更種別:Non-Breaking Change

変更内容:

  • 発注の参照・登録・更新・取消が可能になりました。

変更理由:API経由での発注の利用を可能にし、他システムとの連携利便性を向上させるため。

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

アナウンス日:2026/07/07
変更リリース日:2026/06/24
旧バージョン廃止予定日:なし

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

特に必要な対応はありません。 新機能を利用される場合は、APIリファレンスをご確認ください。

2026年6月の更新情報

(6/3)[会計]freee会計 APIにおいて、振替伝票APIのコード指定対応(更新)およびレスポンスの仕様変更

変更対象API:

  • GET /api/1/manual_journals – 振替伝票一覧の取得
  • POST /api/1/manual_journals – 振替伝票の作成
  • GET /api/1/manual_journals/{id} – 振替伝票の取得
  • PUT /api/1/manual_journals/{id} – 振替伝票の更新

変更種別: 破壊的変更なし

変更内容:
振替伝票の各種レスポンスにおいて、txn_number が必須から任意(optional)に変更されました。

振替伝票の更新(PUT)リクエストにおいて、各種コード(勘定科目、品目、部門、セグメントタグ)による指定が可能となり、これに伴い account_item_id が必須項目から任意に変更されました。


(6/11)[工数管理]共通 error スキーマの type enum に bad_request が追加

変更対象API:
error レスポンスを返す全エンドポイント共通

変更種別: 破壊的変更なし

変更内容:
共通 error スキーマの type enum に bad_request が追加されました。


(6/8)[IT管理]IT管理 APIにおいて、アプリケーションアカウント管理関連のエンドポイントのAPIタグが変更されました。

変更対象API:

  • GET /hub/it_management/application_accounts
  • POST /hub/it_management/application_accounts
  • DELETE /hub/it_management/application_accounts/{id}
  • GET /hub/it_management/application_accounts/{id}
  • PATCH /hub/it_management/application_accounts/{id}

変更種別: 破壊的変更なし

変更内容:
アプリケーションアカウント(application_accounts)に関する各種エンドポイントにおいて、APIタグが it_management_application_account から it_management_application_accounts(複数形)へ変更・統一されました。


(6/9)[IT管理]IT管理 APIにおいて、一覧取得系APIに検索用のクエリパラメータが追加されました。

変更対象API:

  • GET /hub/it_management/application_accounts – アプリケーションアカウント一覧の取得
  • GET /hub/it_management/assets – 資産一覧の取得
  • GET /hub/it_management/members – メンバー一覧の取得

変更種別: 破壊的変更なし

変更内容:
「アプリケーションアカウント一覧の取得」および「資産一覧の取得」APIにおいて、特定のメンバーで絞り込みを行うための任意のクエリパラメータ member_id が追加されました。

「メンバー一覧の取得」APIにおいて、以下の任意の絞り込み用クエリパラメータが追加されました。

  • employment_type_id (雇用形態IDでの絞り込み)
  • entered_since / entered_until (入社日の期間指定)
  • resigned_since / resigned_until (退職日の期間指定)

(6/18)[請求書]freee請求書 APIにおいて、発注書関連APIおよび各種帳票のキャンセル機能が追加

変更対象API:

  • GET, POST /purchase_orders – 発注書の取得・作成
  • GET /purchase_orders/templates – 発注書テンプレート一覧の取得
  • GET, PUT /purchase_orders/{id} – 発注書の詳細取得・更新
  • PUT /purchase_orders/{id}/cancel, uncancel – 発注書のキャンセル・キャンセル取消
  • PUT /delivery_slips/{id}/cancel, uncancel – 納品書のキャンセル・キャンセル取消
  • PUT /invoices/{id}/cancel, uncancel – 請求書のキャンセル・キャンセル取消
  • PUT /quotations/{id}/cancel, uncancel – 見積書のキャンセル・キャンセル取消
  • PUT /receipts/{id}/cancel, uncancel – 領収書のキャンセル・キャンセル取消

変更種別: 破壊的変更なし

変更内容:
発注書(purchase_orders)の作成、取得、更新などを行う一連のエンドポイントが新設されました。

各種帳票(納品書、請求書、見積書、領収書、発注書)に対して、ステータスをキャンセルにする(cancel)、およびキャンセル状態を取り消す(uncancel)ためのアクション系エンドポイントが追加されました。


(6/23)[人事労務]各種申請APIにおける代理申請者IDの追加および手当APIのタグ更新

変更対象API:

  • GET /api/v1/allowances – 手当一覧の取得
  • POST /api/v1/allowances – 手当の作成
  • GET /api/v1/allowances/{id} – 手当の取得
  • GET /api/v1/approval_requests/monthly_attendances – 月次勤怠申請一覧の取得
  • POST /api/v1/approval_requests/monthly_attendances – 月次勤怠申請の作成
  • GET /api/v1/approval_requests/monthly_attendances/{id} – 月次勤怠申請の取得
  • PUT /api/v1/approval_requests/monthly_attendances/{id} – 月次勤怠申請の更新
  • POST /api/v1/approval_requests/monthly_attendances/{id}/actions – 月次勤怠申請に対するアクションの実行
  • GET /api/v1/approval_requests/overtime_works – 残業申請一覧の取得
  • POST /api/v1/approval_requests/overtime_works – 残業申請の作成
  • GET /api/v1/approval_requests/overtime_works/{id} – 残業申請の取得
  • PUT /api/v1/approval_requests/overtime_works/{id} – 残業申請の更新
  • POST /api/v1/approval_requests/overtime_works/{id}/actions – 残業申請に対するアクションの実行
  • GET /api/v1/approval_requests/paid_holidays – 有休申請一覧の取得
  • POST /api/v1/approval_requests/paid_holidays – 有休申請の作成
  • GET /api/v1/approval_requests/paid_holidays/{id} – 有休申請の取得
  • PUT /api/v1/approval_requests/paid_holidays/{id} – 有休申請の更新
  • POST /api/v1/approval_requests/paid_holidays/{id}/actions – 有休申請に対するアクションの実行
  • GET /api/v1/approval_requests/special_holidays – 特別休暇申請一覧の取得
  • POST /api/v1/approval_requests/special_holidays – 特別休暇申請の作成
  • GET /api/v1/approval_requests/special_holidays/{id} – 特別休暇申請の取得
  • PUT /api/v1/approval_requests/special_holidays/{id} – 特別休暇申請の更新
  • POST /api/v1/approval_requests/special_holidays/{id}/actions – 特別休暇申請に対するアクションの実行
  • GET /api/v1/approval_requests/work_times – 勤務時間申請一覧の取得
  • POST /api/v1/approval_requests/work_times – 勤務時間申請の作成
  • GET /api/v1/approval_requests/work_times/{id} – 勤務時間申請の取得
  • PUT /api/v1/approval_requests/work_times/{id} – 勤務時間申請の更新
  • POST /api/v1/approval_requests/work_times/{id}/actions – 勤務時間申請に対するアクションの実行

変更種別: 破壊的変更なし

変更内容:
各種申請(月次勤怠、残業、有休、特別休暇、勤務時間)およびそのアクションのレスポンスに、任意プロパティとして proxy_applicant_id(代理申請者ID)が追加されました。

手当API(allowances)のOpenAPIタグにおいて、「手当」が削除され「その他手当」が追加されました。


(6/26)[販売]仕入・発注関連エンドポイントの追加およびレスポンス構造の仕様変更

変更対象API:

  • GET /businesses – 案件一覧の取得
  • GET /businesses/{id} – 案件の取得
  • GET /cost_budgets – 原価予算一覧の取得
  • GET /cost_budgets/{id} – 原価予算の取得
  • GET /deliveries – 納品一覧の取得
  • GET /deliveries/{id} – 納品の取得
  • GET /master/items – 品目一覧の取得
  • GET /other_costs – その他原価一覧の取得
  • GET /other_costs/{id} – その他原価の取得
  • GET /procurements – 仕入一覧の取得
  • POST /procurements – 仕入の登録
  • GET /procurements/{id} – 仕入詳細の取得
  • PATCH /procurements/{id} – 仕入の更新
  • POST /procurements/{id}/cancellation – 仕入の取消
  • GET /purchase_orders – 発注一覧の取得
  • POST /purchase_orders – 発注の登録
  • GET /purchase_orders/{id} – 発注詳細の取得
  • PATCH /purchase_orders/{id} – 発注の更新
  • POST /purchase_orders/{id}/cancellation – 発注の取消
  • GET /quotations – 見積一覧の取得
  • GET /quotations/{id} – 見積の取得
  • GET /sales – 売上一覧の取得
  • GET /sales/{id} – 売上の取得
  • GET /sales_orders – 受注一覧の取得
  • GET /sales_orders/{id} – 受注の取得

変更種別: 破壊的変更あり

変更内容:
■ 一覧・取得APIの OpenAPI Schema の定義変更
案件、納品、見積、売上、受注などの各レスポンスにおいて、取引先や担当者情報の構造が変更されました。
該当の破壊的変更についての詳細は以下をご確認ください。
https://developer.freee.co.jp/sm/sm-improvement/8071

■ その他の変更・新機能

  • 新機能(仕入・発注APIの追加)
    仕入(procurements)および発注(purchase_orders)を管理する各種エンドポイント(一覧取得、登録、詳細取得、更新、取消)が新設されました。
  • 一覧取得APIの検索パラメータ追加
    案件、原価予算、納品、その他原価、受注などの各一覧取得APIに、最終更新日で絞り込みを行うクエリパラメータ start_last_updated_date および end_last_updated_date が追加されました。
  • レスポンス項目の仕様変更(必須化・Nullable化など)
    各種ステータスや金額情報(amount_set, billing_status, total_amount など)が必須項目に変更されました。

    源泉徴収税額(amount_of_withholding_tax)や一部の関連ID・メモなどが nullable および任意プロパティに変更されました。

    品目マスタ(/master/items)APIにおいて、code および uom_name が nullable に変更されました。

(6/26)[人事労務]手当ルール・給与明細備考の管理エンドポイント追加

変更対象API:

  • GET /api/v1/employees/{employee_id}/allowance_rules – 手当ルール一覧の取得
  • PUT /api/v1/employees/{employee_id}/allowance_rules – 手当ルールの更新
  • DELETE /api/v1/employees/{employee_id}/allowance_rules/{id} – 手当ルールの削除
  • PUT /api/v1/salaries/employee_payroll_statements/{employee_id}/remark – 給与明細の備考の更新

変更種別: 破壊的変更なし

変更内容:
従業員ごとの「手当ルール」を取得、更新、削除するためのエンドポイントが新設されました。

従業員の給与明細の「備考」欄を更新できるエンドポイントが新設されました。


(6/26)[会計]事業所APIへの期末日情報追加および支払依頼の検索条件拡張

変更対象API:

  • GET /api/1/companies/{id} – 事業所の詳細取得
  • GET /api/1/payment_requests – 支払依頼一覧の取得

変更種別: 破壊的変更なし

変更内容:
事業所詳細取得APIのレスポンス内 fiscal_years(事業年度)リストに、以下の必須プロパティが追加されました。

  • is_closed:締め済み判定
  • month_end_date:期末日
  • temp_month_end_date:仮期末日
    支払依頼一覧取得APIの検索パラメータに、approval_flow_route_id(承認経路ID)、observing(閲覧可能フラグ)、partner_name(取引先名)が追加され、より詳細な検索が可能になりました。

    内部コンポーネントスキーマから purchaseRequestActionCreateParams が削除されました。

(6/29)[人事労務]freee人事労務 APIにおいて、従業員の手当ルールおよび給与明細の備考関連エンドポイントが追加されました。

変更対象API:

  • GET, PUT, DELETE /api/v1/employees/{employee_id}/allowance_rules – 従業員手当ルール
  • PUT /api/v1/salaries/employee_payroll_statements/{employee_id}/remark – 給与明細の備考

変更種別: 破壊的変更なし

変更内容:
特定の従業員(employee_id)に対して、個別の手当ルールを取得・作成・削除するための各種エンドポイントが新設されました。

従業員の給与明細に対して、備考(remark)の文言を更新するためのエンドポイントが新設されました。


(6/29)[会計]freee会計 APIにおいて、事業所詳細への決算期情報の追加および支払依頼APIの検索パラメータ拡張が行われました。

変更対象API:

  • GET /api/1/companies/{id} – 事業所の詳細取得
  • GET /api/1/payment_requests – 支払依頼一覧の取得

変更種別: 破壊的変更なし

変更内容:
事業所の詳細取得レスポンスに含まれる決算期情報(fiscal_years)に、決算完了フラグ(is_closed)、期末日(month_end_date)、仮期末日(temp_month_end_date)の各プロパティが必須項目として追加されました。

支払依頼の一覧取得APIにおいて、より柔軟な絞り込みができるよう、クエリパラメータに承認経路ID(approval_flow_route_id)、閲覧のみフラグ(observing)、取引先名(partner_name)が追加されました。

不要となったコンポーネントスキーマ purchaseRequestActionCreateParams が削除されました。

【重要】[freee人事労務API] 従業員手当と給与明細備考の更新が可能になりました

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

freee人事労務APIにおいて、以下に関連する操作が行えるエンドポイントをリリースしました。

  • その他手当の従業員への付与
  • 給与明細備考の更新

■ 対象エンドポイント
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  • 従業員手当の一覧取得API(GET /api/v1/employees/:employee_id/allowance_rules)
  • 従業員手当の付与・金額更新API(PUT /api/v1/employees/:employee_id/allowance_rules)
  • 従業員手当の削除API(DELETE /api/v1/employees/{employee_id}/allowance_rules/{id})
  • 給与明細備考の更新API(PUT /api/v1/salaries/employee_payroll_statements/:employee_id/remark)

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

  • 従業員手当の一覧取得APIは、従業員に付与されているその他手当を一覧で取得することができます。
  • 従業員手当の付与・金額更新APIは、従業員にその他手当を新規付与・金額を更新することができます。
  • 従業員手当の削除APIは、従業員に付与されているその他手当を削除することができます。
  • 給与明細備考の更新APIは、給与明細の備考欄を更新することができます。
  • ご利用方法の詳細は、freee人事労務APIリファレンスページをご確認ください。
    人事労務APIリファレンス – freee Developers Community

【重要】freeeアプリストア – 未利用の開発用テスト事業所および登録アプリの定期削除に関するお知らせ

日頃よりfreee APIおよび開発者向けサービスをご利用いただき、誠にありがとうございます。

この度、サービスの安定的な運用およびシステムリソースの適切な管理を目的として、一定期間ご利用がない「開発用テスト事業所(デモ事業所)」および「該当事業所に登録されているアプリ」を対象とした定期削除を実施いたします。

本件は、freeeアプリストア(開発者ページ)をご利用のユーザーさまおよびfreee Developers Community会員の皆さまにご確認いただきますようお願い申し上げます。

■ 削除対象となる条件
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

以下の2つの条件を両方満たす開発用テスト事業所、およびそこに登録されているすべてのアプリが定期削除の対象となります。

  • 事業所の作成から3ヶ月(90日)以上が経過している
  • 過去3ヶ月(90日)間、該当事業所に紐づくアプリでのAPI実行がない

直近の削除実施予定について
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

現在上記の対象条件を満たしている事業所およびアプリにつきましては、以下の日程にて一斉削除を実施いたします。


実施予定日: 2026年9月頃予定


※本実施日以降も、条件を満たした事業所およびアプリについては継続的に定期削除の対象となります。

開発環境の継続利用をご希望の場合
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

開発やテスト等で引き続き対象の事業所・アプリをご利用になる場合は、上記の実施予定時期までにAPI利用実績が確認できた事業所およびアプリは、自動的に削除対象から除外されます。

【注意事項】
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

一度削除された事業所、アプリ、および事業所内のデータは理由の如何を問わず一切復元することができません。

万が一削除されてしまった場合でも、開発用の事業所は無料で新規作成いただけます。

必要に応じて、改めて新しい事業所を作成してください。

本件に関するお知らせは以上となります。

より良いサービス提供のためのシステム運用の改善に、何卒ご理解とご協力を賜りますようお願い申し上げます。

【freee請求書】freee Public API:帳票一覧取得機能の仕様変更(1万件制限)に伴うシステム改修のお願い

■ 仕様変更の概要
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

平素よりfreee Public APIをご利用いただき、誠にありがとうございます。

この度、システムの安定化および今後の更なる機能拡張(AI活用等)を見据えたデータベース負荷軽減を目的として、APIの一覧取得機能に新たな制限を設ける仕様変更を実施いたします。

本変更の適用後、対象のAPIにおいてクエリパラメータの「limit」 と「offset」の合計値が『10,000』件を超えた場合、データ取得エラー(400)が返却されるようになります。該当するリクエストを行っている場合は、エラーを回避するためのシステム改修をお願いいたします。

■ 対象のエンドポイント
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

freee Public APIにおける以下の各種「一覧の取得」エンドポイントが対象です。

変更対象API:

  • /delivery_slips (納品書)
  • /invoices (請求書)
  • /purchase_orders (発注書)
  • /quotations (見積書)
  • /receipts (領収書)

変更種別:Breaking Change

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

アナウンス日:2026/6/25
変更リリース予定日:2026年9月21日 (予定)

■ ご対応いただきたいこと
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

自社システムにおける対象エンドポイントのリクエスト状況をご確認いただき、以下の条件に合わせてご対応をお願いいたします。

<パターンA>リクエスト時の「limit」と「offset」の合計値が常に10,000未満に収まる場合

必要なご対応:なし
仕様変更による影響はございません。

<パターンB>リクエスト時の「limit」と「offset」の合計値が10,000以上となる可能性がある場合

必要なご対応:適用時期までにシステム側の「リクエスト処理の改修」が必要です。改修を行わない場合、仕様変更の適用後にエラーが発生し、データが取得できなくなります。

▼改修内容
全期間のデータを一括で取得する(大きな「offset」値を指定する)処理から、「月ごとなど特定の期間で区切り、その範囲内でページネーションを回す」処理へのご変更をお願いいたします。

▼推奨する実装方針
将来的なデータ量の増加により、指定した期間内で再び『10,000』件を超過(エラーが発生)するリスクを防ぐため、「1ヶ月単位」または「1日単位」など、十分に短い期間で区切る設計を推奨いたします。

▼実装例(請求書一覧の場合)
「issue_date_start」 と「issue_date_end」 等の日付パラメータを利用し、1ヶ月単位でリクエストを分割します。分割したそれぞれの期間内において、「limit」 + 「offset」 の値が『10,000』件の制限内に収まるようにご調整ください。

【重要】freee販売APIにおける一覧・取得APIの OpenAPI Schema の定義変更に関するお知らせ

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

freee販売APIにおける一覧・取得API の OpenAPI Schema において、一部のフィールド定義と実際のAPIの挙動に不整合があったため、実態に合わせた定義の修正を行います。

API自体の挙動に変更はありませんが、OpenAPI Schema をもとにクライアントコードや型定義を自動生成しているアプリケーションにおかれましては、影響が生じる可能性がございます。

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

変更対象API:

  • GET /businesses
  • GET /businesses/{id}
  • GET /master/deal_line_types
  • GET /master/employees
  • GET /master/items
  • GET /master/custom_fields/business/definitions
  • GET /quotations
  • GET /quotations/{id}
  • GET /sales_orders
  • GET /sales_orders/{id}
  • GET /deliveries
  • GET /deliveries/{id}
  • GET /sales
  • GET /sales/{id}
  • GET /other_costs
  • GET /other_costs/{id}
  • GET /cost_budgets
  • GET /cost_budgets/{id}

変更種別:Breaking Change

変更内容:
freee販売のPublic API における「一覧・取得」に関わる OpenAPI Schema 上の定義を、実際のAPIレスポンスに合わせて以下の通り修正します。

修正前: required: true かつ nullable: false (または nullable: true)
修正後: required: false かつ nullable: true に統一

※実際のAPIエンドポイントの振る舞い(レスポンスペイロード)に変更はありません。OpenAPI Schema(ドキュメント)上の定義のみの変更となります。

変更理由:
APIの実際のレスポンスにおいて null が返るケースが存在する一方、OpenAPI Schema 上では該当フィールドが required かつ nullable: false 等と定義されている不整合が生じていました。これらを実態および 他の製品のPublic APIに沿った仕様に統一するためです。

例として、「見積」データにおける「案件」のレスポンス business は、 required: true, nullable: false となっておりますが、実際には案件が設定されていない場合があるため、実情にあった定義に変更されます。

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

アナウンス日:2026/6/19
変更リリース予定日:2026/6/24

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

OpenAPI Schema を利用して、型定義やAPIクライアントを自動生成しているアプリケーションにおいては、対応が必要となる場合があります。

本変更のリリース後に Schema からコードを再生成した場合、該当フィールドの型が field: string 等から field?: string | null へと変更されます。
これによりコンパイルエラーや型不整合が発生する可能性があるため、クライアント側で null や undefined を適切に許容・処理するよう、実装のご確認および修正をお願いいたします。

なお、Schemaからの自動生成を利用せず、独自にAPIリクエストを実装されている場合は、API自体の振る舞いに変更はないため特別な対応は不要です。

【重要】[発注書API] 令和8年税制改正(インボイス制度経過措置)対応に伴う仕様変更のお知らせ

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

2026年(令和8年)税制改正に伴うインボイス制度の経過措置に対応するため、6/9にリリースされた発注書APIにおける税区分の判別ロジックおよびバリデーションも更新されます。

■ 変更・追加内容
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

対象API:

  • GET /api/public/purchase_orders
  • GET /api/public/purchase_orders/:id
  • POST /api/public/purchase_orders
  • PUT /api/public/purchase_orders/:id
  • GET /api/public/purchase_orders/templates

変更種別:Breaking Change

内容:
税制改正で新設・変更される仕入税額控除可能割合および適用期間に対応した税区分が、発注書の保存時に正しく適用されるようロジックを更新します。

控除率期間既存との関係
80%〜2026-09-30据え置き
70%2026-10-01 〜 2028-09-30新規追加
50%2028-10-01 〜 2030-09-30期間変更
30%2030-10-01 〜 2031-09-30新規追加

これに伴い、仕入発生日(発行日)に応じて、適用不可能な税区分が選択できないように変更されます。

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

アナウンス日:2026/06/19

リリース予定日:2026年7月頃

旧バージョン廃止予定日:なし

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

本リリース以降に新しい控除税率が適用される日付で発注書を登録・更新する際、旧仕様(従来の控除率)のままでは適切な取引登録が行えなくなる、またはバリデーションエラーとなる可能性があります。

連携元システムにおいて新しい控除税率に対応できないようになっている場合は、リリース後〜新税制施行までの期間に、適切な控除税率・税区分が適切な期間においてパラメータとして設定されるようシステムの変更をお願いいたします。

■ 変更・追加後のAPI仕様
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

上記ロジック以外の変更はございせん。

リクエストパラメータ等の詳細は、freee請求書のAPIリファレンスをご確認ください。

サービスメンテナンス(6/23)のお知らせ

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

・日時: 2026/06/23 (火) 1:00 – 5:00
・対象: freee 全サービス(電子公告サービス除く)

メンテナンス中は該当サービスをご利用いただけません。
ご迷惑をおかけしますが、ご理解の程よろしくお願い致します。