| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Discuss (mail)
• Employees (hr) |
| Lines of code | 1075 |
| Technical Name |
l10n_ke_statutory_returns |
| 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 | 1075 |
| Technical Name |
l10n_ke_statutory_returns |
| License | OPL-1 |
| Website | https://gencbaris.com/odoo_plugins/ |
| Versions | 18.0 19.0 |
Kenya Statutory Returns for Odoo
NSSF, SHIF and Affordable Housing Levy monthly return files — ready for portal upload
Turn your monthly payroll figures into the exact upload files that the NSSF self-service portal, the SHA / SHIF portal and the KRA iTax Affordable Housing Levy return expect. Enter or carry forward your members, click Generate, and download three ready-to-upload byproduct files with every contribution computed to the current statutory rates. Built on the Human Resources app with no Enterprise dependency. Compatible with Odoo 18 and Odoo 19, Community and Enterprise.
NSSF Tier I & Tier II file
Two-tier NSSF contributions under the NSSF Act 2013 with the Year-4 earnings limits effective 1 February 2026 (Lower KES 9,000, Upper KES 108,000) at 6% employee + 6% employer per tier. The byproduct file carries each member's payroll number, ID type and number, KRA PIN, surname, other names, gross pay and the Tier I / Tier II split, with a contracted-out Tier II option per member.
SHIF / SHA return file
Social Health Insurance Fund contribution at 2.75% of gross with the KES 300 monthly floor, replacing the former NHIF. The SHA byproduct file lists each member's SHA or National ID, KRA PIN, name, gross pay and the computed contribution, ready for the SHA employer portal.
Affordable Housing Levy file
The KRA iTax Affordable Housing Levy byproduct lists each employee's PIN, name, ID number, gross pay and the 1.5% employee + 1.5% employer levy, with a total levy column and a summary row, matching the iTax AHL return layout.
Identifier validation
KRA PINs are validated against the official format (A or P, nine digits, a check letter — e.g. A001234567Z) and National ID / passport numbers are format-checked, so malformed identifiers are caught before a return file is generated and rejected by the portal.
One return, three files, every month
Add your company employees in one click, or carry the previous month's member list and identifiers forward and just update gross pay. Compute every contribution and review the NSSF, SHIF and Housing Levy totals on a single screen, then generate all three files (or only the one you need) and mark the return filed once uploaded. Editable statutory rates and limits on the company let you adjust as each Finance Act and NSSF schedule advances.
| Return | Basis | Rate | Output |
|---|---|---|---|
| NSSF | Pensionable pay, Tier I / Tier II | 6% + 6% per tier | NSSF byproduct CSV |
| SHIF | Gross pay (KES 300 floor) | 2.75% employee | SHA byproduct CSV |
| Housing Levy | Gross pay | 1.5% + 1.5% | iTax AHL byproduct CSV |
Disclosure: this module computes statutory contributions locally and produces the NSSF, SHIF and Housing Levy upload files; you file them through the NSSF, SHA and KRA iTax portals with your own credentials. No employee data leaves Odoo and the module is not a certified portal integrator. All rates and limits carry the current statutory defaults (including the 1 February 2026 NSSF caps); confirm them against the latest official NSSF, SHA and KRA guidance before filing.
Screenshots
Statutory Returns
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