Loading
Forsikring
InsPolicyService:createRenewalQuote

Du er her:

  1. Salesforce Hjelp
  2. Dokumenter
  3. Digital forsikring

InsPolicyService:createRenewalQuote

Bruk denne tjenesten til å opprette et fornyelsestilbud for en eksisterende policy.

Klasse: InsPolicyService

Metode: createRenewalQuote

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 tilbudsobjektet, 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 oppretter en Salgsmulighet-post ved bruk av OpportunityDetails JSON-noden fra inndataene. Se eksempel på inndata-JSON. Denne noden godtar bare disse tre obligatoriske feltene:

    • Navn

    • StageName

    • CloseDate

    Merk
    Merk Andre salgsmulighetsfelt kan ikke inkluderes i denne noden. Du kan imidlertid oppdatere salgsmulighetsposten med flere detaljer etter at fornyelsestilbudet har blitt generert.

  5. Tjenesten oppretter et tilbud av typen Fornyelse og kobler det til salgsmulighetsposten opprettet i forrige trinn.

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.

additionalFields

Valgfritt

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

opportunityDetails

Detaljene om fornyelsessalgsmuligheten, som er knyttet til fornyelsestilbudet. Hvis denne noden ikke finnes, tar tjenesten opp salgsmulighetsdetaljene fra salgsmuligheten som er knyttet til kilden til den opprinnelige policyen.

Eksterne alternativer

Eksternt alternativ

Beskrivelse

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 ny policy

term

Valgfritt

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

pricebook

Valgfritt

Navnet på PriceBook2 som er tildelt Quote.Pricebook2Id. Standardteksten er standard.

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 rekke deknings premier per instanceKey. Denne matrisen overføres til beregningsprosedyren slik at premiebeløp beregnes riktig.

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

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 dette alternativet til å sette policyen på nytt.
failOnRatingFailure

Valgfritt

Angir om tjenesten skal mislykkes hvis rangeringen ikke returnerer et resultat under fornyelse.

Når true, stopper tjenesten og returnerer en feil. Når false, fortsetter tjenesten og oppretter fornyelsestilbudet uten et rangeringsresultat.

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

Utdata-JSON

quoteId og opportunityId for fornyelsestilbudet.

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

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