What does eTIMS mean for my software startup?
By Bonaventure Ogeto, Founder and CEO, Mctaba Labs
Published
eTIMS is the Kenya Revenue Authority's electronic invoicing system, and KRA says every person in business must use it, VAT registered or not. For a software startup it means each sale needs an invoice sent through eTIMS. With a handful of invoices you can issue them by hand. Automated billing should connect to eTIMS directly.
It usually arrives as an email from a customer's accountant. Your first proper business client has agreed a price, your product is running in their office, and the payment is held up by one line: "Kindly share an eTIMS invoice so we can process this."
A PDF from a spreadsheet will not do. If you have never set up eTIMS, that sale now waits on you. This guide explains what the system is, what it asks of a company that sells software, and what your product should handle so the accountant's email never slows a deal again.
This is general information, not tax advice. Tax rules in Kenya change often, so confirm your own position with an accountant and on the Kenya Revenue Authority's website.
What is eTIMS?
eTIMS stands for electronic Tax Invoice Management System. KRA describes it as a software solution that gives taxpayers options for electronic invoicing, usable on a computer, tablet or phone.
The idea is simple. An invoice is created through, or transmitted to, KRA's system, so the authority has a record of the sale. KRA's onboarding guidelines trace the requirement to section 23A of the Tax Procedures Act, which requires every person in business to record each sale and to issue and transmit invoices through the electronic system the Commissioner prescribes.
For you, eTIMS is not a tax. It is the required way of issuing invoices.
Does my software startup have to use it?
Yes, if you are in business. KRA's page puts it without qualification: all persons engaged in business are required to onboard eTIMS and issue electronic tax invoices. It names companies, partnerships and sole proprietorships, and says the rule applies whether or not the business is registered for VAT.
Selling software, subscriptions or development services is a supply like any other, so a startup with paying customers is covered.
KRA's pages note one arrangement for very small sellers. Where a supply comes from a small business whose annual turnover does not exceed five million shillings, the purchaser issues the tax invoice on the seller's behalf, using a tool KRA calls Buyer Initiated Invoicing. KRA's guide to that tool, as it read on 19 November 2026, says the seller approves or rejects each invoice within 30 days, and that it cannot be used for sellers registered for VAT. Do not build your plans on your customers doing this for you. A company buying software wants to receive an invoice, not to raise one for its supplier, and the same KRA page still says all persons in business must onboard.
Why do my business customers insist on it?
Because without your eTIMS invoice they cannot claim what they paid you.
KRA states that for any person to claim a business expense, the expense must be supported by an electronic tax invoice, and gives 1 January 2024 as the date from which that applies. Its FAQ adds that failing to issue compliant invoices denies your customers the ability to claim the expense on their income tax return, and to claim input VAT if they are registered for VAT.
Put yourself in the finance manager's chair. A supplier who cannot produce an eTIMS invoice makes the purchase more expensive after tax. Between two similar products, a finance manager will lean to the one with a proper invoice. For a startup selling to businesses, eTIMS is a sales requirement as much as a compliance one.
Which eTIMS option fits a company selling software?
KRA offers several ways to issue invoices and lets you register on more than one. For a software company, three matter.
| Option | What it is, in KRA's words | Fits you when |
|---|---|---|
| Online Portal | A web-based platform for invoicing at etims.kra.go.ke, tailored to the service sector, where no goods are supplied | You supply services only and issue a few invoices by hand each month |
| eTIMS Lite | Simplified web, USSD and mobile app options, made for small and micro taxpayers not registered for VAT | You are very small, not VAT registered, and invoice now and then |
| System to system integration | A connection between your own invoicing system and eTIMS through an API, using OSCU or VSCU | Your product bills customers automatically, or you issue many invoices |
There is also the eTIMS Client, a downloadable program that KRA aims at businesses dealing in goods, or goods and services, with branches and cashier tills. Few pure software companies need it.
Here is how the choice plays out, with made-up numbers.
Stage one. You have six business customers on annual contracts. That is six invoices a year plus the odd extra. Someone logs in to the online portal, types each invoice and emails the result. It costs nothing and takes a few minutes. KRA's 2024 onboarding guidelines set the portal's criteria as supplying services only and issuing not more than 10 invoices a month, so check the current criteria when you register.
Stage two. You launch a self-service plan at KES 2,000 a month and 300 customers sign up. That is 300 invoices every month, raised the moment each card or M-Pesa payment succeeds. Nobody can type those. Your billing system has to send each one to eTIMS by itself, which is system to system integration.
Most startups begin at stage one and should plan for stage two before they launch self-service billing, not after.
What does system to system integration involve?
Your software sends invoice data to KRA through an interface KRA provides, and receives back what it needs to produce a valid invoice. KRA offers two forms:
- OSCU, the Online Sales Control Unit. KRA says it suits taxpayers whose invoicing is always online. A web-based subscription product fits that description.
- VSCU, the Virtual Sales Control Unit. KRA says it suits bulk invoicing and systems that are not always online. Its FAQ confirms VSCU can keep invoicing through internet downtime and transmit later.
You cannot simply switch this on. KRA describes a process of development, testing, vetting and certification, and gives you two ways through it. You can self-integrate, which means your own developers build against KRA's specifications in its sandbox test environment and take the system through certification. Or you can engage a KRA-verified third-party integrator who has already been certified. KRA publishes the OSCU and VSCU specification documents and a step by step guide to registering in the sandbox on its integration page.
My verdict: with one product and a capable developer, self-integration is worth it, because invoicing sits at the centre of your billing and you will want to control it. If eTIMS is holding up revenue this month, use an integrator now and revisit later. KRA allows more than one solution at a time, so the online portal can cover a single urgent invoice while the integration is down, and the queue described below covers the rest.
For a plain description of what an integration project covers, see eTIMS integration. If your customers are shops or restaurants, eTIMS integration for restaurants and shops covers the point-of-sale side.
What should we build into the product?
Give this list to whoever is building your billing. Each item comes from something KRA's pages say about how eTIMS behaves.
- Capture the customer's KRA PIN at sign-up. Business customers want the invoice in their name and PIN so they can claim the expense. KRA's own validation rules describe a PIN as 11 characters, starting with A for an individual or P for a company, then nine digits and a final letter. Check the format when the customer types it.
- Raise the invoice when the money is confirmed. Tie invoice creation to a confirmed payment or to the billing date, not to a staff member remembering.
- Never edit or delete an issued invoice. Corrections are made with a credit note. KRA says a credit note can only be generated from the solution where the original invoice was raised, so refunds and downgrades must flow through the same integration.
- Keep one invoice sequence per solution. KRA says each solution has its own unique invoice number sequence. If you use the portal and an integration together, your records should say which one issued each invoice.
- Show the QR code. KRA tells buyers to verify an invoice by scanning its QR code. Put it on the PDF and on the invoice page in the customer's account.
- Plan for failure. OSCU needs a stable connection. Decide what the customer sees if eTIMS does not answer: the payment stands, the invoice is queued and sent as soon as the system responds, and someone on your team is alerted.
- Let customers fetch their own invoices. A page listing every invoice saves you the monthly email from each accountant.
One question to take to your accountant, because the KRA pages cited here do not settle it for software specifically: how to invoice customers outside Kenya, and how VAT applies to what you sell.
What if my product is a marketplace, or invoices for other businesses?
Then eTIMS is part of your product, not just your back office.
If you run a platform where many small sellers earn through you, look at what KRA calls Reverse Invoicing. A large buyer generates invoices on behalf of small sellers through its own billing system, connected to eTIMS by system to system integration. KRA's page uses a ride-hailing platform as an example: after a trip, the platform issues a commission invoice to the driver for its service fee. The buyer must be approved by KRA through a know-your-customer process and must obtain each seller's consent.
If you are building invoicing, point-of-sale or accounting software for other businesses, your customers will expect it to issue eTIMS invoices for them. That means following KRA's route for third-party integrators: development, testing, vetting and certification. Put that work in your first plan and your first budget. A billing tool that cannot produce an eTIMS invoice is hard to sell to a Kenyan business.
Key takeaways
- KRA says all persons in business must be on eTIMS and issue electronic tax invoices, whether or not they are registered for VAT.
- Business customers need your eTIMS invoice to claim what they paid you as an expense, so they will ask for it.
- A services-only startup with few invoices can begin on the free online portal and issue invoices by hand.
- Automated subscription billing calls for system to system integration through OSCU or VSCU.
- Collect each business customer's KRA PIN at sign-up and design for credit notes, not deleted invoices.
- The eTIMS software is free. Integration costs money only if you hire a third-party integrator.
Frequently asked questions
- Is eTIMS only for businesses registered for VAT?
- No. KRA's eTIMS pages say persons in business must onboard whether or not they are registered for VAT, and they list companies, partnerships and sole proprietorships among those covered. VAT registration changes which eTIMS options are open to you, not whether you need one.
- How much does eTIMS cost?
- KRA says the eTIMS software is free of charge, including the online portal and the eTIMS Client. It adds that businesses connecting their own invoicing system to eTIMS may incur costs if they use one of the approved third-party integrators. Your own development time is the other cost.
- Can I use two eTIMS solutions at once?
- Yes. KRA says taxpayers can register on more than one eTIMS solution and see all their invoices on the online taxpayer portal. Each solution keeps its own invoice number sequence, and a credit note can only be raised from the solution that issued the original invoice.
- What happens if the internet goes down while I am invoicing?
- It depends on the solution. KRA says the online portal, the eCitizen option and OSCU need a stable internet connection. The eTIMS Client and VSCU can keep invoicing during downtime and transmit the invoices once the connection returns.
- How does a customer check that my invoice is genuine?
- KRA gives two ways. The customer can scan the QR code printed on the invoice, or enter the invoice number in the invoice number checker on the iTax portal. Make sure the QR code survives on whatever you send, whether a PDF, an email or a printout.
Sources
- What is eTIMS?, Kenya Revenue Authority. Checked on 19 November 2026.
- Types of eTIMS Solutions, Kenya Revenue Authority. Checked on 19 November 2026.
- eTIMS System to System Integration, Kenya Revenue Authority. Checked on 19 November 2026.
- How to Onboard on eTIMS, Kenya Revenue Authority. Checked on 19 November 2026.
- Learn about eTIMS (frequently asked questions), Kenya Revenue Authority. Checked on 19 November 2026.
- Guidelines to Taxpayers on eTIMS Onboarding (2024), Kenya Revenue Authority. Checked on 19 November 2026.
- Reverse Invoicing, Kenya Revenue Authority. Checked on 19 November 2026.
- Buyer Initiated Invoicing, Kenya Revenue Authority. Checked on 19 November 2026.
