InsPolicyService:cancelPolicy

Deze service werkt samen met de InsPolicyService:prepareToCancelPolicy en met de InsPolicyRevenueScheduleService:cancelRevenueSchedule om alle wijzigingen te voltooien die nodig zijn om een polis te annuleren, een restitutiebedrag op te geven en de omzetplanning te beëindigen (indien nodig).

Klasse: InsPolicyService

Methode: cancelPolicy

Deze service werkt met de Salesforce Financial Services Cloud.

De manier waarop het werkt...

1. Neemt de assetId of policyId van de te annuleren polis en de effectiveDate waarop de annulering van kracht wordt.

   

   Opmerking De ingangsdatum van de annulering kan niet groter zijn dan vandaag.

2. Werkt de polisstatus bij naar Canceled, de oorspronkelijke Vervaldatum naar de huidige waarde van de Vervaldatum en Vervaldatum naar een dag vóór de Annuleringsdatum (met Tijdstempel van 23:59 uur).

3. Wijzigt de vervaldatum in de effectiveDate die is doorgegeven aan de service met een tijdstempel van 23:59 PM.

4. Gebruikt het juiste berekeningsproces op basis van de useIsPaidFlag.

   Als useIsPaidFlag is ingesteld op false (niet geselecteerd), pro rata de Totale premie voor looptijd, Totale kosten voor looptijd en Totale belasting voor looptijd van de polis, en berekent terugbetaalde bedragen op basis van de Annuleringsdatum en de Tot op heden betaalde polis. Als Polis Betaald aan datum null is, houdt de service rekening met de volledig betaalde polis en wordt Vervaldatum gebruikt.

   Met useIsPaidFlag ingesteld op true (geselecteerd), de service:

   1. Gebruikt betalingsschema om het totaalbedrag te berekenen dat al voor de polis is betaald. Het totaalbedrag dat voor de polis is betaald, is gelijk aan de som van bedragen in betalingsschema's met Is betaald ingesteld op true (waar) (geselecteerd). Dit bedrag wordt gebruikt in berekeningen van restituties.

   2. Pro rata van Totale premie voor looptijd, Totale kosten voor looptijd en Totale belasting voor looptijd van de polis, en berekent restitutiebedragen op basis van de annuleringsdatum en het totaalbedrag dat al voor de polis is betaald.

   3. Past betalingsplanningen aan op basis van de huidige datum of de annuleringsdatum, afhankelijk van welke later is. Als betalingsplanningen op of na deze datum Is betaald zijn ingesteld op false (niet geselecteerd), verwijdert de service deze.

   4. Werkt de status bij van alle onbetaalde betalingsschema's (die in het verleden zijn geweest vanaf cancellationDate) naar Invalid. Het onbetaalde bedrag wordt toegevoegd aan de nieuwe betalingsplanning.

   5. Maakt een nieuwe betalingsplanning voor de huidige datum met een bedrag dat gelijk is aan het reeds berekende restitutiebedrag en markeert de status als Valid. Als createTransaction true (waar) is, maakt de service een annuleringstransactie.

   6. Werkt alle toekomstige polisversies bij met annuleringsgegevens:

      • Status: Geannuleerd

      • Annuleringsdatum: De effectiveDate die is doorgegeven aan de service

      • Premie voor termijn, Belasting voor termijn en Termijnkosten: 0

      • Vervaldatum: Dag voordat de effectiveDate aan de service is doorgegeven met een tijdstempel van 23:59 PM

5. Legt de pro rata TotalPremiumForTerm vast in de database.

6. Als createTransaction=true en de doorgegeven ID assetId is, wordt AssetTransaction_c (Amount_c=refund, postDate_c en transactionDate_c=effectiveDate, type=transactionType (standaard geannuleerd) gemaakt. Als createTransaction=true en de doorgegeven ID policyId is, maakt de service InsurancePolicyTransaction_c of InsurancePolicyTransaction (Amount_c=refund, postDate_c en transactionDate_c=effectiveDate, type=transactionType (standaard geannuleerd).

   De service vult ook transactieopsplitsingsgegevens in het transactiedetailobject in. Het geeft gegevens weer over hoeveel elk activum, elke deelnemer en elke dekking bijdraagt aan het totale transactiebedrag in termen van premie, belasting en kosten. Alleen die activa, deelnemers en dekkingen worden weergegeven die minstens één niet-nulwaarde voor premie, belasting en kosten hebben.

7. Roept InsPolicyRevenueScheduleService:cancel aan met behulp van de assetId en de nieuw gemaakte transactionId.

8. De service InsPolicyRevenueScheduleService: cancel berekent het einde van de omzetplanning en post de resultaten in de sectie Omzetplanning van het beleid. De restitutiebedragen zijn vanuit het perspectief van de verzekeringsmaatschappij. Een negatief bedrag resulteert in een restitutie aan de verzekeringnemer en een positief bedrag vertegenwoordigt een niet-betaald bedrag door de verzekeringnemer.

Opmerking

De service ondersteunt ook annulering van polissen waarbij de oorspronkelijke polisversie een duur van minder dan 365 dagen of minder dan 366 dagen in een schrikkeljaar heeft. Zie Overwegingen en beperkingen bij verzekeringspolissen.

Toeslagen (belastingen en toeslagen)

Deze service (samen met de prepareToCancel) faciliteert pro rata en restituties voor belastingen en vergoedingen wanneer een polis wordt geannuleerd. Dat werkt als volgt:

• Als het doelbeleid een TotalTaxAmount__c heeft, wordt die waarde pro rata berekend over de annuleringsdatum en ingesteld op het veld TotalTaxForTerm__c.

• Als het doelbeleid een TotalFeeAmount__c heeft, wordt die waarde pro rata berekend over de annuleringsdatum en ingesteld op het veld TotalFeeForTerm__c.

• Als de createTransaction (zie hieronder) is ingesteld op true (waar) en het doelbeleid AssetPricingAdjustment__c heeft die kunnen worden gerestitueerd, worden de pro rata restitutiebedragen ingesteld voor de TaxAmount__c en FeeAmount__c van de transactie.

Als u het objectmodel Verzekeringspolis gebruikt (in plaats van het objectmodel Activum), zijn de veldnamen anders:

• TotalTaxAmount__c = StandardTaxAmount

• TotalTaxForTerm__c = TermTaxAmount

• TotalFeeAmount__c = StandardFeeAmount

• TotalFeeForTerm__c = TermFeeAmount

• AssetPricingAdjustment__c = InsurancePolicySurcharge

• TaxAmount__c = TransactionTaxAmount

• FeeAmount__c = TransactionFeeAmount

Tip

Wilt u meer weten over de overstap van het objectmodel Activum naar het objectmodel Verzekeringspolis? Lees Verzekeringspolissen harmoniseren.

Externe opties

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

Invoer-JSON

Deze service gebruikt geen invoer-JSON.

Uitvoer-JSON

Als u het objectmodel Activum gebruikt, retourneert deze service een JSON output. Hier is een voorbeeld:

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

Als u het objectmodel Verzekeringspolis gebruikt, retourneert deze service een JSON results. Hier is een voorbeeld:

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