Lesson 1 — Article 51, exactly as it is written
Start with the statute, because every field on the configuration screen is one of its parameters.
Who it covers, and who it does not. Article 51 grants end-of-service gratuity to a foreign worker employed full time. UAE nationals do not receive Article 51 gratuity. Their end-of-service entitlement comes from the federal pensions legislation administered by the General Pension and Social Security Authority (GPSSA), which is a contributory scheme rather than an accrued provision, so a UAE national does not belong in an Article 51 liability at all. Source: FDL 33/2021 Art. 51. MISSING FACT: the number and title of the federal pensions instrument under which UAE nationals take their end-of-service entitlement, and the contribution rates it sets.
The formula, in one sentence. A foreign full-time worker is entitled to 21 days' wage for each of the first five years of service and 30 days' wage for each year thereafter, calculated on the last basic wage, with the total capped at two years' wage, payable once the worker has completed one year of continuous service. Parts of a year are paid in proportion, and lawful amounts due may be deducted from the sum. Source: FDL 33/2021 Art. 51.
And then there is a deadline on paying it. All entitlements owed to the worker must be paid within 14 days of the end of the contract. That is what makes this a provisioning problem rather than a reporting one: the figure has to be right before the person leaves, not reconstructed in the following quarter. Source: FDL 33/2021 Art. 53.
In Odoone, those five numbers are configuration, pre-filled. Open Settings → Users & Companies → Companies, select your company, and look at the End of Service (UAE) section. The Article 51 parameters arrive with the statutory figures already in them, and the module guide's instruction is to change them only if you have advice that says otherwise.
| Field | Default | Statutory basis |
|---|---|---|
| Days per Year (First Band) | 21 | Art. 51(1)(a), the first five years |
| Days per Year (Later Band) | 30 | Art. 51(1)(b), thereafter |
| Band Boundary (Years) | 5 | Where the bands change |
| Cap (Years of Wage) | 2 | Art. 51(6) |
| Days per Month | 30 | The divisor turning a monthly wage into a daily rate |
The mental model. The gratuity is a defined benefit: what an employee is owed depends on total continuous service, not on a fixed amount per month. So the module computes what each employee has earned as at the end of the period and books only the difference against what earlier runs already provided. Every worked example in this course is an application of that one sentence.
The worked example. Rania joined on 1 March 2019. Her last basic wage is AED 12,000 a month, and her full package — basic plus housing, transport and other allowances — is AED 24,000. Take her entitlement as at 31 August 2026.
| Step | Figure |
|---|---|
| Continuous service at 31 August 2026 | 7 years and 6 months |
| The first five years at 21 days | 105 days |
| The remaining 2 years and 6 months at 30 days | 75 days |
| Total days of gratuity | 180 days |
| Last basic wage | AED 12,000 per month |
| Daily rate, basic divided by 30 | AED 400 |
| Gratuity under Article 51(1) | AED 72,000 |
| Cap: two years of the full package | AED 576,000 |
The cap is nowhere near binding, which is the normal case and the reason Lesson 3 exists — when the cap does bind on an ordinary employee, something is usually set wrong rather than genuinely at its limit.
One thing the module does for nationals. A third scheduled job, "GPSSA: monthly remittance reminder", ships switched off like the other two and books nothing at all. Once a month it looks at GPSSA contributions payable and, where a balance is outstanding, schedules an activity for that company's accounting managers, citing GPSSA's published collection window — the 1st to the 15th of the following month — and its 0.1% per day late charge. It is available only where the UAE payroll accounting module is installed, since that is what says where GPSSA contributions sit.
The failure mode. Budgeting gratuity as a flat percentage of payroll. It is not a percentage of anything: it is a function of each person's service band and last basic wage, and it moves in steps when someone crosses five years and in jumps when someone gets a raise. A company that accrues a smooth monthly percentage will be wrong in both directions and will discover it in the month a long-serving employee resigns, with 14 days to find the difference.