Quick facts
- Price
- $299.00 USD
- Odoo versions
- 17, 18, 19
- Setup time
- 20160 min
- License
- One-time perpetual
- Languages
- 11 languages
One-time Purchase
Nigeria Payroll (PAYE, Pension, NHF)
Build-to-order Odoo Nigeria payroll localization: PAYE, pension, NHF, NSITF & ITF in NGN. ECOSIRE builds, installs and supports it.
$299.00USD
No payment now. This sends a quote request to our team — we'll follow up by email with pricing and next steps.
Key Features
PAYE progressive tax computed across the statutory income bands as Odoo salary rules, with the consolidated relief allowance (CRA) applied before taxable income is derived
Employee and employer pension contributions calculated on the pensionable base, posted as separate deduction and employer-cost lines on the payslip
National Housing Fund (NHF) deduction computed on basic salary with configurable eligibility per employee or contract
NSITF and ITF employer levy handling, modelled as employer-side contributions that never reduce employee net pay but feed cost reporting
NGN salary structures and structure types with reusable Nigeria salary categories (basic, housing, transport, allowances) so contracts assemble from standard building blocks
New fields added to hr.employee and hr.contract via models.Model — TIN, pension PIN, NHF number, pension administrator (PFA) — with @api.depends compute for taxable and pensionable bases
Statutory schedules and remittance summaries rendered as QWeb reports (PAYE schedule, pension schedule, NHF schedule) ready for FIRS/PenCom/FMBN submission
Per-employee and per-run payslips as branded QWeb PDF, showing gross, each statutory deduction, and net pay in NGN with correct rounding
Security enforced with ir.model.access.csv plus record rules so payroll officers see only their company's employees under Odoo multi-company
Automated actions for recurring payroll tasks — scheduled payslip email dispatch and monthly remittance-schedule generation
Accounting integration that posts payroll journals to your NGN chart of accounts, keeping salary, PAYE, pension and NHF liabilities cleanly separated
Configurable rule parameters (band thresholds, rates, contribution percentages) exposed as data records so Finance Act or PenCom rate changes are updated without code edits
XML-RPC / JSON-RPC compatible — payroll figures are standard Odoo records, so external HR portals or reporting tools can read and write them
Full parallel-run validation harness: we reproduce your most recent payroll inside Odoo and reconcile line-by-line before go-live
Built cleanly for Odoo 17, 18 and 19 on Community or Enterprise, with an upgrade path so you are not locked to one version
About this Product
Odoo core HR Payroll ships no Nigerian salary rules — no PAYE bands, no consolidated relief allowance, no pension or NHF logic. Teams end up running payroll in spreadsheets alongside Odoo, or paying for a generic apps.odoo.com module that doesn't match Finance Act treatment or FIRS/PenCom expectations.
Why Choose Nigeria Payroll (PAYE, Pension, NHF)
PAYE progressive tax computed across the statutory income bands as Odoo salary rules, with the consolidated relief allowance (CRA) applied before taxable income is derived
Employee and employer pension contributions calculated on the pensionable base, posted as separate deduction and employer-cost lines on the payslip
National Housing Fund (NHF) deduction computed on basic salary with configurable eligibility per employee or contract
NSITF and ITF employer levy handling, modelled as employer-side contributions that never reduce employee net pay but feed cost reporting
NGN salary structures and structure types with reusable Nigeria salary categories (basic, housing, transport, allowances) so contracts assemble from standard building blocks
New fields added to hr.employee and hr.contract via models.Model — TIN, pension PIN, NHF number, pension administrator (PFA) — with @api.depends compute for taxable and pensionable bases
Nigeria Payroll (PAYE, Pension, NHF) is a build-to-order Odoo localization that ECOSIRE designs, builds, installs and supports specifically for your company. This is not an instant download — after purchase our Odoo engineers scope your exact salary components, entities and reporting needs, then deliver a production-ready module for Odoo 17, 18 or 19 (Community or Enterprise) within a typical 2–4 week lead time.
The module extends hr.payroll with NGN salary structures and Nigeria-specific rules encoded as Odoo salary rules and Python compute logic: PAYE progressive tax across the statutory bands, the consolidated relief allowance, employee and employer pension contributions, National Housing Fund (NHF) deductions, and handling for NSITF and ITF employer levies. Every rule is a real Odoo object — new fields on hr.employee/hr.contract via models.Model, computed amounts using @api.depends, access controlled through ir.model.access.csv and record rules, and results rendered on QWeb payslip reports and statutory schedules.
Because it is built for your books, the numbers reconcile with your chart of accounts, your pay frequency and your reporting entities. We ground the build in your real data, validate a full parallel run against your last payroll, and hand over documentation, training and a support window. Where you need automation — monthly remittance schedules, payslip email dispatch, or pushing net-pay journals — we wire Odoo automated actions and (optionally) XML-RPC/JSON-RPC endpoints so the payroll talks to the rest of your stack.
What you get
- Production-ready Odoo module (custom addon) with a proper __manifest__.py, models, views, security and QWeb reports, delivered to a Git repository you own
- Configured NGN salary structures, salary rules and rule parameters mapped to your actual pay components and entities
- Security configuration: ir.model.access.csv and record rules scoped to your payroll roles and multi-company setup
- QWeb payslip and statutory schedule templates (PAYE, pension, NHF) branded for your organization
- A documented, reconciled parallel-run report comparing Odoo output against your last live payroll run
- Administrator and payroll-officer documentation plus a recorded/live training session for your HR team
- Deployment and installation on your Odoo instance (self-hosted, Odoo.sh, or ECOSIRE-managed hosting), with go-live support
- A post-delivery support window for fixes, questions and statutory rate adjustments, with terms agreed at scoping
Who this is for
Payroll Officer at a Nigerian SME
Runs monthly payroll and needs PAYE, pension and NHF to compute correctly inside Odoo instead of maintaining a fragile parallel spreadsheet. Wants payslips, deductions and net pay to reconcile every month without manual recalculation.
HR Manager scaling headcount
Manages growing staff across roles and allowances and needs standardized NGN salary structures, clean role-based access, and reliable statutory schedules to hand to Finance and to regulators on time.
Finance Controller / Accountant
Owns the numbers and cares that PAYE, pension, NHF, NSITF and ITF post as distinct liabilities to the NGN chart of accounts, reconcile to bank remittances, and survive audit — with clear reporting rather than opaque black-box calculations.
Installation overview
Download from ECOSIRE
Buy the license on ecosire.com and download the Nigeria Payroll (PAYE, Pension, NHF) module ZIP from your account dashboard.
Upload to Odoo
Extract the ZIP into your Odoo custom addons folder on the server (or upload via Apps > Install from file on Odoo.sh / runbot).
Install the module
Activate Developer Mode, open Apps, click Update Apps List, search for Nigeria Payroll (PAYE, Pension, NHF), and press Install.
Configure settings
Open the new menu, paste your ECOSIRE license key, connect any external credentials (Shopify, Amazon, Stripe, etc.), and save.
Verify & go live
Run the built-in connection test, sync your first 10 records, and schedule the recurring cron. Contact support if anything fails.
How Nigeria Payroll (PAYE, Pension, NHF) Compares
| Criterion | ECOSIRE | Custom Build | Competitor | Odoo Native |
|---|---|---|---|---|
| Nigeria PAYE, pension & NHF rules out of the box | Built to Nigerian statutory rules and your pay components | Only if you build every rule yourself | Sometimes, but often generic or outdated | |
| Fits your exact salary structures & entities | Scoped and configured to your real data | Yes, but you carry all the design work | Rarely — you adapt to the module's assumptions | |
| Parallel-run reconciliation before go-live | Included — line-by-line against your last payroll | Only if you plan and run it yourself | Not provided; you validate alone | |
| Statutory QWeb reports (PAYE / pension / NHF) | Delivered as branded QWeb templates | Must be designed and built from scratch | Partial or generic layouts | |
| Updates for rate / Finance Act changes | Editable rule parameters + support window | You maintain it yourself indefinitely | Depends on vendor's release cadence | |
| Code ownership & Odoo 17/18/19 support | You own the addon; built for your version & edition | You own it; version support is on you | Vendor-licensed; upgrade timing not yours | |
| Named support & training for your team | Docs, live training and a post-go-live window | Internal knowledge only | Ticket-based, generic support |
Frequently Asked Questions about Nigeria Payroll (PAYE, Pension, NHF)
+How long until the module is delivered, and is this an instant download?
This is a build-to-order module, not an instant apps.odoo.com download. After purchase, ECOSIRE scopes your salary components, entities and reporting needs, then builds, tests and installs the module. Typical lead time is 2–4 weeks depending on complexity, the number of pay components and how many entities are in scope. You get a confirmed timeline at the end of the scoping call.
+What support and updates are included after delivery?
Delivery includes a post-go-live support window (agreed during scoping) covering bug fixes, configuration questions and help during your first live payroll runs. Because statutory rates and thresholds (PAYE bands, pension and NHF rates, Finance Act changes) evolve, rule parameters are exposed as data records so most rate changes are configuration, not code. We also offer ongoing support and update retainers for teams that want ECOSIRE to maintain the module across Odoo version upgrades.
+Which Odoo versions and editions does this support?
We build for Odoo 17, 18 and 19, on both Community and Enterprise. We confirm your exact version and edition at scoping and deliver a module aligned to it, with a documented upgrade path so a future Odoo version bump does not strand your payroll.
+Will the calculations actually match my current payroll?
Yes — that is the point of the parallel run. Before go-live we reproduce your most recent payroll inside Odoo and reconcile it line-by-line against your existing figures. We resolve any differences (rounding, relief treatment, allowance handling) with you until the numbers agree, so you switch over with confidence rather than hope.
+How is PAYE, pension and NHF actually computed inside Odoo?
Each is a real Odoo salary rule with Python compute logic. PAYE applies the consolidated relief allowance and then the progressive tax bands to derive tax; pension is calculated on the pensionable base as separate employee and employer lines; NHF is computed on basic salary. Employer levies like NSITF and ITF are modelled as employer-side costs that do not reduce net pay. Band thresholds and rates live in editable rule parameters so they can be updated as regulations change.
+Can it handle multiple companies, allowances and integrate with accounting?
Yes. Salary structures are built from reusable NGN salary categories so different roles and allowance packages assemble cleanly, record rules enforce per-company visibility under Odoo multi-company, and payroll journals post to your NGN chart of accounts with PAYE, pension and NHF kept as distinct liabilities. Since everything is standard Odoo data, it is also reachable via XML-RPC/JSON-RPC for external tools.
+Do we own the code, and can we customize it later?
You own the module — it is delivered to a Git repository under your control as a standard Odoo addon with a documented __manifest__.py, models, views and security files. Your own developers, or ECOSIRE, can extend it later. Nothing is obfuscated or license-locked to us.
Why Customers Trust ECOSIRE
SOC 2 Aligned
GDPR Compliant
Secure Stripe Payment
30-Day Money Back
Lifetime Updates
LGPL-3.0 License
Related Modules
Request a quote
Nigeria Payroll (PAYE, Pension, NHF)
Build-to-order Odoo Nigeria payroll localization: PAYE, pension, NHF, NSITF & ITF in NGN. ECOSIRE builds, installs and supports it.
- PAYE progressive tax computed across the statutory income bands as Odoo salary rules, with the consolidated relief allowance (CRA) applied before taxable income is derived
- Employee and employer pension contributions calculated on the pensionable base, posted as separate deduction and employer-cost lines on the payslip
- National Housing Fund (NHF) deduction computed on basic salary with configurable eligibility per employee or contract
- NSITF and ITF employer levy handling, modelled as employer-side contributions that never reduce employee net pay but feed cost reporting