InsClaimItemService:calculateCoverages

Palvelu ottaa huomioon asiaankuuluvat vähennettävät summat, copays-maksut, coinsurance- ja out-of-pocket-maksut, kun se luo säätöjä.

Tämä palvelu arvioi kattavuuden laskentakaavan, jos se on määritetty kattavuuden määrityksessä.

Luokka: InsClaimItemService

Metodi: calculateCoverages

Miten se toimii?

Palvelu käyttää objektien käyttöliittymän kenttien nimiä oletusarvoisina input- ja output-arvoina yleisille kentille sekä Vlocity (ClaimLineItem__c) että Salesforce FSC (ClaimCoveragePaymentDetail) -datamalleissa.

Tämä palvelu toimii eri tavalla riippuen siitä, onko kattavuuden laskentakaava olemassa vakuutusmäärityksessä.

Kun kattavuuden laskentakaavaa ei ole, tämä palvelu:

1. Käyttää seuraavia tietoja noutaakseen korvausvaatimustietueen, siihen liittyvän vakuutustietueen ja attribuuttiarvot sekä korvausvaatimukselle että vakuutukselle.

   • claimId

   • claimCoverageId

   • claimItemId (jos saatavilla)

   • claimAmount

2. Kutsuu InsPolicyTermsService: prosessin palvelu.

   Tämä palvelu laskee kaikki vakuutettujen velvoitteiden summat (copay/coinsurance, deductible ja out-of-pocket max) ja palauttaa nämä tiedot.

3. Vähentää vakuutettujen velvoitteiden summat korvausvaatimuksen summasta, jos yksi tai useampi vakuutettujen velvoitteiden summa on olemassa.

4. Palauttaa tuloksen, mukaan lukien lopullisen säädetyn summan ja alitason korvausvaatimuksen kohteet (jos sellaisia on).

Kun kattavuuden määrityksessä on kattavuuden laskentakaava, tämä palvelu:

• Käyttää seuraavia tietoja noutaakseen korvausvaatimustietueen, siihen liittyvän vakuutustietueen ja attribuuttiarvot sekä korvausvaatimukselle että vakuutukselle.

  • claimId

  • claimCoverageId

  • claimItemId (jos saatavilla)

  • claimAmount

• Kerää seuraavat objektit (mukaan lukien AttributeSelectedValues <productcode.key>) salliakseen niiden käytön vakuutusmäärityksen kattavuuden laskentakaavassa:

  • Korvausvaatimus

  • Käytäntö

  • PolicyCoverage

  • Vakuutettu osuus

  • InsuredItem

  • InvolvedInjury

  • InvolvedProperty

• Suorittaa kattavuuden laskentakaavan.

• Kutsuu InsPolicyTermsService: prosessin palvelu.

  Tämä palvelu laskee kaikki vakuutettujen velvoitteiden summat (copay/coinsurance, deductible ja out-of-pocket max) ja palauttaa nämä tiedot.

• Vähentää vakuutettujen velvoitteiden summat korvausvaatimuksen summasta, jos yksi tai useampi vakuutettujen velvoitteiden summa on olemassa.

• Palauttaa tuloksen, mukaan lukien lopullisen säädetyn summan ja alitason korvausvaatimuksen kohteet (jos sellaisia on).

Etäasetukset

Tämä vaihtoehto käyttää tässä taulukossa kuvattuja käyttöliittymän kenttien nimiä Vlocity ClaimLineItem__c- ja Salesforce FSC ClaimCoveragePaymentDetail -datamallien yhteisten kenttien input- ja output-arvoissa:

Jos kenttä ei sisälly tähän luetteloon, käytä kentän täydellistä nimeä.

ClaimLineItem-arvon etuliitteellä olevat attribuutit, joilla on korvausvaatimuksen rivikohteen API, tallennetaan luotuun korvausvaatimuksen rivikohteeseen.

Input JSON ja output JSON

Jos maksun lisätietojen säädetyn summan määrittämisen käyttövalmiit menetelmät vastaavat liiketoimintatarpeitasi, voit ohittaa tämän osion. Jos kuitenkin haluat säätää maksujen lisätietosummia tavoilla, joita ei tueta käyttövalmiina, tämä osio sopii sinulle.

Tavallisesti nämä käyttövalmiit käyttötarkoitukset koskevat skenaarioita, joita power-attribuuttien luokat eivät kata, kuten:

• Ehdolliset vähennettävät arvot, joissa samassa kattavuusmäärityksessä on kaksi vähennettävää arvoa. Esimerkiksi vähennettävä arvo A koskee palovahinkojen menetystä ja vähennettävä arvo B koskee tulvien vahinkojen menetystä. Haluat järjestelmän määrittävän, mitä vähennettä sovelletaan maksun lisätietoihin suorituksen aikana.

• Toimintajärjestys Copay/Coinsurance. Esimerkiksi coinsurance ja copay ovat molemmat samassa vakuutusmäärityksessä, ja haluat käyttää coinsurance-ominaisuutta ennen kuin sovellat copay-ominaisuutta maksun lisätietoihin.

• Edun tyypin maksun summan laskenta. Oletetaan esimerkiksi, että kun käytät Wellness-vierailun etuustyyppiä, haluat järjestelmän laskevan maksun lisätiedoille 50 dollarin summan.

Kun olet ymmärtänyt InsClaimItemService: calculateCoverages-lähtöjen JSON-formaatin, voit käyttää power-attribuuttien kaltaista toimintatapaa laskeaksesi maksuja ja säätöjä ilman, että sinulla olisi perustana power-attribuuttien luokka.

Ennen kuin aloitamme, käytämme yksinkertaista esimerkkiä, joka kuvaa tuloksen JSON-tiedoston, jonka InsClaimItemService: calculateCoverages odotetaan palauttavan. Kuvittele yksinkertainen käyttötapaus, jota käyttövalmis Deductible power attribute -luokka tukee.

Esimerkki: 5 000 dollarin korvausvaatimuksen summa vakuutuksessa ja 1 000 dollarin vähennettävä summa

Alla on syötetty JSON-tiedosto InsClaimItemService: calculateCoverages:lle.

{ 
	"claimId": "01t000000000000001",
	"claimCoverageId": "01t000000000000002",
	"claimItemId": "01t000000000000003",
	"additionalInput": {
		"ClaimLineItem.claimAmount": 5000
		"ClaimLineItem.description": "first party claim payment"
		"ClaimLineItem.recipientId": "01t000000000000004"
	}
}

Alla on tuloksen JSON, jonka InsClaimItemService: calculateCoverages palauttaa.

{  
	"claimItem": {
		"adjustedAmount": 4000 // loss item adjusted amount
	},
	"claimLineItemAdjustment": {
		"attributeClass": "Deductible", // policy terms attribute class
		"adjustedAmount": 1000, // policy terms tracking entry postedAmount
		"assetTermId": "a6ERN00000000dg2AA", // policy terms id
		"remainingAmount": 0 // policy terms tracking entry remainingAmount
	}
}

Alla on kuvattu, miten Financials-välilehden käyttäjien vuorovaikutukset kutsuvat palveluja, miten InsClaimItemService: calculateCoverages saa dataa ja mitä datalle tapahtuu sen jälkeen.

• (1) Käyttäjä napsauttaa korvausvaatimuksen Finanssit-välilehdestä Uusi häviökohde ja syöttää korvausvaatimuksen summan 5 000 dollaria. Välilehden painaminen korvausvaatimuksen summasta seuraavaan kenttään kutsuu InsClaimItemService: calculateCoverages. Tässä esimerkissä InsClaimItemService: calculateCoverages:sta palautettu JSON-tulos sisältää seuraavat arvot.

  • claimLineItem: adjustedAmount Maksun maksaminen maksun vastaanottajalle, kun vähennys vähennetään korvausvaatimuksen summasta: $5,000-$1,000=$4,000. Tämä arvo esitetään käyttäjälle takaisin Uusi häviökohde -lomakkeen Säädetyn summan kentässä.

  • claimLineItemAdjustment:adjustedAmount Korjauksen summa korvausvaatimuksen kattavuuden maksun lisätietoihin, tässä tapauksessa korvausvaatimuksen summasta vähennetty 1 000 dollaria.

  • claimLineItemAdjustment:attributeClass Syy, miksi maksun vastaanottajalle myönnettävä summa eroaa korvausvaatimuksesta. Tässä esimerkissä korvausvaatimuksen summa pienenee 1 000 dollarilla, koska 1 000 dollarin vähennysvaatimus on voimassa (attributeClass = Vähennysvaatimus).

  • claimLineItemAdjustment:assetTermId Käytäntötermi, jolle käytäntötermien seurantamerkintä luodaan. Tässä esimerkissä se on Deductible-käytännön termin tunnus.

  • claimLineItemAdjustment:remainingAmount Käytäntöehdot-seurantamerkinnässä määritettävä summa, tässä tapauksessa 0 dollaria, koska tämän transaktion jälkeen ei ole jäljellä vähennettävää summaa.

• (2) Kun napsautat Lisää tallentaaksesi uuden häviökohteen, InsClaimItemService: add kutsuu, joka käyttää palautettua JSON-tulosta InsClaimItemService: calculateCoverages:stä säilyttääkseen dataa ClaimCoveragePaymentDetail-, ClaimCoveragePaymentAdjustment- ja InsurancePolicyTermTrackingEntry-tietueissa. (InsClaimItemService: update toimii samalla tavalla). Jokainen tietue sisältää esimerkkeihimme liittyviä arvoja:

  • ClaimCoveragePaymentDetail-tietueella on ClaimCoveragePaymentDetail.ClaimedAmount-arvo 5 000 dollaria ja ClaimCoveragePaymentDetail.AdjustedAmount-arvo 4 000 dollaria.

  • ClaimCoveragePaymentAdjustment-tietueella on ClaimCoveragePaymentAdjustment.AdjustedReason-arvo ja ClaimCoveragePaymentAdjustment.AdjustedAmount-arvo 1 000 dollaria.

  • InsurancePolicyTermTrackingEntry-tietueella on InsurancePolicyTermTrackingEntry.PostedAmount-arvo 1 000 dollaria ja InsurancePolicyTermTrackingEntry.RemainingAmount-arvo 0.

Kun ymmärrät tuloksen JSON-tiedoston perusrakenteen, voit määrittää edistyneemmän käyttötarkoituksen syöttämällä logiikkaa kattavuuden laskentakaavaan kattavuusmäärityksissä.

Esimerkki: Syötät kattavuusmäärityksen Lisätiedot-välilehteen tämänkaltaisen kattavuuden laskentakaavan käyttämällä samaa ClaimLineItem-syntaksia kuin mitä käytetään additionalInput-objektille.

InvokeIP('ClaimCoverage_ClaimCoverageFormula', , INPUT('claimId', ClaimLineItem.claimId) INPUT('benefitType', ClaimLineItem.benefitType), INPUT('quantityCount', ClaimLineItem.unitCount), 'result')

Tämä kaava kutsuu suorituksen aikana integraatiotoimenpidettä nimeltään ClaimCoverage_ClaimCoverageFormula. Tämä integrointitoimenpide odottaa input-arvoja claimId-, benefitType- ja quantityCount-arvoille, niin kuin tässä esimerkkien syötetyssä JSON-tiedostossa on kuvattu integraatiotoimenpiteen testaamiseksi:

{ 
	"claimId": "a2b4W000007W2pQQAS",
	"benefitType": "Ambulance - Air",
	"quantityCount": "1",
}

Coverage Calculation -kaava määrittää, että ClaimCoverage_ClaimCoverageFormula-integrointitoimenpiteen output JSON on result-nimisessä noodissa. Niin kauan kuin kyseisen result-noodin JSON-rakenne noudattaa odotettua InsClaimItemService: calculateCoverages-lähtöjen JSON-formaattia, järjestelmä toimii aivan kuin se käyttäisikin perustana olevaa power-attribuuttien luokkaa: Näytä käyttäjälle oikaistu summa ja pysyvät tiedot ClaimCoveragePaymentDetail-, ClaimCoveragePaymentAdjustment- ja InsurancePolicyTermTrackingEntry-tietueissa, kun Lisää-painiketta on napsautettu.

Tässä output JSON-esimerkissä, joka sisältää 50 dollarin maksun Wellness-vierailulle, result-noodi aiheuttaa sen, että InsClaimItemService: add suorittaa insert-arvon 50 ClaimCoveragePaymentDetail.AdjustedAmount-muuttujaan.

{  
	"result": {
		"claimLineItem": {
			"adjustedAmount": "50"
			}
	},
}

Alla on joitakin vihjeitä laskentojen määrittämiseen.

• Jos käyttöskenaariosi sisältää olemassa olevia power-attribuuttien luokkia, voit käyttää InsurancePolicyTerms: getCurrentStandings-funktiota määrittääksesi, kuinka paljon käytäntöehdoksi jää ennen säädön tekemistä. Tämän vaiheen avulla voit käyttää oikeaa säätöä ja välittää asiaankuuluvan assetTermId-arvon. Määritä integraatiotoimenpiteesi palauttama JSON-rakenne näissä käyttötarkoituksissa sisältämään sekä claimLineItem- että claimLineItemAdjustment-noodit.

  Varmista claimLineItemAdjustment-noodista, että:

  • Sisällytä assetTermId.

  • Sisällytä attributeClass.

  InsClaimItemService: add tarvitsee molemmat nämä arvot määrittääkseen, miten vakuutussopimuksen ehtojen seurantatietue luodaan vakuutuksen tietylle Power-attribuutille. Esimerkiksi ehdollisen vähennyksen sisältävällä kattavuusmäärityksellä on kaksi vähennyskelpoista tehoa: Deductible A palolle ja Deductible B tulvalle. Kattavuuden laskenta -kaavassa oleva integrointitoimenpide voi käyttää InsurancePolicyTerms: getCurrentStandings-funktiota määrittääkseen, että tämän vakuutuksen vähennettävä arvo on 1 000 dollaria ja vähennettävä arvo on 500 dollaria. Tämän jälkeen integraatiotoimenpide voi määrittää tämän korvausvaatimuksen häviön syyn perusteella, mitä vähennystä sovelletaan. Kun palautat tuloksen JSON-tiedoston, muista palauttaa oikea assetTermId, joka perustuu käytettyyn deduktiiviin.

• Jotkin käyttöskenaariot eivät sisällä käyttövalmiita power-attribuuttien luokkia, mutta ne edellyttävät silti maksun lisätietojen säätämistä. Kun tarjoaja laskuttaa esimerkiksi enemmän kuin neuvotellut maksut, tarvitset ClaimCoveragePaymentAdjustment-tietueen selittääksesi, miksi säädetyn maksun summa on pienempi kuin korvattu summa. Määritä integraatiotoimenpiteesi palauttama JSON-rakenne näissä käyttötarkoituksissa sisältämään sekä claimLineItem- että claimLineItemAdjustment-noodit.

  claimLineItemAdjustment-noodissa:

  • Jätä assetTermId pois, koska tätä säätöä ei ole määritetty power-attribuuttien luokalla.

  • Sisällytä säädön syyksi attributeClass (esimerkiksi ”Oververbilling Adjustment”).

  InsClaimItemService: add käyttää attributeClass-merkkijonoa täyttääkseen ClaimCoveragePaymentDetail.AdjustedReason-kentän, vaikka siihen ei ole liitetty attributeClass-attribuuttia.

• Jos käyttötarkoitus sisältää etuustyypin maksun summan, korjattujen ja korjattujen summien välillä ei ole ristiriitoja. Esimerkiksi sairaalahoitoon sovelletaan kiinteää maksua 100 dollaria/päivä. Jätä näissä tapauksissa koko claimLineItemAdjustment-noodi pois JSON-tiedostostostasi.