Clock-in / Clock-out

Introduction

Field service and shift-based workers are often paid per Work Order. As demand grows, location-powered workflows can automate and accelerate payments by providing ground truth to close out Work Orders. What once took weeks to reconcile can now happen the moment the order is completed and the worker walks out of the customer’s door. A key signal for triggering payment is the time the worker spends at the work site.

HyperTrack provides a lightweight, location-aware signal that captures when a worker starts and ends their shift at the job site. One common challenge businesses face is workers clocking in or out from outside the work site to avoid penalties for punctuality. The HyperTrack SDK solves this by validating—directly on the device—whether the worker is within the predefined geofence of the work location. This ensures accountability and helps workers build trust with your business and your customers by upholding the promise of the Work Order.

Highlights

• Speed up Payouts: Accurately capture Work times for payout
• Improve Compliance: Verify workers are on-site before they clock in (or clock out).
• Reduce Disputes: Minimize no-show disputes by making sure work starts on destination.
• Works offline: No network, no problem, the SDK syncs the signal as soon as the device is back online

Prerequisite

• Required
  • Onboard Workers to the HyperTrack platform by following the Worker App Setup guide
  • Set up Places to let HyperTrack know the geofences for your customer work sites
• Optional
  • If you also want to get signals around breaks, overtime and so on, you should use Orders

Step by Step Solution

1. Invoke the geotag method in the SDK to capture the clock-in/clock-out

Once the app in integrated with the HyperTrack SDK, you can call the following method to capture the Clock-in/Clock-out signal.

addGeotag(order_handle, order_status, metadata)

Resources for different Mobile platforms - iOS, Android, React Native, Flutter , Ionic , Cordova , Web

While HyperTrack also provides the Arrival and Exit location and timestamps, the clock-in/clock-out signals act more as a definitive signal for when work actually started and ended for a Work Order.

2. Check if the Worker is inside the Geofenced Work Location to control Clock-in/Clock-out

HyperTrack SDK supports on-device geofencing via isInsideGeofence property on your orders or places. Use the orders method when you are looking for more signals around duration spent at work site, breaks, overtime etc.

🚧

Orders or Places integration

This feature requires Orders API or Places API integration

To use this feature, make sure you're tracking work with the Orders API.

The isInsideGeofence status is calculated based on the order.destination geometry, which is provided when creating the order with the Orders API or the places.geometry provided when the place was created.

Local geofencing works offline once any active orders have been received or Places have been defined.

3. Consume the events to trigger workflows in real time
   
   
   If you've added your webhook endpoint to your HyperTrack account, you will receive a webhook about the clock-in/clock-out event that you can use to trigger workflows in your systems. The details of the webhook payload can be found here.

Cookbook

FAQ

1. What happens when the Worker is offline?
   
   
   The Clock-in/Clock-out feature works in offline mode where the Geofence check and the Clock-in/Clock-out signals are stored on device and sync with the HyperTrack platform once network is established.