Loading
Forsikring
InsPolicyService:createRenewalQuote

breadcrumbDescription

  1. helpHomeLinkText
  2. docsHomeLinkTextShort
  3. Digital forsikring

InsPolicyService:createRenewalQuote

Brug denne tjeneste til at oprette et fornyelsestilbud for en eksisterende politik.

Kategori: InsPolicyService

Metode: createRenewalQuote

Sådan fungerer det

  1. Tjenesten accepterer policyId for fornyelse af policen.

    Bemærk
    Bemærk

    Tjenesten videregiver userInputs for at fastsætte yderligere vurderingsfaktorer til genberegning af prisen. Tjenesten bruger også additionalFields til at udfylde yderligere felter på tilbudsobjektet, som ellers ikke er en del af denne tjeneste.

  2. Tjenesten kontrollerer for ikrafttrædelsesdatoen og udløbsdatoen for den fornyede politik. Hvis det ikke er angivet, beregner tjenesten disse datoer ved brug af følgende logik:

    • Ikrafttrædelsesdato = Udløbsdato for den oprindelige politik + 1 dag

    • Udløbsdato = Ikrafttrædelsesdato for ny politik + Varighed af den nye politik

  3. Genprissætter policeproduktet ved brug af aggByKey- og includeInputKey-indstillinger.

  4. Tjenesten opretter en salgsmulighedsregistrering ved brug af OpportunityDetails JSON-noden fra inputtet. Se eksempel på input-JSON. Denne node accepterer kun disse tre obligatoriske felter:

    • Navn

    • StageName

    • CloseDate

    Bemærk
    Bemærk Yderligere salgsmulighedsfelter kan ikke inkluderes i denne node. Du kan dog opdatere salgsmulighedsregistreringen med yderligere detaljer, når fornyelsestilbuddet er genereret.

  5. Tjenesten opretter et tilbud af typen "Fornyelse" og linker det til den salgsmulighedsregistrering, der er oprettet i det forrige trin.

Input

Input

Beskrivelse

policyId

Påkrævet

Id'et på den politik, der skal fornyes.

userInputs

Valgfrit

Detaljerne for de produkter, der er knyttet til politikken. For ethvert produkt hentes målformatet for userInputs fra servicelisten på API-fanen i produktvisningen. Objektnøglerne er i formatet ProductCode.AttributeCode, hvor ProductCode er produktkode, tilknyttede dækningsspecifikationer, specifikationer for forsikrede varer eller vurderingsfakta.

additionalFields

Valgfrit

Nøgle-værdi-par af de yderligere felter, der ikke er en del af denne tjeneste. Disse felter udfyldes på tilbudsobjektet.

opportunityDetails

Detaljerne for fornyelsesmuligheden, som er linket til fornyelsestilbuddet. Hvis denne node ikke findes, opsamler tjenesten salgsmulighedsdetaljerne fra den salgsmulighed, der er linket til kildetilbuddet for den oprindelige politik.

Fjernindstillinger

Fjernindstilling

Beskrivelse

renewalEffectiveDate

Valgfrit

Ikrafttrædelsesdato for den fornyede politik. Hvis værdien ikke angives, beregnes den ved brug af følgende logik:

Udløbsdato for eksisterende politik + 1 dag

renewalExpirationDate

Valgfrit

Udløbsdato for den fornyede politik. Hvis ikke angivet, angives værdien ved brug af følgende logik:

Ikrafttrædelsesdato for ny politik + Varighed af ny politik

term

Valgfrit

Politikens periode. Det hjælper med at beregne renewalExpirationDate, hvis ikke angivet i fjernindstillingerne. InsPolicyService:createRenewalQuote understøtter kun årlige politikudtryk.

pricebook

Valgfrit

Navnet på den PriceBook2, der er tildelt til Quote.Pricebook2Id. Standarden er standard.

aggByKey

Påkrævet

PRODUCT.instanceKey

Tjenesten sender denne indstilling som et input til beregningsproceduren, som bruger den til at fuldføre beregningen med aggregering.

En bilforsikringspolice har f.eks. flere chauffører tilknyttet hvert forsikret køretøj. Det forsikrede køretøj har en separat forekomstKey for hver forekomst i policen. aggByKey tager alle forekomstnøglerne til køretøjerne og skaber en række dækningspræmier pr. instanceKey. Denne matriks overføres til beregningsproceduren, så præmier beregnes korrekt.

Tjenesten bruger denne indstilling til at erstatte politikken.

includeInputKeys

Påkrævet

En streng af kommaseparerede nøgle-værdi-par, som tjenesten overfører ind og ud af beregningsproceduren.

Disse nøgle-værdi-par er inkluderet i outputproduktobjektet i CalculatedPriceData. De er der for at hjælpe dig med at parse beregningsresultaterne.

Det er kun nøgler, der bruges af beregningsproceduren, der har en værdi i resultaterne.

Tjenesten bruger denne indstilling til at erstatte politikken.
failOnRatingFailure

Valgfrit

Angiver, om tjenesten skal mislykkes, hvis vurderingen ikke returnerer et resultat under fornyelse.

Når den er sand, stopper tjenesten og returnerer en fejl. Når det er falsk, fortsætter tjenesten og opretter fornyelsestilbuddet uden et vurderingsresultat.

Input JSON

Her er et eksempel på input-JSON:

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

Output JSON

quoteId og opportunityId af fornyelsestilbuddet.

Her er et eksempel på output-JSON:

{
  "quoteId": "0Q0B0000000A0YEKA0",
  "opportunityId": "006B0000006zdiAIAQ",
}
 
Indlæser
Salesforce Help | Article