Payroll Africa — Statutory Payroll Automation for ERPNext
Statutory payroll deductions for 11 African countries
The open-source alternative to cloud payroll platforms -- you fully own your data. Automates PAYE, social security, health insurance, and housing levy calculations for Kenya, Uganda, Tanzania, Rwanda, Burundi, Zambia, Malawi, DRC, Nigeria, Mozambique, and Angola. No per-employee fees, no vendor lock-in. 33 compliance reports ready for tax authority filing.
What's inside
PAYE Tax Calculation
Progressive tax band calculation for all 11 countries. Kenya KRA bands, Uganda URA, Tanzania TRA, Rwanda RRA, and more. Personal relief and insurance relief applied automatically.
Social Security Deductions
NSSF Tier I and II (Kenya), NAPSA (Zambia), INSS (DRC, Mozambique, Angola, Burundi), Pension (Rwanda, Malawi, Nigeria). Employer and employee contributions calculated separately.
Health Insurance & Housing
SHIF (Kenya), NHIMA (Zambia), NHIS (Nigeria), CBHI (Rwanda), Housing Levy (Kenya), NHF (Nigeria). Country-specific rates, tiers, caps, and minimums enforced automatically.
33 Compliance Reports
P9A Tax Deduction Card, P10 Monthly Return, NSSF/SHIF/Housing Levy remittances (Kenya). URA, TRA, RRA, OBR, ZRA returns. PenCom, NHIS, NHF reports for Nigeria. Ready for filing.
Multi-Country Deployment
Enable countries individually. Per-employee country override via custom field. Different statutory rates, tax bands, and salary components per country. Multi-currency salary support.
Open Source & Extensible
GPL-3.0 licensed. Calculator-based architecture makes adding new countries straightforward. REST API for standalone deduction calculations. Hooks into ERPNext HRMS Salary Slip validation.
Coale-POS
Coale-Hoteli
Coale-Payments
How businesses use Payroll Africa
Retail Chain eTIMS Compliance
Multi-branch retail chains in Kenya use Payroll Africa to ensure every sales invoice across all locations is submitted to KRA in real time. Branch-level device initialization means each outlet operates independently while headquarters maintains a consolidated compliance view.
- • Per-branch TIS device setup and management
- • Automatic invoice submission on every sale
- • Centralized compliance dashboard for all outlets
Manufacturer Social Security Deductions
Kenyan manufacturers with hundreds of SKUs rely on Payroll Africa to map complex product lines to eTIMS classification codes. Once items are classified, tax info auto-fills on every invoice -- eliminating manual code lookup and data entry errors.
- • Bulk eTIMS code mapping for large item catalogues
- • Unit and packing unit management
- • Automatic tax rate assignment per classification
Import Company Compliance
Companies importing goods into Kenya use the purchase order tracking module to register suppliers with KRA, manage import documentation, and report stock receipts -- keeping both customs and eTIMS requirements in sync.
- • Supplier registration with KRA
- • Import item and insurance record management
- • Stock movement reporting on goods receipt
Professional Services Firm
Law firms, consultancies, and accounting practices use Payroll Africa to submit service invoices to eTIMS and validate payment compliance before processing client receipts -- avoiding penalties from KRA.
- • Service invoice eTIMS submission
- • Pre-payment compliance validation
- • Receipt number tracking per invoice
Works with the CoaleTech ecosystem
Connect with other products for a unified business platform.
Coale-Payments
Validate payroll compliance before processing M-Pesa payments, ensuring every transaction meets KRA requirements.
Coale-POS
Every POS sale is automatically submitted to eTIMS with the correct item classification and tax codes.
Coale-Audit
Audit tax compliance across the organization with automated checks against eTIMS submission records.
Coale-Insights
Analyze tax submission patterns, identify classification gaps, and generate compliance dashboards.
Frequently asked questions
What is eTIMS and why does my business need it?
eTIMS (electronic Tax Invoice Management System) is Kenya Revenue Authority's mandatory system for real-time tax invoice reporting. All VAT-registered businesses in Kenya must submit invoices electronically to KRA. Payroll Africa automates this directly from ERPNext so you stay compliant without manual data entry.
Does Payroll Africa automatically submit invoices to KRA?
Yes. When you submit a Sales Invoice or Purchase Invoice in ERPNext, Payroll Africa automatically sends it to the KRA eTIMS API in real time. You receive a confirmation receipt number that is stored on the invoice for your records.
How does item classification work with eTIMS codes?
Payroll Africa maps your ERPNext items to official KRA eTIMS classification codes. Once mapped, tax information is auto-filled on every new invoice. The system supports unit management, packing units, and complex item hierarchies.
Can Payroll Africa handle stock movement reporting to KRA?
Yes. Stock entries in ERPNext are automatically reported to eTIMS, and bin quantities are synchronized. This covers material receipts, transfers, and adjustments -- all reported in real time.
Is Payroll Africa suitable for importing companies?
Absolutely. The purchase order tracking module handles import item management, branch information, insurance records, and supplier registration with KRA. This is essential for companies importing goods into Kenya.
Ready to get started with Payroll Africa?
Stay compliant with KRA eTIMS requirements without lifting a finger. Automatic invoice submission, item classification, and stock reporting -- built into your ERPNext workflow.