InsPolicyService:cancelPolicy

Denne service fungerer sammen med InsPolicyService:prepareToCancelPolicy og med InsPolicyRevenueScheduleService:cancelRevenueSchedule for at udføre alle de ændringer, der er nødvendige for at annullere en police, give et refusionsbeløb og afslutte omsætningsplanen (hvis det er nødvendigt).

Kategori: InsPolicyService

Metode: cancelPolicy

Denne tjeneste fungerer med Salesforce Financial Services Cloud.

Sådan fungerer det

1. Det tager assetId eller policyId af den politik, der skal annulleres, og den effectiveDate, hvor annulleringen træder i kraft.

   

   Bemærk Annulleringsdatoen kan ikke være større end i dag.

2. Opdaterer politikstatus til Canceled, den oprindelige Udløbsdato til den aktuelle værdi for Udløbsdato og Udløbsdato til en dag før Annulleringsdatoen (med tidsstempel på 23:59).

3. Ændrer udløbsdatoen til den effectiveDate, der er overført til tjenesten med et tidsstempel på 23:59.

4. 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 betalingsplan 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. Justerer betalingsplaner baseret på enten den aktuelle dato eller annulleringsdatoen, afhængig af hvad der er senere. Hvis betalingsplaner på eller efter denne dato har Er betalt indstillet til falsk (fravælg), sletter tjenesten dem.

   4. Opdaterer status for alle ubetalte betalingsplaner (som er gået fra cancellationDate) til Invalid. Det ubetalte beløb føjes til den nye betalingsplan.

   5. Opretter en ny betalingsplan for den aktuelle dato med et beløb svarende til det allerede beregnede refusionsbeløb og markerer statussen som Valid. Hvis createTransaction er sandt, opretter tjenesten en annulleringstransaktion.

   6. Opdaterer alle fremtidige politikversioner med annulleringsoplysninger:

      • Status: Annulleret

      • Annulleringsdato: effectiveDate overført til tjenesten

      • Periodepræmie, Periodeskatt og Periodegebyr: 0

      • Udløbsdato: Dagen før effectiveDate gik over til tjenesten med et Tidsstempel på 23:59

5. Bekræfter den proportionelle TotalPremiumForTerm til databasen.

6. Hvis createTransaction=true, og det overførte id er assetId, oprettes AssetTransaction_c (Amount_c=refund, postDate_c og transactionDate_c=effectiveDate, type=transactionType (indstilles som standard til Annulleret). Hvis createTransaction=true, og det overførte id er policyId, opretter tjenesten InsurancePolicyTransaction_c eller InsurancePolicyTransaction (Amount_c=refund, postDate_c og transactionDate_c=effectiveDate, type=transactionType (indstilles som standard til Annulleret).

   Tjenesten udfylder også transaktionsopdelingsdata i transaktionsdetaljeobjektet. Den viser data om, hvor meget hvert aktiv, deltager og dækning bidrager til det samlede transaktionsbeløb i forhold til præmier, moms og gebyrer. Kun de aktiver, deltagere og dækninger, der har mindst en ikke-nul-værdi for præmie, moms og gebyrer, vises.

7. Kaldes InsPolicyRevenueScheduleService:cancel ved brug af assetId og den netop oprettede transactionId.

8. InsPolicyRevenueScheduleService: annulleringstjeneste beregner slutningen af omsætningsplanen og sender resultaterne i afsnittet omsætningsplan for politikken. Refusionsbeløbene er fra forsikringsselskabets perspektiv. Et negativt beløb resulterer i en refusion til policeejeren, og et positivt beløb repræsenterer et ubetalt beløb fra policeejeren.

Bemærk

Tjenesten understøtter endvidere annullering af policer, hvor den oprindelige policeversion har en varighed på mindre end 365 dage eller mindre end 366 dage i et skudår. Se overvejelser og begrænsninger for forsikringspolicer.

Supplerende gebyrer (skatter og gebyrer)

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

• Hvis målpolitikken har en TotalTaxAmount__c, fordeles denne værdi i forhold til annulleringsdatoen og indstilles i feltet TotalTaxForTerm__c.

• Hvis målpolitikken har en TotalFeeAmount__c, fordeles denne værdi i forhold til annulleringsdatoen og angives i feltet TotalFeeForTerm__c.

• Hvis indstillingen createTransaction (se nedenfor) er indstillet til true, og målpolitikken har AssetPricingAdjustment__c, der kan refunderes, angives de pro rata refusionsbeløb i transaktionens TaxAmount__c- og FeeAmount__cfelter.

Hvis du bruger objektmodellen Forsikringspolice (i stedet for aktivobjektmodellen), er feltnavnene forskellige:

• TotalTaxAmount__c = StandardTaxAmount

• TotalTaxForTerm__c = TermTaxAmount

• TotalFeeAmount__c = StandardFeeAmount

• TotalFeeForTerm__c = TermFeeAmount

• AssetPricingAdjustment__c = InsurancePolicySurcharge

• TaxAmount__c = TransactionTaxAmount

• FeeAmount__c = TransactionFeeAmount

Tip

Vil du vide mere om overgangen fra aktivobjektmodellen til objektmodellen Forsikringspolice? Læs Harmoniser forsikringspolicer.

Fjernindstillinger

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

Input JSON

Denne tjeneste bruger ikke et input-JSON.

Output JSON

Hvis du bruger aktivobjektmodellen, returnerer denne tjeneste 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 bruger objektmodellen Forsikringspolice, returnerer denne tjeneste 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"
}