メインコンテンツへスキップ
見出し画像

【MFクラウド会計】APIで仕訳を登録してみよう!【実践的チュートリアル】

  • 割引あり

はじめに:本システムが目指す「運用しやすさ」の形

前回の記事では、マネーフォワードAPIを利用するための準備として「認証」について解説しました。
※この記事は、前回の設定が完了していることを前提に進めていきます。未読の方はまずこちらをご覧ください。

注意⚠️(2026/3/29 追記)
前回の記事ではスプレッドシートとのリンクをIDを介して行っていましたが、今回はわかりやすさを重視するためスプレッドシートの拡張機能からGoogle App Scriptを開く形で紐づけることを想定しています。
スタンドアロン形式でGoogle App Scriptを立ち上げられている方はご注意ください

本記事では、Google Apps Script(GAS)を使って「最新のマスタデータを取得する」「スプレッドシートから仕訳を登録する」という一連の仕組みを、どのように構築・設定していくかを解説します。

この仕組みを設計する上で、この記事はチュートリアルではあるものの、工夫次第で使ってほしいという気持ちもあったので、特に意識したのが「プログラムを極力シンプルに保ち、後からの変更を楽にする」ことです。そのために、以下の2つの工夫を取り入れています。

  1. 「全件上書き」で複雑さを排除: データの更新があった場所だけを特定して書き換えるのではなく、APIから取得した最新データをシートに「まるごと一括で貼り付ける」仕組みにしています。これにより、プログラムの動きが単純になり、データのズレも起こりにくくなります。

  2. 「設定リスト」でコードを触らずに保守: 「どの項目をどの列に並べるか」といった各データの仕様を、プログラムの冒頭に「設定リスト(変数)」としてまとめています。新しいマスタ(取引先など)を増やしたいときも、プログラムの中身(ロジック)を書き換える必要はありません。このリストに数行追加するだけで、誰でも簡単にシステムを拡張・維持できるようにしています。

実際に動くスクリプトは記事の最後にオマケとしてつけています!
※有料記事区間になっていますが、Xのポストをリポストすることで無料で見れるようにしています。

システムの全体像とデータフロー

まずは、このシステムがどのように動いているのか、視覚的に確認してみましょう。

システム構成図

UI(メニュー)、業務ロジック(マスタ同期・仕訳登録)、通信基盤(API接続)の役割をきれいに分けることで、どこで何が行われているかが一目でわかるようにしています。

保守性と拡張性を重視したファイル分割の意図

本システムを構成する5つのファイルは、それぞれが明確な役割(関心の分離)を持っています。

この設計により、例えばAPIの仕様が変更された場合には通信部分のファイルのみを改修し、画面の使い勝手を変えたい場合は画面制御のファイルのみを改修するといった、影響範囲を限定した安全なアップデートが可能となります。

  • Auth.gs: マネーフォワードへのアクセス権を取得するための認証処理を専門に担当します。セキュリティに関わる設定はすべてここに集約されています。※前の記事参照

  • ApiClient.gs: マネーフォワードのAPIサーバーに対するデータの要求(取得)や送信を実行する通信の基盤です。すべての外部通信は必ずこのファイルを経由する設計としています。

  • MasterData.gs: 勘定科目や部門などの設定データをマネーフォワードから一括で取得し、スプレッドシートに出力します。データのマッピング(変換)ロジックを保持しています。

  • UI.gs: スプレッドシートの上部に独自のメニューを追加し、操作画面や確認のポップアップを表示します。ユーザーとシステムの間の対話(インターフェース)を制御します。

  • Journals.gs: スプレッドシートに入力された仕訳データを検証し、マネーフォワードへ登録します。業務ロジックと厳格なデータチェック(バリデーション)の中核を担います。

システムアーキテクチャ図

以下は、本システムの全体構成と各スクリプトの相互関係を示した図です。UI(フロントエンド)、業務ロジック、通信基盤がきれいに分離されていることがわかります。

画像

データ処理の実行フロー(仕訳登録の例)

また、実際の業務フロー(仕訳データの登録)におけるシステム間のデータ連携と処理の順序は以下のようになります。多段の検証を経てから安全にAPIへ送信される流れが設計のポイントです。

画像


導入とセットアップの4ステップ

ソースコードを貼り付けた後、実際に動かすための手順と、それぞれのステップで注意すべき重要ポイントを解説します。

Step 1: 認証情報の紐付け(Auth.gs)

まず、システムがマネーフォワードと安全に通信できるように設定します。

  • Client IDの設定: Auth.gs の冒頭にある変数に、発行されたIDを入力します。

  • シークレットの保存: セキュリティ上の理由から、Client Secretはコードに直接書かず、GASの「スクリプトプロパティ」に保存します(エディタ左側の歯車アイコンから設定できます)。

【注意:最小権限の原則(スコープについて)】
Auth.gs では、APIで「何ができるか」の範囲(スコープ)を定義しています。 ここでの鉄則は、権限を最小限に絞ることです。
例えば、仕訳の登録だけが必要なら、不要な「取引先の登録権限」や「明細の作成権限」などは付与すべきではありません。万が一の漏洩リスクを抑えるためにも、業務に必要な最小限の権限だけを選択するよう設定リストを調整しましょう。

前回の記事とはAuth.gsのSCOPES_ARRAY変数が以下のような感じで変わっています。いくつかの行がコメント外れていると思います。

const SCOPES_ARRAY = [
  // 'mfc/accounting/offices.read',           // 事業者情報の取得
  'mfc/accounting/accounts.read',             // 勘定科目の参照、補助科目の参照
  'mfc/accounting/departments.read',       // 部門の参照
  // 'mfc/accounting/journal.read',           // 仕訳の参照
  'mfc/accounting/journal.write',          // 仕訳の登録、更新、削除
  // 'mfc/accounting/voucher.write',          // 証憑の登録、削除
  // 'mfc/accounting/report.read',            // 帳票の参照
  'mfc/accounting/taxes.read',             // 税の参照
  'mfc/accounting/trade_partners.read',    // 取引先の参照
  // 'mfc/accounting/trade_partners.write',   // 取引先の登録
  // 'mfc/accounting/connected_account.read', // 連携サービスの参照
  // 'mfc/accounting/transaction.write'       // 明細の作成、更新
];

Step 2: 連携の許可と自動ログイン(UI.gs)

設定ができたら、スプレッドシートの画面から「連携の承認」を行います。

画像
  • スプレッドシートを更新すると表示される「MF設定」メニューから「API連携の認証」を実行します。※すでに前回の記事で認証している場合には、一度認証情報の初期化を行ってください。

  • 認証するためのURLがモーダルで表示されると思いますが、その画面は認証URL側で許可を出すと、ポーリングという技術により、承認完了をシステムが自動検知して画面を閉じます。手動で「完了しました」と入力する手間を省いた、少しユーザーに優しい設計にしています。

Step 3: マスタ情報の同期(MasterData.gs)

仕訳を入力するための準備として、最新の勘定科目などを取り込みます。

  • 「マスタ情報の同期」を実行すると、設定されたすべてのデータが一括でコピペされます。

  • ここがポイント!: 前述の通り、このファイルには「どのデータをどう並べるか」という設定リスト(変数)があります。将来的に新しいマスタデータを管理したくなっても、このリストに項目を書き足すだけで、同期処理を簡単に拡張・保守できます。

Step 4: 仕訳入力シートの準備(Journals.gs)

最後に、データを入力する場所を用意します。

setupJournalSheet という関数を一度だけ実行してください。入力ミスを防ぐための列固定や色付けが施された専用シートが作成されます。

実践:仕訳を試しに入れてみましょう!

セットアップが終わったら、実際に「仕訳入力」シートにデータを入力して動かしてみましょう。本システムは、送信前にGASが自動で「入力内容の正しさ」をチェックしてくれます。

1. 様々なケースを入力してみる

まずは「最小限の項目」や「補助科目付き」、あるいは「あえて間違えた名前」など、いくつかのパターンを入力してみます。

画像

ここがポイント:空欄や省略時の挙動

  • 税区分・補助科目を空欄にした場合: マネーフォワード側の科目で設定されている「標準設定」が適用されます。「まずはシンプルに登録したい」というときは、無理にすべて埋める必要はありません。

  • マスタにない名称を入れた場合: 例えば「現金」を「げんきん」と入力したり、マスタと少しでも違う税区分を入力すると、GASが送信前にエラーを検知してくれます。

    • 【重要】税区分の名称について: マネーフォワードのマスタには「正式名称(例:課税売上 10%)」と「省略名(例:課売 10%)」がありますが、この仕組みでは「正式名称」で照合を行う仕様になっています。省略名を入力するとエラーになるため、入力の際はマスタシートの正式名称を使用してください。※あくまでAPI側にはIDで送信されているので、どの情報を使ってそのIDを検索するか?の話です。

2. 登録実行とエラーチェックの結果

メニューの「MF業務」→「📝 仕訳データの登録」をクリックすると、以下のように結果が色分けされます。

画像
  • 背景が緑色(送信済): 無事にマネーフォワードへ登録されました。右端に「仕訳ID」が記録されます。

  • 背景が赤色(エラー): マスタに存在しない名称や、APIが受け付けられないデータ(マイナス金額など)が含まれている場合です。

    • 右端の「API応答ログ」を確認すると、「『げんきん』がマスタに存在しません」といった具体的な理由が表示されるので、修正が非常に簡単です。

例えば、CSVではマイナスは貸借を反対にして登録されますが、API経由の場合マイナスは受け付けられないので、注意が必要です。※必要に応じて、GAS側の事前処理で貸借を反対にすることはできます。

3. マネーフォワード会計での最終確認

最後に、マネーフォワード クラウド会計の「仕訳帳」画面を確認してみましょう。

画像

成功したデータが正しく並んでいるはずです。 取引日の下に 「外部連携(API)」 という緑色のバッジがついているのが、本システムを通じて正確にデータが送られた証拠です。

まとめ:API連携が拓く業務自動化の可能性

ここまでお疲れ様でした!これで「最新のマスタを取得し、スプレッドシートからAPI経由で仕訳を登録する」という仕組みが完成しました。

今回の仕組みの最大のメリットは、「データの入り口」を自由に選べるようになることです。 今回はスプレッドシートへ手入力を前提としましたが、例えば他の販売管理システムや決済サービスのデータを、今回作成した「仕訳入力」シートの形に整形さえしてしまえば、あらゆる情報をボタン一つでマネーフォワードへ送り込むことができるようになります。

これまでのチュートリアル編は今回で終了です。

今後、この基盤をベースにして、さらに現場の課題を解決するための「より実践的な活用・カスタマイズ方法」を投稿していく予定です。ぜひ、ご自身の環境に合わせた自動化の第一歩として活用してみてください。

【ソースコード】コピー&ペースト用エリア

ここからは実際に使用する5つのスクリプトファイルを公開します。 ※これ以降は有料区間(またはリポスト無料)となります。

各ファイルをGASエディタで作成し、中身をそのまま貼り付けてください。

Auth.gs(前回とほぼ同じスコープだけ変更)

2026/03/31更新:認証方式に合わせた形に変更しております。
CLIENT_SECRET_BASICの場合:headerとしてSECRETを送る
CLIENT_SECRET_POSTの場合:setClientSecretとしてSECRETを送る

// ==========================================
// Auth.gs: 認証(OAuth2)に関する設定と処理
// ==========================================

// ------------------------------------------
// ▼ 設定エリア(ここだけ変更すればOK!)
// ------------------------------------------

// 1. クライアントIDの設定
// TODO: マネーフォワードで発行されたClient IDに書き換えてください。
const CLIENT_ID = '******************';

// 2. 利用するAPIのスコープ(権限)設定
// 必要な機能の先頭にある「//」を消す(コメントアウトを解除する)と有効になります。
//
// 【重要】スコープ(権限)のコメントアウトを変更した際の注意点
// マネーフォワード側が古い権限を記憶しているため、設定を変更した後は
// 取得済みの古いカギを破棄して「再認証」を行う必要があります。
// 必ず以下の手順でもう一度関数を実行してください:
//   1. 関数 resetAuth を実行する(古い認証情報をリセット)
//   2. 関数 logRedirectUriAndAuthUrl を実行する
//   3. ログに出たURLにブラウザでアクセスして、新しい権限で「許可」を出し直す
const SCOPES_ARRAY = [
  // 'mfc/accounting/offices.read',           // 事業者情報の取得
  'mfc/accounting/accounts.read',             // 勘定科目の参照、補助科目の参照
  'mfc/accounting/departments.read',       // 部門の参照
  // 'mfc/accounting/journal.read',           // 仕訳の参照
  'mfc/accounting/journal.write',          // 仕訳の登録、更新、削除
  // 'mfc/accounting/voucher.write',          // 証憑の登録、削除
  // 'mfc/accounting/report.read',            // 帳票の参照
  'mfc/accounting/taxes.read',             // 税の参照
  'mfc/accounting/trade_partners.read',    // 取引先の参照
  // 'mfc/accounting/trade_partners.write',   // 取引先の登録
  // 'mfc/accounting/connected_account.read', // 連携サービスの参照
  // 'mfc/accounting/transaction.write'       // 明細の作成、更新
];

// 有効にした配列をスペース区切りの文字列に結合
const SCOPES_STRING = SCOPES_ARRAY.join(' ');

// 3. スクリプトプロパティからClient Secretを取得
const CLIENT_SECRET = PropertiesService.getScriptProperties().getProperty('CLIENT_SECRET');


// ------------------------------------------
// ▼ システム処理エリア(基本いじらなくてOK)
// ------------------------------------------

/**
 * OAuth2 認証サービスの設定
 */
function getMoneyForwardService() {
  return OAuth2.createService('MoneyForward')
    .setAuthorizationBaseUrl('https://api.biz.moneyforward.com/authorize') 
    .setTokenUrl('https://api.biz.moneyforward.com/token') 
    .setClientId(CLIENT_ID)
    // ▼ アプリポータルでクライアント認証方式をCLIENT_SECRET_POSTにしている場合に有効にする
    // .setClientSecret(CLIENT_SECRET)
    .setCallbackFunction('authCallback')
    .setPropertyStore(PropertiesService.getUserProperties())
    .setScope(SCOPES_STRING)
    // ▼ Basic認証用のヘッダー(アプリポータルでクライアント認証方式をCLIENT_SECRET_BASICにしている場合に有効にする)
    .setTokenHeaders({
      'Authorization': 'Basic ' + Utilities.base64Encode(CLIENT_ID + ':' + CLIENT_SECRET)
    });
}

/**
 * 認証用URLとリダイレクトURIを出力する関数(最初に実行)
 */
function logRedirectUriAndAuthUrl() {
  const service = getMoneyForwardService();
  
  Logger.log('【重要】以下のリダイレクトURIをマネーフォワードのアプリ設定に登録してください:');
  Logger.log(service.getRedirectUri());
  
  if (!service.hasAccess()) {
    Logger.log('--------------------------------');
    Logger.log('以下のURLをブラウザで開いて、マネーフォワードの認証を許可してください:');
    Logger.log(service.getAuthorizationUrl());
  } else {
    Logger.log('既に認証済みです。APIを実行できます。');
    Logger.log('※もしスコープを変更した場合は、一度 resetAuth() を実行してから再認証してください。');
  }
}

/**
 * 認証完了後にマネーフォワードからリダイレクトされるコールバック関数
 */
function authCallback(request) {
  const service = getMoneyForwardService();
  const authorized = service.handleCallback(request);
  if (authorized) {
    return HtmlService.createHtmlOutput('認証が成功しました!このタブを閉じてGASエディタに戻ってください。');
  } else {
    return HtmlService.createHtmlOutput('認証に失敗しました。設定を確認してください。');
  }
}

/**
 * 認証情報をリセットしたい場合に実行する関数
 */
function resetAuth() {
  getMoneyForwardService().reset();
  Logger.log('認証情報をリセットしました。スコープを変更した場合は、再度 logRedirectUriAndAuthUrl を実行してください。');
}

MasterData.gs

 
 
会計事務所や税理士事務所の視点から生成AIの活用に関して様々な視点から情報を提供していきます。#推しはGemini

あなたへのおすすめ