Setting up balance transfers

A balance transfer deducts units from one balance and adds them to another balance on a set schedule, such as once a year or month. You can use balance transfers to prevent unused balances of a specific type to be carried over to the next year or month or quarter, and still have the employees receive compensation for their unused balances. For example, instead of deducting unused vacation days, you can set up a balance transfer to convert unused vacation days into personal days at the end of the year.

Note: You must set the BALANCE_TRANSFERS_ENABLED registry parameter to TRUE to enable the processing of balance transfers in the calculation engine. This registry parameter is set to FALSE by default.

See Enabling balance transfers.

  1. From the homepage, select Maintenance > Balances and Accruals > Balances.
  2. Click Edit next to the balance from which you want to transfer units.
  3. In the Balance Transfer section, click the new row icon.
  4. Specify this information:
    Transfer To
    Select the balance that receives the transferred units.
    Calculation Group
    Select the calculation groups that are eligible for balance transfer.
    Apply Unit
    Select these time frame when the transfer occurs:
    • Day: A transfer happens every day and has no effect on the Apply Value field.
    • Week: You can specify a day, between 1 and 7, in the Apply Value field from a calendar week.
    • Month: You can specify a day, such as day 29 of every month, in the Apply Value field from a calendar month.
    • Quarter: You can specify a day in the Apply Value field from a calendar quarter.
    • Year: You can specify a day in the Apply Value field from a calendar year.
    • Pay Period: You can specify a day in the Apply Value field from the calculation date pay period of the employee.
    • Custom Date: You can create custom dates by implementing the com.workbrain.app.ta.db.BalanceTransferCustomDate interface. The full path of the implemented class must be specified in the Apply Value field.
    • Constant Date: You can specify a date using the mm/dd/yyyy format in the Apply Value field.
    • Days After Accrual: You can use this option to transfer the balance after a set number of accrued Apply Value days. The entire balance accrued during the Apply Value days is transferred.
    • Anniversary: You can use this option to transfer the balance on the employee's hiring or anniversary date. The Apply Value field is ignored because the anniversary date is a specific date and a value is not required.
    Apply Value
    Specify the day that the transfer occurs, based on the value you selected from the Apply Unit list.

    Specify one of these values:

    • L: Applies the accrual on the last day of the time period.
    • F: Applies the accrual on the first day of the time period.
    • 1-31: Applies the accrual on the date of the time period. For example, specifying 5 and then selecting Month from the Apply Unit list means the accrual is applied on the fifth of every month.
    Ratio
    Specify the transfer ratio which determines the amount of balance transferred. The balance units in the Transfer From field is multiplied by this ratio when transferred to the balance units in the Transfer To field. Use the Ratio when you are transferring balances of higher value to a balance of lesser value. For example, specifying two as a ratio for a transfer between vacation and sick days means the employee receives two sick days for every vacation day in their balance at the time of the transfer.
    Condition
    Specify the full path of the class that implements the com.workbrain.app.ta.db.BalanceTransferCondition class. The transfer occurs if this condition is satisfied, even if the specified condition in the Transfer When is also satisfied. Leave this field blank if no condition is required.
    Action

    Specify the full path of the class that implements the com.workbrain.app.ta.db.BalanceTransferAction class. When you supply an action, transfers are not performed. Instead, the value eligible for deduction is sent to the implementing class, which deducts the value or performs a customization, such as adding a premium.

  5. Click Save.
Note: If a calculation group includes a transfer balance, the transfer balance is prioritized and overrides the All Calc Groups behavior. Transfer balances have a ratio of one by default. If the ratio is not one, then the ratio is multiplied by the balance value on the apply date.