Loading
保险
InsPolicyService:createOutOfSequencePolicyVersion

您在此处：

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

InsPolicyService:createOutOfSequencePolicyVersion

使用此服务为给定策略启动无序背书。

类：InsPolicyService

方法：createOutOfSequencePolicyVersion

该服务会创建这些无序背书交易：

  • 无序更改/背书：由于背书，保单年度保费的总变化。如果多期限保单受到影响，将为每个期限创建交易。

  • 无序背书：执行背书时付款计划的保费调整。它仅适用于当前期限。付款计划条目日期是无序列在过去日期和当前日期之间有效的当前日期或操作日期。对于未来日期，付款计划条目日期是无序列背书的生效日期。

    重要
    重要 参考保单编号必须在所有保单版本中跨术语填充。

工作原理

  1. 该服务policyId当前策略、无序背书的生效日期和inputKey指定的 JSON。

  2. 如果 createTransaction 是 true，服务会创建类型为 Out-of-Sequence Changed/Endorsed 的无序事务和事务详细信息。

  3. 如果includePaymentSchedule是true，服务会生成或更新付款计划和付款计划条目详细信息。根据为相应paymentCalculationMethod和paymentFrequency选项选择的值执行计算。付款计划遵循现有的付款计划规则：

    • 仅更新未来日期的未付付款计划。

    • 过去的付款计划（不论已付或未付）永远不会更新。

    • 对过期付款和已付付款计划的任何调整都包含在无序列背书交易中。

  4. 该服务将IsPolicyEditLocked字段的值更新为相关保险单版本的true。所有策略版本都被锁定，直到无序背书事务完成。

备注
备注

该服务还支持原始保单版本的持续时间少于 365 天或闰年少于 366 天的无序背书。请参阅保险单注意事项和限制。

支持自定义字段

  • 将保险单对象的自定义字段存储在 OutOfSequenceEndorsementCustomFields 字段集中。

  • 在additionalFields部分，将自定义字段填充为键/值对。请参阅输入 JSON。

  • 使用此 OutOfSequenceEndorsementCustomFields 字段集，以在无序背书期间将自定义数据从取消的保单版本复制到新的保单版本。

远程选项

选项

说明
policyId

必需。

服务根据新的或更新的信息更新的现有策略的 ID。
createContactForParticipants

可选。

true 或 false

默认为 true。

如果false，服务不会创建联系人记录。
createInsuredItemsRelationships

可选。

true 或 false

如果此选项是true，请指定instanceKey > 保险项目之间的parentInstanceKey关系列表。

此选项支持父级 > 子级和父级 > 子级 > 孙级保险项目关系。
createTransaction

可选。

true 或 false

默认为 false。

如果true，服务会创建交易。
effectiveDate

必需。

"YYYY-MM-DD HH:MM:SS" 或 %OmniScriptDataElement%

无序背书更改适用的开始日期。
includePaymentSchedule

可选。

true是否为保单创建或更新付款计划。

默认值是 false。
inputKey

必需。

%theJSONyouneed%

JSON，包含创建或更新策略所需的输入。您可以指定以下其中一个值：

  • postDataCustomClassName

  • postDataDRBundleName

    如果您未指定其中一个选项，该值默认设置为 postDataCustomClassName。
paymentCalculationMethod 如果includePaymentSchedule为真，则为必填项。此选项会覆盖保单的保费计算方法值。
paymentFrequency 如果includePaymentSchedule为真，则为必填项。此选项会覆盖保单的保费频率值。
paymentType 如果includePaymentSchedule为真，则为必填项。此选项会覆盖保单的保费付款类型值。
postDataCustomClassName

可选。

服务用于保存新策略版本的自定义类的名称。

您必须指定此选项或postDataDRBundleName。

默认值是 PostInsurancePolicy。
postDataDRBundleName

可选。

服务用于保存新策略版本的 Omnistudio 数据映射器的名称。

您必须指定此选项或postDataCustomClassName。

  • 如果您未指定，服务会使用默认值 postDataCustomClassName。
transactionType

可选。

如果未为transactionType提供值，则默认设置为 Out-of-Sequence Changed/Endorsed。
term

服务创建的策略期限。

InsPolicyService:createOutOfSequencePolicyVersion 仅支持年度保单术语。

输入 JSON

该服务查找产品 JSON 中指定的inputKey。以下是示例输入 JSON：

"newPolicyJSON": {
  "accountId": "001f400000RrQSrAAN",
  "term": "Annual",
  "productConfigurationDetail": {
    ...
  },
  "insuredItems": {
    ...
  },
  "additionalFields": {
    "vlocity_ins__Type__c": "AUTO",
  },
}

以下是示例选项 JSON：

{
   
    "effectiveDate": "2023-03-01",
    "inputKey": "quotepolicyJson",
    "policyId": "0YT3t000000uUz6GAE",
    "includePaymentSchedule": true,
    "createTransaction": true,
    "paymentFrequency": "Monthly",
    "paymentCalculationMethod": "Modal"
  }

输出 JSON

以下是服务启动无序背书并成功生成作业 ID 时的输出 JSON 示例：

 {
"jobId": "7073t0000BNGivxAQD",
"errorCode": "INVOKE-200",
 "error": "OK"
}

以下是服务返回错误时的示例输出 JSON：

{
"errorCode": "ERROR-CODE",
"error": "error message"
}
 
正在加载
Salesforce Help | Article