Workforce
Enable Workforce and Record Staff Attendance
The header clock creates the attendance record that later feeds worked hours, labour cost and timecard exports.
- Menu path
- Manage -> Features -> Workforce; header clock -> Shift / Attendance
- Verified from
- Posnic demo and current POS source reviewed on 2026-09-08
Technical source evidence
Current local Posnic Workforce feature, Shift / Attendance modal and General page exercised 2026-09-09, frontend/modules/settings_write.html Features and Workforce General, frontend/static/script/js/core/PosnicPro.js shiftWidget and workforce board, api/src/controllers/shifts.controller.js self-service, read and write permission boundaries, api/src/constants/shift.constants.js 16-hour stale threshold and 12-hour cap, api/src/repositories/shift.repository.js clock, card toggle, correction and worked-minute calculation, api/src/routes/shifts.routes.js
Before the First Shift
- Create one employee account for each person who must have separate attendance.
- Open Manage -> Features, enable Workforce and click Save.
- Open Manage -> Workforce and confirm General is available.
- If staff use cards, edit each existing employee and assign a unique RFID card.
- Set an hourly wage only when Posnic should calculate wage payout.
- Ask every employee to test clock-in and clock-out before the first payroll period.
Know Which Identity Each Control Uses
| Control | Whose shift changes | Permission or setup |
|---|---|---|
| Clock In / Clock Out | The employee currently signed in to Posnic. | Any authenticated employee can manage their own current shift when Workforce is enabled. |
| Swipe card | The employee who owns the scanned RFID or swipe-card code. | The terminal must be signed in and the card must already be assigned to exactly one employee. |
| Workforce -> General | No shift changes; it reads current branch attendance. | Viewing other employees' shifts requires employee read access. |
| Timecard correction | The selected historical shift. | Editing clock times, break minutes, tips or notes requires employee write access and creates an audit event. |
| Labour / Payout | No shift changes; it aggregates attendance for a date range. | The report requires employee read access; payout additionally depends on each employee's saved hourly wage. |
Clock In as the Signed-In User
- Click the clock icon in the top header.
- Read the status. It must say Not clocked in before starting a new shift.
- Click Clock In once.
- Wait for the Clocked in success message. The same panel should change to On shift and show the recorded start time.
- Ask a manager to refresh Manage -> Workforce -> General and confirm the employee appears.
- Do not clock in again from another device; an already-open shift is rejected.
Clock Out and Declare Tips
- At the actual end of work, open Shift / Attendance.
- If Tips at clock-out is enabled, enter only the cash tips that this employee is declaring for this shift. Blank is allowed.
- Click Clock Out once and wait for confirmation.
- Confirm the status changes to Not clocked in.
- The server closes the shift and calculates worked minutes after recorded break minutes.
- Review unusual durations before exporting payroll.
Recover a Forgotten Clock-Out
Posnic protects payroll from an indefinitely open shift. When the employee's existing shift is more than 16 hours old, the next Clock In or staff-card swipe automatically closes that forgotten shift and starts a new one.
- A normal Clock Out before the shift is stale closes at the actual request time and does not use the 12-hour cap.
- A staff-card swipe on a fresh open shift clocks that cardholder out; on a stale open shift it auto-closes the old record and clocks the cardholder in again.
- The safeguard prevents an accidental very long payable shift, but its capped time is not proof of the hours actually worked.
- Managers should review auto-closed records before labour or payroll export and document the approved correction.
| Recovery behavior | What Posnic records | Manager action |
|---|---|---|
| Stale test | The open shift must be older than 16 hours; exactly 16 hours is not yet stale. | Do not wait for the threshold when the mistake is noticed earlier; ask a manager to correct the timecard. |
| Automatic close time | Gross time is capped at 12 hours from the original clock-in, even if the shift remained open longer. | Compare with the approved actual finish time and correct it when the cap is not the true shift. |
| Worked minutes | Posnic subtracts recorded break minutes from the capped gross duration and never records a negative result. | Verify breaks as well as clock-in and clock-out. |
| Audit marker | The shift note receives [auto clock-out], and the automatic closure is audited. | Preserve that marker; make an authorized timecard correction instead of hiding the incident. |
| New shift | The same action then creates a fresh open shift at the current time. | Confirm the employee is now On shift and that only one current shift is open. |
Manager Daily Check
- Open Manage -> Workforce -> General and click Refresh.
- Confirm every person physically working appears under On shift right now.
- Treat No one is clocked in right now as a statement about open shifts returned for the current branch and request time, not proof that no employee worked earlier.
- Investigate an unexpectedly long open shift before day close.
- Do not use another employee's login to repair attendance; preserve individual identity.
- Use the Labour / Payout report for closed-shift history and exports.
Correct a Timecard Without Hiding the Error
A manager correction can replace clock-in, clock-out, break minutes, tips or the note on an existing shift. Posnic recalculates worked minutes when both times exist and writes a shift-edit audit event.
- Open the detailed timecard or shift record from the labour workflow.
- Confirm the employee and date before editing anything.
- Enter the approved clock-in and clock-out times, then the verified break minutes.
- Correct declared tips only from supporting evidence.
- Add a note that explains the reason and who approved the correction.
- Save once, rerun the same date range and verify worked hours and payout.
- Retain the audit event; do not create a replacement shift merely to conceal an auto-close or missed clock-out.
Troubleshooting
| Symptom | Check |
|---|---|
| Clock icon is missing | Enable Workforce in Manage -> Features, save, then reload the application. |
| Clock In is rejected | Check for an already-open shift and confirm the user session is valid. |
| Card does nothing | Assign the card to an existing employee, use a unique UID and focus the swipe field. |
| Employee is missing from General | Click Refresh, then confirm the correct employee and branch were used. |
| General is empty after clock-out | That board shows open shifts. Use Labour / Payout or timecards for completed attendance. |
| Hours look too high | Look for a forgotten clock-out or an open shift spanning the wrong period. |
| Clock In says a forgotten shift was closed | Review the previous shift's [auto clock-out] marker, capped duration and breaks, then make an authorized timecard correction if they differ from actual work. |
| Card swipe unexpectedly clocks in | A shift older than 16 hours was treated as stale; verify the old automatic closure and the new open shift. |