Loading
Forsikring
InsPolicyService:createOutOfSequencePolicyVersion

Du er her:

  1. Salesforce Hjelp
  2. Dokumenter
  3. Digital forsikring

InsPolicyService:createOutOfSequencePolicyVersion

Bruk denne tjenesten til å starte en utsolgt anbefaling av en gitt policy.

Klasse: InsPolicyService

Metode: createOutOfSequencePolicyVersion

Tjenesten oppretter disse transaksjonene for en utsolgt anbefaling:

  • Ikke-sekvensiert endret/anbefalt: Total endring i premiebeløpet for poliseåret som et resultat av anbefaling. Hvis flertidspolicyer påvirkes, opprettes transaksjonen for hver periode.

  • Utenforliggende anbefaling: Premiejusteringen for betalingsplanen når anbefalingen utføres. Den er bare for gjeldende term. Betalingsplanoppføringsdatoen er den gjeldende datoen eller datoen for operasjon når utestående er gjeldende mellom en tidligere dato og gjeldende dato. For en fremtidig dato er betalingsplanoppføringsdatoen gyldighetsdatoen for utsolgt anbefaling.

    Viktig
    Viktig Referansepolisenummeret må fylles ut i alle policyversjoner på tvers av vilkår.

Slik virker det

  1. Tjenesten tar policyId av gjeldende policy, gyldighetsdatoen for den utsolgte anbefalingen og JSON-koden som er angitt av inputKey.

  2. Hvis createTransaction er true, oppretter tjenesten en utsolgt transaksjon av typen Out-of-Sequence Changed/Endorsed og transaksjonsdetaljene.

  3. Hvis includePaymentSchedule er true, genererer eller oppdaterer tjenesten betalingsplaner og detaljer om betalingsplanoppføring. Beregningen utføres basert på verdier valgt for tilsvarende paymentCalculationMethod og paymentFrequency alternativer. Betalingsplanen følger de eksisterende betalingsplanreglene:

    • Bare fremtidsdaterte ikke-betalte betalingsplaner oppdateres.

    • Tidligere betalingsplaner, betalt eller ubetalt, oppdateres aldri.

    • Eventuelle justeringer for den tidligere daterte betalingen og den betalte betalingsplanen inkluderes i Transaksjonen Utgående anbefaling.

  4. Tjenesten oppdaterer verdien i IsPolicyEditLocked-feltet til true i de relaterte forsikringspoliseversjonene. Alle policyversjonene låses til den utsolgte anbefalingstransaksjonen er fullført.

Merk
Merk

Tjenesten støtter også anbefalinger utenfor rekkefølgen der den opprinnelige policyversjonen har en varighet på mindre enn 365 dager, eller mindre enn 366 dager i et skuddår. Se Vurderinger og begrensninger for forsikringspoliser.

Støtte for tilpassede felt

  • Lagre de tilpassede feltene i Forsikringspolise-objektet i feltsettet OutOfSequenceEndorsementCustomFields.

  • Fyll ut de tilpassede feltene som nøkkel/verdi-par i additionalFields-delen. Se Inndata-JSON.

  • Bruk dette feltsettet OutOfSequenceEndorsementCustomFields til å kopiere tilpassede data fra de kansellerte til nye policyversjonene under en utsolgt anbefaling.

Eksterne alternativer

Alternativ

Beskrivelse
policyId

Obligatorisk.

ID-en til en eksisterende policy som tjenesten oppdaterer basert på ny eller oppdatert informasjon.
createContactForParticipants

Valgfritt.

true eller false

Standardverdien er true.

Hvis false, oppretter ikke tjenesten kontaktposter.
createInsuredItemsRelationships

Valgfritt.

true eller false

Hvis dette alternativet er true, angir du en liste over instanceKey > parentInstanceKey-relasjoner mellom forsikrede artikler.

Dette alternativet støtter overordnet > underordnet og overordnet > underordnet > barnebarnforsikrede elementrelasjoner.
createTransaction

Valgfritt.

true eller false

Standardverdien er false.

Hvis true, oppretter tjenesten en transaksjon.
effectiveDate

Obligatorisk.

"YYYY-MM-DD HH:MM:SS" eller %OmniScriptDataElement%

Datoen fra når endringer i utsolgt anbefaling gjelder.

includePaymentSchedule

Valgfritt.

true hvis betalingsplanen opprettes eller oppdateres for policyen.

Standard er false.
inputKey

Obligatorisk.

%theJSONyouneed%

En JSON-fil med nødvendige inndata for å opprette eller oppdatere en policy. Du kan angi en av disse verdiene:

  • postDataCustomClassName

  • postDataDRBundleName

    Hvis du ikke angir ett av disse alternativene, angis verdien som standard til postDataCustomClassName.
paymentCalculationMethod Obligatorisk hvis includePaymentSchedule er sann. Dette alternativet overstyrer policyens premiebeløpsberegningsmetodeverdi.
paymentFrequency Obligatorisk hvis includePaymentSchedule er sann. Dette alternativet overstyrer policyens verdi for premiefrekvens.
paymentType Obligatorisk hvis includePaymentSchedule er sann. Dette alternativet overstyrer policyens premiebeløpstypeverdi.
postDataCustomClassName

Valgfritt.

Navnet på den tilpassede klassen tjenesten bruker til å lagre den nye policyversjonen.

Du må angi dette alternativet eller postDataDRBundleName.

Standardverdien er PostInsurancePolicy.
postDataDRBundleName

Valgfritt.

Navnet på Omnistudio-datatilordneren som tjenesten bruker til å lagre den nye policyversjonen.

Du må angi dette alternativet eller postDataCustomClassName.

  • Hvis du ikke angir noe annet, bruker tjenesten standardverdien for postDataCustomClassName.
transactionType

Valgfritt.

Hvis det ikke oppgis noen verdi for transactionType, brukes som standard Out-of-Sequence Changed/Endorsed.
term

Betingelsen for policyen som tjenesten oppretter.

InsPolicyService:createOutOfSequencePolicyVersion støtter bare årlige poliseperioder.

Inndata-JSON

Tjenesten ser etter inputKey spesifisert i produkt-JSON. Her er et eksempel på JSON-koden for inndata:

"newPolicyJSON": {
  "accountId": "001f400000RrQSrAAN",
  "term": "Annual",
  "productConfigurationDetail": {
    ...
  },
  "insuredItems": {
    ...
  },
  "additionalFields": {
    "vlocity_ins__Type__c": "AUTO",
  },
}

Her er et eksempel på JSON-filen for alternativer:

{
   
    "effectiveDate": "2023-03-01",
    "inputKey": "quotepolicyJson",
    "policyId": "0YT3t000000uUz6GAE",
    "includePaymentSchedule": true,
    "createTransaction": true,
    "paymentFrequency": "Monthly",
    "paymentCalculationMethod": "Modal"
  }

Utdata-JSON

Her er et eksempel på JSON-koden for utdata når tjenesten starter en ikke-sekvensiell anbefaling og genererer jobb-IDen: 

 {
"jobId": "7073t0000BNGivxAQD",
"errorCode": "INVOKE-200",
 "error": "OK"
}

Her er et eksempel på JSON-koden for utdata når tjenesten returnerer en feil: 

{
"errorCode": "ERROR-CODE",
"error": "error message"
}
 
Laster
Salesforce Help | Article