InsPolicyService:cancelPolicy

Tämä palvelu toimii yhdessä InsPolicyService:prepareToCancelPolicy- ja InsPolicyRevenueScheduleService:cancelRevenueSchedule-palvelun kanssa suorittaakseen kaikki muutokset, jotka ovat tarpeen vakuutuksen peruuttamiseksi, hyvityksen tarjoamiseksi ja tuottoaikataulun päättämiseksi (tarvittaessa).

Luokka: InsPolicyService

Metodi: cancelPolicy

Tämä palvelu toimii Salesforce Financial Services Cloudin kanssa.

Miten se toimii?

1. Vaatii peruutettavan käytännön assetId tai policyId ja effectiveDate, jolloin peruutus astuu voimaan.

   

   Huomautus Voimassaolon peruutuspäivä ei voi olla suurempi kuin tämä päivä.

2. Päivittää vakuutuksen tilaksi Canceled, alkuperäisen erääntymispäivän tämänhetkiseen erääntymispäivän arvoon ja erääntymispäivän peruutuspäivää edeltävään päivään (aikaleima on klo 23.59).

3. Muuttaa vanhenemispäiväksi palveluun välitetyn effectiveDate, jonka aikaleima on klo 23.59.

4. Käyttää sopivaa laskentaprosessia, joka perustuu useIsPaidFlag-arvoon.

   Kun useIsPaidFlag on määritetty arvoon false (ei valittuna), palvelu laskee vakuutuksen Kokonaismaksu ehdolle-, Kokonaismaksu ehdolle- ja Kokonaisvero ehdolle -arvot osittain ja laskee hyvityt summat peruutuspäivän ja vakuutuksen maksamispäivän perusteella. Jos Maksettu päivämääräksi -käytännön arvo on null, palvelu huomioi maksun kokonaan ja käyttää Vanhenemispäivä-arvoa.

   Kun useIsPaidFlag on true (valittuna), palvelu:

   1. Käyttää maksuaikataulua laskeakseen vakuutukselle jo maksetun kokonaissumman. Käytännön maksujen kokonaissumma on maksuaikatauluissa olevien summien summa, jonka arvoksi on määritetty On maksettu true (valittu). Tätä summaa käytetään hyvitysten laskutoimissa.

   2. Suhdistaa vakuutuksen vakuutusmaksujen kokonaissumman ajanjaksoon, vakuutusmaksujen kokonaissumman ajanjaksoon ja vakuutusmaksujen kokonaissumman ajanjaksoon ja laskee hyvityssummat peruutuspäivän ja vakuutukselle jo maksetun kokonaissumman perusteella.

   3. Säätää maksuaikatauluja tämänhetkisen päivämäärän tai peruutuspäivän perusteella, kumpi niistä on myöhemmin. Jos maksuaikataulujen On maksettu -arvoksi on määritetty false (ei valittuna) tai sen jälkeen, palvelu poistaa ne.

   4. Päivittää kaikkien maksamattomien maksuaikataulujen (jotka ovat menneet cancellationDate) tilaksi Invalid. Maksamaton summa lisätään uuteen maksuaikatauluun.

   5. Luo uuden maksuaikataulun tämänhetkiselle päivämäärälle, jonka summa vastaa jo laskettua hyvityksen summaa, ja merkitsee tilan Valid. Jos createTransaction on tosi, palvelu luo peruutuksen transaktion.

   6. Päivittää kaikki tulevat käytännön versiot peruutustiedoilla:

      • Tila: Peruutettu

      • Peruutuspäivä: Palveluun välitetty effectiveDate

      • Term Premium, Term Tax ja Term Fee: 0

      • Vanhenemispäivä: Päivä ennen palveluun välittämää effectiveDate, jonka aikaleima on klo 23.59

5. Sitouttaa suhteutetun TotalPremiumForTerm-arvon tietokantaan.

6. Jos createTransaction=true ja välitetty tunnus on assetId, luo AssetTransaction_c (Amount_c=refund, postDate_c ja transactionDate_c=effectiveDate, type=transactionType (oletusarvo on Peruutettu). Jos createTransaction=true ja välitetty tunnus on policyId, palvelu luo InsurancePolicyTransaction_c tai InsurancePolicyTransaction (Amount_c=refund, postDate_c ja transactionDate_c=effectiveDate, type=transactionType (oletusarvo on Peruutettu).

   Palvelu täyttää myös transaktioiden erittelytiedot transaktion lisätietoobjektiin. Se näyttää tietoja siitä, kuinka paljon jokainen omaisuus, osallistuja ja kattavuus vaikuttaa transaktion kokonaissääntöön vakuutusmaksujen, verojen ja palkkioiden osalta. Näet vain omaisuudet, osallistujat ja kattavuudet, joilla on vähintään yksi muu kuin nolla-arvo vakuutusmaksujen, verojen ja palkkioiden osalta.

7. Kutsuja InsPolicyRevenueScheduleService:cancel käyttämällä assetId ja juuri luotua transactionId.

8. InsPolicyRevenueScheduleService: peruutuspalvelu laskee tuottoaikataulun päättymisen ja lähettää tulokset käytännön tuottoaikataulun osioon. Hyvityksen summat ovat vakuutusyhtiön näkökulmasta. Negatiivinen summa palauttaa vakuutuksen omistajalle ja positiivinen summa edustaa vakuutuksen omistajan maksamatonta summaa.

Huomautus

Palvelu tukee myös vakuutusten peruuttamista, kun vakuutuksen alkuperäinen versio kestää alle 365 päivää tai alle 366 päivää karkausvuodessa. Lisätietoja on kohdassa Vakuutuksissa huomioitavia asioita ja rajoituksia.

Lisämaksut (verot ja maksut)

Tämä palvelu (yhdessä prepareToCancel palvelun kanssa) helpottaa verojen ja palkkioiden osituksia ja hyvityksiä vakuutuksen peruuttamisen yhteydessä. Näin se toimii:

• Jos kohdekäytännöllä on TotalTaxAmount__c, arvo suhteutetaan peruutuspäivään ja määritetään TotalTaxForTerm__c-kenttään.

• Jos kohdekäytännöllä on TotalFeeAmount__c, arvo suhteutetaan peruutuspäivään ja määritetään TotalFeeForTerm__c-kenttään.

• Jos createTransaction-vaihtoehdoksi (katso alla) on määritetty true ja kohdekäytännöllä on hyvitettävät AssetPricingAdjustment__c-tietueet, suhteelliset hyvityssummat määritetään transaktion TaxAmount__c- ja FeeAmount__c-kenttiin.

Jos käytät Vakuutus-objektin mallia (Omaisuus-objektin mallin sijaan), kenttien nimet ovat erilaiset:

• TotalTaxAmount__c = StandardTaxAmount

• TotalTaxForTerm__c = TermTaxAmount

• TotalFeeAmount__c = StandardFeeAmount

• TotalFeeForTerm__c = TermFeeAmount

• AssetPricingAdjustment__c = InsurancePolicySurcharge

• TaxAmount__c = TransactionTaxAmount

• FeeAmount__c = TransactionFeeAmount

Vihje

Haluatko saada lisätietoja Siirtymisestä Omaisuus-objektin mallista Vakuutus-objektin malliin? Lue Vakuutuskäytäntöjen harmonisointi.

Etäasetukset

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

Syötetty JSON

Tämä palvelu ei ota syötettyä JSON-tiedostoa.

Tulos-JSON

Jos käytät Omaisuus-objektin mallia, tämä palvelu palauttaa JSON output -noodin. Alla on esimerkki:

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

Jos käytät Vakuutus-objektin mallia, tämä palvelu palauttaa JSON results -noodin. Alla on esimerkki:

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