Loading
Vakuutus
InsPolicyService:createRenewalPolicy

Olet tässä:

  1. Salesforce-ohje
  2. Asiakirja
  3. Digitaalinen vakuutus

InsPolicyService:createRenewalPolicy

Käytä tätä palvelua luodaksesi uusintakäytännön olemassa olevasta käytännöstä.

Luokka: InsPolicyService

Metodi: createRenewalPolicy

Miten se toimii

  1. Palvelu hyväksyy käytännön uusimisen policyId.

    Huomautus
    Huomautus

    Palvelu välittää userInputs määrittääkseen lisäarvosuhteita hinnan uudelleenlaskemiseen. Lisäksi palvelu käyttää additionalFields-noodia täyttääkseen käytäntöobjektin lisäkenttiä, jotka eivät muutoin kuulu tähän palveluun.

  2. Palvelu tarkastaa uusitun käytännön voimaanastumispäivän ja vanhenemispäivän. Jos tämä ei ole määritetty, palvelu laskee nämä päivämäärät käyttämällä seuraavaa logiikkaa:

    • Voimaanastumispäivä = alkuperäisen käytännön vanhenemispäivä + 1 päivä

    • Vanhenemispäivä = Uuden käytännön voimaanastumispäivä + Uuden käytännön voimassaoloaika

  3. Hinnoittelee vakuutustuotteen uudelleen käyttämällä aggByKey- ja includeInputKey-vaihtoehtoja.

  4. Palvelu käyttää includePaymentSchedule ja includeRevenueSchedule määrittääkseen, täytyykö maksuaikataulu ja tuottoaikataulu luoda uudelle vakuutukselle. Jos vaihtoehtoja ei ole määritetty, samat asetukset peritään edellisestä käytännöstä.

  5. Palvelu luo käytännön ja merkitsee sen uusituksi käytännöksi.

Huomautus
Huomautus

Palvelu tukee lisäksi käytäntöjen uusimista, kun alkuperäinen käytäntöversio kestää alle 365 päivää tai alle 366 päivää karkausvuodessa. Käytännön kesto on kuitenkin 365 päivää, eli 366 päivää karkausvuodelle. Lisätietoja on kohdassa Vakuutuksissa huomioitavia asioita ja rajoituksia.

Syötteet

Input

Kuvaus

policyId

Pakollinen

Uusittavan käytännön tunnus.

userInputs

Valinnainen

Käytäntöön liittyvien tuotteiden lisätiedot. Minkä tahansa tuotteen kohdemuoto userInputs-objektille saadaan tuotenäkymän API-välilehden palvelun luettelosta. Objektin avaimet ovat muodossa ProductCode.AttributeCode, jossa ProductCode on tuotteen koodi, siihen liittyvät kattavuusmääritykset, vakuutetun kohteen määritykset tai arvosanan faktat.

Jos userInputs-arvoa ei ole annettu, uusintapalvelu ottaa olemassa olevan käytännön tiedot ja toistaa ne uudistetussa käytännössä.

additionalFields

Valinnainen

Näiden lisäkenttien avainarvoparit, jotka eivät ole osa tätä palvelua. Nämä kentät täytetään käytännön objektissa.

Etäasetukset

Huomautus
Huomautus Kaikkia InsProductService:repriceProduct:ssä käytettyjä etäasetuksia voidaan käyttää myös tämän palvelun kanssa.

Etävaihtoehto

Kuvaus

renewalExpirationDate

Valinnainen

Uudistetun käytännön vanhenemispäivä. Jos arvoa ei ole määritetty, se määritetään seuraavalla logiikalla:

Uuden käytännön voimaanastumispäivä + Uuden käytännön voimaanastumispäivä

renewalEffectiveDate

Valinnainen

Uudistetun käytännön voimaanastumispäivä. Jos arvoa ei ole annettu, se lasketaan seuraavalla logiikalla:

Olemassa olevan käytännön vanhenemispäivä + 1 päivä

Jos käytät Insurance Industries Extension -pakettia, aikaleiman arvoa ei huomioida renewalEffectiveDate-vaihtoehdossa. Sen sijaan voimaanastumispäivän aikaleiman arvoksi asetetaan valitun voimaanastumispäivän klo 00.00.00 ja vanhenemispäivän arvoksi asetetaan valitun vanhenemispäivän kello 23.59. Aikaleima määritetään käyttämällä käyttäjän määrittämää aikavyöhykettä.

aggByKey

Pakollinen

PRODUCT.instanceKey

Palvelu lähettää tämän vaihtoehdon input-arvona laskentatoimenpiteeseen, joka käyttää sitä suorittaakseen laskutoimen aggregoinnilla.

Esimerkiksi autovakuutussopimuksella voi olla useita kuljettajia kussakin vakuutetussa ajoneuvossa. Vakuutetulla ajoneuvolla on erillinen instanceKey jokaiselle vakuutuksen esiintymälle. aggByKey ottaa kaikki instanssin avaimet ajoneuvoille ja luo kattavuusmaksujen taulukon per instanssinKey. Tämä taulukko välitetään laskentatoimenpiteeseen, jotta vakuutusmaksut lasketaan oikein.

Palvelu käyttää tätä arvoa vakuutuksen uudelleenhinnoittelussa.
calculateTaxesAndFees

Valinnainen.

Oletusarvo on true.

Valitse true laskeaksesi verot ja maksut.

createTransaction

Valinnainen.

Tosi tai epätosi

Oletusarvo on False.

Jos arvo on true, palvelu luo transaktion, jota tuottoaikataulupalvelut käyttävät.

includeInputKeys

Pakollinen

Pilkuilla erotettujen avain-arvojen parien merkkijono, jonka palvelu välittää laskentavaiheeseen ja pois.

Nämä avain-arvojen parit sisältyvät CalculatedPriceData-objektin output-tuoteobjektiin. Ne auttavat sinua jäsentämään laskentatulokset.

Vain laskentatoimenpiteen käyttämillä avaimilla on arvo tuloksissa.

Palvelu käyttää käytäntöä uudelleenhinnoituksessa includeInputKeys.

includePaymentSchedule

Valinnainen

Jos arvo on true, palvelu luo maksuaikataulun uusitulle käytännölle. Jos arvoa ei ole annettu, palvelu luo maksuaikataulun uusitulle käytännölle vain, jos se on olemassa alkuperäiselle käytännölle.

includeRevenueSchedule

Valinnainen

Jos arvo on true, palvelu luo tuottoaikataulun uusitulle käytännölle. Jos arvoa ei ole annettu, palvelut luovat maksuaikataulun uusitulle käytännölle vain, jos se on olemassa alkuperäiselle käytännölle.

paymentCalculationMethod

Pakollinen, jos includePaymentSchedule-arvo on true.

Korvaa käytännön Premium Calculation Method-arvon.

paymentFrequency

Pakollinen, jos includePaymentSchedule-arvo on true.

Korvaa käytännön PremiumFrequency-arvon.

paymentType

Pakollinen, jos includePaymentSchedule-arvo on true.

Korvaa käytännön Premium Payment Type-arvon.

ratingDate

Määrittää uusitun käytännön hinnoittelun arvostelumenettelyn. Jos tätä ei ole annettu, hinnoittelu suoritetaan uusitun käytännön voimaanastumispäivän perusteella.

Huomautus
Huomautus Et voi välittää tiettyä aikaa ratingField-kenttään, koska kenttätyyppi on Date. Arvioinnin päivämäärän aikaleima on siis oletusarvoisesti klo 00.00.

term

Valinnainen

Käytännön termi. Se auttaa laskemaan renewalExpirationDate, jos etävaihtoehtoja ei ole määritetty. InsPolicyService:createRenewalPolicy tukee vain vuosikäytäntöjen ehtoja..

useLocalTimezone

Tosi tai epätosi

Oletusarvo on true.

Kun arvo on true, palvelu käyttää paikallista aikavyöhykettä, jossa käytäntö luodaan.

Kun arvo on false, palvelut käyttävät aikavyöhykkeenä GMT-aikavyöhykettä.

Syötetty JSON

Alla on esimerkki syötetystä JSON-tiedostosta:

{
   "policyId": "0YT5w000000Y8MNGA0",
   "userInputs": [
      {
        "DRIVER.instanceKey": "Bob Jones",
        "DRIVER.LN": "Jones",
        "DRIVER.GENDER": "Male",
        "DRIVER.FN": "Bobby",
        "DRIVER.AGE": 30,
        "AUTO.instanceKey": "2018 Audi A3",
        "AUTO.autoYear": 2018,
        "AUTO.autoModel": "A4",
        "perAccident": 500
      }
    ],
   "additionalFields": {
      "BillingName": "John Smith",
      "Description": "This is a renewal quote",
      "Phone": "123456789"
    }
}

Tulos-JSON

Alla on esimerkki tuloksen JSON-tiedostosta:

{
  "snapshotId": [
    "00P5w00001fKlqEEAS"
  ],
  "InsurancePolicy": [
    "0YT5w000000Y8tTGAS"
  ]
  "error": "OK"
}
 
Ladataan
Salesforce Help | Article