๐Ÿ“„ Article ยท Timesheet Addon

Timesheet Add-on โ€” Help Documentation

Everything you need to install, set up, and use the Timesheet Addon.

โ† Back to Timesheet Addon

Overview

The Timesheet Add-on allows ServiceM8 users to record, review, and approve staff timesheets directly against ServiceM8 jobs. Staff can quickly log their work hours, while managers can review and approve timesheets before payroll processing.

Key features include:

  • โœ“ Job-based timesheet entry
  • โœ“ Mobile-friendly interface
  • โœ“ Manager approval workflow
  • โœ“ Staff role permissions
  • โœ“ Secure connection with your ServiceM8 account

Installation

Follow the steps below to install the Timesheet Add-on.

Step 1 โ€” Install the Add-on

  • โœ“ Log in to ServiceM8
  • โœ“ Open the Add-ons section
  • โœ“ Search for Timesheet Add-on
  • โœ“ Click Install
  • โœ“ Authorise the add-on when prompted

Once installed, the add-on will be connected to your ServiceM8 account.

Getting Started (First-Time Setup)

After installation, complete the initial setup.

Step 1 โ€” Open the Add-on

  • โœ“ In ServiceM8, navigate to Add-ons
  • โœ“ Select Timesheet Add-on

The add-on will automatically connect to your ServiceM8 account.

Step 2 โ€” Sync Staff Members

The add-on automatically retrieves staff members from ServiceM8.

  • โœ“ Open Staff Settings
  • โœ“ Review the list of imported staff
  • โœ“ Confirm that all required staff members appear

If a staff member is missing, ensure they exist in ServiceM8 Staff Settings and then select Sync Staff to bring them across to the Addon.

Step 3 โ€” Assign Staff Roles

Each staff member that requires access to the addon must be assigned a role.

  • โœ“ Open Staff Settings
  • โœ“ Select a staff member
  • โœ“ Choose a role

Save your changes once roles are assigned.

RolePermissions
EmployeeCan submit and edit their own timesheets
ManagerCan review and approve selected staff timesheets
AdministratorFull access to system settings and approving all timesheets

Creating a Timesheet Entry

Staff can record their work hours by submitting a timesheet entry.

Step-by-step instructions

  • โœ“ Open the Timesheet Add-on
  • โœ“ Enter the Start Time
  • โœ“ Enter the End Time
  • โœ“ Enter Break Minutes if applicable
  • โœ“ Search for and select the ServiceM8 Job
  • โœ“ Add optional Notes and Allowances
  • โœ“ Click Submit

Once submitted, the entry will be sent for manager approval. If additional entries are required per day, select the "+" at the end of the day to add another time entry for that day.

Viewing Your Timesheets

Staff can review previously submitted timesheets.

  • โœ“ Open the Timesheet Add-on
  • โœ“ Navigate to the bottom of the window to the History section
  • โœ“ Select a timesheet entry to view details

Timesheets will show one of the following statuses:

StatusMeaning
DraftTimesheet not yet submitted by employee
SubmittedAwaiting manager approval
ApprovedApproved and locked

Editing a Timesheet Entry

Timesheets can be edited before they are approved.

  • โœ“ Open Timesheet Addon
  • โœ“ Select the entry you want to edit
  • โœ“ Update the required fields
  • โœ“ Click Save

Once approved, entries can only be edited by administrators.

Approving Timesheets

Managers can review submitted timesheets.

To approve a timesheet

  • โœ“ Open the Timesheet Add-on
  • โœ“ On the left of the screen, all staff timesheets will be visible
  • โœ“ Select a timesheet
  • โœ“ Review the details
  • โœ“ Click Approve

The timesheet will now be locked and marked as approved. On approval the timesheet data is automatically synced into ServiceM8, and a note is created on the job card associated with the time entry, showing the changes made to that job's check-in data. Once a timesheet is approved, only an admin can un-approve it for additional editing. On approval, a new sync to ServiceM8 will be automatically completed.

Mobile Usage

The Timesheet Add-on can be used on mobile devices. It is accessible through:

  • โœ“ The ServiceM8 mobile app
  • โœ“ Mobile web browsers
  • โœ“ Supported Android applications

The interface automatically adjusts for mobile screen sizes.

Troubleshooting

Job not appearing when searching

Ensure:

  • โœ“ The job exists in ServiceM8
  • โœ“ The job is not archived
  • โœ“ You have permission to view the job

Unable to submit a timesheet

Check that:

  • โœ“ A job has been selected
  • โœ“ Start time is earlier than end time
  • โœ“ Required fields are completed

Staff member missing

Ensure the staff member has been created in ServiceM8 Staff Settings and Sync Staff has been selected.

Support

If you require assistance with the Timesheet Add-on, please contact support.