Loading
Forsikring
InsPolicyService:createRenewalPolicy

breadcrumbDescription

  1. helpHomeLinkText
  2. docsHomeLinkTextShort
  3. Digital forsikring

InsPolicyService:createRenewalPolicy

Brug denne tjeneste til at oprette en fornyelsespolitik fra en eksisterende politik.

Kategori: InsPolicyService

Metode: createRenewalPolicy

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å politikobjektet, 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 bruger includePaymentSchedule og includeRevenueSchedule til at bestemme, om betalingsplanen og omsætningsplanen skal oprettes på fornyet police. Hvis der ikke er angivet nogen indstillinger, overtages de samme indstillinger fra den tidligere politik.

  5. Tjenesten opretter en politik og markerer den som fornyet politik.

Bemærk
Bemærk

Tjenesten understøtter endvidere fornyelse af policer, hvor den oprindelige politikversion har en varighed på mindre end 365 dage eller mindre end 366 dage i et skudår. Men ved fornyelse er policevarigheden 365 dage eller 366 dage for et skudår. Se overvejelser og begrænsninger for forsikringspolicer.

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.

Hvis der ikke leveres nogen userInputs, tager fornyelsestjenesten den eksisterende politiks oplysninger og gengiver dem i den fornyede politik.

additionalFields

Valgfrit

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

Fjernindstillinger

Bemærk
Bemærk Alle fjernindstillinger, der bruges i InsProductService:repriceProduct, kan også bruges med denne tjeneste.

Fjernindstilling

Beskrivelse

renewalExpirationDate

Valgfrit

Udløbsdatoen 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

renewalEffectiveDate

Valgfrit

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

Udløbsdato for eksisterende politik + 1 dag

Hvis du bruger pakken Udvidelse af forsikringssektorer, ignoreres tidsstempelværdien i indstillingen renewalEffectiveDate. I stedet indstilles værdien for det gældende datotidsstempel til 12:00 midnat for den valgte ikrafttrædelsesdato, og værdien for udløbsdatoen indstilles til 23:59 midnat for den valgte udløbsdato. Tidsstemplet angives ved brug af brugerens angivne tidszone.

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øgler for køretøjerne og opretter en opstilling af dækningspræmier pr. instanceKey. Denne matriks overføres til beregningsproceduren, så præmier beregnes korrekt.

Tjenesten bruger denne værdi til at erstatte politikken.
calculateTaxesAndFees

Valgfrit.

Standardværdien er true.

Indstillet til true for at beregne moms og gebyrer.

createTransaction

Valgfrit.

Sand eller Falsk

Standard er Falsk.

Hvis det er sandt, opretter tjenesten en transaktion, der bruges af omsætningsplanen.

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 includeInputKeys til at kompensere for politikken.

includePaymentSchedule

Valgfrit

Hvis det er sandt, opretter tjenesten en betalingsplan på den fornyede politik. Hvis der ikke angives nogen værdi, opretter tjenesten kun en betalingsplan på fornyet politik, hvis den findes for den oprindelige politik.

includeRevenueSchedule

Valgfrit

Hvis det er sandt, opretter tjenesten en omsætningsplan på fornyet politik. Hvis der ikke angives nogen værdi, opretter tjenesterne kun en betalingsplan på fornyet politik, hvis den findes for den oprindelige politik.

paymentCalculationMethod

Krævet, hvis værdien af includePaymentSchedule er sand.

Tilsidesætter policens Premium Calculation Method-værdi.

paymentFrequency

Krævet, hvis værdien af includePaymentSchedule er sand.

Tilsidesætter policens PremiumFrequency-værdi.

paymentType

Krævet, hvis værdien af includePaymentSchedule er sand.

Tilsidesætter policens Premium Payment Type-værdi.

ratingDate

Bestemmer vurderingsproceduren for prissætning af den fornyede politik. Hvis det ikke angives, foretages prissætning baseret på ikrafttrædelsesdatoen for den fornyede politik.

Bemærk
Bemærk Du kan ikke overføre et bestemt tidspunkt for ratingField, da felttypen er Dato. Så vurderingsdatotidsstemplet sættes som standard til 12:00.

term

Valgfrit

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

useLocalTimezone

Sandt eller Falsk

Standardværdien er sand.

Når værdien er angivet som sand, bruger tjenesten den lokale tidszone, som politikken oprettes i.

Når værdien er angivet som falsk, bruger tjenesterne GMT som tidszone.

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

Output JSON

Her er et eksempel på output-JSON:

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