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