InsPolicyService:createPolicyVersion

Denne tjenesten aktiverer policyversjonsbehandling. Alle endringer i en policy spores i forskjellige versjoner av den policyen. Du kan bruke den til å endre policy og avbryte policy OmniScripts og Integrasjonsprosedyrer. Du kan også bruke denne tjenesten til å gjenopprette utløpte og kansellerte poliser.

Denne tjenesten fungerer sammen med Salesforce Financial Services Cloud for valgfri støtte for opprettelse av betalingsplan.

Klasse: InsPolicyService

Metode: createPolicyVersion

Slik virker det

1. Tar assetId eller policyId av gjeldende policy og JSON-koden som er angitt av inputKey.

2. Oppretter en klone av den opprinnelige policyen.

3. Hvis det finnes en eksisterende betalingsplan, oppdaterer tjenesten betalingsplanen og oppretter en betalingsplanoppføring på gyldighetsdatoen for anbefalingen. Hvis useIsPaidFlag er sann, oppdateres alle fremtidige betalingsplanoppføringer (fra gyldighetsdatoen) uten transaksjoner (der statusfeltet er Valid og isPaid ikke er merket av for) basert på nyere verdier for premiebeløp, avgift og avgift. Den nye betalingsplanoppføringen inneholder de justerte verdiene for premiebeløp, avgift og gebyr basert på nye premier, avgifter og gebyrer og oppdaterte betalingsplanoppføringer. Bidragspostene for polisekomponenter i hver betalingsplanoppføring oppdateres også.

4. Tjenesten bruker den forrige polisens beregningsmetode for premiebeløp, betalingstype og frekvens for premiebeløp, og den nye polisens Total Premium for periode, Total avgift for periode og Total avgift for periode til å generere den endrede betalingsplanen. I tillegg til å opprette transaksjonen fylles transaksjonsdetaljdata ut i transaksjonsdetaljobjektet. Dette objektet lagrer data om hvor mye hvert aktivum, deltaker eller dekning bidrar til totalt transaksjonsbeløp når det gjelder premiebeløp, avgifter og gebyrer. Bare aktiva, deltagere og dekninger med minst én verdi større enn null for premiebeløp, avgifter eller gebyrer vises.

   

   Merk Premium Beregningsmetode, Betalingstype og Premium Frequency kopieres ikke over fra den tidligere policyen og må overføres som inndata til tjenesten via JSON-koden.

5. Hvis includeRevenueSchedule er satt til true, kaller den opp omsetningsplantjenesten for å endre omsetningsplanen.

6. Hvis det er den første endringen av denne policyen, stempler tjenesten originalVersionId__c og previousVersionId__c med samme assetId. Hvis dette ikke er den første endringen av denne policyen, overfører tjenesten OriginalVersionId__c til den nye versjonen og stempler den tidligere assetId til PreviousVersionId__c i den nye policyen.

7. Hvis taxesAndFees-, taxAmount- og/eller feeAmount-nodene er inkludert i inndata-JSON-filen, opprettes de tilsvarende avgifts-/godtgjørelsesfeltene og/eller postene og blir fordelt på den nye versjonen av policyen.

8. Det opprettes eventuelt en InsurancePolicyTransaction for betalingsjusteringen.

9. Hvis calculateCommission er true, ringer tjenesten InsurancePolicyService.calculateAndSaveCommission, som klargjør inndata for InsCommissionService.calculate og InsCommissionService.saveCommissions. Når beregningstjenesten har behandlet inndataene, lagrer lagringstjenesten den beregnede verdien i TotalCommissionAmount, og deretter oppsummerer den verdien og legger den til i TotalCommissionAmount av den opprinnelige policyen.

10. Hvis disableAttributeCategories-flagget i getquotedetail-tjenesten er satt til true, utelater tjenesten attributeCategory-noden fra svaret, og createPolicyVersion kan ikke opprette policybegreper. For å forsikre deg om at createPolicyVersion-tjenesten oppretter policyvilkår, setter du disableAttributeCategories-flagget i i getQuoteDetail-tjenesten til false.

Merk Tjenesten støtter også anbefalinger av poliser der varigheten av den opprinnelige poliseversjonen er mindre enn 365 dager, eller mindre enn 366 dager i et skuddår. Se Vurderinger og begrensninger for forsikringspoliser.

Skatt og gebyrer

Slik fungerer denne tjenesten for avgifter og gebyrer:

• Hvis taxesAndFees-feltet er angitt i en JSON-post, beholdes en tilhørende AssetPricingAdjustment__c-post for hvert element i taxesAndFees-listen.

• Hvis taxAmount-feltet angis i en JSON-post, angis TaxAmount__c-feltet til verdien i taxAmount-feltet i det opprettede AssetItem-objektet.

• Hvis feeAmount-feltet er angitt i en JSON-post, settes FeeAmount__c-feltet til verdien i feeAmount-feltet i den opprettede AssetItem.

Når det gjelder gjeldende (nylig opprettede policy):

• Hvis gjeldende policy har en TotalTaxAmount__c, blir denne verdien fordelt på gyldighets- og sluttdatoene og angitt i TotalTaxForTerm__c-feltet.

• Hvis gjeldende policy har en TotalFeeAmount__c, blir denne verdien fordelt på gyldighets- og sluttdatoene og angitt i TotalFeeForTerm__c-feltet.

• Hvis AssetItem i gjeldende policy har en TaxAmount__c, blir verdien fordelt på gyldighets- og sluttdatoene og angitt i ProratedTaxAmount__c-feltet.

• Hvis AssetItem i gjeldende policy har en FeeAmount__c, blir verdien fordelt på gyldighets- og sluttdatoene og angitt i ProratedFeeAmount__c-feltet.

Slik overføres avgifter og gebyrer for poliser som allerede er opprettet:

• Hvis den tidligere policyen har en TotalTaxAmount__c, blir denne verdien fordelt på de nye gyldighets- og sluttdatoene, og angis i TotalTaxForTerm__c-feltet.

• Hvis den tidligere policyen har en TotalFeeAmount__c, blir denne verdien fordelt på de nye gyldighets- og sluttdatoene, og angis i TotalFeeForTerm__c-feltet.

• Hvis AssetItem-feltene har en TaxAmount__c, blir denne verdien fordelt på de nye gyldighets- og sluttdatoene og angis i ProratedTaxAmount__c-feltet.

• Hvis AssetItem-feltene i den forrige policyen har en FeeAmount__c, blir denne verdien fordelt på de nye gyldighets- og sluttdatoene og angis i ProratedFeeAmount__c-feltet.

Hvis alternativet createTransaction (se nedenfor) settes til true og den nye poliseversjonen har tilknyttede avgifter og avgifter, settes til slutt TaxAmount__c- og FeeAmount__c-feltene i den opprettede transaksjonen til forskjellen mellom den nye (gjeldende) policyen og den tidligere polisens TotalTaxForTerm__c og TotalFeeForTerm__c.

Eksterne alternativer

Alternativ	Beskrivelse
assetId eller policyId	Obligatorisk. Id'et for den aktuelle policy.
createContactForParticipants	Valgfritt. true eller false Standardverdien er true. Hvis false, oppretter ikke tjenesten kontaktposter.
createInsuredItemsRelationships	true eller false Hvis dette alternativet angis til true, kan du angi 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 som skal brukes av omsetningsplantjenestene.
effectiveDate	“YYYY-MM-DD HH:MM:SS” eller %OmniScriptDataElement% Datoen da policyen trer i kraft. Hvis det ikke er noen effectiveDate-verdi på alternativkartet, ser tjenesten etter den på rootAttributes-kartet. Hvis tjenesten ikke finner en effectiveDate der, bruker den dagens dato. Hvis du bruker Forsikringsbransjeutvidelse-pakken, ignoreres tidsstempelverdien i effectiveDate-alternativet. I stedet settes verdien for gyldighetstidsstempel til 12:00 kl.m. for den valgte gyldighetsdatoen, og verdien for utløpsdatoen settes til 23:59 kl.m. for den valgte utløpsdatoen. Tidsstempelet angis ved å bruke brukerens angitte tidssone.
getDataCustomClassName	Valgfritt. Navnet på den tilpassede klassen denne tjenesten bruker til å hente policyinformasjon (aktivuminformasjon). Hvis du bruker Salesforce FSC, må du angi dette alternativet eller postDataDRBundleName. Standardverdien er satt til GetInsurancePolicy.
getDataDRBundleName	Valgfritt: Navnet på datatilordneren denne tjenesten bruker til å hente policyinformasjon (aktivuminformasjon). Hvis du bruker Salesforce FSC, må du angi dette alternativet eller getDataCustomClassName. Hvis du angir begge, bruker tjenesten getDataDRBundleName-verdien. Hvis du ikke angir noe annet, bruker tjenesten standardverdien for getDataCustomClassName (GetInsurancePolicy).
includePaymentSchedule	Valgfritt. True om betalingsplanen skal oppdateres for polisen. Standard er false.
includeRevenueSchedule	Valgfritt. Brukes bare hvis createTransaction er satt til true. true eller false Hvis true, kaller dette alternativet opp InsPolicyRevenueScheduleService: endre
inputKey	Obligatorisk. %theJSONyouneed%
isCreatingPolicyTerms	true eller false Når det angis til true, returnerer tjenesten en policyTermIds-node i utdata-JSON-koden.
postDataCustomClassName	Valgfritt. Navnet på den tilpassede klassen denne tjenesten bruker til å lagre den nye policyversjonen. Hvis du bruker Salesforce FSC, må du angi dette alternativet eller postDataDRBundleName. Standardverdien er satt til PostInsurancePolicy.
postDataDRBundleName	Valgfritt. Navnet på datatilordneren denne tjenesten bruker til å lagre den nye policyversjonen. Hvis du bruker Salesforce FSC, må du angi dette alternativet eller postDataCustomClassName. Hvis du angir begge, bruker tjenesten postDataDRBundleName-verdien. Hvis du ikke angir noe annet, bruker tjenesten standardverdien for postDataCustomClassName (PostInsurancePolicy).
transactionType	Valgfritt. Brukes bare hvis createTransaction er satt til true. Hvis det ikke oppgis noen verdi for transactionType, brukes som standard Changed/Endorsed.
updateDataCustomClassName	Valgfritt. Oppdaterer gjeldende policy. Hvis du bruker Salesforce FSC, må du angi dette alternativet eller updateDataDRBundleName. Standardverdien er satt til PostInsurancePolicy.
updateDataDRBundleName	Valgfritt. Navnet på datatilordneren denne tjenesten bruker til å oppdatere gjeldende policy. Hvis du bruker Salesforce FSC, må du angi dette alternativet eller updateDataCustomClassName. Hvis du angir begge, bruker tjenesten updateDataDRBundleName-verdien. Hvis du ikke angir noe annet, bruker tjenesten standardverdien for updateDataCustomClassName (PostInsurancePolicy).
useLocalTimezone	true eller false Standardverdien er true. Når den angis til true, bruker denne tjenesten den lokale tidssonen der policyversjonen opprettes. Når det angis til false, bruker denne tjenesten GMT som tidssone.
calculateCommission	true eller false Når det angis til true, beregner tjenesten provisjoner for rotelementene og lagrer det totale beløpet til TotalCommissionAmount. Når det angis til false (standard), beregner ikke tjenesten provisjoner. Merk Hvis du angir dette alternativet til true, må du også skrive inn minst én av produsent- eller produksjonskodeverdiene: producerId, productionCodeId eller productionCodeName.
commissionType	Valgfritt. Type kommisjon (for eksempel Bonus eller Standard).
commissionStatus	Valgfritt. Status for kommisjonen (for eksempel Venter, Betalt eller Fjernet).
producerId	Valgfritt. Den behandlende produsent-IDen, det vil si produsenten som ble brukt til å hente commissionScheduleId og beregne kommisjonsbeløpet. Tildelt til InsurancePolicy.ProducerId.
productionCodeId	Valgfritt. Produktionskode-id'et. Tildelt til InsurancePolicy.ProductionCodeId__c.
productionCodeName	Valgfritt. Produksjonskodenavnet som er overført til InsCommissionService.calculate-tjenesten. Hvis du ikke skriver inn productionCodeId, bruker tjenesten productionCodeName til å slå opp på productionCodeId. Hvis du skriver inn begge verdiene, men de ikke samsvarer, prioriteres productionCodeId.
memberPlanIntegrationProcedure	Starter en tilpasset integreringsprosedyre basert på brukerkonfigurasjonen. Når du bruker dette alternativet, overføres alle alternativer for tjenesten til den tilpassede integrasjonsprosedyren og alle policy-ID-er som inndata for å integreres med objektet, for eksempel forsikringspoliseobjektet med medlemsplanen.
ratingDate	Rangeringsdatoen som ble brukt til å sette pris på inndata-JSON-filen. Merk Du kan ikke overføre et bestemt klokkeslett for ratingField fordi felttypen er Date. Så tidsstempelet for rangeringsdatoen er som standard 12:00.
term	Betingelsen for policyen som tjenesten oppretter. InsPolicyService:createPolicyVersion støtter bare årlige poliseperioder.
useIsPaidFlag	Valgfritt Angir om IsPaid-flagget må være aktivert eller ikke. Hvis true, vurderes isPaid-feltet i betalingsplanoppføringsobjektet ved beregning av premiebeløp, avgifter og gebyrer. Standardverdien er false.

Inndata-JSON

Denne tjenesten ser etter inputKey som er angitt i produkt-JSON-koden.

"policyJson": {
  "productConfigurationDetail": {
    "insuredItems": {
      "Auto": [{
          "instanceKey": "2015 Lexus LX250",
          "autoLicNum": "Lexus",
          "autoModel": "LX150",
          "autoYear": 2015,
          "BodyClass": "Sedan/Saloon",
          "VehicleType": "PASSENGER CAR",
          "isPrimary": true
                                        "isParent": true
        },
        {
          "instanceKey": "2006 Honda Odyssey",
          "autoLicNum": "Honda",
          "autoModel": "Odyssey",
          "autoYear": 2006,
          "BodyClass": "Minivan",
          "VehicleType": "MULTIPURPOSE PASSENGER VEHICLE (MPV)",
          "isPrimary": true
                                        "isParent": true
        },
        {
          "instanceKey": "2018 530 BMW",
          "autoLicNum": "530",
          "autoModel": "BMW",
          "autoYear": 2018,
          "BodyClass": "Sedan/Saloon",
          "VehicleType": "PASSENGER CAR",
          "isPrimary": true
                                        "isParent": true
        },
        {
          "instanceKey": "2016 Camry Toyota",
          "autoLicNum": "Camry",
          "autoModel": "Toyota",
          "autoYear": 2016,
          "BodyClass": "Sedan/Saloon",
          "VehicleType": "PASSENGER CAR",
          "isPrimary": true
                                        "isParent": true
        }
      ],
      "Driver": [{
          "AGE": 20,
          "instanceKey": "Joan Smith",
          "FN": "Joan",
          "GENDER": "Female",
          "LN": "Smith",
          "isPrimary": false
                                        "isParent": false
        },
        {
          "AGE": 30,
          "instanceKey": "John Smith",
          "FN": "John",
          "GENDER": "Male",
          "LN": "Smith",
          "isPrimary": false
                                        "isParent": false
        },
        {
          "AGE": 30,
          "instanceKey": "Robert Henderson",
          "FN": "Robert",
          "GENDER": "Male",
          "LN": "Henderson",
          "isPrimary": false
                                        "isParent": false    
        },
        {
          "AGE": 20,
          "instanceKey": "Kinsey Schell",
          "FN": "Kinsey",
          "GENDER": "Female",
          "LN": "Schell",
          "isPrimary": false
                                        "isParent": false
        }
      ]
    },
    "accountId": "001f400000RrQSrAAN"
  }

Hvis alternativet for ekstern isCreatingPolicyTerms er satt til true, inkluderes en policyTermIds-node. Her er et eksempel på en policyTermIds-node:

{  
   "policyId": "02i6g000000h110AAA",
   "policyTermIds": [
    "a5X6g000001LeUUEA0",
    "a5X6g000001LeUVEA0",
    "a5X6g000001LeUWEA0",
    "a5X6g000001LeUXEA0",
    "a5X6g000001LeUYEA0",
    "a5X6g000001LeUZEA0",
    "a5X6g000001LeUaEAK",
    "a5X6g000001LeUbEAK",
    "a5X6g000001LeUcEAK",
    "a5X6g000001LeUdEAK",
    "a5X6g000001LeUeEAK",
    "a5X6g000001LeUfEAK"
  ]
}

Utdata-JSON

Tjenesten returnerer det nye policyversjonsnummeret i JSON-koden for utdata.

{
    "policyId": "02i0b00000uRwhVAAS"
    "error": "ok"
}