Odoo Payroll UAE: WPS, Gratuity and Setup Guide
27 October 2026 · Emiracle Advisory
Quick answer: Odoo payroll UAE setups work best when the UAE payroll localisation, contracts and salary rules mirror Federal Decree-Law No. 33 of 2021. Split basic wage from allowances, accrue gratuity at 21 or 30 days of basic wage per year, configure leave and overtime rules, generate or export the WPS salary information file, and post every payslip to the right ledger accounts.
Key takeaways
- Gratuity, overtime and leave encashment are all driven by basic wage, so the basic and allowance split in each Odoo contract must match the signed employment contract.
- Salaries for the previous month are due on the first day of each Gregorian month and must be paid through WPS.
- Odoo publishes a UAE payroll localisation, but features differ between versions and between Community and Enterprise. Check before you design.
- Accrue gratuity and leave provisions monthly so your balance sheet shows the real liability.
- Run at least one parallel payroll and test the WPS file with your bank or exchange house before go live.
What does Odoo payroll UAE actually cover?
Odoo Payroll is part of the Odoo HR suite, alongside Employees, Time Off, Attendances and Accounting. Payslips are calculated from the employee contract, the salary structure and its salary rules, plus work entries for days worked, leave and overtime. Odoo also publishes a dedicated United Arab Emirates payroll localisation page in its documentation.
Be careful with assumptions. The Payroll app is an Enterprise feature, and the content of the UAE localisation (salary structures, provisions, WPS file generation, reports) varies by Odoo version and edition. Some companies on older versions, or on Community, rely on apps from the Odoo Apps store or on custom salary rules for the same results. Confirm what your version includes before you promise anything to finance or HR.
The building blocks
- Employee record: personal details, Emirates ID, passport, MOHRE person or labour card number, bank account and IBAN.
- Contract: start date, wage type, basic wage and each allowance, working schedule and salary structure.
- Salary structure and rules: the formulas for earnings, deductions, provisions and net pay.
- Work entries and time off: attendance, leave, unpaid days and overtime that feed the payslip.
- Accounting: journals and accounts that every salary rule posts to.
How does WPS work and how does Odoo produce the SIF?
The Wages Protection System is the electronic channel through which private sector employers registered with MOHRE pay wages. According to u.ae guidance on payment of wages, salaries for the previous month are due on the first day of each Gregorian month and are transferred through banks, exchange houses or financial institutions authorised by the Central Bank of the UAE. MOHRE monitors payments from the due date, sends alerts, and escalates to measures such as suspending new work permits, fines and labour cases if wages stay unpaid.
What goes into the salary information file
The salary information file (SIF) is the payment instruction your bank or exchange house submits on your behalf. In practice it carries an employee line for each worker (MOHRE person ID, bank routing code, account or IBAN, pay period, fixed pay, variable pay and leave days) and an employer control line (MOHRE establishment ID, bank details, totals and salary month). The exact layout is validated by your WPS agent, so always get their current specification.
Generating it from Odoo
Depending on your version, the UAE localisation can produce a WPS file from a payslip batch, or a third party app or custom export does it. Either way, the file is only as good as the master data. Every employee needs a valid MOHRE ID, routing code and IBAN, and the company needs its MOHRE establishment number stored in Odoo. Fixed pay should equal contractual basic plus fixed allowances, with overtime and bonuses in variable pay.
How do you calculate end of service gratuity in Odoo payroll UAE?
Gratuity follows Federal Decree-Law No. 33 of 2021 and its implementing regulation. The official summary on u.ae end of service benefits sets the rules below.
| Item | Rule for full time private sector employees | Odoo configuration point |
|---|---|---|
| Eligibility | At least 1 year of continuous service | Contract start date and service calculation |
| Years 1 to 5 | 21 days of basic wage per year | Provision rule rate for first five years |
| After 5 years | 30 days of basic wage per year | Second tier in the same rule |
| Partial years | Paid proportionally | Prorate by days of service |
| Unpaid absence | Not counted as service | Unpaid leave work entry type excluded |
| Wage basis | Basic wage only, allowances excluded | Separate basic field in the contract |
| Cap | Total cannot exceed 2 years of wages | Cap check in the final settlement rule |
| Payment | Within 14 days of contract termination | Final payslip and payment deadline |
Monthly provision versus final settlement
Treat gratuity as two calculations. The monthly provision accrues the liability as service builds up. The final settlement calculates the actual entitlement on termination, using the last basic wage, service net of unpaid days and the cap, then releases the provision and books any difference. Agree the daily rate convention with your advisor and apply it consistently across both. Part time employees are prorated by contracted hours, and companies enrolled in the alternative savings scheme contribute 5.83 per cent of basic salary under five years of service and 8.33 per cent after five years instead of accruing new gratuity.
How should leave, overtime and allowances be set up?
Annual and sick leave
Employees earn 30 days of paid annual leave after one year of service, and 2 days per month for service between six months and one year. Leave encashment on termination is calculated on basic salary, and unused leave can be carried forward with employer consent. Sick leave after probation runs up to 90 days a year: full pay for the first 15 days, half pay for the next 30, then unpaid. Configure each as a separate time off type linked to its own work entry type, so payslips pick up full, half and unpaid days correctly.
Overtime
Overtime is capped at two extra hours a day. Normal overtime is paid at the normal rate plus at least 25 per cent, rising to at least 50 per cent between 10 pm and 4 am, and rest day work earns a substitute day or normal pay plus 50 per cent. Shift workers are treated differently. Create separate overtime inputs or work entry types for each case and make the hourly rate formula visible to HR.
Allowances
Housing, transport, telephone and other allowances should each have their own field or input and salary rule. This keeps them out of the gratuity basis, lets you map them to separate expense accounts and makes the payslip readable for employees.
Which accounting entries should payroll post?
| Event | Debit | Credit |
|---|---|---|
| Monthly payslip | Basic salary and allowance expense accounts | Salaries payable |
| Deductions (loans, advances) | Salaries payable | Employee advances or loan receivable |
| Gratuity provision | End of service benefit expense | Provision for end of service benefits |
| Leave provision | Leave salary expense | Accrued leave liability |
| WPS payment | Salaries payable | Bank |
| Final settlement | Provision for end of service benefits, plus expense for any shortfall | Salaries payable |
Use analytic accounts or departments so labour costs reach projects and cost centres. Reconcile the salaries payable account to zero after every WPS run and reconcile the gratuity provision to an independent schedule at least once a year, especially before audit.
What are the implementation steps for Odoo payroll UAE?
- Confirm version and edition. Check what the UAE payroll localisation includes for your Odoo version and whether you need extra apps.
- Collect master data. Contracts, MOHRE IDs, Emirates IDs, IBANs, routing codes, joining dates and leave balances for every employee.
- Design the chart of accounts. Separate expense, payable and provision accounts for each salary component.
- Configure contracts and structures. Load basic wage and allowances exactly as signed, and assign the UAE salary structure.
- Set up time off and work entries. Annual, sick, unpaid and other leave types, overtime categories and attendance rules.
- Build and test salary rules. Gratuity, leave and overtime rules, tested against manual calculations for sample employees.
- Load opening balances. Gratuity provision, leave balances and year to date figures from the old system.
- Run parallel payrolls. Compare Odoo output with the legacy payroll line by line for one or two months.
- Test the WPS file. Submit a test or validate the format with your bank or exchange house.
- Go live and train. Train HR and finance on monthly close, final settlements and approvals.
Odoo payroll UAE checklist
- Company MOHRE establishment ID and WPS agent details recorded
- Every employee has a MOHRE person ID, IBAN and routing code
- Basic wage and allowances in Odoo match the MOHRE contract
- Gratuity rule handles 21 and 30 day tiers, proration, unpaid days and the cap
- Leave types and sick leave pay bands configured
- Overtime categories with correct premiums
- Every salary rule mapped to an account
- Opening balances reconciled and signed off
- WPS file validated by the bank or exchange house
- Payroll access restricted and approvals in place
What mistakes should you avoid with Odoo payroll UAE?
- Calculating gratuity on gross salary. This overstates the liability and creates disputes at settlement.
- Ignoring unpaid leave. Unpaid absence days are excluded from service and must reduce the gratuity calculation.
- Contract mismatches. If Odoo pays a basic wage that differs from the MOHRE contract, WPS and labour records will not agree.
- Assuming features exist. Do not assume your version includes WPS export or provisions. Check the documentation first.
- Skipping parallel runs. One untested rule can underpay a whole department.
- No provision reconciliation. Auditors will ask for a gratuity schedule that ties to the ledger.
How Emiracle helps
Emiracle Advisory combines UAE compliance knowledge with hands on Odoo ERP implementation. We design salary structures and rules that follow the Labour Law, map payroll to your chart of accounts, migrate opening balances and test WPS output with your bank. Our compliance focused Odoo ERP approach keeps payroll, VAT and corporate tax reporting in one system, and our PRO and government services team handles MOHRE contracts, work permits and labour cards so the data in Odoo matches official records. Where you need it, our corporate tax advisors review how payroll costs and provisions are treated in your returns.
Ready to move payroll into Odoo with confidence? Book a consultation with Emiracle or call or WhatsApp +971 52 185 3005 to discuss your headcount, version and timeline.
Frequently asked questions
Does Odoo payroll UAE support WPS salary files out of the box?
Odoo publishes a UAE payroll localisation for recent versions of its Enterprise Payroll app, and its documentation covers UAE specific payroll setup. What is included, such as WPS file generation, varies by Odoo version and edition, so confirm against the documentation for your exact version and test the file with your bank or exchange house before go live.
How is end of service gratuity calculated in the UAE?
Under Federal Decree-Law No. 33 of 2021, a full time private sector employee with at least one year of continuous service earns 21 days of basic wage for each of the first five years and 30 days for each year after that. Partial years are prorated, unpaid absence days are excluded and the total cannot exceed two years of wages.
Are allowances included in the gratuity calculation?
No. According to u.ae, gratuity is calculated on basic salary only. Housing, transport, utilities and similar allowances are excluded, which is why the split between basic wage and allowances in each Odoo contract must match the signed employment contract.
When must salaries be paid through WPS?
According to u.ae, salaries for the previous month are due on the first day of each Gregorian month. MOHRE monitors payments from the due date, with alerts and then progressively stronger measures, such as suspension of new work permits, if wages are not paid through WPS.
How should overtime be configured in Odoo for UAE staff?
Create separate work entry or input types for normal overtime, night overtime between 10 pm and 4 am, and rest day work. Then build salary rules that apply the statutory premiums of at least 25 per cent and 50 per cent on the basic wage rate, with approval through Attendance or a manager workflow.
Should gratuity be accrued monthly in the books?
Most UAE companies accrue an end of service provision every month so the balance sheet reflects the liability as it builds up. In Odoo this can be done with a provision salary rule that posts to a dedicated liability account, reconciled against an independent gratuity schedule at least once a year.
Can Odoo payroll handle employees on the alternative savings scheme?
It can be configured to, using a contribution salary rule based on basic salary and a liability or payable account for the approved fund. The scheme rates published on u.ae are 5.83 per cent of basic salary under five years of service and 8.33 per cent after five years. Any gratuity accrued before enrolment still has to be settled.
How long does an Odoo payroll implementation take?
It varies with headcount, number of entities, data quality and how many custom rules you need. A small single entity company with clean data moves much faster than a group with several licences, multiple WPS establishments and legacy payroll history. Plan at least one or two parallel payroll runs before switching off the old system.
Last reviewed: 27 October 2026. Rules change; confirm current requirements with an Emiracle advisor before you apply.
