您位於此處:
InsPolicyService:createRenewalQuote
使用此服務為現有原則建立續約報價。
運作方式
-
服務接受要續約的原則
policyId。備註服務會通過
userInputs來決定重新計算價格的其他等級係數。此外,服務會使用additionalFields節點填入報價物件上的其他欄位,這些欄位否則不是此服務的一部分。 -
服務會檢查已續約原則的生效日期與到期日期。若未提供,則服務會使用下列邏輯計算這些日期:
-
有效日期 = 原始保單的到期日期 + 1 天
-
到期日期 = 新原則的生效日期 + 新原則的期限
-
-
使用
aggByKey和includeInputKey選項重新定價保單產品。 -
服務使用輸入中的
OpportunityDetails JSON節點建立「機會」記錄。請參閱範例輸入 JSON。此節點僅接受以下三個必要欄位:-
名稱
-
StageName
-
CloseDate
備註 此節點中無法包含其他機會欄位。然而,您可以在產生續約報價後,以其他詳細資料更新機會記錄。 -
-
服務會建立「續約」類型的報價,並將其連結至在上一個步驟中建立的機會記錄。
輸入
輸入 |
描述 |
|---|---|
|
必要 要續約的原則識別碼。 |
|
選擇性 與原則相關聯的產品詳細資料。針對任何產品, |
|
選擇性 非此服務一部分之其他欄位的金鑰值配對。這些欄位會填入報價物件。 |
|
續約機會的詳細資料,連結至續約報價。如果沒有此節點,則服務會從連結至原始原則來源報價的機會中取用機會詳細資料。 |
遠端選項
遠端選項 |
描述 |
|---|---|
|
選擇性 已續約原則的生效日期。若未提供,則會使用下列邏輯計算值: 現有保單的到期日 + 1 天 |
|
選擇性 已續約原則的到期日。若未提供,則值會使用下列邏輯設定: 新原則生效日期 + 新原則的期限 |
|
選擇性 原則的期限。如果遠端選項未提供,則其可協助計算 |
|
選擇性 指派給 |
|
必要
服務會將此選項作為計算程序的輸入傳送,其會使用此選項來透過彙總完成計算。 例如,汽車保險保單會將多個司機附加至每部受保車輛。受保車輛針對原則中的每個例項有個別的 instanceKey。 服務會使用此選項重新定價原則。 |
|
必要 服務傳入和傳出計算程序的以逗號分隔金鑰-值配對字串。 這些金鑰值配對包含在 只有計算程序使用的索引鍵在結果中具有值。 |
| failOnRatingFailure | 選擇性 指定若等級在續約期間未傳回結果,服務是否應失敗。 若為 true,則服務會停止並傳回錯誤。若為 false,則服務會繼續並建立續約報價,而不會產生評分結果。 |
輸入 JSON
以下是輸入 JSON 的範例:
{
"policyId": "0YT5w000000Y8MNGA0",
"userInputs": [
{
"DRIVER.instanceKey": "Bob Jones",
"DRIVER.LN": "Jones",
"DRIVER.GENDER": "Male",
"DRIVER.FN": "Bobby",
"DRIVER.AGE": 30,
"AUTO.instanceKey": "2018 Audi A3",
"AUTO.autoYear": 2018,
"AUTO.autoModel": "A4",
"perAccident": 500
}
],
"additionalFields": {
"BillingName": "John Smith",
"Description": "This is a renewal quote",
"Phone": "123456789"
},
"OpportunityDetails": {
"Name": "Renewal Opportunity",
"StageName": "Qualification",
"CloseDate": "2023-04-04"
}
}