Time Tracking
Track technician work hours with clock in/out, GPS location, automatic deductions, and pay calculations.
Overview
Time tracking lets technicians clock in and out to record their work hours. Forz captures GPS coordinates at each clock event, automatically applies lunch deductions based on your settings, calculates pay based on the technician's hourly rate, and can auto-assign time logs to projects based on proximity to customer sites. Dispatchers and admins can view, edit, and create manual time entries for any team member.
Before You Begin
Prerequisites:
You have the Time Tracking permission on your role. Timelog module settings are configured (Settings > Modules > Timelog) — including automatic deduction rules. Technicians have an hourly rate set on their user profile (Settings > Users).
Clocking In
Open the Forz app (web or mobile).
Click the Clock In button.
Allow location access if prompted — Forz records your GPS coordinates at clock-in.
Expected result: Forz creates a new timelog entry with your current time and GPS location. The button changes to indicate you are currently clocked in. A confirmation message displays: "Clocked in at: [time]".
Tip: If GPS is unavailable or has low accuracy, Forz still records the clock-in but flags it with a GPS error indicator. Clock events are not blocked by GPS issues.
Clocking Out
Click the Clock Out button while clocked in.
Forz captures your GPS coordinates at clock-out.
Expected result: Forz records the end time and GPS location. The timelog is completed and shows your total hours worked, any automatic deductions, and calculated pay. A confirmation message displays: "Clocked out at: [time]".
Note: Clocking out also ends any active activity log. Both the timelog and activity log are closed at the same time.
Creating a Manual Time Entry
Dispatchers and admins can add time entries for any team member — for example, when a technician forgot to clock in.
Navigate to the user's profile or the Time Tracking section.
Click the New button to create a manual entry.
Select the User the entry is for (pre-filled if accessed from a user profile).
Set the Start Date and Start Time.
Set the End Date and End Time.
Optionally, select a Project to assign the time to.
Click Save.
Expected result: Forz creates the timelog and automatically calculates deductions and pay based on the configured rules and the user's hourly rate.
Editing a Time Entry
When times need correction (e.g., a technician forgot to clock out), dispatchers and admins can adjust the entry.
Open the timelog from the time tracking list or user profile.
Click Edit to modify the start time, end time, or project assignment.
Adjust the fields as needed.
Click Save.
Expected result: The timelog is updated. Forz recalculates deductions and pay automatically. A change history entry is recorded showing who made the edit, the original times, and the new times.
Warning: Every manual edit is tracked in the timelog's change history. The history records the old values, new values, who made the change, and when. This audit trail cannot be deleted.
Viewing the Change History
Open a timelog entry.
Click the History link or tab.
Expected result: A list of all changes to this timelog, including automatic rounding adjustments and manual edits, with timestamps and the user who made each change.
Viewing Time Entries
Click Timelogs in the sidebar navigation.
Use the date picker to select the day you want to view.
The dashboard shows all timelogs for that day, grouped by user.
The list view shows:
Working users — technicians who have time entries for the selected day.
Projects — time entries grouped by auto-assigned project.
Off-duty users — active users with no time entries for the day.
Tip: Use the time filter to switch between Current Week, Previous Week, and All views when viewing a specific user's timelogs.
How Automatic Deductions Work
Forz can automatically apply lunch deductions based on hours worked.
Automatic Deduction After — the number of hours after which a deduction is applied (configured in Settings > Modules > Timelog)
Automatic Time Deduction — the number of minutes to deduct (e.g., 30 minutes for lunch)
When a timelog's total elapsed time exceeds the configured threshold, Forz automatically applies the deduction. The deduction is labeled "Lunch" and subtracted from the total hours before pay is calculated.
How Pay Calculation Works
Forz calculates pay for each timelog:
Total elapsed time = end time minus start time.
Deductions = automatic lunch deduction (if applicable).
Billable hours = total elapsed time minus deductions.
Pay amount = billable hours multiplied by the technician's hourly rate.
The hourly rate is captured from the user's profile at the time the timelog is created. If the rate changes later, existing timelogs keep the original rate.
How GPS and Project Assignment Work
Forz captures GPS coordinates at clock-in and clock-out. When a technician clocks in, Forz runs a background job to check if the clock-in location is near any customer site (within a configurable radius, default 0.3 miles). If a match is found and that site has an active project, the timelog is automatically assigned to that project.
What Happens After Clock-In
When a technician clocks in, Forz automatically:
Records GPS coordinates — latitude, longitude, and accuracy at clock-in.
Captures user details — stores the technician's name and hourly rate on the timelog.
Queues project assignment — a background job checks nearby sites and assigns the closest active project.
Common Scenarios
Tracking a full-day HVAC installation
A technician arrives at a commercial site at 7:00 AM and clocks in. Forz records the GPS location and auto-assigns the timelog to the project associated with the nearby customer site. At 3:30 PM, the technician clocks out. Forz applies a 30-minute lunch deduction (configured for shifts over 6 hours), resulting in 8 billable hours at the technician's rate.
Correcting a missed clock-out
A plumber forgot to clock out after finishing a job at 4:00 PM. The next morning, the dispatcher opens the technician's time tracking, sees the open timelog, and edits it to set the end time to 4:00 PM. The change is recorded in the timelog's history with the dispatcher's user ID and the original and corrected times.
Creating a manual entry for training time
An admin needs to log 4 hours of safety training for a technician who attended an off-site class. The admin creates a manual time entry with the training date and times, and assigns it to the "Training" project.