InsPolicyService:cancelPolicy

Denne tjenesten samarbeider med InsPolicyService:prepareToCancelPolicy og med InsPolicyRevenueScheduleService:cancelRevenueSchedule for å fullføre alle endringer som er nødvendige for å kansellere en polise, gi et refusjonsbeløp og avslutte omsetningsplanen (hvis nødvendig).

Klasse: InsPolicyService

Metode: cancelPolicy

Denne tjenesten fungerer sammen med Salesforce Financial Services Cloud.

Slik virker det

1. Tar assetId eller policyId av polisen som skal kanselleres og effectiveDate som kanselleringen trer i kraft.

   

   Merk Gjeldende kanselleringsdato kan ikke være større enn i dag.

2. Oppdaterer policystatusen til Canceled, den opprinnelige utløpsdatoen til den gjeldende verdien i utløpsdatoen, og utløpsdatoen til en dag før kanselleringsdatoen (med tidsstempel på 23:59 PM).

3. Endrer utløpsdatoen til effectiveDate overført til tjenesten med et tidsstempel på 23:59.

4. Bruker den riktige beregningsprosessen basert på useIsPaidFlag.

   Når useIsPaidFlag er angitt til false (ikke valgt), proporsjonerer tjenesten polisens Total Premium for Term, Total Fee for Term og Total Tax For Term, og beregner refunderte beløp basert på kanselleringsdatoen og Policy Paid To Date. Hvis dato for betalt polise er null, vurderer tjenesten betalte poliser fullt ut og bruker Utløpsdato.

   Med useIsPaidFlag angitt til true (valg):

   1. Bruker en betalingsplan til å beregne totalbeløpet som allerede er betalt for policyen. Samlet beløp som betales for polisen, er lik summen av beløp i betalingsplaner der Er betalt er satt til sann (valg). Dette beløpet brukes til beregning av refusjoner.

   2. Fordeler polisens Total Premium for Term, Total Fee for Term og Total Tax for Term, og beregner refusjonsbeløp basert på kanselleringsdatoen og totalbeløpet som allerede er betalt for policyen.

   3. Justerer betalingsplaner basert på den gjeldende datoen eller kanselleringsdatoen, avhengig av hva som er senere. Hvis betalingsplaner på eller etter denne datoen har Er betalt satt til usann (ikke merket), sletter tjenesten dem.

   4. Oppdaterer statusen til alle ikke-betalte betalingsplaner (som er i fortiden fra cancellationDate) til Invalid. Det ubetalte beløpet legges til i den nye betalingsplanen.

   5. Oppretter en ny betalingsplan for gjeldende dato med et beløp lik refusjonsbeløpet som allerede er beregnet, og markerer statusen som Valid. Hvis createTransaction er sann, oppretter tjenesten en kanselleringstransaksjon.

   6. Oppdaterer alle fremtidige policyversjoner med informasjon om kansellering:

      • Status: Kansellert

      • Dato for kansellering: effectiveDate overført til tjenesten

      • Term Premium, Term Tax og Term Fee: 0

      • Utløpsdato: Dagen før effectiveDate overføres til tjenesten med et tidsstempel på 23:59

5. Forplikter den proporsjonale TotalPremiumForTerm-verdien til databasen.

6. Hvis createTransaction=true og ID-en overført er assetId, opprettes AssetTransaction_c (Amount_c=refund, postDate_c og transactionDate_c=effectiveDate, type=transactionType (avbrytes som standard). Hvis createTransaction=true og ID-en overført er policyId, oppretter tjenesten InsurancePolicyTransaction_c eller InsurancePolicyTransaction (Amount_c=refund, postDate_c og transactionDate_c=effectiveDate, type=transactionType (avbrytes som standard).

   Tjenesten fyller også ut transaksjonsdetaljdata i transaksjonsdetaljobjektet. Den viser data om hvor mye hvert aktivum, deltaker og dekning bidrar til totalt transaksjonsbeløp når det gjelder premiebeløp, avgifter og gebyrer. Bare de aktivaene, deltakerne og dekningene som har minst én ikke-nullverdi for premiebeløp, avgifter og gebyrer, vises.

7. Kaller opp InsPolicyRevenueScheduleService:cancel med assetId og den nyopprettede transactionId.

8. InsPolicyRevenueScheduleService: cancel service beregner slutten på omsetningsplanen og legger inn resultatet i omsetningsplandelen av policyen. Refusjonsbeløpene er fra forsikringsselskapets perspektiv. Et negativt beløp fører til en refusjon til forsikringshaveren, og et positivt beløp representerer et ubetalt beløp fra forsikringshaveren.

Merk

Tjenesten støtter også kansellering av poliser der den opprinnelige poliseversjonen har en varighet på mindre enn 365 dager eller mindre enn 366 dager i et skuddår. Se Vurderinger og begrensninger for forsikringspoliser.

Tilleggskostnader (avgifter og avgifter)

Denne tjenesten (sammen med prepareToCancel) letter proporsjoner og refusjoner av skatter og avgifter når en polise kanselleres. Slik fungerer det:

• Hvis målpolicyen har en TotalTaxAmount__c, blir denne verdien fordelt på kanselleringsdatoen og angitt i TotalTaxForTerm__c-feltet.

• Hvis målpolicyen har en TotalFeeAmount__c, blir denne verdien fordelt på kanselleringsdatoen og angitt i TotalFeeForTerm__c-feltet.

• Hvis createTransaction-alternativet (se nedenfor) er satt til true og målpolicyen har refusjonsbare AssetPricingAdjustment__c-poster, angis de proporsjonale refusjonsbeløpene i transaksjonens TaxAmount__c- og FeeAmount__c-felt.

Hvis du bruker Forsikringspolise-objektmodellen (i stedet for Aktivum-objektmodellen), er feltnavnene forskjellige:

• TotalTaxAmount__c = StandardTaxAmount

• TotalTaxForTerm__c = TermTaxAmount

• TotalFeeAmount__c = StandardFeeAmount

• TotalFeeForTerm__c = TermFeeAmount

• AssetPricingAdjustment__c = InsurancePolicySurcharge

• TaxAmount__c = TransactionTaxAmount

• FeeAmount__c = TransactionFeeAmount

Tips

Vil du lære om overgang fra Aktivum-objektmodellen til Forsikringspolise-objektmodellen? Les Harmoniser forsikringspoliser.

Eksterne alternativer

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

Inndata-JSON

Denne tjenesten bruker ikke en inndata-JSON.

Utdata-JSON

Hvis du bruker Aktivum-objektmodellen, returnerer denne tjenesten en JSON output-node. Her er et eksempel:

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

Hvis du bruker objektmodellen Forsikringspolise, returnerer denne tjenesten en JSON results-node. Her er et eksempel:

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