ZRA Smart Invoice API: Developer Integration Guide 2026

The Real Cost of Keying Every Sale Twice

If your business is VAT-registered, you already know the routine. You raise an invoice or ring up a sale, then someone opens ZRA Smart Invoice and types in the same transaction a second time. Do that across a busy retail shop in Lusaka, a wholesale outlet in Kitwe, or a pharmacy in Ndola and you are burning staff time, creating keying errors, and maintaining two sets of records that can fall out of sync the moment someone misses a step.

That gap between your billing system and the ZRA Smart Invoice API is where audit risk lives. A missed entry, a transposed amount, a credit note raised in one place and forgotten in the other — any of these can surface during a ZRA review when your records do not match what was transmitted.

Account Desk was built to close that gap for VAT-registered Zambian businesses: retail shops, wholesalers, distributors, pharmacies, hardware stores and restaurants across Lusaka, Kitwe, Ndola, Livingstone, Kabwe, Chipata and Solwezi.

What ZRA Smart Invoice Requires

ZRA's Smart Invoice system — also called the VSDC (Virtual Sales Data Controller) — requires VAT-registered businesses to transmit every sale to ZRA electronically at the point of billing. When the sale is accepted, ZRA returns a receipt number, a unique SDC ID and a QR code. These must appear on the invoice or till receipt given to the customer.

The system allows ZRA to match what appears on your VAT return to what was actually billed, in real time — not months later when discrepancies are harder to explain.

How Account Desk Connects to the ZRA Smart Invoice API

Account Desk integrates directly with the ZRA Smart Invoice API (VSDC). When you post a sale — from the invoicing screen or the POS till — Account Desk sends that transaction to ZRA automatically. You do not open a second system. You do not retype a single field.

The ZRA receipt number, SDC ID and QR code return from ZRA and print on the customer's invoice and on the till receipt in the same action that posts the sale. One workflow. One record. No duplicate entry.

Corrections and Returns Without Loose Ends

Sales sometimes need to be corrected or reversed. Account Desk lets you raise a credit note or debit note directly against the original ZRA receipt number. This includes amount-only price-difference notes — useful when the quantity is right but the price needs adjusting after the original invoice was raised. The correction is filed with ZRA against the original transaction, so your records and ZRA's records stay consistent.

Stock and Purchases: Synced to ZRA

ZRA Smart Invoice also monitors inventory. Account Desk syncs your stock master, stock movements and purchases to ZRA — in real time, on a weekly schedule, or manually when you choose.

Every item in your stock list carries a ZRA UNSPSC classification code. The full ZRA-published list is built into Account Desk and searchable by name or code, so your team does not need a separate spreadsheet to look up classifications.

For items in VAT Category B — where ZRA requires that VAT is calculated on the recommended retail price rather than the actual selling price — Account Desk applies the minimum taxable value rule automatically. The VAT figure on the invoice is calculated correctly from the start.

Understanding VAT on Your Invoices

Zambia's standard VAT rate is 16%. When you raise a sale in Account Desk, the system applies the correct VAT treatment based on each item's classification and category:

• Standard-rated items — 16% VAT on the selling price
• Category B items — 16% VAT on the recommended retail price (the minimum taxable value)
• Zero-rated and exempt items — no VAT charged, clearly separated on the invoice and in your VAT return

The VAT-exclusive price, the VAT amount and the VAT-inclusive total all print on the invoice. Your VAT return is built from the same transactions sent to ZRA Smart Invoice, so the figures you file match exactly what ZRA holds.

Everything Else a Zambian Business Needs

Account Desk is a complete cloud accounting and business-management platform. Alongside the ZRA Smart Invoice integration it covers:

• Inventory — multi-store, batch and expiry-date tracking (FEFO rotation), barcodes, units of measure and price lists
• Double-entry accounting — chart of accounts, customer and supplier ledgers, vouchers, trial balance, profit and loss and balance sheet
• Payments in Kwacha (ZMW) — Airtel Money, MTN Money, bank transfer, cash and card, each recorded against the correct invoice
• ZRA reporting — Sales Book and Z-Report ready for ZRA submissions
• Multi-branch and multi-company — manage more than one location or business from a single login
• WhatsApp invoice delivery — send a fiscalised invoice directly to a customer's phone

Test the Full Flow Before Going Live

Account Desk includes a sandbox mode that mirrors the live ZRA Smart Invoice environment. You can run through a complete cycle — sales, credit notes, stock syncs and receipts — without affecting your real ZRA records. This is the right way to train cashiers, confirm your item classifications and verify your setup before the first live transaction.

Works on Any Device, Anywhere in Zambia

Account Desk is an installable web app (PWA) that runs on desktop, tablet and phone without a separate download. Whether your cashier is at a till in Kabwe, your buyer is receiving goods in Chipata, or you are reviewing reports from Solwezi, your whole team works in the same live system.

Role-based access keeps things organised: a cashier handles the POS, a manager pulls reports, an accountant works the ledgers.

Ready to Stop Doing the Work Twice?

If your team is still keying sales into ZRA Smart Invoice separately, talk to our team — the setup is straightforward and the time saving starts from day one.

Book a demo of Account Desk and see the ZRA Smart Invoice API integration in action, from the first sale through to your VAT return.