Loading
Forsikring
InsPolicyService:createRenewalPolicy

Du er her:

  1. Salesforce Hjelp
  2. Dokumenter
  3. Digital forsikring

InsPolicyService:createRenewalPolicy

Bruk denne tjenesten til å opprette en fornyelsespolicy fra en eksisterende policy.

Klasse: InsPolicyService

Metode: createRenewalPolicy

Slik fungerer det

  1. Tjenesten godtar policyId for fornyelse av policyen.

    Merk
    Merk

    Tjenesten overfører userInputs for å bestemme ytterligere rangeringsfaktorer for ny beregning av prisen. Tjenesten bruker også additionalFields-noden til å fylle ut flere felt i policyobjektet, som ellers ikke er en del av denne tjenesten.

  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. Tjenesten bruker includePaymentSchedule og includeRevenueSchedule til å bestemme om betalingsplanen og omsetningsplanen må opprettes på fornyet polise. Hvis ingen alternativer er angitt, arves de samme innstillingene fra den forrige policyen.

  5. Tjenesten oppretter en policy og merker den som fornyet policy.

Merk
Merk

Tjenesten støtter også fornyelse av poliser der den opprinnelige poliseversjonen har en varighet på mindre enn 365 dager eller mindre enn 366 dager i et skuddår. Ved fornyelse er varigheten av policyen imidlertid 365 dager, eller 366 dager for et skuddår. Se Vurderinger og begrensninger for forsikringspoliser.

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, tilknyttede dekningsspesifikasjoner, spesifikasjoner for forsikrede artikler eller rangeringsfakta.

Hvis ingen userInputs oppgis, tar fornyelsestjenesten informasjonen om den eksisterende policyen og gjengir den i den fornyede policyen.

additionalFields

Valgfritt

Nøkkel-verdi-parene for de ekstra feltene som ikke er en del av denne tjenesten. Disse feltene fylles ut i policyobjektet.

Eksterne alternativer

Merk
Merk Alle eksterne alternativer som brukes i InsProductService:repriceProduct, kan også brukes med denne tjenesten.

Eksternt alternativ

Beskrivelse

renewalExpirationDate

Valgfritt

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

Gyldighetsdato for ny policy + Varighet for ny policy

renewalEffectiveDate

Valgfritt

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

Utløpsdato for eksisterende policy + 1 dag

Hvis du bruker Forsikringsbransjeutvidelse-pakken, ignoreres tidsstempelverdien i renewalEffectiveDate-alternativet. I stedet settes verdien for gyldighetstidsstempel til 12:00 kl.m. for den valgte gyldighetsdatoen, og verdien for utløpsdatoen settes til 23:59 kl.m. for den valgte utløpsdatoen. Tidsstempelet angis ved å bruke brukerens angitte tidssone.

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 denne verdien til å sette policyen på nytt.
calculateTaxesAndFees

Valgfritt.

Standardverdien er true.

Sett til true for å beregne avgifter og avgifter.

createTransaction

Valgfritt.

Sann eller Usann

Standardverdien er False.

Hvis true, oppretter tjenesten en transaksjon som brukes av omsetningsplantjenestene.

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.

Bare nøkler som brukes av beregningsprosedyren, har en verdi i resultatet.

Tjenesten bruker includeInputKeys til å endre policyen.

includePaymentSchedule

Valgfritt

Hvis true, oppretter tjenesten en betalingsplan for fornyet polise. Hvis ingen verdi oppgis, oppretter tjenesten en betalingsplan for fornyet polise bare hvis den finnes for den opprinnelige policyen.

includeRevenueSchedule

Valgfritt

Hvis true, oppretter tjenesten en omsetningsplan for fornyet policy. Hvis ingen verdi oppgis, oppretter tjenestene en betalingsplan for fornyet polise bare hvis den finnes for den opprinnelige policyen.

paymentCalculationMethod

Obligatorisk hvis verdien av includePaymentSchedule er sann.

Overstyrer policyens Premium Calculation Method-verdi.

paymentFrequency

Obligatorisk hvis verdien av includePaymentSchedule er sann.

Overstyrer policyens PremiumFrequency-verdi.

paymentType

Obligatorisk hvis verdien av includePaymentSchedule er sann.

Overstyrer policyens Premium Payment Type-verdi.

ratingDate

Bestemmer rangeringsprosedyren for prising av den fornyede policyen. Hvis det ikke oppgis, gjøres prising basert på gyldighetsdatoen for den fornyede 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.

term

Valgfritt

Betingelsen for policyen. Det hjelper beregner renewalExpirationDate, hvis ikke gitt i eksterne alternativer. InsPolicyService:createRenewalPolicy 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
      }
    ],
   "additionalFields": {
      "BillingName": "John Smith",
      "Description": "This is a renewal quote",
      "Phone": "123456789"
    }
}

Utdata-JSON

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

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