Loading
Forsikring
InsPolicyService:createOutOfSequencePolicyVersion

breadcrumbDescription

  1. helpHomeLinkText
  2. docsHomeLinkTextShort
  3. Digital forsikring

InsPolicyService:createOutOfSequencePolicyVersion

Brug denne tjeneste til at starte en ikke-på-rækkefølge-anbefaling for en given politik.

Kategori: InsPolicyService

Metode: createOutOfSequencePolicyVersion

Tjenesten opretter disse transaktioner for en anbefaling uden for rækkefølge:

  • Ikke-i rækkefølge ændret/anbefales: Samlet ændring i præmie for policeåret som et resultat af anbefaling. I tilfælde af, at flertidspolitikker påvirkes, oprettes transaktionen for hver periode.

  • Anbefaling uden for rækkefølge: Præmiejusteringen for betalingsplanen, når anbefalingen udføres. Det er kun for den aktuelle periode. Indtastningsdatoen for betalingsplanen er den aktuelle dato eller dato for handlingen, når uden for rækkefølge er gældende mellem en forfalden dato og den aktuelle dato. For en fremtidig dato er betalingsplanindtastningsdatoen datoen for ikrafttrædelsesdatoen for anbefaling uden for rækkefølge.

    Vigtigt
    Vigtigt Referencepolitiknummeret skal udfyldes på alle politikversioner på tværs af udtryk.

Sådan fungerer det

  1. Tjenesten tager policyId af den aktuelle politik, ikrafttrædelsesdatoen for den ikke-påfølgende anbefaling og den JSON, der er angivet af inputKey.

  2. Hvis createTransaction er true, opretter tjenesten en transaktion uden for rækkefølge af typen Out-of-Sequence Changed/Endorsed og transaktionsdetaljerne.

  3. Hvis includePaymentSchedule er true, genererer eller opdaterer tjenesten betalingsplaner og betalingsplanoplysninger. Beregningen udføres på basis af værdier, der er valgt for tilsvarende paymentCalculationMethod og paymentFrequency. Betalingsplanen følger de eksisterende betalingsplanregler:

    • Kun fremtidsdaterede ubetalte betalingsplaner opdateres.

    • Tidligere betalingsplaner, betalte eller ubetalte, opdateres aldrig.

    • Alle justeringer for den fortidsdaterede betaling og den betalte betalingsplan er inkluderet i transaktionen Ikke-i rækkefølge-anbefaling.

  4. Tjenesten opdaterer værdien af feltet IsPolicyEditLocked til true på de relaterede forsikringspoliceversioner. Alle politikversioner er låst, indtil anbefalingstransaktionen uden for rækkefølge er fuldført.

Bemærk
Bemærk

Tjenesten understøtter endvidere anbefalinger uden for rækkefølge, hvor den oprindelige politikversion har en varighed på mindre end 365 dage eller mindre end 366 dage i et skudår. Se overvejelser og begrænsninger for forsikringspolicer.

Understøttelse af tilpassede felter

  • Gem de tilpassede felter for objektet Forsikringspolice i feltsættet OutOfSequenceEndorsementCustomFields.

  • Udfyld de tilpassede felter som nøgle-/værdipar i afsnittet additionalFields. Se Input JSON.

  • Brug dette feltsæt OutOfSequenceEndorsementCustomFields til at kopiere tilpassede data fra de annullerede til nye politikversioner under en ikke-på-rækkefølge-anbefaling.

Fjernindstillinger

Indstilling

Beskrivelse
policyId

Påkrævet.

Id'et på en eksisterende politik, som tjenesten opdaterer baseret på nye eller opdaterede oplysninger.
createContactForParticipants

Valgfrit.

true eller false

Standard er true.

Hvis false, opretter tjenesten ikke kontaktregistreringer.
createInsuredItemsRelationships

Valgfrit.

true eller false

Hvis denne indstilling er true, skal du angive en liste over instanceKey > parentInstanceKey relationer mellem forsikrede elementer.

Denne indstilling understøtter overordnede > underordnede og overordnede > underordnede > underunderordnede forsikrede elementrelationer.
createTransaction

Valgfrit.

true eller false

Standard er false.

Hvis true, opretter tjenesten en transaktion.
effectiveDate

Påkrævet.

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

Den dato, hvor ændringer af anbefalinger, der ikke er i rækkefølge, gælder.

includePaymentSchedule

Valgfrit.

true, hvis betalingsplanen er oprettet eller opdateret for policen.

Standarden er false.
inputKey

Påkrævet.

%theJSONyouneed%

En JSON med de nødvendige input til at oprette eller opdatere en politik. Du kan angive en af disse værdier:

  • postDataCustomClassName

  • postDataDRBundleName

    Hvis du ikke angiver en af disse indstillinger, indstilles værdien som standard til postDataCustomClassName.
paymentCalculationMethod Krævet, hvis includePaymentSchedule er sandt. Denne indstilling tilsidesætter politikkens præmieberegningsmetodeværdi.
paymentFrequency Krævet, hvis includePaymentSchedule er sandt. Denne indstilling tilsidesætter politikkens værdi for præmiefrekvens.
paymentType Krævet, hvis includePaymentSchedule er sandt. Denne indstilling tilsidesætter policens præmiebetalingstypeværdi.
postDataCustomClassName

Valgfrit.

Navnet på den tilpassede klasse, som tjenesten bruger til at gemme den nye politikversion.

Du skal angive enten denne indstilling eller postDataDRBundleName.

Standardværdien er PostInsurancePolicy.
postDataDRBundleName

Valgfrit.

Navnet på den Omnistudio-datatilknytning, som tjenesten bruger til at gemme den nye politikversion.

Du skal angive enten denne indstilling eller postDataCustomClassName.

  • Hvis du heller ikke angiver det, bruger tjenesten standardværdien for postDataCustomClassName.
transactionType

Valgfrit.

Hvis der ikke angives nogen værdi for transactionType, indstilles den som standard til Out-of-Sequence Changed/Endorsed.
term

Vilkårene for den politik, som tjenesten opretter.

InsPolicyService:createOutOfSequencePolicyVersion understøtter kun årlige politikudtryk.

Input JSON

Tjenesten søger efter de inputKey, der er angivet i produkt-JSON. Her er eksempel på input-JSON:

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

Her er eksempelindstillingerne JSON:

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

Output JSON

Her er der et eksempel på output-JSON, når tjenesten starter en anbefaling uden for rækkefølge og genererer job-id'et: 

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

Her er eksempelresultat-JSON, når tjenesten returnerer en fejl: 

{
"errorCode": "ERROR-CODE",
"error": "error message"
}
 
Indlæser
Salesforce Help | Article