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

・日時: 2025/2/13 (木) 1:00 – 5:00
・対象:freeeの全サービス (電子公告サービス除く)

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

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

freee工数管理のプロジェクトの招待リンクの機能をリリースしました。
これにともない、プロジェクトのAPIで項目が増えました。

機能の詳細についてはヘルプページをご覧ください。

▼ 【ヘルプセンター】プロジェクトの招待リンクを有効にする
https://support.freee.co.jp/hc/ja/articles/42195635572121

任意項目のため、これまでのリクエストが使えなくなることはございません。

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

対象エンドポイント

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

変更内容

• プロジェクトの登録APIのRequest bodyに任意項目としてassignment_url_enabled（プロジェクトの招待リンク機能設定）を追加
• プロジェクト一覧取得APIとプロジェクト詳細の取得APIとプロジェクトの登録APIのResponsesに項目としてassignment_url_enabled（プロジェクトの招待リンク機能設定）を追加

リリース時期

• 2025年1月23日（木）

freee請求書APIにおいて、取引先に設定されている帳票テンプレートがfreee請求書のデフォルトより優先して使用されるようになりました。

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

対象エンドポイント

• 納品書の作成API（POST /delivery_slips）
• 納品書の更新API（PUT /delivery_slips）
• 請求書の作成API（POST /invoices）
• 請求書の更新API（PUT /invoices）
• 見積書の作成API（POST /quotations）
• 見積書の更新API（PUT /quotations）

変更内容

• freee請求書APIにおいて、取引先に設定されている帳票テンプレートが優先して使用されるようになりました。
• 取引先に帳票テンプレートが設定されている場合、freee請求書のデフォルトの帳票テンプレートより優先して使用されます。
• APIでtemplate_idを指定した場合、取引先の帳票テンプレートより優先して使用されます。
• 取引先の帳票テンプレート設定については取引先を登録する – freee ヘルプセンターをご確認ください。

リリース時期

• 2025年01月28日（火）

以下の2024年10月30日に発信したお知らせの内容に訂正がありました。

【freee人事労務】半日単位と時間単位の年次有給休暇を同日に日次勤怠として登録することができるようになります。（勤怠API・勤怠情報月次サマリAPI・有給申請API）

詳しくは2024年10月30日発信のお知らせ内容の訂正をご覧ください。

2024年10月30日発信のお知らせ内容の訂正

訂正があったエンドポイントは以下となります

• 有給申請一覧の取得API（GET /api/v1/approval_requests/paid_holidays）
  • Response
    • paid_holidays->values->type
      • 有給休暇の種別（full:全休、half:半休、morning_off:午前休、 afternoon_off:午後休、hour:時間休）
• 有給申請の取得API（GET /api/v1/approval_requests/paid_holidays/{id}）
  • Response
    • paid_holiday->values->type
      • 有給休暇の種別（full:全休、half:半休、morning_off:午前休、 afternoon_off:午後休、hour:時間休）
• 有給申請の作成API（POST /api/v1/approval_requests/paid_holidays）
  • Request
    • values->type
      • 休暇種別（full:全休、half:半休、morning_off:午前休、 afternoon_off:午後休、hour:時間休）
• 有給申請の更新API（PUT /api/v1/approval_requests/paid_holidays/{id}）
  • Request
    • values->type
      • 休暇種別（full:全休、half:半休、morning_off:午前休、 afternoon_off:午後休、hour:時間休）

今回のリリースの詳細について、訂正内容を反映したものを再掲いたします。

概要

freee勤怠APIと勤怠情報月次サマリAPI、freee有給申請APIにおいて、従業員が半日単位と時間単位の年次有給休暇を同日に日次勤怠として登録・取得することができるようになります。

freee勤怠APIと勤怠情報月次サマリAPI、freee有給申請APIをご利用の開発者の皆様におかれましては、変更点をご確認いただき、アプリの改修などの必要な対応をいただきますよう、よろしくお願い申し上げます。

対象エンドポイント

• 勤怠の取得API（GET /api/v1/employees/{employee_id}/work_records/{date}）
• 勤怠の更新API（PUT /api/v1/employees/{employee_id}/work_records/{date}）
• 勤怠情報月次サマリの取得API（GET /api/v1/employees/{employee_id}/work_record_summaries/{year}/{month}）
• 有給申請一覧の取得API（GET /api/v1/approval_requests/paid_holidays）
• 有給申請の取得API（GET /api/v1/approval_requests/paid_holidays/{id}）
• 有給申請の作成API（POST /api/v1/approval_requests/paid_holidays）
• 有給申請の更新API（PUT /api/v1/approval_requests/paid_holidays/{id}）
• 有給申請の承認操作API（POST /api/v1/approval_requests/paid_holidays/{id}/actions）

新規機能の内容

• 勤怠の取得APIと勤怠情報月次サマリの取得APIは、従業員が半日単位と時間単位の年次有給休暇が同日に登録されている日次勤怠を取得することができるようになります。
• 勤怠の更新APIは、従業員が半日単位と時間単位の年次有給休暇を同日に日次勤怠として登録することができます。※１
• 有給申請一覧の取得APIと作成API、更新API、承認操作APIは、従業員が半日単位と時間単位の年次有給休暇が同日に登録されている日次勤怠実績の申請を取得することができます。
• 有給申請の作成APIと更新APIは、従業員が半日単位と時間単位の年次有給休暇が同日に登録されている日次勤怠実績を登録する申請を作成、更新することができます。※１

※１：半日単位と時間単位の年次有給休暇を同日に日次勤怠に登録するためには、勤怠基本設定で「年次有給休暇のうち半日単位と時間単位の同日取得を許可する」という設定が有効化されている必要があります。（勤怠基本設定で「年次有給休暇のうち半日単位と時間単位の同日取得を許可する」が設定可能になる機能のリリースに関するスケジュールは今後の対応予定のお知らせをご確認ください。）

年次有給休暇の同日取得に対応しない場合の影響

半日単位と時間単位の年次有給休暇が同日に登録されている勤怠や有給申請が存在しない場合には、勤怠APIや勤怠情報月次サマリAPI、有給申請APIには直ちに影響はありません。ただし、従来の有給休暇に関するパラメータは1年後を目処に削除予定のため非推奨となっております。

• 勤怠の更新APIにおいて、従来のパラメータを用いて半日単位と時間単位の年次有給休暇が同日に登録されている勤怠を更新する場合には、一律でエラーが発生するようになります。
• 有給申請の取得APIで半日単位と時間単位の年次有給休暇が同日に日次勤怠として登録する申請を取得する場合には、申請時に最初に設定した休暇情報が返されます。
• 有給申請の更新APIにおいて、従来のパラメータを用いて半日単位と時間単位の年次有給休暇が同日に勤怠を登録する申請を更新する場合には、一律でエラーが発生するようになります。
• ご利用方法の詳細はfreee人事労務APIのリファレンスページをご確認ください。人事労務APIリファレンス – freee Developers Community

勤怠の取得APIの変更内容

要素	型定義	変更前	変更後
half_paid_holiday_mins	number(integer)	有給休暇の半休を利用した時間（分単位）	[deprecated] 有給休暇の半休を利用した時間（分単位）※ 削除予定のため paid_holidays->minsを参照してください
hourly_paid_holiday_mins	number(integer)	有給休暇の時間休を利用した時間（分単位）	[deprecated] 有給休暇の時間休を利用した時間（分単位）※ 削除予定のため paid_holidays->minsを参照してください
paid_holiday	number(float)	この日に対する有給取得日数。半休の場合は0.5が入ります。時間休の場合はhourly_paid_holiday_minsを所定労働時間で割った値が入るため、実際の時間を確認するにはhourly_paid_holiday_minsを参照してください。	[deprecated] この日に対する有給取得日数。半休の場合は0.5が入ります。時間休の場合はhourly_paid_holiday_minsを所定労働時間で割った値が入るため、実際の時間を確認するにはhourly_paid_holiday_minsを参照してください。※ 削除予定のため paid_holidays の days または mins を参照してください
paid_holidays->type	string	–	有給休暇の種別が返されます。（全休：full, 半休：half, 午前休：morning_off, 午後休：afternoon_off, 時間休：hourly）
paid_holidays->mins	number(integer)	–	休暇時間（分単位）
paid_holidays->days	number(float)	–	消化日数（全休：1, 半日単位：0.5, 時間休：0）

勤怠の更新APIの変更内容

RequestBody

要素	型定義	変更前	変更後
paid_holiday	number(float)	この日の有休取得日数。1日単位で指定します。	[deprecated] この日の有休取得日数。1日単位で指定します。 ※ paid_holidaysを指定する場合にはこちらの値は参照されません ※ 削除予定のためpaid_holidays->type を指定してください
half_paid_holiday_mins	number(integer)	有給休暇の半休を利用した時間（分単位）	[deprecated] 有給休暇の半休を利用した時間（分単位） ※ paid_holidaysを指定する場合にはこちらの値は参照されません※ 削除予定のためpaid_holidays->mins を指定してください
half_holiday_type	string	morning_off または afternoon_off を指定します	[deprecated] morning_off または afternoon_off を指定します ※ paid_holidaysを指定する場合にはこちらの値は参照されません※ 削除予定のためpaid_holidays->type を指定してください
hourly_paid_holiday_mins	number(integer)	有給休暇の時間休を利用した時間（分単位）	[deprecated] 有給休暇の時間休を利用した時間（分単位） ※ paid_holidaysを指定する場合にはこちらの値は参照されません※ 削除予定のためpaid_holidays->mins を指定してください
paid_holidays->type	string	–	有給休暇の種別を指定します（全休：full, 半休：half, 午前休：morning_off, 午後休：afternoon_off, 時間休：hourly）
paid_holidays->mins	number(integer)	–	有給休暇を利用した時間（分単位） ※ 全休の場合や午前休、午後休の場合にはこちらの値は参照されません

Response

勤怠の取得APIの変更内容と同様です。

勤怠情報月次サマリの取得APIの変更内容

要素	型定義	変更前	変更後
work_records->half_paid_holiday_mins	number(integer)	有給休暇の半休を利用した時間（分単位）	[deprecated] 有給休暇の半休を利用した時間（分単位）※ 削除予定のためwork_records->paid_holidays を参照してください
work_records->hourly_paid_holiday_mins	number(integer)	有給休暇の時間休を利用した時間（分単位）	[deprecated] 有給休暇の時間休を利用した時間（分単位）※ 削除予定のためwork_records->paid_holidays を参照してください
work_records->paid_holiday	number(float)	この日に対する有給取得日数。半休の場合は0.5が入ります。時間休の場合はhourly_paid_holiday_minsを所定労働時間で割った値が入るため、実際の時間を確認するにはhourly_paid_holiday_minsを参照してください。	[deprecated] この日に対する有給取得日数。半休の場合は0.5が入ります。時間休の場合はhourly_paid_holiday_minsを所定労働時間で割った値が入るため、実際の時間を確認するにはhourly_paid_holiday_minsを参照してください。※ 削除予定のためwork_records->paid_holidays を参照してください
work_records->paid_holidays->type	string	–	有給休暇の種別（full:全休、half:半休、morning_off:午前休、 afternoon_off:午後休、hourly:時間休）
work_records->paid_holidays->mins	number(integer)	–	年次有給休暇の休暇時間（分単位）
work_records->paid_holidays->days	number(float)	–	消化日数（全休：1, 半日単位：0.5, 時間休：0）

有給申請一覧の取得APIの変更内容

要素	型定義	変更前	変更後
paid_holidays->start_at	string	取得予定開始時間	[deprecated] 取得予定開始時間 ※ 削除予定のためpaid_holidays->values->start_at を参照してください
paid_holidays->end_at	string	取得予定終了時間	[deprecated] 取得予定終了時間 ※ 削除予定のためpaid_holidays->values->end_at を参照してください
paid_holidays->holiday_type	string	取得単位。（full:全休、half:半休、morning:午前休、 afternoon:午後休、hour:時間休）	[deprecated] 取得単位。（full:全休、half:半休、morning:午前休、 afternoon:午後休、hour:時間休）※ 削除予定のためpaid_holidays->values->type を参照してください
paid_holidays->values->type	string	–	有給休暇の種別（full:全休、half:半休、morning:午前休、 afternoon:午後休、hourly:時間休）
paid_holidays->values->start_at	string	–	取得予定開始時間
paid_holidays->values->end_at	string	–	取得予定終了時間

有給申請の取得APIの変更内容

要素	型定義	変更前	変更後
paid_holiday->start_at	string	取得予定開始時間	[deprecated] 取得予定開始時間 ※ 削除予定のためpaid_holiday->values->start_at を参照してください
paid_holiday->end_at	string	取得予定終了時間	[deprecated] 取得予定終了時間※ 削除予定のためpaid_holiday->values->end_at を参照してください
paid_holiday->holiday_type	string	取得単位。（full:全休、half:半休、morning:午前休、 afternoon:午後休、hour:時間休）	[deprecated] 取得単位。（full:全休、half:半休、morning:午前休、 afternoon:午後休、hour:時間休）※ 削除予定のためpaid_holiday->values->type を参照してください
paid_holiday->values->type	string	–	有給休暇の種別（full:全休、half:半休、morning:午前休、 afternoon:午後休、hourly:時間休）
paid_holiday->values->start_at	string	–	取得予定開始時間
paid_holiday->values->end_at	string	–	取得予定終了時間

有給申請の作成、更新APIの変更内容

RequestBody

要素	型定義	変更前	変更後
start_at	string	取得予定開始時間	[deprecated] 取得予定開始時間 ※ paid_holidays->values を指定している場合にはこちらの値は参照されません ※ 削除予定のためvalues->start_at を指定してください
end_at	string	取得予定終了時間	[deprecated] 取得予定終了時間 ※ paid_holidays->valuesを指定している場合にはこちらの値は参照されません ※ 削除予定のためvalues->end_at を指定してください
holiday_type	string	取得単位。（full:全休、half:半休、morning:午前休、 afternoon:午後休、hour:時間休）	[deprecated] 取得単位。（full:全休、half:半休、morning:午前休、 afternoon:午後休、hour:時間休） ※ paid_holidays->valuesを指定している場合にはこちらの値は参照されません ※ 削除予定のためvalues->type を指定してください
values->type	string	–	休暇種別（full:全休、half:半休、morning:午前休、 afternoon:午後休、hourly:時間休）
values->start_at	string	–	取得予定開始時間 ※全休の場合や午前休、午後休の場合にはこちらの値は参照されません
values->end_at	string	–	取得予定終了時間 ※全休の場合や午前休、午後休の場合にはこちらの値は参照されません

Response

有給申請の取得APIの変更内容と同様です。

有給申請の承認APIの変更内容

RequestBody

変更はありません。

Response

有給申請の取得APIの変更内容と同様です。

リリース時期

• web版における同日取得の対応時期
  • https://sites.google.com/c-fo.com/freee-hr-updates/plans#h.vkkmyhxg3r83
• PublicAPIにおける同日取得の対応時期
  • 1月中予定

freeeアプリストアについて、2024年7月より以下2点の運用変更を予定しております。

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

なお、変更の影響を受けるアプリの開発者様には個別メールにてご連絡を差し上げております。

ご確認のほどどうぞ宜しくお願い申し上げます。

変更内容①：アプリタイプによる事業所数制限の見直し

• これまで「アプリ利用事業所数の制限」は、プライベートアプリのみが対象でしたが、一部のパブリックアプリについても対象となります。
• 変更前
  • 利用事業所数の制限はプライベートアプリのみにある。（5事業所の制限）
  • 
• 変更後
  • プライベートアプリに加え、freeeに未申請のパブリックアプリについて、デフォルトの利用事業所数を20以下までに制限します。
  • 制限の詳細はアプリタイプのヘルプページをご確認ください。
  • freeeに申請を行うことで、利用事業所数の上限は撤廃できます。
  • 

影響範囲について

• この変更はパブリック・プライベートに関わらず、freeeアプリストア上の全てのアプリに適用されます。
• 既存のアプリについては、アプリの種別に応じて、対応が異なります。以下のフローチャートをご参照ください。

変更時期

• 2024年7月頃を予定

変更内容②：プラン限定アプリ制度の開始

• 特定の機能を持つfreee会計との連携アプリについて、利用できるユーザーのプランを限定する場合があります。
• 変更前
  • 原則アプリと連携できるfreeeのプラン指定はなし。
• 変更後
  • 特定の機能を持つパブリックアプリの場合、利用できるユーザーのプランを限定する場合があります
  • 詳細はプラン限定アプリのヘルプページをご確認ください。

影響範囲について

• 対象となるアプリ開発者には、既にメールでご連絡を差し上げております。
• 今後新規で作成されるアプリについては同条件での審査を行いますのでご留意ください。
  • 審査の流れについてはアプリ審査についてをご確認ください。

変更時期

• 2024年7月頃を予定
  • 2024年7月より、ユーザーは特定プランに所属していないと、該当のアプリを利用できなくなります。
  • この変更がユーザーに適用されるのは2024年7月以降最初のプラン更新時となります。

下記2点、freee会計 ファイルボックス（証憑ファイル）APIの仕様変更があります。

変更内容①は実施済み、変更内容②は今後実施される予定です。
freee会計APIをご利用の開発者の皆様におかれましては、変更点をご確認いただき、アプリの改修などの必要な対応をいただきますよう、よろしくお願い申し上げます。

変更内容①：

• POST・PUT時のリクエストパラメーター「issue_date（発生日）」を廃止しました。

対象エンドポイント：

• POST /api/1/receipts ファイルボックス（証憑ファイル）のアップロード
• PUT /api/1/receipts/{id} ファイルボックス（証憑ファイル）の更新

変更理由：

• 不具合への対応となります。
  ユーザーがリクエストパラメーターで指定した値に関わらず、アップロード日付がissue_dateに登録されていました。
• Webの仕様と合わせ、POSTやPUT時にissue_dateを指定できないようにします。
  ※なお、今後issue_dateを指定したリクエストはエラーにならず、値が無視されるようになります。
  そのため、この変更は既存アプリの挙動に影響はございません。
  

変更の実施時期：

• 2023年6月（実施済み）

変更内容②：

• GET時のレスポンスから「issue_date（発生日）」「file_src（ファイルのダウンロードURL）」を廃止します。

対象エンドポイント：

• GET /api/1/receipts ファイルボックス（証憑ファイル）一覧の取得
• GET /api/1/receipts/{id} ファイルボックス（証憑ファイル）の取得

変更理由：

• いずれもWebで利用されてない非推奨の値となります。
  今後、issue_dateに代わりcreated_atをご利用ください。
• 今後、file_srcに代わり、ファイルボックス（証憑ファイル）のダウンロードAPIをご利用ください。
• ※なお、issue_dateは現在POST/PUT時のレスポンスパラメーターにも含まれますが、上記GETのレスポンスパラメーターと同じタイミングで廃止されます。

変更の実施時期：

• 2023年7月中旬

下記の通り、freee APIの仕様変更を予定しています。

freee APIをご利用されている開発者の皆さまにおかれましては、新仕様の確認ならびに必要に応じてアプリの改修などの対応をご検討いただきますよう、よろしくお願い申し上げます。

変更の概要

• freee API　リフレッシュトークンの有効期限を「有効期限なし」から、「発行後90日間」に変更します。

変更理由

• freee API　セキュリティ強化のため。

変更時期

• 2023年12月頃

影響範囲

• この変更は、全てのfreee API リフレッシュトークンに関わります。
• なお、freee APIを利用するアプリにおいて、大部分のアプリはこの変更の影響を受けないことが確認できております。大部分のアプリは、リフレッシュートークンを用いたアクセストークン生成を90日以内の間隔で行っていることが確認できているためです。
• 【有効期限の影響を受ける場合】
  • （アクセストークンと同時に発行された）リフレッシュトークンを、発行後91日以上経ってから利用する実装があるアプリ。
  • リフレッシュトークンを用いたアクセストークンの再発行を定期的に（90日以内に）行っていないアプリ。
• 【有効期限の影響を必ずしも受けない場合】
  • ユーザーが90日以上freeeにログインしない場合
    • 該当アプリが、内部的にアクセストークンの再発行を（90日以内に）行っていれば影響を受けることはありません。
• アクセストークン・リフレッシュトークンの概要については以下のページも併せてご参照ください。
  • アクセストークンを取得する
  • この変更は、有効期限適用後に発行されたリフレッシュトークンだけでなく、有効期限適用前に発行された全てのリフレッシュトークンにも関わります。
  • 90日の有効期限は「有効期限が適用されてから」ではなく、「リフレッシュトークンが発行されてから」となります。

必要な対応内容

• 既存のアプリにつきまして、 必要に応じて「リフレッシュトークンが無効の場合（有効期限切れの場合）、認可コードの再取得を行う」仕様を実装してください。
• なおリフレッシュトークンの有効期限が切れていた場合は、現在無効なリフレッシュトークンを利用した際にも出力される、以下の401エラーが出力されます。

{
    "error": "invalid_grant",
    "error_description": "指定された認可グラントは不正か、有効期限切れか、無効か、リダイレクトURIが異なるか、もしくは別のクライアントに適用されています。"
}

※以下の変更は2023年7月3日にリリースされました。

2023年10月に開始するインボイス制度への対応として、freee会計APIの仕様変更を予定しています。
その一環として、以下の税区分コード48件を新規に追加します。

新しい税区分は2023年7月より利用いただける予定です。リリースが完了しましたら、別途お知らせをいたします。

新しい税区分の影響範囲、またfreee会計APIのインボイス制度への対応全体に関するお知らせは、【重要】freee会計 APIの仕様変更（インボイス制度対応）についてをご確認ください。

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

新税区分の概要

インボイス制度の開始に伴い、以下12種類の税区分がWeb上で追加されます。（それぞれ4通りの税率を持つため、48件の税区分コードが追加されます。）

• 課税売上に対応する免税事業者からの仕入
  • 課対仕入（控80）、課対仕入（控50）
  • 課対仕返（控80）、課対仕返（控50）

• 非課税売上に対応する免税事業者からの仕入
  • 非対仕入（控80）、非対仕入（控50）
  • 非対仕返（控80）、非対仕返（控50）

• 課税・非課税売上に共通対応する免税事業者からの仕入
  • 共対仕入（控80）、共対仕入（控50）
  • 共対仕返（控80）、共対仕返（控50）

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

控80
仕訳の発生日が、2023/10/1 〜 2026/9/30 の場合に選択してください。
仕入税額相当額の80％が控除可能であることを示します。

控50
仕訳の発生日が、2026/10/1 〜 2029/9/30 の場合に選択してください。
仕入税額相当額の50％が控除可能であることを示します。

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

税区分コード (code)	税区分名 （name）	日本語税区分名 （name_ja）
183	purchase_with_tax_exempt_80	課対仕入（控80）
184	purchase_with_tax_exempt_50	課対仕入（控50）
185	purchase_with_tax_8_exempt_80	課対仕入（控80） 8%
186	purchase_with_tax_8_exempt_50	課対仕入（控50） 8%
187	purchase_with_tax_reduced_8_exempt_80	課対仕入（控80） 8%（軽）
188	purchase_with_tax_reduced_8_exempt_50	課対仕入（控50） 8%（軽）
189	purchase_with_tax_10_exempt_80	課対仕入（控80） 10%
190	purchase_with_tax_10_exempt_50	課対仕入（控50） 10%
191	purchase_with_no_tax_exempt_80	非対仕入（控80）
192	purchase_with_no_tax_exempt_50	非対仕入（控50）
193	purchase_with_no_tax_8_exempt_80	非対仕入（控80） 8%
194	purchase_with_no_tax_8_exempt_50	非対仕入（控50） 8%
195	purchase_with_no_tax_reduced_8_exempt_80	非対仕入（控80） 8%（軽）
196	purchase_with_no_tax_reduced_8_exempt_50	非対仕入（控50） 8%（軽）
197	purchase_with_no_tax_10_exempt_80	非対仕入（控80） 10%
198	purchase_with_no_tax_10_exempt_50	非対仕入（控50） 10%
199	purchase_with_common_exempt_80	共対仕入（控80）
200	purchase_with_common_exempt_50	共対仕入（控50）
201	purchase_with_common_8_exempt_80	共対仕入（控80） 8%
202	purchase_with_common_8_exempt_50	共対仕入（控50） 8%
203	purchase_with_common_reduced_8_exempt_80	共対仕入（控80） 8%（軽）
204	purchase_with_common_reduced_8_exempt_50	共対仕入（控50） 8%（軽）
205	purchase_with_common_10_exempt_80	共対仕入（控80） 10%
206	purchase_with_common_10_exempt_50	共対仕入（控50） 10%
207	return_of_purchase_with_tax_exempt_80	課対仕返（控80）
208	return_of_purchase_with_tax_exempt_50	課対仕返（控50）
209	return_of_purchase_with_tax_8_exempt_80	課対仕返（控80） 8%
210	return_of_purchase_with_tax_8_exempt_50	課対仕返（控50） 8%
211	return_of_purchase_with_tax_reduced_8_exempt_80	課対仕返（控80） 8%（軽）
212	return_of_purchase_with_tax_reduced_8_exempt_50	課対仕返（控50） 8%（軽）
213	return_of_purchase_with_tax_10_exempt_80	課対仕返（控80） 10%
214	return_of_purchase_with_tax_10_exempt_50	課対仕返（控50） 10%
215	return_of_purchase_with_no_tax_exempt_80	非対仕返（控80）
216	return_of_purchase_with_no_tax_exempt_50	非対仕返（控50）
217	return_of_purchase_with_no_tax_8_exempt_80	非対仕返（控80） 8%
218	return_of_purchase_with_no_tax_8_exempt_50	非対仕返（控50） 8%
219	return_of_purchase_with_no_tax_reduced_8_exempt_80	非対仕返（控80） 8%（軽）
220	return_of_purchase_with_no_tax_reduced_8_exempt_50	非対仕返（控50） 8%（軽）
221	return_of_purchase_with_no_tax_10_exempt_80	非対仕返（控80） 10%
222	return_of_purchase_with_no_tax_10_exempt_50	非対仕返（控50） 10%
223	return_of_purchase_with_common_exempt_80	共対仕返（控80）
224	return_of_purchase_with_common_exempt_50	共対仕返（控50）
225	return_of_purchase_with_common_8_exempt_80	共対仕返（控80） 8%
226	return_of_purchase_with_common_8_exempt_50	共対仕返（控50） 8%
227	return_of_purchase_with_common_reduced_8_exempt_80	共対仕返（控80） 8%（軽）
228	return_of_purchase_with_common_reduced_8_exempt_50	共対仕返（控50） 8%（軽）
229	return_of_purchase_with_common_10_exempt_80	共対仕返（控80） 10%
230	return_of_purchase_with_common_10_exempt_50	共対仕返（控50） 10%

※「フォーム用選択項目情報の取得」仕様変更について

上記税区分追加と同時に、「フォーム用選択項目情報の取得API」に、以下の仕様修正を行います。

変更の詳細:

これまでフォーム用選択項目について、消費税の仕様設定に関わらず、default_taxにて全ての税率、(tax_rate_5,tax_rate_8,tax_rate_10,tax_rate_r8)を返却していました。

上記を修正し、消費税の仕様設定で「使用しない」と設定した税率は返却しないように修正します。

消費税の使用設定についてはヘルプページ2. 消費税・税区分の設定を行うをご確認ください。

対象エンドポイント:

GET /api/1/forms/selectables フォーム用選択項目情報の取得
（account_items内のdefault_taxの返却内容）

変更の理由:

不要な税率を表示しないため。

[2023/3/28 19:38追記]

本日17時53分頃より、freeeの全てのAPI（会計・人事労務・プロジェクト管理・受発注）で動作が不安定な状況が発生しておりましたが、18時36分に機能復旧を完了しています。

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

---

本日17時57分頃より、freeeの全てのAPI（会計・人事労務・プロジェクト管理・受発注）で動作が不安定な状況が確認されております。

https://status.freee.co.jp/issues/6422b024386fb37753e257e9

現在、復旧に向けた対応を行っております。

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

2023年10月に開始予定のインボイス制度への対応として、freee会計APIの仕様変更を予定しています。
仕様変更は2023年4月〜10月にかけて、段階的に行われます。
変更点は大きく分けて5つあり、アプリの挙動に大きな影響がある変更（破壊的変更）が2点含まれます。

このお知らせは2022年12月にお知らせした、以下のお知らせの続報となります。
https://developer.freee.co.jp/news/6140
なお、今後このお知らせは、都度更新をさせていただく予定です。

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

インボイス対応による仕様変更の一覧
1.請求書API・見積書APIの「freee請求書」への移行（破壊的変更） 2.経費精算APIの仕様変更（破壊的変更） 3.インボイス制度関連項目の追加（取引先・ファイルボックス） 4.新規税区分・税区分カテゴリの追加 5.支払依頼APIの仕様変更（適格・非適格のパラメーターの追加）

1.請求書API・見積書APIの「freee請求書」への移行（破壊的変更）【リリース済】

変更内容：

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

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

freee請求書 APIリファレンス

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

対象エンドポイント：

廃止(「freee会計」請求書・見積書API)

• 請求書（invoices）
  • DELETE /api/1/invoices/{id}：請求書の削除
  • GET /api/1/invoices：請求書一覧の取得
  • GET /api/1/invoices/{id}：請求書の取得
  • POST /api/1/invoices：請求書の作成
  • PUT /api/1/invoices/{id}：請求書の更新
• 見積書（quotations）
  • DELETE /api/1/quotations/{id}：見積書の削除
  • GET /api/1/quotations：見積書一覧の取得
  • GET /api/1/quotations/{id}：見積書の取得
  • POST /api/1/quotations：見積書の作成
  • PUT /api/1/quotations/{id}：見積書の更新

新設（「freee請求書API」としてリリース）

• 請求書（invoices）
  • GET /invoices 請求書一覧の取得
  • POST /invoices：請求書の作成
  • GET /invoices/{id}：請求書の取得
  • PUT /invoices/{id}：請求書の更新
  • GET /invoices/templates：使用可能な請求書の帳票テンプレート一覧の取得
• 見積書（quotations）
  • GET /quotations：見積書一覧の取得
  • POST /quotations：見積書の作成
  • GET /quotations/{id}：見積書の取得
  • PUT /quotations/{id}：見積書の更新
  • GET /quotations/templates：使用可能な見積書の帳票テンプレート一覧の取得

変更の実施予定時期

• 2023年4月：freee請求書API「請求書」「見積書」リリース 【リリース済】
• 2023年10月：freee会計API「請求書」「見積書」の新規作成（POST）廃止 【リリース済】
• 時期未定：freee会計API「請求書」「見積書」の更新・削除（PUT, DELETE）廃止
• 時期未定：freee会計API「請求書」「見積書」の取得（GET）廃止

---

2.経費精算APIの仕様変更（破壊的変更）【リリース済】

変更内容：

経費精算APIには以下の仕様変更が発生します。

変更①：複数明細行への対応（データ構造の変更）【リリース済】

今まで、経費精算には、一つの明細行しか紐づけることができませんでした。
そのため申請行はAPIのレスポンスにおいては省略されていました。
Web側の仕様変更に伴い、一つの申請行に対して複数の明細行を紐づけられるようになります。

これに伴い、経費精算のデータ構造が以下のように変わります。

※この変更は、2023年5月〜10月は、後述の「移行方針」に記載した「ヘッダー分岐」を指定することで利用ができます。

変更前	変更後
「経費精算」の直下に「明細行」が存在する。 「申請行」は存在するが見えない。 「明細行」は複数作成できる。 “expense_application”（経費精算）: {   “expense_application_lines”（明細行）: [   ] }	「経費精算」と「明細行」の間に、 「申請行」が存在する。 「申請行」も「明細行」も複数作成できる。 “expense_application”（経費精算）: {  “purchase_lines”（申請行）: [   “expense_application_lines”（明細行）: [     ]   ] }

移行方針：

新しいデータ構造（変更①）は2023年5月から利用することができます。
このデータ構造は、リクエストヘッダーに以下のAPIのバージョンを指定することで、利用可能となります。

Expense-Application-Mode: purchase-lines

※1 2023年10月以降、APIのバージョン指定の有無に関わらず、経費精算APIの仕様は①となります。
※2 2023年5月〜10月の間、APIのバージョン(Expence-Application-Mode: purchase-lines)を指定しない場合、「申請行」を持つ経費精算の取得（GET）をすることができません。
※3 2023年6月時点で予定していた「変更②(申請行ごとの適格非適格パラメーターの追加)」 は仕様の方針変更に伴い、対応不要となりました。

変更の実施予定時期：

2023年5月：freee会計API「経費精算」登録・更新・取得（POST,PUT, GET） ヘッダー分岐開始（変更①）【リリース済】

2023年10月末：freee会計API「経費精算」登録・更新・取得（POST,PUT, GET） 旧仕様の廃止【リリース済】

---

3.インボイス制度関連項目の追加（取引先・ファイルボックス）【リリース済】

変更内容：

インボイス制度対応に必要な下記項目が関連APIに追加されます。
いずれも任意のパラメーターとなります。

• 適格請求書発行事業者の登録番号
• 適格請求書発行事業者か否かのステータス
• 書類の種類（ファイルボックスAPIのみ）

なお、仕様の詳細は、2023年4月に公開したリファレンスを合わせてご確認ください。

freee会計 APIリファレンス

取引先API

変更前	変更後
以下のパラメーターに対応していない。 ・適格請求書発行事業者の登録番号 ・適格請求書発行事業者か否かのステータス	GETで以下のパラメーターを取得できる。 PUT・POSTで、以下のパラメーターの登録や更新ができる。 ・適格請求書発行事業者の登録番号 ・適格請求書発行事業者か否かのステータス

ファイルボックスAPI

変更前	変更後
以下のパラメーターに対応していない。 ・適格請求書発行事業者の登録番号 ・適格請求書発行事業者か否かのステータス ・書類の種類	GETで以下のパラメーターを取得できる。 PUTで以下のパラメーターを指定して更新ができる。 ※1 POST時は指定ができません。 ・適格請求書発行事業者の登録番号※1 ・適格請求書発行事業者か否かのステータス ・書類の種類

対象エンドポイント：

取引先（partners）

• GET /api/1/partners：取引先一覧の取得
• GET /api/1/partners/{id}：取引先の取得
• POST /api/1/partners：取引先の作成
• PUT /api/1/partners/{id}：取引先の更新
• PUT /api/1/partners/code/{code}：取引先の更新

ファイルボックス（receipts）

• GET /api/1/receipts：ファイルボックス（証憑ファイル）一覧の取得
• GET /api/1/receipts/{id}：ファイルボックス（証憑ファイル）の取得
• POST /api/1/receipts：ファイルボックス（証憑ファイル）アップロード
• PUT /api/1/receipts/{id}： ファイルボックス（証憑ファイル）情報更新

変更の実施予定時期：

2023年4月上旬 【リリース済】

---

4.新規税区分・税区分カテゴリの追加【リリース済】

変更内容：

インボイス制度対応に伴い新たに48件の税区分および8件の税区分カテゴリが追加され、関連エンドポイントで利用可能になります。

新税区分は2023年7月から各APIで利用することができます。

新税区分一覧は以下のリンクよりご確認ください。
freee会計APIのインボイス制度における税区分追加のお知らせ

対象エンドポイント：

税区分

• 税区分（taxes）
  • GET /api/1/taxes/codes 税区分一覧の取得
  • GET /api/1/taxes/codes/{code} 税区分の取得
  • GET /api/1/taxes/companies/{company_id} 指定した事業所の税区分一覧の取得
• 事業所（companies）
  • GET /api/1/companies/{id}： 事業所の詳細情報の取得
• 取引（deals）
  • GET /api/1/deals：取引（収入・支出）一覧の取得
  • GET /api/1/deals/{id}：取引（収入・支出）の取得
  • POST /api/1/deals：取引（収入・支出）の作成
  • PUT /api/1/deals/{id}：取引（収入・支出）の更新
• 仕訳帳（journals）
  • GET /api/1/journals/reports/{id}/download：ダウンロード実行
• 振替伝票（manual journals）
  • GET /api/1/manual_journals 振替伝票一覧の取得
  • GET /api/1/manual_journals/{id} 振替伝票の取得
  • POST /api/1/manual_journals 振替伝票の作成
  • PUT /api/1/manual_journals/{id} 振替伝票の更新
• 取引の＋更新（renews）
  • POST /api/1/deals/{id}/renews：取引（収入・支出）に対する+更新の作成
  • PUT /api/1/deals/{id}/renews/{renew_id}：取引（収入・支出）の+更新の更新
• フォーム用選択項目（selectables）
  • GET /api/1/forms/selectables フォーム用選択項目情報の取得

税区分カテゴリ

• 税区分（taxes）
  • GET /api/1/taxes/codes 税区分一覧の取得
  • GET /api/1/taxes/codes/{code} 税区分の取得
  • GET /api/1/taxes/companies/{company_id} 指定した事業所の税区分一覧の取得

変更の実施予定時期：

2023年7月 【リリース済】

---

5.支払依頼APIの仕様変更（適格・非適格のパラメーターの追加）【リリース済】

変更内容：

支払依頼ごとに「適格・非適格・未指定」を選択できるようになります。
なお、こちらは任意のパラメーターとなります。

変更前	変更後
“payment_requests”（支払依頼）に適格・非適格のパラメーター“qualified_invoice_status”はない。	“payment_requests”（支払依頼）に適格・非適格のパラメーター“qualified_invoice_status”が存在する。 上記のパラメーターはGETで取得ができる。 PUT・POST登録や更新ができる。

対象エンドポイント：

支払依頼（payment requests）

• GET /api/1/payment_requests 支払依頼一覧の取得
• GET /api/1/payment_requests/{id} 支払依頼の取得
• POST /api/1/payment_requests 支払依頼の作成
• PUT /api/1/payment_requests/{id} 支払依頼の更新

変更の実施予定時期：

2023年7月 【リリース済】

---

お知らせの変更履歴

2023年10月 11日　1.請求書API・見積書APIの「freee請求書」への移行　（POST）廃止　リリース済みの旨追記

2023年7月 4日　2.経費精算APIの仕様変更 変更②　　変更内容を削除
                            4.新規税区分・税区分カテゴリの追加　リリース済みの旨追記
                            5.支払依頼APIの仕様変更　リリース済みの旨追記

2023年6月 23日　5.支払依頼APIの仕様変更 パラメーター名をqualified_invoice_statusに修正

2023年5月 26日　2.経費精算APIの仕様変更 変更①　リリース済みの旨追記

2023年5月 9日　1.請求書API・見積書APIの「freee請求書」への移行　移行ガイドへのリンクを追加

2023年4月 17日 4.新規税区分・税区分カテゴリの追加　新規税区分一覧へのリンクを追加
                         　 2. 経費精算APIの変更予定時期　修正

2023年4月 4日　1.請求書API・見積書APIの「freee請求書」への移行　リリース済みの旨追記
                        　 3.インボイス制度関連項目の追加　リリース済みの旨追記
                        　 4.新規税区分・税区分カテゴリの追加　税区分の公開予定時期を修正

2023年3月30日　2.経費精算APIの仕様変更 変更②　修正（明細行→申請行）

2023年3月29日　5. 支払依頼APIの変更内容　追記
                         　 2. 経費精算APIの変更予定時期　修正

2023年3月10日　初回掲載

下記の通り、freee会計APIの仕様変更を予定しております。

ご迷惑をおかけし大変恐れ入りますが、新仕様の確認ならびに必要に応じてアプリの改修などの対応をご検討いただきますよう、よろしくお願い申し上げます。

変更の詳細:

「グループ管理機能」で「利用可能な部門」を制限されているユーザーの場合、section_ids に “0”（部門:未選択）を指定できなくなります。 

対象エンドポイント:

[GET] /api/1/reports/trial_pl_sections: 損益計算書(部門比較)の取得

[GET] /api/1/reports/trial_cr_sections: 製造原価報告書(部門比較)の取得

変更の理由:

上記のエンドポイントを利用する際、グループ管理機能で利用可能な部門を制限していても、section_ids に “0”（未選択）を指定することで、Web版では指定できない「部門:未選択」で比較ができてしまうという不具合が存在しています。

これを修正し、利用可能な部門を制限されたユーザーの場合は（Webと同様に）部門:未選択で比較ができないようにする変更を下記の日程で計画しています。
※グループ管理機能について詳しくは「メンバーが利用できる口座・部門を指定する(グループ管理)」をご参照ください。

変更の実施予定時期:

2023年3月末