KRA eTIMS integration service
We bring eTIMS to your system.
Already running a POS, ERP, or billing system? Advatech Group integrates KRA eTIMS fiscalization into your existing platform, on any stack.
We built eTIMS into AdvaPOS and AdvaERP. Now we offer the same work as a standalone integration service for third-party systems.
Fiscalization sequence
Your business
Tax invoice
Control unit invoice no.
Control unit serial no.
Sample document.
Not real data.
What is KRA eTIMS
Every sale is registered with KRA.
KRA requires taxpayers carrying on business, VAT-registered or not, to issue invoices through eTIMS. Sales, credit notes, and purchase documents are registered through a KRA-approved VSCU.
If your system does not yet have eTIMS wired in, we can add it to your platform without a rebuild.
We integrate with any modern backend stack
VSCU implementation and maintenance included
Sandbox testing before production go-live
Offline queue and retry logic built in
Sale, credit note, and reverse invoice documents
Ongoing support and KRA compliance monitoring
What we deliver
A complete eTIMS integration. Every edge case covered.
- 01VSCUFiscal receipt
Invoice fiscalization
We wire VSCU invoice submission into your checkout or billing flow. Every transaction is registered with KRA before the receipt reaches the customer.
- 02Fiscal invoiceRegisteredCredit noteLinked
Credit note fiscalization
Refunds and adjustments generate KRA-signed credit notes with full links back to the originating fiscal invoice, processed automatically.
- 03on reconnect
Offline queue and retry
Transactions queue locally when connectivity drops. The integration retries the backlog automatically on reconnection, without data loss or manual intervention.
- 04
Printed or digital
Checkable by customers and auditors
QR code generation
KRA-standard QR codes on every printed or digital receipt, so customers and auditors can verify authenticity independently.
- 05Raw VSCU error codeA plain-language message for your users
KRA error mapping
VSCU error codes translated into plain-language messages your interface can show, so raw API errors never reach your users.
- 06VSCU healthStatus endpointQueue depthStatus endpointLast syncStatus endpoint
Real-time monitoring
Status endpoints and webhook callbacks so your system can surface VSCU health, queue depth, and last sync time to your operations team.
Why it matters
eTIMS is a requirement, not an option.
A summary of the rules as reported by EY. It is not tax advice, so confirm your position with your tax adviser or KRA.
Source: EY tax alert on e-TIMSWho is covered
All taxpayers carrying on business
This includes taxpayers who are not registered for VAT. Certain payments are exempt, and the Commissioner can grant other exemptions by Gazette notice.
1 June 2023
Input VAT needs an eTIMS invoice
Input VAT claims are allowed only against invoices generated through TIMS or eTIMS.
1 January 2024
Expenses without an eTIMS invoice
Expenses not generated through TIMS or eTIMS become non-deductible for income tax purposes.
Reverse invoicing included
When your suppliers do not issue ETRs, we can wire reverse invoicing directly into your procurement or purchase order flow. Issue buyer-side purchase documents and maintain your VAT chain.
- 1
Supplier issues no ETR
- 2
Purchase order raised
- 3
Buyer issues the purchase document
- 4
Approval workflow
- 5
Document hash and full audit history
Works with your existing stack
- Node.js
- Python
- PHP
- Java
- .NET
- Go
- REST APIs
- GraphQL
- Webhooks
- Any ERP or POS
Do not see your stack? If it has an HTTP layer, we can integrate it.
How we work
- 01
Discovery call
We review your existing system architecture, transaction flows, and KRA PIN setup.
- 02
Integration design
We propose the VSCU wiring points, queue architecture, and error handling strategy specific to your stack.
- 03
Build and test
We implement, unit test, and integration test against the KRA VSCU sandbox before any production traffic.
- 04
Go live
We deploy with you, monitor the first live transactions, and hand over documentation and runbooks.
Ready to add eTIMS to your system?
Tell us about your existing system and we will scope what the integration involves.
Looking for a ready-to-use POS instead? See the AdvaPOS platform.