Loading
保險
InsPolicyService:prepareToRenewPolicy

您位於此處：

  1. Salesforce 說明
  2. 文件
  3. 數位保險

InsPolicyService:prepareToRenewPolicy

使用此服務可計算續約現有原則所需的金額。此服務會傳回續約保費、稅金和費用,或續約原則 JSON,而無須建立原則。

類別:InsPolicyService

方法:prepareToRenewPolicy

運作方式

  1. 服務接受要續約的原則policyId。

  2. 服務會檢查已續約原則的生效日期與到期日期。若未提供,則服務會使用下列邏輯計算這些日期:

    • 有效日期 = 原始保單的到期日期 + 1 天

    • 到期日期 = 新原則的生效日期 + 新原則的期限

  3. 使用 aggByKey 和 includeInputKey 選項重新定價保單產品。

  4. 使用 getPolicyJson 判斷只有續約金額元件必須傳回,還是在回應中傳送完整原則 JSON。

輸入

輸入

描述

policyId

必要

要續約的原則識別碼。

userInputs

選擇性

與原則相關聯的產品詳細資料。針對任何產品,userInputs 物件的目標格式可從產品檢視其 API 索引標籤中的服務清單取得。物件索引鍵的格式為 ProductCode.AttributeCode,其中 ProductCode 為產品代碼、相關聯的涵蓋範圍規格、保險項目規格或等級實情。

遠端選項

遠端選項

描述

aggByKey

必要

PRODUCT.instanceKey

服務會將此選項作為計算程序的輸入傳送,其會使用此選項來透過彙總完成計算。

例如,汽車保險保單會將多個司機附加至每部受保車輛。受保車輛針對原則中的每個例項有個別的 instanceKey。aggByKey 會取得車輛的所有例項金鑰,並為每個 instanceKey 建立涵蓋範圍保費陣列。系統會將此陣列傳遞至計算程序,以正確計算保費。

服務會使用此選項重新定價原則。

calculateTaxesAndFees

選擇性

true 或 false

設定為 true 可計算已續約原則的稅額和費用。

includeInputKeys

必要

服務傳入和傳出計算程序的以逗號分隔金鑰-值配對字串。

這些金鑰值配對包含在 CalculatedPriceData 物件內的輸出產品物件中。他們可以幫助您剖析計算結果。

服務會使用此選項重新定價原則。

getPolicyJson

選擇性

用於判斷只有續約金額元件必須在回應中傳回,還是完整原則 JSON 必須傳回的布林值標記。

ratingDate

決定重新定價原則的等級程序。若未提供,則會根據修改原則的生效日期完成定價。

備註
備註 您無法傳遞 ratingField 的特定時間,因為欄位類型為 Date。因此,等級日期時間戳記預設為 12:00 am。

renewalEffectiveDate

選擇性

已續約原則的生效日期。若未提供,則會使用下列邏輯計算值:

現有保單的到期日 + 1 天

renewalExpirationDate

選擇性

已續約原則的到期日。若未提供,則值會使用下列邏輯設定:

新原則生效日期 + 新原則的期限

term

選擇性

原則的期限。如果遠端選項未提供,則其可協助計算 renewalExpirationDate。InsPolicyService:prepareToRenewPolicy 僅支援年度保單條款。

useLocalTimezone

True 或 False

預設值為 true。

當值設定為 true 時,服務會使用建立原則所在的本機時區。

當值設定為 false 時,服務會使用 GMT 作為時區。

輸入 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
      }
    ]
}

輸出 JSON

以下是輸出 JSON 的範例:

{
  "totalFeeForTermDiff": -0.07,
  "totalTaxForTermDiff": 0,
  "totalPremiumForTermDiff": -2.73,
  "newFeeForTerm": 24.93,
  "newTaxForTerm": 0,
  "newPremiumForTerm": 997.27,
  "newFee": 25,
  "newTax": 0,
  "newStandardPremium": 1000
}
 
正在載入
Salesforce Help | Article