KRA eTIMS Integration: What Kenyan Businesses Must Get Right
How eTIMS invoicing works, which integration route fits your system, and how to avoid failed invoice submissions.

Since January 2024, KRA has expected every business in Kenya β whether VAT-registered or not β to issue electronic tax invoices through eTIMS, and buyers increasingly need those invoices to claim their expenses. For anyone running an online store or ERP, that means integration rather than manual typing.
This article is general guidance, not tax advice. Confirm your obligations with your tax advisor and KRA.
Your options
- eTIMS Lite (web or USSD) β fine for a handful of invoices a week, typed in by hand.
- eTIMS Client β software on a computer or tablet for a single location without its own billing system.
- OSCU β system-to-system integration: your ERP, POS or online store sends each invoice to KRA online. This is what most WooCommerce, OpenCart and custom ERP users need.
- VSCU β system-to-system integration for high-volume or multi-branch businesses.
See eTIMS integration options explained for a fuller comparison.
Start from the official KRA eTIMS page to obtain credentials.
Data you must send correctly
Buyer PIN (for B2B), item classification codes, tax category per line, quantities and unit prices, and the document type β sale or credit note referencing the original invoice. In our experience, mismatched tax categories and item codes cause many of the rejections we see.
Engineering notes
- Queue submissions; never block the customer's checkout on KRA latency.
- Retry with backoff and store the control unit signature and QR payload on the invoice.
- Reconcile daily and alert on any unsubmitted invoice older than 24 hours.
Hosting and uptime
An eTIMS bridge must be reachable. Run it on a VPS with monitoring rather than on shared hosting with cron limits.
We build and maintain eTIMS bridges for WooCommerce, OpenCart and custom systems β see our integrations or request a scoping call.
Share this article
Was this article helpful?
Your vote helps us write better guides.
