Introduction

This module serves as a comprehensive tax integration solution, specifically designed to seamlessly connect Odoo with the Electronic Tax Invoice Management System (eTIMS) as mandated by the Kenya Revenue Authority (KRA). As an approved module, it ensures that your Odoo installation is fully compliant with KRA's taxation requirements, facilitating accurate and real-time tax reporting directly from your ERP system.

Disclaimer

Compatibility

Please note that this module does not offer out-of-the-box compatibility with the existing Branch Management functionality within Odoo. However, understanding the critical need for this integration in multi-branch operations, we provide a placeholder for Branch Management. To address this, we offer a complimentary customization service, which is designed to be quick and efficient, typically requiring no more than an hour to implement.

Support

We are committed to ensuring the reliability and efficiency of the Approved KRA Integrator module. To this end, we guarantee free of charge support for any API changes that may occur in the near future, as well as for any bugs that may arise as a result of this installation. It is our goal to ensure your continued compliance and operational efficiency without additional costs for these updates. Please note, however, that further customizations requested outside the current functionality of the module will be subject to charges.

Legal Agreement

By purchasing this module, you (the purchaser) are legally bound to an agreement not to redistribute, share, or replicate this module either in part or in whole. This agreement is intended to protect the intellectual property contained within the module and ensure the sustainability of development efforts. Violation of this agreement may result in legal action

Installation and Configuration

To successfully install and configure the Approved KRA Integrator module, please follow the instructions below. This module requires the existence of branches within your Odoo installation, as it operates with multi-branch functionality. Ensure you have your branches set up, either using the dependent multi-branch module or through your custom solution, before proceeding with these steps.

1. Make sure to contact the author of the module before attempting to initialize the module, Some instructions will be privately shared with you to assure a smooth installation of the module
2. Ensure that the Multi Branch Operations module is installed and properly configured within your Odoo installation. Your branches must be created and set up in accordance with your organization's structure.
3. Once the module is installed, navigate to the eTIMS configuration section. Here, you will need to fill in the credentials provided by the Kenya Revenue Authority (KRA).
4. For each branch, select the appropriate branch from the dropdown to associate the provided credentials with the correct branch. This step is crucial for multi-branch systems to ensure accurate data reporting to KRA.
5. Avoid checking the "Test" checkbox unless you are intending to use the sandbox URL for testing purposes. The Test mode is designed for development and testing environments only.
6. Start your VSCU webserver. It will run natively at localhost port 8088, use that as your URL or if you'd rather access it remotely expose the URL with the tool of your choice and use that link to access the VSCU
7. After entering your credentials and selecting the branch, click on the "Initialize Device" button to complete the setup.

Below is an illustrative guide on how to fill in the eTIMS configuration:

Detailed configuration instructions and the necessary prerequisites for the module's operation are also provided with the module's documentation below. For further assistance, do not hesitate to contact our support team.

User Guides

For more in-depth guidance on installation, configuration, and usage of the module, please refer to our comprehensive documentation package. This package contains additional details, best practices, and troubleshooting tips to enhance your experience with the module.

Access the Full Documentation Package within the Module's files