Loading
Assicurazioni
InsPolicyService:calculateTaxesAndFees

InsPolicyService:calculateTaxesAndFees

Utilizzare questo servizio per calcolare e risparmiare imposte e commissioni su un asset di destinazione (polizza).

Classe: InsPolicyService

Metodo: calculateTaxesAndFees

Le informazioni su imposte e spese vengono salvate nell'oggetto asset (polizza) e nei campi AssetCoverage__c, AssetInsuredItem__c e AssetPartyRelationship__c.

Questo servizio consente anche di salvare le imposte dettagliate come descritto nel passaggio 3 seguente.

Nota
Nota

Questo servizio supporta Salesforce Financial Services Cloud.

Funzionamento

  1. Il servizio assume il assetId, il effectiveDate (o EffectiveDate_c la policy di destinazione, o la data odierna se il valore è nullo).

  2. In base alle voci imposte e spese associate alla polizza, alle coperture e/o alle voci assicurate, viene specificato il calcolo semplice o viene chiamata la procedura di calcolo o la procedura di integrazione necessaria per calcolare le imposte e le spese.

    Nota
    Nota

    Questo servizio può anche chiamare sistemi esterni per calcolare imposte e spese. Specificare questi sistemi quando si impostano imposte e spese.

  3. Se saveChanges è impostato (o è impostato per impostazione predefinita) su true, salva le imposte e le spese calcolate in uno dei tre modi seguenti.

    • Se un'AssetItem ha calcolato imposte e spese, il servizio salva un record AssetPricingAdjustment__c che rappresenta tale imposta/tariffa.

      Il record AssetPricingAdjustment__c contiene l'ammontare calcolato (Amount__c), i AssetItem associati (AssetCoverageId__c/AssetInsuredItemId__c/AssetPartyRelationshipId__c) e Asset (AssetId__c), il tipo (imposta o tassa; AdjustmentType__c) e l'imposta/tassa associata (PriceListEntryId__c).

      AssetPricingAdjustment__c ha un AssetItem associato, quindi verrà impostato anche il campo ApplicableItemType__c. Questa impostazione indica il tipo di elemento applicabile: Copertura, Voce assicurata o Relazione con la parte.

      Se è specificata l'opzione transactionId, il AssetTransactionId__c campo viene impostato sul valore transactionId.

    • Se un'AssetItem o i suoi figli hanno calcolato imposte, la somma delle imposte calcolate su di loro e sui suoi figli verrà memorizzata nel campo TaxAmount__c.

    • Se un'AssetItem o i suoi figli hanno calcolato le spese, la somma delle spese calcolate su se stessi e sui suoi figli verrà memorizzata nel campo FeeAmount__c.

    Nota
    Nota

    Se saveItemizedTaxesAndFees è impostato su false, i record AssetPricingAdjustment__c non vengono salvati. L'ammontare di TotalTaxAmount__c e TotalFeeAmount__c dell'asset (polizza) è impostato su 0. Tutti gli altri valori vengono comunque salvati.

  4. A livello di Asset, la somma di tutti gli importi delle imposte e degli oneri viene memorizzata rispettivamente nei campi TotalTaxAmount__c e TotalFeeAmount__c.

  5. Se l'asset di destinazione (polizza) non è la versione originale della polizza, l'ammontare delle imposte e delle spese verrà ripartito in base al EffectiveDate__c e al ExpirationDate__c dell'asset. Gli importi ripartiti delle imposte e delle spese per un AssetItem vengono memorizzati nei campi ProratedTaxAmount__c e ProratedFeeAmount__c. Gli importi ripartiti delle imposte e delle spese per l'asset sono memorizzati nei campi TotalTaxForTerm__c e TotalFeeForTerm__c.

  6. Se è prevista un'opzione transactionId, la modifica dell'ammontare totale delle imposte e delle spese ripartite (somma dell'imposta ripartita e degli importi delle spese nella versione asset di destinazione e in tutte le versioni precedenti dell'asset) tra la versione asset corrente e le versioni asset precedenti viene memorizzata rispettivamente nei campi TaxAmount__c e FeeAmount__c della transazione di destinazione.

Opzioni remote

Opzione

Descrizione

assetId

Obbligatorio

ID dell'asset (polizza) per cui il servizio calcolerà le imposte e le spese.

transactionId

Facoltativo

La transazione specificata verrà aggiornata con gli importi calcolati delle imposte e delle spese.

jurisdictionIds

Facoltativo

Calcola solo le imposte e le spese associate alle giurisdizioni specificate.

effectiveDate

Facoltativo

Calcolare le imposte e le spese effettive solo nella data specificata.

Se non viene specificato, il valore predefinito è .EffectiveDate__c Se EffectiveDate__c è nullo, il valore viene impostato automaticamente sulla data odierna.

saveChanges

Facoltativo

true o false

Per impostazione predefinita, true.

In caso di true, persistono le imposte e le spese calcolate sulla polizza (asset).

In caso di false, non persistono le imposte e le spese calcolate sulla polizza (asset).

Input JSON

Questo servizio non accetta un JSON di input.

JSON di output

Il servizio restituisce le imposte e le spese dettagliate nella gerarchia prodotti/prodotti controllati. Ecco un esempio:

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