Loading
保險
InsQuoteService:calculateTaxesAndFees

InsQuoteService:calculateTaxesAndFees

使用此服務可計算和儲存目標報價的稅金與費用。

稅金與費用資訊會儲存在報價物件與報價條列項目物件上。

備註
備註

來賓使用者不支援此服務。

如果來賓使用者嘗試執行使用此服務的 OmniScript 或整合程序或 UI 函數,則該服務將無法執行,且來賓使用者會看到錯誤訊息。

類別:InsQuoteService

方法:calculateTaxesAndFees

運作方式

  1. 取得 quoteId、jurisdictionId 和 effectiveDate (若有指定),並計算要套用至報價的稅金和費用。

  2. 如果將 saveChanges 設為 (或預設為) true,則會以三種方式的其中一種方式儲存計算的稅金和費用。

    • 如果「報價條列項目」已計算稅額和費用,則會儲存代表該稅額/費用的 QuotePricingAdjustment__c 記錄。QuotePricingAdjustment__c 記錄會包含計算的金額 (Amount__c)、相關聯的報價條列項目 (QuoteItemId__c) 和報價 (QuoteId__c)、類型 (tax 或 fee; AdjustmentType__c),以及相關聯的稅金/費用 (PriceListEntryId__c)。

    • 如果「報價條列項目」或其子系項目已計算稅額,則本身及其子系項目的計算稅額總和會儲存在 TaxAmount__c 欄位上。

    • 如果「報價條列項目」或其子系項目已計算費用,則本身及其子系項目的計算費用總和會儲存在 FeeAmount__c 欄位上。

    備註
    備註

    如果將 saveChanges 設為 false,則不會儲存「報價條列項目」記錄的 QuotePricingAdjustment__c 和更新。

  3. 在「報價」層級,所有稅額和費用金額的總和會分別儲存在 TotalTaxAmount__c 和 TotalFeeAmount__c 欄位上。

遠端選項

選項

描述

quoteId

必要

此服務將計算稅金與費用的報價識別碼。

jurisdictionIds

選擇性

僅計算與所提供的管轄權相關聯的稅金和費用。

effectiveDate

選擇性

計算僅在指定日期生效的稅金和費用。

若未提供,則值預設為目標報價的 EffectiveDate__c。如果 EffectiveDate__c 為空值,則值預設為今天日期。

saveChanges

選擇性

true 或 false

預設為 true。

如果為 true,則儲存報價的已計算稅金與費用。

如果為 false,則不會在報價上儲存計算的稅金與費用。

withTaxFeeRounding

選擇性

如果為 true,則會使用半偶數捨入方法將計算的稅金與費用金額捨入至兩個小數位數。如果為 false,則捨入會停用。

預設為 False。

輸入 JSON

此服務不會取得輸入 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