Loading
保险
InsPolicyService:calculateTaxesAndFees

InsPolicyService:calculateTaxesAndFees

使用此服务计算并节省目标资产的税费(策略)。

类:InsPolicyService

方法:calculateTaxesAndFees

税费信息保存在资产(保单)对象以及AssetCoverage__c、AssetInsuredItem__c和AssetPartyRelationship__c字段中。

此服务还节省了下面步骤 3 中描述的明细税。

备注
备注

此服务支持 Salesforce Financial Services Cloud。

工作原理

  1. 服务会获取assetId、effectiveDate(或EffectiveDate_c 在目标策略上,或如果值为 null 则为今天的日期)。

  2. 根据与保单、承保范围和/或保险项目关联的税费项目,执行指定的简单计算,或调用计算税费所需的计算程序或集成程序。

    备注
    备注

    此服务也可以调用外部系统来计算税费。在设置税费时指定这些系统。

  3. 如果 saveChanges 设置为(或默认)true,则以三种方式之一保存计算的税费。

    • 如果AssetItem已计算税费,服务会保存表示该税费的AssetPricingAdjustment__c记录。

      AssetPricingAdjustment__c记录包含计算金额(Amount__c)、关联AssetItem(AssetCoverageId__c/AssetInsuredItemId__c/AssetPartyRelationshipId__c)和Asset(AssetId__c)、类型(税或费用;AdjustmentType__c)以及关联税/费用(PriceListEntryId__c)。

      AssetPricingAdjustment__c 具有关联的AssetItem,因此也将设置ApplicableItemType__c字段。此设置表示适用哪种项目类型:承保范围、保险项目或当事人关系。

      如果指定了transactionId选项,该AssetTransactionId__c 字段将设置为transactionId值。

    • 如果AssetItem估价员计算了子项的税额,则它自己及其子项的计算税额总和将存储在TaxAmount__c字段中。

    • 如果AssetItem访问者计算了费用,则其自身及其子项的计算费用总和将存储在FeeAmount__c字段中。

    备注
    备注

    如果saveItemizedTaxesAndFees设置为false,则不会保存AssetPricingAdjustment__c记录。资产(保单)的TotalTaxAmount__c和TotalFeeAmount__c金额设置为 0。所有其他值仍会保存。

  4. 在资产级别,所有税金额和费用金额的总和分别存储在TotalTaxAmount__c和TotalFeeAmount__c字段中。

  5. 如果目标资产(保单)不是保单的原始版本,则税费金额将根据资产的EffectiveDate__c和ExpirationDate__c按比例分配。AssetItem的按比例分配的税费金额存储在ProratedTaxAmount__c和ProratedFeeAmount__c字段中。资产的按比例分配的税费金额存储在TotalTaxForTerm__c和TotalFeeForTerm__c字段中。

  6. 如果提供transactionId选项,当前资产版本和以前资产版本之间按比例分配的总税费金额(目标资产版本和所有以前版本按比例分配的税费金额的总和)的变化将分别存储在目标交易的TaxAmount__c和FeeAmount__c字段中。

远程选项

选项

说明

assetId

必填

此服务将计算税费的资产(保单)的 ID。

transactionId

可选

指定的交易将使用计算的税费金额进行更新。

jurisdictionIds

可选

仅计算与提供的管辖区相关的税费。

effectiveDate

可选

计算仅在指定日期生效的税费。

如果未提供,该值默认设置为目标策略的EffectiveDate__c。如果 EffectiveDate__c 为空,值默认设置为今天的日期。

saveChanges

可选

true 或 false

默认为 true。

如果true,保留保单(资产)的计算税费。

如果false,请勿保留保单(资产)的计算税费。

输入 JSON

此服务不需要输入 JSON。

输出 JSON

该服务返回产品/子产品层次结构中的明细税费。以下示例:

{
  "productId": 1,
  "productName": "Product",
  "ProductCode": "P",
  "taxesAndFees": [{
    "Id": 1,
    "Amount__c": 10,
    "PriceListEntryId__c": 11,
    "AdjustmentType__c": "Tax"
  }, {
    "Id": 2,
    "Amount__c": 15,
    "PriceListEntryId__c": 12,
    "AdjustmentType__c": "Fee"
  }],
  "taxAmount": 25
  "feeAmount": 30
  "childProducts": [{
    "productId": 2,
    "productName": "Insured Item",
    "ProductCode": "II",
    "instanceKey": "My Insured Item",
    "taxesAndFees": [{
      "Id": 3,
      "Amount__c": 15,
      "PriceListEntryId__c": 16,
      "AdjustmentType__c": "Tax"
    }],
    "taxAmount": 15
  }, {
    "productId": 3,
    "productName": "Coverage",
    "ProductCode": "C",
    "taxesAndFees": [{
      "Id": 4,
      "Amount__c": 15,
      "PriceListEntryId__c": 21
      "AdjustmentType__c": "Fee"
    }],
    "feeAmount": 15
  }]
}
 
正在加载
Salesforce Help | Article