リリースノート

【freee人事労務】従業員カスタム項目の内容が取得可能になりました

freee人事労務APIにおいて、従業員情報に入力された「カスタム項目」を取得できるエンドポイントをリリースしました。

対象エンドポイント

  • カスタム項目API（/api/v1/employees/{employee_id}/profile_custom_fields）

変更内容

  • カスタム項目APIは、freee人事労務のカスタム項目に入力された内容を従業員ごとに取得することができます。
  • このAPIはお手元での人事データの分析や、外部ツールとの連携に活用いただけます。
  • ご利用方法の詳細はfreee人事労務APIのリファレンスページをご確認ください。
    人事労務APIリファレンス – freee Developers Community

従業員カスタム項目について

リリースノート

【freee会計】仕訳帳APIにおいて、「新CSV形式での取得」、「文字コードの選択」が可能になりました

freee会計　仕訳帳APにおいて「新CSV形式での仕訳帳の取得」、「文字コードの選択」が可能になりました。

対象エンドポイント

  • 仕訳帳API（/api/1/journals）

変更点

  • ダウンロード形式（download_type）で新CSV形式（generic_v2）を選択して、仕訳帳をダウンロードすることができるようになりました。
  • 文字コード（encoding）を指定して、仕訳帳をダウンロードすることができるようになりました。
  • ご利用方法の詳細はfreee会計 仕訳帳APIのリファレンスをご確認ください。
    会計APIリファレンス – freee Developers Community

新CSV形式について

  • 新CSV形式では、これまでのAPIでは出力できなかった「（仕訳を）登録した方法」のような項目を出力することができます。
  • 新CSV形式で出力できる項目の詳細については、ヘルプページ「仕訳帳をCSV形式・PDF形式で出力する」をご確認ください。
ニュース

[復旧済み]freee APIにて動作が不安定な状況が確認されておりました

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

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

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

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

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

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

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

リリースノート

2023年2月の更新情報

  • (2/7) [会計][事業所][詳細] (GET /api/1/companies/{id})
    • industry_code が null になるケースを “” (空文字) に統一しました。リファレンス記載の内容と一致させる修正です。
  • (2/13) [人事労務] path パラメータで employee_id を指定するエンドポイント
    • path と body に同一の従業員IDを指定した場合も出ていた「employee_idとemp_idの値が異なっています」をでなくしました。

以上です。
引き続きどうぞよろしくお願いいたします。

ニュース

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

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の仕様変更について

下記の通り、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月末

リリースノート

freee人事労務Webhook(β版)をリリースしました

この度freee人事労務Webhook(β版)をリリースしました。

Webhookはfreeeプロダクト上で操作が行われた際、そのことを連携先のアプリに通知するための仕組みです。

freee人事労務Webhook(β版)は「freee人事労務上で従業員の追加・更新・削除が行われたこと」を、連携先のアプリに通知することができます。

これにより、連携アプリに「従業員の追加・更新・削除」をトリガーとしたアクションを実装頂けるようになりました。

freee人事労務Webhook(β版)の機能の詳細、β版における制限については人事労務Webhook概要をご参照ください。

リリースノート

【重要】freeeプロジェクト管理API「工数登録」時にworkload_tags.tag_idが必須になりました

freeeプロジェクト管理APIにおいて、工数登録（POST /workloads）でこれまで任意だったリクエストパラメータ「工数タグID（workload_tags.tag_id）」が必須になりました。
利用方法については下記リファレンスページをご確認ください。

https://developer.freee.co.jp/reference/pm/reference#operations-tag-Workloads

なお、本リリースは先日配信いたしましたお知らせ「【重要】freeeプロジェクト管理APIの仕様変更について（https://developer.freee.co.jp/news/6298）」に関連するリリースです。

ニュース

【重要】freeeプロジェクト管理APIの仕様変更について（不具合への対応）

下記の通り、freeeプロジェクト管理APIの仕様変更を予定しております。

この仕様変更は不具合対応によるもののため、リリース直前のお知らせとなります。

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

変更の詳細:

工数登録の際に、これまで任意だったリクエストパラメータ「工数タグID（workload_tags.tag_id）」が必須になります。

対象エンドポイント:

[POST] /workloads: 工数登録

変更の理由:

工数登録時の工数タグ選択を「必須」に設定していても、工数登録する際、工数タググループを選択することで工数タグを選択せずに工数登録ができてしまう不具合が存在しています。

これを修正し、工数タグの選択を必須とする変更を下記の日程で計画しています。

これに伴い、Public APIについてもこれまで任意だった工数タグIDが必須となります。

変更の実施予定時期:

2023年2月中

ニュース

[復旧済み]freeeAPIの一部の動作が不安定な状況が発生していました

[2023/2/14 14:00追記]

本日8時24分頃~8時47分頃の間、freee 会計・人事労務Public APIの一部について動作が不安定な状況が発生しておりましたが、14時00分現在、機能復旧を完了しています。

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

本日8時24分頃より、「モバイルアプリ（会計/人事労務/電子申告/プロジェクト管理）、Public APIの一部の機能」の動作が不安定な状況が確認されておりましたが、8時47分より安定的な稼働状況に戻っていることを確認しております。

https://status.freee.co.jp/issues/63ead4faf4e01e46241f5bad

現在、念の為稼働状況のモニタリングを続けております。

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

リリースノート

2023年1月の更新情報

以上です。
引き続きどうぞよろしくお願いいたします。

リリースノート

freee Public APIに関する事業所選択機能のリリースについて

この度freeeが提供しているAPIにおいて、「事業所選択機能」をリリースしたことをお知らせいたします。

機能の概要

事業所選択機能は、「freeeユーザーが連携アプリの利用を開始する際、アプリがアクセスできる事業所を指定する機能」のことです。
これまで開発者がfreee上で公開アプリを作成する際、開発者自身で「事業所選択機能」を実装頂く必要がありました。

今後はfreeeが提供するデフォルトの認証用URLをご利用頂くことで、freee製の事業所選択機能をご利用頂けます。

事業所選択機能について、詳しくはfreee APIの使い方－事業所の選択についてをご覧ください。

既存機能への影響

この変更による、既存アプリケーションの挙動への影響はありません。

開発者ページ・アプリ詳細画面内でデフォルトで表示される以下のURL2つが変更されました。

  • Webアプリ認証用URL
  • モバイル・JSアプリ認証用URL

各URLについて、末尾に以下文言が追加されています。

  • &prompt=select_company

なお文言を削除し、旧来のURLを引き続きご利用頂くことも可能です。
但し旧来のURLでは、freee製の事業所選択機能をご利用頂くことができません。
詳しくはfreee APIの使い方－事業所の選択についてをご覧ください。

ニュース

freee会計 Public APIに関するSDKのメンテナンス終了、およびスキーマのymlファイルでの公開終了について

※2023/4/17追記
このお知らせの内容は2023/4/17に以下の通り実施されました。

  1. freee会計SDKのメンテナンス終了
  2. freee会計スキーマのymlファイルでの公開終了

1.freee会計SDKのメンテナンス終了

この度freeeが提供している以下3つのAPI開発者向けのSDKについて、定期のメンテナンスを終了することになりましたのでお知らせいたします。

対象のSDK：

メンテナンスの終了時期：

2023年4月

今後のご利用につきまして：

いずれのSDKについても定期メンテナンスは終了しますが、github上ではdepreceated（非推奨）として公開を継続しますので、ご利用は可能です。

また、クライアントコードはリファレンス内で公開しているjsonを利用して、開発者ご自身で生成頂くことが可能です。

設計ガイドライン内で会計 PHP用クライアントコード（SDK）の生成方法を公開しておりますのでご活用ください。

2.freee会計スキーマのymlファイルでの公開終了

またgithub上でymlファイルの形式で公開していた会計APIのスキーマファイルについて、公開を終了することになりましたのでお知らせいたします。

対象のリポジトリ：

公開の終了時期：

2023年4月

今後のご利用につきまして：

今後はリファレンス内でも公開している、json形式のスキーマファイルをご活用ください。

ニュース

システムメンテナンス(1/24) のお知らせ

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

日時：2023年1月24日（火）1:00-5:00

対象：全サービス

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

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

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

freee developer support

ニュース

【重要】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）