Geofence attendance means the system checks the employee's location at the moment of the punch. It accepts the punch inside the boundary you drew for their branch and rejects it outside. You set it up on three screens: Branches and Locations for the boundaries, Establishment Settings for the punch rules, and Work Times for shifts. The admin web interface is in Arabic, so screen names are given in English.
Checklist before you start
- The Attendance service is included in your subscription.
- An admin account with permissions for locations, devices and establishment settings.
- Branch and project-site names, and the city of each.
- A mobile number in every employee file, and an app account for each employee created from their file.
- Work hours for every team, including anyone on two shifts or whose shift crosses midnight.
- The serial number of each fingerprint device, if you use devices.
Steps
1. Create the location
Under Organization Structure, open Branches and Locations and click "Create new location/branch". Enter the location or branch name and the city or region. The map centers on the city you typed before you draw anything, so type it first.
2. Draw the boundary
Use the drawing tools at the top left of the map to draw a rectangle, polygon or circle around the site. Each location has one boundary. You can search for a place, enter latitude and longitude, or switch between map and satellite view. If you have not drawn a boundary, a warning says "draw the location boundary first". Then click "Save location".
3. Link employees to the location
Open the employee file, go to Work and Attendance, then Settings, and pick the location under General Settings. To move a whole team, open the location card, click "View employees", then "Move employees". The team is pre-selected so you can change location, department or shift in one pass.
4. Set where each employee can punch
In Establishment Settings, open Attendance and set "Allow check-in from":
| Option | Meaning |
|---|---|
| Employee's branch only | Punches inside their own branch boundary |
| Selected branches / locations | Punches at the locations you pick from the list |
| Any saved branch | Punches at any location with a drawn boundary |
| Anywhere (outside locations) | Punches from any place |
"Check-out scope" has the same options. A check-out outside the scope is not blocked; it is recorded and shows in the employee's attendance sheet. To make an exception for one person, open their file, go to Work and Attendance, then Settings, and set Verification and Locations: "Punch from anywhere outside the site" and "Allow check-in from". What you set in the employee file overrides the establishment setting.
5. Set punch methods and the punch window
On the same screen, choose how punching is allowed: all options, mobile app only, or fingerprint device only. Then set how many minutes before shift start check-in opens, and how many minutes after shift end check-out stays open.
6. Require fingerprint or face verification
Turn on "Verify fingerprint / face". The app then asks for the phone's biometric check before it records a check-in or check-out, which stops one employee from punching for a colleague. The system issues a one-time challenge valid for 5 minutes.
7. Bind the device to the employee
Device binding is strict by default: the first phone an employee signs in from is bound to their account. Signing in from another phone is blocked, and a dialog sends a device change request to management. You approve or reject it from Recent Requests. To release a binding, open the employee file, go to Work and Attendance, then Settings, and click "Unbind phone" in the Mobile App section. That section also shows the bound phone and the last sign-in.
8. Register fingerprint devices
Under Organization Structure, open Fingerprint Devices and Punch Methods. In "Add new device", enter the device name, serial number and model, and pick the location, then click "Register device". Click "Generate key" and the device card shows the device's own address. Enter it in the device's ADMS settings with the port. Sending starts within minutes and "Last connection" appears. Devices that speak the ADMS protocol, such as ZKTeco, work this way.
Punches from numbers the system does not know wait under "Unlinked numbers". Pick the employee and click "Link", and the saved punches are applied retroactively, so no day is lost.
9. Define work shifts
Under Organization Structure, open Work Times. In "Add default shift", enter the shift name, then choose fixed times with check-in and check-out, or flexible times with daily hours. Add the allowed lateness and allowed early leave in minutes, set the weekly days off, and click "Add shift".
- Two shifts in a day: open the employee file, go to Work and Attendance, then Work Times, and click "Add shift" in the Work Shift card. You can assign more than one primary shift as long as they do not overlap, for example 08:00 to 12:00 and 16:00 to 20:00. Lateness is measured at the start of each shift, and the gap between them is not overtime.
- Shift across midnight: enter check-in 22:00 and check-out 06:00, and the end falls on the next day.
- Seasonal change: use the Scheduled Changes tab to set an effective date, and the system applies it on time.
10. Review rejected attempts
Open Attendance Analytics and the Punch Integrity tab. "Rejected attendance attempts" lists each attempt with its date, employee, reason, nearest location and distance, and you can export it. Rejected attempts show to admins on the web, never to the employee.
Worked example: two punches at a branch with a 150-meter radius
The «Riyadh branch» boundary is drawn as a circle centered on latitude 24.7136 and longitude 46.6753 with a radius of 150 meters. Two employees punch in the morning, and the system measures each punch's distance from the center with the haversine formula, then decides by distance alone: inside the boundary if it does not exceed the radius. The coordinates are an assumed example, the distances are calculated by the geo-containment function in the code itself, and a permanent test recomputes them.
| Punch | Location | Distance from center | Verdict |
|---|---|---|---|
| First employee | 24.7142, 46.6759 | 90 m | Accepted: 90 ≤ 150 |
| Second employee | 24.7160, 46.6753 | 267 m | Rejected: 267 > 150 |
What each side sees
- The second employee: receives the rejection at once on the phone: "Check-in is allowed only from your assigned locations. You are 267 m away from «Riyadh branch»."
- Management: the attempt is logged under «Rejected attempts» with its distance of 267 m, so the reviewer can tell someone standing 267 meters away from someone who never left home. These attempts show to management on the web only.
- The first employee: the punch is recorded inside the boundary with no note.
If you widen the boundary: a radius of 300 meters accepts the second employee's punch because 267 ≤ 300, but it also accepts anyone standing 300 meters from the branch. Choose the radius to match the real size of the site, not to silence rejections.
If the boundary is a polygon: the verdict is whether the point falls inside the polygon, and for a point outside it the distance shown is to the nearest vertex, an approximation rather than the distance to the edge itself, so read the displayed distance as an estimate, not a precise measurement.
Common mistakes
- A location with no drawn boundary. It accepts punches from anywhere, and the Boundaries column in the Branches and Locations list shows it as "No boundaries".
- An employee with no shift. Their day is counted as eight default hours for lateness in the payroll run.
- Two overlapping shifts. After a time edit they show "overlapping, not counted" and stay out of the calculation until you reassign.
- A new device key without updating the address. The device goes silent until you enter the new address in its menu.
- "Accept by serial number only." Anyone who knows the serial printed on the back could send punches in your employees' names. Leave it off unless the device cannot send a key in the path.
- Expecting offline punches. Punching always needs internet.
After setup
Once attendance works, move to the payroll setup guide so shifts and lateness flow into the payroll run, and to field reps management for field teams. The anti-tampering controls are covered in how to stop punching from outside the workplace. For two shifts in a day read lateness and absence on split shifts. See also field attendance and the guides hub.
Product link
The Attendance service in TAC HR combines mobile punch with a geofence verified in the system, device binding per employee, fingerprint devices that support ADMS, more than one shift per employee, and calculation of lateness, early leave and partial absence. See Attendance.
Frequently asked questions
What happens when an employee punches outside the geofence?
The system rejects the punch and logs the attempt under Punch Integrity, with the nearest location and the distance. The employee does not see the attempt.
Can a field employee punch from anywhere?
Yes. Set "Punch from anywhere outside the site" in their file, or choose "Anywhere (outside locations)" for the whole company.
Does the system accept a fake location?
No. The app rejects fake-location apps, jailbroken or rooted phones, emulators and USB debugging, and it reports the attempt to management.
How do I move an employee to a new phone?
They sign in from the new phone and a device change request reaches management for approval. Or click "Unbind phone" in their file, and the next phone they sign in from is bound.
Do I need a fingerprint device?
No. The app alone is enough. Devices suit sites without phones or teams that prefer them, and their punches go into the same attendance log.
