freee会計の経費申請において設定金額を超過した場合、購買申請の関連付けの必須化が可能になりました。この機能により、特定の条件で申請をできないように制御できるようになります。

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

対象エンドポイント

• 経費申請の作成（POST / expense_application ）
• 経費申請の更新（PUT / expense_application / {id} ）

変更内容

• 本拡張機能はPublic APIに対応していないため、この設定を[有効]にした場合にはPublic APIを経由した経費精算の作成・変更ができません。
• 設定を[有効]にしてPublic APIを経由した経費精算の作成・変更を行おうとすると、「関連付けが必須化された申請の操作は、web版freee会計を利用ください。」というエラーメッセージを返します。

リリース時期

• 2024年9月下旬

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

・日時: 2024/09/26 (木) 1:00 – 5:00
・対象:freeeの全サービス (電子公告サービス除く、freeeサイン含む) 

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

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

freee会計APIにおいて、取引先の使用可能・使用停止の変更が可能になりました。

（「使用停止」は取引先設定画面リニューアル前時点の「入力候補に使用しない」という項目に、「使用可能」は「入力候補に使用する」に相当します）

取引先設定画面リニューアルの詳細は以下の資料をご参照ください。
https://docs.google.com/presentation/d/1nHQHvpGjxCUsSRmCpkTaoOzwh-2so3ITZEMK91op5OI/edit#slide=id.g2db307f53f9_133_0

取引先の削除APIをご利用の場合は、以下の点に注意してください。

2024/9/17(火)の取引先設定画面のリニューアルで、既存の「削除」が「アーカイブ」として機能性が変更されます。

取引先をアーカイブにするには今までの取引先削除APIをご利用いただけ、ご利用方法は変更ありませんが、今回の修正でアーカイブ前に使用停止に変更する必要があります。

今回ご案内する取引先の更新APIの使用可能・使用停止の変更機能をご活用ください。

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

対象エンドポイント

• 取引先の更新API（PUT /api/1/partners/{id}）
• 取引先の更新API（PUT /api/1/partners/code/{code}）

Request Bodyの追加

available

true: 使用可能、false: 使用停止

変更内容

• freee会計APIにおいて、使用可能・使用停止(available)の変更が可能になりました。

リリース時期

• 2024/9/5

freee工数管理において、プロジェクト名の文字数上限が50文字から100文字に変更されました。

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

対象エンドポイント

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

変更内容

• プロジェクト名の文字数上限が50文字から100文字に変更されました。

リリース時期

• 2024年9月4日

freee会計の経費申請において、特定の条件で申請をできないように制御できるようになります。

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

対象エンドポイント

• 経費申請の作成（POST / expense_application ）
• 経費申請の更新（PUT / expense_application / {id} ）
• 経費申請の承認操作（POST / expense_application / {id} / actions )

変更内容

• 経費申請を作成・更新・承認するときに新たにバリデーションが追加されます。
• 申請制御の設定を有効にし、その設定に該当する経費申請に対して該当の操作をされた際にバリデーションが実行されエラーが返ってくるようになります。

リリース時期

• 10月中旬

補足

• 申請制御機能で設定できる制御条件はリリース時にお知らせいたします。

発生時刻
2024年08月28日(水)16:00頃　〜　2024年08月28日(水)　 16:20頃

発生事象
以下の特定のフローにおけるアクセストークンの発行に失敗する事象が発生していました。

• freeeアカウントをお持ちでない方 のフローを辿って、無料の開発者向けアカウントをあわせてアクセストークンを発行するフロー
• 通常の「Webアプリ認証用URL」ではなく「モバイル・JSアプリ認証用URL」を利用してアクセストークンを発行するフロー

ご対応いただきたいこと
発生時刻中にエラーを確認している場合は、再度操作をお試しください。

本事象について、2024年08月28日(水) 17:20頃に復旧対応が完了し、現在は解消しております。
ご迷惑をおかけし、大変申し訳ございません。

freee人事労務APIにおいて、2024年分より年末調整関連のAPIにて「保険金等の受取人 あなたとの続柄」が削除されます。

これは国税庁より提示されております「変更を予定している年末調整関係書類（事前の情報提供）」に基づく対応となります。

freee人事労務APIにて年末調整をご利用の開発者の皆様におかれましては、変更点をご確認いただき、アプリの改修などの必要な対応を行っていただきますよう、よろしくお願い申し上げます。

対象エンドポイント

• 年末調整の従業員情報取得API
  • （GET /api/v1/yearend_adjustments/{year}/employees/{employee_id}）
• 年末調整の従業員保険料情報の作成API
  • （POST /api/v1/yearend_adjustments/{year}/insurances/{employee_id}）
• 年末調整の従業員保険料情報の更新API
  • （PUT /api/v1/yearend_adjustments/{year}/insurances/{employee_id}）

変更内容

• 年末調整の従業員情報取得APIにおいて、2024年以降は「保険金等の受取人 あなたとの続柄」が出力されなくなります。
• 年末調整の従業員保険料情報の作成及び更新APIにおいて、2024年以降は「保険金等の受取人 あなたとの続柄」を指定しても反映されなくなります。
• 2023年以前の年末調整APIについては変更はありません。

リリース時期

• 2024年10月中

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

対象のリポジトリ：

• 会計freee SDK
  • GitHub – freee/freee-accounting-sdk-javascript: 会計 freee APIのjavascript SDK（β版）です。

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

• 2024年9月

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

• github上ではdepreceated（非推奨）として公開を継続しますので、ご利用は可能です。

freee人事労務APIにおいて新しい雇用形態の選択が可能になりました。

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

対象エンドポイント

• 従業員（GET/POST /employees）
• 従業員の姓名・住所など（GET/POST employees/{employee_id}/profile_rule）

変更内容

• freee人事労務APIにおいて以下の雇用形態の選択が可能になりました。
  • board-member: 役員
  • regular: 正社員
  • fixed-term: 契約社員
  • part-time: アルバイト・パート
  • temporary: 派遣社員
  • （空文字列）: その他
• 従来の’役員以外’は雇用形態として選択不可になります。
• 過去に’役員以外（空文字列）’として設定された従業員は今後、’その他’として表示されます。
• 役員の登録方法については役員を登録する – freee ヘルプセンターをご確認ください。

リリース時期

• 9月上旬

freee会計APIにおいて、ファイル削除のバリデーションの仕様を一部変更します。

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

対象エンドポイント

• ファイルの削除API（DELETE /receipts）

変更内容

• 自分が作成した申請の下書きに添付されたファイルは削除可能でしたが、削除できないように変更します。
• ファイルに下書きが紐づいている場合は、下書きの作成者がWeb上の画面で下書きに添付されたファイルを解除した後に、再度削除をお試しください。

リリース時期

• 2024年 8月下旬

2024年7月1日よりfreeeアプリストアの運用に変更がありました。

アプリの利用事業所数についてパブリックタイプアプリは20件以下までの上限がございます。
解除の必要がある場合は後述の対応が必要となります。

詳細については、【重要】freeeアプリストアの運用変更についてをご参照ください。

アプリの利用事業所数の上限に達した場合、新規でアカウントによる認可を行おうとすると以下のエラーメッセージが表示されます。

「”アプリ名”　”XXX”　は上限数に達しました。」

上限を解除するためには以下の対応が必要となります。

２．上限変更申請

広く認知いただく意図のない、21事業所以上で利用されたいアプリの場合に推奨いたします。

上限変更申請を行っていただき、デモンストレーション等、21事業所以上の複数事業所でのご利用に際して適正な実装となっているかを確認した上で、上限数を解除させていただきます。

上限変更をご申請いただいた場合は、アプリの管理を行っている事業所を作成したアカウントのメールアドレスへ、審査の流れなど必要項目をご連絡させていただきます。

３．開発テスト事業所の利用

開発・検証用に作成したアプリの場合に推奨いたします。

開発・検証用に作成したアプリの認可を行う場合については、開発テスト事業所をご利用いただくことでご利用数としてカウントされない形に変更が可能ですので、意図せず利用事業所数が21を超えてしまった場合などにご活用ください。

４．利用アカウントの削減

アプリの認可を行うURLを全ての事業所を認可するURLを用いているアプリや、複数の事業所に所属しているアカウントが存在する場合等に推奨いたします。

旧認可にてご利用いただいている場合や、複数の事業所に所属したアカウントの認可を行う利用事業所数の確認方法については、利用事業所数のカウント方法をご確認ください。

なお、該当のアプリについては既に利用されていないなど、新しく認可を行う必要がない場合は、対応不要のケースもございます。

ご確認の上、必要に応じてご対応をお願い申し上げます。

ご不明な点がございましたらお気軽にお問い合わせください。

どうぞよろしくお願いいたします。

集計表機能の提供終了に伴い、ログインユーザーの権限の取得API (/api/1/users/capabilities) から集計表に対する権限 (reports_crosstabs) がレスポンス項目の対象外となります。

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

対象エンドポイント

• ログインユーザーの権限の取得API（GET /api/1/users/capabilities）

変更内容

• レスポンスから reports_crosstabs キーの削除

リリース時期

• 8月中旬

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

・日時: 2024/07/24 (水) 1:00 – 5:00
・対象: freee 全サービス（freeeサイン除く）

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

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

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

– 日時: 2024/07/09 (火) 1:00 – 5:00
– 対象: freee 全サービス、freeeサイン (電子公告含む)

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

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

2024年7月1日付で、freeeAPI利用規約を改訂しましたのでお知らせいたします。

■改定の効力発生日

2024年7月1日

■改定後のfreeeAPI利用規約

URL：https://app.secure.freee.co.jp/terms-freee-api.html

■改定内容

・フリーファイナンスラボ株式会社の吸収合併に伴い、同社に関する表記を削除しました。（第7条１(５)）。

■フリーファイナンスラボ株式会社の吸収合併について

　詳細は以下のリンクをご参照ください。　
フリーファイナンスラボ株式会社の吸収合併(簡易合併・略式合併)に関するお知らせ

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

– 日時: 2024/06/19 (水) 1:00 – 5:00
– 対象: freee 全サービス、freeeサイン (電子公告含む)

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

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