New

2026 ZRA Tax Season: Filing deadline approaching — ensure your returns are submitted on time. Get tax compliance support →

ERP & Software Updated 16 April 2026 7 min read

Is Odoo ZRA Smart Invoice Compliant in Zambia? (2026)

How Odoo's native ZRA Smart Invoice integration works in Zambia. Setup process, compliance comparison with Sage and QuickBooks, and why M&J is the certified implementation partner.

What ZRA Smart Invoice Requires From Accounting Software

Before we discuss Odoo specifically, here’s what ZRA mandates for any accounting software to be Smart Invoice compliant:

  1. Real-time or near-real-time transmission — every tax invoice must be sent to ZRA’s servers when it’s issued
  2. Unique verification code — ZRA returns a code that must appear on the invoice
  3. Invoice data format — the software must transmit in ZRA’s specified data format (JSON/XML via API)
  4. Taxpayer credentials — the software must authenticate with ZRA using your TPIN and device/API credentials
  5. Sequential numbering — invoices must have unique, sequential numbers with no gaps
  6. Tax breakdown — each invoice must show the VAT amount separately, the VAT rate, and the supplier’s VAT number

Any software that meets these requirements can be used. The question is whether it does so natively (built-in) or requires third-party middleware.

How Odoo’s Smart Invoice Integration Works

Odoo’s ZRA integration is native — it is built into the Odoo Accounting module, not bolted on as a third-party add-on. Here’s how it works:

The Invoice Flow

  1. You create a sales invoice in Odoo (manually or from a sales order)
  2. When you confirm the invoice, Odoo automatically transmits the invoice data to ZRA’s Smart Invoice API
  3. ZRA validates the invoice and returns a verification code
  4. The verification code and QR code are embedded in the invoice PDF
  5. The invoice is sent to your customer with full ZRA compliance

This happens automatically. There is no manual step, no separate software to run, no fiscal device to maintain. Every invoice created in Odoo is a Smart Invoice.

What Gets Transmitted to ZRA

  • Invoice number and date
  • Supplier TPIN and VAT number
  • Customer TPIN (for B2B transactions)
  • Line items with descriptions, quantities, and unit prices
  • VAT rate and VAT amount per line
  • Total invoice amount
  • Currency (ZMW, USD, etc.)

Credit Notes and Adjustments

Odoo also transmits credit notes through Smart Invoice. When you issue a credit note in Odoo, it references the original invoice and is sent to ZRA, maintaining a complete audit trail.

Step-by-Step: How M&J Configures Odoo for Smart Invoice

Step 1: Zambian Chart of Accounts

We configure Odoo with a Zambian chart of accounts that maps to ZRA reporting requirements. This includes:

  • VAT output account (16%)
  • VAT input account
  • Zero-rated and exempt supply tracking
  • WHT accounts for applicable transactions

Step 2: Tax Configuration

We set up Zambian tax codes in Odoo:

  • Standard VAT (16%)
  • Zero-rated VAT (0%)
  • Exempt supplies
  • Withholding tax rates (15%, 20% as applicable)

Step 3: Smart Invoice Credentials

We enter your ZRA Smart Invoice API credentials into Odoo’s fiscal settings:

  • TPIN
  • API key / device ID
  • ZRA endpoint URL
  • Authentication tokens

Step 4: Invoice Template Customisation

We customise the Odoo invoice PDF template to include:

  • ZRA verification code
  • QR code for verification
  • Your company VAT number prominently displayed
  • “Tax Invoice” label (required for VAT invoices)
  • All fields required by ZRA

Step 5: Connection Testing

We issue test invoices and verify:

  • Successful transmission to ZRA
  • Verification code returned correctly
  • Invoice PDF displays all required fields
  • Credit notes transmit correctly
  • Error handling works (what happens when the internet drops)

Step 6: Team Training

We train your accounts team on:

  • Creating invoices in Odoo
  • Verifying Smart Invoice transmission status
  • Handling transmission errors
  • Reconciling Odoo invoices with ZRA Smart Invoice records

Odoo vs Sage Pastel vs QuickBooks — Smart Invoice Compliance

FeatureOdooSage PastelQuickBooks
Smart Invoice integrationNative (built-in)Via third-party connectorVia third-party connector
Setup complexityLow — configure in Odoo settingsMedium — install and configure connectorMedium — install and configure connector
Additional cost for SIIncluded in Odoo EnterpriseConnector licence feeConnector licence fee
Real-time transmissionYesDepends on connectorDepends on connector
Credit note supportFullVaries by connectorVaries by connector
Offline fallbackQueues invoices, transmits when onlineVariesVaries
Local support in ZambiaM&J Consultants (Certified Partner)Various resellersLimited local support

Key advantage of Odoo: Because the integration is native, there’s no dependency on a third-party middleware provider. If the middleware company goes out of business or stops updating their connector, Sage and QuickBooks users face a compliance gap. Odoo’s integration is maintained by Odoo SA as part of the core product.

What Happens If Your Software Isn’t Smart Invoice Connected

The consequences are straightforward and severe:

  1. Your invoices are invalid — they are not recognised by ZRA as tax invoices
  2. Your customers can’t claim input VAT — this means B2B customers will stop buying from you
  3. ZRA compliance action — potential penalties and deregistration
  4. Audit exposure — your entire VAT history becomes questionable

If your current software does not support Smart Invoice, you have three options:

  • Upgrade to software with native integration (like Odoo)
  • Install a third-party Smart Invoice connector (if available for your software)
  • Purchase a standalone fiscal device and manually reconcile with your software

The first option is the most sustainable long-term solution.

M&J as Zambia’s Official Certified Odoo Partner

M&J Consultants holds the Official Certified Odoo Partner designation for Zambia. This means:

  • Certified by Odoo SA — our team has completed Odoo’s official training and certification programme
  • Direct technical support — we have access to Odoo’s partner support channel for complex technical issues
  • Implementation methodology — we follow Odoo’s proven 5-phase methodology: scoping → configuration → data migration → training → go-live
  • Ongoing support — post-implementation support and maintenance as part of our service

We implement Odoo across all modules — not just accounting. If your business needs inventory, manufacturing (MRP), CRM, HR, project management, or e-commerce alongside Smart Invoice compliance, Odoo covers it all in a single integrated system.

See our Odoo ERP Zambia page for the full list of modules and industries we serve.

M&J is Zambia's Official Certified Odoo Partner.

We implement Odoo with ZRA Smart Invoice pre-configured, Zambian tax codes set up, and your team trained. Book a free Odoo demo.

Book Free Consultation

Frequently Asked Questions

Is Odoo ZRA Smart Invoice compliant in Zambia?

Yes. Odoo has native, built-in ZRA Smart Invoice integration. When you create an invoice in Odoo, it is automatically transmitted to ZRA's Smart Invoice system and receives a verification code — no third-party middleware or separate fiscal device is needed.

Does Odoo Community edition support Smart Invoice?

The ZRA Smart Invoice module is available in Odoo Enterprise. If you are using Odoo Community, M&J can advise on the best path to compliance, which may include upgrading specific modules or using a connector.

How long does it take to set up Smart Invoice in Odoo?

If your Odoo instance is already running, the Smart Invoice configuration typically takes 1–2 days. This includes entering ZRA credentials, configuring tax codes, testing the connection, and verifying that invoices transmit correctly.

Can I use Odoo for all my ZRA compliance, not just Smart Invoice?

Yes. Odoo handles invoicing (Smart Invoice), VAT calculations, PAYE payroll, financial reporting, and can generate the data needed for all ZRA returns. M&J configures Odoo to align with Zambian tax requirements as part of every implementation.

What makes M&J different from other Odoo implementers in Zambia?

M&J is Zambia's Official Certified Odoo Partner — the only firm in Zambia with this designation. This means we have direct access to Odoo's technical support, we are trained and certified by Odoo SA, and our implementations are backed by the Odoo Partner SLA.

Schedule a Meeting With Our Team

Fill in your details and one of our consultants will reach out to discuss how we can help your business.

+260 950 054 386
1504 Mungulube Road, Northmead, Lusaka