【v3対応版】マネーフォワードのクラウド請求書とGoogleスプレッドシートをGASでデータ連携する方法の紹介

Home > TECH BLOG > 【v3対応版】マネーフォワードのクラウド請求書とGoogleスプレッドシートをGASでデータ連携する方法の紹介
公開日:2022年11月6日 更新日:2023年8月17日

記事概要

この記事は、マネーフォワード クラウド請求書 API v3 + GASを使用して、MFクラウド請求書とGoogleスプレッドシートのデータ連携方法を紹介する記事です。事業者情報や請求書一覧をAPIから取得する方法も解説しています。また、連携サンプル用のスプレッドシートも提供いたします。

スプレッドシートとGASの準備

まずは、スプレッドシートとGASを準備いたします。

GASエディタを起動

  1. Googleドライブで、スプレッドシートを新規作成
  1. GASエディタの起動
      • メニュー > 拡張機能 > App Scriptをクリック

マネーフォワード クラウド請求書API連携用のライブラリを追加

  1. ライブラリの "+" をクリック
  1. スクリプトIDに以下入力して検索する
  1. 最新のバージョンを選択
  1. 「追加」ボタンをクリック
  1. 「MfInvoiceApi」というライブラリが追加される
 

MFのClient IDとClient Secretを取得する

次に、MFのアプリポータルからAPI連携に必要なを取得し、GASのスクリプト プロパティに設定します。
  1. MFのアプリポータルのアプリ新規登録画面に遷移
      • アプリ名称: [検証用]MFクライアント
      • リダイレクトURI:
        • 例:スクリプトIDが の場合
        • スクリプトIDは、GASエディタの から取得してください。
      • クライアント認証方式: を選択してください。
  1. アプリ詳細画面のをメモ
  1. GASエディタのプロジェクト設定画面に遷移
  1. スクリプト プロパティにを追加
      • CLIENT_ID: MFアプリポータルの
      • CLIENT_SECRET: MFアプリポータルの

初期設定

  1. GASエディタを起動します。
  1. に以下のコードをコピー&ペーストしてください。
  1. を実行
      • トリガーを自動設定します。
      • このトリガーによってMF請求書API連携用のメニューをスプレッドシートのメニューに追加します。
  1. メニューの表示
      • スプレッドシートの画面を再読み込みしてください。再読み込みすると、スプレッドシートの起動時にトリガーが実行されます。
      • メニューの表示されたらOKです。
ここまでで、スプレッドシートとGASの準備が完了です。
次に、API認証に必要なをMFのアプリポータルから取得します。

マネーフォワード クラウド請求APIへの認証

ここまでで、接続に必要な環境と情報が揃ったので、マネーフォワード クラウド請求APIに認証して接続します。
  1. マネーフォワード クラウド請求APIへの認証処理を開始
      • スプレッドシートメニュ > MF請求書API連携 > 認証処理を開始する
  1. Google権限を許可
  1. を再実行する
  1. マネーフォワード クラウド請求APIのサイトで認証処理を継続する
      • をクリックする
      • URLに認証に必要な情報が記載されています。
      • ここでエラーが発生する場合は、以下、確認してください。
        • リダイレクトURIが間違っていませんか?
          • 認証処理しているGASとMF請求書に登録したリダイレクトURIが不一致の場合があります。
        • クライアント認証方式でを選択しましたか?
          • 初期値だと、 になっているので間違って設定する場合があります。
  1. 認証が成功したことを確認
      • と表示されたら認証完了です

事業者情報をAPIから取得してみよう!

まずは、自分の事業者情報をAPIから取得してみましょう。
リファレンスは以下を参考にしました。
  1. 以下、 にコピー&ペーストしてください。
    1. getMyOffice関数を実行します。
    1. ログで事業者情報が無事に取得できたことを確認します。
        • と表示されたら成功です。
    1. スプレッドシートのに取得したデータが追加されたことを確認します。

    事業者情報のデータ

    上記、 の変数officeには、以下のようなデータが格納されます。
    例えば、name(事業者名) を取得したい場合は、 で取得することができます。
    他のデータに関してもリファレンスを公開してますので、データ例を確認する場合は、以下のページで確認してください。

    請求書一覧をAPIから取得してみよう!

    続けて、請求書一覧をAPIから取得してみましょう。
    リファレンスは以下を参考にしました。
    1. 以下、 にコピー&ペーストしてください。
      1. getBillings関数を実行します。
      1. ログで請求書一覧が無事に取得できたことを確認します。
          • と表示されたら成功です。
      1. スプレッドシートのに取得したデータが追加されたことを確認します。

      請求書のデータ

      上記、 の変数billingsには、以下のようなデータが格納されます。

      その他API(見積書、品目など)のデータ取得方法

      以下、Githubに全てのサンプルコード(実装例)がありますので、そちらを参考にしていただければです。

      完全版のスプレッドシートを提供します!

      今回の記事で紹介した内容の完全版のスプレッドシートで提供します。興味のある方は、以下、「完全版を自分のGoogleドライブにコピーする」よりコピーしてご活用ください。

      まとめ

      マネーフォワード クラウド請求書 API v3 + GASで、MFクラウド請求書とGoogleスプレッドシートのデータ連携方法を紹介いたしましたがいかがだったでしょうか?
      見積書、請求書をスプレッドシートで管理している企業様だと、素早くマネーフォワード クラウド請求書に連携できて便利なので是非、試してみてください。

      [宣伝] GASプログラミング入門の教材 - Udemy

      • 2023年11月時点で、約3,000人の受講生を獲得し、「Udemy Business」に選定されてます。
        • 「Udemy Business」とは、Udemyが「企業研修」向けに提供しているサービスのことです。
        • Udemyで販売している全ての講座の中から、「企業研修」に提供できる高品質な講座をレビューや内容を加味して厳選していることが特徴のサービスです。
        • その「Udemy Business」で、このGAS講座は採用されております。
      • 教材の詳細は、以下のUdemyに記載しておりますので内容ご確認ください
        • 以下のバナーから購入すると、通常、定価27,800円が1,500円に割引される特別クーポンが適用されます!
        • 有効期限は、です。

      関連ブログ