Loading
保险
InsPolicyService:prepareToCancelPolicy

InsPolicyService:prepareToCancelPolicy

在取消保单前,使用此服务计算保费价格差异。该服务按比例分配保费、费用和税额,并计算保费、费用和退税。

此服务需要在InsPolicyService:cancelPolicy服务之前调用。

此服务适用于 Salesforce Financial Services Cloud。

类:InsPolicyService

方法:prepareToCancelPolicy

工作原理

  1. 获取assetId或policyId,并发现策略被取消。

  2. 根据useIsPaidFlag值使用适当的计算流程。

    在将useIsPaidFlag设置为假(取消选择)时,服务会按比例分配保单的定期总保费、定期总费用和定期总税额,并根据取消日期和迄今支付的保单金额计算退款金额。如果保单付款日期为空,服务会考虑全额付款保单,并使用到期日期。

    将useIsPaidFlag设置为true(已选择),服务:

    1. 使用付款计划计算已为保单支付的总金额。为保单支付的总金额等于付款计划中“已支付”设置为真(已选择)的金额总和。此金额用于退款计算。

    2. 按比例分配保单的定期总保费、定期总费用和定期总税额,并根据取消日期和已为保单支付的总金额计算退款金额。

  3. 服务会考虑费用或税是否可以退款。

  4. 返回输出 JSON 中保单的原始总保费与已取消保单之间的价格差。

    • 退款金额从保单持有人的角度来看。正数金额表示对保单持有人的退款。 ⁇ 负数表示投保人未支付的金额。

  5. 如果此策略包含税费,则Total Tax For Term、Total Fee For Term、refundedTax和/或refundedFee也会包含在输出 JSON 中。

    如果服务正在取消的策略不含税或费用,这些字段将从输出 JSON 中忽略。

附加费(税费)

此服务(与InsPolicyService:cancelPolicy服务一起)便于在保单取消时按比例分配和退还税费。以下是工作方式:

  • priceDiff本质上是退款金额,并使用公式 =(旧GrossWrittenPremium - 更新的GrossWrittenPremium)+ refundedTax + refundedFee。

  • 更新的GrossWrittenPremium是保单生效日期和取消日期之间按比例分配的PremiumAmount。

  • 新总金额等于目标保单的PremiumAmount加上StandardTaxAmount加上StandardFeeAmount,所有金额按比例分配到取消日期。

  • 如果目标策略有StandardTaxAmount,该值将在取消日期按比例分配,并通过输出中的TermTaxAmount字段返回。

  • 如果目标策略有StandardFeeAmount,该值将在取消日期按比例分配,并通过输出中的TermFeeAmount字段返回。

  • 如果目标保单有可退款InsurancePolicySurcharge或AssetPricingAdjustment__c记录,将通过输出中的refundedTax和refundedFee字段返回按比例分配的退款金额。如果相关PriceListEntry__c可退款,InsurancePolicySurcharge或AssetPricingAdjustment__c可退款。按比例计算的退款金额在取消日期和原始到期日期之间计算。

远程选项

选项

说明

assetId

或

policyId

必需。

%theIdYouAreLookingFor%

要取消的保险单的 ID。

effectiveDate

必需。

“YYYY-MM-DD HH:MM:SS” 或 %OmniScriptDataElement%

保单的取消日期。

getDataDRBundleName

可选(仅限FSC)。

此服务用于检索保单(资产)信息的 Omnistudio 数据映射器的名称。

如果您正在使用 Salesforce FSC,您必须指定此选项或getDataCustomClassName。

getDataCustomClassName

可选(仅限FSC)。

此服务用于检索保单(资产)信息的自定义类的名称。

如果您正在使用 Salesforce FSC,您必须指定此选项或getDataDRBundleName。

默认值设置为 GetInsurancePolicy。

useIsPaidFlag

可选。

真或假

如果为真,则使用新的按比例分配逻辑(考虑付款计划)。

如果为假,则使用现有的按比例分配逻辑(它使用取消日期和 paidToDate)。

默认值设置为假。

输入 JSON

此服务需要包含effectiveDate的输入 JSON(取消日期)。

{
    "Id": "02i6g000002f07VAAQ",
    "effectiveDate": "08/12/2019"
}

输出 JSON

该服务返回为具有新取消日期的保单计算的价格差异。

{
  "Id": "02i6g000002f07VAAQ",
  "output": {
    "refundedFee": -3.68,
    "totalFeeForTerm": 14.06,
    "refundedTax": -37.93,
    "totalTaxForTerm": 144.84,
    "aggregateTotalPremiumForTerms": 4002.28,
    "priceDiff": -420.97,
    "totalPremiumForTerm": 1448.44,
    "errorCode": "INVOKE-200",
    "error": "OK"
  }
}

输出密钥和值

输出

描述

Id

已更新保单(资产)或保险单的 ID。

output

  • totalPremiumForTerm:按比例分配的总保费

  • totalFeeForTerm:按比例分配的总期限费用

  • totalTaxForTerm:按比例分配的定期纳税总额

  • aggregateTotalPremiumForTerms:所有保单版本的总保费与正在取消的当前版本按比例分配的总保费之和

  • refundedFee:要退还的费用金额

  • refundedTax:要退还的税金额

  • priceDiff:退款的保费、费用和税款总额

 
正在加载
Salesforce Help | Article