eTIMS

eTIMS VSCU Installation in Kenya: What It Is and How to Approach It (2026)

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

eTIMS VSCU installation is a question for any Kenyan business or developer connecting their own systems to KRA eTIMS. The VSCU (Virtual Sales Control Unit) is KRA's software-based control unit for system-to-system eTIMS integration, suited to higher volumes and environments where a virtual unit fits better than the online OSCU. Installation and certification follow KRA's process, so scope it against KRA's documentation and an integrator. 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 VSCU is KRA's software-based control unit for system-to-system integration
  • It often suits higher volumes and virtual environments, versus the online OSCU
  • Installation is a technical, certified integration, not a one-click app install
  • Compliant software removes the need to install a control unit yourself
On this page
  1. What the VSCU is and when it fits
  2. How to approach it
  3. What to check before you build
  4. A high-volume business installs a VSCU
  5. When you can skip the integration
  6. Frequently asked questions

What the VSCU is and when it fits

KRA provides control units that sit between a business system and eTIMS. The VSCU, or Virtual Sales Control Unit, is the software-based control unit used for system-to-system integration, often suited to higher transaction volumes and to setups where a virtual, software unit fits the architecture better than the online OSCU.

Installing a VSCU is a technical integration task, not a one-click app install: it involves setting up the unit per KRA's specification, connecting your system to it, and following KRA's certification and testing process so invoices transmit and validate. Because the exact installation, requirements and certification depend on KRA's current process and your environment, scope it against KRA's official documentation and a qualified integrator. For many businesses, compliant software removes the need to install a control unit yourself.

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 VSCU is the right control unit

    Decide between VSCU and OSCU based on your volume, connectivity and architecture, per KRA's requirements.

  2. 2

    Scope installation against KRA's process

    Get KRA's current VSCU installation and certification requirements and plan the setup with a qualified integrator.

  3. 3

    Connect your system and map data

    Connect your business system to the VSCU 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

Treating it as a simple app install

A VSCU is a technical integration with certification, not a one-click install. Scope it properly.

Choosing VSCU or OSCU without assessing fit

The right control unit depends on your volume and connectivity. Assess fit against KRA's requirements rather than defaulting.

Skipping certification and testing

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

A high-volume business installs a VSCU

Worked example

A high-volume business in Nairobi assessed that a VSCU suited its architecture better than the online OSCU.

Working with an integrator, they scoped the installation against KRA's requirements, connected their system to the VSCU, mapped invoice data correctly, and followed KRA's certification and testing.

With the VSCU certified and tested, their invoices transmitted and validated reliably at volume, where a smaller business in their group simply used compliant software instead.

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 VSCU?
The Virtual Sales Control Unit, KRA's software-based control unit for system-to-system eTIMS integration, often suited to higher volumes and to environments where a virtual unit fits better than the online OSCU.
How do I install a VSCU?
It is a technical integration: set up 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.
VSCU or OSCU, which should I use?
It depends on your volume, connectivity and architecture. Both are KRA control units; assess fit against KRA's requirements rather than defaulting to one.
Do I need a VSCU if I use compliant software?
No. Compliant software like Veira handles eTIMS for you, so most businesses do not install 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 VSCU installation 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