n8nを使って会計freeeのデータをSlackに流してみる、ほぼほぼノンプログラミングで。

n8nとは

フリーでオープンな自動ワークフローツール、だそうです。

https://n8n.io/
https://github.com/n8n-io/n8n

※ JP1を思い出します

手っ取り早く動かす

手元のnodeのバージョンは12.8.0でした。

$ node --version
v12.8.0
$ npx n8n
n8n ready on 0.0.0.0, port 5678
Version: 0.73.1

Editor is now accessible via:
http://localhost:5678/

Press "o" to open in Browser.

ここまで来たら http://localhost:5678/ にアクセスします（もしくは o を押します）

Company情報の取得

APIで会計freeeを使うにはcompany_idを取得する必要があります。
さくっとOAuth2認証をしてCompany情報を取得してみます。

OAuth2認証

右上の Create Node から

http を検索し、 HTTP Requestを選択します。

Authentication は OAuth2 を選択して、 Create New で新しく作ります。

必要な情報を埋めていきます。

項目名	入力値	備考
Credentials Name	freee	ラベルなのでなんでも良い
Authorization URL	https://accounts.secure.freee.co.jp/public_api/authorize
Access Token URL	https://accounts.secure.freee.co.jp/public_api/token
Client ID	xxxxxxxxxxxxxxxxxxxxxxxxxx	ご自身のClient ID
Client Secret	xxxxxxxxxxxxxxxxxxxxxxxxxx	ご自身のClient Secret
Scope		入れなくてもOK
Auth URI Query Parameters		入れなくてOK
Authentication	Body	Headerだと認証で失敗します

アプリストア側のcallback uriは http://localhost:5678/rest/oauth2-credential/callback を指定します。
（OAuth Callback URLに書いてある）

ここまで来たら、 ->] みたいなボタンを押して接続してみましょう。
うまくいくとこんなウィンドウが出てくるので許可します。

ウィンドウに　Got connected. The window can be closed now. と出ればOKです。
ウィンドウを閉じて、Credentialの設定を保存します。

Company情報の取得

URLに https://api.freee.co.jp/api/1/companies と入れて、右上の　Execute Node を押します。

companyの情報が出てきます。
今後はここで取得したcompany_idを使っていきます。

取引情報の取得

今日の取引データを取得してみます。

指定するパラメータは以下のとおりです。

項目	値	備考
Request Method	GET
URL	https://api.freee.co.jp/api/1/deals
Response Format	JSON

Query Parameter

Name	Value	備考
company_id	xxxxxx	先程取得したcompany_id
start_issue_date	2020-07-10	発生日。いったん固定で指定する
end_issue_date	2020-07-10	こちらもいったん固定

ここまで指定したら実行します。
データがあればJSON形式で落ちてきます。

必要なデータだけ取る

収入

https://developer.freee.co.jp/docs/accounting/reference#/Deals/get_deals
API仕様を見ると取引の一覧を取得するのにもいろいろな条件を指定できます。
ここでは収入だけ取得してニヤニヤしようと思います。

Query Parameterに type income を追加します。

Name	Value	備考
company_id	xxxxxx	先程取得したcompany_id
start_issue_date	2020-07-10	発生日。いったん固定で指定する
end_issue_date	2020-07-10	こちらもいったん固定
type	income	収入

発生日

発生日を毎回手で書き換えるのは面倒なので、現在の日付を取得して指定するようにします。

発生日は Function を使います。（ほぼノンプログラミング

こんな感じで、YYYY-MM-DD形式の日付を取得します。

const today = new Date();
const yyyy = today.getFullYear();
const mm = ('' + (today.getMonth() + 1)).padStart(2, '0');
const dd = ('' + today.getDate()).padStart(2, '0');

items[0].json.today = [yyyy, mm, dd].join('-');
return items;

Execute Node すると、大丈夫そうな感じです。

つぎに、 Function から HTTP Request に線を引きます。

HTTP Requestのパラメータ start_issue_date と end_issue_date の値をNodeからの返り値に指定します。

もう一度 Execute Node を押して動くか確認しておくと良いでしょう。

これで、「本日発生した収入」を取得することができました。

Slackに連携

SlackのほうはサクッとOAuth2で接続します。

Execute Nodeをして、n8nからSlackに行けばokです。

合計値の計算

収入が複数ある場合はそれを合算した値を知りたいので、freeeからの出力した値を合計します。

ここでは Function を使ってさくっとやります（ほぼノンプログラミング

freeeの後続にFunctionを追加し、そこで計算します。

items[0].json.total_amount = items[0].json.deals.reduce((x, y) => x.amount + y.amount);

return items;

例によってExecute Nodeをすると合計値が表示されます。

Slackに喋らせる

合計を計算したFunctionとSlackをつないで、 SlackのTextを先程の結果にします。
歯車を押して Add Expression でやると簡単に指定できます。

Current Nodeからたどって、出力したい値を指定し、喋らせたい文字と合わせます。

結果

Startからつなで、下の Execute Workflow を押すと実行されます。

Slack側はこうなります。

発展

毎回Execute Workflowを押すのはかっこよくないので、時間が来たら勝手に起動するようにしたいです。

TriggerからCronを選択します。

あとは実行時刻を指定して、

Cronとつないで、

右上の Active を有効にすればOKです！

あ、ひとつ設定がありました。
Settingから

Timezoneを正しく指定しないとCronで指定した時刻に起動しなくなります

いかがでしたか？

いかがでしたか？
freeeAPIを使うのって結構面倒かなと思うのですが、n8nをつかうことで比較的簡単にデータ連携ができました。
HTTP Requestを受け取れてOAuth2等で認証できるサービスであれば、n8nで連携できるのでぜひいろいろな連携を試していただければと思います。

裏話

こんな感じのfreee用のNodeを作っていたんですが、標準のHTTP Requestで行けそうと気が付いてしまいました。。。

コードはこちら
https://github.com/tamurashingo/n8n/tree/feature/freee