Configure Odoo HR & Payroll Systems

This skill guides HR managers and payroll accountants through correctly setting up Odoo HR and Payroll, covering salary structure creation with Python-computed rules, time-off policies, employee contract types, and the payroll-to-accounting journal posting flow. Activate it by mentioning @odoo-hr-payroll-setup and describing your payroll scenario; it responds with step-by-step configuration for salary rules and leave allocation, or a root cause analysis if you paste in a salary rule or payslip issue.

A salary structure example shows how rules execute top-to-bottom, each with a code, formula, and category - a BASIC rule reading contract.wage, a GROSS rule equal to BASIC, deduction rules for Social Security (6.2%), Medicare (1.45%), and Federal Income Tax (via a variable withholding rate input), and a NET rule summing GROSS plus the three deductions. It also walks through configuring a time-off type (approval routing, self-allocation, negative-balance rules, initial day allocations) and shows the accounting journal entries Odoo generates after validating a payroll batch - a debit to the salary expense account against credits to social security, Medicare, tax, and salary payable accounts, followed by the payment entry when net salary is disbursed.

Use it when creating a salary structure with gross pay, deductions, and net pay; configuring annual leave, sick leave, or public holiday policies; troubleshooting incorrect payslip amounts or missing rule contributions; or setting up the payroll journal to post correctly to accounting.

Odoo Payroll is Enterprise-only - the Community Edition does not include the hr_payroll module, so this skill assumes Enterprise. It does not cover multi-country payroll (each country needs its own structure and localization), does not generate US tax filings like W2 or 941 directly, and expense reimbursements via payslip require a custom salary rule input not covered in the standard documentation.

Inputs are your payroll scenario description or a specific salary rule/payslip problem. Outputs are step-by-step Odoo configuration instructions or a root-cause diagnosis, grounded in best practices: install your country's payroll localization (e.g. l10n_us_hr_payroll) before building custom rules, use salary rule inputs like inputs.ALLOWANCE.amount instead of hardcoding variable values, archive rather than delete old salary structures since active payslips reference them, and always verify an active Employee Contract exists before generating payslips. It also warns against manually editing posted payslips (cancel and regenerate instead) and against using contract.wage in deduction rules without checking whether the structure period is monthly or annual.

HR managers and payroll accountants configuring or debugging Odoo HR and Payroll - salary structures, leave policies, and the payroll-to-accounting posting flow - on Odoo Enterprise.