KRA eTIMS with ERPNext
Every Kenyan business now has to issue electronic tax invoices through KRA's eTIMS. Here is what the rules mean in practice, and how ERPNext can issue compliant invoices as part of normal invoicing.
What eTIMS is
The electronic Tax Invoice Management System (eTIMS) is KRA's system for issuing and recording tax invoices. Each invoice is transmitted to KRA and comes back with KRA's validation details, so KRA can see your sales as they happen.
Who has to use it
Under the Tax Procedures (Electronic Tax Invoice) Regulations, 2024, the obligation covers all persons carrying on business in Kenya, whether or not they are registered for VAT. That includes companies, partnerships, sole proprietors, professionals, turnover tax payers and landlords. It applies to both taxable and exempt supplies.
There are exemptions, for example employment income under PAYE, imports cleared through customs, imported services, transactions subject to final withholding tax and airline ticketing. Check the current list with KRA if you think one applies to you.
Why it matters now: your expenses and your tax return
- Expenses need eTIMS invoices. Since the Finance Act, 2023, an expense is only deductible for income tax if it is supported by an eTIMS (or TIMS) invoice, unless it falls under an exemption. Genuine business costs can be disallowed if your supplier did not issue one.
- Returns are checked against eTIMS data. From January 2026, KRA validates income tax returns against the data it holds, including eTIMS sales and purchases and withholding tax. Where declared figures do not match, KRA can adjust them, which can lead to extra tax, penalties and problems getting a tax compliance certificate.
In short, eTIMS is no longer only about your own sales invoices. Your purchase records need to line up too.
The eTIMS options
- eTIMS Lite (web or USSD): for businesses with very few transactions.
- Online portal: for service businesses that do not sell goods.
- eTIMS Client: software you install for businesses selling goods, with support for branches and tills.
- OSCU and VSCU: the two system-to-system options that connect your own invoicing or ERP system directly to eTIMS. OSCU (Online Sales Control Unit) suits online invoicing systems. VSCU (Virtual Sales Control Unit) suits high volumes and bulk invoicing.
If you invoice from ERPNext, a system-to-system connection means your team keeps working in one system instead of typing every invoice twice.
How it works in ERPNext
- ERPNext is connected to eTIMS through an integration app configured for your KRA PIN and branches.
- When a sales invoice or credit note is submitted, it is sent to eTIMS and KRA's validation details and QR code are written back onto the invoice before it goes to the customer.
- Items are mapped to KRA item classification codes and tax types, and customers are recorded with their KRA PIN, so invoices pass validation first time.
- Failed submissions are flagged for your team to fix, instead of being discovered at year end.
Getting it right
- Clean up your item list and tax settings before go-live. Most eTIMS rejections come from item codes and tax types that do not match.
- Ask key suppliers for eTIMS invoices and record them against your purchase invoices, so your expense claims are supported.
- Test credit notes and cancellations in KRA's sandbox before going live, not just standard invoices.
Last reviewed October 2026. Tax rules change often. This guide is general information, not tax advice. Check the latest notices from the tax authority or speak to your tax adviser before acting.
Frequently asked questions
Do I need eTIMS if I am not registered for VAT?
Yes. Under the 2024 regulations the obligation to issue electronic tax invoices applies to all persons carrying on business, whether or not they are VAT-registered, unless an exemption applies.
Can ERPNext connect to eTIMS directly?
Yes. ERPNext can be integrated with eTIMS through the system-to-system options (OSCU or VSCU), so invoices are validated by KRA as part of normal invoicing in ERPNext.
What happens if a supplier does not give me an eTIMS invoice?
The expense may not be deductible for income tax unless an exemption applies. Ask suppliers for eTIMS invoices and keep them against your purchase records.
Find out what ERPNext would look like in your business
A 45-minute consultation with our lead consultant. We look at how you run finance and operations today and tell you plainly whether ERPNext is the right fit.