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
Update date: 2026-07-02