freee のすべての投稿

試算表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 ユーザーのみなさま

お申し込み

下記のセミナーの告知ページからお申し込みください。

freeeアプリストア 決済機能セミナー 申し込みページ

試算表API活用セミナー開催のお知らせ

試算表APIセミナーを9月8日(水) 15時からオンラインで開催します。

今回のセミナーでは「試算表」に絞り込み

・試算表の新機能、これから実装予定の機能
・試算表APIを利用した簡単な分析アプリのデモ
・活用事例

などをご紹介します。

freee会計をもっと活用したい方、試算表の活用をお考えの方、経営分析・予実管理や経営資料の作成など、社内の情報共有に試算表の活用をお考えの方は、ぜひご参加ください。

開催日時

2021年9月8日(水) 15時ー15時40分(予定)

参加対象者

  • freee会計をもっと活用したい方
  • 試算表の活用をお考えの方
  • 経営資料の作成など、社内の情報共有に活用をお考えの方

お申し込み

下記のセミナーの告知ページからお申し込みください。

freee会計 試算表API活用セミナー

【重要】Community 機能変更に関するご案内

当サイトで提供をしている「Community」機能の変更を行います。Developer Community 会員の皆様におきましては、変更内容のご確認とご理解をいただきたく、よろしくお願いいたします。

  1. Community 掲示板の廃止と、TeraTail上のコミュニティ新設について
  2. サポートポリシーについて
  3. Developer Community 会員の位置付けについて

1. Community 掲示板の廃止と、TeraTailのコミュニティ新設について

当サイトで提供している、Q&A用の掲示板「Community」機能を、2021年6月25日(金)をもって提供終了します。終了に先立ち、6月11日(金)に新規スレッドの作成を終了します。6月25日(金)にはスレッド作成・コメント作成・Developer Community会員のログイン機能提供を全て終了します。

同時に、技術者向けのQ&A 提供サービス「TeraTail」に、freee開発者向けのコミュニティを新設します

2. サポートポリシーについて

会計freee, 人事労務freeeをはじめとする、freeeの各サービスをご契約の方は、管理画面から正規のサポートをご利用いただけます。お問い合わせから、お問い合わせの種類を「操作方法についてのご質問」、対象の画面カテゴリを「Public API」を選択しお問い合わせください。

画像に alt 属性が指定されていません。ファイル名: image1-1024x735.png

会計freee, 人事労務freee等のfreee各種サービスの契約を行なっていない方は、今後はTeraTail上のコミュニティをご利用ください。

  • TeraTailのご利用に際しては、TeraTail上でアカウント登録を行う必要があります。
  • TeraTail のご利用に際しては、TeraTailの利用規約をご覧いただき、ご承諾いただく必要があります。
  • TeraTail上のコミュニティでは、freeeからの公式回答は行いません。freeeの公式回答をご希望の方は、上記の手順に従い、正規サポートをご利用ください。

3. Developer Community 会員の位置付けについて

これまで、Developer Community 会員には以下の2つの情報・機能を提供してきました。

  • freee API に関する情報をメール配信
  • Community機能(掲示板)の提供

6月25日以降は「freee API に関する情報をメール配信」をご提供いたします。以下のページから登録いただけます。

Developers Community 会員登録

今後とも 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

動画掲載の設定方法

  1. 動画のYouTube IDを取得

youtubeのIDは動画のURL「https://youtu.be/◯◯◯◯◯◯」の◯の部分に入る11桁の文字列です。動画の下にある [共有] 機能からも確認することができます。

  1. アプリストアの開発者向けページ「アプリ管理」から動画を追加するアプリを選択

アプリストアの開発者向けページ: https://app.secure.freee.co.jp/developers

  1. 「公開設定」の「アプリ説明動画のYouTube ID」を入力

動画のYouTube IDの11桁の文字列のみ入力します。

  1. 「公開設定」から「公開申請」または「更新申請」をする

新規で公開するアプリの場合は「公開申請」ボタン、公開済みのアプリの場合は「更新申請」ボタンが公開設定ページに表示されます。

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

システムメンテナンス(10/22)のお知らせ

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

日時:2020年10月22日(木)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の全プランでご利用可能です。

freee受発注サービスβ版のAPIをリリース

「freee受発注サービスβ版」のPublic APIを公開しました。APIによりログインユーザー情報の取得や、受発注一覧を取得することが可能となります。

「freee受発注サービスβ版」APIで可能となること

ログインユーザー情報の取得

ログインユーザーの情報を取得することができます。ユーザーが複数の事業所に所属している場合は各事業所毎に情報が出力されます。 受発注APIで必要なcompany_idはこのAPIを利用して取得してください。

受発注一覧の取得

指定した事業所の発注・受注一覧を取得することができます。 一覧には日付や金額、取引先名やステータスなどが含まれています。 このAPIを用いることで、リアルタイムの発注・受注情報を把握したり、他クラウドサービスに取り込むことが可能になります。

freee受発注サービスβ版について

下記をご参照ください。

「freee受発注サービスβ版」:https://www.freee.co.jp/deals/

経費精算APIをアップデート

経費精算APIをアップデートしました。これにより、経費精算の申請や申請に対する承認操作が可能となります。

経費精算APIのアップデートで可能になること

今までは経費精算のAPI経由では下書き状態の申請しか作成できず、会計freeeのウェブサイトから申請を行う必要がありました。APIのアップデートにより、経費精算の申請の作成や申請に対する承認や差し戻しなどのアクションといった経費精算のワークフローを最初から最後までAPI経由で完結できます。

新設・拡張された経費精算APIの機能

経費精算APIの新設・拡張により、以下の操作がAPI経由で可能になります。

・経費精算の申請

・会計freeeで作成された申請経路の利用

・申請に対する承認や差し戻しなどのアクションの実行

ご利用可能なプラン

経費精算APIは、経費精算機能を提供している以下の会計freeeのプランでご利用可能です。

  • 個人:プレミアムプラン
  • 法人:ベーシックプラン
  • 法人:プロフェッショナルプラン
  • 法人:エンタープライズプラン

使い方

詳細な使い方は以下をご覧ください。

「会計freeeの経費精算APIの使い方」https://developer.freee.co.jp/tips/accounting-expense-applications

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

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

日時:2020年9月24日(木)1:00-5:00

対象:全サービス

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

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

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

freee developer support

【再掲】当サイトメンテナンスのお知らせ(9/11)

下記の日時に、当サイト「freee Developers Communty」のシステムメンテナンスを行います。

日時:2020年9月11日(金)14:00-15:00

メンテナンス時間中も、各ページ・リファレンスなどの閲覧は可能ですが、当サイトへのログイン および Community掲示板への投稿はできません。

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

システムメンテナンス(8/21)のお知らせ

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

日時:2020年8月21日(金)1:00-5:00

対象:全サービス

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

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

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

freee developer support

【重要】freee APIのセキュリティ基準見直しについて

freeeアプリストアのユーザー数・掲載アプリ数の増加、会計freeeと各金融機関のAPI連携の拡大を受け、ユーザー保護の観点からfreee APIの利用に関するセキュリティ基準の見直しを行います。なお、適用されるセキュリティ基準はアプリの目的によって異なります。

変更内容

  1. アプリの目的を識別するため、「アプリタイプ(※1)」という分類を導入します。
    個々の事業所における利用を目的としたアプリを「プライベートアプリ」、配布や複数の事業所での利用を目的としたアプリ(*1)を「パブリックアプリ」とし、アプリ作成時に選択いただきます。
  2. 「プライベートアプリ」を選択した場合、以下のポリシーが適用されます。
    • アプリを利用可能な事業所の上限が5事業所(※2)までになります。
    • アプリをfreeeアプリストアに公開することができなくなります。
  3. 「パブリックアプリ」を選択した場合、以下のポリシーが適用されます。
    • 銀行明細を取得する(※3)場合、セキュリティチェックが必要となります。
    • アプリのサービス内容が金融サービス(※4)に該当する場合、審査が必要となります。これに伴い、freee API利用規約が一部改定されます(第7条-1-5)
    • freeeアプリストア公開時の審査について、セキュリティ基準が強化されます。

変更の適用について

変更後のセキュリティ基準は、アプリタイプが設定されたアプリから順次適用されます。
アプリタイプ選択機能については、リリースされたタイミングで別途お知らせいたします。

作成済みのアプリに関するお願い

アプリタイプ選択機能のリリースされる以前に作成したアプリについて、以下の条件に当てはまる場合は 2020年9月30日 までに「パブリックアプリ」の申請を行なっていただく必要があります。

  • freeeアプリストアに公開中、または公開の予定があるアプリ。
  • freeeアプリストアで作成する開発用テスト事業所を除く、6つ以上の事業所で利用しているアプリ。

「パブリックアプリ」の申請がないアプリについては、アプリタイプ選択機能がリリースされたタイミングで「プライベートアプリ」に設定されます。

なお、開発用テスト事業所で作成したアプリは「パブリックアプリ」を選択できません。

申請は「パブリックアプリ申請フォーム」からお願いいたします。

また、「パブリックアプリ」を選択(申請)した場合、以下2点についてもご確認・ご対応をお願いいたします。

申請の期限は2020年9月30日までです。

作成済みアプリの対応チャート

  • ※1:アプリタイプは一度選択すると変更することができません。アプリタイプについては、「アプリタイプについて」も併せてご参照ください。
  • ※2:freeeアプリストアで作成する開発用テスト事業所を除く、6つ以上の事業所。
  • ※3:「GET /api/1/wallet_txns」または「GET /api/1/wallet_txns/{id}」に対するアクセスのうち、「walletable_type」が「bank_account」または指定なしのもの。
  • ※4:金融サービスの定義については、「金融サービスについて」を参照ください。

改訂履歴

2020年8月21日:
開発用テスト事業所で作成したアプリは「パブリックアプリ」を選択できない旨を追記

会計freeeのWebhook β版をリリース

会計freeeのWebhook β版をリリースしました。会計freeeでWebhook β版を設定すると「申請・承認・却下・差し戻し」の操作が行われた際に、それらの動作を会計freeeと連携した外部のアプリに通知することができます。

Webhook機能テーブル

Webhook β版における制限

以下のようなエラーが発生した場合、Webhook β版利用アプリでのトラブルシューティングに必要な情報を確認することができません。

  • Webhook β版 URLの誤り
  • 上記URLのDNSによる名前解決のエラー
  • 上記URLのサービス側のエラーによる通知失敗
    • サービスのダウン
    • サービスのhttpsポートの異常
  • 上記URLのサービス側のRate Limitによる通信および接続エラー

会計freeeのWebhook β版の詳細

詳細は、「会計Webhook」ドキュメントをご覧ください。