Why eTIMS credit note not working happens
eTIMS credit note not working 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 credit note is rejected or will not link to the sale
- An error mentioning the original invoice
- You cannot record a refund or return cleanly
Match what you are seeing to the closest description above, then work through the fixes below in order, starting with the most common.
eTIMS credit note not working is rarely random; match the symptom to the cause and the fix is usually minutes away.
How to fix eTIMS credit note not working
Work through these in order. Most businesses resolve it at step one or two, without contacting KRA.
- 1
Reference the correct original invoice
A credit note must point to the original invoice it is correcting, by its control unit number. If the reference is wrong or the invoice cannot be found, the credit note fails. Confirm the original invoice details and use the exact reference.
- 2
Match the items and amounts to the original
The credit note should reflect what is being returned or corrected against the original. Amounts that do not match, or that exceed the original value, are rejected. Credit only what was actually on the original invoice.
- 3
Complete any required fields
A credit note often needs a reason and the same buyer details as the original. Fill in every required field so the document is complete.
- 4
Make sure the original was confirmed first
You cannot credit an invoice that never transmitted. Confirm the original invoice was accepted by KRA before issuing a credit note against it.
What not to do
Do not issue a negative sale instead of a credit note
Recording a fake negative invoice misstates your records. Use the proper credit note linked to the original.
Do not guess the original reference
An approximate reference will fail. Look up the exact original invoice details first.
A worked example
A wholesaler accepted a return and tried to issue a credit note, but it kept failing. He assumed credit notes were broken.
He had typed the wrong original invoice number, so the credit note could not link to a real sale. Once he referenced the correct original invoice and matched the returned items, the credit note went through at once.
A credit note is only as good as the original it points to. Get the reference right and it works.
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 credit note not working 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 is my eTIMS credit note not working?
How do I issue a credit note on eTIMS?
Can I credit more than the original invoice value?
What if the original invoice never transmitted?
What is the difference between a credit note and a debit note?
eTIMS credit note not working 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.