請求書一覧を取得する

このピースでできること

  • マネーフォワード クラウド請求書で、指定した条件に合致する請求書の一覧を取得します。
  • ページ番号・1ページあたりの取得件数・期間・取引先・ステータスなどで絞り込んで取得できます。

マネーフォワード クラウド請求書 の接続方法

workrun とマネーフォワード クラウド請求書 を接続するには、マネーフォワード クラウド請求書 の OAuth クライアント(クライアントID・クライアントシークレット) が必要です。

ステップ 1:workrun のリダイレクト URL を確認する

  1. workrun でマネーフォワード クラウド請求書 のアクションをフローに追加します。
  1. 「接続を選択」の横にある 「+ 新しい接続」 をクリックします。
  1. 接続画面に表示される 「リダイレクト URL」 をコピーしておきます。

ステップ 2:マネーフォワード クラウド請求書 で OAuth クライアントを作成する

  1. マネーフォワード クラウド アプリポータル で新しいアプリケーションを登録します。
  1. コールバックURL に、ステップ 1 でコピーしたリダイレクト URL を設定します。
  1. クライアント認証方式を 「CLIENT_SECRET_POST」 に指定します。
  1. 登録後に表示される クライアントIDクライアントシークレット をコピーしておきます。
      • 必要な認可スコープ: (請求書データの読み取り)、(請求書データの書き込み)

ステップ 3:workrun に接続を追加する

  1. ステップ 1 の接続画面に戻り、クライアントIDクライアントシークレット をそれぞれ貼り付けます。
  1. 「接続」 をクリックすると、マネーフォワード クラウド請求書 の認証画面が開きます。
  1. マネーフォワード クラウド請求書 にログインし、workrun に対するアクセスを 「許可」 します。
  1. 画面が自動で閉じ、接続が完了します。

ピースの設定項目

1. ページ番号(任意)

  • 取得するページ番号を数値で入力します。未入力の場合は1ページ目から取得します。

2. 1ページあたりの取得件数(任意)

  • 1回のリクエストで取得する件数を数値で入力します。最大100件まで指定できます。

3. 期間絞込対象(任意)

  • 期間開始日・期間終了日と組み合わせて絞り込む対象を選択します。「請求日」「期日」「売上日」「作成日」「更新日」から選べます。

4. 期間開始日(任意)

  • 絞り込みの開始日を入力します。「期間絞込対象」と組み合わせて使用します。

5. 期間終了日(任意)

  • 絞り込みの終了日を入力します。「期間絞込対象」と組み合わせて使用します。

6. 検索文字列(任意)

  • 取引先(完全一致)、ステータス、件名などで検索します。この項目を入力すると、請求書番号・ステータス・取引先名・タグは検索に使用されません。

7. 取引先(任意)

  • ドロップダウンから取引先を選択します。300件を超える場合は「検索文字列」で絞り込んでください。「検索文字列」を指定した場合は使用されません。

8. 請求書番号(任意)

  • 請求書番号で絞り込む場合に入力します。「検索文字列」を指定した場合は使用されません。

9. ステータス(任意)

  • 「下書き」「ロック中」「未ロック」から選択します。「検索文字列」を指定した場合は使用されません。

10. 取引先名(任意)

  • 取引先名で絞り込む場合に入力します。「検索文字列」を指定した場合は使用されません。

11. タグ(任意)

  • タグ名で絞り込む場合に入力します。複数指定する場合はカンマ区切りで入力してください。「検索文字列」を指定した場合は使用されません。