Loading
保险
InsPolicyService:prepareToRenewPolicy

您在此处：

  1. Salesforce 帮助
  2. 文档
  3. 数字保险

InsPolicyService:prepareToRenewPolicy

使用此服务计算续订现有保单所需的金额。此服务返回续订保费、税费或续订策略 JSON，无需创建策略。

类：InsPolicyService

方法：prepareToRenewPolicy

工作原理

  1. 服务接受要续订的保单的policyId。

  2. 服务会检查续订保单的生效日期和到期日期。如果未提供，服务会使用以下逻辑计算这些日期：

    • 生效日期 = 原始保单的到期日期 + 1 天

    • 到期日期 = 新保单的生效日期 + 新保单的期限

  3. 使用 ⁇ aggByKey 和 includeInputKey 选项重新定价保单产品。

  4. 使用getPolicyJson来确定是否只有续订金额组件必须返回，或者在响应中发送完整的保单 JSON。

输入

输入

描述

policyId

必填

要续订的保单的 ID。

userInputs

可选

与保单关联的产品的详细信息。对于任何产品，可从产品视图的 API 选项卡中的服务列表获取 ⁇ userInputs ⁇ 对象的目标格式。对象密钥的格式为 ⁇ ProductCode.AttributeCode ⁇ ,其中ProductCode包含产品代码、相关承保范围规格、保险项目规格或评级事实。

远程选项

远程选项

描述

aggByKey

必填

PRODUCT.instanceKey

服务将此选项作为输入发送到计算程序，计算程序使用它通过聚合完成计算。

例如，汽车保险单为每个保险车辆附加了多个驾驶员。对于保单中的每个实例，被保险车辆都有一个单独的 instanceKey。aggByKey获取车辆的所有实例密钥，并为每个实例密钥创建一系列保费。此数组会传递到计算程序，以便正确计算保费。

服务使用此选项重新定价保单。

calculateTaxesAndFees

可选

true 或 false

设置为真以计算续订保单的税费。

includeInputKeys

必填

服务传入和传出计算过程的逗号分隔键值对字符串。

这些键值对包含在 ⁇ CalculatedPriceData ⁇ 对象中的输出产品对象中。它们可以帮助您解析计算结果。

服务使用此选项重新定价保单。

getPolicyJson

可选

一个布尔标志，用于确定只有续订金额组件必须在响应中返回，还是必须返回完整的保单 JSON。

ratingDate

确定重新定价保单的评级程序。如果未提供，将根据修改策略的生效日期定价。

备注
备注 您无法为 ratingField 传递特定时间，因为字段类型是日期。因此，评级日期时间戳默认为 12:00 am。

renewalEffectiveDate

可选

续订保单的生效日期。如果未提供，使用以下逻辑计算值：

现有保单的到期日期 ⁇ + 1 天

renewalExpirationDate

可选

续订保单的到期日期。如果未提供，使用以下逻辑设置值：

新保单的生效日期 + 新保单的期限

term

可选

保单的期限。如果远程选项中未提供renewalExpirationDate，则帮助计算。InsPolicyService:prepareToRenewPolicy 仅支持年度保单条款。

useLocalTimezone

真或假

默认值为真。

当值设置为真时，服务会使用创建策略的本地时区。

当该值设置为假时，服务会将 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