跳轉到主要內容

概覽

submitRfi mutation 會儲存客戶對未結 RFI 的回答。
  • 當 finalize: true(預設值)時,RFI 會被送交審核並進入 IN_REVIEW 狀態。所有必填問題都必須已回答,可以是在本次呼叫中回答,也可以是先前已儲存的回答。
  • 當 finalize: false 時,只會儲存您傳送的回答,RFI 仍維持 PENDING_DOCUMENTS 狀態,其餘回答可在之後的呼叫中補上。
無論哪種方式,回答都會依據 RFI 的問題進行驗證。

所需權限範圍

請使用與讀取 RFI 時相同的客戶權杖。請參閱誰可以回答 RFI。

基本 mutation 結構

參數

SubmitRfiInput

RfiAnswerInput

每個問題請傳送一個回答。請省略以下項目:
  • isSubmitted: true 的問題(已儲存),
  • SECTION_BREAK 問題,
  • 您已透過 completeRfiPlaidLink 回答的銀行連結與地址問題,除非您改為為這些問題上傳文件。

範例變數

cURL 範例

回應詳細資料

SubmitRfiResponse

成功

驗證失敗

驗證失敗時,本次呼叫中的任何內容都不會被儲存。請修正列出的回答後重新傳送呼叫。

分批儲存

使用 finalize: false 可讓客戶中途離開稍後再回來,或在填寫長表單時逐頁儲存。
已儲存的回答為最終結果。 問題一旦有已儲存的回答,就會被標記為 isSubmitted: true 且無法變更,再次傳送會回傳 ALREADY_SUBMITTED。請僅在客戶確認後才儲存回答。唯一的例外是 Plaid 銀行連結,可由 completeRfiPlaidLink 取代。
  • 分批儲存不會變更 RFI 的狀態,也不會將其送交審核。
  • 必填問題只會在您完成提交時檢查。如果所有必填項目都已儲存,完成提交的呼叫可以只是 { "rfiId": "...", "answers": [] }。
  • 完成提交後,RFI 會變為 IN_REVIEW,之後的呼叫會回傳 RFI_NOT_OPEN。如果 Fluz 需要更多資料,RFI 會帶著新問題回到 PENDING_DOCUMENTS。

條件式問題

visibilityCondition 不成立的問題會被略過:
  • 這些問題不是必填,且
  • 您為這些問題傳送的任何回答都會被忽略,不會有錯誤,也不會儲存任何內容。
可見性會依 ordinal 順序,根據先前的回答判定,並使用已儲存的回答以及同一次呼叫中的回答。請參閱條件式問題。

錯誤代碼

Payload 錯誤

submitRfi 會在 payload 中以 success: false 回傳 RFI 錯誤,而不是放在頂層的 errors 陣列中。

validationErrors 代碼

頂層錯誤

這些錯誤會在 mutation 執行之前,於 errors 陣列中回傳。

最佳實務

  • 先在您的 UI 中驗證。 呼叫之前先檢查格式、選項與必填欄位,讓驗證失敗的情況很少發生。
  • 只完成提交一次。 如有需要,可使用 finalize: false 儲存各頁,並在客戶按下提交時再完成提交。
  • 顯示結果。 進入 IN_REVIEW 後,顯示「審核中」狀態,並停止針對此 RFI 再次提示客戶。

相關頁面

讀取 RFI

問題、已儲存的回答與狀態。

上傳 RFI 文件

取得檔案類問題所需的 fileId 值。

以銀行連結回答

使用 Plaid 回答銀行對帳單與地址證明類問題。

RFI 概覽

狀態、問題類型與完整流程。