Loading
Страхование
InsPolicyService:calculateTaxesAndFees

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 целевой транзакции соответственно.

Удаленные параметры

Параметр

Описание

assetId

Обязательно

Код актива (полиса), для которого эта служба рассчитает налоги и платежи.

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