| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Employees (hr)
• Discuss (mail) |
| Lines of code | 724 |
| Technical Name |
gb_holiday_pay_calculator |
| License | OPL-1 |
| Website | https://gencbaris.com/odoo_plugins/ |
| Versions | 18.0 19.0 |
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Employees (hr)
• Discuss (mail) |
| Lines of code | 724 |
| Technical Name |
gb_holiday_pay_calculator |
| License | OPL-1 |
| Website | https://gencbaris.com/odoo_plugins/ |
| Versions | 18.0 19.0 |
Holiday Pay 52-wk Average
Rolled-up holiday pay using UK 52-week statutory averaging for variable-hours staff
Holiday pay for variable and irregular-hours workers is a frequent source of miscalculation and genuine legal risk, because it must average pay over a statutory reference period rather than use a flat weekly rate. This module implements the UK 52-week averaging rule directly in Odoo HR: you log weekly pay (regular, overtime and commission, excluding one-off bonuses) per employee, and the engine builds an averaged weekly and daily figure by collecting 52 paid weeks while skipping zero-pay weeks and looking back up to 104 weeks, exactly per guidance. Requests run through a draft-to-paid approval workflow, each storing a full calculation note for audit, and a rolled-up 12.07% method plus a side-by-side comparison help you apply the correct, worker-favourable result. A batch wizard processes a whole team at once. It does not submit anything to HMRC; it produces the defensible figures your payroll team needs.
Key Features
Statutory 52-week averaging engine
_gather_reference_weeks walks gb.hol.pay.period records backwards from the leave start, collecting the configured number of paid weeks (default 52) while skipping zero-pay weeks and looking back up to the cap (default 104). _calculate_average then derives average weekly and daily pay and the holiday pay due, exactly per UK guidance.
Weekly pay reference log
Each gb.hol.pay.period records hours_worked plus regular_pay, overtime_pay, commission_pay and a one-off bonus_pay for a week. averageable_pay is computed to include regular, overtime and commission but exclude one-off bonuses, and is_zero_pay flags weeks that the averaging engine skips.
Rolled-up 12.07% method
For genuinely irregular-hours workers, _calculate_rolled_up applies the configurable rolled_up_rate (default 12.07%, i.e. 5.6/46.4 weeks) to a period pay base. Each request picks 'average' or 'rolled_up', so you use whichever method is correct for the worker.
Method comparison advisory
compare_methods computes the holiday pay due under both the 52-week average and the rolled-up method without saving, returning the difference, and action_show_comparison posts it to the chatter. Payroll can advise which method is more favourable to the worker before committing.
Approval workflow with audit note
gb.hol.pay.request runs draft to calculated to approved to paid (or cancelled) with guarded transitions on mail.thread. Every calculation stores weeks_used, weeks_skipped, total reference pay and a full plain-text calculation_note, giving a defensible audit trail for tribunals or audits.
Configurable per-company settings
gb.hol.pay.config sets reference_weeks, max_lookback_weeks, overtime/commission inclusion, the rolled-up rate and statutory_weeks_entitlement, validated so look-back cannot be smaller than the reference period. get_active_config resolves (and seeds) the active policy per company.
Batch generation across a team
The gb.hol.pay.batch.wizard creates holiday pay requests for selected employees, or every employee flagged is_variable_hours, over a date range and optionally calculates them immediately. Employees lacking reference data are left in draft instead of erroring, so a whole leave period is processed in one run.
Employee tools and payroll hooks
hr.employee gains an is_variable_hours flag, weekly-log and request smart counts, and a standalone get_current_average_weekly_pay callable from payroll integrations. get_holiday_pay_summary returns paid requests, total paid and the current averaged weekly pay for reporting.
Use Cases
Screenshots
Generate Holiday Pay
Holiday Pay Settings
Weekly Pay Log
Holiday Pay Requests
Why Choose This Module
Holiday pay for variable and irregular-hours workers is a common source of miscalculation — and real legal risk. This module computes statutory holiday pay using the UK 52-week reference period rule: it builds an averaged weekly pay figure from historical pay periods, skips zero-pay weeks and looks back up to 104 weeks to gather 52 paid weeks, exactly per UK guidance — with a defensible audit trail. No HMRC submission; it produces the figures your payroll team needs.
Specifications
- Compatible: Odoo 18.0 / 19.0
- License: LGPL-3
- Languages: 35+
- Author: Baris Genc
- Dependencies: hr
- Support: odoo@gencbaris.com
Odoo Proprietary License v1.0 This software and associated files (the "Software") may only be used (executed, modified, executed after modifications) if you have purchased a valid license from the authors, typically via Odoo Apps, or if you have received a written agreement from the authors of the Software (see the COPYRIGHT file). You may develop Odoo modules that use the Software as a library (typically by depending on it, importing it and using its resources), but without copying any source code or material from the Software. You may distribute those modules under the license of your choice, provided that this license is compatible with the terms of the Odoo Proprietary License (For example: LGPL, MIT, or proprietary licenses similar to this one). It is forbidden to publish, distribute, sublicense, or sell copies of the Software or modified copies of the Software. The above copyright notice and this permission notice must be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Please log in to comment on this module