Loading
Vakuutus
InsCommissionService: laske

InsCommissionService: laske

Käytä tätä palvelua laskeaksesi tuottajan palkkion.

Luokka: InsCommissionService

Metodi: calculate

Kuvaus

Tämä palvelu käyttää tuottajia, vakuutustuotetta ja tilattavaa tapahtumaa koskevia tietoja laskeakseen tuottajan palkkion.

Miten se toimii?

Tämä palvelu laskee palkkion seuraavasti:

  1. Hyväksyy input-arvot productionCode, producerId, productId, commissionableEvent, context ja effectiveDate löytääkseen asiaankuuluvan CommissionSchedule, jota käytetään laskutoimiin.

  2. Laskee palkkion palkkioaikataulun perusteella.

  3. Arvioi palkkion määrittääkseen, onko se takaisinmaksu (palautetun palkkion summa).

    • Jos komissioitava summa on negatiivinen, palvelu käsittelee komissiota palautuksena.

    • Jos palkkio ei ole palautusmaksu, palvelu vertaa laskettua palkkion summaa minimi- ja maksimipalkkioiden summiin. Jos laskettu summa on liian alhainen tai liian korkea, palvelu palauttaa lasketun summan vähimmäis- tai enimmäissumman.

  4. Palauttaa palkkion summan, sen laskemiseen käytetyn palkkioaikataulun tunnuksen sekä palkkioon liittyvät vähimmäis- ja enimmäissummat.

Syötteet

Input

Kuvaus

productionCode

Valinnainen.

Käsittelyn tuottajan tuotantokoodin nimi, ei tunnus.

producerId

Valinnainen.

Käsittelyn tuottajan tunnus.

productId

Pakollinen.

Sen tuotteen tunnus, josta komissio maksetaan.

commissionableEvent

Valinnainen.

Tapahtuma tai transaktio, joka käynnistää palkkion laskennan (esimerkiksi Tarjous, Myyty käytäntö tai Muutettu/hyväksytty).

effectiveDate

Valinnainen.

Palkkion maksun voimaanastumispäivä. Jos arvo on null, palvelu käyttää tämänhetkistä päivämäärää.

context

Pakollinen.

Kentän nimi ja arvoparit tietueelle, jolle palkkio lasketaan. Sinun täytyy:

  • Lisää API-nimiin nimitila, jos sellainen on.

  • Sisällytä mukaan objectId, eli sen tietueen tunnus, jolle palkkio lasketaan.

Muoto ilman hakukenttää:

{ objectAPI.fieldAPI : fieldValue }

Muoto ja hakukenttä:

{ objectAPI.relationshipAPI.fieldAPI : fieldValue }

Voit määrittää enintään kaksi kenttätasoa, jos muotoilet input-arvon hakukentällä.

commissionableAmount

Valinnainen.

Summa, johon palkkiolaskenta perustuu.

Syötetty JSON

Alla on ohjeet syötetyn JSON-tiedoston muotoiluun.

{
   "productionCode": ProductionCode.Name,
   "producerId": Producer.Id,
   "product2Id": Product2.Id,
   "commissionableEvent": event type,
   "commissionableAmount": amount of the transaction,
   "context": {
      "objectId": ID of applicable object used,
	  "objectAPI.fieldAPI" : value
   }
}

Tämä esimerkki laskee kannatusmaksun.

{
   "productionCode":AX001,
   "producerId":ay001jh002,
   "product2Id":az011jh022,
   "commissionableEvent":"Endorsement",
   "commissionableAmount":500,
   "context":{
      "Quote.vlocity_ins__TotalPremiumforTerm__c":100,
      "QuoteLineItem.vlocity_ins__GroupClassId__r.vlocity_ins__ClassCode__c":"Managers",
      "QuoteLineItem.vlocity_ins__FeeAmount__c":5,
      "objectId":ax003jh001
   }
}

Tulos-JSON

Alla on tuloksen JSON-tiedoston muoto.

{
   "commissionAmount": amount,
   "commissionScheduleId": ID of the commission schedule used,
   "minCommissionAmount": CommissionScheduleAssignment.MinCommissionAmount,
   "maxCommissionAmount": CommissionScheduleAssignment.MaxCommissionAmount
}

Alla on esimerkki tuloksesta, joka näyttää lasketun summan (167 dollaria) vähimmäis- ja enimmäisarvojen (100–500 dollaria) määrittämän arvoalueen sisällä.

{
   "commissionAmount":167,
   "commissionScheduleId":"ab001od002",
   "minCommissionAmount":100,
   "maxCommissionAmount":500
}
 
Ladataan
Salesforce Help | Article