Loading
Vakuutus
InsPolicyService:createUpdatePolicy

InsPolicyService:createUpdatePolicy

Käytä tätä palvelua luodaksesi uuden vakuutussopimuksen tai päivittääksesi olemassa olevan vakuutuksen uusilla tiedoilla.

Tätä palvelua voidaan käyttää Salesforce Financial Services Cloudin kanssa valinnaisen maksuaikataulun luonnin tueksi.

Luokka: InsPolicyService

Metodi: createUpdatePolicy

Miten se toimii

  1. Palvelu hakee syötettävää JSON-tiedostoa inputKey. inputKey-noodi sisältää tiedot, joita palvelu tarvitsee käytännön luomiseen tai päivittämiseen. Palvelun vaatimiin tietoihin sisältyy:

    • accountId

    • term

    • productConfigurationDetail-tietueet

    • insuredItems-tietueet (valinnainen)

    • endDate

    • effectiveDate

  2. Luo Policy (resurssi) -objektin.

  3. Jos vakuutukselle on olemassa maksuaikataulu, palvelu palauttaa virheviestin.

  4. Jos sinulla on alustava maksu, luodaan InsurancePolicyTransaction. 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. Sinun täytyy lisätä transaktion lisätietoobjekti transaktion viiteluetteloon.

  5. Jos tallennat maksuaikataulun, tietueet linkitetään vakuutuksen alkuperäisen vakuutuksen tunnukseen.

  6. Jos input JSON sisältää taxesAndfees-, taxAmount- ja/tai feeAmount-noodit, verot ja/tai maksutietueet luodaan.

  7. Palauttaa käytännön tunnuksen tuloksen JSON-tiedostossa, jos palvelua ei välitetä assetId.

    Jos palvelulle välitetään assetId syötetyssä JSON-tiedostossa, se päivittää assetId määrittämän resurssin.

  8. calculateCommission=trueJos: 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.

    • Palvelu kutsuu InsurancePolicyService.calculateAndSaveCommission, joka valmistelee InsCommissionService.calculate- ja InsCommissionService.saveCommissions-palveluiden input-arvot.

    • Palkkion tyyppi (esimerkiksi Palkkio tai Bonus) välitetään InsCommissionService.saveCommissions-palveluun commissionType.

    • Palkkion tila (esimerkiksi Vapautettu tai Maksettu) välitetään InsCommissionService.saveCommissions-palveluun commissionStatus-tilana.

    Kun laskentapalvelu käsittelee input-arvon, tallennuspalvelu tallentaa lasketun arvon TotalCommissionAmount-arvoon.

Huomautus
Huomautus endDate ja effectiveDate määrittävät vakuutuksen keston. Ensimmäisen käytännön version kesto voi olla 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 näin, jos veroja ja maksuja käytetään:

  • 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 taxAmount-kentän arvo.

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

Etäasetukset

Vaihtoehto

Kuvaus

assetId

Valinnainen.

Olemassa olevan käytännön tunnus, jonka tämä palvelu päivittää uusien tai päivitettyjen tietojen perusteella. Käytetään, kun palvelun täytyy päivittää olemassa oleva käytäntö.

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.

Palvelu täyttää myös transaktioiden erittelytiedot transaktion lisätietoobjektiin. Se näyttää tietoja siitä, kuinka paljon jokainen omaisuus, osallistuja ja kattavuus vaikuttaa transaktion kokonaissääntöön vakuutusmaksujen, verojen ja palkkioiden osalta. Näet vain omaisuudet, osallistujat ja kattavuudet, joilla on vähintään yksi muu kuin nolla-arvo vakuutusmaksujen, verojen ja palkkioiden summissa. Transaktion lisätietoobjekti täytyy lisätä transaktioiden viiteluetteloon.

coolingOffPeriod

Valinnainen

Montako päivää voit viivästyttää ensimmäistä maksuaikataulun merkintää.

Jäähdytysjakson yhteydessä vakuutuksen ensimmäinen maksuaikataulun päivämäärä lasketaan voimaanastumispäivänä + päivien määrä.

Sinulla voi esimerkiksi olla kuukausittainen maksujen yleisyys, jossa voimaanastumispäivä on 5. tammikuuta ja ensimmäinen maksuaikataulun päivämäärä 5. tammikuuta. Jos käytämme 14 päivän jäähdytysjaksoa, ensimmäinen maksuaikataulun merkintä muuttuu 5. tammikuuta 19. tammikuuta. Jäljellä olevat kuukausittaiset maksuaikataulun päivämäärät pysyvät ennallaan.

Huomautus
Huomautus Jäähdytysjakson täytyy olla 1–28 päivää käytännön alkamispäivästä.

effectiveDate

%“VVVV-KK-PP TT:MM:SS” tai %OmniScriptDataElement%

Päivämäärä, jolloin käytäntö (tai käytännön päivitys) 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ä.

generatePolicyNumber

true tai false

Jos true, tämä vaihtoehto käyttää UniqueIdGenerator-arvoa luodakseen yksilöllisen vakuutuksen numeron. Tämä numero tallennetaan muodossa Asset.SerialNumber.

includePaymentSchedule

Valinnainen.

True, luodaanko vakuutukselle maksuaikataulu.

Oletusarvo on false.

includeRevenueSchedule

Valinnainen.

true tai false

Jos true, tämä vaihtoehto kutsuu InsPolicyRevenueScheduleService: createRevenueSchedule-palvelu tuottoaikataulun luomiseksi tai InsPolicyRevenueScheduleService: modifyRevenueSchedule, jos käytäntöä päivitetään.

Jos false, palvelu ei luo tälle käytännölle tuottoaikataulua.

initialPaymentRule

Valinnainen.

Joko prosenttiosuus, kuukaudet tai päivät.

initialTransactionName

Valinnainen.

Transaktion nimi.

Oletusarvo on käyttää samaa arvoa kuin initialPaymentTransactionType.

initialPaymentTransactionType

Valinnainen.

Transaktion tyyppi.

Oletusarvo on Premium Charge.

initialPaymentValue

Pakollinen, jos initialPaymentRule on annettu.

Prosenttiarvo tai kuukausien tai päivien määrä.

inputKey

Pakollinen.

JSON, josta tämä palvelu noutaa tarvittavat tiedot käytännön luomiseksi tai päivittämiseksi.

isCreatingPolicyTerms

true tai false

Kun arvo on true, palvelu palauttaa tuloksen JSON-tiedostossa olevan policyTermIds-noodin.

isFsc

Valinnainen.

True, onko luotava vakuutus InsurancePolicy-objekti.

Oletusarvo on false.

Voit määrittää jokopostDataCustomClassName tai postDataDRBundleName.

Jos et määritä jotakin näistä vaihtoehdoista, palvelun oletusarvo on postDataCustomClassName.

paymentCalculationMethod

Pakollinen, jos includePaymentSchedule on true.

Korvaa vakuutuksen Premium-laskentatavan arvon.

paymentFrequency

Pakollinen, jos includePaymentSchedule on true.

Korvaa käytännön PremiumFrequency-arvon.

paymentStartDate

Valinnainen.

Maksuaikataulun ensimmäisen merkinnän päivämäärä.

Oletusarvo on käytännön voimaanastumispäivä.

paymentType

Pakollinen, jos includePaymentSchedule on true.

Korvaa vakuutuksen Premium Payment Type -arvon.

postDataCustomClassName

Valinnainen.

Sinun täytyy määrittää joko tämä vaihtoehto tai postDataDRBundleName.

Oletusarvoksi asetetaan PostInsurancePolicy.

postDataDRBundleName

Valinnainen.

Sinun täytyy määrittää joko tämä vaihtoehto tai postDataCustomClassName.

Jos et määritä tätä vaihtoehtoa, oletusarvo on postDataCustomClassName.

transactionType

%OmniScriptDataElement%

Käytä, jos includeRevenueSchedule on true.

Jos arvoa ei ole määritetty, oletusarvo on Myyty käytäntö.

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
Huomautus

Jos määrität tämän vaihtoehdon arvoksi true, palvelu vaatii vähintään yhden 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 kohteeseen InsurancePolicy.ProducerId.

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
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:createUpdatePolicy tukee vain vuosittaisia vakuutusehtoja.

useIsPaidFlag

Valinnainen

Jos arvo on true ja includePaymentSchedule on myös true, palvelu luo vakuutuskomponenttien vaikutustietueita jokaiselle maksuaikataulun merkinnälle.

Oletusarvo on false.

Syötetty JSON

Tämä palvelu etsii inputKey arvon.

Tässä esimerkissä inputKey = newPolicyJSON.

"newPolicyJSON": {
  "accountId": "001f400000OSHq2AAH",
  "term": "Annual",
  "endDate": "2019-05-14T07:00:00.000Z",
  "effectiveDate": "2018-05-15T07:00:00.000Z",
  "productConfigurationDetail": {
    ...
  },
  "insuredItems": {
    ...
  },
  "additionalFields": {
    "SerialNumber": "AUTO-123",
    "Status": "InForce",
    "vlocityins2__Type__c": "AUTO",
    "vlocityins2__PaymentMethodId__c": "a2Rf40000002NrgEAE"
  },
}

inputKey sisäinen JSON sisältää useita avain/arvo-paria, joita palvelu tarvitsee käytännön luomiseen tai päivittämiseen. Se sisältää myös tuotteen JSON-tiedoston, joka sisältää vakuutettujen tuotteiden hinnoittelun ja vakuutuksen kokonaissumman.

Avain

Arvo

accountId

Omaisuudelle luotu tilin tunnus.

additionalFields

Valinnainen.

Avain/arvo-parit, mukaan lukien kaikki käytäntöjen (omaisuuksien) kentät, jotka eivät ole osa palvelua.

endDate

Valinnainen.

Päivämäärä, jolloin käytäntö vanhenee.

effectiveDate

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ää.

insuredItems

Avain/arvo-parit vakuutetuista kohteista, joita palvelu käyttää vakuutuksen luomiseen.

modificationDate

Päivämäärä, jolloin käytäntöä muokattiin

productConfigurationDetail

Tietueiden taulukko, joka noudattaa tuotteen JSON-rakennemallia.

term

Palvelun luoman käytännön termi.

Tämän esimerkin insuredItems-tietueet sisältävät vakuutetut kohteet ja käyttäjän kullekin valitsemat arvot.

Tässä esimerkissä inputKey = quotepolicyJSON.

"quotepolicyJson": {
  "productConfigurationDetail": {
    ...
  }
  "insuredItems": {
    "DRIVER": [{
        "GENDER": "Female",
        "FN": "Joan",
        "AGE": 20,
        "LN": "Smith",
        "instanceKey": "Joan Smith",
        "isPrimary": false
        "isParent": false
      },
      {
        "GENDER": "Male",
        "FN": "John",
        "AGE": 30,
        "LN": "Smith",
        "instanceKey": "John Smith",
        "isPrimary": false
        "isParent": false
      },
      {
        "GENDER": "Male",
        "FN": "Robert",
        "AGE": 30,
        "LN": "Henderson",
        "instanceKey": "Robert Henderson",
        "isPrimary": false
        "isParent": false
      },
      {
        "GENDER": "Female",
        "FN": "Kinsey",
        "AGE": 20,
        "LN": "Schell",
        "instanceKey": "Kinsey Schell",
        "isPrimary": false
        "isParent": false
      }
    ],
    "AUTO": [{
        "autoLicNum": "Lexus",
        "autoModel": "LX250",
        "autoYear": 2015,
        "instanceKey": "2015 Lexus LX250",
        "BodyClass": "Sedan/Saloon",
        "VehicleType": "PASSENGER CAR",
        "isPrimary": true
        "isParent": true
      },
      {
        "autoLicNum": "Honda",
        "autoModel": "Odyssey",
        "autoYear": 2006,
        "instanceKey": "2006 Honda Odyssey",
        "BodyClass": "Minivan",
        "VehicleType": "MULTIPURPOSE PASSENGER VEHICLE (MPV)",
        "isPrimary": true
        "isParent": true                                
      }
    ]
  },
  "accountId": "0011I00000QknfjQAB",
  "opportunityId": "0061I00000AV8gBQAT"
},
"quoteId": "0Q01I000000206USAQ",
"error": "OK"

Tulos-JSON

Palvelu palauttaa juuri luodun käytännön käytännön tunnuksen.

{
    "policyId": "02if4000001uCZXAA2",
    "error": "OK"
}

Jos isCreatingPolicyTerms-etäasetukseksi on määritetty true, siihen sisältyy policyTermIds-noodi. Alla on esimerkki policyTermIds-noodista:

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

Esimerkkejä

Palvelua käytetään tavallisesti OmniScriptin Tarjousta käytännölle -kuviossa.

 
Ladataan
Salesforce Help | Article