How to Integrate KRA eTims API with In-house ERPs and Third-party Software
KRA eTims API integration is now critical for businesses in Kenya to stay compliant with tax regulations. In 2024, the Kenya Revenue Authority (KRA) collected a record KES 2.407 trillion, driven in part by digital tax enforcement via eTIMS (Electronic Tax Invoice Management System).
Whether you’re a developer, ERP vendor, or online store owner, here’s how to integrate your systems with KRA eTims using official tools and community-driven SDKs.
🔐 Step-by-Step: eTIMS Online Sales Control Unit (OSCU) Onboarding
KRA provides a sandbox environment to help developers test their eTIMS integrations safely. Here’s how to get started:
1. Access the Sandbox Portal
Visit: https://etims-sbx.kra.go.ke
2. Sign Up
Choose the PIN option, and fill in your KRA PIN, verify the OTP sent to the masked phone number, and set your password.
If the number is incorrect, email: [email protected]
3. Register Your OSCU or VSCU Device
Log in to the portal using your new credentials. Select the eTIMS option and proceed with the Service Request form.
4. Await Approval
Once approved, your integration credentials will be active and ready for use.
⚙️ Using the Official KRA eTims Node.js SDK
A robust Node.js SDK authored by Shadrack Matata simplifies integration for back-end developers.
🔑 Key Features:
- Full support for KRA eTims API
- Built-in Express.js server setup
- CORS whitelisting for secure access
- Input validation and error logging
- Environment-based configuration
- TypeScript ready
📦 Install via NPM:
bashCopyEditnpm install kra-etims-sdk
📁 Source code: GitHub – KRA eTims SDK
🛒 KRA eTims WooCommerce Plugin for WordPress
For online retailers, the KRA eTims WooCommerce plugin automates tax reporting:
✅ Features:
- Auto-submission of completed orders to KRA
- Seamless support for M-Pesa, PayPal, card payments
- ETR-compliant receipt generation
- Works with manual or auto order completions
📥 Download Plugin: kra-etims-woocommerce latest version
Tulipe ushuru, tujitegemee! — Let’s pay our taxes and build our nation.
✅ Final Thoughts
KRA eTims API integration bridges compliance and digital innovation. Whether you’re operating a custom ERP, building on Node.js, or running a WooCommerce store, Kenya’s eTims tools and SDKs make tax reporting efficient and accurate.
Ready to integrate? Start testing in the sandbox, deploy using the Node SDK or WooCommerce plugin, and stay ahead of compliance needs.
