Loading
Vakuutus
InsPolicyService:createRenewalQuote

Olet tässä:

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

InsPolicyService:createRenewalQuote

Käytä tätä palvelua luodaksesi tarjouksen olemassa olevan käytännön uusimiseksi.

Luokka: InsPolicyService

Metodi: createRenewalQuote

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 tarjousobjektin 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 luo mahdollisuustietueen käyttämällä input-arvosta saatuja OpportunityDetails JSON-noodeja. Katso syötetty JSON-esimerkki. Tämä noodi hyväksyy vain nämä kolme pakollista kenttää:

    • Nimi

    • StageName

    • CloseDate

    Huomautus
    Huomautus Muita mahdollisuuskenttiä ei voi sisällyttää tähän noodiin. Voit kuitenkin päivittää mahdollisuustietueen lisätiedoilla, kun tarjouksen uusiminen on luotu.

  5. Palvelu luo tarjouksen, jonka tyyppi on 'Renewal' ja linkittää sen edellisessä vaiheessa luotuun mahdollisuustietueeseen.

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.

additionalFields

Valinnainen

Näiden lisäkenttien avainarvoparit, jotka eivät ole osa tätä palvelua. Nämä kentät täytetään tarjousobjektissa.

opportunityDetails

Uusimisen mahdollisuuden lisätiedot, jotka on linkitetty uusimisen tarjoukseen. Jos tätä noodia ei ole, palvelu ottaa mahdollisuuden lisätiedot käyttöön alkuperäisen käytännön lähdetarjoukseen linkitetystä mahdollisuudesta.

Etäasetukset

Etävaihtoehto

Kuvaus

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ä

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ä

term

Valinnainen

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

pricebook

Valinnainen

Quote.Pricebook2Id:lle kohdistetun PriceBook2-tietueen nimi. Oletusarvo on vakio.

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 instanceKey. Tämä taulukko välitetään laskentatoimenpiteeseen, jotta vakuutusmaksut lasketaan oikein.

Palvelu käyttää tätä vaihtoehtoa vakuutuksen uudelleenhinnoittelussa.

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ää tätä vaihtoehtoa vakuutuksen uudelleenhinnoittelussa.
failOnRatingFailure

Valinnainen

Määrittää, epäonnistuuko palvelu, jos arvosana ei palauta tulosta uusimisen aikana.

Kun arvo on true, palvelu pysähtyy ja palauttaa virheen. Kun arvo on false, palvelu jatkaa ja luo uusittavan tarjouksen ilman arvosanan tuloksia.

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"
    },
    "OpportunityDetails": {
      "Name": "Renewal Opportunity",
      "StageName": "Qualification",
      "CloseDate": "2023-04-04"
    }
}

Tulos-JSON

Uusinnan tarjouksen quoteId ja opportunityId.

Alla on esimerkki tuloksen JSON-tiedostosta:

{
  "quoteId": "0Q0B0000000A0YEKA0",
  "opportunityId": "006B0000006zdiAIAQ",
}
 
Ladataan
Salesforce Help | Article