Overview

For Uganda URA compliance on supplier bills. This module lets you apply Withholding (Income) and Withholding VAT on posted vendor bills with editable base/amount. It automatically creates separate journal entries and performs partial reconciliation against payable lines while leaving the original bill untouched.

Key Features

✅ WHT Income Application

• Apply income withholding on posted vendor bills
• Editable base amount and withheld amount
• Simple wizard interface accessible from vendor bills

✅ WHT VAT Application

• Apply withholding VAT on posted vendor bills and credit notes
• Enter taxable base and withheld VAT amount
• Wizard suggests journal and payable account

✅ Smart Journal Entries

• Dr Supplier Payable (partner) – Withheld amount
• Cr URA Withholding Payable – Withheld amount
• Original bill remains intact (separate entry)

✅ Auto Reconciliation

• Auto partial reconcile against payable lines
• Linked documents for instant access
• Clean, auditable trail

✅ Security & Compliance

• Multi-company safe
• Works with Accounting User permissions; sudo only for posting/reconciliation
• No core Odoo overrides

How It Works

The Uganda Withholding Agent module follows a clear workflow:

1. Vendor Bill Processing

• Create and post vendor bills normally in Odoo
• No change to your existing accounting workflow

2. Apply Withholding (Income or VAT)

• Open the posted vendor bill and launch the respective wizard
• Provide/confirm base and withheld amounts (defaults are suggested)
• Wizard proposes a journal and the URA withholding payable account

3. Journal Entry Creation

• Creates a separate journal entry (original bill stays untouched)
• Debits the supplier's payable account and credits the withholding payable account

4. Automatic Reconciliation

• System partially reconciles the withholding entry with the original bill
• Reduces the net amount payable to the supplier
• Links entries for audit trail and review

5. Compliance & Reporting

• Withholding amounts accumulate on dedicated liability accounts
• Easy reporting for URA submissions

What Gets Posted

When a withholding is applied through the wizard, the system creates:

Dr Supplier Payable (partner)    XXX.XX
    Cr URA Withholding Payable           XXX.XX

The original vendor bill remains completely intact, ensuring no disruption to your accounting processes.

Installation

Configuration (1–2 minutes)

Usage Instructions

Vendor Bill: UGX 1,000,000
Status: Posted
Amount Due: UGX 1,000,000

Original Vendor Bill: UGX 1,000,000 (unchanged)
WHT Income Entry: UGX 60,000 (6% of 1,000,000)
Net Amount Due: UGX 940,000 (automatically reconciled)

Compatibility

✅ Supported Platforms: - Odoo Community Edition - Odoo Enterprise Edition - Odoo.sh

❌ Not Supported: - Odoo Online (Python restrictions)

✅ Compatible With: - Vendor Bills and Vendor Credit Notes - Multi-company environments - Standard Odoo accounting workflows

Permissions

Who Can Use: - Any user with "Accounting User" access rights

Security: - Sudo access is used only for posting and reconciliation steps - Multi-company safe with proper access controls - No core Odoo overrides or modifications

Troubleshooting

Getting Help

Documentation: - User Guide: https://docs.odoo.co.ke/withholding-ura

Support Channels: - Email: support@odoo.co.ke - Website: https://odoo.co.ke/helpdesk/customer-support-1 - Phone: +254739444447 - Response Time: 1 business day SLA

Why Choose This Module?

Faster Compliance - Automates URA withholding workflows (Income + VAT) - Saves accountant time and reduces errors

Clean & Safe - No changes to core Odoo objects - Original bills remain intact - Proper audit trails and linked documents

Cost-Effective - One-time license: $141 - Pays for itself in time savings

Professional Support - Developed by Metro ICT Ltd (East Africa Odoo experts) - 90-day complimentary support included

License & Legal

License: OPL-1 (Odoo Proprietary License) Copyright: Metro ICT Ltd Redistribution: Not permitted

This module is licensed under OPL-1 with no redistribution rights. Please review our full license policy at: https://odoo.co.ke/license-policy

About Metro ICT Ltd

Metro ICT Ltd is an Odoo implementation partner focused on accounting automation and compliance solutions for East African businesses.

Contact Information: - Website: https://odoo.co.ke - Email: support@odoo.co.ke - Phone: +254739444447 - Location: Nairobi, Kenya

---

Last Updated: October 2025 Version: 17.0.1.0.0