Requirements & Installation
Requirements
Before installing, ensure the following are in place:
| Requirement | Details |
|---|---|
| ERPNext Version | Version 14 or Version 15 (recommended) |
| Frappe Framework | Compatible version matching ERPNext |
| Bench | Installed and configured on your server |
| Tevin Middleware License | Purchase from tevin.eu |
| API Server Address | Provided by Tevin on purchase (sandbox + production) |
| Sender ID | Provided by Tevin as part of API credentials |
| KRA PIN | Your business must be VAT-registered with KRA |
| Internet Access | The ERPNext server must have outbound HTTPS access to Tevin's API |
Obtaining the Tevin Middleware
The Type-C Middleware for Accounting is a commercial product sold by Tevin. It acts as the certified bridge between your accounting software and KRA's TIMS infrastructure.
Tevin Type-C Middleware for Accounting
- Visit https://tevin.eu/type-c-middleware/
- Purchase the middleware licence appropriate for your business size
- Tevin will provision:
- A sandbox API server URL (for testing)
- A production API server URL (for live operations)
- A Sender ID unique to your account
Keep these credentials secure — they are your authentication to KRA via Tevin.
Installation
Self-Hosted / Manual
Follow these steps on a server where Frappe bench is already set up and ERPNext is installed.
Step 1: Install Frappe Bench (if not already done)
# Follow the official Frappe bench installation guide
# https://github.com/frappe/bench
pip install frappe-bench
bench init frappe-bench --frappe-branch version-15
cd frappe-bench
Step 2: Install ERPNext (if not already done)
bench get-app --branch version-15 erpnext
bench new-site your-site-name.local
bench --site your-site-name.local install-app erpnext
Refer to the ERPNext installation guide for a complete walkthrough.
Step 3: Add the TIMS Tevin Type-C App to Bench
bench get-app --branch {branch-name} https://github.com/navariltd/TIMS-Tevin-Type-C-Integration.git
Replace {branch-name} with the correct branch for your ERPNext version. Check the repository for available branches (e.g., version-15, version-14).
Example (ERPNext v15):
bench get-app --branch version-15 https://github.com/navariltd/TIMS-Tevin-Type-C-Integration.git
Step 4: Install the App on Your Site
bench --site {sitename} install-app tims_tevic_typec_integration
Replace {sitename} with your actual site name.
Step 5: Run Migrations
bench --site {sitename} migrate
Step 6: Restart Bench
bench restart
Verifying Installation
After restarting, log in to ERPNext and search for "TIMS Settings" in the search bar. If the doctype appears, the app has been installed successfully.
Frappe Cloud
If you are hosting on Frappe Cloud, the process is simpler and does not require any server management.
- Sign up at frappecloud.com if you haven't already
- Create a new Bench — select Frappe Version 15 or above
- Create a new Site on that bench
- During site creation, in the Apps to Install section, select:
- ERPNext
- TIMS Tevin Type-C Integration
- Complete the setup — the site will be ready within a few minutes with the app pre-installed
For enterprise deployments or custom configurations on Frappe Cloud, contact Navari for implementation support.