UAE employers in the mainland pay salaries through the Wage Protection System (WPS), run by the Ministry of Human Resources and Emiratisation (MOHRE). Odoo can calculate payroll and produce the salary file your bank or exchange house uploads to WPS. This guide explains how it fits together.
How WPS works
Each month the employer sends a Salary Information File (SIF) to a WPS agent, such as a bank or exchange house, together with the funds. The agent pays employees and reports the payment to MOHRE. Late or missing payments can lead to penalties and restrictions on the company, so the file must be accurate and on time.
Setting up UAE payroll in Odoo
Odoo Enterprise includes a UAE payroll localisation in recent versions. We check what your version supports and fill any gaps with configuration or a small module. A typical setup covers:
- Employee records with MOHRE person ID, bank or agent details and routing codes
- Salary structures with basic salary, housing, transport and other allowances
- Overtime, unpaid leave and deductions from timesheets or attendance
- Annual leave accruals
- End-of-service gratuity accruals
- The monthly WPS salary file in the format your agent requires
End-of-service gratuity
Under the UAE Labour Law, gratuity for full-time employees is based on basic salary: 21 days’ pay for each of the first five years of service and 30 days’ pay for each year after that, capped at two years’ total wages. Odoo can accrue this every month, so the liability on your balance sheet is always current and final settlements are quick.
Common WPS problems and how to avoid them
- Rejected files caused by wrong employee IDs or bank codes: validate employee data before the first run
- Salary differences between the file and accounting: post payroll journals from the same payslips
- Missed payments when an employee changes bank: lock bank changes to an approval step
- Free-zone staff mixed with mainland staff: use separate companies or pay structures where rules differ
Who needs to pay salaries through WPS
The Wage Protection System applies to companies registered with the Ministry of Human Resources and Emiratisation, which covers most mainland employers. Salaries are paid through an approved bank or exchange house using a Salary Information File. Many free zones have their own payroll rules, so free zone companies should check with their authority.
Paying late or outside WPS can lead to penalties, so payroll needs to be accurate and on time every month.
Building UAE salary structures in Odoo
Odoo Payroll uses salary structures and rules. For UAE companies we usually set up basic salary, housing and transport allowances, other fixed allowances, overtime, deductions and unpaid leave, so each payslip is calculated the same way every month.
Keeping basic salary separate from allowances matters, because end-of-service gratuity is calculated on basic salary.
- Basic salary, housing and transport allowances
- Overtime rules linked to attendance
- Deductions for advances, loans and unpaid leave
- Gratuity provision posted to accounting each month
- Payslips in English and Arabic
Leave, attendance and payroll together
Payroll errors usually start with attendance and leave. When Odoo Attendance, Time Off and Payroll work together, unpaid leave and overtime flow straight into payslips without manual adjustments, and managers approve leave in the same system.
Month-end payroll checklist in Odoo
A short routine each month keeps WPS payments on time and accurate.
- Approve attendance, overtime and leave for the month
- Check new joiners, leavers and salary changes
- Generate and review payslips in a batch
- Export the Salary Information File and upload it to your bank or exchange house
- Post the payroll journal entry and gratuity provision
- Reconcile the salary payment in Odoo when the bank confirms it
Connecting attendance devices to Odoo
Many UAE companies already use biometric or card-based attendance machines on sites and in warehouses. These can be connected to Odoo Attendance so check-in and check-out times feed payroll automatically, instead of being exported to spreadsheets and re-typed each month.
Reports HR and finance need
Once payroll runs in Odoo, HR and finance can see the same numbers without exporting spreadsheets.
- Monthly payroll summary by company, department or project
- Salary cost charged to projects or cost centres
- Leave balances and leave liability
- Gratuity provision and liability
- Headcount, joiners and leavers
Moving payroll from Excel to Odoo
Most companies we work with run payroll in spreadsheets before moving to Odoo. A safe move follows a few clear steps.
- Import employee records, contracts, salary details and bank information
- Set up salary structures and test them against last month’s spreadsheet
- Run one or two months in parallel and compare results
- Switch to Odoo once the figures match, then retire the spreadsheet
Common WPS mistakes to avoid
Most WPS rejections come from data issues rather than calculation errors. Keep employee records complete and checked.
- Wrong or missing personal or labour card numbers
- Incorrect bank routing codes or IBANs
- Salary paid differs from the contract amount
- Missing records for employees on leave or newly joined
How O Prime helps
We implement and support Odoo payroll for UAE companies, including manpower and labour-supply businesses with large monthly payrolls. See Odoo implementation in Dubai, Odoo support in Dubai and our guide to Odoo for manpower companies.
Frequently asked questions
Can Odoo generate the WPS Salary Information File?
Yes. Odoo Payroll with UAE localisation can produce the salary file your bank or exchange house needs, based on the approved payslips.
Is Odoo Payroll available in Community?
No. Payroll is an Odoo Enterprise app. Community users need a third-party or custom payroll module.
Can Odoo calculate end-of-service gratuity?
Yes. Gratuity can be calculated from basic salary and service period, and a monthly provision can be posted to accounting.
Do free zone companies need WPS?
It depends on the free zone. Many free zones have their own payroll rules, so check with your free zone authority. Odoo Payroll works either way.
Can Odoo handle payroll for several companies?
Yes. Each company can have its own employees, salary structures, bank file and accounting, managed in one Odoo database.


