Maximum Zero Cap for Payroll Deductions

You can now enter a value of 0 in the Maximum Amount field for voluntary and pretax deductions to serve as an absolute cap, preventing any deduction collection and automatically recording any excess as arrears, if enabled. This enhancement applies to new elements created after this update. Existing elements will maintain their current behavior, disregarding a 0 value in the Maximum Amount field.
You can use the Run Element Upgrade process to enable this functionality for existing elements. It is recommended to run the element upgrade process only for the specific elements required, rather than applying it to the entire classification, to prevent unintended changes to other elements.

This enhancement provides greater control and flexibility in managing voluntary and pretax deduction limits. By enabling a true cap with a maximum amount of 0, organizations can ensure compliance with deduction policies, prevent unintended collections, and streamline arrears tracking for accurate payroll processing. 
 

Steps to enable and configure

Existing voluntary deduction elements with Arrears or Total Owed enabled won't be automatically upgraded to support this new functionality if they don’t have the Deduction Reference input value configured.

To enable the new functionality for these elements, complete the following steps manually for each affected element.

For voluntary deduction elements:

  1. Open the base element formula (for example, <ELEMENT_BASE_NAME>_VOL_DEDN).
  2. Update DEFAULT FOR Maximum_Amount IS 0 to DEFAULT FOR Maximum_Amount IS 9999.
  3. Open the calculator element formula (for example, <ELEMENT_BASE_NAME>_VOL_DEDN_CALCULATOR).
  4. Add the following line after the Inputs section:
    p_max_amt_zero_enable = 'Y'
  5. Locate the existing CALL_FORMULA for GLB_DEDN_VDED_CALC.
  6. Add the following line to the call parameters:
    Guaranteed_net > 'Guaranteed_Net',
    p_max_amt_zero_enable > 'p_max_amt_zero_enable',
    Dedn_Amt < 'Dedn_Amt' DEFAULT 0,

For pretax deduction elements:

  1. Open the base element formula (for example, <ELEMENT_BASE_NAME>_PRESTAT_DEDN).
  2. Update DEFAULT FOR Maximum_Amount IS 0 to DEFAULT FOR Maximum_Amount IS 9999.
  3. Open the calculator element formula (for example, <ELEMENT_BASE_NAME>_PRESTAT_DEDN_CALCULATOR).
  4. Add the following line after the Inputs section:
    p_max_amt_zero_enable = 'Y'
  5. Locate the existing CALL_FORMULA for GLB_DEDN_VDED_CALC.
  6. Add the following line to the call parameters:
    Guaranteed_net > 'Guaranteed_Net',
    p_max_amt_zero_enable > 'p_max_amt_zero_enable',
    Dedn_Amt < 'Dedn_Amt' DEFAULT 0,

Save and compile the formulas after making the changes.

NOTE: Instead of modifying existing elements, you can create new elements and set up new entries as needed.