InsPolicyService:prepareToCancelPolicy

Denne tjeneste skal kaldes før InsPolicyService:cancelPolicy.

Denne tjeneste fungerer med Salesforce Financial Services Cloud.

Kategori: InsPolicyService

Metode: prepareToCancelPolicy

Sådan fungerer det

1. Tager assetId eller policyId og finder den politik, der skal annulleres.

2. Bruger den relevante beregningsproces baseret på useIsPaidFlag.

   Med useIsPaidFlag indstillet til falsk (fravælges) forudsætter tjenesten, at policens samlede præmie for periode, samlede gebyrer for periode og samlede moms for periode fordeles og beregner refunderede beløb baseret på annulleringsdatoen og policens betalingsdato. Hvis Politik betalt til dato er nul, tager tjenesten policen betalt fuldt ud i betragtning og bruger Udløbsdato.

   Med useIsPaidFlag indstillet til true (valgt) gør tjenesten følgende:

   1. Bruger betalingsplaner til at beregne det samlede beløb, der allerede er betalt for policen. Det samlede beløb, der betales for policen, er lig med summen af beløb i betalingsplaner med Er betalt indstillet til true (valgt). Dette beløb bruges i refusionsberegninger.

   2. Fordeler policens samlede præmie for periode, samlede gebyrer for periode og samlede moms for periode, og beregner refusionsbeløb baseret på annulleringsdatoen og det samlede beløb, der allerede er betalt for policen.

3. Tjenesten tager højde for, om gebyrer eller afgifter kan refunderes eller ej.

4. Returnerer prisforskellen mellem den oprindelige samlede præmie for politikken og den annullerede politik i output-JSON.

   • Refusionsbeløbene er fra policeholderens perspektiv. Et positivt beløb repræsenterer en refusion til policeejeren. Et negativt beløb angiver et ubetalt beløb af policeejeren.

5. Hvis moms og gebyrer er inkluderet i denne politik, inkluderes Total Tax For Term, Total Fee For Term, refundedTax og/eller refundedFee også i output-JSON.

   Hvis den politik, som tjenesten annullerer, ikke inkluderer moms eller gebyrer, udelades disse felter fra output-JSON.

Supplerende gebyrer (skatter og gebyrer)

Denne service (sammen med InsPolicyService:cancelPolicy) gør det nemmere at foretage afgifter og refunderinger af skatter og afgifter, når en police annulleres. Sådan fungerer det:

• priceDiff er i det væsentlige refusionsbeløbet og bruger formlen = (gamle GrossWrittenPremium - opdaterede GrossWrittenPremium) + refundedTax + refundedFee.

• Den opdaterede GrossWrittenPremium er den PremiumAmount, der er fordelt på policens ikrafttrædelsesdato og opsigelsesdato.

• Det nye samlede beløb svarer til målpolitikens PremiumAmount plus StandardTaxAmount plus StandardFeeAmount, alt sammen proportionelt til opsigelsesdatoen.

• Hvis målpolitikken har en StandardTaxAmount, fordeles denne værdi i forhold til annulleringsdatoen og returneres via feltet TermTaxAmount i outputtet.

• Hvis målpolitikken har en StandardFeeAmount, fordeles denne værdi i forhold til annulleringsdatoen og returneres via feltet TermFeeAmount i outputtet.

• Hvis målpolitikken har InsurancePolicySurcharge eller AssetPricingAdjustment__c, der kan refunderes, returneres de pro rata refusionsbeløb via felterne refundedTax og refundedFee i outputtet. En InsurancePolicySurcharge eller AssetPricingAdjustment__c kan refunderes, hvis den tilknyttede PriceListEntry__c kan refunderes. De pro rata refusionsbeløb beregnes over annulleringsdatoen og den oprindelige udløbsdato.

Fjernindstillinger

Input JSON

Denne tjeneste tager et input JSON, der inkluderer effectiveDate (dato til at blive annulleret).

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

Output JSON

Tjenesten returnerer den prisforskel, der er beregnet for policen med den nye annulleringsdato.

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

Outputnøgler og værdier