---
title: "Sales Invoice Flow"
space: "TIMs INCOTEX Intergration"
url: "https://docs.navari.co.ke/tims-incotex/sales-invoice-flow"
updated: "2026-06-09"
---

This is the end-to-end workflow for a standard taxable sale:



**1. Create the Sales Invoice** Create a Sales Invoice in ERPNext as normal. Ensure:

- A **Tax Category** is selected on the invoice header.
- The **Sales Taxes and Charges** table is populated with the appropriate tax template.
- All line items have their **HS Codes** populated (either auto-filled or manually entered).



**2. Verify HS Codes** Before submitting, confirm that every line item has an HS Code. Invoices with missing HS Codes may fail at the INCOTEX side, requiring manual re-submission.



**3. Submit the Invoice** Click **Submit** (or **Amend and Submit** for amended invoices). Upon submission:

- The integration fires immediately via the `on_submit` hook.
- The invoice data is packaged into a payload according to the INCOTEX API specification.
- The correct endpoint (inclusive or exclusive) is selected based on the tax configuration.
- The payload is sent to INCOTEX via a secure HTTP POST request.



**4. INCOTEX Response** If the submission is successful, INCOTEX returns:

- A **System Invoice Number** (INCOTEX's internal reference ID)
- A **CU Invoice Number** (the official KRA control unit number)
- A **Verify URL** for KRA's public verification portal
  ![](/files/image958165.png)
  *Successful Response*



ERPNext immediately updates the invoice with these values. The `is_filed` checkbox is ticked, and the Verify URL is stored.



**5. QR Code Generation** A QR code is automatically generated from the Verify URL and stored on the invoice. This QR code must appear on the printed invoice given to the customer.



**6. Print** Use a custom print format that includes the QR code field to produce a KRA-compliant invoice printout.

![](/files/image64132c.png)
*Current Print Format*



> **Note on Print Formats:** As of the current release, a standard out-of-the-box print format with the QR code is not yet bundled. Administrators should create a custom print format that references the `verify_url` and QR code fields. Frappe's print format builder or Jinja2 HTML templates can be used for this purpose.