Time Tracking Basics
Clock in and out, breaks, lunch deductions, GPS, and PinShot — how Klees captures accurate field time across crews, jobs, and cost codes.
Updated May 29, 2026
Time tracking is the core of Klees. Job costing, payroll, scheduling, and reports all feed off the time entries your crew creates in the field. This page explains clock-in and clock-out, breaks and lunch, GPS, and how PinShot fits in. For the product overview see Features; for first-time setup see Quickstart.
How a time entry is created
A Klees time entry is an immutable record with: user, job, cost code, start time, end time, breaks, GPS trail, and (optionally) a PinShot selfie. Entries are created in one of three ways:
- Self clock-in — a crew member taps Clock In on their phone
- Crew Clock — a foreman clocks in multiple crew members from a single device
- Manual entry — a manager enters time after the fact (always flagged in the audit log)
Self clock-in is the default and produces the cleanest audit trail. Crew Clock is common for tight 4–8 person construction and cleaning crews led by one foreman.
Clocking in
When a crew member opens the app, the home screen shows their assigned jobs for the day. To clock in:
- Tap Clock In
- Confirm the job (or pick from a list if multiple are assigned)
- Pick a cost code if the job has them configured
- Allow location and camera permissions
- Klees captures GPS, takes the PinShot selfie if enabled, and starts the timer
Clock-in is usually under two seconds on a modern phone. If the device cannot get a GPS fix in 8 seconds, Klees falls back to the last known location and flags the entry for review.
Geofence behavior
If the worker is inside the job’s geofence (see Jobs and Customers), the entry is green. If they are outside, Klees does not block — it asks the worker to confirm and flags the entry as outside fence. A soft prompt with a clean audit signal beats a strict block, which just pushes workers to drift or fake locations.
Clocking out
Tap Clock Out, confirm open breaks are closed, take the closing PinShot if enabled, and the entry lands in the Pending queue. If a worker forgets to clock out, Klees auto-closes at the configured shift cap (default 14 hours) and flags it for manager correction.
Breaks and lunch
Klees supports both paid and unpaid breaks, and an automatic lunch deduction.
| Type | Counts as work time | Typical use |
|---|---|---|
| Paid break | Yes | Short rest, prevailing wage |
| Unpaid break | No | Standard 15-minute coffee on long shifts |
| Lunch (manual) | No | Worker taps Start Lunch / End Lunch |
| Lunch (auto-deduct) | No | System subtracts a fixed period after a configurable shift length |
Auto-deduction is the most common setup in construction and cleaning: deduct 30 minutes if the shift exceeds 6 hours. Workers can override by recording an actual lunch — the foreman approves the override on the timesheet. Break policies are set company-wide and overridable per job.
GPS and location
Every clock-in, clock-out, and break event captures a GPS point with accuracy radius (typically 5–15 meters in open sky). On Pro and Enterprise Klees also records a low-frequency GPS trail during the shift (a point every 2–3 minutes) for Live Map and after-the-fact route review.
Location is captured only while clocked in. Off-shift location is never recorded. Live Map deliberately introduces a 60-second display delay to avoid feeling like surveillance.
PinShot selfie verification
On Pro and Enterprise, Klees captures a selfie at clock-in (optionally at clock-out). An anti-spoof model rejects photos of photos, screens, and printed faces. The score is stored on the time entry. Full details in PinShot Selfie Verification. PinShot is the highest-leverage anti-buddy-punch control Klees ships — operators typically see buddy-punch incidents drop to zero within one shift cycle.
Cost codes
If a job has cost codes, the worker picks one at clock-in and can switch mid-shift (Klees closes the running segment and opens a new one). Common patterns: construction phase codes (01-DEMO, 02-FRAMING), cleaning area codes (OFFICES, RESTROOMS), and delivery route codes. See Reports and Exports for downstream use.
What gets sent to payroll
Approved time entries flow into the payroll export with worker, job, cost code, hours (regular vs overtime by state rule), and the applicable wage rate. See Payroll Integrations for supported providers and mapping details.