Incentive Calculation Failures

The calculation process can fail for a variety of reasons during either the Eligibility or Calculation phase. The calculation process updates the transaction status based on the reason for the failure.

Before you submit a calculation request, ensure the following:

• Participants are associated with valid compensation plans.

• The calculation compensation period has a period status of Open.

• The credit category, or any of its parent classification rules, is associated with a valid measure for that period.

Eligibility Phase Failures

Eligibility processing links classified credit transactions to the compensation plan components and performance measures assigned to the specified participants. The process tries to validate invalid plans. If it can't do this, then it does the following:

• Sets the transaction status to Failed plan validation

• Lists the invalid plans in the calculation request process log for you to review and correct

Here are some typical reasons for an Eligibility phase error:

• The processed date of the transaction isn't within the range of the plan assignment date for the plan component.

• The participant's plan component or performance measure doesn't include the credit category that's on the transaction.

Calculation Phase Failures

If the Calculation process fails, then it changes the transaction status to Failed calculation. Check for any recent changes to the plan components or performance measures of the plan being calculated. Are the plan components and performance measures all valid? Fix what you find and then recalculate. Here are some reasons for a failed calculation:

• An expression uses the wrong field or table.

• A plan component references the result of another plan component, and the base component isn't valid for the entire range of the dependent plan component.

• The rate table doesn't include the value passed to it from the input expression.

  Tip: To prevent this problem, always ensure that the input to the rate dimension is compatible with the corresponding rate dimension type. For example, you can't pass a string value to the rate dimension of the type percent or number. Also, ensure that the rate dimension tiers cover all of the possible values.

• A value in the formula (input or output expression of the measure formula or plan component incentive formula) is divided by zero.

• All columns used in the formula for calculation aren't populated for the transaction. For example, the input expression uses quantity and the quantity field is empty.

• Someone changed a plan component while calculation was running and happened to be processing that plan. There's nothing to fix. Rerun the calculation.