A Kenya eTIMS credit note needs to connect three records: the invoice being corrected, the reason and amount of the correction, and the VAT return that recognises it. Issuing the document is only one part of that job. This guide follows the correction through the seller's records and the buyer's review, with particular attention to original invoice references and return mismatches.
Use the Kenya VAT calculator to check VAT arithmetic after confirming the supply's tax treatment. It does not issue an eTIMS credit note, transmit an invoice, amend a return or verify an input-tax deduction. The Kenya VAT guide covers the wider rate and filing framework. The eTIMS expense-validation guide covers the separate annual income-tax evidence workflow.
1. Identify the correction before choosing the document
KRA's VAT guidance describes credit notes for returned goods or a valid reduction in the value of a supply after invoicing. It gives a general issue window of six months after the relevant invoice. Its electronic-invoice FAQs also describe correcting data-entry errors with credit or debit notes linked to the original invoice.
Begin by stating what actually changed. Is the supply value lower, were goods returned, or does the invoice contain incorrect information? Identify the person who can approve the correction and attach the evidence supporting it. A customer request, a bookkeeping adjustment and a completed tax document should have separate entries in the working record.
Do not let a general description such as "invoice error" hide the question that needs resolving. Record the disputed field or line item, the original value and the requested correction. That makes it possible for a reviewer to compare the request with the issued invoice without reconstructing the conversation from several messages.
For a date-sensitive or unusual case, check the applicable rule with KRA or a qualified adviser before proceeding. This guide does not reproduce every statutory exception. Put an unresolved treatment question on the review list rather than issuing a document simply to make the accounts balance.
2. Match the original invoice and its issuing solution
The same KRA FAQs require the original invoice reference when issuing a credit or debit note and say a credit note cannot combine references to several invoices. KRA's current eTIMS solution guidance adds a practical constraint: the credit note must be generated in the solution that issued the invoice. Different solutions have their own numbering sequences.
A reconciliation register should therefore store more than a familiar invoice number. Include the issuing business, branch where relevant, eTIMS solution, invoice date, customer reference and the document's tax and total values. Preserve a link to the source document. Match those fields before deciding that a number in one list is the same transaction as a number in another.
For a batch of corrections, review each original invoice separately. An internal worksheet can group the requests for convenience while preserving the individual document relationships. Avoid using a customer balance as the only evidence of what each invoice correction should contain.
Keep the original document available after the correction. Label the relationship explicitly: original invoice, credit note, and any replacement invoice. Use a status column to identify documents that have been prepared, issued or checked against a return. A single "done" label hides which part of the evidence chain is complete.
3. Review a full or partial correction before issuing it
KRA's 2024 online-portal user guide shows the invoice opened from the sales-receipt record and distinguishes partial and full credit-note controls. Treat this as the published manual's workflow, not proof that every button has been tested in a current taxpayer account. The current tutorials page provides separate credit-note training for online, client and eCitizen solutions.
Before confirming a document, compare its scope with the approved reason. A full reversal and a reduction affecting selected items have different effects on the remaining invoice balance. Check quantities, taxable values and VAT separately. Document the reviewer and approval date beside the evidence used to support the action.
Separate a tax-document correction from the commercial settlement. If money is to be returned or offset, record the agreed settlement and its evidence in another field. That prevents a document's issue date from being mistaken for the date a customer received a refund.
After issue, retain the final document rather than relying on a draft preview. Recheck the original invoice reference and amounts against the approved worksheet. Record any difference as an exception with a named owner. Avoid quietly altering the worksheet to conceal a mismatch that the issuer needs to explain.
4. Reconcile the seller's return to the original invoice
KRA's auto-populated return FAQs say sales credit notes are included in the relevant CSVs. For a credit note declared as a line item to a VAT-registered customer, the original invoice must have been declared as a line item in the return for its relevant invoice date. The FAQs also distinguish invoice dates from late transmission dates when allocating sales.
Build the seller's review around that relationship. Find the original invoice in the sales register and identify the return that recorded it. Then locate the corresponding correction in the current working data. A credit note appearing in a download does not, by itself, show that the original declaration is correct.
Keep a dated copy of each return download used for reconciliation. Record the tax period and extraction time in the worksheet header. KRA says the prefilled data changes as further invoices arrive, so obtain the latest data before filing. Do not mix totals from one download with line items from another without explaining the difference.
When an original invoice cannot be matched, stop at the exact missing link. Establish whether the source document is missing, the invoice was absent from the declaration, or the wrong period is being searched. Ask KRA about the appropriate correction route where an earlier filing is affected; do not assume that entering a current credit note repairs every earlier error.
5. Give the buyer a document trail to review
KRA's input-tax guidance makes clear that documentation and eligibility matter to a deduction. A business should review the actual invoice and correction rather than treating every purchase value as recoverable VAT. Record whether the item relates to taxable business activity and refer uncertain treatment to the responsible tax reviewer.
The buyer's worksheet should identify the original supplier document, the credit note received, the original treatment in its records and the correction awaiting review. Keep the supplier's explanation with the documents. If a replacement invoice follows, label it separately so the reconciliation does not mistake it for an additional independent purchase.
Ask the reviewer to confirm what remains after the correction. The record should show whether the original amount was wholly reversed or partly reduced, and which document supports the remaining balance. Keep a record of the return review rather than using the supplier's email as proof that the buyer's filing has been corrected.
A payment reference can help investigate the commercial transaction, but it should not replace the invoice relationship. Use it as supporting evidence in the register. Keep the deduction decision, tax-document correction and settlement review distinct so each can be checked by the person responsible for it.
6. Investigate a return error without repeating the same entry
The January 2025 iTax enhancements bulletin discusses credit-note declaration errors involving original invoice details and previously claimed records. It explains that purchase credit notes require attention even where other purchases are not being claimed. This is historical system guidance, not a claim that every described defect persists in October 2026.
For a current error, retain its wording, affected invoice reference, tax period and the time it appeared. Make a short record of the steps already taken. Repeating the same submission without changing or checking the underlying records gives the reviewer little new evidence.
Use the comparison below to organise the investigation. These are review questions, not instructions to bypass a validation or alter an official record without support.
| Observed problem | Evidence to compare | Question to resolve |
|---|---|---|
| Original invoice cannot be found | Issued document, sales register and original return | Which record or period is missing? |
| Correction appears twice | Document identifiers and previous review records | Are these two documents or repeated references to one? |
| Amounts disagree | Approved reason, original lines and final credit note | Was the correction full or partial? |
| Current download differs from an earlier copy | Extraction dates and changed line items | Which data supports the proposed filing? |
| System message remains unresolved | Error wording and investigation log | What specific action does KRA require? |
7. Check the arithmetic without inventing a transaction
KRA's VAT page publishes an example with output tax of KSh 1,920 and input tax of KSh 1,600, producing KSh 320 payable. Those are official example amounts, not a fictional customer's transaction or a credit-note example. They show why output, input and the resulting liability must be checked separately.
For an actual correction, compare the VAT change in the credit note with its approved taxable-value change and confirmed rate. Then reconcile the document's total with the accounting entry. Do not apply a general rate to an item whose tax classification has not been established.
Check the VAT calculation
Use confirmed amounts and treatment to review the arithmetic. Keep the eTIMS documents and return evidence in the official workflow.
Open Kenya VAT calculator8. Close the review with an evidence index
Give each unresolved difference an owner, an action and a next review date. Keep the correction request, approval, final documents, return comparison and any support response in a single index. Use document references in a shared review list rather than copying customer identifiers into unnecessary reports.
Before closing an item, ask the reviewer to check that the final amounts agree, the original invoice relationship is visible and the filing action is documented. Record what was verified and what remains open. A prepared worksheet should not be described as a submitted return, and a submitted return should not be described as an accepted deduction without the relevant evidence.
For technical assistance, use KRA's current eTIMS support page to select the appropriate channel. Share the minimum information needed for the authenticated enquiry. Retain the response and its reference so another reviewer can understand the resolution.
Frequently asked questions
Can one credit note correct several original invoices?
KRA's electronic-invoice FAQs require the original invoice reference and say several invoices cannot be referenced in one credit note. Keep each invoice relationship separately identifiable.
Can I issue the credit note from a different eTIMS solution?
KRA's current solution guidance says the credit note must come from the solution that issued the original invoice. Identify the issuing solution before starting the correction.
Does issuing the credit note complete VAT reconciliation?
No. Compare the final document with the original invoice, accounting records and relevant return evidence. Keep the commercial settlement and the tax filing review separately documented.
Can AfroTools submit the correction to KRA?
No. The linked calculator checks planning arithmetic. It does not issue or transmit an eTIMS document, amend a return or certify a deduction.
Primary sources checked October 11, 2026
The nine KRA references linked above cover VAT, electronic-invoice rules, current solution selection and tutorials, the auto-populated return, input-tax eligibility, technical support, the 2024 manual and the January 2025 bulletin. Older manuals support only the identified workflow context. Consult current KRA guidance and the applicable law for a disputed treatment or exceptional date position.