InsPolicyService:prepareToCancelPolicy

Deze service moet worden aangeroepen vóór de InsPolicyService:cancelPolicy.

Deze service werkt met de Salesforce Financial Services Cloud.

Klasse: InsPolicyService

Methode: prepareToCancelPolicy

De manier waarop het werkt...

1. Neemt de assetId of policyId en vindt de te annuleren polis.

2. 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's 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. De service houdt er rekening mee of de kosten of belastingen al dan niet worden terugbetaald.

4. Retourneert het prijsverschil tussen de oorspronkelijke totale premie voor de polis en de geannuleerde polis in de uitvoer-JSON.

   • De restitutiebedragen zijn vanuit het perspectief van de verzekeringnemer. Een positief bedrag vertegenwoordigt een restitutie aan de verzekeringnemer. Een negatief bedrag geeft een onbetaald bedrag door de verzekeringnemer aan.

5. Als belastingen en vergoedingen zijn inbegrepen in dit beleid, worden de Total Tax For Term, Total Fee For Term, refundedTax en/of refundedFee ook opgenomen in de uitvoer-JSON.

   Als de polis die de service annuleert geen belastingen of kosten omvat, worden deze velden weggelaten uit de uitvoer-JSON.

Toeslagen (belastingen en toeslagen)

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

• De priceDiff is in wezen het restitutiebedrag en gebruikt de formule = (oude GrossWrittenPremium - bijgewerkte GrossWrittenPremium) + refundedTax + refundedFee.

• De bijgewerkte GrossWrittenPremium is de PremiumAmount pro rata over de ingangsdatum en annuleringsdatum van de polis.

• Het nieuwe totaalbedrag is gelijk aan de PremiumAmount van de doelpolis plus de StandardTaxAmount plus de StandardFeeAmount, alles pro rata de annuleringsdatum.

• Als het doelbeleid een StandardTaxAmount heeft, wordt die waarde pro rata berekend over de annuleringsdatum en geretourneerd via het veld TermTaxAmount in de uitvoer.

• Als het doelbeleid een StandardFeeAmount heeft, wordt die waarde pro rata berekend over de annuleringsdatum en geretourneerd via het veld TermFeeAmount in de uitvoer.

• Als de doelpolis InsurancePolicySurcharge of AssetPricingAdjustment__c heeft die kunnen worden gerestitueerd, worden de pro rata restitutiebedragen geretourneerd via de velden refundedTax en refundedFee in de uitvoer. Een InsurancePolicySurcharge of AssetPricingAdjustment__c wordt terugbetaald als de gekoppelde PriceListEntry__c wordt terugbetaald. De pro rata restitutiebedragen worden berekend over de annuleringsdatum en de oorspronkelijke vervaldatum.

Externe opties

Invoer-JSON

Deze service gebruikt een invoer-JSON die de effectiveDate bevat (datum moet worden geannuleerd).

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

Uitvoer-JSON

De service retourneert het prijsverschil dat is berekend voor de polis met de nieuwe annuleringsdatum.

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

Uitvoersleutels en -waarden