Skip to content

Chezhira/l10n-tanzania

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

12 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Tanzania Odoo Localization Suite

License: LGPL-3 Odoo 18 Odoo 19

Author: Zahidah Murira GitHub: https://github.com/Chezhira Contact: ziddmurira@gmail.com

The first open-source Tanzania localization suite for Odoo 18 & 19 — built by a Tanzanian finance professional with 20+ years of multi-entity, multi-currency experience across East Africa.


Modules in this Repository

l10n_tz — Tanzania Accounting Localization

The core fiscal localization for Tanzania, covering all TRA requirements.

What's included Detail
Chart of Accounts ~120 accounts, 8-digit codes, industry-specific (aquaculture, agri-processing, multi-entity, M-Pesa)
VAT 18% standard, zero-rated exports, exempt, claimable/non-claimable input
Withholding Tax 5% services, 10% rent/dividends/interest, 15% non-resident
Fiscal Positions Domestic VAT-registered, non-VAT, export, non-resident, NGO/government
Currency Tanzanian Shilling (TZS)

Full documentation


l10n_tz_asset_report — Fixed Asset Register Report

Tanzania-specific fixed asset register accessible from Accounting → Reporting → Fixed Asset Register (TZ).

What's included Detail
Cost schedule Opening B/F, additions, disposals, closing C/F per asset
Depreciation schedule Opening B/F, charge for period, on disposals, closing C/F
NBV Opening and closing per asset and category
TRA rates Allowable rates per ITA 2004 shown alongside IFRS useful life
Category subtotals Per asset class with grand total
PDF output Landscape format, audit-ready

Full documentation


l10n_tz_hr_payroll — Tanzania Payroll Localization

(Separate repository)

What's included Detail
PAYE Progressive 5-band scale per ITA 2004
NSSF Employee 10% + Employer 10% = 20% total
SDL 3.5% of gross — employer only (effective July 2023)
WCF Industry-specific rate per contract
HESLB 15% of basic salary — conditional on active loan
Loans & Advances hr.loan model with instalment recovery and auto-close
LWOP Automatic basic salary proration for unpaid leave
Termination pay Notice, leave encashment, severance (ELRA 2004 s.42)

l10n-tanzania-payroll repository


Statutory Rates Quick Reference

Statutory body Rate Remittance deadline
TRA — VAT 18% standard 20th of following month
TRA — PAYE Progressive 0–30% 7th of following month
TRA — SDL 3.5% of gross (employer) 7th of following month
TRA — WHT Services 5% resident / 15% non-resident 7th of following month
TRA — WHT Rent/Dividends/Interest 10% 7th of following month
NSSF 20% total (10% each) 30th of following month
WCF 0.5–2% by industry (employer) Per WCF schedule
HESLB 15% of basic salary Monthly

Rates verified against Finance Act 2023/2024. Verify annually.


Roadmap

Module Feature Status
l10n_tz Chart of Accounts, VAT, WHT, Fiscal Positions ✅ Complete
l10n_tz_asset_report PDF Asset Register with TRA rates ✅ Complete
l10n_tz_hr_payroll PAYE, NSSF, SDL, WCF, HESLB, Loans ✅ Complete
l10n_tz EFDMS/VFD integration 📋 Planned
l10n_tz TRA VAT return report 📋 Planned
l10n_tz_asset_report Excel export 📋 Planned
l10n_tz_asset_report Multi-company consolidated view 📋 Planned
l10n_tz_hr_payroll PAYE P9 annual report 📋 Planned
l10n_tz_hr_payroll NSSF/SDL monthly return reports 📋 Planned
l10n_tz_bank Bank statement importers (CRDB, NMB, NBC) 📋 Planned
All Odoo 20 support 📋 Sept 2026

Contributing

Contributions welcome from Tanzanian accountants, Odoo partners, and developers.

  1. Fork the repository
  2. Create a feature branch
  3. Submit a pull request referencing the relevant TRA publication or legislation

Legal Disclaimer

Statutory rates change with each Finance Act. Always verify current rates with TRA, NSSF, WCF, and HESLB before relying on this module for compliance.


License

LGPL-3.0

About

Tanzania Accounting Localization for Odoo 18

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages