Loading
保險
InsPolicyService:createRenewalPolicy

您位於此處：

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

InsPolicyService:createRenewalPolicy

使用此服務可從現有原則建立續約原則。

類別:InsPolicyService

方法:createRenewalPolicy

運作方式

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

    備註
    備註

    服務會通過 userInputs 來決定重新計算價格的其他等級係數。此外,服務會使用 additionalFields 節點填入原則物件上的其他欄位,這些欄位否則不是此服務的一部分。

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

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

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

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

  4. 服務會使用 includePaymentSchedule 和 includeRevenueSchedule 來判斷是否必須在已續約的原則上建立付款排程和收入排程。如果未指定任何選項,則會從先前的原則繼承相同的設定。

  5. 服務會建立原則並將其標記為已續約原則。

備註
備註

此外,此服務支援原始保單版本的持續期間少於 365 天,或年份內少於 366 天的保單續約。不過,在保單續約時,保單持續期間為 365 天,若為峰年,則為 366 天。請參閱保單的 考量事項與限制。

輸入

輸入

描述

policyId

必要

要續約的原則識別碼。

userInputs

選擇性

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

如果未提供 userInputs,則續約服務會取用現有原則的資訊,並在已續約原則中複製該資訊。

additionalFields

選擇性

非此服務一部分之其他欄位的金鑰值配對。這些欄位會填入原則物件。

遠端選項

備註
備註 InsProductService:repriceProduct 中使用的所有遠端選項也可以與此服務搭配使用。

遠端選項

描述

renewalExpirationDate

選擇性

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

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

renewalEffectiveDate

選擇性

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

現有保單的到期日 + 1 天

如果您使用的是 Insurance Industries Extension 封裝,則會忽略 renewalEffectiveDate 選項中的時間戳記值。而是會將有效日期時間戳記值設定為所選有效日期的凌晨 12:00,並將所選到期日期的到期日期值設定為下午 11:59。時間戳記是使用使用者指定的時區來設定。

aggByKey

必要

PRODUCT.instanceKey

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

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

服務會使用此值重新定價原則。
calculateTaxesAndFees

選擇性。

預設值為 true。

設定為 true 以計算稅額與費用。

createTransaction

選擇性。

True 或 False

預設為 False。

如果為 true,則服務會建立收入排程服務使用的交易。

includeInputKeys

必要

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

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

只有計算程序使用的索引鍵在結果中具有值。

服務使用 includeInputKeys 重新定價原則。

includePaymentSchedule

選擇性

如果為 true,則服務會在已續約原則上建立付款排程。如果未提供值,則只有在原始保單中存在時,服務才會在已續約保單上建立付款排程。

includeRevenueSchedule

選擇性

如果為 true,則服務會針對已續約的原則建立收入排程。如果未提供值,則只有在原始保單中有付款排程時,服務才會在已續約保單上建立付款排程。

paymentCalculationMethod

必要,如果 includePaymentSchedule 的值為 true。

覆寫原則的 Premium Calculation Method 值。

paymentFrequency

如果 includePaymentSchedule 的值為 true,則為必要。

覆寫原則的 PremiumFrequency 值。

paymentType

如果 includePaymentSchedule 的值為 true,則為必要。

覆寫原則的 Premium Payment Type 值。

ratingDate

決定已續約原則定價的等級程序。若未提供,則會根據已續約保單的生效日期完成定價。

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

term

選擇性

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

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
      }
    ],
   "additionalFields": {
      "BillingName": "John Smith",
      "Description": "This is a renewal quote",
      "Phone": "123456789"
    }
}

輸出 JSON

以下是輸出 JSON 的範例:

{
  "snapshotId": [
    "00P5w00001fKlqEEAS"
  ],
  "InsurancePolicy": [
    "0YT5w000000Y8tTGAS"
  ]
  "error": "OK"
}
 
正在載入
Salesforce Help | Article