nightman19/odoo-ghana-localization

Odoo 19 module for Ghana payroll - PAYE & SSNIT calculations (2025 tax rates) # Odoo Ghana Localization Complete payroll localization module for Odoo 19 Community Edition, implementing Ghana's 2025 tax regulations. ## Features ✅ **2025 PAYE Tax Calculation** - 6-tier progressive tax brackets (0% - 30%) - Automatic tax computation based on gross income - Compliant with Ghana Revenue Authority regulations ✅ **SSNIT Contributions** - Employee contribution: 5.5% - Employer contribution: 13% - Automatic ceiling enforcement (GHS 61,000 annual maximum) - Tier 1 and Tier 2 breakdown ✅ **Automatic Salary Computations** - Gross salary calculation - Net salary calculation - Real-time updates as salary components change ✅ **Custom Employee Fields** - Basic Salary - Transport Allowance - Housing Allowance - Monthly deductions breakdown ## Installation ### Prerequisites - Odoo 19.0 Community Edition - PostgreSQL - Python 3.8+ ### Install Module 1. **Clone the repository:** ```bash cd /path/to/odoo/addons git clone github.com gh_localization ``` 2. **Restart Odoo:** ```bash # If using Docker docker-compose restart # If running natively sudo systemctl restart odoo ``` 3. **Update Apps List:** - Go to Apps menu in Odoo - Click "Update Apps List" - Wait for update to complete 4. **Install the module:** - Search for "Ghana Localization" - Click "Activate" ## Usage ### Configure Employee Payroll 1. **Navigate to Employees:** - Go to Employees menu - Select an employee or create new 2. **Add salary information:** - Click the "Ghana Payroll" tab - Enter Basic Salary - Add allowances (Transport, Housing) - All calculations update automatically 3. **View payroll breakdown:** - Gross Salary (auto-calculated) - PAYE Tax (auto-calculated) - SSNIT Employee contribution (auto-calculated) - SSNIT Employer contribution (auto-calculated) - Net Salary (auto-calculated) ## Tax Rates (2025) ### PAYE (Pay As You Earn) | Monthly Income (GHS) | Tax Rate | |---------------------|----------| | 0 - 490 | 0% | | 491 …