Setting up balance transfers

A balance transfer deducts units from one balance and adds them to another on a set schedule (such as once a year or month). Balance transfers can be used when you do not want unused balances of a specific type to carry over to the next year (or month or quarter), but want employees to get some compensation for their unused balances. For example, instead of deducting unused vacation days, you can set up a balance transfer so that unused vacation days at the end of the year become personal days.

Note: The BALANCE_TRANSFERS_ENABLED registry parameter must be set to TRUE (default is FALSE) to enable the processing of balance transfers in the calculation engine.

See Enabling balance transfers.

  1. 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, and specify this information:
    Transfer To
    Select the balance that will receive the transferred units.
    Calculation Group
    Select the calculation groups that are eligible for this transfer.
    Apply Unit
    Select the time frame the transfer occurs. These are the available options:
    • Day: A transfer happens every day and therefore 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 (for example, 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 develop custom dates by implementing the com.workbrain.app.ta.db.BalanceTransferCustomDate interface. The full path of the implemented class must be supplied in the Apply Value field.
    • Constant Date: You can enter a date adhering to 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.
    • Anniversary: You can use this option to transfer the balance at the employee's hiring or anniversary date. This option ignores the Apply Value field because the anniversary is a specific date and a value is not needed.
    Apply Value
    Specify the day that the transfer occurs, based on the value you selected from the Apply Unit drop-down 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 selecting Month from the Apply Unit drop-down list means the accrual is applied on the 5th of every month.
    Ratio
    Specify the ratio of the balance value that is transferred. The number of units in the "transfer from" balance is multiplied by this number when they are transferred to the "transfer to" balance. This field is used when you are transferring balances that are considered more valuable to a balance of lesser value. For example, a ratio of two for a transfer between vacation and sick days means for every vacation day in the employee's balance when the transfer occurs, they receive two sick days.
    Condition
    Specify the full path of the class that implements the com.workbrain.app.ta.db.BalanceTransferCondition class. The transfer will only occur if this condition is satisfied even if the "transfer when" condition is satisfied. This field must be left blank if no condition is required.
    Action

    Specify the full path of the class that implements the com.workbrain.app.ta.db.BalanceTransferAction class. Transfers are not performed when an action is supplied. The value that is eligible for deduction is sent to the implementing class, where the class will either deduct the value or perform a customization (such as adding a premium).

  4. Click Save.
Note: If a calculation group has a transfer balance, it will take precedence and override the All Calc Groups behavior. Transfer balances have a ratio default of one. If the ratio is not the default, then the ratio is multiplied by the balance value as of the apply date.