eTIMS OSCU Setup in Kenya: What It Is and How to Approach It (2026)

The OSCU, or Online Sales Control Unit, is one of KRA's control units for connecting a business system to eTIMS. As the name suggests, it is oriented to online operation, transmitting to KRA over a connection, and suits environments with reliable connectivity where invoices are sent to KRA online.

Setting up an OSCU is a technical integration: configuring the unit per KRA's specification, connecting your system, and following KRA's certification and testing so invoices transmit and validate. The choice between OSCU and the software-based VSCU depends on your volume, connectivity and architecture. Because the exact setup and certification depend on KRA's current process, scope it against KRA's official documentation and a qualified integrator, and remember that compliant software removes the need to set up a control unit at all.

Setup is tied to the device, which is the fact that governs everything else here. Replacing hardware is therefore not a copy-and-paste exercise: the new device goes through registration rather than inheriting the old one’s identity, and attempts to shortcut that are what produce device-not-registered errors later.

Plan replacement while the old device still works. Registering the new one before the old is out of service means you are choosing your moment rather than reacting, and it keeps a working till available if the new setup needs a second attempt.

A practical path. Confirm exact technical details against KRA's official documentation.

1. 1

   Confirm OSCU suits your connectivity

   The OSCU is online-oriented. Confirm it fits your connectivity and architecture versus the VSCU, per KRA's requirements.

2. 2

   Scope setup against KRA's process

   Get KRA's current OSCU setup and certification requirements and plan with a qualified integrator.

3. 3

   Connect and map your invoice data

   Connect your system to the OSCU and map invoice data with correct tax treatment and buyer PINs.

4. 4

   Certify and test before go-live

   Follow KRA's certification, validate in the sandbox, and confirm invoices transmit and validate before going live.

5. 5

   Register a replacement before retiring the old device

   Set the new one up while the old one is still functioning, so you always have a working till and can choose when to switch.

6. 6

   Do not clone or copy a setup between devices

   Copying files across to skip registration is what causes device-not-registered errors. Follow the registration route for each device.

The biggest decision here is whether you need to build an integration at all. Veira is already a compliant eTIMS system: it issues compliant KRA invoices automatically, applies the right tax treatment, captures the buyer PIN, transmits to KRA, and works offline. For many businesses that removes the need to build, certify and maintain a custom integration yourself.

If you do run an ERP or a custom stack, weigh the cost of building and maintaining an integration against running point of sale and invoicing on Veira and reconciling. Veira runs from KES 2,999 a month, terminal included on annual billing and a 30-day money-back guarantee. See how Veira works, or book a free demo to talk through your setup.