Loading
Assicurazioni
InsQuoteService:calculateTaxesAndFees

InsQuoteService:calculateTaxesAndFees

Utilizzare questo servizio per calcolare e risparmiare imposte e spese su un preventivo target.

Le informazioni su imposte e spese vengono salvate sia nell'oggetto preventivo che nell'oggetto voce preventivo.

Nota
Nota

Questo servizio non è supportato per gli utenti guest.

Se un utente guest tenta di eseguire un OmniScript o una procedura di integrazione o una funzione dell'interfaccia utente che utilizza questo servizio, il servizio non verrà eseguito e l'utente guest visualizzerà un messaggio di errore.

Classe: InsQuoteService

Metodo: calculateTaxesAndFees

Funzionamento

  1. Prende il quoteId, il jurisdictionId e il effectiveDate (se specificato) e calcola le imposte e le spese da applicare al preventivo.

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

    • Se una Voce preventivo ha imposte e spese calcolate, viene salvato un record QuotePricingAdjustment__c che rappresenta tale imposta/tariffa. Il record QuotePricingAdjustment__c contiene l'ammontare calcolato (Amount__c), la Voce preventivo (QuoteItemId__c) e il Preventivo (QuoteId__c) associati, il tipo (tax o fee; AdjustmentType__c) e l'imposta/tariffa associata (PriceListEntryId__c).

    • Se una Voce preventivo o le sue controllate hanno imposte calcolate, la somma delle imposte calcolate su se stesse e sulle controllate verrà memorizzata nel campo TaxAmount__c.

    • Se una Voce preventivo o le sue controllate hanno calcolato le spese, la somma delle spese calcolate su se stesse e sulle controllate viene memorizzata nel campo FeeAmount__c.

    Nota
    Nota

    Se saveChanges è impostato su false, i QuotePricingAdjustment__c e gli aggiornamenti ai record Voce preventivo non vengono salvati.

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

Opzioni remote

Opzione

Descrizione

quoteId

Obbligatorio

ID del preventivo per cui il servizio calcolerà le imposte e le spese.

jurisdictionIds

Facoltativo

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

effectiveDate

Facoltativo

Calcolare le imposte e le spese che diventano 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.

Se true, consente di risparmiare le imposte e le spese calcolate sul preventivo.

Se false, non salva le imposte e le spese calcolate nel preventivo.

withTaxFeeRounding

Facoltativo

Se true, gli importi calcolati delle imposte e delle spese vengono arrotondati al secondo decimale utilizzando il metodo di arrotondamento alla metà. Se false, l'arrotondamento è disabilitato.

Il valore predefinito è false.

Input JSON

Questo servizio non accetta un JSON di input.

JSON di output

Il servizio restituisce una rappresentazione JSON del preventivo contenente solo informazioni sul prodotto e sulle imposte/spese.

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