| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Discuss (mail)
• Employees (hr) |
| Community Apps Dependencies | Show |
| Lines of code | 3141 |
| Technical Name |
l10n_za_emp501_easyfile |
| License | OPL-1 |
| Website | https://gencbaris.com/odoo_plugins/ |
| Versions | 18.0 19.0 |
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Discuss (mail)
• Employees (hr) |
| Community Apps Dependencies | Show |
| Lines of code | 3141 |
| Technical Name |
l10n_za_emp501_easyfile |
| License | OPL-1 |
| Website | https://gencbaris.com/odoo_plugins/ |
| Versions | 18.0 19.0 |
South Africa EMP501 & e@syFile
SARS bi-annual EMP501 employer reconciliation with IRP5 / IT3(a) certificates exported as an e@syFile Employer import file
Produce the SARS EMP501 Employer Reconciliation Declaration and the IRP5 / IT3(a) employee tax certificates straight from your Odoo payroll, then export them as an e@syFile Employer import file. Builds on South Africa EMP201 — every amount tagged with its BRS source code.
Odoo 18 Odoo 19 South Africa SARS e@syFile
Stored EMP501 reconciliation
A tracked reconciliation record per company, transaction year and period (interim March–August, or annual March–February). It harvests the payroll runs in the SARS tax-year window, rebuilds each employee's annual certificate totals, sums the EMP201 PAYE declared and the payments made, and classifies the reconciliation as balanced, under-declared or under-paid.
IRP5 / IT3(a) certificates
Each employee gets a child certificate record tagged with the BRS source codes — income 3601, PAYE 4102, UIF 4141, SDL 4142, medical credit 4116, ETI 7004 and total deductions 4149. The IRP5-vs-IT3(a) nature is decided automatically by whether PAYE was deducted.
SA ID decode & validation
The 13-digit South African ID number is Luhn-validated and decoded into date of birth, gender and citizenship, so the demographic block of each certificate (source code 3060) is checked before the file is written.
ETV-style validation engine
A client-side reproduction of the deterministic Employment Taxes Validation checks: certificate number present, nature agrees with PAYE, total deductions equal PAYE + UIF + SDL, amounts non-negative, ID number valid, and the control totals reconcile within a configurable Rand tolerance. Blocking errors are separated from advisory warnings.
e@syFile import file
Certificates are rendered as the documented code,value
employer + certificate block structure, in CSV or pipe-tagged shape, with
the employer header (PAYE/SDL/UIF references derived from the PAYE number)
and the per-certificate demographics — ready for capture or verify
in e@syFile Employer.
One-click build & reminders
A build wizard creates, computes and opens a reconciliation in one click, a reconciliation report summarises the control totals, and an optional scheduled reminder nudges open reconciliations near the SARS window.
Built locally, filed by you
The pure-Python engine (SA ID decode, e@syFile builder, validation rules, tax-year window and reconciliation orchestration) is fully unit tested. The module computes and exports locally and is bring-your-own-key: you file the figures through SARS eFiling / e@syFile with your own credentials — no employee data leaves Odoo and nothing is transmitted to any third party.
Disclosure: this module builds reconciliation and certificate files; it does not transmit any data to SARS or any third party. The shipped BRS source codes and SARS reference algorithms carry the current statutory layout (v24-series PAYE BRS, 2025–2026); confirm them against the latest SARS guidance before filing.
Odoo Proprietary License v1.0 This software and associated files (the "Software") may only be used (executed, modified, executed after modifications) if you have purchased a valid license from the authors, typically via Odoo Apps, or if you have received a written agreement from the authors of the Software (see the COPYRIGHT file). You may develop Odoo modules that use the Software as a library (typically by depending on it, importing it and using its resources), but without copying any source code or material from the Software. You may distribute those modules under the license of your choice, provided that this license is compatible with the terms of the Odoo Proprietary License (For example: LGPL, MIT, or proprietary licenses similar to this one). It is forbidden to publish, distribute, sublicense, or sell copies of the Software or modified copies of the Software. The above copyright notice and this permission notice must be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Please log in to comment on this module