The EliteTeQ Ledger ยท ยท 9 min read

How to Set Up KRA eTIMS on Your POS in Kenya: A Practical Walkthrough

E
EliteTeQ Team
Published โ€ข Updated โ€ข 9 min read

A business customer walks up to your counter, buys a few cartons for their office, and before they pay they ask the question that's become normal in Kenya: "Will the receipt be on eTIMS?" If the answer is no, they can't claim the input VAT, and next time they'll buy from the shop down the road that says yes.

That's the real reason most owners end up setting up eTIMS. Not the fear of KRA, though that's there too, but the fact that customers now expect it.

The short version: if you're VAT-registered and selling through a POS, the sensible route is to have the POS send every invoice to KRA automatically. You register on iTax, get your eTIMS credentials, enter them in the POS, put every product in the right VAT category, run a test sale and go live. After that, each receipt goes to KRA as you sell, and it comes back with a CU invoice number and a QR code.

First, what eTIMS actually does

eTIMS is KRA's electronic invoicing system. When you issue a tax invoice, its details go to KRA, KRA validates it, and the receipt carries proof of that validation. It took over from the old ETR boxes that used to sit on the counter beside the till.

There are a few ways to use it, and picking the right one saves you trouble:

  • eTIMS Lite suits small traders with only a handful of invoices, issued from a phone or the web.
  • eTIMS Online lets you raise invoices directly on the KRA portal.
  • System-to-system (POS) integration sends invoices straight from your POS software.

If you run a supermarket, restaurant, pharmacy or a busy shop, typing invoices into a portal by hand isn't realistic. You want the POS route, so selling stays the way it is and compliance happens in the background.

Why eTIMS is worth setting up properly

eTIMS lets KRA match what you sell with what you declare, and it lets your buyers claim their input VAT cleanly. That second point matters more than people think. Wholesale and corporate buyers increasingly refuse invoices that aren't eTIMS-validated.

Not transmitting invoices, or issuing ones that don't comply, also exposes you to KRA penalties. The amounts change from time to time, so check the current position on iTax or with your accountant rather than relying on a figure from a blog. Whatever the exact amount, getting it wrong costs far more than setting it up properly.

The setup, step by step

Plan for an afternoon, and have your KRA PIN and iTax login to hand.

1. Register for eTIMS on iTax

Log in to iTax, open the eTIMS section and choose the POS or system-to-system option. Once KRA approves it, you'll get the credentials that identify your business and device to KRA. Save them somewhere safe, because you need them in the next step and again if you ever move to a new machine.

2. Enter the credentials in your POS

In EliteTeQ, the KRA details go into the tax settings: your KRA PIN, the branch the till belongs to, and the credentials from iTax. Then check the connection. If it fails at this point, it's nearly always a mistyped PIN or credential, so check those before anything else.

If you have more than one branch, each branch is set up separately, so receipts from your town shop and your estate shop are reported under the right location.

3. Put every product in the right VAT category

VAT categories are the step people rush, and they cause most of the trouble later. Every product needs the correct tax treatment:

  • Standard rated at 16 per cent
  • Zero rated
  • Exempt
  • Non-VAT

The easy mistake is to put everything under standard rate and sort it out later. Don't. If an exempt or zero-rated item goes out at 16 per cent, you overcharge your customer and file the wrong figures. Go through your list properly once and the POS applies the right rate every time after that. If you're unsure where an item belongs, ask your accountant; Finance Acts do move items between categories.

4. Run a test sale

Ring up one real transaction. The POS sends it to KRA, and KRA returns a CU invoice number and a QR code that print on the receipt. Anyone can scan that QR code to check the invoice is genuine. If both come back, you're connected.

5. Go live and brief your cashiers

Turn eTIMS on for all sales. Then spend ten minutes with your cashiers on the new receipt layout, so nobody looks lost when a customer points at the QR code and asks what it is.

When the internet or power goes

Every Kenyan shop owner knows the line will drop at some point, often in the middle of the evening rush. That shouldn't stop you selling.

EliteTeQ keeps working offline. The sale goes through, the receipt prints, and the invoice waits in a queue. When the connection comes back, the queued invoices go to KRA on their own, and you can see what's been sent and what's still waiting. A UPS on the till is still worth buying, so a power cut doesn't shut the counter mid-sale.

Problems you're likely to hit

Most eTIMS problems come from a weak connection, a mistyped PIN or credentials, or a product in the wrong VAT category, and each has a simple fix.

What you seeUsual causeWhat to do
Connection timeoutWeak or no internetCheck Wi-Fi or mobile data; offline mode holds the queue
Invalid PINKRA PIN typed wronglyCheck the PIN on iTax and re-enter it
Device not recognisedCredentials not activated or mistypedCheck the status on iTax and re-enter the credentials
Duplicate invoiceThe same invoice sent twiceClear the stuck transaction from the queue
Wrong tax on receiptItem in the wrong VAT categoryFix the product's tax category

Most of these take a few minutes to fix. When something won't connect, start with the credentials, because typos cause more failures than anything else.

Questions owners ask

Do I still need an ETR box? No. With a POS connected to eTIMS, the software does that job, and you can use standard hardware rather than one specific terminal brand.

What if KRA rejects an invoice? The POS shows an error. Fix the cause, usually a wrong PIN, a wrong tax category or a duplicate, and send it again.

Does eTIMS cost extra on EliteTeQ? No. It comes with the subscription, which is KES 5,000 per month, and KRA doesn't charge for eTIMS registration itself.

What about the rest of the business? That's where a good POS pays off beyond compliance: stock that matches the shelf, every branch in one view, staff logins with an audit log, and M-Pesa payments matched to the sale. For more on the tax side, read our guide to [VAT compliance with a POS in Kenya](/ke/blog/vat-compliance-pos-kenya/) or see how [EliteTeQ handles KRA eTIMS](/ke/kra-etims-pos/).

Next step

eTIMS sounds heavier than it is. It's a one-off setup, and after that your sales report themselves to KRA. If you'd like someone to do it with you, book a free demo and we'll set up eTIMS on your own products, or talk to a real person on WhatsApp first.

Let's discuss how EliteTeQ POS can help you achieve the results you just read about.

Related Articles

Tax Compliance

VAT Compliance in Kenya: How Your POS Can Take the Monthly Scramble Out of KRA Filing

How a POS helps Kenyan businesses get VAT right every day: the correct rate on each product, every invoice through eTIMS, refunds handled properly, and figures ready for the monthly return.

Read

We support businesses across the world with fully remote onboarding, real-time assistance, and dedicated technical support โ€” no matter your location.

Remote support worldwide
WhatsApp-first global communication
โฑFast response times across time zones
Dedicated POS
WhatsAppIndustries