OdooWiki OCA HUB

HR Timesheet Sheet based on Payroll Period

hr_timesheet_sheet_period folder_open OCA/timesheet open_in_new
Human Resources License: AGPL-3

This module allows to create timesheets with start and end dates matching with the payroll period of the schedule pay that is specified in the contract of the employee or if not then will match the nearest payroll period.

auto_awesome What this module does

AI-generated from the code · Odoo 15.0

Lets companies align employee timesheet sheets with payroll periods, so each sheet covers exactly the same dates as the pay period. A new "Payroll Period" option is added to the company timesheet range setting.

When a company sets its timesheet range to "Payroll Period", timesheet sheets are no longer free-form date ranges: they are tied to a payroll period.

  • On the timesheet sheet form, a new "Pay Period" field appears. It is required when the company uses the payroll period range, and it is read-only once the sheet leaves draft.
  • Choosing a pay period automatically fills the sheet's start date, end date and name from that period.
  • Selecting an employee also refreshes the pay period to the one covering today, using the employee's contract pay schedule when available, otherwise the nearest matching period.
  • Odoo blocks saving if no suitable payroll period is found, or if the sheet's start or end date does not match the selected period's dates.
  • The timesheet list view gains a "Pay Period" column and a "Current Period" filter, and the "All Timesheets" action opens filtered on the current period by default.

It touches the timesheet sheet model hr_timesheet.sheet and the company settings model res.company.

Depends on

hr_payroll_periodhr_timesheet_sheet
Models and fields (2)
  • res.company · extends an existing modelsheet_range
  • hr_timesheet.sheet · extends an existing modelhr_period_id (Pay Period), is_hr_period_required

Text generated by AI (DeepSeek) from reading the Odoo 15.0 code on GitHub; it may contain mistakes, so check the code before deciding. View the code on GitHub

Availability by version

Reviewed: 2026-11-03
Confirmed (verified in repository and branch) Estimated (unverified) No information

Confirmation status: 3 confirmed, 6 with no information of 9 versions.

Sources · Odoo 12.0

Confirmed on 2026-11-03 in branch 12.0 of OCA/timesheet.

terminal Installation and usage

OCA documentation · Odoo 15.0

Configuration

Source · Odoo 15.0

Configure Timesheet Sheets:

  • Go to Timesheets > Configuration > Settings
  • Set Timesheet Sheet Range to Payroll Period

Configure Payroll Fiscal Years and Payroll Periods:

  • Go to Human Resources > Configuration > Payroll
  • Configure Payroll Fiscal Years
  • Configure Payroll Periods:

Usage

Source · Odoo 15.0

When the user goes to 'Human Resources > Time Tracking > My current timesheet', the application will attempt to create a new timesheet using start and end dates of the Pay Period corresponding to today's date as per the Schedule Pay mentioned in the Employee's contract.

No verified information in OCA: Installation.

info

Data imported from GitHub: this sheet reflects the latest catalog review, not a live lookup. Always check the module documentation and staging before installing in production.