# Employee self attendance

<p class="doc-lead">Employees check in and check out from the Field Sale App <b>My Day</b> row. The punch is written on the same attendance day HR already uses. Daily attendance entered by a supervisor is unchanged.</p>

<div class="doc-toc">
<p class="doc-toc-title">On this page</p>
<div class="doc-toc-section">
<span class="doc-toc-group-title">Setup</span>
<div class="doc-toc-links">
<a href="#/hr/employee-self-attendance?id=enable">Enable the feature</a>
<a href="#/hr/employee-self-attendance?id=preference">Order of preference</a>
<a href="#/hr/employee-self-attendance?id=who-can-punch">Who can punch</a>
<a href="#/hr/employee-self-attendance?id=hr-settings">HR Settings</a>
<a href="#/hr/employee-self-attendance?id=employee">Employee</a>
<a href="#/hr/employee-self-attendance?id=user-and-role">User and role</a>
</div>
</div>
<div class="doc-toc-section">
<span class="doc-toc-group-title">On the phone</span>
<div class="doc-toc-links">
<a href="#/hr/employee-self-attendance?id=my-day">My Day</a>
<a href="#/hr/employee-self-attendance?id=check-in">Check in</a>
<a href="#/hr/employee-self-attendance?id=check-out">Check out</a>
<a href="#/hr/employee-self-attendance?id=capture">Photo and location</a>
<a href="#/hr/employee-self-attendance?id=geofence">Geofence</a>
<a href="#/hr/employee-self-attendance?id=blocked">When a punch is refused</a>
</div>
</div>
<div class="doc-toc-section">
<span class="doc-toc-group-title">On the web</span>
<div class="doc-toc-links">
<a href="#/hr/employee-self-attendance?id=punch-details">Punch details</a>
<a href="#/hr/employee-self-attendance?id=status">Status</a>
<a href="#/hr/employee-self-attendance?id=faq">FAQ</a>
</div>
</div>
</div>

<hr class="doc-section-divider">

<h2 id="enable">Enable the feature</h2>

Employee self punch is off until it is turned on for the company. Contact the <b>support team</b> or the <b>sales team</b> and ask them to enable <b>Employee self punch</b>.

Until that is done, My Day does not appear for anyone, including employees set to Custom.

After it is enabled:

<ol>
<li>Grant the role <b>Self Attendance</b>. This is a single checkbox under Attendance. It has no List, View, or Create actions.</li>
<li>On the user, set the default <b>Employee</b>. My Day uses only that employee.</li>
<li>In <a href="#/hr/hrms-settings">HR Settings</a>, turn on <b>Employee self punch</b> for employees who inherit the company rule, and set capture, geofence, and the company place.</li>
<li>On an employee who should differ from the company rule, set <b>Punch mode</b> to Custom or Disabled.</li>
<li>Ask the employee to sign in to the Field Sale App again so the new access is picked up.</li>
</ol>

<hr class="doc-section-divider">

<h2 id="preference">Order of preference</h2>

The phone decides check-in from the first rule that applies. Later rules are used only when the earlier one does not turn the punch off.

<h3>1. Can this person punch at all?</h3>

| Order | Check | Result |
|------:|-------|--------|
| 1 | Employee self punch is not enabled for the company | My Day is off for every employee. Contact support or sales to enable it. |
| 2 | The role does not include <b>Self Attendance</b> | My Day is hidden. |
| 3 | The user has no default <b>Employee</b> | My Day is hidden. No other employee is used. |
| 4 | Employee <b>Punch mode</b> is <b>Disabled</b> | This employee cannot punch. HR self punch does not override Disabled. |
| 5 | Employee <b>Punch mode</b> is <b>Custom</b> | This employee punches with the capture and geofence on the employee, even when HR <b>Employee self punch</b> is off. |
| 6 | Employee <b>Punch mode</b> is <b>Inherit</b> (the default) | The employee punches only when HR Settings <b>Employee self punch</b> is on. Capture and geofence come from HR Settings. |

<h3>2. Capture and geofence mode</h3>

| Punch mode | Capture | Geofence |
|------------|---------|----------|
| <b>Custom</b> | Employee → Capture | Employee → Geofence |
| <b>Inherit</b> | HR Settings → Capture | HR Settings → Geofence |

Plan for the day and Summary of the day are always taken from HR Settings, for both Inherit and Custom.

<h3>3. Place used for the geofence</h3>

Used only when the geofence mode from the table above is <b>Soft</b> or <b>Hard</b>. The first place that exists is the one that is used.

| Order | Place |
|------:|-------|
| 1 | Employee <b>territory</b>, when it has at least 3 points |
| 2 | Employee <b>latitude</b> and <b>longitude</b>, when both are filled |
| 3 | HR Settings <b>territory</b>, when it has at least 3 points |
| 4 | HR Settings <b>latitude</b> and <b>longitude</b>, when both are filled |
| 5 | None of the above | Soft and Hard refuse the punch. Off does not need a place. |

A territory is used instead of a point on the same record. An employee territory replaces the company place. An employee point is used only when that employee has no territory.

<h3>4. Radius</h3>

Used for a point place. A territory does not use the radius.

| Order | Radius |
|------:|--------|
| 1 | Employee <b>Radius (meters)</b>, when it is filled |
| 2 | HR Settings <b>Geofence radius</b> |
| 3 | 150 meters |

On Inherit, the employee latitude, longitude, radius, and territory are still the employee's own place. They do not change the capture or the geofence mode. Those stay on HR Settings until Punch mode is Custom.

<hr class="doc-section-divider">

<h2 id="who-can-punch">Who can punch</h2>

My Day is for the employee named on the user. It is not tied to a customer, an outlet, or a route.

One check-in and one check-out are stored on the attendance row for that employee and that company day. A second check-in the same day is refused.

The clock is the company time zone, not the time on the phone.

<hr class="doc-section-divider">

<h2 id="hr-settings">HR Settings</h2>

Open <b>HRMS → Settings</b>. The <b>Self attendance</b> section is shown after Employee self punch is enabled for the company.

| Setting | What it does |
|---------|----------------|
| <b>Employee self punch</b> | Turns My Day on for employees whose Punch mode is Inherit. |
| <b>Require plan</b> | Check-in must include a plan for the day. Off by default. |
| <b>Require summary</b> | Check-out must include a summary of the day. Off by default. |
| <b>Capture</b> | None, Photo, Location, or Photo and location. Used for Inherit. |
| <b>Geofence</b> | Off, Soft, or Hard. Used for Inherit. |
| <b>Geofence radius</b> | Meters around the company point. Default 150. Used when the employee radius is empty. |
| <b>Latitude</b> and <b>Longitude</b> | Company point. Used when the employee has no place of their own. |
| <b>Territory</b> | Company polygon. Click the map to add corners. At least 3 points. Undo, Clear, and Locate me are on the map. |

<hr class="doc-section-divider">

<h2 id="employee">Employee</h2>

On the employee form and on the employee view, <b>Self attendance</b> is the last section. It is shown when Employee self punch is on in HR Settings and the company feature is enabled.

| Field | When it is used |
|-------|-----------------|
| <b>Punch mode</b> | Inherit, Disabled, or Custom. See the preference table. |
| <b>Capture</b> | Shown for Custom. |
| <b>Geofence</b> | Shown for Custom. |
| <b>Latitude</b>, <b>Longitude</b>, <b>Radius</b>, <b>Territory</b> | Shown when the effective geofence is Soft or Hard. On Inherit, the effective geofence is the HR Settings geofence. On Custom, it is the employee geofence. |

<hr class="doc-section-divider">

<h2 id="user-and-role">User and role</h2>

| Setup | Where |
|-------|--------|
| <b>Self Attendance</b> on the role | Role → Attendance. One checkbox. |
| Default <b>Employee</b> | User → default values. This is the only employee My Day will punch. |

Sign in to the app again after the role or the default employee changes.

<hr class="doc-section-divider">

<h2 id="my-day">My Day</h2>

My Day is one row at the top of Home. It is not a button in the home grid.

| Label | Meaning |
|-------|---------|
| <b>Check in</b> | No punch yet today. |
| <b>Check out</b> | Checked in, not checked out. The time is not shown on the row. |
| <b>Attendance marked</b> | Check-out is done, or the day was already marked and cannot be punched. |

The row is hidden when self punch is off or the default employee is missing.

Home does not ask the server for My Day on every visit. The label is kept for 30 minutes. The refresh icon on the row always loads it again. Opening My Day, or a successful punch, updates the label. Signing out clears it.

Tap the row to open My Day.

<hr class="doc-section-divider">

<h2 id="check-in">Check in</h2>

| Item | Rule |
|------|------|
| <b>Plan for the day</b> | Free text. Required only when HR Settings <b>Require plan</b> is on. A star is shown on the label when it is required. |
| Photo | Taken with the front camera when capture includes a photo. |
| Location | Taken when capture includes location. |
| Away reason | Not shown at the start. It appears only after a Soft geofence punch is outside the place. The photo already taken is kept. |

Check-in writes the in time on today's attendance row and leaves the status empty. It does not create a second attendance record.

If yesterday (or an earlier day) was checked in from the app and never checked out, today's check-in is refused until that open day is checked out. My Day opens on that earlier day.

<hr class="doc-section-divider">

<h2 id="check-out">Check out</h2>

| Item | Rule |
|------|------|
| <b>Summary of the day</b> | Free text. Required only when HR Settings <b>Require summary</b> is on. Nothing is filled in automatically. |
| Photo and location | Same capture rule as check-in. |
| Away reason | Separate from the check-in reason. Asked only when this check-out is outside a Soft geofence. |

The check-out screen shows the check-in time, plan, check-in photo, check-in place, and check-in away reason.

After check-out, My Day is read-only: check-in and check-out times, plan, summary, both away reasons, map links, and both photos.

<hr class="doc-section-divider">

<h2 id="capture">Photo and location</h2>

| Capture | What the phone asks for |
|---------|-------------------------|
| <b>None</b> | Plan or summary only, when those are required. |
| <b>Photo</b> | Front camera. The punch is saved after the photo is stored. |
| <b>Location</b> | Current location. |
| <b>Photo and location</b> | Both. |

Location rules:

<ul>
<li>Accuracy is required. A reading worse than 100 meters is refused. Move outdoors and try again.</li>
<li>A mock location is refused.</li>
<li>The same spot is judged the same way on check-in and check-out. A point that falls just outside the place, but within the phone's accuracy, still counts as inside.</li>
</ul>

<hr class="doc-section-divider">

<h2 id="geofence">Geofence</h2>

| Geofence | Outside the place |
|----------|-------------------|
| <b>Off</b> | The punch is saved. Location is stored when capture includes it. It is not judged. |
| <b>Soft</b> | The punch is saved after a reason. The reason is stored on that punch only. Check-out does not replace the check-in reason. |
| <b>Hard</b> | The punch is refused. No reason field is shown. |

A missing place with Soft or Hard refuses the punch with <i>Attendance place is not set for this employee</i>.

<hr class="doc-section-divider">

<h2 id="blocked">When a punch is refused</h2>

<ul>
<li>Self punch is off for this employee, by the preference order above.</li>
<li>An earlier app day is still open. Check that day out first.</li>
<li>Already checked in today, or already checked out today.</li>
<li>A supervisor has already saved a status for the day, and there is no open app punch.</li>
<li>The day is split across projects.</li>
<li>Salary is already posted for the day.</li>
<li>Hard geofence, or Soft geofence with no reason, or no place configured.</li>
<li>Location accuracy is too low, or the location is mocked.</li>
<li>A required photo failed to upload. The punch is not saved.</li>
</ul>

Field errors are shown on the field itself.

<hr class="doc-section-divider">

<h2 id="punch-details">Punch details</h2>

Daily Attendance and Employee Attendance keep the usual columns. App punch text is hidden until the more menu <b>Show punch details</b>.

The extra columns are on the same attendance row. The grid scrolls sideways. Plan and Summary stay on one line.

| Column | Content |
|--------|---------|
| Plan | Check-in plan. |
| Summary | Check-out summary. |
| Check-in away | Reason when check-in was outside a soft geofence. |
| Check-out away | Reason when check-out was outside a soft geofence. |
| Check-in / Check-out | Place, and a link to the map. |
| Photos | Check-in and check-out photos. |

<b>Hide punch details</b> returns the grid to the usual columns.

Changing the status of an app punch does not rewrite the in time or out time from the shift. A supervisor row that was not punched in the app still fills times from the shift when the status changes, as before.

<hr class="doc-section-divider">

<h2 id="status">Status</h2>

Check-in does not set Full Day, Absent, or Leave. The status stays empty while the app punch is open, so an open My Day punch is not treated as Absent.

After both the in time and the out time exist, the status is calculated with the same attendance rules as any other day (shift, grace, and the duration setting in HR Settings). It is not forced to Full Day.

A blank attendance row can already exist because a report or the day screen was opened. Check-in and check-out update that same row.

<hr class="doc-section-divider">

<h2 id="faq">FAQ</h2>

<b>My Day is missing after login.</b><br>
Confirm Employee self punch is enabled for the company (support or sales), the role has Self Attendance, and the user has a default Employee. Then sign in again. Use the refresh icon on the row if it still shows an old label.

<b>Inherit still shows latitude, longitude, radius, and territory.</b><br>
Those fields are the employee's own place. They are used when the HR geofence is Soft or Hard. Capture and Geofence on the employee are used only when Punch mode is Custom.

<b>Check-in did not ask for a reason, but check-out at the same spot did.</b><br>
The second GPS reading can fall just outside a small territory or radius. A reading within the phone's accuracy of the edge is treated as inside. If it is still outside, Soft asks for a reason on that punch only.

<b>Does this replace Attendance Entry on the More tab?</b><br>
No. <a href="#/field-sale-app/hr-and-payroll/attendance">Attendance Entry</a> is still the supervisor bulk entry. My Day is one employee's own check-in and check-out.

<b>Can the employee punch offline?</b><br>
No. The punch is sent when the phone is online. There is no queue, and the app does not check the employee out from background location.

<hr class="doc-section-divider">

<h2 id="related">Related</h2>

<ul>
<li><a href="#/field-sale-app/hr-and-payroll/my-day">My Day in the Field Sale App</a></li>
<li><a href="#/hr/hrms-settings">HR Settings</a></li>
<li><a href="#/hr/employees">Employee</a></li>
<li><a href="#/hr/daily-attendance">Daily Attendance</a></li>
<li><a href="#/hr/employee-attendance-screen">Employee Attendance</a></li>
<li><a href="#/field-sale-app/hr-and-payroll/attendance">Attendance Entry</a> — supervisor bulk entry, unchanged.</li>
</ul>

<section class="ai-index-only">

## Errors and warnings

Exact messages for My Day check-in and check-out. Visitors do not see this section; Vertex AI Search uses it to answer questions about on-screen errors.


### Self punch is off or the user has no employee

- **Type:** Error
- **Action:** Check in, Check out
- **When:** The signed-in user has no default employee, or self punch is off for that employee (Punch mode Disabled, or Inherit while HR self punch is off).
- **Example message:** *Employee is not set for this user* or *Self attendance is turned off*
- **Outcome:** The punch is not saved.
- **Solution:** Set a default Employee on the user, and set Punch mode to Custom or Inherit with Employee self punch on in HR Settings.

### Check in refused

- **Type:** Error
- **Action:** Check in
- **When:** An earlier day is still open, today is already checked in, or a supervisor, project split, or posted salary already covers today.
- **Example message:** *Check out the open day before checking in* or *Already checked in* or *Attendance for today is already marked* or *Enter what you will do today*
- **Outcome:** Check-in is not saved.
- **Solution:** Check out the open day first. If today is already marked, do not check in again. Enter the plan when the company requires it.

### Check out refused

- **Type:** Error
- **Action:** Check out
- **When:** There is no open check-in for the day being closed, that day is already closed, or the company requires a summary and it is blank.
- **Example message:** *Check out the open day first* or *Check in before checking out* or *Attendance for this day is already marked* or *Enter what you did today*
- **Outcome:** Check-out is not saved.
- **Solution:** Check in first, or check out the day that is still open. Enter the summary when the company requires it.

### Photo

- **Type:** Error
- **Action:** Check in, Check out, when capture includes a photo
- **When:** No photo is sent, the upload does not return a file, the image cannot be processed, the file is not JPEG, PNG, GIF, or WebP, or the file is larger than 5 MB.
- **Example message:** *Photo is required* or *Photo upload failed* or *Unable to process image file* or *Invalid file type. Please upload a JPEG, PNG, GIF, or WebP image.* or *File size exceeds 5MB*
- **Outcome:** The punch is not saved.
- **Solution:** Take the photo again as a JPEG, PNG, GIF, or WebP of 5 MB or less.

### Location and geofence

- **Type:** Error
- **Action:** Check in, Check out, when capture includes location, or geofence is Soft or Hard
- **When:** Latitude or longitude is missing, accuracy is missing or worse than 100 metres, the location is mocked, Soft or Hard geofence has no place on the employee, Hard geofence is outside the place, or Soft geofence is outside the place and the reason is blank.
- **Example message:** *Location is required* or *Location accuracy is required* or *Location accuracy is too low. Move outdoors and try again* or *Mock location is not allowed* or *Attendance place is not set for this employee* or *You are outside the allowed place* or *You are outside the allowed place. A reason is required*
- **Outcome:** The punch is not saved.
- **Solution:** Move outdoors and use a real GPS reading. Set the employee place when geofence is Soft or Hard. On Soft, enter a reason. On Hard, punch from inside the place.

</section>
