InsPolicyService:calculateTaxesAndFees

Classe: InsPolicyService

Méthode : calculateTaxesAndFees

Les informations fiscales et de frais sont enregistrées dans l'objet Actif (police), et dans les champs AssetCoverage__c, AssetInsuredItem__c et AssetPartyRelationship__c.

Ce service permet également d'économiser les taxes détaillées comme indiqué à l'étape 3 ci-dessous.

Remarque

Ce service prend en charge Salesforce Financial Services Cloud.

Fonctionnement

1. Le service prend la assetId, la effectiveDate (ou EffectiveDate_c la stratégie cible, ou la date du jour si la valeur est nulle).

2. Selon les taxes et les éléments de frais associés à la police, aux couvertures et/ou aux éléments assurés, soit effectue le calcul simple spécifié, soit appelle la procédure de calcul ou la procédure d'intégration requise pour calculer les taxes et les frais.

   

   Remarque

   Ce service peut également appeler des systèmes externes pour calculer les taxes et les frais. Spécifiez ces systèmes lors de la configuration des taxes et des frais.

3. Si saveChanges est défini (ou défini par défaut) sur true, enregistre les taxes et les frais calculés de l'une des trois façons suivantes.

   • Si un AssetItem a calculé les taxes et les frais, le service enregistre un enregistrement AssetPricingAdjustment__c représentant cette taxe/ces frais.

     L'enregistrement AssetPricingAdjustment__c contient le montant calculé (Amount__c), les AssetItem (AssetCoverageId__c/AssetInsuredItemId__c/AssetPartyRelationshipId__c) et Asset (AssetId__c) associés, le type (taxe ou frais; AdjustmentType__c) et la taxe/frais (PriceListEntryId__c) associés.

     AssetPricingAdjustment__c a une AssetItem associée. Par conséquent, le champ ApplicableItemType__c sera également défini. Ce paramètre indique le type d'élément applicable : Couverture, Article assuré ou Relation de partie.

     Si l'option transactionId est spécifiée, le AssetTransactionId__c champ est défini sur la valeur transactionId.

   • Si un AssetItem ou ses enfants ont calculé l'impôt, la somme des impôts calculés sur lui-même et ses enfants est stockée dans le champ TaxAmount__c.

   • Si un AssetItem ou ses enfants ont des frais calculés, la somme des frais calculés sur lui-même et ses enfants sera stockée dans le champ FeeAmount__c.

   

   Remarque

   Si saveItemizedTaxesAndFees est défini sur false, les enregistrements AssetPricingAdjustment__c ne sont pas enregistrés. Les montants de TotalTaxAmount__c et de TotalFeeAmount__c de l'actif (police) sont définis sur 0. Toutes les autres valeurs sont encore enregistrées.

4. Au niveau Actif, la somme de tous les montants de taxe et de frais est stockée respectivement dans les champs TotalTaxAmount__c et TotalFeeAmount__c.

5. Si l’actif cible (police) n’est pas la version originale de la police, les montants de taxe et de frais seront calculés au prorata en fonction de la EffectiveDate__c et de la ExpirationDate__c de l’actif. Les montants de taxe et de frais calculés au prorata pour une AssetItem sont stockés dans les champs ProratedTaxAmount__c et ProratedFeeAmount__c. Les montants de taxe et de frais calculés au prorata pour l'actif sont stockés dans les champs TotalTaxForTerm__c et TotalFeeForTerm__c.

6. Si une option de transactionId est fournie, l'évolution des montants totaux de taxe et de frais au prorata (la somme des montants de taxe et de frais au prorata dans la version de l'actif cible et dans toutes les versions antérieures de l'actif) entre la version actuelle de l'actif et les versions précédentes de l'actif sont stockés respectivement dans les champs TaxAmount__c et FeeAmount__c de la transaction cible.

Options distantes

JSON d'entrée

Ce service ne prend pas de JSON d'entrée.

JSON de sortie

Le service renvoie les taxes et les frais détaillés dans la hiérarchie des produits/produits enfants. Exemple :

{
  "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
  }]
}