Loading
保险
InsPolicyService:createRenewalQuote

InsPolicyService:createRenewalQuote

使用此服务为现有保单创建续订报价。

类:InsPolicyService

方法:createRenewalQuote

工作原理

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

    备注
    备注

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

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

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

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

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

  4. 服务使用输入中的 ⁇ OpportunityDetails JSON节点创建业务机会记录。请参阅示例输入 JSON。此节点仅接受以下三个必填字段:

    • 名称

    • StageName

    • CloseDate

    备注
    备注 此节点中不能包含其他业务机会字段。但您可以在生成续订报价后使用其他详细信息更新业务机会记录。
  5. 该服务创建类型为“续订”的报价,并将其链接到在上一步中创建的业务机会记录。

输入

输入

描述

policyId

必填

要续订的保单的 ID。

userInputs

可选

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

additionalFields

可选

不属于此服务的其他字段的键值对。这些字段会填充到报价对象中。

opportunityDetails

续订业务机会的详细信息,已链接到续订报价。如果此节点不存在,服务将从链接到原始保单源报价的业务机会中获取业务机会详细信息。

远程选项

远程选项

描述

renewalEffectiveDate

可选

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

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

renewalExpirationDate

可选

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

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

term

可选

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

pricebook

可选

分配给 ⁇ Quote.Pricebook2Id的PriceBook2记录的名称。默认值是标准。

aggByKey

必填

PRODUCT.instanceKey

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

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

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

includeInputKeys

必填

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

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

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

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

failOnRatingFailure

可选

指定如果在续订期间评级未返回结果,服务是否应失败。

为真时,服务停止并返回错误。为假时,服务将继续,并创建没有评级结果的续订报价。

输入 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