Loading
Försäkring
InsPolicyService:createRenewalPolicy

Du är här:

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

InsPolicyService:createRenewalPolicy

Använd denna tjänst för att skapa en förnyelsepolicy från en befintlig policy.

Klass: InsPolicyService

Metod: createRenewalPolicy

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 policyobjektet, 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 använder includePaymentSchedule och includeRevenueSchedule för att avgöra om betalningsplanen och intäktsplanen måste skapas vid förnyad policy. Om inga alternativ specificeras ärvs samma inställningar från den tidigare policyn.

  5. Tjänsten skapar en policy och markerar den som förnyad policy.

Anteckning
Anteckning

Tjänsten har även stöd för förnyelse av policyer där den ursprungliga policyversionen har en varaktighet på mindre än 365 dagar, eller mindre än 366 dagar under ett skottår. Vid förnyelse är policyns varaktighet 365 dagar, eller 366 dagar för ett skottår. Se Överväganden och begränsningar för försäkringspolicyer.

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.

Om inga userInputs anges tar förnyelsetjänsten den befintliga policyns information och återger den i den förnyade policyn.

additionalFields

Valfri

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

Fjärralternativ

Anteckning
Anteckning Alla fjärralternativ som används i InsProductService:repriceProduct kan även användas med denna tjänst.

Fjärralternativ

Beskrivning

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

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

Om du använder tilläggspaketet Försäkringsbransch ignoreras tidsstämpelvärdet i alternativet renewalEffectiveDate. Istället sätts värdet för giltighetsdatumets tidsstämpel till 12:00 för det valda giltighetsdatumet och värdet för utgångsdatumet sätts till 23:59 för det valda utgångsdatumet. Tidsstämpeln ställs in genom att använda användarens specificerade tidszon.

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 instanceKey. Denna matris skickas till beräkningsförfarandet så att premier beräknas korrekt.

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

Valfritt.

Standardvärdet är true.

Sätt till true för att beräkna skatter och avgifter.

createTransaction

Valfritt.

Sant eller Falskt

Blir som standard Falskt.

Om sant skapar tjänsten en transaktion som används av intäktsschematjänsterna.

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 includeInputKeys för att ändra pris på policyn.

includePaymentSchedule

Valfri

Om sant skapar tjänsten ett betalningsschema för förnyad policy. Om inget värde anges skapar tjänsten en betalningsplan för förnyad policy endast om den finns för den ursprungliga policyn.

includeRevenueSchedule

Valfri

Om sant skapar tjänsten ett intäktsschema för förnyad policy. Om inget värde anges skapar tjänsterna en betalningsplan för förnyad policy endast om den finns för den ursprungliga policyn.

paymentCalculationMethod

Obligatoriskt om värdet på includePaymentSchedule är sant.

Åsidosätter policyns Premium Calculation Method.

paymentFrequency

Krävs om värdet på includePaymentSchedule är sant.

Åsidosätter policyns PremiumFrequency.

paymentType

Krävs om värdet på includePaymentSchedule är sant.

Åsidosätter policyns Premium Payment Type.

ratingDate

Bestämmer värderingsförfarandet för prissättning av den förnyade policyn. Om detta inte anges görs prissättningen baserat på giltighetsdatumet för den förnyade 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.

term

Valfri

Policyns löptid. Den hjälper till att beräkna renewalExpirationDate, om de inte finns i fjärralternativen. InsPolicyService:createRenewalPolicy 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
      }
    ],
   "additionalFields": {
      "BillingName": "John Smith",
      "Description": "This is a renewal quote",
      "Phone": "123456789"
    }
}

JSON för utdata

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

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