概覽
submitRfi mutation 會儲存客戶對未結 RFI 的回答。- 當
finalize: true(預設值)時,RFI 會被送交審核並進入IN_REVIEW狀態。所有必填問題都必須已回答,可以是在本次呼叫中回答,也可以是先前已儲存的回答。 - 當
finalize: false時,只會儲存您傳送的回答,RFI 仍維持PENDING_DOCUMENTS狀態,其餘回答可在之後的呼叫中補上。
所需權限範圍
請使用與讀取 RFI 時相同的客戶權杖。請參閱誰可以回答 RFI。
基本 mutation 結構
參數
SubmitRfiInput
RfiAnswerInput
每個問題請傳送一個回答。請省略以下項目:
isSubmitted: true的問題(已儲存),SECTION_BREAK問題,- 您已透過 completeRfiPlaidLink 回答的銀行連結與地址問題,除非您改為為這些問題上傳文件。
範例變數
cURL 範例
回應詳細資料
SubmitRfiResponse
成功
驗證失敗
分批儲存
使用finalize: false 可讓客戶中途離開稍後再回來,或在填寫長表單時逐頁儲存。
- 分批儲存不會變更 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 概覽
狀態、問題類型與完整流程。