貨幣額度
追蹤受管理事件之間的實際、估計、已認可和總費用,並對參與者的費用強制執行費用限制。貨幣上限是帳戶層級限制,當使用者建立「受管理事件參與者」記錄或「費用參與者」記錄時適用。
必要版本
| 提供版本:Lightning Experience |
| 提供版本:具有 Life Sciences Cloud、Life Sciences Cloud for Customer Engagement 附加元件授權和 Life Sciences Customer Engagement 受管理封裝的 Enterprise 和 Unlimited Edition。 |
先決條件
- 啟用貨幣上限觸發處理常式。
- 若要查看與參與者帳戶相關的所有啟用中貨幣額度,請將「利用率追蹤器 Lightning 應用程式產生器」元件新增至「帳戶」記錄頁面。
貨幣保單的運作方式
「貨幣涵蓋範圍」會計算三個費用分類的費用金額:
- 預估費用:預期會針對一或多個活動花費的金額。
- 認可費用:一或多個活動批准的金額。
- 實際費用:已針對一或多個活動支付的金額。
事件正在進行中時,系統會將實際支出與估計和認可的費用總和較高,作為執行總計。事件結束後,系統只會考量實際的費用。
每個參與者帳戶在「提供者活動目標限制」記錄中都有定義的費用限制。只要將參與者新增至事件,或建立、更新或刪除費用,系統就會自動重新計算總額上限,並根據該限制進行檢查。只有類型標記為「包含在標題中」的費用才會計入限制。
當違反限制時,系統會以下列兩種方式的其中一種來回應,端點設定方式取決於:
- 錯誤:系統會封鎖動作,並顯示錯誤訊息,以防止新增參與者或記錄費用。
- 警告:允許此動作,但系統會使用警告訊息建立「受管理事件參與者不一致」記錄。
計算總費用
總費用是根據受管理事件的狀態計算而得。
如果受管理事件已完成,亦即狀態代表已完成的狀態,則總費用等於實際費用。
總計 = 實際
如果未完成受管理事件,亦即狀態代表草稿狀態,則總費用為實際費用上限和預估費用加上認可費用。
總計 = MAX(實際、估計 + 認可)
額度資料會以 JSON 格式儲存在提供者活動目標度量的其他資訊欄位中,並累計至「認可費用金額」、「實際費用金額」、「估計費用金額」和「費用總金額」欄位。
下列代碼為貨幣上限的範例。
{"1POXJOO0000002L4AU":{"isFinalValue":true,"isFinal":true,"estimatedMap":
{},"estimated":{},"committedMap":{},"committed": {},"actualMap":
{"1Z6XJ0000000iAjOAI":{"rate": 1.0,"amount":200.0},"1Z6XJ00000001970AA":
{"rate":1.0,"amount": 100.0}},"actual":{"1Z6XJ0000000iAjOAI":
{"rate": 1.0,"amount":200.0},"1Z6XJ00000001970AA":
{"rate": 1.0, "amount":100.077}}}}只有在受管理事件處於最終狀態 (亦即已結束或已結束) 之後,才會計算上限。最終狀態是根據事件管理組織層級設定中的「已結束事件狀態」欄位來決定。轉換率會根據貨幣自動更新。
觸發處理常式
- ExpenseParticipantMonetaryCapsHandler
- 建立費用參與者時,處理常式會重新計算總費用。如果貨幣上限設定為「警示類型」為「錯誤」,且新總計超過貨幣限制,則處理常式會封鎖未建立費用參與者。如果「警示類型」為「警示」,即使超過貨幣限制,處理常式仍允許建立費用參與者,但會顯示警告。只有其費用類型標記為「包含在頁首」的參與者會計入計數。
- 更新費用參與者的金額時,處理常式會根據新金額重新計算總額。如果貨幣上限的「警示類型」設定為「錯誤」,則處理常式會封鎖將總計推送至上限的金額增加。如果「警示類型」為「警示」,即使超過貨幣限制,處理常式仍允許增加金額。即使目前總計已超出上限,減少總計一律可不受限制,因為這會降低利用率。對金額以外的任何欄位進行的變更不會觸發重新計算。
- 刪除費用參與者時,處理常式會重新計算總額上限,以移除刪除的金額。一律允許刪除,因為移除參與者一律會減少總計上限。
- MngEventPartMonetaryCapsHandler
- 將新參與者新增至事件時,處理常式會檢查該提供者的費用上限是否已達到。如果貨幣上限設定為「警示類型」為「錯誤」,則處理常式會限制新增。如果貨幣上限設定為「警示類型」為「警告」,則處理常式會允許,但不會顯示警告。
- 當參與者帳戶變更 (帳戶對帳戶、帳戶對專家或專家對帳戶) 時,處理常式會重新計算舊參與者與新參與者的上限。如果帳戶與使用者交換,則僅會降低帳戶的貨幣上限。非帳戶類型 (使用者、連絡人) 之間的交換沒有效果。
- MngEventMonetaryCapsHandler
- 如果受管理事件狀態更新,觸發處理常式會重新計算所有參與者的貨幣上限限制。如果狀態不是其中一個合格狀態 (草稿或已結束),則處理常式會移除費用項目,且不會再追蹤事件。
- 如果受管理事件開始日期更新為相關聯活動計畫的期間之外,則處理常式會移除費用項目。如果事件日期在活動計畫期間內,則處理常式會根據新期間重新計算費用。
- 如果刪除受管理事件,則處理常式會從貨幣上限限制中移除所有相關的貢獻。
- ExpenseMonetaryCapsHandler
- 如果費用日期更新,則處理常式會根據新日期重新計算總額。如果新日期落在設定的時間範圍外,費用將不再計入上限。
- 如果在 ProviderActivityMeasureType 的「條件 JSON」中定義的任何控制欄位已更新,但仍符合條件,則處理常式會重新計算上限。如果在 ProviderActivityMeasureType 的「條件 JSON」中定義的任何控制欄位已更新,但未符合條件,則處理常式會從上限總計中移除貢獻。
- 如果刪除標記為「包含在標題中的費用」,則處理常式會重新計算費用並移除費用項目的項目。只會計算類型標記為「包含在標題中的」的費用。
批次工作
- 計算貨幣上限的費用:大量上載資料時,觸發處理常式是此批次工作根據最新帳戶資料重新計算費用。
- 根據活動計畫類型共用提供者活動目標:與類型為「事件管理限制」的活動計畫相關聯的提供者活動目標與與帳戶相符的區域範圍共用。針對與其他活動計畫類型相關聯的目標,工作會根據活動計畫的共用設定來共用目標。
離線行動同步化
「貨幣上限」在行動裝置中處理離線貨幣上限違規的方式與在網路上不同。
在網路上,當銷售代表嘗試新增已超過貨幣上限或限制的參與者時,系統會封鎖該動作。
在行動裝置上,當銷售代表在離線時嘗試進行相同的動作時,系統不會封鎖該動作。參與者成功新增至其他事件,但會建立相關的「受管理事件參與者不一致」記錄。當行動裝置與 Web 同步化時,資料會與主要系統共用。
貨幣罰款設定
設定啟用貨幣上限所需的記錄和組態,包括活動計畫、提供者活動目標、具有封鎖與警告條件的度量類型,以及費用類型。
先決條件
- 在事件管理的組織層級管理主控台設定中,設定「已結束事件狀態」欄位以表示狀態的最終值。此設定由提供者活動目標估量使用,以確認事件已結束,並計算每個參與者的實際費用。
- 在區域範圍階層中建立區域範圍。將使用者 (銷售代表) 新增至區域範圍,並將代表參與者的帳戶指派給該區域範圍。如需詳細資訊,請參閱 設定 Life Sciences Cloud 的銷售區域範圍
- 建立費用類型。確定「費用可用性類型」為「受管理事件」,且費用類型的開始與結束日期在活動計畫的期間內。選取「包含在 Cap」核取方塊。如需詳細資訊,請參閱 費用管理。
設定工作 (管理員)
- 使用定義的 期間建立「事件管理限制」類型的活動計畫。計畫應為啟用中。
- 針對新增至區域範圍模型的帳戶,建立提供者活動目標。將目標與活動計畫建立關聯。
- 建立封鎖 (錯誤) 和警告 (警告) 情況的提供者活動度量類型。這代表計算貨幣上限時需要檢查的條件。
- 針對封鎖案例,請執行下列程式碼來設定提供者活動度量類型:
ProviderActivityMeasureType pamt = new ProviderActivityMeasureType( DeveloperName = 'PAMTMonetaryCaps', MasterLabel = 'PAMTMonetaryCaps', Category = 'MonetaryCapLimit', IsActive = true, ActivityObject = 'ExpenseParticipant', Criteria = '{"contextCondition":{"conditions":[{"field":"MngEvent.Status","operator":"In","value":"Draft;Completed"}]},"utilizationTypes":{"estimated":{"conditions":[{"field":"MngEvent.Status","operator":"In","value":"Draft;Completed"}]},"committed":{"conditions":[{"field":"MngEvent.Status","operator":"In","value":"Draft;Completed"}]},"actual":{"conditions":[{"field":"MngEvent.Status","operator":"In","value":"Draft;Completed"}]}}}', AlertType = 'Warning' ); insert pamt; - 同樣地,針對警告情況建立中繼資料組態,並使用相同的詳細資料與 JSON 結構。將警示類型選取為「警示」。
- 針對封鎖案例,請執行下列程式碼來設定提供者活動度量類型:
- 與類型為「事件管理限制」的提供者活動目標相關聯的 建立提供者活動目標度量。新增針對貨幣上限區塊案例建立的提供者活動度量類型。
設定工作 (銷售代表)
若要讓貨幣上限運作,銷售代表必須設定基本事件管理記錄。
- 建立受管理事件。確定受管理事件的開始日期和結束日期在活動計畫的期間內。
- 為符合該區域範圍的帳戶建立受管理事件參與者。
- 建立費用,然後新增您建立的受管理事件和相關費用類型。
建立提供者活動目標限制
建立與目標度量相關聯的提供者活動目標限制。設定帳戶在與帳戶相關聯的所有事件之間使用的貨幣限制。
必要版本
| 所需的使用者權限 | |
|---|---|
| 若要設定提供者活動目標限制: | 「Life Science 商業管理員」權限集 |
系統允許使用者以「受管理事件參與者不一致」記錄建立為警告,來記錄超出提供者活動目標中設定的現金限制的實際費用。
如果提供者活動度量類型的「警示類型」欄位設為「錯誤」,則如果參與者的貨幣限制已達到上限或已超過上限,則系統會封鎖參與者新增至其他事件。
如果提供者活動度量類型的「警示類型」欄位設為「警示」,則系統會允許參與者新增至其他事件,即使其貨幣限制已達到上限或已超過上限。
- 進入 App Launcher,尋找並選取「提供者活動目標限制」。
- 按一下「新增」。
-
針對「提供者活動度量類型」,選取貨幣上限度量類型。
選擇您針對區段或警告情況建立的提供者活動度量類型。
- 選取提供者活動目標。
- 輸入金額作為貨幣限制。帳戶會在所有事件之間使用此金額。
- 儲存您的變更。
建立費用參與者
若要協助使用者追蹤費用上限,請建立費用與參與者的關聯。
必要版本
| 所需的使用者權限 | |
|---|---|
| 若要建立費用參與者: | 「事件管理」權限集 |
- 進入 App Launcher,尋找並選取「費用參與者」。
- 新增記錄的名稱。
-
選取「費用」記錄。
此欄位會捕捉特定種類的實際支出總額。
- 針對「參與者」,請先選取「受管理事件參與者」,然後選取您為其建立費用的對應參與者記錄。
- 輸入參與者實際發生的費用。
- 儲存您的變更。
活動計畫記錄共用規則
深入瞭解如何與使用者 (例如事件召集人) 共用活動計畫。
活動計畫記錄共用規則
依預設,活動計畫和提供者活動目標不會與非管理員使用者 (例如銷售代表) 共用。若要與銷售代表共用這些記錄,請執行「根據活動計畫類型共用提供者活動目標」工作。系統會建立「提供者活動目標共用」記錄和「生活科學商業自動共用」類型的「活動計畫共用」記錄,並與符合參與者帳戶的區域範圍共用這些記錄。
先決條件
在您執行「根據活動計畫類型共用提供者活動目標」工作之前,請將提供者活動目標和活動計畫共用設定從「由父系控制」變更為「私人」。您可以在「設定」中找到共用設定。
共用運作方式
如果活動計畫已存在,則將共用設定從「父系控制」變更為「專用」也會變更相關聯提供者活動目標、目標度量和目標限制的共用存取權。為了確保未遺失存取權,批次工作會根據活動計畫類型來共用活動計畫、提供者活動目標和相關聯的記錄。
如果活動計畫類型為「事件管理限制」,則批次工作會與符合帳戶的區域範圍共用提供者活動目標和活動計畫。
如果活動計畫類型是「事件管理限制」以外的任何項目,則批次工作會根據父系活動計畫共用來共用提供者活動目標,以及相關聯的目標度量和目標限制。
當共用提供者活動目標時,所有相關聯的活動計畫物件 (例如提供者活動目標度量、提供者活動目標限制) 都會隨之共用。
手動共用的共用運作方式
此外,若要確保提供者活動目標繼承與使用者手動共用的現有活動計畫共用設定,請在「適用於客戶參與的生命科學」設定中開啟「在工作流程中包含所有共用類型的記錄」切換開關。
啟用時,此設定會考量所有生命科學流程的所有共用類型,包括手動共用。關閉時,Life Sciences 工作流程只會考量 Life Sciences 商業自動共用共用共用類型。
當在開啟「在工作流程中包含所有共用類型記錄」切換開關後,執行「根據活動計畫類型共用提供者活動目標」批次工作時,批次工作會在提供者活動目標共用設定中複製所有共用類型,包括手動共用。
當切換開關關閉時,批次工作只會針對提供者活動目標共用設定複製生命科學商業自動共用共用類型設定。如需詳細資訊,請參閱為客戶參與受管理封裝準備您的組織。
貨幣保險帳戶合併
瞭解「事件管理」如何使用「帳戶合併」功能來針對具有重疊上限資料的參與者計算貨幣限制。
「帳戶合併」功能使用雙階段合併流程來合併具有相同活動計畫之「提供者活動目標估量」記錄的成交帳戶和未成交帳戶。如需詳細資料,請參閱 帳戶合併。
在第一階段中,「帳戶合併」功能會合併兩個帳戶的目標度量。目標度量應屬於「貨幣上限」種類,且應與類型為「事件管理限制」的相同活動計畫相關聯。
合併的影響如下。
- 會刪除未成交帳戶的目標度量。
- 成交帳戶的費用總金額是成交與未成交帳戶的費用總金額。
- 在 ProviderActivityGoalMeasure.AdditionalInformation 中儲存為 JSON 的 cap 資料現在包含兩個事件的費用詳細資料。
- 未成交帳戶的參與者仍會連結至其帳戶,但費用會合併至成交者之家。
在第二個階段中,如果帳戶具有相同貨幣的費用,則「帳戶合併」會直接加總預估、認可和實際的費用。
如果帳戶有不同的貨幣,則「帳戶合併」會提取未成交參與者帳戶費用的歷程記錄匯率,並將其轉換為贏得帳戶的貨幣,並更新贏得者的總費用。
合併的影響如下。
- 未成交帳戶的費用會使用歷程記錄交易率轉換為成交帳戶的貨幣。
- 成交帳戶的費用總金額是來自成交與未成交帳戶的費用總金額,且包含已轉換金額。
- 儲存在「提供者活動目標度量」其「其他資訊」欄位中的頂層資料也包含稽核追蹤的轉換率。
