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:
- Real-time or near-real-time transmission — every tax invoice must be sent to ZRA’s servers when it’s issued
- Unique verification code — ZRA returns a code that must appear on the invoice
- Invoice data format — the software must transmit in ZRA’s specified data format (JSON/XML via API)
- Taxpayer credentials — the software must authenticate with ZRA using your TPIN and device/API credentials
- Sequential numbering — invoices must have unique, sequential numbers with no gaps
- 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
- You create a sales invoice in Odoo (manually or from a sales order)
- When you confirm the invoice, Odoo automatically transmits the invoice data to ZRA’s Smart Invoice API
- ZRA validates the invoice and returns a verification code
- The verification code and QR code are embedded in the invoice PDF
- 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
| Feature | Odoo | Sage Pastel | QuickBooks |
|---|---|---|---|
| Smart Invoice integration | Native (built-in) | Via third-party connector | Via third-party connector |
| Setup complexity | Low — configure in Odoo settings | Medium — install and configure connector | Medium — install and configure connector |
| Additional cost for SI | Included in Odoo Enterprise | Connector licence fee | Connector licence fee |
| Real-time transmission | Yes | Depends on connector | Depends on connector |
| Credit note support | Full | Varies by connector | Varies by connector |
| Offline fallback | Queues invoices, transmits when online | Varies | Varies |
| Local support in Zambia | M&J Consultants (Certified Partner) | Various resellers | Limited 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:
- Your invoices are invalid — they are not recognised by ZRA as tax invoices
- Your customers can’t claim input VAT — this means B2B customers will stop buying from you
- ZRA compliance action — potential penalties and deregistration
- 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.
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.