Suica を読み取って Google スプレッドシートに交通費を記入するシステム「にゃーん」を作った話

はじめに

こんにちは、たるこすです。
みなさん、交通費申請していますか？

私が所属している株式会社ホロラボでは、毎月 Google スプレッドシートに１か月分の交通経路と交通費を記入して申請することになっています。
ですが、毎日オフィスに行くわけではないので定期券を持っておらず、オフィスに行った場合も含めて交通費を記入しないといけないため、毎月結構な量になってしまいます。

この作業が面倒だったので、Suica などの交通系 IC カードの履歴を読み取り、自動的に Google スプレッドシートに記入するシステム「にゃーん」を開発しました。

twitter.com

Suica の履歴を読み取って、自動的に Google スプレッドシートに交通費を書き込むシステム「にゃーん」が完成しました！
ソースコードはそのうち公開します🐱 pic.twitter.com/ROuEmKSuFT
— たるこす (@tarukosu) 2018年7月19日

「にゃーん」の仕組み

「にゃーん」の仕組みですが、は大きく分けると以下の2つからなっています。

Suica の履歴を読み取る部分
交通費をスプレッドシートに書き込む部分

Suica の履歴を読み取る部分はえむにわさんのコードを利用させていただきました。

github.com

履歴として読み取れるのは直近20件の利用データです。
このデータに含まれているのは利用金額ではなくその地点での残高のため、前後2件のデータから利用金額を求めています。
また、読み取れる履歴には電車やバスなどの交通費だけでなくチャージやコンビニ等の支払い履歴も含まれていますが、交通費だけのデータだけをスプレッドシートに書き込むようにしています。

交通費を書きこむスプレッドシートは、テンプレートとなるシートを用意しておいてそれを人ごと月ごとにコピーするようにしています。

スプレッドシートに重複してデータを書き込んでしまってはいけないので、履歴データに含まれる ID（履歴ごとに1ずつ増えていく番号）を使ってまだ書き込まれていないデータのみを書き込むようにしています。
どの ID までを書き込んだかという情報は、交通費のシートとは別のスプレッドシートに書き込んでいます。

スプレッドシートへのデータの書き込みは、Google Spread Sheet API を使って行っています。また、フォルダの作成や交通費申請シートのテンプレートのコピーは Google Drive API を使っています。