下記の日時に、freeeの各サービスでシステムメンテナンスを行います。

日時：2022年10月27日（木）1:00-5:00

対象：全サービス

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

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

================================================

freee developer support

[2022/10/06 12:00追記]

9時28分頃より、freee会計APIの一部について動作が不安定な状況が発生しておりましたが、11時50分現在、機能復旧を完了しています。ご迷惑をおかけし、大変申し訳ございませんでした。

---

本日9時28分頃より、freee会計APIの一部について動作が不安定な状況が発生しております。

https://status.freee.co.jp/issues/633e2c4ea877245264f6b958

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

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

[2022/09/30 15:54追記]

15時43分に復旧したことを確認いたしました。

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

---

[2022/09/30 15:41追記]

本日14時24分頃より、freee会計API全般について動作が不安定な状況が発生しておりましたが、

15時31分頃より安定的な稼働状況に戻ってきていることを確認しております。

現在、念の為稼働状況のモニタリングを続けております。ご迷惑をおかけし大変申し訳ございません。

---

本日14時24分頃より、freee会計API全般について動作が不安定な状況が発生しております。

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

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

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

変更内容：

口座に紐づく勘定科目※を更新する際、name（勘定科目名）を指定できなくなり、指定した場合エラーとなります。
この変更に伴い、name（勘定科目名）は任意項目となりますが、口座に紐づかない勘定科目を更新する場合は引き続きname（勘定科目名）の指定が必要です。

口座に紐づく勘定科目の名称を変更したい場合は、口座の更新（PUT /api/1/walletables/{type}/{id}）で口座名を更新することで勘定科目名にも変更が反映されます。

※walletables（口座）を作成した際に自動的に生成される勘定科目を指します。

対象エンドポイント：

• PUT /api/1/account_items/{id}：勘定科目の更新

変更理由：

freee会計のWeb画面とギャップがあり、データ不整合が発生する恐れがあるため

変更の実施予定時期：

2022年10月末ごろ

[2022-10-13更新]
告知事項の追加に伴い、「変更の詳細②」「変更の詳細③」を追記いたしました。
以前から告知している内容については「変更の詳細①」とタイトルを改めました。

---

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

変更の詳細①：

勘定科目一覧または事業所の詳細情報を取得した際のレスポンス項目から「tax_id（税区分ID）」に関連する項目が削除されます。

なお、freeeにおける税区分は「tax_code（税区分コード）」に移行しており、「tax_id（税区分ID）」は過去の変更により他のエンドポイントではすでに使用できなくなっているため、実質的な影響はありません。

対象のエンドポイントと削除される項目：

• GET /api/1/account_items：勘定科目一覧の取得
  • default_tax_id（デフォルト設定がされている税区分ID）
• GET /api/1/companies/{id}：事業所の詳細情報の取得
  • default_tax_id（デフォルト設定がされている税区分ID）
  • taxes.id（税区分ID）
  • taxes.name（税区分名）

変更の理由：

廃止された項目を削除するため

変更の実施予定時期：

2022年10月

---

変更の詳細②：

勘定科目の詳細情報を取得した際のレスポンス項目から「tax_id（税区分ID）」に関連する項目が削除されます（すでにリファレンスからは削除されておりますが実際には返却されており、仕様通りに修正するための変更です）。
なお、freeeにおける税区分は「tax_code（税区分コード）」に移行しており、「tax_id（税区分ID）」は過去の変更により他のエンドポイントではすでに使用できなくなっているため、実質的な影響はありません。

対象のエンドポイントと削除される項目：

• GET /api/1/account_items/{id}：勘定科目の詳細情報の取得
  • default_tax_id（デフォルト設定がされている税区分ID）

変更の理由：

廃止された項目「tax_id（税区分ID）」を削除するため

変更の実施予定時期：

2022年10月

---

変更の詳細③：

フォーム用選択項目情報を取得した際のレスポンス項目から「tax_id（税区分ID）」に関連する項目が削除され、「tax_code（税区分コード）」に関連する項目が追加されます。

対象のエンドポイントと削除・追加される項目：

• GET /api/1/forms/selectables：フォーム用選択項目情報の取得
  • [削除] account_categories.account_items.default_tax.tax_rate_5.id（税区分ID）
  • [削除] account_categories.account_items.default_tax.tax_rate_8.id（税区分ID）
  • [追加] account_categories.account_items.default_tax.tax_rate_5.code（税区分コード）
  • [追加] account_categories.account_items.default_tax.tax_rate_8.code（税区分コード）
  • [追加] account_categories.account_items.default_tax.tax_rate_10.code（税区分コード）
  • [追加] account_categories.account_items.default_tax.tax_rate_r8.code（税区分コード）

変更の理由：

使用されていない項目「tax_id（税区分ID）」を削除し、「tax_code（税区分コード）」への移行を行うため

変更の実施予定時期：

2022年12月
※「tax_code（税区分コード）」の追加に関しては2022年10月中を予定しており、リリース後に改めてお知らせいたします。

[2022年9月7日 17:00更新]

影響範囲の詳細について確認が取れたため、以下に記載いたします。

なお、影響を受けた可能性のあるアプリのオーナーさまには個別にご案内いたします。

見積書：

請求書の承認機能が有効になっている事業所について、ステータスが送付待ち（quotation_status = unsubmitted）の見積書の一部が取得できない状態が発生していました。

対象エンドポイント：GET /api/1/quotations（見積書一覧の取得）

対象期間：2022年8月25日 15:39 〜 2022年9月6日 21:45

請求書：

請求書の承認機能が有効になっている事業所について、ステータスが下書き（invoice_status = draft）の請求書の全てが取得できない状態が発生していました。

対象エンドポイント：GET /api/1/invoices（請求書一覧の取得）

対象期間：2022年8月25日 16:15 〜 2022年9月6日 21:45

---

[2022年9月7日 9:00更新]

本事象について、2022年9月6日 21:45頃に復旧対応が完了し、現在は解消しております。

---

本日16時30分頃より、freee会計APIで一部の見積書・請求書を取得できない状況が発生しております。

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

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

見積書：

見積書一覧の取得API（GET /api/1/quotations）でステータスが送付待ち（quotation_status = unsubmitted）の見積書の一部が取得できません。

請求書：

請求書一覧の取得API（GET /api/1/invoices）でステータスが下書き（invoice_status = draft）の請求書の全てが取得できません。

下記の日時に、freeeの各サービスでシステムメンテナンスを行います。

日時：2022年8月24日（水）1:00-5:00

対象：全サービス

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

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

================================================

freee developer support

本事象について、現在は安定的な稼働状況に戻っていることを確認しております。
ご迷惑をおかけし、大変申し訳ございませんでした。
引き続き、よろしくお願い申し上げます。[2022年8月3日15時30分更新]

本日13時30分頃より、freeeAPIリファレンスの表示が不安定な状況が確認されており、現在対応を行っております。

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

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

変更の概要：

現預金カテゴリに属する勘定科目※が明細行に存在する取引および振替伝票について、以下に記載する特定の条件を満たす操作ができなくなります。
実行した場合、エラーとなります。（HTTPステータスコード：400）
なお、すでに特定の条件を満たす操作によって作成された取引を更新する場合にも適用されるため、対象となる取引の更新が必要な場合は取引の作り直しが必要となります。

※「現金・預金」の勘定科目カテゴリに属する勘定科目を指します。勘定科目カテゴリIDは下記の通りです。

• 法人事業所の場合：account_category_id = 36
• 個人事業所の場合：account_category_id = 19

---

変更の詳細①：

決済状況が未決済※となる取引の作成・更新ができなくなります。

※取引の支払行（payments）が未指定、または取引の支払行（payments）の金額の合計が取引の明細行（details）の合計金額より少ない（部分入金）場合

対象エンドポイント：

• POST /api/1/deals
• PUT /api/1/deals

---

変更の詳細②：

以下のいずれかの条件を満たす取引・+更新・振替伝票の作成・更新ができなくなります。

• 以下の条件を満たす明細を1件以上含む
  • 税区分 ≠ ‘対象外’, ‘未選択’, ‘不課税’
• 以下の条件を満たす明細を1件以上含む
  • 税額 ≠ 0

対象エンドポイント：

• POST /api/1/deals
• PUT /api/1/deals
• POST /api/1/deals/{id}/renews
• PUT /api/1/deals/{id}/renews
• POST /api/1/manual_journals
• PUT /api/1/manual_journals

---

変更の詳細③：

取引の支払行（payments）の金額の合計が取引の明細行（details）の合計金額より少なくなるような取引の支払行の更新・削除ができなくなります。

対象エンドポイント：

• PUT /api/1/deals/{id}/payments/{payment_id}
• DELETE /api/1/deals/{id}/payments/{payment_id}

---

変更の理由：

会計データとして不正な現預金系取引の作成防止のため

変更の実施予定時期：

2022年9月

下記の日時に、freeeの各サービスでシステムメンテナンスを行います。

日時：2022年7月27日（水）1:00-5:00

対象：全サービス

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

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

================================================

freee developer support

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

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

変更の詳細：

事業所の設定で請求書が承認制になっており、かつ請求書のステータス（invoice_status）が「draft（下書き）」の場合、請求書の作成者以外のユーザーが請求書を取得・更新・削除できなくなります。

一覧取得の場合は、条件に該当する請求書は取得結果に含まれなくなります。
IDを指定して取得・更新・削除する場合は、エラーとなります（HTTPステータスコード：400）。

対象エンドポイント：

• GET /api/1/invoices：請求書一覧の取得
• GET /api/1/invoices/{id}：請求書の取得
• PUT /api/1/invoices/{id}：請求書の更新
• DELETE /api/1/invoices/{id}：請求書の削除

変更の理由：

freee会計Web画面の仕様変更によるもの。
参考：見積書・納品書・請求書・発注書作成を承認制にする

変更の実施予定時期：

2022年8月

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

変更の詳細：

取引に対する+更新時に、+更新対象の取引明細行の備考欄が、+更新により作成する取引明細行の備考欄にコピーされなくなります。

例えば、以下のような仕訳の前受金に対して売上高で+更新を行った場合

現金（備考：なし）

前受金（備考：手付金）

今までは以下のように前受金行の備考がコピーされていました。

現金（備考：なし）	前受金（備考：手付金）
前受金（備考：手付金）	売上高（備考：なし）

今後は以下のように前受金行の備考がコピーされなくなります。

現金（備考：なし）	前受金（備考：手付金）
前受金（備考：なし）	売上高（備考：なし）

対象のエンドポイント：

• POST /api/1/deals/{id}/renews：取引（収入／支出）に対する+更新の作成

変更の理由：

freee会計Web画面の仕様変更によるもの。

変更の実施予定時期：

2022年7月中旬

下記の日時に、freeeの各サービスでシステムメンテナンスを行います。

日時：2022年6月23日（木）1:00-5:00

対象：全サービス

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

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

================================================

freee developer support

下記の通り、freeeプロジェクト管理APIの仕様変更を予定しています。
ご利用されている開発者の皆さまにおかれましては、新仕様の確認ならびに必要に応じてアプリの改修などの対応をご検討いただきますよう、よろしくお願い申し上げます。

変更の詳細：

工数登録時のリクエストパラメータ「工数タグID（workload_tags.tag_id）」が必須項目になります。

変更の理由：

freeeプロジェクト管理Web画面との仕様ギャップを無くすため。

変更の実施予定時期：

2022年7月11日

[2022年7月11日追記]
本仕様変更は、都合により延期させていただくことになりました。
延期後のリリース時期は決定次第ご案内させていただきます。

下記の日時に、freeeの各サービスでシステムメンテナンスを行います。

日時：2022年6月9日（木）1:00-5:00

対象：全サービス

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

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

================================================

freee developer support

下記の日時に、freeeの各サービスでシステムメンテナンスを行います。

日時：2022年5月26日（木）1:00-5:00

対象：全サービス

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

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

================================================

freee developer support