Loading
Forsikring
InsPolicyService:prepareToRenewPolicy

InsPolicyService:prepareToRenewPolicy

Bruk denne tjenesten til å beregne beløpet som kreves for fornyelse av en eksisterende policy. Denne tjenesten returnerer fornyelses premiebeløp, avgifter og gebyrer eller JSON-koden for fornyelsespolicyen uten å opprette en policy.

Klasse: InsPolicyService

Metode: prepareToRenewPolicy

Slik fungerer det

  1. Tjenesten godtar policyId for fornyelse av policyen.

  2. Tjenesten kontrollerer gyldighetsdatoen og utløpsdatoen for den fornyede policyen. Hvis ikke, beregner tjenesten disse datoene med følgende logikk:

    • Gyldighetsdato = Utløpsdato for den opprinnelige policyen + 1 dag

    • Utløpsdato = Gyldighetsdato for ny policy + Varighet for den nye policyen

  3. Ompriser poliseproduktet ved bruk av aggByKey- og includeInputKey-alternativer.

  4. Bruker getPolicyJson til å bestemme om bare fornyelsesbeløpskomponenter må returneres eller om fullstendig JSON-fil for poliser skal sendes i svaret.

Inndata

Inndata

Beskrivelse

policyId

Obligatorisk

ID-en til policyen som skal fornyes.

userInputs

Valgfritt

Detaljene om produktene som er knyttet til policyen. For alle produkter hentes målformatet for userInputs-objektet fra tjenesteoppføringen i API-fanen i produktvisningen. Objektnøklene er i formatet ProductCode.AttributeCode der ProductCode er produktkode, tilhørende dekningsspesifikasjoner, spesifikasjoner for forsikrede artikler eller rangeringsfakta.

Eksterne alternativer

Eksternt alternativ

Beskrivelse

aggByKey

Obligatorisk

PRODUCT.instanceKey

Tjenesten sender dette alternativet som inndata til beregningsprosedyren, som bruker det til å fullføre beregningen med aggregering.

En automatisk forsikringspolise kan for eksempel ha flere førere knyttet til hvert forsikrede kjøretøy. Det forsikrede kjøretøyet har en egen forekomstKey for hver forekomst i policyen. aggByKey tar alle forekomstnøklene for kjøretøyene og oppretter en matrise med dekningspremier per forekomstnøkkel. Denne matrisen overføres til beregningsprosedyren slik at premiebeløp beregnes riktig.

Tjenesten bruker dette alternativet til å sette policyen på nytt.

calculateTaxesAndFees

Valgfritt

true eller false

Sett til true for å beregne avgifter og gebyrer for den fornyede policyen.

includeInputKeys

Obligatorisk

En streng med kommadelte nøkkel-verdi-par som tjenesten sender inn og ut av beregningsprosedyren.

Disse nøkkel-verdi-parene inkluderes i utdataproduktobjektet i CalculatedPriceData-objektet. De er der for å hjelpe deg å analysere beregningsresultatene.

Tjenesten bruker dette alternativet til å sette policyen på nytt.

getPolicyJson

Valgfritt

Et boolsk flagg for å bestemme om bare fornyelsesbeløpskomponenter må returneres som svar eller om fullstendig JSON-fil for policyer må returneres.

ratingDate

Bestemmer rangeringsprosedyren for omprising av policyen. Hvis ikke, gjøres prising basert på gyldighetsdatoen for den endrede policyen.

Merk
Merk Du kan ikke overføre et bestemt klokkeslett for ratingField fordi felttypen er Date. Så tidsstempelet for rangeringsdatoen er som standard 12:00.

renewalEffectiveDate

Valgfritt

Gyldighetsdatoen for den fornyede policyen. Hvis ikke, beregnes verdien med følgende logikk:

Utløpsdato for eksisterende policy + 1 dag

renewalExpirationDate

Valgfritt

Utløpsdatoen for den fornyede policyen. Hvis ikke, angis verdien med følgende logikk:

Gyldighetsdato for ny policy + Varighet for den nye policyen

term

Valgfritt

Betingelsen for policyen. Det hjelper beregner renewalExpirationDate, hvis ikke gitt i eksterne alternativer. InsPolicyService:prepareToRenewPolicy støtter bare årlige poliseperioder.

useLocalTimezone

Sann eller Usann

Standardverdien er true.

Når verdien angis som sann, bruker tjenesten den lokale tidssonen som policyen opprettes i.

Når verdien angis som usann, bruker tjenestene GMT som tidssone.

Inndata-JSON

Her er et eksempel på JSON-koden for inndata:

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

Utdata-JSON

Her er et eksempel på JSON-koden for utdata:

{
  "totalFeeForTermDiff": -0.07,
  "totalTaxForTermDiff": 0,
  "totalPremiumForTermDiff": -2.73,
  "newFeeForTerm": 24.93,
  "newTaxForTerm": 0,
  "newPremiumForTerm": 997.27,
  "newFee": 25,
  "newTax": 0,
  "newStandardPremium": 1000
}
 
Laster
Salesforce Help | Article