Timesheets user actions

Introduction

This brief guide aims to help API consumers understand the functionality of timesheets within the Oyster platform and provide guidance for timesheet integrations.

How Timesheets in Oyster work

A timesheet is a document used to track the time a team member has worked or not worked during a specific period. Timesheets are records that enable team members to input their working hours in the Oyster platform, automatically incorporating any PTO or public holidays from the Oyster time off tool.

Creation of Timesheets

Timesheets can be created in two ways:

  • Generated by team members themselves through the platform
  • Automatically generated by the Oyster platform 3 business days before the end of the month, excluding weekends and holidays.

Submission Process

  • Team members can review, edit and submit their timesheets until the end of the month
  • Team members must confirm their hours are accurate before submitting. The system automatically submits the last saved draft if the team member hasn’t submitted the timesheet in time.
  • It is a legal requirement that timesheets must only be filled out and edited by the team members themselves. This ensures compliance with labor laws in various countries.

Review Process

  • Once submitted, timesheets are reviewed and approved by customers (company admins or managers)
  • Customers can review and confirm submitted timesheets before payroll cut-off dates
  • If customers do not review the timesheet, it will be auto-approved on the payroll cut-off date
  • Approved timesheets are then used by Oyster to calculate payroll

Conclusion

When integrating timesheets using the Oyster API, it is important to keep in mind the above user actions to ensure timely, compliant payroll. If you have any questions about integrating the Timesheets API, see this guide.