eTIMS

eTIMS Invoice Rejected: Common Reasons and Fixes

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

eTIMS invoice rejected is frustrating when you are mid-sale and a customer is waiting, but it is almost always fixable in a few minutes. It means KRA received the invoice but refused it because a field is missing, wrong or inconsistent. 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

An eTIMS invoice is usually rejected because of a data problem: a wrong or missing tax rate, an unmapped item code, an invalid buyer PIN, or totals that do not add up. Fix the flagged field so the invoice is internally consistent, then resubmit. The rejection message normally names the field at fault.

Key takeaways
  • eTIMS invoice rejected 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 invoice rejected happens
  2. How to fix eTIMS invoice rejected
  3. What not to do
  4. A worked example
  5. How Veira keeps this from happening
  6. Frequently asked questions

Why eTIMS invoice rejected happens

eTIMS invoice rejected 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:

- A rejection message, often naming a field such as tax, item or PIN

- The invoice does not get a control number or QR code

- It usually appears immediately after you submit, not later

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

eTIMS invoice rejected is rarely random; match the symptom to the cause and the fix is usually minutes away.

How to fix eTIMS invoice rejected

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

  1. 1

    Fix the tax rate on each line

    A common cause. Each item must carry the correct tax type: standard-rated, zero-rated or exempt. If a zero-rated item is marked standard, or the VAT does not match the rate, KRA rejects it. Set the right rate per item and resubmit.

  2. 2

    Map any missing or unknown item code

    eTIMS expects each item to map to a recognised classification. An unmapped or blank item code causes a rejection. Assign the correct item code or category to the product, then issue the invoice again.

  3. 3

    Correct an invalid buyer PIN

    If the invoice carries a buyer PIN that does not match KRA records, it is rejected. Re-enter the buyer PIN exactly, or remove it if the customer is an ordinary consumer who does not need it.

  4. 4

    Make the totals add up

    If the taxable value, VAT and gross total do not reconcile, the invoice is inconsistent and is refused. Check that quantity times price equals the line total and that VAT equals the rate applied. A POS that calculates these for you avoids the issue.

What not to do

Do not keep resubmitting the same invoice

Resubmitting without changing the flagged field just repeats the rejection. Read the message, fix that field, then resend.

Do not force a tax rate to clear the error

Changing a rate just to make it pass misreports VAT. Use the correct rate for the item, even if that means checking the VAT schedule.

A worked example

Worked example

A pharmacy in Nakuru had invoices rejected every time it sold certain medicines. The owner assumed the eTIMS account had a fault.

The real cause was tax treatment: some pharmaceutical items are zero-rated, but they had been set as standard-rated, so the VAT on the invoice did not match the rate and KRA refused it. Once the items were set to the correct rate, the invoices went through cleanly.

Getting the tax rate right per item is the single biggest fix for rejected invoices, especially in trades that mix standard, zero-rated and exempt goods.

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 invoice rejected 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 was my eTIMS invoice rejected?
Because a field is missing, wrong or inconsistent. The usual causes are a wrong tax rate, an unmapped item code, an invalid buyer PIN, or totals that do not add up. The rejection message normally names the field at fault, so fix that and resubmit.
What does a rejected invoice mean for my records?
A rejected invoice did not receive a control number, so it is not yet a valid tax invoice. You must correct and resubmit it so the sale is properly recorded. The sale itself is not lost; only the submission was refused.
How do I fix a wrong tax rate on eTIMS?
Set each item to its correct tax type: standard-rated, zero-rated or exempt, in line with the VAT schedule. If the VAT shown does not match the rate, KRA rejects the invoice. A POS that holds the right rate against each product prevents this.
What is an item code in eTIMS?
It is the classification that tells KRA what kind of product or service the line is. Each item should map to a recognised code or category. A blank or unrecognised item code can cause a rejection, so map your products once during setup.
Does Veira prevent rejected invoices?
Yes, largely. Veira holds the correct tax rate against each product, maps item codes during setup, validates the buyer PIN and calculates the totals, so the invoice is internally consistent before it is sent and rejections become rare.

eTIMS invoice rejected 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