Documentation

Timesheets

Auto-generated weekly timesheets derived from clock-in data, with per-day approval workflows, overtime calculation, color-coded status indicators, and CSV export for payroll integration.

How Timesheets Are Generated

Timesheets are automatically generated from clock-in/clock-out data recorded in the Attendance & Clock-In module. No manual entry is required β€” the system calculates daily hours worked based on authenticated attendance records.

  • Timesheets are generated on a weekly cycle (Monday to Sunday)
  • A new timesheet is created for each staff member at the start of each week
  • Hours are updated in real-time as clock-in/out events are recorded
  • If a staff member has no clock-in data for a day, it appears as 0.0 hours (incomplete)
Timesheets cannot be manually created or edited. They are a read-only reflection of attendance data. To correct hours, adjust the underlying clock-in/out records in the Attendance module.

Weekly Grid View

The timesheet interface displays a weekly grid showing hours per day for each staff member:

Staff NameMonTueWedThuFriSatSunTotalStatus
Adebayo Ogunlesi8.08.09.58.07.50.00.041.0Pending
Chioma Nwosu8.04.08.08.08.00.00.036.0Partial

Color Coding

ColorConditionMeaning
 Hours ≀ 8.0Normal working hours β€” within expected range
 Hours > 8.0Overtime detected β€” exceeds standard working hours
 Hours < expected & no leaveIncomplete β€” staff left early or has missing clock-out

Timesheet Statuses

Each weekly timesheet has one of three statuses:

StatusDescriptionNext Action
ApprovedAll days in the week have been reviewed and approvedReady for payroll export
PartialSome days approved, others still pending or rejectedReview remaining days
RejectedOne or more days rejected; requires attentionStaff/admin must resolve issues

Per-Day Approve/Reject Workflow

Managers can approve or reject attendance on a per-day basis for granular control:

  1. Navigate to Workforce > Timesheets
  2. Select the week using the date picker
  3. Click on a staff member's row to expand the daily detail view
  4. For each day, click Approve (βœ“) or Reject (βœ—)
  5. If rejecting, enter a reason (mandatory) β€” e.g., "Missing clock-out, unverified hours"
  6. Click Save to confirm decisions
Rejected days send a notification to the staff member via the Self-Service Portal. They can view the rejection reason but cannot modify the timesheet directly β€” they must contact their manager.

Bulk Approve

For efficient processing of large teams:

  1. Go to Workforce > Timesheets
  2. Filter by department, branch, or team
  3. Check the Select All checkbox at the top of the grid
  4. Click Bulk Approve
  5. Confirm the action β€” all selected timesheets will be marked as Approved
Bulk approve will approve ALL days for all selected staff, including days with overtime or incomplete hours. Review the color coding carefully before bulk approving. Days already rejected will NOT be overridden by bulk approve.

Overtime Calculation

The system automatically calculates overtime based on your configured standard hours:

  • Standard Hours: Configurable per organization (default: 8 hours/day)
  • Overtime Formula: Total hours worked βˆ’ Standard hours = Overtime hours
  • Weekly Overtime: Total weekly hours beyond 40 hours flagged separately
  • Overtime Rate: Configured in Organization Settings (e.g., 1.5x, 2.0x for weekends)

Overtime hours are displayed in a separate column when viewing individual timesheet details, and are included in payroll exports.

Export to CSV

Export timesheets for payroll processing or external record-keeping:

  1. Navigate to Workforce > Timesheets
  2. Select the desired week or date range
  3. Optionally filter by department or approval status
  4. Click Export > CSV

The exported CSV includes the following columns:

ColumnDescription
Staff IDUnique employee identifier
Staff NameFull name
DepartmentAssigned department
Week StartingMonday date of the timesheet week
Mon–SunHours worked each day
Total HoursSum of all daily hours
Overtime HoursHours exceeding standard per day
StatusApproved / Partial / Rejected
Approved ByManager who approved the timesheet
Approved DateDate of final approval
Only timesheets with status "Approved" are recommended for payroll processing. You can filter the export to only include approved timesheets using the status filter before exporting.