- (3/8) [全般] ロックされた事業所を指定したリクエストも 200 系レスポンスを返却していたが 、Webの挙動と合わせて 403 エラーが返却されるようになりました。
以上です。
引き続きどうぞよろしくお願いいたします。
freee会計API インボイス制度における税区分追加について
※以下の変更は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の返却内容）
変更の理由:
不要な税率を表示しないため。
システムメンテナンス(04/18) のお知らせ
日時：2023年4月18日 (火) 1:00 – 5:00
対象：全サービス
メンテナンス中は該当サービスをご利用いただけません。
ご迷惑をおかけしますが、ご理解の程よろしくお願いいたします。
================================================
freee developer support
【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の値が異なっています」をでなくしました。
以上です。
引き続きどうぞよろしくお願いいたします。
システムメンテナンス(3/23) のお知らせ
日時：2023年3月23 (木) 1:00 – 5:00
対象：全サービス
メンテナンス中は該当サービスをご利用いただけません。
ご迷惑をおかけしますが、ご理解の程よろしくお願いいたします。
================================================
freee developer support
【重要】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への移行に際しては、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月に公開したリファレンスを合わせてご確認ください。
取引先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月の更新情報
- (1/6) フォーム用選択項目情報APIのレスポンスを更新しました。
- (1/24) アプリ管理画面『Webアプリ認証用URL』『モバイル・JSアプリ認証用URL』のURLを事業所選択用に更新しました。
- 事業所選択に関しましては『freee APIの使い方－事業所の選択について』をご確認ください。
以上です。
引き続きどうぞよろしくお願いいたします。
システムメンテナンス(2/14) のお知らせ
日時：2023年2月14 (火) 1:00 – 5:00
対象：全サービス
メンテナンス中は該当サービスをご利用いただけません。
ご迷惑をおかけしますが、ご理解の程よろしくお願いいたします。
================================================
freee developer support
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に以下の通り実施されました。
- freee会計SDKのメンテナンス終了
- freee会計スキーマのymlファイルでの公開終了
1.freee会計SDKのメンテナンス終了
この度freeeが提供している以下3つのAPI開発者向けのSDKについて、定期のメンテナンスを終了することになりましたのでお知らせいたします。
対象のSDK：
- 会計freee C# SDK
- 会計freee Java SDK
- 会計freee PHP 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
2022年12月の更新情報
- (12/2) [会計] フォーム用選択項目情報を取得した際のレスポンス項目から「tax_id（税区分ID）」を削除しました。詳細は 2022-09-08 のニュース変更の詳細③をご確認ください。
以上です。
引き続きどうぞよろしくお願いいたします。