はじめに

ETLツールのTROCCOを開発するprimeNumberでは「あらゆるデータを、ビジネスの力に変える」をミッションに掲げており、TROCCOの対応するコネクタも非常に豊富で、日々進化をし続けています。
対応するコネクタの種類もクラウドサービスから広告データやMAツールまで幅広い領域のデータを扱っています。(対応コネクタはこちらをご参照ください)

そして先日、「freee会計」がコネクタとして追加されました！
プレスリリースも2024年12月10日に発表されております。

freee会計は導入している企業数も非常に多く、データを活用して財務分析をしたい方も多くいらっしゃるかと思います。そのためエンジニアだけでなく、より多くの人に需要の高いツールなのでは？と筆者自身考えています。

そんな、ビジネスの様々な場面で使われているfreee会計のデータを、先んじて検証したいと考え、記事にしようと考えました。

今回はfreee会計のデータを活用するべく、TROCCOでの転送設定のやり方についてご紹介したいと思います。

対象の読者

freee会計のデータ使って会社の財務分析をやりたい方
TROCCOを使ってfreee会計のデータを取得したい方

事前準備

開発テスト環境を作成する

記事発信で社内の会計データを晒すのは....と筆者自身腰が引けてしまいました。汗

でもfreee会計には「開発テスト環境アプリ」というのが存在し、「freeeAPIスタートガイド」の方に準拠していけば作成が可能です。
開発テスト環境アプリでは、APIを利用するにあたっての権限も付与されている状態です。
今回はこちらを活用し、転送設定を行います。

実際の会計データを使いたい方は、この章をスキップして問題ありません。
ただし、取得したいデータが、TROCCOで転送するのに十分な権限が付与されているかを予めご確認ください。
権限周りについては、「freee developer community公式権限とエラー」などを参考にしてください。

freee会計のアプリ認証でTROCCOを登録する

次にfreee会計のアプリとTROCCOを接続させます。
TROCCOの「接続情報一覧>接続情報の新規作成(サービス選択)」からfreee会計情報を選択し、接続情報の設定を行います。

freee会計アカウントの「会計アカウント認証」ボタンを押下し、下記画面に飛び、「許可する」を押します。

許可をした後、認証時間が付与されるためこれでTROCCO側との認証がうまくできました。

転送設定

では実際の転送設定に移ります。
財務分析で必要な会計項目を取得するには、以下2つのステップが必要になります。

会計項目の取得で必須となる事業所IDの取得
事業所IDのデータを使って、各種会計項目を取得
- 今回の記事では貸借対照表を取得

そのため、本記事ではそれぞれに対してTROCCOの転送設定を設けました。

事業所IDの取得

会計項目を取得するために、必ず「事業所ID」の情報が必要になります。
そのため、事業所IDを取得するための、TROCCOの転送設定を行います。

では、転送設定に移ります。
以下のように転送元と転送先を選択します。

転送元: freee会計
転送先: 任意の場所（今回はBigQueryで転送先設定を行います）

次に転送先freee会計の情報を設定します。
以下のように事前準備で設定した「freee会計接続情報」を選び、取得対象には「事業所一覧」を選びます。

転送先BigQueryは以下のように、「接続情報」「データセット」「テーブル」「データセットのロケーション」を選択します。

BigQueryの接続情報等の詳細な設定方法について、今回の記事では割愛します。
詳しい設定方法が知りたい方は、筆者の過去記事を参考してください。
TROCCOの転送(先)の設定方法について、BigQueryとDatabricksで取り上げておりますので、適宜ご確認ください。

BigQuery:
https://qiita.com/wakama1994/items/0e586a0954dd0f4f1f2d
Databricks:
https://qiita.com/wakama1994/items/17be09bb78165cefae11

Step2に移ると、「各種会計項目」で使う事業所id(カラム名)が確認で見ます。

こちらからも確認はできますが、今回は念の為転送できたかどうかも確認したいため、BigQuery上からも確認を行います。

事業所IDのデータを使って、各種会計項目を取得

では、いよいよ各種会計項目のデータ取得に移ります。
TROCCOから取得できる会計項目は、事業所一覧も含め、下記画像の通りとなります。

引用元 : freeeアプリストア公式「TROCCO® × freee会計」より

今回は例として、「貸借対照表」のデータを取得したいと思います。

では、転送設定に移ります。事業所IDと同様に、転送元と転送先を以下で選択します。

転送元: freee会計
転送先: 任意の場所（今回はBigQueryで転送先設定を行います）

freee会計の接続情報を設定したのち、取得項目には「貸借対照表」を選び、先ほどBigQueryに転送した事業所IDを記載します。

貸借対照表の場合、勘定科目が必須のため「勘定科目」か「決算書表示」のいずれかを選びます。
それ以外の項目は任意のため、ご自身の環境に合わせて設定してください。

その他の会計項目の詳細と必要なパラメーターに関しては、TROCCO公式ドキュメントに添付されている、「freee Developers Community - 会計APIリファレンス」をご確認ください。

次に転送先BigQueryの設定を行います。
「事業所IDの取得」の場合と同じように設定を行います。

STEP2でカラム名やデータ定義に問題ないか？を確認し、実際の転送を実行します。

転送実行後、BigQueryにデータ転送がされていれば、これでfreee会計の貸借対照表がBigQueryで使えるようになります！

応用例:ワークフロー機能で、各種会計項目を取得する

「事業所IDのデータ取得」の転送設定を使い、貸借対照表のデータ取得を行いました。

ただ、紹介したものだと、事業所IDをどこかにメモして、貸借対照表のデータを取得する必要があります。

よりシームレスな連携をするにあたり、応用例としてTROCCOのワークフロー機能を使った応用例も紹介します。

まず、ワークフローの流れとして「事業所IDが取れる転送設定」＞「貸借対照表が取れる転送設定」の順で設定します。

次に、「貸借対照表が取れる転送設定」内の「事業所ID」には下記のようにカスタム変数を用います。

次にワークフロー内で、カスタム変数が実行されるようにします。
今回は「事業所IDが取れる転送設定」でBigQueryに送ったテーブルを用いて、事業所ID以外の項目で事前にわかっているものを絞って特定させます。

今回は見本で、既に事業所IDの一覧テーブルをBigQueryに転送した状態でクエリを書いていますが、転送が済んでいない場合は上記SQLでの処置はエラーになる可能性があります。

最後にワークフローを実行すると、事業所IDの情報を「貸借対照表が取れる転送設定」に受け渡し、貸借対照表のデータをとることができます。

ワークフロー機能を用いることは、定期的に更新される会計データを取得する際に役立ちます。
また複数同時に会計項目を取りたい場合も、毎回転送設定する手間が省けます。

freee会計のデータを用いて財務リスク分析する際に、ぜひこの機能を活用ください。

まとめ

今回は、TROCCOのコネクタとして開通されたばかりの、freee会計の転送設定について取り上げました。
freee会計のデータ取得には、「事業所IDのデータ取得」と「事業所IDから各種会計項目の取得」の２種類の転送設定が必要となります。
その応用的な活用として、TROCCOのワークフローを使って、「事業所IDの取得→取得した事業所IDから各種会計データの取得」を行いました。

freeeで会計データを管理されている方に、この記事を通じて、freeeのデータをより身近に感じてもらえることを願ってやみません。

補足

今回紹介した、freee会計のコネクタについては、あくまで2024年12月10日現在で設定できるものとなっています。
機能も順次アップデートがありますのでTROCCOの公式ドキュメントを適宜ご確認頂ければ幸いです。