Setup
Connect Xetuu to Kenya Revenue Authority eTIMS in three steps.
Early access. KRA eTIMS can be installed from the App Store, but it is still being proven in real use, so this screen may change.
Overview
Step 1 connects to KRA: enter your KRA PIN, branch, device serial and environment, then Test & activate. The communication key is stored encrypted. Step 2 maps your taxes to KRA tax classes A to E and your sellable products to item codes in one click, and marks anything it had to guess for review. Step 3 switches on sending every posted invoice to KRA. A posted invoice is sent in the background; if KRA cannot be reached the invoice still posts and is retried. Credit notes are sent as refunds that refer to the original invoice, which must already have been accepted.
The module was written from the OSCU specification and tested against a simulated KRA service. Run it against the KRA sandbox with your own PIN and device before you rely on it. Default product classification codes are placeholders for you to confirm, stock sync and POS submission are not built, and the quantity and packaging unit pickers are not in the screen yet.
When to use setup
- You must issue KRA-validated invoices.
Step by step
Screenshot for this step has not been captured yet — run npm run docs:flow.
What you see on the screen
- The screen says: “Three steps. After this, invoices are sent to KRA automatically.”
- The screen says: “One click maps your taxes to KRA tax classes and gives every sellable product a KRA item code. Anything we had to guess is listed below for you to confirm.”
- Actions on the screen: Test & activate, Auto-map everything.
Permissions
These permission keys control access (granted to roles in Administration → Roles & Permissions):
- etims.config.read
- etims.config.update