Loading
Försäkring
InsPolicyService:createRenewalQuote

Du är här:

  1. Salesforce-hjälp
  2. Dokument
  3. Digital försäkring

InsPolicyService:createRenewalQuote

Använd denna tjänst för att skapa en förnyelseoffert för en befintlig policy.

Klass: InsPolicyService

Metod: createRenewalQuote

Så fungerar det

  1. Tjänsten accepterar policyId av policyn som ska förnyas.

    Anteckning
    Anteckning

    Tjänsten skickar userInputs för att avgöra ytterligare värderingsfaktorer för att omberäkna priset. Tjänsten använder även additionalFields för att fylla i ytterligare fält i offertobjektet, som annars inte är en del av denna tjänst.

  2. Tjänsten kontrollerar giltighetsdatum och utgångsdatum för den förnyade policyn. Om det inte tillhandahålls beräknar tjänsten dessa datum med följande logik:

    • Giltighetsdatum = Förfallodatum för ursprunglig policy + 1 dag

    • Förfallodatum = Giltighetsdatum för den nya policyn + Löptid för den nya policyn

  3. Prissätter policyprodukten med hjälp av alternativen aggByKey och includeInputKey.

  4. Tjänsten skapar en säljprojektpost med OpportunityDetails JSON från indata. Se exempel på JSON för indata. Denna nod accepterar endast dessa tre obligatoriska fält:

    • Namn

    • StageName

    • CloseDate

    Anteckning
    Anteckning Ytterligare säljprojektfält kan inte inkluderas i denna nod. Du kan dock uppdatera säljprojektposten med ytterligare detaljer efter att förnyelseofferten har skapats.

  5. Tjänsten skapar en offert av typen 'Förnyelse' och länkar den till säljprojektposten som skapades i föregående steg.

Indata

Indata

Beskrivning

policyId

Obligatoriskt

ID för policyn som ska förnyas.

userInputs

Valfri

Detaljerna för produkterna som är associerade med policyn. För alla produkter hämtas målformatet för objektet userInputs från servicelistningen på produktvyns API-flik. Objektnycklarna är i formatet ProductCode.AttributeCode där ProductCode är produktkod, associerade täckningsspecifikationer, försäkrade objektspecifikationer eller betygsfakta.

additionalFields

Valfri

Nyckelvärdesparen för de ytterligare fält som inte är en del av denna tjänst. Dessa fält fylls i offertobjektet.

opportunityDetails

Detaljerna om förnyelsemöjligheten, som är länkad till förnyelseofferten. Om denna nod inte finns tar tjänsten upp säljprojektdetaljerna från säljprojektet som är länkat till källcitatet för den ursprungliga policyn.

Fjärralternativ

Fjärralternativ

Beskrivning

renewalEffectiveDate

Valfri

Giltighetsdatum för den förnyade policyn. Om detta inte anges beräknas värdet med följande logik:

Förfallodatum för befintlig policy + 1 dag

renewalExpirationDate

Valfri

Förfallodatum för den förnyade policyn. Om detta inte anges ställs värdet in med följande logik:

Giltighetsdatum för ny policy + Löptid för ny policy

term

Valfri

Policyns löptid. Den hjälper till att beräkna renewalExpirationDate, om de inte finns i fjärralternativen. InsPolicyService:createRenewalQuote har endast stöd för årliga policyvillkor.

pricebook

Valfri

Namnet på den PriceBook2 som tilldelats Quote.Pricebook2Id. Standard är standard.

aggByKey

Obligatoriskt

PRODUCT.instanceKey

Tjänsten skickar detta alternativ som en indata till beräkningsförfarandet, som använder det för att slutföra beräkningen med aggregering.

Till exempel har en autoförsäkring flera förare kopplade till varje försäkrat fordon. Det försäkrade fordonet har en separat instanceKey för varje instans i policyn. aggByKey tar alla instansnycklar för fordonen och skapar en uppsättning täckningspremier per instanceKey. Denna matris skickas till beräkningsförfarandet så att premier beräknas korrekt.

Tjänsten använder detta alternativ för att ändra pris på policyn.

includeInputKeys

Obligatoriskt

En sträng av kommaavgränsade nyckelvärdepar som tjänsten skickar in i och ut ur beräkningsförfarandet.

Dessa nyckelvärdespar inkluderas i utdataproduktobjektet inom CalculatedPriceData. De är till för att hjälpa dig tolka beräkningsresultaten.

Endast nycklar som används av beräkningsförfarandet har ett värde i resultaten.

Tjänsten använder detta alternativ för att ändra pris på policyn.
failOnRatingFailure

Valfri

Anger om tjänsten ska misslyckas om värderingen inte returnerar ett resultat under förnyelsen.

Om sant stoppas tjänsten och returnerar ett fel. Om falskt fortsätter tjänsten och skapar förnyelseofferten utan ett värderingsresultat.

Indata-JSON

Här är ett exempel på indata-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"
    }
}

JSON för utdata

quoteId och opportunityId för förnyelseofferten.

Här är ett exempel på JSON för utdata:

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