Loading
Försäkring
InsPolicyService:prepareToCancelPolicy

InsPolicyService:prepareToCancelPolicy

Använd denna tjänst för att beräkna skillnaden mellan premiumpriser innan du avbryter en policy. Tjänsten beräknar premier, avgifter och skattebelopp och beräknar premier, avgifter och skatteåterbetalningar.

Denna tjänst måste åberopas innan InsPolicyService:cancelPolicy.

Denna tjänst fungerar med Salesforce Financial Services Cloud.

Klass: InsPolicyService

Metod: prepareToCancelPolicy

Så här fungerar det

  1. Tar assetId eller policyId och hittar policyn som ska avbrytas.

  2. Använder lämplig beräkningsprocess baserat på useIsPaidFlag.

    Med useIsPaidFlag inställt till falskt (avmarkerat) proportionellerar tjänsten policyns Totala premie för löptid, Totala avgift för löptid och Total skatt för löptid och beräknar återbetalade belopp baserat på Annulleringsdatum och Policy betald till datum. Om Policy betalad till datum är null överväger tjänsten policyn som betalats i sin helhet och använder Förfallodatum.

    Med useIsPaidFlag satt till true (markerat) gör tjänsten följande:

    1. Använder betalningsscheman för att beräkna det totala beloppet som redan betalats för policyn. Det totala beloppet som betalats för policyn är lika med summan av beloppen i betalningsscheman med Är betald satt till sant (markerat). Detta belopp används i återbetalningsberäkningar.

    2. Proportionerar policyns totala premie för löptid, totala avgift för löptid och totala skatt för löptid, och beräknar återbetalningsbelopp baserat på annulleringsdatumet och det totala beloppet som redan betalats för policyn.

  3. Tjänsten överväger om avgifterna eller skatterna är återbetalningsbara eller inte.

  4. Returnerar prisskillnaden mellan den ursprungliga totala premien för policyn och den annullerade policyn i JSON för utdata.

    • Återbetalningsbeloppen är från försäkringstagarens perspektiv. Ett positivt belopp motsvarar en återbetalning till försäkringstagaren. Ett negativt belopp indikerar ett obetalt belopp av försäkringstagaren.

  5. Om skatter och avgifter inkluderas i denna policy inkluderas även Total Tax For Term, Total Fee For Term, refundedTax och/eller refundedFee i JSON för utdata.

    Om policyn som tjänsten annullerar inte inkluderar skatter eller avgifter utelämnas dessa fält från JSON för utdata.

Tillägg (skatter och avgifter)

Denna tjänst (tillsammans med InsPolicyService:cancelPolicy) underlättar proportioner och återbetalningar för skatter och avgifter när en policy annulleras. Så här fungerar det:

  • priceDiff är i huvudsak återbetalningsbeloppet och använder formeln = (gammalt GrossWrittenPremium - uppdaterat GrossWrittenPremium) + refundedTax + refundedFee.

  • Den uppdaterade GrossWrittenPremium är den PremiumAmount som beräknas över policyns giltighetsdatum och annulleringsdatum.

  • Det nya totala beloppet är lika med målpolicyns PremiumAmount plus StandardTaxAmount plus StandardFeeAmount, allt beräknat till annulleringsdatumet.

  • Om målpolicyn har ett StandardTaxAmount beräknas detta värde över annulleringsdatumet och returneras via fältet TermTaxAmount i utdata.

  • Om målpolicyn har ett StandardFeeAmount beräknas detta värde över annulleringsdatumet och returneras via fältet TermFeeAmount i utdata.

  • Om målpolicyn har poster för återbetalningsbara InsurancePolicySurcharge eller AssetPricingAdjustment__c returneras de proportionella återbetalningsbeloppen via fälten refundedTax och refundedFee i utdata. En InsurancePolicySurcharge eller AssetPricingAdjustment__c återbetalas om den associerade PriceListEntry__c återbetalas. De proportionella återbetalningsbeloppen beräknas över annulleringsdatumet och det ursprungliga utgångsdatumet.

Fjärralternativ

Alternativ

Beskrivning

assetId

eller

policyId

Obligatoriskt.

%theIdYouAreLookingFor%

ID för försäkringspolicyn som ska annulleras.

effectiveDate

Obligatoriskt.

“YYYY-MM-DD HH:MM:SS” eller %OmniScriptDataElement%

Datum då policyn kommer att avbrytas.

getDataDRBundleName

Valfritt (endast FSC).

Namnet på Omnistudio Data Mapper som denna tjänst använder för att hämta policyinformation (tillgångsinformation).

Om du använder Salesforce FSC måste du specificera antingen detta alternativ eller getDataCustomClassName.

getDataCustomClassName

Valfritt (endast FSC).

Namnet på den egna klass som denna tjänst använder för att hämta policyinformation (tillgångsinformation).

Om du använder Salesforce FSC måste du specificera antingen detta alternativ eller getDataDRBundleName.

Standardvärdet är satt till GetInsurancePolicy.

useIsPaidFlag

Valfritt.

sant eller falskt

Om sant används den nya proportionslogiken (som överväger betalningsscheman).

Om falskt används den befintliga proportionerliga logiken (som använder annulleringsdatum och paidToDate).

Standardvärdet är inställt till falskt.

Indata-JSON

Denna tjänst tar en JSON för indata som inkluderar effectiveDate (datum som ska avbrytas).

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

JSON för utdata

Tjänsten returnerar prisskillnaden som beräknats för policyn med det nya annulleringsdatumet.

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

Utdatanycklar och värden

Utdata

Beskrivning

Id

ID för policyn (tillgången) eller InsurancePolicy som uppdaterades.

output

  • totalPremiumForTerm: den proportionella totala premien för villkor

  • totalFeeForTerm: den proportionella totala avgiften för villkor

  • totalTaxForTerm: den proportionella totala skatten för villkor

  • aggregateTotalPremiumForTerms: summan av Total premie för löptid för alla policyversioner och den proportionella Total premie för löptid för den aktuella versionen som annulleras

  • refundedFee: beloppet för de avgifter som ska återbetalas

  • refundedTax: beloppet för skatter som ska återbetalas

  • priceDiff: det totala beloppet för premier, avgifter och skatter för återbetalning

 
Laddar
Salesforce Help | Article