AWRA Help Center

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

1. Enter your PIN (TIN), branch ID and device details as issued by KRA.
2. Initialize the device. This is the handshake that registers you with eTIMS; it is done once.
3. Test the connection before you rely on it.
4. 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.

Known Limits — Check These Against Your Obligations

• Filings are B2C. A customer PIN is not sent, so filings are not attributed to a buyer's tax number.
• Item classification is a general fallback rather than a per-item KRA classification code.
• Tax categories covered are VAT and zero-rated. Exempt supplies are not mapped.
• 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.