VAT3 filing

VAT3 is the monthly KRA return that summarises your taxable supplies (sales) and taxable purchases. Omnix doesn't file directly with KRA (the iTax API isn't open to third parties) — but it does the hard part: producing a populated VAT3 PDF in your business colours so you can copy figures into iTax in five minutes instead of fifty.

When to file

By the 20th of the following month, on iTax. Late filers pay a penalty.

How Omnix populates the figures

Open Reports → VAT Report. Pick the period (defaults to the current month). Omnix queries:

• Total taxable supplies (sales) — net: sum of `sales.subtotal` for completed sales in the period where the customer was VAT-applicable.
• Output VAT @ 16%: sum of `sales.tax_amount` over the same set.
• Total taxable purchases — net: sum of `goods_receipts.total` net of VAT for the period.
• Input VAT @ 16%: derived from the GRN total at the configured VAT rate.
• Payable: output VAT minus input VAT. Negative values mean a credit carried forward.

Click the PDF button. The output is an A4 PDF with your masthead, KRA PIN, period, every line above, and a payable/credit line at the bottom.

What to copy across

Open the iTax web portal → File Returns → VAT (VAT3). The form mirrors the PDF. Copy figure-by-figure: - Line A1: total taxable supplies → from PDF row 1 - Line A2: output VAT → from PDF row 2 - Line B1: total taxable purchases → from PDF row 3 - Line B2: input VAT → from PDF row 4

Submit. Pay any payable through your bank or M-Pesa per KRA's payment instructions.

Reconciling with eTIMS

eTIMS is the receipt-signing layer. Every sale you ring up gets signed in real time and the figures are visible on the KRA portal too. Cross-check:

1. Pull your eTIMS dashboard summary for the period 2. Compare with the Omnix VAT3 PDF 3. They should match. If not, the most common cause is a sale completed offline that hasn't yet synced to eTIMS — Settings → eTIMS → queue shows pending submissions

Edge cases

• Sales returns: Omnix subtracts returned VAT from output VAT automatically.
• Mixed-rate goods: products with a non-16% VAT rate are computed at their saved rate, not 16%.
• Zero-rated exports: zero-rated supplies show in the supplies total but contribute zero VAT.

See also

• [eTIMS integration](/docs/etims) — receipt signing
• [Reports](/docs/reports) — every report PDF