How to set up KRA eTIMS¶
Who can do this: The company owner or a full-access administrator · Available on: Mobile · Web
Preview: this setup flow saves your details on this device but doesn't connect to KRA yet. It isn't available in the released app yet.
eTIMS is KRA's electronic invoicing system. Once it's set up, Seroly sends your sales to KRA, and receipts show the control unit number, signature and a QR code customers can scan.
Before you start¶
- Have your KRA PIN ready.
- Have the phone registered on iTax nearby, because KRA texts your sign-up code to it.
- Set aside about 20 minutes. After that, a KRA officer has to approve your request, which usually takes a few working days.
Steps¶
- Go to Settings → Payments & tax → KRA eTIMS, then tap Get started.
- Your tax profile: enter your KRA PIN, the name registered with KRA, whether you're VAT-registered, and your iTax phone.
- How you connect to KRA:
- Choose Seroly connects for me (recommended).
- Or choose I already use an integrator and enter your DIGITAX or BVSCU API key and gateway URL.
- Register with KRA: follow the four steps on the eTIMS portal and tick each one off.
- Sign up at etims.kra.go.ke with your PIN.
- Submit a service request. Choose OSCU, name the integrator shown, and enter the device serial for each branch. Tap a value to copy it.
- Attach the signed eTIMS commitment form.
- Tick KRA has approved your request when KRA emails you. You can finish the setup before this.
- Your branches: check each branch's KRA branch ID. The head office is 00, then 01, 02 and so on. If a branch used another eTIMS system before, enter its last invoice number.
- Product codes: tap Add missing codes. Select products, choose the tax type, packaging, quantity unit and 10-digit item class code, then tap Apply. You can also do this after activating. Choose whether to ask for the customer's KRA PIN at checkout.
- Review and activate: check your details and the receipt preview, then tap Activate eTIMS.
What happens next¶
- The status page shows Submitted → KRA approval → Device activation → Test invoice → Live, and a status for each branch.
- When it shows Action needed, tap Send a test invoice. eTIMS then goes Live.
- From the status page you can manage product codes or turn eTIMS off.