Overview

The TIMS Tevin Type-C Integration is a Frappe/ERPNext application that connects your ERPNext instance to the Kenya Revenue Authority (KRA) Tax Invoice Management System (TIMS) via the Tevin Type-C Middleware. It ensures every invoice and credit note your business generates is reported to KRA in real time, as mandated by the VAT (Electronic Tax Invoice) Regulations, 2020.

Overview

The TIMS Tevin Type-C Integration is a Frappe/ERPNext application that connects your ERPNext instance to the Kenya Revenue Authority (KRA) Tax Invoice Management System (TIMS) via the Tevin Type-C Middleware. It ensures every invoice and credit note your business generates is reported to KRA in real time, as mandated by the VAT (Electronic Tax Invoice) Regulations, 2020.

#What Problem Does This Solve?

Under KRA regulations, VAT-registered businesses are required to issue tax invoices through a KRA-approved Electronic Tax Register (ETR) or middleware solution. Failure to comply attracts penalties. Manually managing this submission alongside ERPNext creates an operational gap, this integration closes that gap entirely by:

• Automatically submitting invoices to Tevin's middleware the moment they are posted in ERPNext

• Receiving and storing the KRA Control Unit (CU) number and QR code on the invoice record

• Retrying failed submissions automatically via a scheduled task

• Maintaining a full audit trail of every submission attempt through the Integration Request doctype

#Who Is This For?

• Kenyan businesses that are VAT-registered and use ERPNext (v14 or v15+)

• ERPNext implementers deploying for Kenyan clients who need TIMS compliance out of the box

• Finance and accounting teams who want submission to be invisible meaning it just works when you post an invoice

#How It Works: Architecture

Understanding the data flow helps when debugging or extending the integration.

ERPNext (Sales Invoice Submitted)
         |
         v
  [TIMS Tevin App Hook]
  Prepares payload (invoice fields, line items, VAT breakdown)
  Attaches Sender ID & authentication headers
         |
         v
  Tevin Type-C Middleware (API Server)
  Validates payload, forwards to KRA TIMS
         |
         v
  KRA TIMS
  Generates CU Number & signs the invoice
         |
         v
  Response returned to ERPNext
  - CU Number stored on the invoice
  - QR Code generated and embedded
  - Integration Request marked "Completed"

If the middleware is unreachable or returns an error, the Integration Request is marked "Failed", and a scheduled task running every minute will automatically retry until a successful response is received.