Loading
保險
InsPolicyService:createRenewalQuote

InsPolicyService:createRenewalQuote

使用此服務為現有原則建立續約報價。

類別:InsPolicyService

方法:createRenewalQuote

運作方式

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

    備註
    備註

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

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

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

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

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

  4. 服務使用輸入中的 OpportunityDetails JSON 節點建立「機會」記錄。請參閱範例輸入 JSON。此節點僅接受以下三個必要欄位:

    • 名稱

    • StageName

    • CloseDate

    備註
    備註 此節點中無法包含其他機會欄位。然而,您可以在產生續約報價後,以其他詳細資料更新機會記錄。
  5. 服務會建立「續約」類型的報價,並將其連結至在上一個步驟中建立的機會記錄。

輸入

輸入

描述

policyId

必要

要續約的原則識別碼。

userInputs

選擇性

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

additionalFields

選擇性

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

opportunityDetails

續約機會的詳細資料,連結至續約報價。如果沒有此節點,則服務會從連結至原始原則來源報價的機會中取用機會詳細資料。

遠端選項

遠端選項

描述

renewalEffectiveDate

選擇性

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

現有保單的到期日 + 1 天

renewalExpirationDate

選擇性

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

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

term

選擇性

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

pricebook

選擇性

指派給 Quote.Pricebook2Id 的 PriceBook2 記錄名稱。預設值為 standard。

aggByKey

必要

PRODUCT.instanceKey

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

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

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

includeInputKeys

必要

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

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

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

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

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"
    }
}

輸出 JSON

續約報價的 quoteId 和 opportunityId。

以下是輸出 JSON 的範例:

{
  "quoteId": "0Q0B0000000A0YEKA0",
  "opportunityId": "006B0000006zdiAIAQ",
}
 
正在載入
Salesforce Help | Article