| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Accounting (account_accountant)
• Invoicing (account) • Discuss (mail) |
| Lines of code | 282 |
| Technical Name |
ke_withholding_vat_agent |
| License | OPL-1 |
| Website | https://odoo.co.ke |
| Versions | 16.0 17.0 18.0 |
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Accounting (account_accountant)
• Invoicing (account) • Discuss (mail) |
| Lines of code | 282 |
| Technical Name |
ke_withholding_vat_agent |
| License | OPL-1 |
| Website | https://odoo.co.ke |
| Versions | 16.0 17.0 18.0 |
Accounting • Compliance
Kenya Withholding VAT (Agent)
For withholding VAT agents handling supplier bills. Apply WHT VAT on posted vendor bills with editable base/amount (default 2%). Auto partial reconcile against payable lines.
Compatible With
Pricing
$69
Kenya Withholding VAT (Agent)
This module depends on ke_withholding_vat_supplier module
Bundle Price for Both Modules
$119
Optional Annual Support & Updates (per database)
$79/year
Priority fixes, version upgrades, and email support within 1 business day
Why this pricing?
These modules automate a narrow but high-impact compliance workflow specific to Kenya. They save accountant time every month, reduce errors, and avoid risky manual journals—while remaining lightweight and safe (no core overrides). $69 is in line with focused accounting add-ons on the store; a $119 bundle rewards buying both.
Value Proposition
Purpose-built for Kenya, zero core overrides, accountant-friendly.
This suite delivers precise handling of Withholding VAT (2%) in Kenya—exactly how local teams work:
Creates a clean, separate journal entry for WHT VAT (no edits to the original invoice/bill).
Rate defaults to 2%, but users can override the withheld amount when reality disagrees with theory.
Attempts partial reconciliation against the receivable/payable line to keep ledgers tidy.
Pre-fills sensible accounts and journals; smart defaults reduce setup time.
Uses sudo only for the posting step so regular accounting users can work—without elevating global rights.
Each invoice shows the linked WHT VAT entry, making reviews and audits simple.
📸 Withholding VAT Screenshots
Visual guide to the Kenya Withholding VAT Agent module functionality
WHT VAT Wizard
Withholding VAT wizard accessible from posted vendor bills. Apply 2% WHT VAT with editable base amount.
Posted Entries
Journal entries showing Dr Payables (partner) and Cr WHT VAT Payable. Original bill remains intact with auto partial reconciliation.
Configuration
Simple configuration setup: General Journal and "Withholding VAT Payable (KRA)" account. Takes 1-2 minutes to configure.
Linked Documents
Instant access to linked documents between original vendor bill and WHT VAT entries for clean audits and compliance tracking.
💰 WHT VAT Application
- Apply 2% WHT VAT on posted vendor bills
- Editable base/amount with defaults
📊 Smart Journal Entries
- Dr Supplier Payable (partner)
- Cr WHT VAT Payable (KRA)
🔗 Auto Reconciliation
- Auto partial reconcile against payable lines
- Linked documents for instant access
🛡️ Security & Compliance
- Multi-company safe, sudo-secured
- Original bill remains intact
Latest Release 17.0.1.0.0
2024-12-01- Initial Kenya Withholding VAT Agent release.
- WHT VAT wizard with editable base/amount (default 2%).
- Auto partial reconciliation against payable lines.
- Multi-company safe with sudo security.
📅 Changelog
| Date | Version | Notes |
|---|---|---|
| 2024-12-01 | 17.0.1.0.0 | Initial release – Kenya WHT VAT Agent with wizard and auto reconciliation |
🔁 Related Modules by Metro ICT
| App | Use Case | Versions |
|---|---|---|
| Kenya Withholding VAT (Supplier) | WHT VAT for supplier bills - companion module | 17 |
| Auto Allocate Credits | Auto reconcile payments to invoices | 16–18 |
| POS Syncer | POS ↔ Accounting Sync | 15–18 |
| FleetCare | Fleet Management | 13–18 |
📜 Licensing
License Type
OPL-1Redistribution
No redistributionFull Policy
View PolicySupport & Contact
support@odoo.co.ke
https://odoo.co.ke/helpdesk
+254739444447
1 business day SLA
Kenya Withholding VAT (Agent)
Apply Kenya Withholding VAT (2%) on posted vendor bills via a simple wizard.
Overview
For withholding VAT agents handling supplier bills. This module allows you to apply Withholding VAT on posted vendor bills with editable base/amount (default 2%). It automatically creates proper journal entries and performs partial reconciliation against payable lines.
Key Features
- ✅ WHT VAT Application
- Apply 2% WHT VAT on posted vendor bills
- Editable base amount and rate (default 2%)
- Simple wizard interface accessible from vendor bills
- ✅ Smart Journal Entries
- Dr Supplier Payable (partner) – Withheld VAT amount
- Cr WHT VAT Payable – Withheld VAT amount
- Original bill remains intact
- ✅ Auto Reconciliation
- Auto partial reconcile against payable lines
- Linked documents for instant access
- Clean audit trails
- ✅ Security & Compliance
- Multi-company safe, sudo-secured
- No changes to Odoo taxes or move lines
- Permissions: Any Accounting User can run wizard
How It Works
The Kenya Withholding VAT Agent module follows a simple but powerful workflow:
- 1. Vendor Bill Processing
- You create and post vendor bills normally in Odoo
- No changes to your existing accounting workflow
- Bills remain in standard Odoo format
- 2. WHT VAT Application
- Access the "Apply WHT VAT" wizard from any posted vendor bill
- System calculates 2% WHT VAT (editable) based on bill amount
- Wizard pre-fills suggested journal and WHT VAT Payable account
- 3. Journal Entry Creation
- Creates a separate journal entry (original bill untouched)
- Debits the supplier's payable account (reduces what you owe)
- Credits the "WHT VAT Payable (KRA)" account (tracks tax owed to KRA)
- 4. Automatic Reconciliation
- System automatically reconciles the WHT entry against the original bill
- Reduces the net amount payable to the supplier
- Creates linked documents for audit trail
- 5. Compliance & Reporting
- WHT VAT amounts accumulate in the dedicated liability account
- Easy reporting for KRA submissions
- Clean separation between original transactions and WHT adjustments
- Example Workflow:
- Original Bill: KES 100,000 to Supplier ABC
- WHT VAT Applied: KES 2,000 (2%)
- Result: You owe Supplier ABC KES 98,000, KRA gets KES 2,000
- All properly documented with linked entries
What Gets Posted
When you apply WHT VAT through the wizard, the system creates:
Dr Supplier Payable (partner) XXX.XX
Cr WHT VAT Payable XXX.XX
The original vendor bill remains completely intact, ensuring no disruption to your existing accounting processes.
Installation
Prerequisites
- Odoo Version: 17.0
- Dependencies: - account (Accounting) - account_accountant (Accounting Features) - ke_withholding_vat_supplier (companion module)
Installation Steps
- Download the Module - Purchase and download from Odoo Apps Store - Or obtain from Metro ICT Ltd
- Install Dependencies - Ensure ke_withholding_vat_supplier module is installed first - This module depends on the supplier module
- Upload and Install - Upload the module to your Odoo addons directory - Update the apps list - Install "Kenya Withholding VAT (Agent)"
- Verify Installation - Go to Apps → Installed Apps - Confirm both WHT VAT modules are installed
Configuration (1-2 minutes)
Quick Setup
- Ensure General Journal Exists - Go to Accounting → Configuration → Journals - Verify you have a "General Journal" or create one
- Create/Confirm WHT VAT Account - Go to Accounting → Configuration → Chart of Accounts - Create account: "Withholding VAT Payable (KRA)" - Account Type: Current Liabilities - Account Code: (as per your chart of accounts)
- Optional: Adjust Wizard Defaults - The wizard suggests appropriate journal & account - Default rate is 2% but can be modified per transaction
That's it! Configuration takes 1-2 minutes.
Usage Instructions
Applying WHT VAT to Vendor Bills
- Post Your Vendor Bill - Create and post your vendor bill as usual - The bill must be in "Posted" state
- Access WHT VAT Wizard - Open the posted vendor bill - Click the "Apply WHT VAT" button - The wizard will open
- Configure WHT VAT Details - Base Amount: Defaults to bill amount (editable) - WHT Rate: Defaults to 2% (editable) - Journal: Suggests General Journal (editable) - Account: Suggests "WHT VAT Payable" (editable)
- Apply WHT VAT - Click "Apply WHT VAT" button - System creates journal entry and reconciles automatically - View linked documents for audit trail
Workflow Example
Before WHT VAT Application:
Vendor Bill: $1,000.00 Status: Posted Amount Due: $1,000.00
After WHT VAT Application:
Original Vendor Bill: $1,000.00 (unchanged) WHT VAT Entry: $20.00 (2% of $1,000) Net Amount Due: $980.00 (automatically reconciled)
Compatibility
✅ Supported Platforms: - Odoo Community Edition - Odoo Enterprise Edition - Odoo.sh
❌ Not Supported: - Odoo Online (Python restrictions)
✅ Compatible With: - Vendor Bills - Vendor Credit Notes - Multi-company environments - All standard Odoo accounting workflows
Permissions
Who Can Use: - Any user with "Accounting User" access rights - No special permissions required for running the wizard
Security: - Sudo access only used for posting journal entries and reconciliation - Multi-company safe with proper access controls - No core Odoo overrides or modifications
Troubleshooting
Common Issues
Issue: "Apply WHT VAT" button not visible - Solution: Ensure the vendor bill is in "Posted" state - Solution: Check user has Accounting User permissions
Issue: Account not found error - Solution: Create "Withholding VAT Payable (KRA)" account - Solution: Ensure account type is set to Current Liabilities
Issue: Journal not found error - Solution: Create a General Journal in Accounting → Configuration → Journals - Solution: Ensure journal type is "General"
Issue: Reconciliation not working - Solution: Check that both entries have the same partner - Solution: Verify account types are correct (Payable accounts)
Getting Help
Documentation: - User Guide: https://docs.odoo.co.ke/withholding-vat - Video Tutorials: Available on our website
Support Channels: - Email: support@odoo.co.ke - Website: https://odoo.co.ke/helpdesk/customer-support-1 - Phone: +254739444447 - Response Time: 1 business day SLA
Annual Support Package: - Priority fixes and version upgrades - Email support within 1 business day - Cost: $79/year per database
Why Choose This Module?
Faster Compliance - Automates Kenya WHT VAT compliance workflow - Saves accountant time every month - Reduces manual journal entry errors
Clean & Safe - No core Odoo overrides or modifications - Original bills remain completely intact - Proper audit trails and linked documents
Cost-Effective - $69 for focused accounting automation - $119 bundle with companion supplier module - Pays for itself in time savings
Professional Support - Developed by Metro ICT Ltd (Kenya Odoo experts) - 90-day complimentary support included - Optional annual support packages available
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 a leading Odoo implementation partner based in Kenya, specializing in 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: December 2024 Version: 17.0.1.0.0
Odoo Proprietary License v1.0 This software and associated files (the "Software") may only be used (executed, modified, executed after modifications) if you have purchased a valid license from the authors, typically via Odoo Apps, or if you have received a written agreement from the authors of the Software (see the COPYRIGHT file). You may develop Odoo modules that use the Software as a library (typically by depending on it, importing it and using its resources), but without copying any source code or material from the Software. You may distribute those modules under the license of your choice, provided that this license is compatible with the terms of the Odoo Proprietary License (For example: LGPL, MIT, or proprietary licenses similar to this one). It is forbidden to publish, distribute, sublicense, or sell copies of the Software or modified copies of the Software. The above copyright notice and this permission notice must be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Please log in to comment on this module