| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Discuss (mail)
• Employees (hr) |
| Lines of code | 828 |
| Technical Name |
l10n_zm_payroll |
| 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) |
| Lines of code | 828 |
| Technical Name |
l10n_zm_payroll |
| License | OPL-1 |
| Website | https://gencbaris.com/odoo_plugins/ |
| Versions | 18.0 19.0 |
Zambia Payroll for Odoo
PAYE bands, NAPSA, NHIMA and the Skills Development Levy — computed per employee
Run statutory Zambian payroll directly in Odoo. This module computes PAYE, NAPSA pension, NHIMA health insurance and the Skills Development Levy for each employee, produces a payroll register (CSV and Excel) and a statutory remittance summary split by collecting agency (ZRA, NAPSA, NHIMA). It is built on the Human Resources app and carries its own payslip and computation models, so it needs no Enterprise payroll. Compatible with Odoo 18 and Odoo 19, Community and Enterprise.
PAYE on editable ZRA bands
Monthly Pay As You Earn on the progressive ZRA 2026 bands (0% up to ZMW 5,100, then 25% / 30% / 37.5%). The first band is the tax-free threshold, and PAYE is charged on taxable pay after the allowable NAPSA pension deduction. The band scale is a fully editable model, so you adjust it whenever the annual Budget changes the rates.
NAPSA pension
National Pension Scheme Authority contributions at 5% employee + 5% employer, capped at the 2026 insurable-earnings ceiling of ZMW 37,236 per month (maximum ZMW 1,861.80 each side). Employees outside the mandatory scheme can be flagged exempt. The employee NAPSA contribution reduces taxable pay for PAYE.
NHIMA health insurance
National Health Insurance contributions at 1% employee + 1% employer of gross monthly earnings, remitted by the employer to NHIMA. NHIMA is not deductible for PAYE and is taken from net pay.
Skills Development Levy
The employer-only Skills Development Levy at 0.5% of gross emoluments is computed per employee and included in the employer cost and the ZRA remittance line, so your total cost-to-company is always accurate.
Payroll run & register
Create a monthly payroll run, populate it from every employee with a gross salary, and compute NAPSA, NHIMA, PAYE, SDL and net pay per employee with run totals. Export the full payroll register to CSV or Excel for your records and bank file preparation.
Statutory remittance summary
A one-click wizard totals PAYE and SDL to ZRA, NAPSA contributions and NHIMA contributions for a run, split by collecting agency, so you know exactly what to remit to each authority every month.
Editable, transparent, and yours to file
Every rate, ceiling and band carries the current Zambian statutory default and is fully editable from the company configuration and the PAYE band model — nothing is hard-coded. The computation engine is pure Python and unit tested. The module produces the statutory figures and the register/summary files; you file them through the ZRA TaxOnline portal, NAPSA and NHIMA with your own credentials. No employee data leaves Odoo and we host nothing on your behalf.
Disclaimer: rates, bands and ceilings reflect the 2026 charge year; confirm them against the latest official ZRA, NAPSA and NHIMA guidance before running live payroll.
Support
Questions or a localization update? Email odoo@gencbaris.com or visit gencbaris.com/odoo_plugins.
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