【重要】freee会計APIの仕様変更(インボイス制度対応)について

(2023/3/10追記:インボイス対応関する最新情報は今後、以下のお知らせをご確認ください。
https://developer.freee.co.jp/news/6369

2023年10月に開始予定のインボイス制度への対応として、freee会計APIの仕様変更を予定しています。

変更点は大きく分けて5つあり、アプリの挙動に大きな影響がある変更(破壊的変更)が2点含まれます。
freee会計APIをご利用されている開発者の皆さまにおかれましては、新仕様の確認ならびに必要に応じてアプリの改修などの対応をご検討いただきますよう、よろしくお願い申し上げます。

1.請求書API・見積書APIのfreee請求書への移行(破壊的変更)

変更内容:

「freee請求書」リリースに伴い、「freee会計」APIの「請求書(invoices)」および「見積書(quotations)」は廃止され、「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」としてリリース)

  • 請求書
  • 見積書
  • 帳票テンプレート

変更の実施予定時期:

2023年4月:freee請求書API「請求書」「見積書」「帳票テンプレート」リリース
2023年10月:freee会計API「請求書」「見積書」の新規作成(POST)廃止
時期未定:freee会計API「請求書」「見積書」の更新・削除(PUT, DELETE)廃止
時期未定:freee会計API「請求書」「見積書」の取得(GET)廃止


2.経費精算APIの仕様変更(破壊的変更)

変更内容:

経費精算APIに仕様変更が発生します。
詳細につきましては後日改めてお知らせいたします。

対象エンドポイント:

  • 経費精算(expense applications)

変更の実施予定時期:

2023年7月:freee会計API「経費精算」登録・更新・取得(POST,PUT, GET) インボイス対応仕様での利用開始
2023年10月以降:freee会計API「経費精算」登録・更新・取得(POST,PUT, GET) 旧仕様の廃止


3.インボイス制度関連項目の追加

変更内容:

インボイス制度対応に必要な下記項目が関連APIに追加されます。

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

対象エンドポイント:

  • 取引先(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件の税区分カテゴリが追加され、関連エンドポイントで利用可能になります。

対象エンドポイント:

税区分

  • 税区分(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の仕様変更

変更内容:

支払依頼APIに仕様変更が発生します。
詳細につきましては後日改めてお知らせいたします。

対象エンドポイント:

  • 支払依頼(payment requests)

変更の実施予定時期:

2023年7月

(2023/3/10追記:インボイス対応関する最新情報は今後、以下のお知らせをご確認ください。
https://developer.freee.co.jp/news/6369