InsCommissionService:calculate

類別:InsCommissionService

方法:calculate

描述

此服務使用有關產生者、保險產品和可訂購事件的詳細資料來計算產生者的佣金。

運作方式

若要計算佣金,此服務會:

1. 接受 productionCode、producerId、productId、commissionableEvent、context 和 effectiveDate 輸入,以尋找用於計算的適當 CommissionSchedule。

2. 根據「佣金排程」計算佣金。

3. 評估佣金以判斷其是否為收回費用 (退貨的佣金金額)。

   • 如果可訂購金額為負數,則服務會將佣金視為收回費用。

   • 如果佣金不是收回費用,則服務會將計算的佣金金額與最低和最高佣金金額進行比較。如果計算的金額過低或過高,服務會傳回最小或最大金額,而非計算的金額。

4. 傳回佣金金額、用於計算的佣金排程識別碼,以及套用至此佣金的最小和最大金額。

輸入

輸入 JSON

以下是設定輸入 JSON 格式的方式。

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

此範例會計算贊同的佣金。

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

輸出 JSON

以下是輸出 JSON 的格式。

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

以下範例輸出顯示計算金額 ($167) 位於最小值和最大值 ($100-$500) 定義的範圍內。

{
   "commissionAmount":167,
   "commissionScheduleId":"ab001od002",
   "minCommissionAmount":100,
   "maxCommissionAmount":500
}