Loading
Verzekering
InsPolicyService:calculateTaxesAndFees

InsPolicyService:calculateTaxesAndFees

Gebruik deze service om belastingen en vergoedingen voor een doelactivum (polis) te berekenen en te besparen.

Klasse: InsPolicyService

Methode: calculateTaxesAndFees

Informatie over belasting en kosten wordt opgeslagen voor het activumobject (polis) en voor de velden AssetCoverage__c, AssetInsuredItem__c en AssetPartyRelationship__c.

Deze service bespaart ook gespecificeerde belastingen zoals beschreven in stap 3 hieronder.

Opmerking
Opmerking

Deze service ondersteunt de Salesforce Financial Services Cloud.

De manier waarop het werkt...

  1. De service neemt de assetId, de effectiveDate (of EffectiveDate_c de doelpolis, of de datum van vandaag als de waarde null is).

  2. Op basis van de belastingen en vergoedingen die zijn gekoppeld aan de polis, de dekkingen en/of de verzekerde items, wordt de eenvoudige berekening opgegeven of wordt de berekeningsprocedure of integratieprocedure aangeroepen die vereist is om de belastingen en vergoedingen te berekenen.

    Opmerking
    Opmerking

    Deze service kan ook externe systemen aanroepen om belastingen en vergoedingen te berekenen. Geef deze systemen op wanneer u belastingen en vergoedingen instelt.

  3. Als saveChanges is ingesteld (of standaard is ingesteld) op true, worden de berekende belastingen en kosten op een van de drie manieren opgeslagen.

    • Als een AssetItem belastingen en vergoedingen heeft berekend, slaat de service een AssetPricingAdjustment__c op die die belasting/vergoeding voorstelt.

      De AssetPricingAdjustment__c bevat het berekende bedrag (Amount__c), de gekoppelde AssetItem (AssetCoverageId__c/AssetInsuredItemId__c/AssetPartyRelationshipId__c) en Asset (AssetId__c), het type (belasting of vergoeding; AdjustmentType__c) en de gekoppelde belasting/vergoeding (PriceListEntryId__c).

      AssetPricingAdjustment__c heeft een gekoppelde AssetItem, dus het veld ApplicableItemType__c wordt ook ingesteld. Deze instelling geeft aan welk itemtype van toepassing is: Dekking, Verzekerd item of Relatie partij.

      Als de optie transactionId is opgegeven, wordt het AssetTransactionId__c veld ingesteld op de transactionId.

    • Als een AssetItem of zijn kinderen belastingen hebben berekend, wordt de som van de berekende belastingen op zichzelf en zijn kinderen opgeslagen in het veld TaxAmount__c.

    • Als een AssetItem of zijn kinderen kosten hebben berekend, wordt de som van de berekende kosten voor zichzelf en zijn kinderen opgeslagen in het veld FeeAmount__c.

    Opmerking
    Opmerking

    Als saveItemizedTaxesAndFees is ingesteld op false, worden de AssetPricingAdjustment__c niet opgeslagen. De TotalTaxAmount__c en TotalFeeAmount__c voor het activum (polis) wordt ingesteld op 0. Alle andere waarden worden nog steeds opgeslagen.

  4. Op activumniveau wordt de som van alle belastingbedragen en kostenbedragen opgeslagen in respectievelijk de velden TotalTaxAmount__c en TotalFeeAmount__c.

  5. Als het doelactivum (de polis) niet de oorspronkelijke versie van de polis is, worden de belasting- en vergoedingsbedragen pro rata berekend op basis van de EffectiveDate__c en ExpirationDate__c van het activum. De pro rata belasting- en kostenbedragen voor een AssetItem worden opgeslagen in de velden ProratedTaxAmount__c en ProratedFeeAmount__c. De pro rata belasting- en kostenbedragen voor het activum worden opgeslagen in de velden TotalTaxForTerm__c en TotalFeeForTerm__c.

  6. Als een transactionId wordt geboden, worden de wijziging in de totale pro rata belasting- en vergoedingsbedragen (de som van de pro rata belasting- en vergoedingsbedragen voor de doelactivumversie en alle vorige versies van het activum) tussen de huidige activumversie en de vorige activumversies opgeslagen in respectievelijk de TaxAmount__c en FeeAmount__c van de doeltransactie.

Externe opties

Optie

Beschrijving

assetId

Verplicht

ID van het activum (de polis) waarvoor deze service belastingen en vergoedingen berekent.

transactionId

Optioneel

De opgegeven transactie wordt bijgewerkt met berekende bedragen aan belasting en kosten.

jurisdictionIds

Optioneel

Berekent alleen belastingen en vergoedingen die zijn gekoppeld aan de opgegeven rechtsgebieden.

effectiveDate

Optioneel

Bereken belastingen en kosten die alleen op de opgegeven datum van kracht zijn.

Indien niet opgegeven, wordt de waarde standaard de EffectiveDate__c van het doelbeleid. Als EffectiveDate__c null is, wordt de waarde standaard de datum van vandaag.

saveChanges

Optioneel

true of false

De standaardwaarde is true.

Indien true, blijven berekende belastingen en vergoedingen op de polis (activum) gehandhaafd.

Indien van false, blijven de berekende belastingen en vergoedingen op de polis (het activum) niet gehandhaafd.

Invoer-JSON

Deze service gebruikt geen invoer-JSON.

Uitvoer-JSON

De service retourneert de gespecificeerde belastingen en vergoedingen in de product/onderliggende producthiërarchie. Hier is een voorbeeld:

{
  "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
  }]
}
 
Wordt geladen
Salesforce Help | Article