InsPolicyService:createPolicyVersion

Denna tjänst aktiverar policyversioner. Alla ändringar av en policy spåras i olika versioner av den policyn. Du kan använda den i OmniScripts och integreringsprocesser för att ändra policy och annullera policyer. Du kan även använda denna tjänst för att återinföra utgångna och annullerade policyer.

Denna tjänst fungerar med Salesforce Financial Services Cloud för valfritt stöd för att skapa betalningsscheman.

Klass: InsPolicyService

Metod: createPolicyVersion

Så här fungerar det

1. Tar assetId eller policyId av den aktuella policyn och den JSON som anges av inputKey.

2. Skapar en klon av den ursprungliga policyn.

3. Om det finns ett befintligt betalningsschema uppdaterar tjänsten betalningsschemat och skapar en post för betalningsschema på giltighetsdatumet för godkännandet. Om useIsPaidFlag är sant uppdateras alla framtida poster i betalningsplanen (från giltighetsdatum) utan transaktioner (där statusfältet är Valid och isPaid är avmarkerat) baserat på nyare värden för premier, skatter och avgifter. Den nya betalningsplanposten innehåller de justerade värdena för premier, skatter och avgifter baserat på nya premier, skatter och avgifter och uppdaterade betalningsplanposter. Bidragsposterna för policykomponenter i varje betalningsplanpost uppdateras också.

4. Tjänsten använder den tidigare policyns premieberäkningsmetod, betalningstyp och premiefrekvens, och den nya policyns totala premie för löptid, totala avgift för löptid och totala skatt för löptid för att skapa den ändrade betalningsplanen. Utöver skapandet av transaktionen fylls transaktionsfördelningsdata i i transaktionsdetaljobjektet. Detta objekt lagrar data om hur mycket varje tillgång, deltagare eller täckning bidrar till totala transaktionsbelopp i form av premier, skatter och avgifter. Endast tillgångar, deltagare och täckningar med minst ett värde större än noll för premier, skatter eller avgifter visas.

   

   Anteckning Premiumberäkningsmetod, betalningstyp och premiumfrekvens kopieras inte över från tidigare policy och måste skickas som indata till tjänsten genom JSON.

5. Om includeRevenueSchedule är inställd till sant anropar den intäktsschematjänsten för att ändra intäktsschemat.

6. Om det är den första ändringen av denna policy stämplar tjänsten originalVersionId__c och previousVersionId__c med samma assetId. Om detta inte är den första ändringen av denna policy överför tjänsten OriginalVersionId__c till den nya versionen och stämplar den tidigare assetId till PreviousVersionId__c i den nya policyn.

7. Om noderna taxesAndFees, taxAmount och/eller feeAmount inkluderas i indata-JSON skapas och proportionelleras motsvarande skatte-/avgiftsfält och/eller poster i den nya versionen av policyn.

8. Om tillämpligt kommer en InsurancePolicyTransaction att skapas för betalningsjusteringen.

9. Om calculateCommission är true anropar tjänsten InsurancePolicyService.calculateAndSaveCommission som förbereder indata för InsCommissionService.calculate och InsCommissionService.saveCommissions. Efter att tjänsten beräkna bearbetar indata lagrar tjänsten spara det beräknade värdet i TotalCommissionAmount och summerar sedan värdet och lägger till det i TotalCommissionAmount av den ursprungliga policyn.

10. Om flaggan disableAttributeCategories i getquotedetail är inställd till sant utelämnar tjänsten attributeCategory-noden från svaret och createPolicyVersion kan inte skapa policytermer. För att se till att createPolicyVersion skapar policytermer, sätt flaggan disableAttributeCategories i tjänsten i getQuoteDetail till falskt.

Anteckning Tjänsten har även stöd för policyer där varaktigheten för den ursprungliga policyversionen är mindre än 365 dagar, eller mindre än 366 dagar under ett skottår. Se Överväganden och begränsningar för försäkringspolicyer.

Skatter och avgifter

Så här fungerar denna tjänst för skatter och avgifter:

• Om fältet taxesAndFees anges i en JSON-post kvarstår en motsvarande AssetPricingAdjustment__c för varje objekt i taxesAndFees.

• Om fältet taxAmount anges i en JSON-post kommer fältet TaxAmount__c att ställas in till värdet för fältet taxAmount i det skapade AssetItem.

• Om fältet feeAmount är angivet i en JSON-post kommer fältet FeeAmount__c att ställas in till värdet för fältet feeAmount i den skapade AssetItem.

Vad gäller den aktuella (nyskapade policyn):

• Om den aktuella policyn har ett TotalTaxAmount__c fördelas värdet över giltighets- och slutdatum och anges i fältet TotalTaxForTerm__c.

• Om den aktuella policyn har ett TotalFeeAmount__c fördelas värdet över giltighets- och slutdatum och anges i fältet TotalFeeForTerm__c.

• Om AssetItem i den aktuella policyn har ett TaxAmount__c fördelas värdet över giltighets- och slutdatum och anges i fältet ProratedTaxAmount__c.

• Om AssetItem i den aktuella policyn har ett FeeAmount__c fördelas värdet över giltighets- och slutdatum och anges i fältet ProratedFeeAmount__c.

För policyer som redan skapats skickas skatter och avgifter runt så här:

• Om den tidigare policyn har ett TotalTaxAmount__c fördelas värdet över de nya giltighets- och slutdatumen och anges i fältet TotalTaxForTerm__c.

• Om den tidigare policyn har ett TotalFeeAmount__c fördelas värdet över de nya giltighets- och slutdatumen och anges i fältet TotalFeeForTerm__c.

• Om AssetItem-fälten har ett TaxAmount__c fördelas värdet över de nya giltighets- och slutdatumen och anges i fältet ProratedTaxAmount__c.

• Om AssetItem i den tidigare policyn har ett FeeAmount__c fördelas värdet över de nya giltighets- och slutdatumen och anges i fältet ProratedFeeAmount__c.

Slutligen, om alternativet createTransaction (se nedan) är inställt till sant och den nya policyversionen har associerade skatter och avgifter, är fälten TaxAmount__c och FeeAmount__c i den skapade transaktionen inställda till skillnaden mellan den nya (aktuella) policyn och den tidigare policyns TotalTaxForTerm__c och TotalFeeForTerm__c.

Fjärralternativ

Alternativ	Beskrivning
assetId eller policyId	Obligatoriskt. ID för den aktuella policyn.
createContactForParticipants	Valfritt. true eller false true som standard. Om false skapas inga kontaktposter i tjänsten.
createInsuredItemsRelationships	true eller false Om detta alternativ är inställt till sant kan du specificera en lista över instanceKey > parentInstanceKey mellan försäkrade objekt. Detta alternativ har stöd för överordnad > underordnad och överordnad > underordnad > barnbarnsförsäkrade objektrelationer.
createTransaction	Valfritt. true eller false false som standard. Om true skapar tjänsten en transaktion som kommer att användas av intäktsschematjänsterna.
effectiveDate	“YYYY-MM-DD HH:MM:SS” eller %OmniScriptDataElement% Datum då policyn börjar gälla. Om det inte finns något effectiveDate i alternativkartan letar tjänsten efter det i rootAttributes. Om tjänsten inte kan hitta ett effectiveDate där använder den dagens datum. Om du använder tilläggspaketet Försäkringsbransch ignoreras tidsstämpelvärdet i alternativet effectiveDate. Istället sätts värdet för giltighetsdatumets tidsstämpel till 12:00 för det valda giltighetsdatumet och värdet för utgångsdatumet sätts till 23:59 för det valda utgångsdatumet. Tidsstämpeln ställs in genom att använda användarens specificerade tidszon.
getDataCustomClassName	Valfritt. Namnet på den egna klass som denna tjänst använder för att hämta policyinformation (tillgångsinformation). Om du använder Salesforce FSC måste du specificera antingen detta alternativ eller postDataDRBundleName. Standardvärdet är satt till GetInsurancePolicy.
getDataDRBundleName	Valfritt. Namnet på den Datamappning som denna tjänst använder för att hämta policyinformation (tillgångsinformation). Om du använder Salesforce FSC måste du specificera antingen detta alternativ eller getDataCustomClassName. Om du specificerar båda använder tjänsten värdet getDataDRBundleName. Om du inte specificerar något av detta använder tjänsten standardvärdet för getDataCustomClassName (GetInsurancePolicy).
includePaymentSchedule	Valfritt. True om betalningsplanen kommer att uppdateras för policyn. Standard är false.
includeRevenueSchedule	Valfritt. Används endast om createTransaction är inställd till true. true eller false Om true anropar detta alternativ InsPolicyRevenueScheduleService: ändra
inputKey	Obligatoriskt. %theJSONyouneed%
isCreatingPolicyTerms	true eller false När satt till true returnerar tjänsten en policyTermIds i JSON för utdata.
postDataCustomClassName	Valfritt. Namnet på den egna klass som denna tjänst använder för att spara den nya policyversionen. Om du använder Salesforce FSC måste du specificera antingen detta alternativ eller postDataDRBundleName. Standardvärdet är satt till PostInsurancePolicy.
postDataDRBundleName	Valfritt. Namnet på den Datamappning som denna tjänst använder för att spara den nya policyversionen. Om du använder SalesForce FSC måste du specificera antingen detta alternativ eller postDataCustomClassName. Om du specificerar båda använder tjänsten värdet postDataDRBundleName. Om du inte specificerar något av detta använder tjänsten standardvärdet för postDataCustomClassName (PostInsurancePolicy).
transactionType	Valfritt. Används endast om createTransaction är inställd till true. Om inget värde anges för transactionType blir det som standard Changed/Endorsed.
updateDataCustomClassName	Valfritt. Uppdaterar den aktuella policyn. Om du använder Salesforce FSC måste du specificera antingen detta alternativ eller updateDataDRBundleName. Standardvärdet är satt till PostInsurancePolicy.
updateDataDRBundleName	Valfritt. Namnet på den Datamappning som denna tjänst använder för att uppdatera den aktuella policyn. Om du använder Salesforce FSC måste du specificera antingen detta alternativ eller updateDataCustomClassName. Om du specificerar båda använder tjänsten värdet updateDataDRBundleName. Om du inte specificerar något av detta använder tjänsten standardvärdet för updateDataCustomClassName (PostInsurancePolicy).
useLocalTimezone	true eller false true som standard. När satt till true använder denna tjänst den lokala tidszon som policyversionen skapas i. När satt till false använder dessa tjänster GMT som tidszon.
calculateCommission	true eller false När satt till true beräknar tjänsten provisioner för rotobjekten och sparar det totala beloppet till TotalCommissionAmount. När satt till false (standard) beräknar inte tjänsten provisioner. Anteckning Om du ställer in detta alternativ till sant måste du även ange minst ett av producent- eller produktionskodvärdena: producerId , productionCodeId eller productionCodeName.
commissionType	Valfritt. Provisionstyp (till exempel Bonus eller Standard).
commissionStatus	Valfritt. Provisionens status (till exempel Väntande, Betalt eller Avstått).
producerId	Valfritt. ID för bearbetningsproducent, det vill säga den producent som används för att hämta commissionScheduleId och beräkna provisionsbeloppet. Tilldelad till InsurancePolicy.ProducerId.
productionCodeId	Valfritt. ID för produktionskod. Tilldelad till InsurancePolicy.ProductionCodeId__c.
productionCodeName	Valfritt. Namnet på produktionskoden som skickas till tjänsten InsCommissionService.calculate. Om du inte anger productionCodeId använder tjänsten productionCodeName för att söka efter productionCodeId. Om du anger båda värdena men de inte matchar har productionCodeId företräde.
memberPlanIntegrationProcedure	Inleder en egen integreringsprocess baserat på användarkonfigurationen. När du använder detta alternativ skickas alla alternativ för tjänsten till den egna integreringsprocessen och alla policy-ID:n som indata för att integrera med objektet, till exempel försäkringspolicyobjektet med medlemsplanen.
ratingDate	Det värderingsdatum som användes för att prissätta indata-JSON. Anteckning Det går inte att ange en specifik tidpunkt för ratingField eftersom fälttypen är Datum. Så tidsstämpeln för värderingsdatum är som standard 12:00.
term	Termen för policyn som tjänsten skapar. InsPolicyService:createPolicyVersion har endast stöd för årliga policyvillkor.
useIsPaidFlag	Valfri Anger om IsPaid måste aktiveras eller inte. Om sant övervägs isPaid i objektet Betalningsplan vid beräkning av premier, skatter och avgifter. Standardvärdet är falskt.

Indata-JSON

Denna tjänst letar efter den inputKey som specificeras i produktens 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"
  }

Om alternativet isCreatingPolicyTerms är inställt till true inkluderas en policyTermIds. Här är ett exempel på en policyTermIds:

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

JSON för utdata

Tjänsten returnerar det nya versionsnumret för policyn i utdata-JSON.

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