InsPolicyService:createUpdatePolicy

此服务可与 Salesforce Financial Services Cloud 一起使用，以获得可选付款计划创建支持。

类：InsPolicyService

方法：createUpdatePolicy

工作方式

1. 该服务会搜索输入的 JSON，以查找inputKey。inputKey节点包含服务创建或更新策略所需的信息。此服务需要的信息包括：

   • accountId

   • term

   • productConfigurationDetail记录

   • insuredItems记录（可选）

   • endDate

   • effectiveDate

2. 创建保单（资产）对象。

3. 如果保单的现有付款计划，服务将返回错误消息。

4. 如果有初始付款，将创建 InsurancePolicyTransaction。除了创建事务之外，事务细分数据会填充到事务详细信息对象中。此对象存储有关每个资产、参与者或承保范围在保费、税和费用方面对交易总额的贡献率的数据。仅显示保费、税或费用至少有一个值大于零的资产、参与者和承保范围。您必须将交易详细信息对象添加到交易的相关列表。

5. 如果保存付款计划，记录将链接到保单的原始保单 ID。

6. 如果输入 JSON 中存在taxesAndfees、taxAmount 和/或feeAmount节点，则会创建税和/或费用记录。

7. 如果服务未通过assetId，则返回输出 JSON 中的策略 ID。

   如果服务在输入 JSON 中传递assetId，它会更新assetId指定的资产。

8. 如果calculateCommission=true：服务调用 InsurancePolicyService.calculateAndSaveCommission，这将为InsCommissionService.calculate和InsCommissionService.saveCommissions服务准备输入。计算服务处理输入后，保存服务会将计算值存储在 TotalCommissionAmount 中。

   • 服务调用InsurancePolicyService.calculateAndSaveCommission，为InsCommissionService.calculate和InsCommissionService.saveCommissions服务准备输入。

   • 佣金类型(例如佣金或奖金)作为commissionType传递给InsCommissionService.saveCommissions服务。

   • 佣金状态(例如，放弃或已付款)会作为commissionStatus传递给InsCommissionService.saveCommissions服务。

   计算服务处理输入后，保存服务会将计算值存储在 TotalCommissionAmount 中。

备注 endDate和effectiveDate决定保单持续时间。第一个保单版本的持续时间可以少于 365 天，也可以在闰年少于 366 天。请参阅保险单注意事项和限制。

税费

如果使用税费，以下是此服务的工作方式：

• 如果在 JSON 记录上指定了taxesAndFees字段，则taxesAndFees列表中的每个项目都会保留相应的AssetPricingAdjustment__c记录。

• 如果在 JSON 记录上指定了taxAmount字段，则TaxAmount__c字段将设置为创建的AssetItem上的 taxAmount 字段的值。

• 如果在 JSON 记录上指定了feeAmount字段，则FeeAmount__c字段将设置为AssetItem上feeAmount字段的值。

远程选项

选项	说明
assetId	可选。 此服务根据新的或更新的信息更新的现有策略的 ID。在服务需要更新现有策略时使用。
createContactForParticipants	可选。 true 或 false 默认为 true。 如果false，服务不会创建联系人记录。
createInsuredItemsRelationships	true 或 false 如果此选项设置为真，您可以指定instanceKey > 保险项目之间的parentInstanceKey关系列表。 此选项支持父级 > 子级和父级 > 子级 > 孙级保险项目关系。
createTransaction	可选。 true 或 false 默认为 false。 如果true，服务会创建收入计划服务使用的交易。 该服务还将事务细分数据填充到事务详细信息对象中。它显示有关每项资产、参与者和承保范围在保费、税和费用方面对总交易金额的贡献率的数据。仅显示保费、税和费用金额至少有一个非零值的资产、参与者和承保范围。交易详细信息对象必须添加到相关交易列表中。
coolingOffPeriod	可选 您可以延迟第一个付款计划条目的天数。 通过冷却期，保单的第一个付款计划日期计算为生效日期 + 天数。 例如，每月付款频率的有效日期是 1 月 5 日，第一个付款计划日期是 1 月 5 日。如果我们应用 14 天的冷却期，第一个付款计划条目将从 1 月 5 日更改为 1 月 19 日。剩余的每月付款计划日期保持不变。 备注 冷却期必须在保单开始日期后的 1 至 28 天内。
effectiveDate	%“YYYY-MM-DD HH:MM:SS”或 %OmniScriptDataElement% 策略（或策略更新）生效的日期。 如果在选项映射中没有effectiveDate值，服务会在rootAttributes映射中查找它。如果服务未在此处找到effectiveDate，则使用今天的日期。 如果您正在使用保险行业扩展软件包，将忽略effectiveDate选项中的时间戳值。相反，有效日期时间戳值设置为选定有效日期的 12:00 a.m.，过期日期值设置为选定过期日期的 11:59 p.m.。时间戳通过使用用户指定的时区来设置。
generatePolicyNumber	真 或 假 如果true，此选项使用UniqueIdGenerator创建唯一保单编号。此数字存储为Asset.SerialNumber。
includePaymentSchedule	可选。 True是否将为保单创建付款计划。 默认值是 false。
includeRevenueSchedule	可选。 true 或 false 如果true，此选项调用 InsPolicyRevenueScheduleService: createRevenueSchedule 服务来创建收入计划，或者调用 InsPolicyRevenueScheduleService: modifyRevenueSchedule（如果正在更新策略）。 如果false，服务不会为此策略创建收入计划。
initialPaymentRule	可选。 百分比、月数或日数。
initialTransactionName	可选。 交易名称。 默认值是使用与 ⁇ initialPaymentTransactionType 相同的值。
initialPaymentTransactionType	可选。 交易类型。 默认值是保费。
initialPaymentValue	如果提供initialPaymentRule，则为必填项。 百分比值，或月数或日数。
inputKey	必需。 此服务从中提取必要信息的 JSON，以便创建或更新策略。
isCreatingPolicyTerms	true 或 false 在设置为 true 时，服务会在输出 JSON 中返回一个policyTermIds节点。
isFsc	可选。 True要创建的保单是否是 InsurancePolicy 对象。 默认值是 false。 您可以指定postDataCustomClassName或postDataDRBundleName。 如果您未指定这些选项之一，服务默认设置为postDataCustomClassName。
paymentCalculationMethod	如果includePaymentSchedule是true，则需要此项。 覆盖保单的保费计算方法值。
paymentFrequency	如果includePaymentSchedule是true，则需要此项。 覆盖策略的 PremiumFrequency 值。
paymentStartDate	可选。 第一个付款计划条目的日期。 默认值是保单的生效日期。
paymentType	如果includePaymentSchedule是true，则需要此项。 覆盖保单的保费付款类型值。
postDataCustomClassName	可选。 您必须指定此选项或postDataDRBundleName。 默认值设置为 ⁇ PostInsurancePolicy。
postDataDRBundleName	可选。 您必须指定此选项或postDataCustomClassName。 如果您未指定此选项，默认设置为 postDataCustomClassName。
transactionType	%OmniScriptDataElement% 在 includeRevenueSchedule 设置为真时使用。 如果未设置值，默认设置为已售保单。
calculateCommission	true 或 false 在设置为 true 时，服务会计算根项目的佣金，并将总金额保存到 TotalCommissionAmount。 当设置为 false（默认）时，服务不会计算佣金。 备注 如果您将此选项设置为真，服务需要至少一个生产者或生产代码值：producerId 、productionCodeId 或 productionCodeName。
commissionType	可选 佣金类型（例如，奖金或标准）。
commissionStatus	可选 佣金的状态（例如，待处理、已付款或已放弃）。
producerId	可选 处理生产者 ID，即用于检索 commissionScheduleId 和计算佣金金额的生产者。 分配给 分配给 InsurancePolicy.ProducerId。
productionCodeId	可选 生产代码 ID。 分配给InsurancePolicy.ProductionCodeId__c。
productionCodeName	可选 传递到 InsCommissionService.calculate 服务的生产代码名称。 如果 ⁇ 您未输入productionCodeId，服务会使用 productionCodeName 查找 ⁇ productionCodeId。如果输入两个值但不匹配，则优先productionCodeId。
memberPlanIntegrationProcedure	根据用户配置启动自定义集成程序。当您使用此选项时，它会将服务的所有选项传递给自定义集成程序，并将所有保单 ID 作为与对象集成的输入，例如带有成员计划的保险单对象。
ratingDate	用于为输入 JSON 定价的评级日期。 备注 您无法为 ratingField 传递特定时间，因为字段类型是日期。因此，评级日期时间戳默认为 12:00 am。
term	服务将创建的策略期限。 InsPolicyService:createUpdatePolicy 仅支持年度保单术语。
useIsPaidFlag	可选 如果 includePaymentSchedule 为真，服务会为每个付款计划条目创建保单组件的贡献记录。 默认值是 false。

输入 JSON

此服务查找inputKey的值。

对于本示例，inputKey = newPolicyJSON。

"newPolicyJSON": {
  "accountId": "001f400000OSHq2AAH",
  "term": "Annual",
  "endDate": "2019-05-14T07:00:00.000Z",
  "effectiveDate": "2018-05-15T07:00:00.000Z",
  "productConfigurationDetail": {
    ...
  },
  "insuredItems": {
    ...
  },
  "additionalFields": {
    "SerialNumber": "AUTO-123",
    "Status": "InForce",
    "vlocityins2__Type__c": "AUTO",
    "vlocityins2__PaymentMethodId__c": "a2Rf40000002NrgEAE"
  },
}

inputKey中的 JSON 包括服务创建或更新策略所需的几个键/值对。它还包括产品 JSON，以及保险项目和总保单的定价。

本示例的insuredItems记录包括保险项目和用户为每个项目选择的值。

对于本示例，inputKey = quotepolicyJSON。

"quotepolicyJson": {
  "productConfigurationDetail": {
    ...
  }
  "insuredItems": {
    "DRIVER": [{
        "GENDER": "Female",
        "FN": "Joan",
        "AGE": 20,
        "LN": "Smith",
        "instanceKey": "Joan Smith",
        "isPrimary": false
        "isParent": false
      },
      {
        "GENDER": "Male",
        "FN": "John",
        "AGE": 30,
        "LN": "Smith",
        "instanceKey": "John Smith",
        "isPrimary": false
        "isParent": false
      },
      {
        "GENDER": "Male",
        "FN": "Robert",
        "AGE": 30,
        "LN": "Henderson",
        "instanceKey": "Robert Henderson",
        "isPrimary": false
        "isParent": false
      },
      {
        "GENDER": "Female",
        "FN": "Kinsey",
        "AGE": 20,
        "LN": "Schell",
        "instanceKey": "Kinsey Schell",
        "isPrimary": false
        "isParent": false
      }
    ],
    "AUTO": [{
        "autoLicNum": "Lexus",
        "autoModel": "LX250",
        "autoYear": 2015,
        "instanceKey": "2015 Lexus LX250",
        "BodyClass": "Sedan/Saloon",
        "VehicleType": "PASSENGER CAR",
        "isPrimary": true
        "isParent": true
      },
      {
        "autoLicNum": "Honda",
        "autoModel": "Odyssey",
        "autoYear": 2006,
        "instanceKey": "2006 Honda Odyssey",
        "BodyClass": "Minivan",
        "VehicleType": "MULTIPURPOSE PASSENGER VEHICLE (MPV)",
        "isPrimary": true
        "isParent": true                                
      }
    ]
  },
  "accountId": "0011I00000QknfjQAB",
  "opportunityId": "0061I00000AV8gBQAT"
},
"quoteId": "0Q01I000000206USAQ",
"error": "OK"

输出 JSON

该服务返回新创建的策略的策略 ID。

{
    "policyId": "02if4000001uCZXAA2",
    "error": "OK"
}

如果isCreatingPolicyTerms远程选项设置为true，则包含policyTermIds节点。以下是policyTermIds节点的示例：

{  
   "policyId": "02i6g000000h110AAA",
   "policyTermIds": [
    "a5X6g000001LeUUEA0",
    "a5X6g000001LeUVEA0",
    "a5X6g000001LeUWEA0",
    "a5X6g000001LeUXEA0",
    "a5X6g000001LeUYEA0",
    "a5X6g000001LeUZEA0",
    "a5X6g000001LeUaEAK",
    "a5X6g000001LeUbEAK",
    "a5X6g000001LeUcEAK",
    "a5X6g000001LeUdEAK",
    "a5X6g000001LeUeEAK",
    "a5X6g000001LeUfEAK"
  ]
}

示例

该服务通常用于 OmniScript 报价到保单模式。