freee API は、クラウド会計・人事労務サービス「freee」のデータを外部システムとつなぐための API だ。仕訳の登録、請求書の管理、経費精算、従業員情報の取得といった操作をプログラムから行える。
自動化で効く場面
最もリターンが大きいのは、売上データの自動仕訳だ。EC サイトや SaaS の決済データを freee 会計に自動で取り込めば、毎月の手入力という単純作業がまるごと消える。人事労務側でも、社内の人事システムと従業員データを同期させれば、入退社のたびに二箇所を更新する手間がなくなる。請求書の作成や経費精算の申請・承認も API 経由で操作でき、社内ツールに組み込みやすい。
設計でつまずきやすい点
仕訳を登録するには、勘定科目・税区分・取引先といったマスタの ID を正しく指定する必要がある。これらは事業所ごとに値が異なるため、連携コードに ID を直書きすると別の事業所では動かない。マスタを API で取得して名前から ID を引く作りにしておくと、移植性と保守性が保てる。OAuth のアクセストークンにも有効期限があり、リフレッシュ処理を組み込んでおかないとバッチが途中で止まる。
前提条件
注意点は、API の利用が freee 本体の有料プラン契約を前提にしていることだ。API だけを単体で使うことはできない。開発者はサンドボックス環境で無料テストできるので、本番契約の前に連携の検証は進められる。API には呼び出し回数の上限もあるため、大量データを一括同期する設計ではバッチ間隔を調整する。
当たり前だが大事なこと
freee API はあくまで freee のためのものだ。他社の会計ソフトはそれぞれ独自の API を持つため、会計ソフトを横断する汎用的な連携基盤を作る用途には使えない。すでに freee を使っている、あるいは導入予定が固まっている前提でこそ価値が出るツールだと考えたい。会計データは決算や税務に直結するため、自動仕訳の連携を組む際は、登録した仕訳を経理担当が後から確認・修正できる運用を必ず残しておきたい。完全な無人化を狙うより、人の目によるチェック工程を前提に設計したほうが、トラブル時の被害を小さく抑えられる。