KRA eTIMS Filing
File customer invoices and POS sales to KRA's eTIMS automatically as they are issued, and reverse them properly when a document is cancelled, credited or refunded.
If your organization is registered for Kenya's electronic tax invoice system, AWRA can file each taxable sale to eTIMS as part of normal work rather than as a separate end-of-day chore. Setup lives under Settings → Connectors → eTIMS.
Connecting
- Enter your PIN (TIN), branch ID and device details as issued by KRA.
- Initialize the device. This is the handshake that registers you with eTIMS; it is done once.
- Test the connection before you rely on it.
- Switch auto-file on when you are ready for live filing.
You can disconnect at any time. Disconnecting stops future filing; it does not un-file anything already accepted by KRA.
What Gets Filed, And When
Filing happens when an invoice is issued — not when it is created, and not when it is paid. A draft invoice files nothing. Once it moves to an issued state (approved, confirmed, sent, partially paid, paid, overdue or posted) it is filed. Payment is irrelevant: an approved unpaid invoice is still a taxable supply and is correctly filed.
The rule is deliberately a list of known issued states rather than "anything that isn't a draft", so an unusual or new status is not filed by accident. POS sales are different only in timing: a sale, its totals and its payment are recorded together, so an incomplete sale never files at all.
There is also a manual File to eTIMS action on a customer invoice and on a POS sale, for anything that needs to be sent by hand.
Reversals: Undoing In AWRA Is Not Undoing At KRA
Once a document is filed, cancelling it in AWRA changes nothing at KRA by itself. A reversal has to be filed. Three events raise one automatically:
- Cancelling a filed invoice.
- A POS return — reversed line by line, so a partial refund reverses partially.
- Applying a credit note to an invoice.
A reversal is recorded even when the connector cannot reach KRA — the obligation exists either way — and unsent reversals are retried on a schedule until they succeed. That is the safe behaviour: a reversal that quietly failed would leave you having declared tax on a sale you refunded.
Invoice Numbers
Filed documents draw their eTIMS invoice number from a single sequence for your organization, not from the record's own ID — otherwise a customer invoice and a POS sale could file under the same number. The allocated number is stored on the record, so a retry re-sends the same number rather than consuming a new one.
How Filings Are Shaped — Check These Against Your Obligations
- A customer’s KRA PIN makes the filing business-to-business. Invoices, POS sales and credit notes for a customer with a KRA PIN in their VAT & Tax Settings are filed with it as the buyer PIN, so the buyer can claim the input VAT and sees the purchase in iTax. With no PIN on file — or a walk-in sale with no customer — the document is a consumer sale.
- A malformed PIN is left off, not sent. KRA rejects a whole document with an invalid buyer PIN, so a PIN that is not one letter (A or P), nine digits and a letter files as a consumer sale instead. Correct the PIN on the customer and the next documents file as B2B.
- Item classification uses one general code for every line, rather than a KRA classification code per item.
- VAT-rated and zero-rated supplies are mapped. Exempt supplies are outside the current mapping.
- A sales credit note reverses as a single line, because a credit note holds an amount rather than itemised lines.
If any of these matter for your filing position, review them with your tax adviser before switching auto-file on. For connection failures, see Failed Sync; for the wider connector list, see Connectors Directory.
eTIMS covers what you sell. Tax you deduct from suppliers, or that customers deduct from what they pay you, is handled under Withholding Tax.
Need help with this topic?
Capture the module, record number, branch or warehouse, user, visible message, and what you expected to happen before contacting support.