Loading
Vakuutus
InsCommissionService: säädä

Olet tässä:

  1. Salesforce-ohje
  2. Asiakirja
  3. Digitaalinen vakuutus

InsCommissionService: säädä

Käytä tätä palvelua säätääksesi tuottajan palkkion summaa.

Luokka: InsCommissionService

Metodi: adjust

Kuvaus

Tämä palvelu käyttää olemassa olevaa tuottajien palkkiotietuetta ja palkkioaikataulua säätääkseen tuottajan palkkion summaa.

Miten se toimii

Tämä palvelu säätää palkkiota seuraavasti:

  1. Hyväksyy syötetyn commissionId-arvon ja noutaa vastaavan tuottajien palkkiotietueen.

    Jos palkkiota on jo säädetty, palvelu vaatii viimeisimmän säädön commissionId-arvon.

  2. Jos useOriginalSchedule on tosi, käytä laskutoimessa tuottajien palkkiotietueessa määritettyä palkkioaikataulua.

    Jos useOriginalSchedule on false, palvelu käyttää productionCode-, producerId-, productId-, commissionableEvent-, context- ja effectiveDate-arvoja määrittääkseen, mitä palkkioaikataulua käytetään.

  3. Laskee palkkion palkkioaikataulun perusteella.

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

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

Syötteet

Input

Kuvaus

commissionId

Pakollinen.

Säädettävän tuottajan palkkion tunnus.

useOriginalSchedule

true tai false

Kun arvo on true, palvelu käyttää laskutoimessa tuottajien palkkiotietueessa määritettyä palkkioaikataulua.

Kun arvo on false, palvelu käyttää muita syötteitä määrittääkseen, mitä palkkioaikataulua se käyttää.

productionCode

Valinnainen.

Käsittelyn tuottajan tuotantokoodin nimi, ei tunnus.

producerId

Valinnainen.

Käsittelyn tuottajan tunnus.

productId

Pakollinen, jos useOriginalSchedule on false.

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.

Säädön 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.

{
   "commissionId": ProducerCommission.Id,
   "useOriginalSchedule": true,
   "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 säätää kannatusmaksua käyttämällä samaa palkkioaikataulua kuin mitä alunperin käytettiin. 

{
   "commissionId": apwe045asx,
   "useOriginalSchedule": true,
   "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