InsPolicyService:calculateTaxesAndFees

類別:InsPolicyService

方法:calculateTaxesAndFees

稅金和費用資訊會儲存在資產 (保單) 物件以及 AssetCoverage__c、AssetInsuredItem__c 和 AssetPartyRelationship__c 欄位上。

此服務也會儲存項目化稅額,如下方步驟 3 中所述。

備註

此服務支援 Salesforce Financial Services Cloud。

運作方式

1. 服務會取得 assetId、effectiveDate (或 EffectiveDate_c 在目標原則上,或今天日期 (如果值為空值)。

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 欄位上。

遠端選項

輸入 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
  }]
}