In 2024, Kenya Revenue Authority (KRA) collected KES 2.407 trillion shillings up from KES 2.166 trillion shillings in 2022/2023 financial year. This marks a 11.1% growth following a thorough revenue collection mobilization and compliance enforcement measures implemented recently including an eTIMS API that allows merchants to integrate their systems with eTims.
eTIMS Online Sales Control Unit Onboarding
KRA offers a Sandbox environment where taxpayers can quickly test their integrations. To sign up for access on the etims taxpayer sandbox
portal, follow these steps:
1) Access the eTIMS taxpayer sandbox portal on the following URL address: https://etims-sbx.kra.go.ke
2) Select the Sign Up option.
eTims Sign Up
3) Select PIN option and complete the Sign Up form: You will enter the PIN of the company. Verify that the masked phone number value displayed is correct and can be accessed as the One Time Password (OTP) message will be sent to this number. In case it is incorrect, write to [email protected] for the correct phone number to be updated. Enter and confirm the Password to be used for the taxpayer sandbox portal
access.
4) Register for OSCU or VSCU device: Upon successful sign up, access the eTIMS taxpayer sandbox portal using your credentials (KRA PIN and Password). Select eTIMS button on the dialog box presented.
5) Complete the Service Request form
Approval
Once your account is approved, the credentials are ready to be used.
KRA eTims Integration SDKs
There is a comprehensive Node.js SDK authored by Shadrack Matata for integrating systems with the Kenya Revenue Authority eTims. The SDK can be downloaded from Github or Node Package Manager.
This KRA eTims SDK offers the following features:
- Complete KRA eTims API integration
- Express.js server mode for easy API endpoint exposure
- CORS support with domain whitelisting
- Comprehensive validation for all API requests
- Detailed logging and error handling
- Environment-based configuration
- TypeScript support
KRA eTims WordPress/Woocommerce Plugin
This is a WordPress plugin that integrates WooCommerce Online Sales with the KRA Electronic Tax Register (ETR) System. This plugin allows WooCommerce store owners to automatically submit sales transactions to the KRA ETR system when orders are completed and generate ETR-compliant receipts.
It provides a seamless integration between your WordPress WooCommerce store and the KRA ETR API, ensuring compliance with KRA’s electronic tax invoice requirements for online sales.
When an order is marked as “Completed” in WooCommerce, the plugin will automatically submit the sales transaction to KRA ETR if the “Auto Submit” option is enabled. This works with both manual order completion and automatic completion through payment gateways like PayPal or M-Pesa.
The latest version of kra-etims-woocommerce can be downloaded here. Tulipe ushuru, tujitegemee!