InsPolicyService:cancelPolicy

Denna tjänst fungerar med InsPolicyService:prepareToCancelPolicy och med InsPolicyRevenueScheduleService:cancelRevenueSchedule för att utföra alla ändringar som behövs för att annullera en policy, ange ett återbetalningsbelopp och avsluta intäktsschemat (om det behövs).

Klass: InsPolicyService

Metod: cancelPolicy

Denna tjänst fungerar med Salesforce Financial Services Cloud.

Så här fungerar det

1. Tar assetId eller policyId av policyn som ska annulleras och effectiveDate då annulleringen träder i kraft.

   

   Anteckning Giltighetsdatumet för annullering kan inte vara högre än idag.

2. Uppdaterar policystatusen till Canceled, det ursprungliga utgångsdatumet till det aktuella värdet för utgångsdatumet och utgångsdatumet till en dag innan annulleringsdatumet (med tidsstämpeln 23:59).

3. Ändrar utgångsdatumet till effectiveDate som skickas till tjänsten med tidsstämpeln 23:59.

4. 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 betalningsschema 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. Justerar betalningsscheman baserat på antingen det aktuella datumet eller annulleringsdatumet, beroende på vilket som inträffar senare. Om betalningsscheman på eller efter detta datum har Is Paid inställt till false (avmarkerat) tar tjänsten bort dem.

   4. Uppdaterar statusen för alla obetalda betalningsplaner (som har passerats från cancellationDate) till Invalid. Det obetalda beloppet läggs till i den nya betalningsplanen.

   5. Skapar en ny betalningsplan för det aktuella datumet med ett belopp som motsvarar det redan beräknade återbetalningsbeloppet och markerar statusen som Valid. Om createTransaction är sant skapar tjänsten en annulleringstransaktion.

   6. Uppdaterar alla framtida policyversioner med information om annullering:

      • Status: Avbruten

      • Annulleringsdatum: effectiveDate som skickas till tjänsten

      • Termpremie, Termskatt och Termsavgift: 0

      • Utgångsdatum: Dagen innan effectiveDate skickades till tjänsten med en tidsstämpel på 23:59

5. Skickar den proportionerliga TotalPremiumForTerm till databasen.

6. Om createTransaction=true och ID:t som skickas är assetId, skapas AssetTransaction_c (Amount_c=refund, postDate_c och transactionDate_c=effectiveDate, type=transactionType (som standard Avbruten). Om createTransaction=true och ID:t är policyId skapar tjänsten InsurancePolicyTransaction_c eller InsurancePolicyTransaction (Amount_c=refund, postDate_c och transactionDate_c=effectiveDate, type=transactionType (som standard Avbruten).

   Tjänsten fyller även i transaktionsfördelningsdata i transaktionsdetaljobjektet. Den visar data om hur mycket varje tillgång, deltagare och täckning bidrar till det totala transaktionsbeloppet i form av premier, skatter och avgifter. Endast de tillgångar, deltagare och täckningar som har minst ett icke-nollvärde för premier, skatter och avgifter visas.

7. Anropar InsPolicyRevenueScheduleService:cancel med assetId och det nyligen skapade transactionId.

8. The InsPolicyRevenueScheduleService: annullera service beräknar slutet på intäktsschemat och publicerar resultaten i sektionen intäktsschema i policyn. Återbetalningsbeloppen är från försäkringsbolagets perspektiv. Ett negativt belopp resulterar i en återbetalning till försäkringstagaren och ett positivt belopp motsvarar ett obetalt belopp från försäkringstagaren.

Anteckning

Tjänsten har även stöd för annullering av policyer där den ursprungliga policyversionen har en varaktighet på mindre än 365 dagar, eller mindre än 366 dagar under ett skottår. Se Överväganden och begränsningar för försäkringspolicyer.

Tillägg (skatter och avgifter)

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

• Om målpolicyn har ett TotalTaxAmount__c beräknas värdet över annulleringsdatumet och anges i fältet TotalTaxForTerm__c.

• Om målpolicyn har ett TotalFeeAmount__c beräknas värdet över annulleringsdatumet och anges i fältet TotalFeeForTerm__c.

• Om alternativet createTransaction (se nedan) är inställt till sant och målpolicyn har poster för återbetalningsbara AssetPricingAdjustment__c anges de proportionella återbetalningsbeloppen i transaktionens fält TaxAmount__c och FeeAmount__c.

Om du använder objektmodellen Försäkringspolicy (istället för objektmodellen Tillgång) är fältnamnen annorlunda:

• TotalTaxAmount__c = StandardTaxAmount

• TotalTaxForTerm__c = TermTaxAmount

• TotalFeeAmount__c = StandardFeeAmount

• TotalFeeForTerm__c = TermFeeAmount

• AssetPricingAdjustment__c = InsurancePolicySurcharge

• TaxAmount__c = TransactionTaxAmount

• FeeAmount__c = TransactionFeeAmount

Tips

Vill du lära dig mer om att övergå från objektmodellen Tillgång till objektmodellen Försäkringspolicy? Läs Harmonisera försäkringspolicyer.

Fjärralternativ

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

Indata-JSON

Denna tjänst tar inte en JSON för indata.

JSON för utdata

Om du använder objektmodellen Tillgång returnerar denna tjänst en JSON output. Exempel:

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

Om du använder objektmodellen Försäkringspolicy returnerar denna tjänst en JSON results. Exempel:

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