Compensation Calculations

You can set up Compensation Calculation tasks for (re-)calculation of Compensation Records in the background. A Compensation Record is calculated by a logic associated with its Compensation Condition Type. The compensation logic decides how to calculate Compensation line items as well as the Compensation Records for the given Compensation Condition Type. This is determined on the logic element level by setting the 'Groups' to which the element applies.

Users are not allowed to delete the default Compensation Calculation (since it is necessary to have it for the Compensation Records Mass Submit action).

There are two main ways of determining which Compensation Records are to be calculated by such a task:

  • Using a static filter on the Compensation Record set.

  • Using a so called 'feeder logic' which is a sort of algorithmic filter.

Configure Compensation Calculations

  1. Go to Sales Compensation > Calculations.

  2. Click Add Calculation.

  3. Define a label and decide if the set will be default or accrual.

  4. Click Add to save it.

  5. On the list page, click on the Calculation’s label to open it for editing.

  6. Decide whether to use a static filter (Compensation Records tab) or a feeder logic (Calculation tab).

    • When using a static filter, configure it on the Compensation Records tab.

    • When using a feeder logic, set it on the Calculation tab. When a feeder is used, any filter set on the Compensation Records tab is ignored.
      A feeder can have inputs just like any other logic, but in this example all the inputs are provided by the logic.

      A feeder can be used where a static Compensation Record filter falls short, for example if you want to: parametrize the Compensation Record-selection (using feeder inputs), implement an incremental calculation mechanism, perform multi-step filtering logic (first find relevant Plans, then Compensation Records within those Plans), etc.
      The Calculation tab also allows you to specify a 'logic', which would then be used to calculate the Compensation Records (instead of the logic set on the Condition Type). This is an option in advanced simulation scenarios where the Compensation Record calculation logic deviates too much from the regular accruals calculation logic.
      Feeders are created under the Generic Logic header – the reason for this is that they do not (always) implement specific Sales Compensation logic and can be used for multiple purposes, not just in Compensation Plans or Analytics calculations. In this case, though, the only application is in a Compensation Record calculation. A feeder that finds all Compensation Records in draft agreements, not re-calculated since a modification was made to those agreement can be implement (see Rebate Calculations for an attached feeder JSON example).

  7. Save the calculation and run it (click the Run Calculation button) and/or schedule it.

    During the calculation, Compensation Records are locked. Administrators can, however, unlock selected Compensation Records on the list page if needed.
    When configuring the schedule, among the available options are:

    • Time Zone – This option ensures that the calculation job will always run at the selected local time even after switching to/from the daylight saving time. Check the Next Run column to verify that your setting is correct.

      The reason for making the setting here is that the Default Timezone option in General Settings sets only the offset from UTC. This offset and the UTC remain the same when your time zone switches to/from the DST. It means that if you set the start time, for example, to 10 AM CET in the winter (UTC+1) then after switching to the DST (UTC+2), your job will run at 9 AM CEST because your offset from the UTC remains +1.

    • Period – Select if the calculation job will run every X minute, hour, day, month or year.

    • Interval – Represents the number of repetitions in the selected period (e.g., if you set Period = day and Interval = 1 and Start Date = 27/11/2015 10:00, the calculation job will run every day at 10:00 AM, starting on 27/11/2015). You can also enter "0" for jobs that you want to run just once.

Found an issue in documentation? Write to us.

 
Pricefx version 13.1