InsPolicyService:cancelPolicy

此服务与InsPolicyService:prepareToCancelPolicy服务和InsPolicyRevenueScheduleService:cancelRevenueSchedule服务配合使用，以完成取消保单、提供退款金额和结束收入计划（如果需要）所需的所有更改。

类：InsPolicyService

方法：cancelPolicy

此服务适用于 Salesforce Financial Services Cloud。

工作原理

1. 获取要取消的保单的assetId或policyId，以及取消生效的effectiveDate。

   

   备注 有效取消日期不能大于今天。

2. 将保单状态更新为 Canceled，将原始到期日期更新为到期日期的当前值，并将到期日期更新为取消日期前一天（时间戳为晚上 11:59）。

3. 将到期日期更改为时间戳为晚上 11:59 的传递给服务的effectiveDate。

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

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

   将useIsPaidFlag设置为true（已选择），服务：

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

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

   3. 根据当前日期或取消日期（以较晚的日期为准）调整付款计划。如果在此日期或之后付款计划的“已付”设置为假(取消选择),服务会将其删除。

   4. 将所有未付付款计划（过去从cancellationDate开始）的状态更新为Invalid。未偿金额会添加到新付款计划。

   5. 为当前日期创建新的付款计划，金额等于已计算的退款金额，并将状态标记为Valid。如果createTransaction为真，服务将创建取消交易。

   6. 使用取消信息更新所有未来的保单版本：

      • 状态：已取消

      • 取消日期：传递给服务的effectiveDate

      • 定期保费、定期税和定期费用：0

      • 到期日期：effectiveDate传递到服务前一天，时间戳为晚上 11:59

5. 将按比例分配的 TotalPremiumForTerm 提交到数据库。

6. 如果 createTransaction=true，并且传递的 ID 是 assetId，则创建 AssetTransaction_c（Amount_c=refund，postDate_c 和 transactionDate_c=effectiveDate，type= TransactionType（默认为已取消）。如果 createTransaction=true，并且传递的 ID 是 policyId，则服务会创建 InsurancePolicyTransaction_c 或 InsurancePolicyTransaction（Amount_c=refund, postDate_c and transactionDate_c=effectiveDate, type= TransactionType（默认为已取消）。

   该服务还将事务细分数据填充到事务详细信息对象中。它显示有关每项资产、参与者和承保范围在保费、税和费用方面对总交易金额的贡献率的数据。仅显示保费、税和费用至少有一个非零值的资产、参与者和承保范围。

7. 调用 InsPolicyRevenueScheduleService：使用assetId和新创建的transactionId取消。

8. InsPolicyRevenueScheduleService: cancel 服务计算收入计划的结束时间，并将结果发布到策略的收入计划部分。退款金额从保险公司的角度来看。负数表示退还给投保人，正数表示投保人未支付的金额。

备注

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

附加费（税费）

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

• 如果目标策略有TotalTaxAmount__c，该值将在取消日期按比例分配，并在TotalTaxForTerm__c字段中设置。

• 如果目标策略有TotalFeeAmount__c，该值将在取消日期按比例分配，并在TotalFeeForTerm__c字段中设置。

• 如果createTransaction选项(见下文)设置为真，并且目标保单有可退款AssetPricingAdjustment__c记录，则在交易的TaxAmount__c和FeeAmount__c字段中设置按比例退款金额。

如果您正在使用保险单对象模型（而不是资产对象模型），则字段名称不同：

• TotalTaxAmount__c = StandardTaxAmount

• TotalTaxForTerm__c = TermTaxAmount

• TotalFeeAmount__c = StandardFeeAmount

• TotalFeeForTerm__c = TermFeeAmount

• AssetPricingAdjustment__c = InsurancePolicySurcharge

• TaxAmount__c = TransactionTaxAmount

• FeeAmount__c = TransactionFeeAmount

提示

是否想要了解从资产对象模型过渡到保险单对象模型？阅读协调保险单。

远程选项

  "additionalFees": {
    "Cancellation Fee": 20,
    "Admin Fee": 10
  }

输入 JSON

此服务不需要输入 JSON。

输出 JSON

如果您正在使用资产对象模型，此服务将返回 JSON output节点。以下示例：

{
  "output": {
    "records": [
      {
        "instest10__TotalAmount__c": 420.97,
        "instest10__TaxAmount__c": 37.93,
        "instest10__FeeAmount__c": 3.68,
        "instest10__Amount__c": 379.36,
        "Id": "a416g0000002CZpAAM"
      }
    ],
    "totalSize": 1
  }
}

如果您正在使用保险单对象模型，此服务将返回 JSON results节点。以下示例：

{
    "result": {
        "type": "Cancelled",
        "transactionNumber": null,
        "transactionDate": 
        "totalAmount": null,
        "taxAmount": null,
        "postDate": "2021-09-01T07:00:00.000Z",
        "name": "Cancelled"
        "Id": null,
        "feeAmount": null,
        "amount": -133.4,
        "additionalInfo": null
    },
    "error": "OK"
}