Loading
保险
InsPolicyService:createRenewalPolicy

InsPolicyService:createRenewalPolicy

使用此服务从现有策略创建续订策略。

类:InsPolicyService

方法:createRenewalPolicy

工作原理

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

    备注
    备注

    该服务通过userInputs来确定其他评级因素来重新计算价格。此外,服务使用additionalFields节点填充策略对象上的其他字段,否则这些字段不属于此服务。

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

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

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

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

  4. 该服务使用includePaymentSchedule和includeRevenueSchedule来确定是否必须在续订保单上创建付款计划和收入计划。如果未指定选项,则从以前的策略继承相同的设置。

  5. 服务会创建策略,并将其标记为续订策略。

备注
备注

该服务还支持续订持续时间少于 365 天(或闰年少于 366 天)的原始保单版本。但是,在续订时,保单持续时间是 365 天,或者闰年是 366 天。请参阅保险单注意事项和限制。

输入

输入

描述

policyId

必填

要续订的保单的 ID。

userInputs

可选

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

如果未提供用户输入,续订服务会获取现有策略的信息,并将其复制到续订策略中。

additionalFields

可选

不属于此服务的其他字段的键值对。这些字段会在策略对象上填充。

远程选项

备注
备注 InsProductService:repriceProduct 中使用的所有远程选项也可以与此服务一起使用。

远程选项

描述

renewalExpirationDate

可选

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

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

renewalEffectiveDate

可选

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

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

如果您正在使用保险行业扩展软件包,将忽略renewalEffectiveDate选项中的时间戳值。相反,有效日期时间戳值设置为选定有效日期的 12:00 a.m.,过期日期值设置为选定过期日期的 11:59 p.m.。时间戳通过使用用户指定的时区来设置。

aggByKey

必填

PRODUCT.instanceKey

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

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

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

calculateTaxesAndFees

可选。

默认值是 true。

设置为true来计算税费。

createTransaction

可选。

True ⁇ or ⁇ False

默认为 ⁇ False。

如果为真,服务会创建收入计划服务使用的交易。

includeInputKeys

必填

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

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

只有计算程序使用的密钥在结果中具有值。

服务使用 includeInputKeys ⁇ 重新定价保单。

includePaymentSchedule

可选

如果为真,服务将在续订保单上创建付款计划。如果未提供值,服务仅在原始保单中存在时,才会在续订保单上创建付款计划。

includeRevenueSchedule

可选

如果为真,服务将在续订保单上创建收入计划。如果未提供值,服务仅在原始保单中存在时,才会在续订保单上创建付款计划。

paymentCalculationMethod

必填,如果 ⁇ includePaymentSchedule ⁇ 的值是 ⁇ true。

覆盖策略的 ⁇ Premium Calculation Method ⁇ value。

paymentFrequency

如果 ⁇ 的值 includePaymentSchedule ⁇ is ⁇ true,则需要此项。

覆盖策略的 ⁇ PremiumFrequency ⁇ value。

paymentType

如果 ⁇ 的值 includePaymentSchedule ⁇ is ⁇ true,则需要此项。

覆盖策略的 ⁇ Premium Payment Type ⁇ value。

ratingDate

确定续订保单定价的评级程序。如果未提供,则根据续订保单的生效日期定价。

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

term

可选

保单的期限。如果远程选项中未提供renewalExpirationDate,则帮助计算。InsPolicyService:createRenewalPolicy 仅支持年度保单术语。

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

输出 JSON

以下是输出 JSON 的示例:

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