Loading
Försäkring
InsPolicyService:prepareToRenewPolicy

Du är här:

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

InsPolicyService:prepareToRenewPolicy

Använd denna tjänst för att beräkna det belopp som krävs för att förnya en befintlig policy. Denna tjänst returnerar förnyelsepremier, skatter och avgifter eller förnyelsepolicyn JSON utan att skapa en policy.

Klass: InsPolicyService

Metod: prepareToRenewPolicy

Så fungerar det

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

  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. Använder getPolicyJson för att avgöra om endast komponenter för förnyelsebelopp måste returneras eller om fullständig policy-JSON skickas i svaret.

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 kod för produkten, associerade täckningsspecifikationer, försäkrade objektspecifikationer eller betygsfakta.

Fjärralternativ

Fjärralternativ

Beskrivning

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 matris av täckningspremier per instansnyckel. 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.

calculateTaxesAndFees

Valfri

true eller false

Sätt till sant för att beräkna skatter och avgifter för den förnyade 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.

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

getPolicyJson

Valfri

En boolesk flagga för att avgöra om endast komponenter för förnyelsebelopp måste returneras som svar eller om fullständig policy-JSON måste returneras.

ratingDate

Bestämmer värderingsförfarandet för att ändra prissättningen av policyn. Om detta inte anges baseras prissättningen på giltighetsdatumet för den ändrade policyn.

Anteckning
Anteckning Det går inte att ange en specifik tidpunkt för ratingField eftersom fälttypen är Datum. Så tidsstämpeln för värderingsdatum är som standard 12:00.

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 den nya policyn + Löptid för den nya policyn

term

Valfri

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

useLocalTimezone

Sant eller Falskt

Standardvärdet är sant.

När värdet är inställt som sant använder tjänsten den lokala tidszon där policyn skapas.

När värdet är inställt som falskt använder tjänsterna GMT som tidszon.

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

JSON för utdata

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

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