eTIMS

How to Install eTIMS in Kenya: A Step-by-Step Setup Guide

K By Kev 10 June 2026 11 min read
Share
eTIMS guide

To install eTIMS in Kenya you register for eTIMS against your KRA PIN, choose a KRA-certified way to issue invoices (a taxpayer app, the portal, or integrated software like Veira), set up your items with the right codes and tax types, and issue your first compliant invoice. There is no longer a physical machine to install for most businesses; eTIMS is software. This guide walks through the full setup, from registration to your first transmitted invoice, and shows how Veira makes the whole process a guided, same-day task.

Key takeaways
  • eTIMS install is a software setup, not a machine installation, for most businesses
  • The key step is mapping products to correct item codes and tax types
  • Test a transmitted invoice before going live
  • Veira makes setup a guided, same-day task
On this page
  1. What "installing eTIMS" actually involves
  2. How to install and set up eTIMS, step by step
  3. Common eTIMS setup mistakes
  4. A hardware store installs eTIMS in a day
  5. How Veira makes this automatic
  6. Frequently asked questions

What "installing eTIMS" actually involves

Installing eTIMS is mostly a software and setup process, not a hardware installation. The old idea of buying and fitting an ETR machine no longer applies to most businesses. Instead you register with KRA, choose a certified method to issue invoices, configure your products and tax types, and go live. The "installation" is getting that certified system ready to transmit compliant invoices.

You have a few options for the issuing method: KRA's eTIMS taxpayer apps and portal for low volumes, or a KRA-certified integration like Veira that connects your POS directly to KRA for everyday selling at speed. For any business with real sales volume, integrated software is the practical choice.

The setup that matters most is your items: mapping products to KRA item codes and the correct tax type. Get that right at install time and every sale afterwards carries the correct classification automatically.

How to install and set up eTIMS, step by step

Follow these steps to go from nothing to a transmitted first invoice.

  1. 1

    Step 1: Confirm your KRA PIN and obligation

    Make sure your KRA PIN is active on iTax and the correct tax obligation is registered. eTIMS is tied to an active PIN.

  2. 2

    Step 2: Register for eTIMS

    Register for eTIMS through a KRA-certified integrator or the KRA channels, and set a password specifically for eTIMS (separate from iTax). Your branch and device get set up here.

  3. 3

    Step 3: Choose your issuing method

    Pick how you will issue invoices: the KRA app/portal for very low volume, or certified software like Veira for everyday selling. For most businesses, integrated software is the right choice.

  4. 4

    Step 4: Set up your items

    Add your products with their KRA item codes, tax types and units of measure. This is the most important setup step; doing it well means every future sale is correctly classified.

  5. 5

    Step 5: Issue a test invoice

    Make a test sale and confirm it transmits to KRA and returns a control number and QR code. This proves your setup works end to end.

  6. 6

    Step 6: Go live and train staff

    Start issuing real invoices. Make sure every attendant knows that every sale must produce a compliant receipt, and confirm offline behaviour works.

Common eTIMS setup mistakes

Assuming you must buy a machine

Most businesses no longer need a physical ETR machine. eTIMS is software; you can issue compliant invoices from a phone or terminal with certified software.

Skipping item-code setup

Rushing setup and lumping everything under one generic code causes rejected invoices and unreconciled VAT later. Take time over item codes and tax types.

Confusing iTax and eTIMS passwords

eTIMS uses a password separate from iTax. Mixing them up is a common reason first-time login or setup stalls.

Not testing transmission

Going live without a test invoice means you discover transmission problems on a real customer. Always confirm a test invoice returns a control number first.

Using uncertified software

Only software on the KRA certified list can issue compliant invoices. Confirm certification before you set anything up.

A hardware store installs eTIMS in a day

Worked example

A hardware store owner in Nakuru thought installing eTIMS meant buying an expensive machine and waiting weeks. He had received a KRA reminder and was anxious.

Instead, he registered for eTIMS, chose certified software, and spent an afternoon mapping his products to item codes and tax types. A test invoice transmitted to KRA in seconds and returned a control number.

He went live the next morning issuing compliant invoices from a terminal, with no machine to install. The whole installation was a same-day software setup, and the careful item-code work meant every sale was correctly classified from the start.

Business impact

Trading without eTIMS-compliant tax invoices risks KRA penalties, blocked VAT input claims for your customers, and receipts a business buyer cannot expense.

Veira signs every sale to KRA eTIMS automatically, so each receipt is compliant the moment it prints, with no separate device to reconcile.

How Veira makes this automatic

Veira is a KRA-certified eTIMS integrator, listed on the official kra.go.ke certified software page. When you ring up a sale, Veira generates the compliant invoice, applies the right item code and tax type, transmits it to KRA, receives the control number, and prints the receipt with a QR code, automatically and offline-capable. Your VAT return reconciles with your eTIMS data with no manual matching.

It runs on a phone you already own or an affordable terminal from KES 2,999 a month, and it sits in the same app as your M-Pesa payments, stock and reporting. The hardest parts of eTIMS, getting the invoice, the codes and the timing right, become a guided setup step rather than a recurring worry.

Frequently asked questions

How do I install eTIMS in Kenya?
Register for eTIMS against your active KRA PIN, choose a KRA-certified way to issue invoices (a taxpayer app or integrated software like Veira), set up your products with the right item codes and tax types, issue a test invoice to confirm transmission, then go live. For most businesses there is no physical machine to install.
Do I need to buy a machine to install eTIMS?
No. eTIMS is software. Most businesses issue compliant invoices from a phone or an affordable terminal using certified software, so the old requirement to buy and fit an ETR machine no longer applies.
What is the most important setup step?
Setting up your items: mapping each product to the correct KRA item code and tax type. Get this right at installation and every future sale carries the correct classification automatically, keeping invoices transmitting cleanly and VAT reconciled.
How long does it take to set up eTIMS?
With certified software it can be a same-day task: register, choose your method, set up items, test, and go live. The main effort is the one-time item-code setup, which is faster with software that lets you search and bulk-assign codes.
What password do I use for eTIMS?
eTIMS uses a password you set specifically during eTIMS registration, separate from your iTax password, though both use the same KRA PIN. Confusing the two is a common reason first-time setup or login stalls.
How do I know my eTIMS is working?
Issue a test invoice and confirm it transmits to KRA and returns a control number and QR code. If it does, your setup works end to end. Veira lets you do this during setup so you go live with confidence.

Installing eTIMS today is a software setup, not a hardware project: register, choose certified software, set up your items, test, and go live. Veira makes it a guided, same-day task and issues compliant invoices automatically from KES 2,999 a month. Run the free eTIMS readiness check and book a free demo.

For more eTIMS guides and compliance resources, visit our free resource site.

Terms explained

Keep reading

See all eTIMS guides

Veira for your business

Browse Veira by business type