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

Enable WorkforceWorkforce is enabled from Manage -> Features. Saving the switch adds the header clock, Workforce manager page and labour reporting entry points.
Ready to clock inNot clocked in is the safe starting state. Clock In acts on the signed-in account; Swipe card acts on the employee identified by the card.
Confirm the shift startedAfter a successful clock-in, the modal shows On shift, the recorded start time and only the valid next action: Clock Out.
Manager attendance checkGeneral is the manager's current-shift board. Use Refresh before relying on it; the empty state means no open shift matched this branch at that request time.

Before the First Shift

  1. Create one employee account for each person who must have separate attendance.
  2. Open Manage -> Features, enable Workforce and click Save.
  3. Open Manage -> Workforce and confirm General is available.
  4. If staff use cards, edit each existing employee and assign a unique RFID card.
  5. Set an hourly wage only when Posnic should calculate wage payout.
  6. Ask every employee to test clock-in and clock-out before the first payroll period.

Know Which Identity Each Control Uses

ControlWhose shift changesPermission or setup
Clock In / Clock OutThe employee currently signed in to Posnic.Any authenticated employee can manage their own current shift when Workforce is enabled.
Swipe cardThe 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 -> GeneralNo shift changes; it reads current branch attendance.Viewing other employees' shifts requires employee read access.
Timecard correctionThe selected historical shift.Editing clock times, break minutes, tips or notes requires employee write access and creates an audit event.
Labour / PayoutNo 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

  1. Click the clock icon in the top header.
  2. Read the status. It must say Not clocked in before starting a new shift.
  3. Click Clock In once.
  4. Wait for the Clocked in success message. The same panel should change to On shift and show the recorded start time.
  5. Ask a manager to refresh Manage -> Workforce -> General and confirm the employee appears.
  6. Do not clock in again from another device; an already-open shift is rejected.

Clock Out and Declare Tips

  1. At the actual end of work, open Shift / Attendance.
  2. If Tips at clock-out is enabled, enter only the cash tips that this employee is declaring for this shift. Blank is allowed.
  3. Click Clock Out once and wait for confirmation.
  4. Confirm the status changes to Not clocked in.
  5. The server closes the shift and calculates worked minutes after recorded break minutes.
  6. Review unusual durations before exporting payroll.

Use a Staff Card on a Shared Till

The card field identifies the card owner on the server and toggles that person's current state. It is not the same as clocking the signed-in cashier in or out.

  1. Open Shift / Attendance on the shared terminal.
  2. Click or focus Swipe card.
  3. Swipe the employee's assigned card.
  4. Read the confirmation naming the employee and whether they clocked in or out.
  5. Clear and retry only if the panel reports an unassigned or invalid card.

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 behaviorWhat Posnic recordsManager action
Stale testThe 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 timeGross 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 minutesPosnic 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 markerThe 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 shiftThe 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.

  1. Open the detailed timecard or shift record from the labour workflow.
  2. Confirm the employee and date before editing anything.
  3. Enter the approved clock-in and clock-out times, then the verified break minutes.
  4. Correct declared tips only from supporting evidence.
  5. Add a note that explains the reason and who approved the correction.
  6. Save once, rerun the same date range and verify worked hours and payout.
  7. Retain the audit event; do not create a replacement shift merely to conceal an auto-close or missed clock-out.

Troubleshooting

SymptomCheck
Clock icon is missingEnable Workforce in Manage -> Features, save, then reload the application.
Clock In is rejectedCheck for an already-open shift and confirm the user session is valid.
Card does nothingAssign the card to an existing employee, use a unique UID and focus the swipe field.
Employee is missing from GeneralClick Refresh, then confirm the correct employee and branch were used.
General is empty after clock-outThat board shows open shifts. Use Labour / Payout or timecards for completed attendance.
Hours look too highLook for a forgotten clock-out or an open shift spanning the wrong period.
Clock In says a forgotten shift was closedReview 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 inA shift older than 16 hours was treated as stale; verify the old automatic closure and the new open shift.