InsPolicyService:prepareToCancelPolicy

Questo servizio deve essere invocato prima del servizio di InsPolicyService:cancelPolicy.

Questo servizio funziona con Salesforce Financial Services Cloud.

Classe: InsPolicyService

Metodo: prepareToCancelPolicy

Funzionamento

1. Prende la assetId o il policyId e trova la polizza da annullare.

2. Utilizza il processo di calcolo appropriato in base al valore useIsPaidFlag.

   Con useIsPaidFlag impostato su false (deselezionato), il servizio ripartisce il premio totale per durata, la spesa totale per durata e l'imposta totale per durata della polizza e calcola gli importi rimborsati in base alla data di annullamento e alla polizza pagata fino alla data odierna. Se Polizza pagata fino alla data odierna è Null, il servizio considera la polizza pagata per intero e utilizza la Data di scadenza.

   Con useIsPaidFlag impostato su true (selezionato), il servizio:

   1. Utilizza le pianificazioni di pagamento per calcolare l'importo totale già pagato per la polizza. L'importo totale pagato per la polizza è uguale alla somma degli importi nelle pianificazioni di pagamento con È pagato impostato su true (selezionato). Questo importo viene utilizzato nei calcoli dei rimborsi.

   2. Proporziona il premio totale per durata, la commissione totale per durata e l'imposta totale per durata della polizza e calcola gli importi dei rimborsi in base alla data di annullamento e all'importo totale già pagato per la polizza.

3. Il servizio prende in considerazione se le tariffe o le imposte sono rimborsabili o meno.

4. Restituisce la differenza di prezzo tra il premio totale originale per la polizza e la polizza annullata nel JSON di output.

   • Gli importi dei rimborsi sono dal punto di vista del titolare della polizza. Un importo positivo rappresenta un rimborso all'assicurato. Un importo negativo indica un importo non pagato dall'assicurato.

5. Se in questa policy sono incluse imposte e spese, nel JSON di output sono inclusi anche Total Tax For Term, Total Fee For Term, refundedTax e/o refundedFee.

   Se la policy che il servizio sta annullando non include tasse o spese, questi campi vengono omessi dal JSON di output.

Supplementi (tasse e commissioni)

Questo servizio (insieme al servizio InsPolicyService:cancelPolicy) facilita le ripartizioni e i rimborsi di imposte e spese quando una polizza viene annullata. Ecco come funziona:

• Il priceDiff è essenzialmente l'ammontare del rimborso e utilizza la formula = (GrossWrittenPremium precedenti - GrossWrittenPremium aggiornati) + refundedTax + refundedFee.

• Il GrossWrittenPremium aggiornato è il PremiumAmount ripartito sulla data di validità e sulla data di annullamento della polizza.

• Il nuovo ammontare totale è uguale al PremiumAmount della polizza di destinazione più il StandardTaxAmount più il StandardFeeAmount, il tutto proporzionato alla data di annullamento.

• Se la policy di destinazione ha un StandardTaxAmount, tale valore viene ripartito sulla data di annullamento e restituito tramite il campo TermTaxAmount nell'output.

• Se la policy di destinazione ha un StandardFeeAmount, tale valore viene ripartito sulla data di annullamento e restituito tramite il campo TermFeeAmount nell'output.

• Se la policy di destinazione ha InsurancePolicySurcharge rimborsabili o record AssetPricingAdjustment__c, gli importi ripartiti dei rimborsi vengono restituiti tramite i campi refundedTax e refundedFee nell'output. Un InsurancePolicySurcharge o un AssetPricingAdjustment__c è rimborsabile se il PriceListEntry__c associato è rimborsabile. Gli importi dei rimborsi ripartiti vengono calcolati sulla data di annullamento e sulla data di scadenza originale.

Opzioni remote

Input JSON

Questo servizio accetta un JSON di input che include il effectiveDate (data da annullare).

{
    "Id": "02i6g000002f07VAAQ",
    "effectiveDate": "08/12/2019"
}

JSON di output

Il servizio restituisce la differenza di prezzo calcolata per la polizza con la nuova data di cancellazione.

{
  "Id": "02i6g000002f07VAAQ",
  "output": {
    "refundedFee": -3.68,
    "totalFeeForTerm": 14.06,
    "refundedTax": -37.93,
    "totalTaxForTerm": 144.84,
    "aggregateTotalPremiumForTerms": 4002.28,
    "priceDiff": -420.97,
    "totalPremiumForTerm": 1448.44,
    "errorCode": "INVOKE-200",
    "error": "OK"
  }
}

Chiavi e valori di output