eTIMS

eTIMS Cannot Add Items: How to Fix It

K By Kev 14 June 2026 7 min read
Share
eTIMS guide

eTIMS cannot add items is frustrating when you are mid-sale and a customer is waiting, but it is almost always fixable in a few minutes. It means a product or service will not save to your eTIMS item list. This guide explains why it happens, how to fix it step by step, and how to stop it from happening again, in plain language for a Kenyan business.

Quick answer

If you cannot add items in eTIMS, it is usually a missing required field such as the item code, tax type or unit of measure, a duplicate item, or a permissions issue. Fill every required field, give each item a unique code, and confirm your user can manage products, then save again.

Key takeaways
  • eTIMS cannot add items usually has a small number of specific causes, each with a clear fix
  • Work through the causes in order; most are resolved in a few minutes without calling KRA
  • Recording sales offline and syncing later prevents the most common transmission-related failures
  • A POS that handles eTIMS natively, like Veira, avoids most of these errors at the source
On this page
  1. Why eTIMS cannot add items happens
  2. How to fix eTIMS cannot add items
  3. What not to do
  4. A worked example
  5. How Veira keeps this from happening
  6. Frequently asked questions

Why eTIMS cannot add items happens

eTIMS cannot add items is not random. It comes from one of a few specific causes, and once you know which one you are looking at, the fix is straightforward. Here is how the problem usually shows up first:

- The item will not save

- An error pointing to a required field

- A message that the item already exists

Match what you are seeing to the closest description above, then work through the fixes below in order, starting with the most common.

eTIMS cannot add items is rarely random; match the symptom to the cause and the fix is usually minutes away.

How to fix eTIMS cannot add items

Work through these in order. Most businesses resolve it at step one or two, without contacting KRA.

  1. 1

    Fill every required field

    An item usually needs a name, an item code or classification, a tax type and a unit of measure. If any required field is blank, the item will not save. Complete them all, then save.

  2. 2

    Give each item a unique code

    Two items cannot share the same code. If you get a duplicate message, change the code to a unique one, or edit the existing item instead of adding a new one.

  3. 3

    Check your user permissions

    If your user role cannot manage products, adding an item will fail. Use an account with the right permissions, or have the owner grant them.

  4. 4

    Map the item classification correctly

    The item code must map to a recognised classification. An unrecognised code can block the save. Choose the correct category for the product.

What not to do

Do not leave the tax type blank

An item with no tax type will fail to save or cause rejected invoices later. Set standard, zero-rated or exempt correctly.

Do not create duplicates to get past the error

If the item exists, edit it rather than forcing a near-duplicate, which clutters your list and causes confusion.

A worked example

Worked example

A shop owner could not add a new product and assumed the system was full or broken.

The item was missing its unit of measure and tax type. Once both were filled in, the product saved immediately. He then set up a habit of completing all fields when adding items, and the error did not return.

Adding an item fails almost always because a required field is missing. Complete them and it saves.

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 keeps this from happening

Veira handles eTIMS natively at the point of sale, so the conditions that cause eTIMS cannot add items are managed for you. It validates the invoice before it is sent, records sales offline when the network drops and transmits them to KRA when the connection returns, and keeps your KRA details in order so the common causes never arise.

When something does need attention, Veira flags it in plain language with the next step, and local support is on hand rather than a queue. See how Veira works and book a free demo. It runs from KES 2,999 a month with a free terminal.

Frequently asked questions

Why can I not add items in eTIMS?
Usually a missing required field such as the item code, tax type or unit of measure, a duplicate code, or a permissions issue. Fill every required field, give each item a unique code, confirm your user can manage products, and save again.
What fields does an eTIMS item need?
An item typically needs a name, an item code or classification, a tax type (standard, zero-rated or exempt) and a unit of measure. Missing any required field stops it saving, and a wrong tax type causes rejected invoices later.
Why does eTIMS say the item already exists?
Because another item already uses that code. Codes must be unique. Either give the new item a different code, or edit the existing item rather than adding a duplicate.
Can my staff add items to eTIMS?
Only if their user role has permission to manage products. Give staff the right permissions for what they need to do, or have the owner or manager add items, so the action does not fail on rights.
How do I add many products quickly?
A POS that lets you import or bulk-add products with their codes and tax rates is far faster than adding them one by one in the portal. Set the full catalogue up once so checkout is never interrupted by a missing item.

eTIMS cannot add items is almost always one of a few known causes, each with a quick fix, so do not panic if you hit it during a sale. Work through the steps above, and if you would rather not deal with eTIMS errors at all, Veira handles compliance natively so most never happen. See how Veira works and book a free demo. Always confirm current KRA processes at kra.go.ke, as rules can change.

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