eTIMS

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

K By Kev 23 June 2026 8 min read
Share
eTIMS guide

eTIMS OSCU setup is a question for any Kenyan business or developer connecting their own systems to KRA eTIMS. The OSCU (Online Sales Control Unit) is KRA's online control unit for system-to-system eTIMS integration, suited to setups with reliable connectivity that transmit to KRA online. Setup and certification follow KRA's process, so scope it against KRA's documentation and an integrator, or use compliant software instead. This guide explains the concepts and the practical approach, what to confirm in KRA's official documentation, and when you can skip the build entirely with compliant software. Technical specifics change, so treat KRA's official eTIMS documentation as the source of truth.

Key takeaways
  • The OSCU is KRA's online control unit for system-to-system integration
  • It suits reliable-connectivity setups that transmit to KRA online, versus the software VSCU
  • Setup is a certified technical integration scoped against KRA's documentation
  • Compliant software removes the need to set up a control unit at all
On this page
  1. What the OSCU is and when it fits
  2. How to approach it
  3. What to check before you build
  4. A business with stable connectivity chooses OSCU
  5. When you can skip the integration
  6. Frequently asked questions

What the OSCU is and when it fits

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.

The cheapest eTIMS integration is often the one you do not have to build, certify and maintain yourself.

How to approach it

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.

What to check before you build

Choosing OSCU without assessing connectivity

The OSCU is online-oriented. If your connectivity is unreliable, assess whether the VSCU fits better.

Treating setup as a quick install

OSCU setup is a certified technical integration. Scope it properly rather than expecting a one-click install.

Skipping certification and testing

Follow KRA's certification and test in the sandbox so problems surface safely before go-live.

A business with stable connectivity chooses OSCU

Worked example

A business in Nairobi with reliable connectivity assessed that the online OSCU suited its setup well.

They scoped the setup against KRA's requirements with an integrator, connected their system to the OSCU, mapped invoice data correctly, and followed KRA's certification and testing.

With the OSCU certified and tested, invoices transmitted and validated reliably online, while a sister branch with patchier connectivity considered the VSCU, and a smaller outlet simply used compliant software.

Business impact

Trading without eTIMS-compliant tax invoices risks KRA penalties, blocked VAT input claims for your customers, and receipts a business buyer cannot expense.

Veira signs every sale to KRA eTIMS automatically, so each receipt is compliant the moment it prints, with no separate device to reconcile.

When you can skip the integration

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 with a free terminal and a 30-day money-back guarantee. See how Veira works, or book a free demo to talk through your setup.

Frequently asked questions

What is the eTIMS OSCU?
The Online Sales Control Unit, KRA's online control unit for system-to-system eTIMS integration, suited to environments with reliable connectivity that transmit invoices to KRA online.
How do I set up an OSCU?
Configure the unit per KRA's specification, connect your system, map invoice data, and follow KRA's certification and testing. Scope it against KRA's documentation and a qualified integrator.
What is the difference between OSCU and VSCU?
The OSCU is online-oriented; the VSCU is software-based and often suits higher volumes or virtual environments. Choose based on your connectivity, volume and architecture, per KRA's requirements.
Do I need an OSCU if I use compliant software?
No. Compliant software like Veira handles eTIMS for you, so most businesses do not set up a control unit themselves.
Do I have to build my own eTIMS integration?
No. Compliant software like Veira already issues and transmits compliant eTIMS invoices, so many businesses do not need to build, certify and maintain a custom integration. Build only if your stack genuinely requires it.
Where is the authoritative eTIMS technical spec?
KRA's official eTIMS API documentation is the source of truth for endpoints, payloads, control units and requirements. Specifics change, so build against the current official documentation, not third-party summaries.

eTIMS OSCU setup comes down to the concepts above plus KRA's official documentation for the exact details, and for many businesses the simplest path is compliant software that handles it for you. See how Veira works, or book a free demo. Always build against KRA's current official eTIMS documentation.

For more eTIMS guides and compliance resources, visit our free resource site.

Terms explained

Keep reading

See all eTIMS guides

Veira for your business

Browse Veira by business type