コンテンツまでスキップ
日本語
  • 検索フィールドが空なので、候補はありません。

ワークフローアクション

請求書作成・見積書作成・取引先同期・未入金請求書チェック

応用的な使い方

ワークフローの「アクションの追加」から、請求書の作成・見積書の作成・取引先の同期・未入金の確認を自動で実行できます。

ワークフローアクション

ワークフローのアクション選択で「Sync for MoneyForward」を開いたところ。マネーフォワード クラウドの請求書作成・取引先同期・未入金請求書チェック・見積書作成の4つが並ぶ
取引のワークフローで3つ、会社のワークフローで1つ使えます。
アクション対象できること
マネーフォワード クラウド 請求書作成取引請求書を作る
マネーフォワード クラウド 見積書作成取引見積書を作る
マネーフォワード クラウド 取引先同期会社取引先を連携・作成・同期する
マネーフォワード クラウド 未入金請求書チェック取引未入金を確かめる

場所は、オートメーション>ワークフロー>アクションの追加>Sync for Money Forward のアクションです。入力項目があるのは取引先同期だけです。失敗の分岐は4つで共通です(下の説明)。

「請求書作成」

「取引ワークフローからマネーフォワード クラウド請求書で請求書を自動作成します」と説明が出ます。

  • 商品項目ごとに、今日以降で最初の回を、その回の請求日で作成します。「未登録」なら予定に登録してから作成します。その回が作成済みなら何もせず、次の回を前倒しで作りません。
  • 作成前の確認画面は出ません。請求書の作成が無効のとき、前受請求モードの取引のとき、止めている回があるときは、エラーになります。月間上限に達したときは、今月まだ数えていない取引がエラーになります。同じ月にすでに数えた取引は、上限に達していても止まりません。
  • 同じ取引の請求書をほかの処理が扱っているときは、エラーになります。
出力表示名内容
billing_id請求書ID作成された請求書のID。
billing_number請求書番号請求書の番号。
errorCodeエラーコード失敗の種類。
errorMessageエラーの内容失敗の説明。

「見積書作成」

「取引ワークフローからマネーフォワード クラウド請求書で見積書を自動作成します」と説明が出ます。

  • 見積日は実行日です。日本時間の0:00〜8:59に実行すると、前日の日付になります。有効期限・件名・メモ・備考・明細は、設定画面の「見積書」タブの設定と、取引の商品項目から作られます。
  • 見積書の作成が無効のとき、月間上限に達したとき、取引に会社・商品項目がないときは、エラーになります。同じ実行の再送では、見積書を作り直さず同じ結果を返します。
出力表示名内容
quote_id見積書ID作成された見積書のID。
quote_number見積書番号見積書の番号。
errorCodeエラーコード失敗の種類。
errorMessageエラーの内容失敗の説明。

「取引先同期」

会社のワークフローで、取引先を連携・作成・同期します。入力項目は「同期の向き」(任意)です。

会社の状態動き
連携していない・同じ名前の取引先が1件その取引先と連携する
連携していない・同じ名前の取引先が無い会社の値で取引先を作る
連携していない・同じ名前の取引先が2件以上連携も作成もせず、理由を「処理結果メッセージ」に出す(誤った連携を防ぐため)
連携している「同期の向き」に従って値を書く
  • 「同期の向き」は、「HubSpot → マネーフォワード クラウド」(会社の値で取引先を書き換える。空なら既定)か「マネーフォワード クラウド → HubSpot」(取引先の値のうち、会社と違う項目を会社に書く)です。取引先の空の項目は、設定の「マネーフォワード クラウドで空の項目」に従います。
  • 同じ名前の取引先がほかの会社に連携済みのときは、連携せずに失敗にして理由を返します。同じ会社の取引先をほかの処理が作っているときも、エラーになります。
!
注意

向きを指定しない(入力なしの)既存のワークフローは、連携していない会社は連携か作成、連携している会社は会社の値で取引先を書き換えます。

出力表示名内容
partner_id取引先ID連携・作成された取引先のID。
resolution処理結果連携・作成・何もしなかった、などの結果。
message処理結果メッセージ結果の説明。
matched_count完全一致した取引先数会社名と完全に同じ名前の取引先の数。
is_new_partner新規作成フラグ新しく作ったか。
partner_code取引先コード取引先のコード。
partner_name取引先名取引先の名前。
errorCode・errorMessageエラーコード・エラーの内容失敗の種類と説明。

「未入金請求書チェック」

「取引ワークフローからマネーフォワード クラウド請求書の請求書の未入金を検出します」と説明が出ます。

  • Money Forward の現在の入金ステータスを HubSpot に同期したうえで、入金済み・振込済みになっていない請求書を数えます。
  • 入金状況を取得できなかった請求書が1件でもあると、「未入金なし」とは返さず失敗にします。取得できないまま督促が止まることを防ぐためです。
  • Money Forward に接続していなくてもワークフローは止まりません(未入金なしとして扱われます)。
出力表示名内容
has_unsettled未入金あり未入金の請求書があるか(はい/いいえ)。
unsettled_count未入金件数未入金の請求書の数。
unsettled_billings未入金請求書一覧未入金の請求書の Money Forward の URL を、1行に1件で並べた文字列。
errorCode・errorMessageエラーコード・エラーの内容失敗の種類と説明。

失敗したときの分岐と再実行

失敗したときは、エラーの種類ごとに分岐を作れます。

分岐に出る文意味
入力に誤りがあるため処理できませんでした:{エラーの内容}入力の内容に誤りがある
認証できなかったため処理できませんでした:{エラーの内容}認証できなかった
権限が無いため処理できませんでした:{エラーの内容}権限が足りない
対象が見つからないため処理できませんでした:{エラーの内容}対象が見つからない
接続し直す必要があるため処理できませんでした:{エラーの内容}接続し直す必要がある
処理できませんでした:{エラーの内容}業務のルールで処理できない(会社が紐付いていない、上限に達したなど)
処理が終わったか分かりません。結果を確かめてください:{エラーの内容}処理が終わったか分からない
外部のサービスの回数の上限に達したため処理できませんでした:{エラーの内容}外部のサービスの回数の上限に達した
一時的な問題で処理できませんでした:{エラーの内容}一時的な問題
同じ取引の請求書をほかの処理が扱っているため処理できませんでした:{エラーの内容}同じ取引・会社をほかの処理が扱っている(見積書は「見積書を…」、取引先は「同じ会社の取引先をほかの処理が作っている」)

上のどれにも当たらない失敗は、「処理できませんでした(エラーコード):エラーの内容」と出ます。

!
注意

作成系のアクション(請求書作成・見積書作成・取引先同期)は、HubSpot のワークフローから自動で再実行されません。二重に作られるのを防ぐためです。処理が終わったか分からない場合は、Money Forward 側で結果を確かめてから再実行してください。未入金請求書チェックは再実行しても結果が重複しないので、一時的な失敗のときは再実行されることがあります。