Tax Guides

ZRA Smart Invoice Setup Guide — Complete Zambia 2026 Walkthrough

📅 Published: 1 March 2026
🔄 Updated: 8 April 2026
⏱️ 14 min read
✍️ PAYEZambia Editorial Team

Smart Invoice has been mandatory for every VAT-registered business in Zambia since 1 October 2024. Without it, your invoices are not legally recognised by ZRA — and your buyers cannot claim input VAT on them. This guide tells you exactly which solution type to use, walks you through registration step-by-step, shows you how to add your stock items, issue your first valid invoice with a Mark ID and QR code, and explains what happens if you don't comply.

Smart Invoice ZRA e-Invoicing VAT Compliance 2026 VSDC Zambia Mark ID Zambia Business

What Is ZRA Smart Invoice and Why Does It Matter?

ZRA Smart Invoice is Zambia's mandatory electronic invoicing system — a digital platform that records every business transaction and transmits the data to ZRA's servers in real time. It was officially launched on 19 March 2024 and became mandatory on 1 July 2024, with penalty enforcement beginning 1 October 2024.

It was developed through a south-south cooperation between the Zambian and Rwandan governments, drawing on Rwanda's successful e-invoicing experience, and replaces the older Electronic Fiscal Devices (EFDs) — the physical machines previously used to generate tax receipts.

Every invoice generated through Smart Invoice receives a unique Mark ID and a QR code. These two identifiers are ZRA's stamp of validity. From 1 January 2026, ZRA only accepts input VAT claims backed by Smart Invoice-generated receipts — any invoice without these identifiers cannot be used to claim VAT deductions.

Mar 2024
System launched
Oct 2024
Penalties enforced
Jan 2026
Input VAT only from Smart Invoice
Free
Cost to register
🚨
If you are VAT-registered and not on Smart Invoice, you are already non-compliant. Every invoice you have issued since October 2024 outside the Smart Invoice system is not a valid ZRA tax invoice. Your buyers cannot claim input VAT on those invoices, and you face statutory penalties. Set up Smart Invoice today — registration is free and takes under an hour.

Key Dates and Enforcement Timeline

19 March 2024
System Launched
ZRA officially launches Smart Invoice, developed in partnership with Rwanda. Voluntary registration opens. Businesses begin testing and integration.
1 July 2024
Mandatory — Grace Period Begins
Smart Invoice becomes mandatory for all VAT-registered taxpayers. ZRA announces a grace period after feedback from businesses — penalties deferred, but registration must begin.
30 September 2024
Grace Period Ends
Final deadline for all VAT-registered businesses to register and start using Smart Invoice. ZRA issues final reminder and announces penalty enforcement beginning the next day.
1 October 2024
Penalty Enforcement Begins
ZRA begins enforcing statutory penalties for non-compliance. Non-Smart Invoice invoices are no longer recognized. EFD receipts can no longer be used in place of Smart Invoices.
1 January 2026
Input VAT Only from Smart Invoices
ZRA formally confirms that input VAT claims are only accepted for purchases backed by invoices generated through the Smart Invoice system. Invoices issued outside the system cannot be used for VAT deductions by buyers.
Ongoing 2026
ZRA Continues Enforcement & Updates
ZRA publishes monthly Smart Invoice bulletins, updates item classification codes, and expands integrations with approved software vendors. June 2026 bulletin published on zra.org.zm.

Who Must Use Smart Invoice?

The mandate is broad. Here is exactly who must comply:

  • 🏪
    All VAT-registered businesses
    Retailers, wholesalers, service providers, restaurants, fuel stations, manufacturers, importers — any business registered for VAT in Zambia, regardless of size or annual turnover. This is non-negotiable.
  • 🌍
    Foreign digital services providers selling to Zambia
    Non-resident businesses required to register for Zambian VAT under the 2024 Cross-Border Electronic Services Regulations must also issue Smart Invoices — typically through a local tax agent.
  • 📱
    Turnover Tax businesses (Mobile App only)
    Businesses registered only for Turnover Tax (not VAT) can use the Smart Invoice Mobile App. They are NOT required to use the Online or Desktop solutions — the Mobile App is specifically designed for this segment.
Exempt from Smart Invoice? The Commissioner-General may grant exceptions to specific categories of taxpayers in exceptional circumstances. However, there is no blanket exemption for small businesses, startups, or sector-specific businesses. If you are VAT-registered, you must comply. Contact ZRA on 4111 or [email protected] if you believe your business has exceptional circumstances.

The 4 Smart Invoice Solution Types — Which Is Right for You?

This is the decision most guides skip — and it is the most important one you will make. The wrong solution type causes setup failures and compliance gaps. Choose carefully based on your business size, industry, and existing software.

🌐
Online Portal
Best for most businesses

A browser-based invoicing platform accessed through any web browser — no software installation needed. Ideal for service businesses that issue a moderate number of invoices per month.

VAT-registered businesses ✓ Any device with a browser Reliable internet required Best for: consultants, professionals, agencies, B2B services
🖥️
Desktop / Laptop App
All taxpayer sizes

A Windows application installed on your computer or laptop. Works offline and syncs to ZRA when reconnected. Suitable for small, medium, and large taxpayers who need local data management.

Windows 10 or higher VAT-registered and Turnover Tax businesses Has offline mode ✓ Best for: retail shops, hospitality, trade businesses
📱
Mobile App
Turnover Tax only

An Android application for on-the-go invoicing. Important: this solution is for Turnover Tax taxpayers ONLY. VAT-registered businesses must use the Online or Desktop solution instead.

Android 8 or higher Turnover Tax taxpayers ONLY NOT for VAT-registered businesses Best for: market traders, mobile vendors
⚙️
VSDC Integration
ERP / Accounting software

Connect your existing accounting or ERP software (Sage, QuickBooks, SAP, Tally, custom systems) to Smart Invoice via the Virtual Sales Data Controller (VSDC) API. Best for businesses with high transaction volumes.

Requires Java 8 on local server VAT-registered large businesses IT / developer setup required Best for: large retailers, manufacturers, distributors, chains
⚠️
The Mobile App mistake costs businesses money. The most common Smart Invoice error in Zambia is VAT-registered businesses registering for the Mobile App (designed for Turnover Tax) instead of the Online or Desktop solution. Invoices issued through the Mobile App by a VAT-registered business will not carry the correct VAT data — your buyers cannot claim input VAT. If you are VAT-registered, use Online or Desktop only.

Know your VAT obligation first

Before setting up Smart Invoice, confirm your VAT registration status and calculate your monthly VAT payable with our free tool.

Open VAT Calculator →

Step-by-Step: Registering on the Smart Invoice Portal

All solution types (Online, Desktop, VSDC) start with the same account registration on the Smart Invoice Taxpayer Portal. Complete this first before applying for your specific solution.

1

Go to the Smart Invoice Taxpayer Portal

Visit the Smart Invoice portal — accessible via www.zra.org.zm → Smart Invoice → Smart Invoice Portal. This is separate from the main ZRA e-Services portal.

2

Click "Sign Up" and enter your TPIN

On the sign-up screen, enter your TPIN. Click Verify. The system will automatically pull your registered taxpayer information from ZRA's database — your business name, address, and VAT registration status will auto-populate. Check for any errors before proceeding.

3

Create your password

Set a strong password that meets ZRA's password policy — typically a mix of uppercase, lowercase, numbers, and symbols. This password is used to log into the Smart Invoice portal and applications going forward.

4

Click Send and enter your OTP

Click the Send button to receive a One-Time Password (OTP) via SMS to your ZRA-registered mobile number. Enter the 6-digit OTP. Example: if the SMS says "Request security code is [579086]", enter 579086. OTPs expire quickly — enter it immediately.

Click Sign Up — account created

Your Smart Invoice account is now created. Log in using your TPIN as the username and the password you set. You will land on your Smart Invoice dashboard, where you can apply for your chosen solution type.

💡
OTP not arriving? The OTP is sent to the mobile number registered with ZRA against your TPIN. If you receive nothing, it means the phone number on your ZRA account may be outdated. Visit any ZRA office to update your contact details before retrying. Do not attempt sign-up repeatedly with wrong details — it can temporarily lock your TPIN from the portal.

Applying for Your Chosen Solution Type

After account creation, the next step is applying for and activating your specific Smart Invoice solution. The process is the same regardless of whether you choose Online, Desktop, or VSDC — only the form fields differ.

1

Log in and click "Apply"

From your Smart Invoice dashboard, locate and click the Apply button in the top right area of the screen.

2

Select "Smart Invoice"

A dropdown or list of available services will appear. Click Smart Invoice to begin the service application.

3

Choose your Smart Invoice type

Select your solution type from the options: Online, Desktop/Laptop/Tablet, Mobile App, or VSDC. Remember — Mobile App is for Turnover Tax only. If you are VAT-registered, choose Online or Desktop.

4

Fill in the service information form

Complete the form with your business details — number of invoicing terminals, business location, primary business activity, and expected monthly invoice volume. For VSDC, you will need to provide your server details and software environment information.

5

Submit and await ZRA approval

Submit the application. ZRA reviews and processes it — you will receive an approval or rejection notification via SMS to your registered phone number. Approval is typically received within 1–3 working days for Online and Desktop applications. VSDC may take longer due to technical verification.

Download the app or access the portal (after approval)

Online: Access is activated immediately after approval — log in and start issuing invoices.
Desktop: Download the Smart Invoice Desktop App from the portal after approval. Install on Windows 10 or higher. Log in with your TPIN and portal password.
VSDC: Download the VSDC WAR package file from the portal. Deploy it on your local server (requires Java 8). Follow the VSDC Step-by-Step Guide available on zra.org.zm.

Setting Up Your Items and Stock Classification

Before you can issue your first invoice, you must add all the goods and services you sell to the Smart Invoice system. Each item must be classified using ZRA's official item classification codes, and each must be assigned the correct tax treatment — standard-rated (16% VAT), zero-rated (0% VAT), or exempt.

Getting this right is critical. If an item is classified as zero-rated when it should be standard-rated, your invoices will show incorrect VAT and ZRA's system will flag discrepancies during return reconciliation.

How to Add Items

1

Access Item Management in the system

In the Smart Invoice portal or Desktop App, navigate to the Item Management section. This is where all your sellable goods and services are stored.

2

Search for the correct item classification code

ZRA provides a comprehensive Item Classification Code list available for download on their Smart Invoice page. Each product or service category has a specific code. Use the search function in Item Management to find your item's code. If unsure, contact ZRA — misclassification is a common audit trigger.

3

Enter item details

For each item enter: item name, item code, unit of measure (each, kg, litre, hour, etc.), unit price, and the applicable tax rate (Standard 16%, Zero-rated 0%, or Exempt). Items can be added one at a time or in bulk.

!

Use Bulk Upload for many items

If you have a large stock list, do not add items one by one. Download ZRA's Bulk Item Upload Template from zra.org.zm, fill in all your items following the template format, and upload the completed file to Smart Invoice. This process is designed for retailers and wholesalers with hundreds of SKUs.

⚠️
Do not skip item setup — you cannot issue invoices without it. Smart Invoice requires every item on an invoice to be pre-registered in the system. You cannot manually type a description and price without linking it to a classified item. Take time to get your item list right before going live.

Issuing Your First Smart Invoice — Mark ID and QR Code

Once your items are loaded, you are ready to issue your first legitimate ZRA tax invoice. Here is what the process looks like and what each element means.

1

Create a new sale transaction

Select New Sale or Sales by Invoice from the menu. Choose the customer (you can create a customer record or sell to a walk-in/unnamed customer for B2C transactions).

2

Add items from your pre-loaded list

Select the items being sold from your registered item list. Adjust quantities as needed. The system automatically calculates VAT at the correct rate for each item based on its classification.

3

Submit the transaction to ZRA

Click Submit or Issue Invoice. The Smart Invoice system sends the transaction data to ZRA's servers in real time for validation. This happens automatically in the background — it usually takes a few seconds.

Receive your Mark ID and QR code

ZRA validates the transaction and returns a unique Mark ID — a reference number that identifies this specific invoice in ZRA's database. A QR code is also generated, which links to ZRA's verification page. Both appear on the final invoice. Printing is optional — you can share the invoice digitally.

Lusaka Trading Co. Ltd VAT Reg: ZM1234567 · TPIN: 1000000001
Plot 4520 Cairo Road, Lusaka
ZRA Smart Invoice
TAX INVOICE
Invoice No. LTC-2026-00847
Date 08 April 2026
Net Amount K 10,000.00
VAT @ 16% K 1,600.00
Total (Incl. VAT) K 11,600.00
Mark ID: ZRA-2026-8X47-K91P-QR22 This invoice is verified and registered with the Zambia Revenue Authority. Scan QR code to verify at zra.org.zm. Valid input VAT deduction: K 1,600.00

The Mark ID and QR code are the two elements that make this a legally valid Zambian tax invoice. Your buyer can scan the QR code to independently verify the invoice in ZRA's system. Without these two elements, the invoice is not recognised by ZRA and cannot be used for input VAT claims.

Using Smart Invoice Offline

One of the most common concerns from Zambian businesses — particularly outside Lusaka — is connectivity. What happens when your internet goes down mid-day?

The Smart Invoice Desktop App has a built-in offline mode. Here is how it works:

  • 📴
    Internet drops — create invoices normally
    The Desktop App continues operating. You can create and issue invoices as usual. The system stores all transaction data locally on your device.
  • 🔄
    Internet restored — automatic sync
    When connectivity resumes, the Desktop App automatically uploads all offline invoices to ZRA's server. Mark IDs and QR codes are then generated for all offline transactions.
  • 📤
    Manual upload option
    ZRA also provides a "Guide to Upload Offline Invoices" for businesses that need to manually upload stored transaction data. Download this guide from zra.org.zm under Smart Invoice → User Manuals & Forms.
ℹ️
The Online Portal does not have offline mode. If you choose the Online Portal solution and lose internet connectivity, you cannot issue invoices until connectivity is restored. For businesses in areas with unreliable connectivity, the Desktop App is strongly recommended.

What to Do With Your Old EFD Machine

If your business previously used an Electronic Fiscal Device (EFD) — the physical machine issued by ZRA under the old system — you must return it to ZRA now that Smart Invoice is mandatory.

Do not continue issuing EFD receipts. EFD receipts are no longer valid tax invoices. Buyers cannot claim input VAT on them, and issuing them in place of Smart Invoices constitutes non-compliance.

1

Contact ZRA's Smart Invoice support team

Email [email protected] or call the toll-free number 4111. Notify ZRA that you are ready to return your EFD and arrange the deregistration process.

2

Return the device to your nearest ZRA office

Bring the EFD machine and any associated accessories to a ZRA Taxpayer Services office. ZRA will process the deregistration, remove the device from your account, and issue a deregistration confirmation.

Confirm Smart Invoice is fully active

After EFD return, ensure your Smart Invoice solution is fully set up and that you are issuing Smart Invoices for every sale. Keep your deregistration confirmation on file in case of future ZRA audits.

Penalties for Non-Compliance

ZRA's penalty framework for Smart Invoice non-compliance is enforced through the VAT Act and general tax administration legislation. Here are the consequences of failing to comply:

OffenceConsequence
Not registered for Smart Invoice (VAT-registered business) Statutory penalties under VAT Act + potential audit of all sales since Oct 2024
Issuing invoices outside Smart Invoice Invoice not legally valid · buyer cannot claim input VAT · denial of seller's deductions
Failure to issue a tax invoice from an approved system ZRA Penalties Schedule: statutory penalty under VAT Act (financial sanction)
Failure to provide records to ZRA officers K6,000 fixed penalty + K600 per additional day
Continued EFD use after October 2024 EFD receipt invalid as tax invoice · same as issuing non-Smart Invoice
VAT fraud using invalid invoices Criminal prosecution · fine up to K90,000 · up to 3 years imprisonment
Already behind? Voluntary compliance is always better. If you are not yet on Smart Invoice, register today. ZRA's enforcement posture rewards proactive compliance — voluntary registration before an audit is treated more favourably than discovered non-compliance. Call 4111 or email [email protected] to get help with late registration.

Now set up — calculate your VAT payable each month

Use our free VAT Calculator to compute your output VAT, input VAT, and monthly remittance due to ZRA by the 18th.

Business VAT Calculator →

Common Smart Invoice Errors and How to Fix Them

"TPIN not found" or "Invalid TPIN" error during sign-up
This means either your TPIN is not yet active in ZRA's system or your TPIN status is Inactive. Fix: First search for your TPIN at portal.zra.org.zm/searchTaxpayer to confirm it exists and is Active. If Inactive, visit a ZRA office to reactivate. If you have no TPIN yet, register at our TPIN guide first.
OTP not received on my phone
The OTP is sent to the phone number ZRA has on record for your TPIN — which may be an old or incorrect number. Fix: visit any ZRA office with your NRC and Certificate of Incorporation to update your contact number on your TPIN account before attempting sign-up again. Do not make multiple failed attempts — it can temporarily restrict your account.
Invoice submission fails — "Connection error" or "Server timeout"
This occurs when your device cannot reach ZRA's servers. Fix for Online users: check your internet connection; if the connection is fine, ZRA's server may be temporarily busy — wait a few minutes and retry. Fix for Desktop users: the offline mode will capture the transaction. Once connectivity is restored, the invoice will sync automatically. Do not create the same invoice twice — this creates duplicates in ZRA's system.
Wrong solution type — I registered for Mobile App but I'm VAT-registered
This is a significant problem — all invoices issued through the Mobile App by a VAT-registered business are non-compliant. Fix: contact ZRA immediately at [email protected] or call 4111. Explain the situation and request to migrate your account to the Online or Desktop solution. ZRA's Smart Invoice support team can guide you through the transition. Stop issuing Mobile App invoices immediately.
Item not found when searching classification codes
ZRA's item classification code list is extensive but may not cover every niche product or service. Fix: download the full Item Classification Codes document from zra.org.zm → Smart Invoice → Integrations → Item Classification Codes. Search the PDF for your product category. If your item genuinely does not appear, contact ZRA's Smart Invoice team at [email protected] — they can advise on the appropriate code or add new classifications.

Frequently Asked Questions

Is Smart Invoice registration free in Zambia?
Yes — completely free. ZRA's Smart Invoice Online portal, Desktop application, and Mobile App are all free to register and use. VSDC API access is also provided at no cost by ZRA. Your business may incur costs from your ERP vendor or integration partner for the implementation work if you choose the VSDC route, but the ZRA service itself carries no charge.
Can I issue Smart Invoices without a printer?
Yes. Printing an invoice is optional under the Smart Invoice system. You can share the invoice digitally — by email, WhatsApp, or any digital channel — as long as it contains the valid Mark ID and QR code. For B2B transactions where the buyer needs to claim input VAT, sharing the digital invoice with the Mark ID is sufficient.
Does Smart Invoice work for both B2B and B2C sales?
Yes. Smart Invoice handles both B2B (business to business) and B2C (business to consumer) transactions. For B2C sales where the buyer is an individual without a TPIN, you can issue to an unnamed/walk-in customer. For B2B sales where the buyer is VAT-registered and needs to claim input VAT, enter their TPIN as the buyer's reference — this creates a link in ZRA's system between your output VAT and their input VAT claim.
What accounting/ERP software is approved for VSDC integration in Zambia?
ZRA publishes a list of Approved Vendor List of software providers that have successfully integrated with Smart Invoice via the VSDC. This list is available at zra.org.zm → Smart Invoice → Integrations → Approved Vendor List. The list includes providers that have completed ZRA's certification process. If your software is not on the list, your vendor can apply for certification through ZRA's developer checklist and sandbox portal.
How long do I need to keep Smart Invoice records?
ZRA requires taxpayers to retain records for at least six years under the Tax Records Act. Smart Invoice data is transmitted to ZRA in real time, so ZRA holds a copy on their servers. However, you should also maintain your own local records — particularly for offline invoices, credit notes, and any manual adjustments. The Desktop App stores records locally; ensure regular backups.
Where do I get help if I'm stuck setting up Smart Invoice?
ZRA has dedicated Smart Invoice support:
Email: [email protected]
General queries: [email protected]
Toll-free call centre: 4111
Live chat: ZRA website Customer Service Portal
In person: any ZRA Taxpayer Services office
ZRA also publishes monthly Smart Invoice bulletins and a Common Errors and Solutions FAQ document at zra.org.zm — check these before contacting support.
PAYEZambia Editorial Team
Tax & Compliance Guides · Lusaka, Zambia
PAYEZambia.com is a Zambian-owned platform providing accurate, practical tax and payroll guides for Zambian businesses and employees. Our content is researched against official ZRA publications, updated regularly, and written for real Zambian business owners — not accountants. We are not a registered tax advisor; for complex compliance matters, contact ZRA directly on 4111 or engage a qualified Zambian tax practitioner.
📚 Sources & References
  • ZRA Smart Invoice Learn More — Official description of all four solution types · zra.org.zm/smart-invoice-learn-more
  • ZRA Smart Invoice Registration Guide — Official step-by-step registration process · zra.org.zm/smart-invoice-registration-guide
  • ZRA Smart Invoice Deadline Notice — Official September 2024 enforcement deadline announcement · zra.org.zm/smart-invoice-deadline
  • ZRA Smart Invoice Online Portal User Manual — Official user manual PDF · zra.org.zm/wp-content/uploads/2024/01/Smart-Invoice-Online-Portal-User-Manual.pdf
  • ZRA VSDC Service Sign-Up Guide — Step-by-step VSDC integration guide PDF · zra.org.zm/wp-content/uploads/2024/03/Smart-Invoice-VSDC-Service-Sign-Up-Guide.pdf
  • ZRA Smart Invoice FAQs — Official FAQ document · zra.org.zm/wp-content/uploads/2024/08/Smart-Invoice-FAQs.pdf
  • ZRA Smart Invoice Common Errors & Solutions (2026) — Updated error guide · zra.org.zm/wp-content/uploads/2026/06/SMART-INVOICE-COMMON-ERRORS-AND-SOLUTIONS.pdf
  • ZRA Penalties Schedule — Official penalty framework · zra.org.zm/penalties
  • Smart Invoice Contact: [email protected] · [email protected] · Toll-free: 4111