---
title: "Requirements & Installation"
space: "TIMS Tevin Type-C Integration"
url: "https://docs.navari.co.ke/tims-tevin/requirements-configuration"
updated: "2026-05-26"
---

## 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](https://tevin.eu/type-c-middleware/)     |
| 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.  


![](/files/image1647c8.png)
*Tevin Type-C Middleware for Accounting*

1. Visit [https://tevin.eu/type-c-middleware/](https://tevin.eu/type-c-middleware/)
2. Purchase the middleware licence appropriate for your business size
3. 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)

```sh
# 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)

```sh
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](https://github.com/frappe/erpnext#installation) for a complete walkthrough.



#### Step 3: Add the TIMS Tevin Type-C App to Bench

```sh
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](https://github.com/navariltd/TIMS-Tevin-Type-C-Integration) for available branches (e.g., `version-15`, `version-14`).



**Example (ERPNext v15):**

```sh
bench get-app --branch version-15 https://github.com/navariltd/TIMS-Tevin-Type-C-Integration.git

```



#### Step 4: Install the App on Your Site

```sh
bench --site {sitename} install-app tims_tevic_typec_integration
```

Replace `{sitename}` with your actual site name.



#### Step 5: Run Migrations

```sh
bench --site {sitename} migrate
```



#### Step 6: Restart Bench

```sh
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](https://frappecloud.com/), the process is simpler and does not require any server management.

1. **Sign up** at [frappecloud.com](https://frappecloud.com/) if you haven't already
2. **Create a new Bench** — select Frappe Version 15 or above
3. **Create a new Site** on that bench
4. During site creation, in the **Apps to Install** section, select:
  - ERPNext
  - TIMS Tevin Type-C Integration
5. 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](https://navari.co.ke/) for implementation support.