InsPolicyService:createPolicyVersion

Denne tjeneste aktiverer politikversionering. Alle ændringer af en politik spores i forskellige versioner af den pågældende politik. Du kan bruge den i redigere politik og annullere politik OmniScripts og integrationsprocedurer. Du kan også bruge denne tjeneste til at genindstille udløbne og annullerede policer.

Denne tjeneste fungerer med Salesforce Financial Services Cloud for valgfri oprettelsessupport for betalingsplan.

Kategori: InsPolicyService

Metode: createPolicyVersion

Sådan fungerer det

1. Tager assetId eller policyId for den aktuelle politik og den JSON, der er angivet af inputKey.

2. Opretter en dublet af den oprindelige politik.

3. Hvis der er en eksisterende betalingsplan, opdaterer tjenesten betalingsplanen og opretter en betalingsplanpost på ikrafttrædelsesdatoen for anbefalingen. Hvis useIsPaidFlag er sand, opdateres alle fremtidige betalingsplanoplysninger (fra ikrafttrædelsesdatoen) uden transaktioner (hvor statusfeltet er Valid og isPaid ikke er markeret) baseret på nyere værdier for præmie, moms og gebyr. Den nye betalingsplanoplysning indeholder de justerede værdier for præmier, moms og gebyrer baseret på nye præmier, moms og gebyrer og opdaterede betalingsplanoplysninger. Endvidere opdateres bidragsregistreringerne for policekomponenter i hver betalingstidsoplysning.

4. Tjenesten bruger den forrige polices præmieberegningsmetode, betalingstype og præmiefrekvens og den nye polices præmie i alt for periode, gebyr i alt for periode og moms i alt for periode til at generere den ændrede betalingsplan. I tillæg til oprettelsen af transaktionen udfyldes transaktionsopdelingsdata i transaktionsdetaljeobjektet. Dette objekt lagrer data om, hvor meget hvert aktiv, deltager eller dækning bidrager til det samlede transaktionsbeløb i forhold til præmier, moms og gebyrer. Kun aktiver, deltagere og dækninger med mindst en værdi, der er større end nul for præmie, moms eller gebyrer, vises.

   

   Bemærk Premium-beregningsmetode, betalingstype og Premium-frekvens kopieres ikke fra en tidligere politik og skal overføres som input til tjenesten gennem JSON.

5. Hvis includeRevenueSchedule er indstillet til true, kalder det omsætningsplanlægningstjenesten for at redigere omsætningsplanen.

6. Hvis det er den første ændring af denne politik, stempler tjenesten originalVersionId__c og previousVersionId__c med samme assetId. Hvis dette ikke er den første ændring af denne politik, overfører tjenesten OriginalVersionId__c til den nye version og stempler den tidligere assetId til PreviousVersionId__c i den nye politik.

7. Hvis noderne taxesAndFees, taxAmount og/eller feeAmount er inkluderet i input-JSON, oprettes og fordeles de tilsvarende moms-/gebyrfelter og/eller registreringer på den nye version af politikken.

8. Hvis det er relevant, oprettes der en InsurancePolicyTransaction for betalingsjusteringen.

9. Hvis calculateCommission er true, ringer tjenesten til InsurancePolicyService.calculateAndSaveCommission, som forbereder inputtet for InsCommissionService.calculate og InsCommissionService.saveCommissions. Når beregningstjenesten har behandlet inputtet, lagrer lagringstjenesten den beregnede værdi i TotalCommissionAmount og ruller derefter værdien op og føjer den til TotalCommissionAmount af den oprindelige politik.

10. Hvis disableAttributeCategories-flaget i getquotedetail er indstillet til true, udelader tjenesten attributeCategory-noden fra svaret, og createPolicyVersion kan ikke oprette politikudtryk. Hvis du vil sikre, at createPolicyVersion opretter politikudtryk, skal du indstille disableAttributeCategories-flaget i getQuoteDetail til falsk.

Bemærk Tjenesten understøtter endvidere anbefalinger af policer, hvor varigheden af den oprindelige politikversion er mindre end 365 dage eller mindre end 366 dage i et skudår. Se overvejelser og begrænsninger for forsikringspolicer.

Skatter og gebyrer

Sådan fungerer denne tjeneste for moms og gebyrer:

• Hvis feltet taxesAndFees er angivet på en JSON-registrering, bevares der en tilsvarende AssetPricingAdjustment__c for hvert element på taxesAndFees.

• Hvis taxAmount-feltet er angivet på en JSON-registrering, indstilles TaxAmount__c-feltet til værdien af taxAmount-feltet på det oprettede AssetItem-objekt.

• Hvis feeAmount-feltet er angivet på en JSON-registrering, indstilles FeeAmount__c-feltet til værdien af feeAmount-feltet på den oprettede AssetItem.

Hvad angår den aktuelle (nyligt oprettede politik):

• Hvis den aktuelle politik har en TotalTaxAmount__c, er denne værdi fordelt på ikrafttrædelses- og slutdatoer og angivet i feltet TotalTaxForTerm__c.

• Hvis den aktuelle politik har en TotalFeeAmount__c, er denne værdi fordelt på ikrafttrædelses- og slutdatoer og angivet i feltet TotalFeeForTerm__c.

• Hvis AssetItem på den aktuelle politik har en TaxAmount__c, fordeles denne værdi i forhold til ikrafttrædelses- og slutdatoer og angives i feltet ProratedTaxAmount__c.

• Hvis AssetItem på den aktuelle politik har en FeeAmount__c, fordeles denne værdi i forhold til ikrafttrædelses- og slutdatoer og angives i feltet ProratedFeeAmount__c.

For policer, der allerede er oprettet, kan du se her, hvordan moms og gebyrer overføres:

• Hvis den tidligere politik har en TotalTaxAmount__c, fordeles denne værdi i forhold til de nye ikrafttrædelses- og slutdatoer og angives i feltet TotalTaxForTerm__c.

• Hvis den tidligere politik har en TotalFeeAmount__c, fordeles denne værdi i forhold til de nye ikrafttrædelses- og slutdatoer og angives i feltet TotalFeeForTerm__c.

• Hvis felterne AssetItem har en TaxAmount__c, fordeles denne værdi mellem de nye ikrafttrædelses- og slutdatoer og indstilles på feltet ProratedTaxAmount__c.

• Hvis AssetItem-felterne på den forrige politik har en FeeAmount__c, fordeles denne værdi mellem de nye ikrafttrædelses- og slutdatoer og indstilles i feltet ProratedFeeAmount__c.

Hvis indstillingen createTransaction (se nedenfor) indstilles til true, og den nye politikversion har tilknyttede afgifter og afgifter, indstilles felterne TaxAmount__c og FeeAmount__c på den oprettede transaktion til forskellen mellem den nye (aktuelle) politik og den tidligere politiks TotalTaxForTerm__c og TotalFeeForTerm__c.

Fjernindstillinger

Indstilling	Beskrivelse
assetId eller policyId	Påkrævet. Id'et for den aktuelle politik.
createContactForParticipants	Valgfrit. true eller false Standard er true. Hvis false, opretter tjenesten ikke kontaktregistreringer.
createInsuredItemsRelationships	true eller false Hvis denne indstilling er indstillet til true, kan 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, der skal bruges af omsætningsplanen.
effectiveDate	“YYYY-MM-DD HH:MM:SS” eller %OmniScriptDataElement% Den dato, hvor politikken træder i kraft. Hvis der ikke er nogen effectiveDate værdi på valgmulighedskortet, søger tjenesten efter den på rootAttributes. Hvis tjenesten ikke kan finde en effectiveDate der, bruger den dags dato. Hvis du bruger pakken Udvidelse af forsikringssektorer, ignoreres tidsstempelværdien i indstillingen effectiveDate. I stedet indstilles værdien for det gældende datotidsstempel til 00.00.00 fra den valgte ikrafttrædelsesdato, og værdien for udløbsdatoen indstilles til 23:59 for den valgte udløbsdato. Tidsstemplet angives ved brug af brugerens angivne tidszone.
getDataCustomClassName	Valgfrit. Navnet på den tilpassede klasse, denne tjeneste bruger til at hente politikoplysninger (aktiv). Hvis du bruger Salesforce FSC, skal du angive enten denne indstilling eller postDataDRBundleName. Standardværdien er indstillet til GetInsurancePolicy.
getDataDRBundleName	Valgfrit, Navnet på den datatilknytning, denne tjeneste bruger til at hente politikoplysninger (aktiv). Hvis du bruger Salesforce FSC, skal du angive enten denne indstilling eller getDataCustomClassName. Hvis du angiver begge, bruger tjenesten getDataDRBundleName-værdien. Hvis du heller ikke angiver det, bruger tjenesten standardværdien for getDataCustomClassName (GetInsurancePolicy).
includePaymentSchedule	Valgfrit. True om betalingsplanen vil blive opdateret for policen. Standarden er false.
includeRevenueSchedule	Valgfrit. Bruges kun, hvis createTransaction er indstillet til true. true eller false Hvis true, kalder denne indstilling InsPolicyRevenueScheduleService: rediger
inputKey	Påkrævet. %theJSONyouneed%
isCreatingPolicyTerms	true eller false Når den er indstillet til true, returnerer tjenesten en policyTermIds i output-JSON.
postDataCustomClassName	Valgfrit. Navnet på den tilpassede klasse, denne tjeneste bruger til at gemme den nye politikversion. Hvis du bruger Salesforce FSC, skal du angive enten denne indstilling eller postDataDRBundleName. Standardværdien indstilles til PostInsurancePolicy.
postDataDRBundleName	Valgfrit. Navnet på den datatilknytning, denne tjeneste bruger til at gemme den nye politikversion. Hvis du bruger Salesforce FSC, skal du angive enten denne indstilling eller postDataCustomClassName. Hvis du angiver begge, bruger tjenesten postDataDRBundleName-værdien. Hvis du heller ikke angiver det, bruger tjenesten standardværdien for postDataCustomClassName (PostInsurancePolicy).
transactionType	Valgfrit. Bruges kun, hvis createTransaction er indstillet til true. Hvis der ikke angives nogen værdi for transactionType, indstilles den som standard til Changed/Endorsed.
updateDataCustomClassName	Valgfrit. Opdaterer den aktuelle politik. Hvis du bruger Salesforce FSC, skal du angive enten denne indstilling eller updateDataDRBundleName. Standardværdien indstilles til PostInsurancePolicy.
updateDataDRBundleName	Valgfrit. Navnet på den datatilknytning, denne tjeneste bruger til at opdatere den aktuelle politik. Hvis du bruger Salesforce FSC, skal du angive enten denne indstilling eller updateDataCustomClassName. Hvis du angiver begge, bruger tjenesten updateDataDRBundleName-værdien. Hvis du heller ikke angiver det, bruger tjenesten standardværdien for updateDataCustomClassName (PostInsurancePolicy).
useLocalTimezone	true eller false Standard er true. Når den er indstillet til true, bruger denne tjeneste den lokale tidszone, hvor politikversionen oprettes. Når den er indstillet til false, bruger denne tjeneste GMT som tidszone.
calculateCommission	true eller false Når den er indstillet til true, beregner tjenesten kommissioner for rodelementerne og gemmer det samlede beløb til TotalCommissionAmount. Når den er indstillet til false (standarden), beregner tjenesten ikke kommissioner. Bemærk Hvis du indstiller denne indstilling til sand, skal du også angive mindst en af producent- eller produktionskodeværdierne: producerId, productionCodeId eller productionCodeName.
commissionType	Valgfrit. Kommissionstype (f.eks. Bonus eller Standard).
commissionStatus	Valgfrit. Status for kommissionen (f.eks. Afventer, Betalt eller Afvist).
producerId	Valgfrit. Det behandlende producent-id, dvs. den producent, der bruges til at hente commissionScheduleId og beregne kommissionsbeløbet. Tildelt til InsurancePolicy.ProducerId.
productionCodeId	Valgfrit. Produktionskode-id. Tildelt til InsurancePolicy.ProductionCodeId__c.
productionCodeName	Valgfrit. Produktionskodenavnet, der blev overført til InsCommissionService.calculate-tjenesten. Hvis du ikke indtaster productionCodeId, bruger tjenesten productionCodeName til at slå productionCodeId op. Hvis du angiver begge værdier, men de ikke matcher, har productionCodeId forrang.
memberPlanIntegrationProcedure	Starter en tilpasset integrationsprocedure baseret på brugerkonfigurationen. Når du bruger denne indstilling, overfører den alle indstillinger for tjenesten til den tilpassede integrationsprocedure og alle police-id'er som input, der skal integreres med objektet, f.eks. objektet Forsikringspolice med medlemsplanen.
ratingDate	Den vurderingsdato, der blev brugt til at prissætte input-JSON. 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	Vilkårene for den politik, som tjenesten opretter. InsPolicyService:createPolicyVersion understøtter kun årlige politikudtryk.
useIsPaidFlag	Valgfrit Angiver, om IsPaid skal være aktiveret eller ej. Hvis det er sandt, tages isPaid-feltet på betalingsplanindtastningsobjektet med i betragtning under beregning af præmie, moms og gebyrer. Standardværdien er false.

Input JSON

Denne tjeneste søger efter de inputKey, der er angivet i produkt-JSON.

"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 isCreatingPolicyTerms-fjernanmodningen er indstillet til true, inkluderes der en policyTermIds. Her er et eksempel på en policyTermIds:

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

Output JSON

Tjenesten returnerer det nye politikversionsnummer i output-JSON.

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