支払依頼に含まれる支払明細の取得

このピースでできること

  • マネーフォワード クラウド債務支払で、支払依頼に含まれる支払明細のリストを取得します。
  • 承認ステータス・部門・経費科目・従業員・日付範囲など、複数の条件で絞り込んで取得できます。
  • 最大300件まで自動ページネーションで一括取得できます。

マネーフォワード クラウド債務支払 の接続方法

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

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

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

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

  1. マネーフォワード クラウドにログイン後、画面右上のユーザーメニューから 「個人設定」 を開きます。
  1. 「基本設定」「API連携はこちら」 をクリックします。
  1. 「アプリケーション」 を新規登録します。
  1. 「コールバック URL(https のみ)」 に、ステップ 1 でコピーしたリダイレクト URL を入力します。
  1. 以下のスコープにチェックを入れます。
      • (事業者の設定から、事業者の従業員の設定まで管理できる権限)
      • (ユーザー自身の設定を管理できる権限)
      • (明細の読み書きができる権限)
      • (申請の読み書きができる権限)
      • (連携サービスの管理が出来る権限)
      • (公開リソースを読み込む権限)
      • ※「カスタム API 呼び出し」アクションで他の API を使用する場合は、対応するスコープも追加してください
  1. 「Confidential」 にチェックを入れてアプリケーションを作成します。
  1. 作成後に表示される クライアント ID(アプリケーションID)クライアントシークレット(シークレット) をコピーしておきます。

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

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

ピースの設定項目

1. 事業者(必須)

  • 支払明細を取得する対象の事業者を選択します。
  • 認証情報(接続)を設定すると、アクセス可能な事業者の一覧がドロップダウンに表示されます。

2. 支払先 ID(任意)

  • 特定の支払先に絞って取得する場合に入力します。
  • 管理画面 > 取引先 > 支払先 で対象行の「詳細」ボタンをクリックした遷移先 URL の末尾から確認できます。
  • 例:

3. 支払明細番号(完全一致)(任意)

  • 特定の支払明細番号(AP プレフィックスなしの数字部分)で完全一致検索します。

4. 支払明細番号(下限)(任意)

  • 指定番号以上の支払明細を取得します。

5. 支払明細番号(上限)(任意)

  • 指定番号以下の支払明細を取得します。

6. 部門(任意)

  • 特定の部門に絞って取得する場合に選択します。事業者を選択すると選択肢が表示されます。

7. プロジェクト(任意)

  • 特定のプロジェクトに絞って取得する場合に選択します。事業者を選択すると選択肢が表示されます。

8. 経費科目(任意)

  • 特定の経費科目に絞って取得する場合に選択します。事業者を選択すると選択肢が表示されます。

9. 従業員(任意)

  • 特定の従業員に絞って取得する場合に選択します。事業者を選択すると選択肢が表示されます。

10. 申請の承認日時(下限)(任意)

  • 指定日時以降に承認された支払明細を取得します。

11. 申請の承認日時(上限)(任意)

  • 指定日時より前に承認された支払明細を取得します(未満で判定)。

12. 費用計上日(下限)(任意)

  • 指定日以降の費用計上日を持つ支払明細を取得します。

13. 費用計上日(上限)(任意)

  • 指定日以前の費用計上日を持つ支払明細を取得します(以前で判定)。

14. 支払明細の更新日時(下限)(任意)

  • 指定日時以降に更新された支払明細を取得します。差分取得に活用できます。

15. 支払明細の更新日時(上限)(任意)

  • 指定日時より前に更新された支払明細を取得します(未満で判定)。

16. 申請ステータス(任意)

  • 申請ステータスで絞り込みます。選択肢: 全て / 未申請 / 申請済 / 承認済

17. 並び順(任意)

  • 取得結果の並び順を指定します。
  • 選択肢: 支払明細ID昇順 / 降順 / 更新日昇順 / 降順 / 承認時刻昇順 / 降順

18. 取得最大件数(任意)

  • ページを跨いで取得する累計件数の上限を指定します。最大300件まで指定できます。
  • 未入力の場合はデフォルト値の300件が使用されます。