請求書一覧の取得
このピースでできることfreee請求書 の接続方法ステップ 1:workrun のリダイレクト URL を確認するステップ 2:freee請求書 で OAuth クライアントを作成するステップ 3:workrun に接続を追加するピースの設定項目1. 事業所ID(必須)2. 請求書番号(任意)3. 件名(任意)4. 取引先(任意)5. 決済ステータス(任意)6. 取引ステータス(任意)7. 送付ステータス(任意)8. 取消済み(任意)9. 請求日の開始日(任意)10. 請求日の終了日(任意)11. 入金期日の開始日(任意)12. 入金期日の終了日(任意)13. 取得件数(任意)14. オフセット(任意)
このピースでできること
- freee請求書で条件を指定して請求書の一覧を取得します。
- 決済ステータス・取引ステータス・送付ステータス・取消ステータスなど複数の条件で絞り込みができます。
freee請求書 の接続方法
workrun と freee請求書 を接続するには、freee請求書 の OAuth クライアント(クライアントID・クライアントシークレット) が必要です。
ステップ 1:workrun のリダイレクト URL を確認する
- workrun で freee請求書 のアクションをフローに追加します。
- 「接続を選択」の横にある 「+ 新しい接続」 をクリックします。
- 接続画面に表示される 「リダイレクト URL」 をコピーしておきます。
ステップ 2:freee請求書 で OAuth クライアントを作成する
- freeeアプリストア でアプリケーションを登録します。
- コールバック URL に、ステップ 1 でコピーしたリダイレクト URL を追加して保存します。
- 権限設定 で、以下の項目にチェックを入れてください。
- [freee請求書] 見積書・請求書・納品書・領収書: 参照・更新
- [会計] 事業所: 参照(事業所の選択肢取得に使用)
- [会計] 取引先: 参照(取引先の選択肢取得に使用)
- 「カスタムAPI呼び出し」アクションを利用する場合は、そのエンドポイントに対応する権限も追加してください。
- 登録完了後、クライアントID と クライアントシークレット をコピーしておきます。
ステップ 3:workrun に接続を追加する
- ステップ 1 の接続画面に戻り、クライアントID と クライアントシークレット をそれぞれ貼り付けます。
- 「接続」 をクリックすると、freee請求書 の認証画面が開きます。
- freee請求書 にログインし、workrun に対するアクセスを 「許可」 します。
- 画面が自動で閉じ、接続が完了します。
ピースの設定項目
1. 事業所ID(必須)
- 連携するfreee事業所をドロップダウンから選択します。接続情報と紐付いた事業所の一覧が表示されます。
2. 請求書番号(任意)
- 絞り込みたい請求書番号を入力します。freee請求書の一覧画面で確認できます。
3. 件名(任意)
- 絞り込みたい請求書の件名を入力します。
4. 取引先(任意)
- 絞り込みたい取引先をドロップダウンから最大3件まで選択します。取引先が300件を超える場合は一部表示されません。
5. 決済ステータス(任意)
- 絞り込みたい決済ステータスを選択します。「決済待ち」「決済済み」「決済キャンセル」から選択できます。
6. 取引ステータス(任意)
- 絞り込みたい取引ステータスを選択します。「登録済み」「登録待ち」から選択できます。
7. 送付ステータス(任意)
- 絞り込みたい送付ステータスを選択します。「送付済み」「送付待ち」から選択できます。
8. 取消済み(任意)
- 取消済み請求書を絞り込む条件を選択します。「該当する」「該当しない」から選択できます。
9. 請求日の開始日(任意)
- 絞り込む請求日の開始日を入力します。
10. 請求日の終了日(任意)
- 絞り込む請求日の終了日を入力します。
11. 入金期日の開始日(任意)
- 絞り込む入金期日の開始日を入力します。
12. 入金期日の終了日(任意)
- 絞り込む入金期日の終了日を入力します。
13. 取得件数(任意)
- 取得する請求書の件数を入力します。デフォルトは20件、最小1件、最大100件です。
14. オフセット(任意)
- 取得開始位置をオフセット値で指定します。デフォルトは0です。