InsPolicyService:cancelPolicy

Questo servizio collabora con il servizio InsPolicyService:prepareToCancelPolicy e con il servizio InsPolicyRevenueScheduleService:cancelRevenueSchedule per completare tutte le modifiche necessarie per annullare una polizza, fornire un ammontare di rimborso e terminare la pianificazione del reddito (se necessario).

Classe: InsPolicyService

Metodo: cancelPolicy

Questo servizio funziona con Salesforce Financial Services Cloud.

Funzionamento

1. Prende la assetId o la policyId della polizza da annullare e la effectiveDate in cui la cancellazione ha effetto.

   

   Nota La data di annullamento effettiva non può essere superiore alla data odierna.

2. Aggiorna lo stato della polizza a Canceled, la Data di scadenza originale al valore corrente della Data di scadenza e la Data di scadenza a un giorno prima della Data di annullamento (con indicazione oraria 23:59).

3. Cambia la data di scadenza impostandola sul effectiveDate passato al servizio con un'indicazione oraria delle 23:59.

4. 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 la pianificazione dei pagamenti 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. Rettifica le pianificazioni dei pagamenti in base alla data corrente o alla data di annullamento, a seconda di quale sia la data successiva. Se le pianificazioni di pagamento a partire da questa data sono A pagamento impostate su false (deselezionate), il servizio le elimina.

   4. Aggiorna lo stato di tutte le pianificazioni di pagamento non pagate (passate da cancellationDate) a Invalid. L'importo non pagato viene aggiunto alla nuova pianificazione di pagamento.

   5. Crea una nuova pianificazione di pagamento per la data corrente con un ammontare pari all'ammontare del rimborso già calcolato e contrassegna lo stato come Valid. Se createTransaction è true, il servizio crea una transazione di annullamento.

   6. Aggiorna tutte le versioni future della policy con le informazioni sull'annullamento:

      • Stato: Annullato

      • Data annullamento: Il effectiveDate è passato al servizio

      • Premio durata, imposta durata e commissione durata: 0

      • Data di scadenza: Giorno prima del passaggio del effectiveDate al servizio con indicazione oraria 23:59

5. Impegna TotalPremiumForTerm ripartito nel database.

6. Se createTransaction=true e l'ID passato è assetId, crea AssetTransaction_c (Amount_c=refund, postDate_c e transactionDate_c=effectiveDate, type=transactionType (l'impostazione predefinita è Annullato). Se createTransaction=true e l'ID passato è policyId, il servizio crea InsurancePolicyTransaction_c o InsurancePolicyTransaction (Amount_c=refund, postDate_c e transactionDate_c=effectiveDate, type=transactionType (l'impostazione predefinita è Annullato).

   Il servizio compila anche i dati di suddivisione delle transazioni nell'oggetto dettaglio transazione. Visualizza i dati relativi al contributo di ogni asset, partecipante e copertura all'ammontare totale della transazione in termini di premi, imposte e commissioni. Vengono visualizzati solo gli asset, i partecipanti e le coperture che hanno almeno un valore diverso da zero per premi, imposte e commissioni.

7. Chiama InsPolicyRevenueScheduleService: annulla utilizzando il assetId e il transactionId appena creato.

8. Il servizio InsPolicyRevenueScheduleService: cancel calcola la fine della pianificazione del reddito e pubblica i risultati nella sezione della pianificazione del reddito della policy. Gli importi dei rimborsi sono dal punto di vista della compagnia assicurativa. Un importo negativo si traduce in un rimborso all'assicurato e un importo positivo rappresenta un importo non pagato dall'assicurato.

Nota

Il servizio supporta inoltre l'annullamento delle polizze quando la versione originale della polizza ha una durata inferiore a 365 giorni o inferiore a 366 giorni in un anno bisestile. Vedere Considerazioni e limitazioni per le polizze assicurative.

Supplementi (tasse e commissioni)

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

• Se la policy di destinazione ha un TotalTaxAmount__c, tale valore viene ripartito sulla data di annullamento e impostato sul campo TotalTaxForTerm__c.

• Se la policy di destinazione ha un TotalFeeAmount__c, tale valore viene ripartito sulla data di annullamento e impostato sul campo TotalFeeForTerm__c.

• Se l'opzione createTransaction (vedere sotto) è impostata su true e la policy di destinazione ha record AssetPricingAdjustment__c rimborsabili, gli importi dei rimborsi ripartiti vengono impostati sui campi TaxAmount__c e FeeAmount__c della transazione.

Se si utilizza il modello di oggetto Polizza assicurativa (anziché il modello di oggetto Asset), i nomi dei campi sono diversi:

• TotalTaxAmount__c = StandardTaxAmount

• TotalTaxForTerm__c = TermTaxAmount

• TotalFeeAmount__c = StandardFeeAmount

• TotalFeeForTerm__c = TermFeeAmount

• AssetPricingAdjustment__c = InsurancePolicySurcharge

• TaxAmount__c = TransactionTaxAmount

• FeeAmount__c = TransactionFeeAmount

Suggerimento

Per informazioni sul passaggio dal modello oggetto Asset al modello oggetto Polizza assicurativa, Leggere Armonizzazione delle polizze assicurative.

Opzioni remote

  "additionalFees": {
    "Cancellation Fee": 20,
    "Admin Fee": 10
  }

Input JSON

Questo servizio non accetta un JSON di input.

JSON di output

Se si utilizza il modello di oggetto Asset, questo servizio restituisce un nodo output JSON. Ecco un esempio:

{
  "output": {
    "records": [
      {
        "instest10__TotalAmount__c": 420.97,
        "instest10__TaxAmount__c": 37.93,
        "instest10__FeeAmount__c": 3.68,
        "instest10__Amount__c": 379.36,
        "Id": "a416g0000002CZpAAM"
      }
    ],
    "totalSize": 1
  }
}

Se si utilizza il modello a oggetti Polizza assicurativa, questo servizio restituisce un nodo results JSON. Ecco un esempio:

{
    "result": {
        "type": "Cancelled",
        "transactionNumber": null,
        "transactionDate": 
        "totalAmount": null,
        "taxAmount": null,
        "postDate": "2021-09-01T07:00:00.000Z",
        "name": "Cancelled"
        "Id": null,
        "feeAmount": null,
        "amount": -133.4,
        "additionalInfo": null
    },
    "error": "OK"
}