InsPolicyService:createPolicyVersion

Tämä palvelu sallii käytäntöjen versioinnin. Käytäntöön tehtyjä muutoksia seurataan sen eri versioissa. Voit käyttää sitä muokataksesi käytäntöä ja peruuttaaksesi käytännön OmniScriptit ja integrointitoimenpiteet. Voit käyttää tätä palvelua myös palauttaaksesi vanhentuneet ja peruutetut vakuutukset.

Tämä palvelu toimii Salesforce Financial Services Cloudin kanssa valinnaisen maksuaikataulun luonnin tueksi.

Luokka: InsPolicyService

Metodi: createPolicyVersion

Miten se toimii?

1. Ottaa nykyisen käytännön assetId- tai policyId-arvon ja inputKey-arvon mukaisen JSON-tiedoston.

2. Luo alkuperäisen käytännön kloonin.

3. Jos maksuaikataulu on olemassa, palvelu päivittää sen ja luo maksuaikataulun merkinnän sen voimaanastumispäivänä. Jos useIsPaidFlag on tosi, kaikki tulevat maksuaikataulun merkinnät (voimaanastumispäivästä alkaen) ilman transaktioita (joiden tila-kenttä on Valid ja isPaid-kenttä ei ole valittuna) päivitetään uusien vakuutusmaksujen, verojen ja maksujen arvojen perusteella. Uusi maksuaikataulun merkintä sisältää vakuutusmaksujen, verojen ja palkkioiden säädetyt arvot uusien vakuutusmaksujen, verojen ja palkkioiden sekä päivitettyjen maksuaikataulun merkintöjen perusteella. Lisäksi kunkin maksuaikataulun merkinnän vakuutuskomponenttien vaikutustietueet päivitetään.

4. Palvelu käyttää aiemman vakuutuksen Premium-laskentatapaa, maksutyyppiä ja Premium-yleisyyttä sekä uuden vakuutuksen Total Premium For Term, Total Fee For Term ja Total Tax For Term -arvoa muokatun maksuaikataulun luomiseksi. Transaktion luomisen lisäksi transaktion erittelytiedot täytetään transaktion lisätietoobjektiin. Tämä objekti tallentaa tietoja siitä, kuinka paljon kukin omaisuus, osallistuja tai kattavuus vaikuttaa transaktioiden kokonaissummien määrään vakuutusmaksujen, verojen ja palkkioiden osalta. Näet vain omaisuudet, osallistujat ja kattavuudet, joiden vakuutusmaksujen, verojen tai palkkioiden vähintään yksi arvo on suurempi kuin nolla.

   

   Huomautus Premium-laskentatapa-, Maksutyyppi- ja Premium-yleisö-kenttiä ei kopioida edellisestä käytännöstä, vaan ne täytyy välittää palveluun syötettynä JSON-tiedoston kautta.

5. Jos includeRevenueSchedule on true, se kutsuu tuottoaikataulun palvelua muokatakseen sen aikataulua.

6. Jos tämä on tämän käytännön ensimmäinen muutos, palvelu merkitsee originalVersionId__c ja previousVersionId__c samoilla assetId. Jos tämä ei ole tämän käytännön ensimmäinen muutos, palvelu siirtää sen OriginalVersionId__c uuteen versioon ja merkitsee edellisen assetId versioon uudessa käytännössä.PreviousVersionId__c

7. Jos taxesAndFees-, taxAmount- ja/tai feeAmount-noodit sisältyvät syötettyyn JSON-tiedostoon, niitä vastaavat veron/maksun kentät ja/tai tietueet luodaan ja suhteutetaan käytännön uuteen versioon.

8. Maksun säädölle luodaan InsurancePolicyTransaction, jos sellainen on.

9. Jos calculateCommission on true, palvelu kutsuu InsurancePolicyService.calculateAndSaveCommission, joka valmistelee InsCommissionService.calculate- ja InsCommissionService.saveCommissions-palveluiden input-arvot. Kun laskentapalvelu käsittelee input-arvon, tallennuspalvelu tallentaa lasketun arvon TotalCommissionAmount-arvoon, kerää arvon ja lisää sen alkuperäisen käytännön TotalCommissionAmount.

10. Jos getquotedetail-palvelun disableAttributeCategories-merkinnäksi on määritetty true, palvelu ohittaa attributeCategory-noodin vastauksesta ja createPolicyVersion-palvelu ei voi luoda käytäntöehtoja. Jos haluat varmistaa, että createPolicyVersion-palvelu luo käytäntöjen ehdot, määritä getQuoteDetail-palvelussa olevan disableAttributeCategories-merkinnän arvoksi false.

Huomautus Palvelu tukee lisäksi käytäntöjen hyväksyntöjä, kun alkuperäisen käytännön version kesto on alle 365 päivää tai alle 366 päivää karkausvuodessa. Lisätietoja on kohdassa Vakuutuksissa huomioitavia asioita ja rajoituksia.

Verot ja maksut

Tämä palvelu toimii verojen ja palkkioiden osalta näin:

• Jos JSON-tietueelle on määritetty taxesAndFees-kenttä, vastaava AssetPricingAdjustment__c-tietue säilyy jokaiselle taxesAndFees-luettelon kohteelle.

• Jos JSON-tietueelle on määritetty taxAmount-kenttä, TaxAmount__c-kentän arvoksi määritetään luodun AssetItem-objektin taxAmount-kentän arvo.

• Jos JSON-tietueelle on määritetty feeAmount-kenttä, FeeAmount__c-kentän arvoksi määritetään luodun AssetItem feeAmount-kentän arvo.

Tämänhetkiseen (uusiin luotuun käytäntöön) liittyen:

• Jos tämänhetkisellä käytännöllä on TotalTaxAmount__c, se suhteutetaan voimaanastumis- ja päättymispäivään ja määritetään TotalTaxForTerm__c-kenttään.

• Jos tämänhetkisellä käytännöllä on TotalFeeAmount__c, se suhteutetaan voimaanastumis- ja päättymispäivään ja määritetään TotalFeeForTerm__c-kenttään.

• Jos tämänhetkisen käytännön AssetItem on TaxAmount__c, arvo suhteutetaan voimaanastumis- ja päättymispäivään ja määritetään ProratedTaxAmount__c-kenttään.

• Jos tämänhetkisen käytännön AssetItem on FeeAmount__c, arvo suhteutetaan voimaanastumis- ja päättymispäivään ja määritetään ProratedFeeAmount__c-kenttään.

Kun käytät jo luotuja vakuutuksia, verot ja maksut siirretään seuraavalla tavalla:

• Jos aiemmalla käytännöllä on TotalTaxAmount__c, kyseinen arvo suhteutetaan uuteen voimaanastumispäivään ja päättymispäivään, ja se määritetään TotalTaxForTerm__c-kenttään.

• Jos aiemmalla käytännöllä on TotalFeeAmount__c, kyseinen arvo suhteutetaan uuteen voimaanastumispäivään ja päättymispäivään, ja se määritetään TotalFeeForTerm__c-kenttään.

• Jos AssetItem-kentillä on TaxAmount__c, arvo suhteutetaan uuteen voimaanastumis- ja päättymispäivään ja määritetään ProratedTaxAmount__c-kenttään.

• Jos edellisen käytännön AssetItem-kentillä on FeeAmount__c, kyseinen arvo suhteutetaan uuteen voimaanastumis- ja päättymispäivään ja määritetään ProratedFeeAmount__c-kenttään.

Lopuksi, jos createTransaction-vaihtoehdoksi (ks. alla) on määritetty true ja uudelle vakuutuksen versiolle on liitetty veroja ja maksuja, luodun transaktion TaxAmount__c- ja FeeAmount__c-kenttiin määritetään uuden (nykyisen) käytännön ja edellisen käytännön TotalTaxForTerm__c ja TotalFeeForTerm__c-arvojen välinen ero.

Etäasetukset

Vaihtoehto	Kuvaus
assetId tai policyId	Pakollinen. Nykyisen käytännön tunnus.
createContactForParticipants	Valinnainen. true tai false Oletusarvo on true. Jos false, palvelu ei luo yhteyshenkilötietueita.
createInsuredItemsRelationships	true tai false Jos tämä vaihtoehto on true, voit määrittää luettelon instanceKey > parentInstanceKey-suhteista vakuutettujen kohteiden välillä. Tämä vaihtoehto tukee ylätason > alitason ja ylätason > alitason > lapsenlapsen vakuutettujen kohteiden suhteita.
createTransaction	Valinnainen. true tai false Oletusarvo on false. Jos true, palvelu luo transaktion, jota tuottoaikataulujen palvelut käyttävät.
effectiveDate	“YYYY-MM-DD HH:MM:SS” tai %OmniScriptDataElement% Päivämäärä, jolloin käytäntö astuu voimaan. Jos vaihtoehtojen kartassa ei ole effectiveDate-arvoa, palvelu etsii sen rootAttributes-kartasta. Jos palvelu ei löydä effectiveDate-arvoa, se käyttää tämänhetkistä päivämäärää. Jos käytät Insurance Industries Extension -pakettia, aikaleiman arvoa ei huomioida effectiveDate-vaihtoehdossa. Sen sijaan voimaanastumispäivän aikaleiman arvoksi asetetaan valitun voimaanastumispäivän klo 00.00.00 ja vanhenemispäivän arvoksi asetetaan valitun vanhenemispäivän kello 23.59. Aikaleima määritetään käyttämällä käyttäjän määrittämää aikavyöhykettä.
getDataCustomClassName	Valinnainen. Mukautetun luokan nimi, jota tämä palvelu käyttää käytäntöjen (omaisuuksien) tietojen noutamiseen. Jos käytät Salesforce FSC:tä, sinun täytyy määrittää joko tämä vaihtoehto tai postDataDRBundleName. Oletusarvoksi asetetaan GetInsurancePolicy.
getDataDRBundleName	Valinnainen, Datan kartoitajan nimi, jota tämä palvelu käyttää käytäntöjen (omaisuuksien) tietojen noutamiseen. Jos käytät Salesforce FSC:tä, sinun täytyy määrittää joko tämä vaihtoehto tai getDataCustomClassName. Jos määrität molemmat, palvelu käyttää getDataDRBundleName-arvoa. Jos et määritä samaa arvoa, palvelu käyttää oletusarvoa getDataCustomClassName (GetInsurancePolicy).
includePaymentSchedule	Valinnainen. True, päivitetäänkö vakuutukselle maksuaikataulu. Oletusarvo on false.
includeRevenueSchedule	Valinnainen. Käytetään vain, jos createTransaction on true. true tai false Jos true, tämä vaihtoehto kutsuu InsPolicyRevenueScheduleService: muokkaa
inputKey	Pakollinen. %theJSONyouneed%
isCreatingPolicyTerms	true tai false Kun arvo on true, palvelu palauttaa tuloksen JSON-tiedostossa olevan policyTermIds-noodin.
postDataCustomClassName	Valinnainen. Mukautetun luokan nimi, jota tämä palvelu käyttää uuden käytännön version tallentamiseen. Jos käytät Salesforce FSC:tä, sinun täytyy määrittää joko tämä vaihtoehto tai postDataDRBundleName. Oletusarvoksi asetetaan PostInsurancePolicy.
postDataDRBundleName	Valinnainen. Datan kartoitusohjelman nimi, jota tämä palvelu käyttää uuden käytännön version tallentamiseen. Jos käytössäsi on SalesForce FSC, sinun täytyy määrittää joko tämä vaihtoehto tai postDataCustomClassName. Jos määrität molemmat, palvelu käyttää postDataDRBundleName-arvoa. Jos et määritä samaa arvoa, palvelu käyttää oletusarvoa postDataCustomClassName (PostInsurancePolicy).
transactionType	Valinnainen. Käytetään vain, jos createTransaction on true. Jos arvoa ei ole annettu transactionType-kenttään, se on oletusarvoisesti Changed/Endorsed.
updateDataCustomClassName	Valinnainen. Päivittää tämänhetkisen käytännön. Jos käytät Salesforce FSC:tä, sinun täytyy määrittää joko tämä vaihtoehto tai updateDataDRBundleName. Oletusarvoksi asetetaan PostInsurancePolicy.
updateDataDRBundleName	Valinnainen. Tämän palvelun nykyisen käytännön päivittämiseen käyttämän datakartoituksen nimi. Jos käytät Salesforce FSC:tä, sinun täytyy määrittää joko tämä vaihtoehto tai updateDataCustomClassName. Jos määrität molemmat, palvelu käyttää updateDataDRBundleName-arvoa. Jos et määritä samaa arvoa, palvelu käyttää oletusarvoa updateDataCustomClassName (PostInsurancePolicy).
useLocalTimezone	true tai false Oletusarvo on true. Kun arvo on true, tämä palvelu käyttää paikallista aikavyöhykettä, jossa käytäntöversio luodaan. Kun arvo on false, tämä palvelu käyttää aikavyöhykkeenä GMT-aikavyöhykettä.
calculateCommission	true tai false Kun arvo on true, palvelu laskee juurikohteiden palkkiot ja tallentaa kokonaissumman TotalCommissionAmount. Kun arvo on false (oletus), palvelu ei laske komissioita. Huomautus Jos määrität tämän vaihtoehdon arvoksi true, sinun täytyy myös syöttää vähintään yksi tuottajan tai tuotanto-koodin arvoista: producerId, productionCodeId tai productionCodeName.
commissionType	Valinnainen. Palkkion tyyppi (esimerkiksi Bonus tai Standard).
commissionStatus	Valinnainen. Palkkion tila (esimerkiksi Odottava, Maksettu tai Poistettu).
producerId	Valinnainen. Käsittelyn tuottajan tunnus, eli tuottaja, jota käytettiin commissionScheduleId-arvon noutamiseen ja palkkiosumman laskemiseen. Kohdistettu InsurancePolicy.ProducerId:lle.
productionCodeId	Valinnainen. Tuotantokoodin tunnus. Kohdistettu InsurancePolicy.ProductionCodeId__c:lle.
productionCodeName	Valinnainen. InsCommissionService.calculate-palveluun välitetty tuotantokoodin nimi. Jos et syötä tietojaproductionCodeId, palvelu käyttää productionCodeName niitä hakeakseen productionCodeId. Jos syötät molemmat arvot, mutta ne eivät vastaa toisiaan, productionCodeId on etusijalla.
memberPlanIntegrationProcedure	Käynnistää mukautetun integraatiotoimenpiteen käyttäjäkokoonpanon perusteella. Kun käytät tätä vaihtoehtoa, se välittää kaikki palvelun vaihtoehdot mukautettuun integraatiotoimenpiteeseen ja kaikki vakuutuksen tunnukset input-arvona, jotta voit integroida objektin, esimerkiksi vakuutussopimusobjektin ja jäsensuunnitelman.
ratingDate	Arvosana, jota käytettiin syötetyn JSON-tiedoston hinnoitteluun. Huomautus Et voi välittää tiettyä aikaa ratingField-kenttään, koska kenttätyyppi on Date. Arvioinnin päivämäärän aikaleima on siis oletusarvoisesti klo 00.00.
term	Palvelun luoman käytännön termi. InsPolicyService:createPolicyVersion tukee vain vuosittaisia vakuutusehtoja.
useIsPaidFlag	Valinnainen Määrittää, täytyykö IsPaid-merkintä ottaa käyttöön vai ei. Jos arvo on true, maksuaikataulun merkintäobjektin isPaid-kenttä otetaan huomioon vakuutusmaksujen, verojen ja palkkioiden laskennassa. Oletusarvo on false.

Syötetty JSON

Tämä palvelu etsii tuotteen JSON-tiedostossa määritetyn inputKey.

"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"
  }

Jos isCreatingPolicyTerms-etäasetukseksi on määritetty true, se sisältää policyTermIds-noodin. Alla on esimerkki policyTermIds-noodista:

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

Tulos-JSON

Palvelu palauttaa uuden käytännön versionumeron tuloksen JSON-tiedostossa.

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