Overtime Calculator

image7

The Overtime Calculator is designed to read in DRIVERPAY payroll timesheet records and generate the appropriate overtime entries based on the information available.

This application starts up by calculating and displaying the overtime for the week prior to the current week.

To access the Overtime Calculator:

From this location Go to

TruckMate Menu and TruckMate Task List

  • TruckMate 2022.3 and later:
    Accounting & Finance > Driver Payable > Overtime Calculator

  • TruckMate 2022.2 and earlier:
    Accounting & Finance > Driver Payables > Overtime Calculator

Windows Start Menu

TruckMate 20xx > Overtime Calculator

Windows Explorer

C:\Program Files (x86) > TruckMate 20xx > OTCalc.exe

Layout of the Overtime Calculator window

The Header includes a legend describing the color coding appearing in the grid.

The left side panel groups the drivers, the days they’ve worked, the individual DRIVERPAY/PR_TIME_SHEET records the Overtime Calculator program has found to consider, as well as showing the overtime records it is proposing should be generated.

The right side panel categories drivers/employees first by the Other Category defined for the driver on the Driver Profiles program > Pay/Remuneration tab, then by department. The definition of department varies depending upon the OTCALC.EXE > Join Employee Table application configuration option; if False, it uses the Terminal # field on the Driver Profiles > Address tab as the department. If True, it uses the Department field on the Employee Profiles > Address tab which defaults to NA if not populated.

Setting up Overtime Calculator

The basic steps for setting up the Overtime Calculator are:

  • Configure the Application Configurator settings for OTCALC.exe

  • Indicate what the number of regular hours worked in a day and week are using the Driver and Employee profile programs

  • Specify pay codes that should not generate overtime and should be excluded.

  • Map each pay code that should generate overtime to an overtime code.

Application Configurator for Overtime Calculator

The following Application Configurator options are listed under Configuration Options > OTCALC.EXE.

* Indicates this application configuration option can also be edited within the Overtime Calculator program using the Tools menu > Options > General tab.

image8

Option Definition

Days Offset *

The Overtime Calculator program works on a weekly basis, but this configuration allows you to specify which day of the week it starts on. 0 = Sunday, 1 = Monday, etc…​

Default: 0

Eligibility Days *

The number of days from the hire date to qualify for Overtime eligibility. If a statutory holiday falls after this configuration value, the driver will get the statutory holiday.

Default: 30

Note: Only applies if 'Stat Worked OT Factor' configuration option is set to 0.

Enable Logging

Determines if the system will write to a log file when you save.

  • True (default)
    Writes to a log file every time you save.

  • False
    No log file entries are created.

Generation Mode

Determines the tables where the Overtime Calculator program will generate entries.

  • DP - Driver Pay (default) + Get the information from the Employee Profile.

  • DPTS - Driver Pay and Timesheets

Join Employee Table

Determines which TruckMate application will be used to obtain the daily/weekly hours considered as normal hours before overtime is applied.

  • True (default)
    Get the information from the Employee Profile.

  • False
    Get the information from the Driver Profile.

New Payment State *

Indicates which status is considered a valid payment state. This is the status that generated DRIVERPAY records should be in to ensure the General Ledger is correctly updated. Values include:

  • U - Unapproved

  • A - Approved (default)

OT Rate Formula

Determines the formula by which the Overtime is calculated.

  • Lowest Rate (default)
    Use lowest rate worked that day to apply the OT rate factor to.

  • Rate Worked
    Use the rate as it was worked in the reverse time order.

    For example, if multiple DRIVERPAY records existed for a given day with one of more of them having a timestamp, the system will use the # of hours for the last entry of the day first, for the # of hours on that record. If there are more hours left, it will then use the next to last record for that # of hours, etc. If no entries for that day have a timestamp on it, it defaults back to the lowest rate worked.

Stat Worked OT Factor

Determines the overtime factor to be applied for time entered during a statutory holiday.

For example, regular overtime may be paid out using a factor of 1.5 but time worked during a statutory holiday might be calculated using an OT factor of 2.5.

Default: 0

Use Holidays *

This option is for future development and is not enabled yet. The system will currently always use Holidays as defined in the Codes Maintenance program.

  • True (default)
    Use Holidays from Codes Maintenance.

  • False
    Use Holidays from Codes Maintenance. (The False option is intended for future development to permit an alternate option.)

Use OT Paycode Rate *

This option is for future development and is not enabled yet. The system will currently always use the Overtime Paycode rate of 1.5.

  • True (default)
    Use the Overtime Paycode rate of 1.5.

  • False
    Use the Overtime Paycode rate of 1.5. (The False option is intended for future development to permit an alternate option.)

Driver/Employee Setup (DRIVERS.EXE/EMPLOYEE.EXE)

If the OTCALC.EXE > application configuration setting for Join Employee Table is False, then you need to configure every driver to indicate what the number of regular hours worked in a day and week are in a week in the Driver Profiles program.

For example, Day would be set to 8 hours, Week would be set to 40.

image9

If the OTCALC.EXE > application configuration setting for Join Employee Table is True, or the Generation Mode configuration option is set to 'DPTS', then you need to configure each employee/driver in EMPLOYEE.EXE.

The Pay Audit line determines the regular daily/weekly hours before Overtime should be assessed for DRIVERPAY records. The Timesheet line determines the regular daily/weekly hours before Overtime should be assessed for PR_TIME_SHEET records.

The Timesheet week use Driver checkbox is a True/False field; False (clear) by default. If True, then all the DRIVERPAY hours will also be considered as part of the weekly hours for an employee/driver when generating timesheet weekly overtime.

For example, If employee drove 20 driverpay hours, and 30 time sheet hours, with the Timesheet weekly regular hours being 40, then the employee should have 10 hours of Timesheet weekly overtime.

image10

Pay Code Configuration (OTCALC.EXE)

This application assumes that your DRIVERPAY pay codes (as defined by PAYCON.EXE) matches your payroll pay codes (as defined in PRCONFIG.EXE).

Exclusions

To specify pay codes that should not generate overtime, go to the Tools menu > Options > Exclusions tab and add them.

image11

PayCode Map

For every pay code that should generate overtime, you need to map it to the appropriate overtime code.

Go to the Overtime Calculator > Tools menu > Options > Paycode Map tab, add the pay codes which should generate overtime and associate them with the OT Code which is using the correct OT rate.

image12

Driver Pay Audit (PAYAUDIT.EXE)

Driver Pay records can be entered into the TruckMate system in multiple manners. They can be added directly to a freight bill in the Customer Service program, or generated by assigning a driver to a trip through the dispatching programs, or by imported from some other application in the Driver Pay Audit program.

But the DRIVERPAY records must reach the Approved state before they are considered for overtime generation. Double-clicking the records in the Payments tab in PAYAUDIT.EXE will change them from the Not Reviewed state to the Approved state.

image13

Payroll Time Sheets (TIMESHEETS.EXE)

If your application configuration Generation Mode is set to DPTS, so it generates overtime for both DRIVERPAY and PR_TIME_SHEETS, you will also need to have the time entered into the Payroll > Payroll Time Sheets program prior to running OTCALC.EXE.

image14

Overtime Calculation (OTCalc.exe)

This application starts up by calculating the overtime for the week prior to the current week.

On the right pane it categorizes drivers/employees first by the Other Category found on the Driver Profiles > Pay/Remuneration' tab, then by department. The definition of department varies upon the OTCALC.EXE > Join Employee Table application configuration setting. If False, it uses the Terminal # field on the Driver Profiles > Address tab as the department. If True, it uses the Department field on the Employee Profiles > Address tab which defaults to 'NA' if not populated.

On the left pane, it groups the drivers, then the days they have worked, then the individual DRIVERPAY/PR_TIME_SHEET records it has found to consider, as well as showing the overtime records it is proposing should be generated.

At the top in the header area, there is a legend describing the color coding used by the rows in the grid.

image15

You can use the calendar icon at the top to select a date, or the '<' or '>' arrows to scroll backwards/forwards by week.

The title of the screen gives you some information: "Pay records for <Start Date> to <End Date> [# of Statutory Holidays in week] (<Time to retrieve information for that week> / < Time to process the information for that week>).

Right-click the Department from the panel on the right to display the related information in the left side panel.

In the right side panel, hover the cursor over the driver to get additional information to appear.

image16

The information displayed depends on the OTCALC.EXE > Generation Mode application configuration setting; if it is DP (driver pay only), it would not include the TS (i.e., time sheet) subtotals.

The Reported hours lists the total hours the program read in and considered for overtime. The Regular Hours is what the reported hours were converted to (i.e., It reduces those hours, as it converts the time to overtime). It also shows the hours it will insert as daily overtime and weekly overtime.

You can get a similar breakdown if you hover over a particular date.

If you hover over a DRIVERPAY records (white color), you also get more information on that record.

image17

If you hover over a Timesheet record (Pale Green color), you get additional information on that record.

image18

The Orig Hours column identifies the number of hours that was on the DRIVERPAY/PR_TIME_SHEET record. The New Hours column identifies what it reduced that record’s hours to when generating the appropriate overtime.

Once you have reviewed the generated overtime, you need to save it. You can do that at multiple levels; if you right-mouse-click on a driver record you have a few options, including Save Driver.

image19

But you can also right-click the Department & Category levels in the left pane to get similar options to save at those levels; including Save All.

It will first prompt you for a filename to save a .csv version of the data and use this to update the DRIVERPAY/PR_TIME_SHEET records appropriately; i.e., reducing the hours on those records, and potentially even deleting them (if all hours on that record were converted to overtime).

This application is meant to be a one-time processing event! I.e., once you have applied a week’s changes and go back to that week for that driver, there is no guarantee the system will re-generate the same overtime.

For example, suppose this was your driver record, and you saved it.

image20

You would see the entries in DRIVERPAY adjusted; e.g., The 'HR' entry on 11/17/2014 used to be 12 hours; it is now 10 hours and an 'OT1' record has been inserted for that date, @ 1.5 times the 'HR' rate.

image21