Odoo Payroll South Africa: PAYE, UIF, SDL and EMP201 in Odoo 19/20
Odoo payroll for South Africa in Odoo 19 and 20: what Odoo ships, which modules add PAYE, UIF, SDL and EMP201, and how IRP5 and EMP501 reach e@syFile.
Searching "Odoo payroll South Africa" turns up marketing pages that promise automatic PAYE but never name the module behind it. This guide names what exists, what is missing, and when our Odoo customization services need to fill the gap with a local module.
Related service: Odoo implementation services — HR, payroll and attendance configured for your local rules.
It is for South African finance managers, payroll officers and IT leads on Odoo 19 or 20. For the general setup order, see our Odoo payroll setup guide for HR, attendance and localization. This is not tax advice: confirm rates with SARS or your tax practitioner.
Does Odoo have a South Africa payroll localization?
No, Odoo's official payroll localization list for 19.0 and 20.0 does not include South Africa. That means no ready salary structure for PAYE, UIF or SDL from Odoo itself.
Odoo's payroll localizations page for Odoo 20 lists 25 countries, including Kenya, Egypt, Morocco and the UAE in Africa and the Middle East. South Africa is not on it, and it was not on the Odoo 19 list either.
We also found no l10n_za_hr_payroll module in Odoo's published documentation or Apps Store for 17.0 to 19.0. Odoo's Enterprise source code is not public, so open Payroll settings and click "Choose a Payroll Localization" in your own database to confirm.
What Odoo does ship is l10n_za, "South Africa - Accounting". Its manifest describes "a generic chart of accounts" and a "SARS VAT Ready Structure", and it is listed under South Africa on Odoo's fiscal localizations page.
What does Odoo cover for South African payroll out of the box?
Out of the box, Odoo gives you the payroll engine and South African accounting, but no South African tax rules. The table shows where each part comes from.
| Payroll need | Standard Odoo 19/20 | Gap to fill |
|---|---|---|
| Employees, contracts, wages | Employees and Payroll apps | None |
| Salary structures and rules | Generic engine with Python rules | South African rules not supplied |
| PAYE on SARS tax tables | Not included | Module or custom rules |
| UIF 1% plus 1%, capped | Not included | Module or custom rules |
| SDL 1% employer levy | Not included | Module or custom rules |
| EMP201 monthly figures | Not included | Report or module |
| IRP5, IT3(a), EMP501 | Not included | e@syFile export or manual capture |
| Chart of accounts and VAT | l10n_za | None |
So the real question is not whether Odoo can run South African payroll. It can calculate almost anything. The question is who writes and maintains the South African rules every tax year.
What are the 2027 tax year PAYE, UIF and SDL rates?
For the 2027 tax year (1 March 2026 to 28 February 2027), SARS lists seven PAYE brackets from 18% to 45%, UIF at 1% plus 1% up to R17,712 a month, and SDL at 1%. Load these into Odoo as rule parameters, not hard-coded numbers.
| Item (2027 tax year) | SARS figure |
|---|---|
| First PAYE bracket | 18% of taxable income up to R245,100 |
| Top PAYE bracket | 45% above R1,878,600 |
| Primary rebate | R17,820 |
| Secondary rebate (65 and older) | R9,765 |
| Tertiary rebate (75 and older) | R3,249 |
| Tax threshold under 65 | R99,000 |
| UIF | 1% employee plus 1% employer, ceiling R17,712 a month |
| SDL | 1% of leviable pay, if annual payroll will exceed R500,000 |
For the UIF calculation, apply 1% to pay up to the ceiling; for the SDL calculation, apply 1% to all leviable pay. SARS says both are paid with the EMP201 within seven days after month end, or the last business day before a weekend or public holiday.
An illustrative PAYE check for an employee under 65 earning R300,000 a year, with no medical credits or retirement deductions: R44,118 plus 26% of R54,900 is R58,392, less the R17,820 rebate, so R40,572 a year or about R3,381 a month. Use a case like this as a test payslip.
Which South Africa payroll modules exist for Odoo 19 and 20?

Three paid Odoo Apps Store listings cover most of the gap for Odoo 19, each with a different scope and dependency. None of them is made by Odoo, so review the code and the vendor before you buy.
| Module (Odoo 19 listing) | Vendor and listed price | Depends on | What it covers |
|---|---|---|---|
| za_hr_payroll | Prys Accounting, US$198.94 | Enterprise Payroll | PAYE, UIF, SDL, ETI, EMP201, EMP501, e@syFile CSV |
| l10n_za_payroll | Pokutsoft, US$88.10 | Employees app only | PAYE, UIF, SDL, ETI, EMP201 CSV, EMP501 |
| l10n_za_emp201 | Pokutsoft, US$167.28 | l10n_za_payroll | Tracked EMP201 declaration, reference checks |
| Your own salary rules | Built in-house or by a partner | Enterprise Payroll | Whatever you define and maintain |
Prices are the Apps Store listing prices on 21 November 2026 and can change. The Prys listing says it "requires Odoo Enterprise Edition" and lists the 2026/27 tax brackets. The Pokutsoft listing says it is built on the Employees app with "no Enterprise dependency".
The Pokutsoft EMP201 listing is clear about one limit: you file "through SARS eFiling / e@syFile with your own credentials", and the module "does not transmit anything to SARS". Plan your process around that, whichever module you pick.
How do you set up PAYE, UIF and SDL rules in Odoo?
You set up South African payroll in Odoo by creating a salary structure whose rules calculate taxable pay, PAYE, UIF and SDL in a fixed order. A module does this for you; with custom rules, follow these steps.
- Install the base: Employees, Payroll and Accounting with the l10n_za chart of accounts.
- Create a structure type: for example "South Africa monthly", with a monthly schedule and your working calendar.
- Store rates as parameters: brackets, rebates, thresholds, the UIF ceiling and the SDL rate, each dated to the tax year, so next year means new values, not new code.
- Order the rules: gross pay, taxable pay, annualized PAYE less rebates, UIF on pay up to the ceiling, then employer UIF and SDL.
- Map rules to accounts: PAYE, UIF and SDL liabilities each post to their own account so the EMP201 ties to the ledger.
- Add employee fields: tax number, date of birth for age rebates, and UIF status for people working under 24 hours a month.
- Test with known payslips: compare a full month against your current payroll for each employee type before going further.
Our overview of the Odoo Payroll app shows the payslip workflow, batches and accounting entries it handles. The South African part is the rules and parameters you add on top.
How do you produce the EMP201 from Odoo?
Odoo can produce the EMP201 totals from your validated payslips, but you still capture and submit the declaration on SARS eFiling. The goal is that the Odoo figures and the SARS form match to the cent.
SARS's EMP201 guide lists the fields: PAYE, SDL and UIF liabilities, then ETI brought forward, calculated, utilised and carried forward, then the total payable. Your Odoo report or module should show the same blocks, per company and per tax period.
- One period, one report: lock the month's payslips before you run the EMP201 totals.
- ETI carry forward: track it per period; SARS says the brought-forward ETI for periods 03 and 09 must be zero.
- Payment reference: SARS issues the payment reference number with the EMP201, so record it against the payment in Odoo.
- Reconcile: match the bank payment to the PAYE, UIF and SDL liability accounts each month.
If you run several South African entities in one database, each needs its own PAYE, UIF and SDL reference numbers and its own EMP201. Our Odoo localization gaps guide explains how to handle multi-country groups.
How do IRP5 and EMP501 work with e@syFile?
The EMP501 reconciliation and IRP5 or IT3(a) certificates go to SARS through eFiling or e@syFile Employer, so Odoo needs to produce a clean import file or a reconciliation report. This is where most local module work sits.
SARS opened the 2026 interim EMP501 season on 21 September 2026, covering 1 March to 31 August 2026, and closed it on 31 October 2026. The 2026 annual season ran from 1 April to 31 May 2026. Check SARS for the 2027 annual dates.
e@syFile Employer imports employee certificate data as a CSV built on SARS source codes, such as income code 3601. The Prys listing says its module exports e@syFile CSV files with source-code tags. With custom rules, map each Odoo salary rule to a source code and build the export.
Keep e@syFile current. SARS said moving from e@syFile Employer 8.0.1 to 8.0.2 needs a full uninstall and reinstall, and its 2026 notes added new source codes and changed validations, including code 4118 for ETI totals. Retest your export after every SARS release.
Build, buy or outsource: which path fits?
Buy a tested module for standard monthly payroll, build custom rules when your pay structures are unusual, and outsource payroll when headcount is small or rules change faster than you can test. Each path has a clear trade-off.
- Buy a module: fastest start; you depend on the vendor updating tax tables each March and following Odoo upgrades.
- Build custom rules: full control and no vendor lock-in, but you own the yearly rate changes and the e@syFile mapping.
- Outsource payroll: a local payroll bureau runs PAYE and SARS filing, and Odoo receives one journal entry per pay run.
- Hybrid: a module for PAYE, UIF and SDL, plus custom code for allowances, fringe benefits or bargaining council rules.
Whichever path you pick, run two to three months in parallel with your current payroll before you switch. Our Odoo US payroll guide shows the same parallel-run approach in a country Odoo does support.
South African payroll in Odoo by industry
The rules for PAYE, UIF and SDL are the same everywhere, but each industry adds its own pay items that a generic module may not handle. Map these before you choose a module.
| Industry | Pain or cost driver | Odoo approach | How iVentureTeam helps |
|---|---|---|---|
| Retail | Weekly and hourly staff, shift premiums | Attendance feeding hourly salary rules | Build shift and overtime rules |
| Manufacturing | Overtime, shift allowances, many sites | Work schedules per site, one structure | Map allowances, test PAYE impact |
| Security and staffing | Large headcount, high turnover | Batch payslips, contract templates | Speed up onboarding and termination pay |
| Professional services | Bonuses, commissions, travel allowances | Variable inputs on payslips | Add allowance rules and reports |
| Hospitality | Part-time staff near the UIF 24-hour rule | UIF status field per employee | Flag UIF exemptions automatically |
What does Odoo payroll for South Africa cost?
The cost is your Odoo subscription, the module or development, and the setup and testing time. Hosting matters, because third-party modules rule out Odoo Online.
Payroll is an Enterprise app, priced per user on the Odoo pricing page. Odoo's own Odoo Online documentation says Odoo Online is incompatible with custom modules and Odoo Apps Store modules, so a South African payroll module means Odoo.sh or on-premise.
Our guide on how to install third-party modules on Odoo.sh, on-premise and Online covers the steps. Our published Odoo project ranges are $3k to $9k for small, $9k to $27k for mid-size and $27k to $150k+ for large projects.
Payroll for one South African company is usually a slice of a wider project, not a project on its own. For a quick figure based on your apps and users, try the Odoo project estimate tool.
How iVentureTeam helps with Odoo payroll in South Africa

iVentureTeam sets up Odoo payroll for South Africa by testing the module that fits, or building the local rules, then proving every figure against your current payroll. We have delivered 150+ ERP projects across 35+ countries with 40+ Odoo specialists, led by a consultant with 13+ years in Odoo.
- Fit check: your pay items, headcount and entities compared against the available modules and custom rules.
- Module review: code review, upgrade risk and tax-table update terms before you buy.
- Local module build: PAYE, UIF, SDL, ETI and e@syFile export rules through our Odoo implementation services.
- Parallel runs: two to three months of payslips matched line by line with your current payroll.
- Yearly care: new SARS rates loaded and tested each March, plus e@syFile export checks before each EMP501 season.
Odoo payroll South Africa case study: Fernando Tax Management
This was not a payroll or South African project; it is our closest fit because it shows how we build localized compliance reports as custom Odoo work. Fernando Tax Management B.V. is a Dutch tax and accounting firm.
The firm had outgrown a rigid legacy system. Manual entry across systems produced duplicate records, and reports came out with translation gaps, a real problem when the output feeds government compliance.
We migrated the firm to Odoo 18, built a cost tracking workflow into Sales and Purchase, and developed custom tax compliance reports for its Netherlands and Curaçao contexts. The project took 10 weeks and covered two jurisdictions.
The firm reports a 60% reduction in manual data entry. The same approach, local rules and reports built on standard Odoo, is what a South African payroll gap needs. Read the Fernando Tax Odoo accounting automation case study.
The bottom line on Odoo payroll for South Africa
Odoo can run South African payroll well, but Odoo itself does not supply the PAYE, UIF and SDL rules, so you choose a module, build the rules, or outsource. Plan for Odoo.sh or on-premise.
Pick the path that matches your pay complexity, load the 2027 tax year rates as dated parameters, and run parallel months before you file. Then keep the e@syFile export tested every SARS season.
Ready to set up South African payroll in Odoo?

Get a clear plan for PAYE, UIF, SDL and SARS filing in Odoo 19 or 20. Talk to us about your South African payroll setup, call +91-90235-15208, or email business@iventureteam.com.
Frequently Asked Questions
Does Odoo support South African payroll?
+
Not with an official localization. Odoo's 19.0 and 20.0 payroll localization lists do not include South Africa, so you add a third-party module, build salary rules, or use a local payroll provider and post journals to Odoo.
Is there an l10n_za_hr_payroll module in Odoo Enterprise?
+
We found none in Odoo's published documentation or Apps Store. Odoo ships l10n_za for accounting and VAT. Check "Choose a Payroll Localization" in your own Payroll settings to confirm for your version.
Can Odoo calculate PAYE, UIF and SDL?
+
Yes, with the right salary rules. A third-party module supplies them, or you build them with the SARS brackets, rebates, the UIF ceiling of R17,712 a month and the 1% SDL rate for the 2027 tax year.
Can Odoo submit the EMP201 to SARS?
+
No module we reviewed submits to SARS. Odoo or a module produces the EMP201 totals, and you capture and submit the declaration on SARS eFiling with your own credentials.
How do I get IRP5 certificates out of Odoo?
+
Map each salary rule to a SARS source code and export a CSV that e@syFile Employer can import, or use a module that does this. Then reconcile and submit the EMP501 through eFiling or e@syFile.
Can I use a South African payroll module on Odoo Online?
+
No. Odoo's documentation says Odoo Online is incompatible with custom modules and Odoo Apps Store modules. You need Odoo.sh or an on-premise install for third-party payroll modules.
Does Odoo Payroll need the Enterprise edition?
+
The Payroll app is part of Odoo Enterprise. One Apps Store module for South Africa states it needs only the Employees app, but most setups use Enterprise Payroll for payslips, batches and accounting entries.
How often do South African payroll rules in Odoo need updating?
+
At least once a year, as SARS tax tables change from 1 March. Also retest your e@syFile export when SARS releases a new e@syFile version or changes source codes.
Is this article tax advice?
+
No. It explains how Odoo handles South African payroll. Confirm rates, thresholds and filing dates with SARS or a registered tax practitioner before you run payroll.
Free payroll setup review
Setting up payroll in Odoo?
Tell us your headcount and pay rules. We set up salary rules, statutory files and leave in Odoo, and show what needs a custom module.
Free, with no obligation. A senior consultant replies within 12 business hours.
Free Odoo tools
All tools- Odoo Health CheckVersion, modules, findings and upgrade cost
- Odoo App SelectorWhich apps you need, by industry
- Odoo Project EstimateIndicative cost and timeline in minutes
- Odoo Implementation Cost CalculatorImplementation cost and timeline, in minutes
- Odoo Migration Cost CalculatorVersion jump or legacy ERP, priced in minutes
Continue reading
Odoo Payroll Setup: HR, Attendance and Localization in Odoo 19/20
Odoo payroll setup for Odoo 19 and 20: localizations by country, HR module, attendance, time off, pay runs, what changed in Odoo 20 and what it costs.
Odoo Employee Self Service Mobile App: Options, Build Paths, Cost
Odoo employee self service mobile app guide: leave, attendance, expenses and payslips on a phone, Light User cost, and build options on Odoo 19/20.
Odoo Pay Transparency: EU Directive Setup in Odoo 19 and 20 HR
Odoo pay transparency guide: what Odoo 19 and 20 HR, Payroll and Recruitment do natively for the EU Directive, and what needs a pay gap report or code.
