日時：2023年2月14 (火) 1:00 – 5:00
対象：全サービス
メンテナンス中は該当サービスをご利用いただけません。
ご迷惑をおかけしますが、ご理解の程よろしくお願いいたします。
================================================
freee developer support
All posts by freee
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
試算表APIのレスポンス内容変更について
下記の通り、試算表APIの仕様変更を予定しています。
開発者の皆さまにおかれましては、新仕様の確認ならびに必要に応じてアプリの改修などの対応をご検討いただきますよう、よろしくお願い申し上げます。
変更の実施予定時期
2021年10月
変更内容
試算表APIのリクエストパラメータ[section_id（部門ID）]に親部門のIDを指定した場合の実行結果が変更されます。
変更前
親部門のIDを指定した場合、集計値は0が返却されます。（HTTPステータスコードは[200(成功)]）
変更後
親部門のIDを指定した場合、指定した親部門の配下の部門（子部門）の集計値が返却されます。（HTTPステータスコードは[200(成功)]）
対象エンドポイント
- /api/1/reports/trial_bs
- /api/1/reports/trial_bs_two_years
- /api/1/reports/trial_bs_three_years
- /api/1/reports/trial_pl
- /api/1/reports/trial_pl_two_years
- /api/1/reports/trial_pl_three_years
- /api/1/reports/trial_pl_segment_1_tags
- /api/1/reports/trial_pl_segment_2_tags
- /api/1/reports/trial_pl_segment_3_tags
変更理由
freee会計の機能アップデートのため
freeeアプリストア 決済機能セミナー開催のお知らせ
freeeアプリストア 決済機能セミナーを、9月10日(金) 17時よりオンラインで開催します。
「アプリストア 決済機能」を利用すると、freee用に開発したアプリを有料販売することが可能となります。
この新機能の詳細、利用方法をご紹介いたします。
※7月21日に開催したセミナーと同じ内容となります。セミナー動画をもとに再構成して開催します。
開催日時
2021年9月10日(金) 17時00分ー17時40分
参加対象者
freeeアプリストアでアプリの販売をお考えの開発者様
freeeアプリストアを使っているfreee ユーザーのみなさま
お申し込み
下記のセミナーの告知ページからお申し込みください。
試算表API活用セミナー開催のお知らせ
試算表APIセミナーを9月8日(水) 15時からオンラインで開催します。
今回のセミナーでは「試算表」に絞り込み
・試算表の新機能、これから実装予定の機能
・試算表APIを利用した簡単な分析アプリのデモ
・活用事例
などをご紹介します。
freee会計をもっと活用したい方、試算表の活用をお考えの方、経営分析・予実管理や経営資料の作成など、社内の情報共有に試算表の活用をお考えの方は、ぜひご参加ください。
開催日時
2021年9月8日(水) 15時ー15時40分（予定）
参加対象者
- freee会計をもっと活用したい方
- 試算表の活用をお考えの方
- 経営資料の作成など、社内の情報共有に活用をお考えの方
お申し込み
下記のセミナーの告知ページからお申し込みください。
【重要】Community 機能変更に関するご案内
当サイトで提供をしている「Community」機能の変更を行います。Developer Community 会員の皆様におきましては、変更内容のご確認とご理解をいただきたく、よろしくお願いいたします。
- Community 掲示板の廃止と、TeraTail上のコミュニティ新設について
- サポートポリシーについて
- Developer Community 会員の位置付けについて
１. Community 掲示板の廃止と、TeraTailのコミュニティ新設について
当サイトで提供している、Q&A用の掲示板「Community」機能を、2021年6月25日(金)をもって提供終了します。終了に先立ち、6月11日(金)に新規スレッドの作成を終了します。6月25日(金)にはスレッド作成・コメント作成・Developer Community会員のログイン機能提供を全て終了します。
同時に、技術者向けのQ&A 提供サービス「TeraTail」に、freee開発者向けのコミュニティを新設します。
2. サポートポリシーについて
会計freee, 人事労務freeeをはじめとする、freeeの各サービスをご契約の方は、管理画面から正規のサポートをご利用いただけます。お問い合わせから、お問い合わせの種類を「操作方法についてのご質問」、対象の画面カテゴリを「Public API」を選択しお問い合わせください。
会計freee, 人事労務freee等のfreee各種サービスの契約を行なっていない方は、今後はTeraTail上のコミュニティをご利用ください。
- TeraTailのご利用に際しては、TeraTail上でアカウント登録を行う必要があります。
- TeraTail のご利用に際しては、TeraTailの利用規約をご覧いただき、ご承諾いただく必要があります。
- TeraTail上のコミュニティでは、freeeからの公式回答は行いません。freeeの公式回答をご希望の方は、上記の手順に従い、正規サポートをご利用ください。
３. Developer Community 会員の位置付けについて
これまで、Developer Community 会員には以下の2つの情報・機能を提供してきました。
- freee API に関する情報をメール配信
- Community機能（掲示板）の提供
6月25日以降は「freee API に関する情報をメール配信」をご提供いたします。以下のページから登録いただけます。
今後とも freee Developers Community をどうぞよろしくお願いいたします。
システムメンテナンス(2/10) のお知らせ
下記の日時に、freeeの各サービスでシステムメンテナンスを行います。
日時：2021年2月10日（水）1:00-5:00
対象：全サービス
メンテナンス中は該当サービスをご利用いただけません。
ご迷惑をおかけしますが、ご理解の程よろしくお願いいたします。
================================================
freee developer support
システムメンテナンス(1/21)のお知らせ
下記の日時に、freeeの各サービスでシステムメンテナンスを行います。
日時：2021年1月21日（木）1:00-5:00
対象：全サービス
メンテナンス中は該当サービスをご利用いただけません。
ご迷惑をおかけしますが、ご理解の程よろしくお願いいたします。
================================================
freee developer support
会計freee API用 Swagger 2.0 のファイル提供終了について
GitHubで提供している、会計freee API用 Swagger 2.0ファイルの提供を、2021年3月で終了します。
今後は Swagger2.0 の後継である OpenAPI 3.0 ファイルの提供を続けていきます。
https://github.com/freee/freee-api-schema
影響範囲：
会計freee API を利用したアプリ、および本サイトで公開中のAPIリファレンスどちらにも影響はありません。
【アップデート】アプリ詳細ページに動画掲載が可能に
アプリ詳細ページに動画掲載が可能になりました
freeeアプリストアのアプリ詳細ページの機能がアップデートされ、動画掲載が可能となりました。動画を掲載することで、アプリの機能や魅力をよりユーザーに伝えやすくなります。公開アプリのオーナーの皆様はぜひご活用ください。
動画掲載参考：https://app.secure.freee.co.jp/applications/5724
動画掲載の設定方法
- 動画のYouTube IDを取得
youtubeのIDは動画のURL「https://youtu.be/◯◯◯◯◯◯」の◯の部分に入る11桁の文字列です。動画の下にある [共有] 機能からも確認することができます。
- アプリストアの開発者向けページ「アプリ管理」から動画を追加するアプリを選択
アプリストアの開発者向けページ： https://app.secure.freee.co.jp/developers
- 「公開設定」の「アプリ説明動画のYouTube ID」を入力
動画のYouTube IDの11桁の文字列のみ入力します。
- 「公開設定」から「公開申請」または「更新申請」をする
新規で公開するアプリの場合は「公開申請」ボタン、公開済みのアプリの場合は「更新申請」ボタンが公開設定ページに表示されます。
freeeによる審査が完了すると動画がアプリ詳細ページに掲載されます。
システムメンテナンス(12/17)のお知らせ
下記の日時に、freeeの各サービスでシステムメンテナンスを行います。
日時：2020年12月17日（木）1:00-5:00
対象：全サービス
メンテナンス中は該当サービスをご利用いただけません。
ご迷惑をおかけしますが、ご理解の程よろしくお願いいたします。
================================================
freee developer support
会計freee API の一部機能の障害に関するご連絡
日頃より会計freeeをご利用いただきありがとうございます。
2020年12月1日(火) 0:00 から 13:14まで、会計freeeのPublic APIの一部機能がご利用いただけない状況が発生しておりました。
今回の影響範囲は以下の通りです。
* 2020年12月中旬以降に変更が予定されている、各機能を利用したアプリ
https://developer.freee.co.jp/release-note/2948現在は復旧対応が完了しており、全ての機能をご利用いただけます。
この度はご迷惑をおかけして申し訳ございません。何卒よろしくお願い申し上げます。
freee APIチーム
システムメンテナンス(11/26)のお知らせ
下記の日時に、freeeの各サービスでシステムメンテナンスを行います。
日時：2020年11月26日（木）1:00-5:00
対象：全サービス
メンテナンス中は該当サービスをご利用いただけません。
ご迷惑をおかけしますが、ご理解の程よろしくお願いいたします。
================================================
freee developer support
経費精算Webhook と ファイルダウンロードAPI をリリース
経費精算Webhookとファイルボックスの証憑ファイルダウンロードAPIをリリースしました。
経費精算Webhook
経費精算Webhookを利用することで、会計freeeで経費精算の「申請・承認・却下・差し戻し」の操作が行われた際に、それらの動作を会計freeeと連携した外部サービスに通知することができます。
加えて、freeeからの通知をきっかけにfreeeのデータをAPI経由で参照しに行くといったリアクションをとることでAPIコールを効率よく行うことができます。
ファイルダウンロードAPI
ファイルダウンロードAPIを利用することで、経費精算などワークフローに添付された証憑の参照や確認を、外部サービス上で行うことが可能となります。
利用可能なプラン
経費精算Webhookは、経費精算機能を提供している以下の会計freeeのプランでご利用可能です。
個人：プレミアムプラン
法人：ベーシックプラン
法人：プロフェッショナルプラン
法人：エンタープライズプラン
ファイルボックスAPIは、会計freeeの全プランでご利用可能です。
システムメンテナンス(10/22)のお知らせ
下記の日時に、freeeの各サービスでシステムメンテナンスを行います。
日時：2020年10月22日（木）1:00-5:00
対象：全サービス
メンテナンス中は該当サービスをご利用いただけません。
ご迷惑をおかけしますが、ご理解の程よろしくお願いいたします。
================================================
freee developer support
経費精算APIをアップデート
経費精算APIをアップデートしました。これにより、経費精算の申請や申請に対する承認操作が可能となります。
経費精算APIのアップデートで可能になること
今までは経費精算のAPI経由では下書き状態の申請しか作成できず、会計freeeのウェブサイトから申請を行う必要がありました。APIのアップデートにより、経費精算の申請の作成や申請に対する承認や差し戻しなどのアクションといった経費精算のワークフローを最初から最後までAPI経由で完結できます。
新設・拡張された経費精算APIの機能
経費精算APIの新設・拡張により、以下の操作がAPI経由で可能になります。
・経費精算の申請
・会計freeeで作成された申請経路の利用
・申請に対する承認や差し戻しなどのアクションの実行
ご利用可能なプラン
経費精算APIは、経費精算機能を提供している以下の会計freeeのプランでご利用可能です。
- 個人：プレミアムプラン
- 法人：ベーシックプラン
- 法人：プロフェッショナルプラン
- 法人：エンタープライズプラン
使い方
詳細な使い方は以下をご覧ください。
「会計freeeの経費精算APIの使い方」https://developer.freee.co.jp/guideline/accounting-expense-applications
freee受発注サービスβ版のAPIをリリース
「freee受発注サービスβ版」のPublic APIを公開しました。APIによりログインユーザー情報の取得や、受発注一覧を取得することが可能となります。
「freee受発注サービスβ版」APIで可能となること
ログインユーザー情報の取得
ログインユーザーの情報を取得することができます。ユーザーが複数の事業所に所属している場合は各事業所毎に情報が出力されます。 受発注APIで必要なcompany_idはこのAPIを利用して取得してください。
受発注一覧の取得
指定した事業所の発注・受注一覧を取得することができます。 一覧には日付や金額、取引先名やステータスなどが含まれています。 このAPIを用いることで、リアルタイムの発注・受注情報を把握したり、他クラウドサービスに取り込むことが可能になります。
freee受発注サービスβ版について
下記をご参照ください。
「freee受発注サービスβ版」：https://www.freee.co.jp/deals/
システムメンテナンス(9/24)のお知らせ
下記の日時に、freeeの各サービスでシステムメンテナンスを行います。
日時：2020年9月24日（木）1:00-5:00
対象：全サービス
メンテナンス中は該当サービスをご利用いただけません。
ご迷惑をおかけしますが、ご理解の程よろしくお願いいたします。
================================================
freee developer support