| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Discuss (mail)
• Invoicing (account) |
| Community Apps Dependencies | Show |
| Lines of code | 2740 |
| Technical Name |
l10n_zm_smart_invoice |
| License | OPL-1 |
| Website | https://gencbaris.com/odoo_plugins/ |
| Versions | 18.0 19.0 |
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Discuss (mail)
• Invoicing (account) |
| Community Apps Dependencies | Show |
| Lines of code | 2740 |
| Technical Name |
l10n_zm_smart_invoice |
| License | OPL-1 |
| Website | https://gencbaris.com/odoo_plugins/ |
| Versions | 18.0 19.0 |
Zambia Smart Invoice
Lodge ZRA Smart Invoices straight from Odoo — VAT, levies, signed JSON and verification QR
Connect Odoo to the Zambia Revenue Authority (ZRA) Smart Invoice regime through the Virtual Sales Data Controller (VSDC). Smart Invoice has been live since 1 July 2024, with standard penalties from 1 October 2024 and input VAT restricted to Smart-Invoice transactions from 1 January 2025 — so every VAT-registered supplier must lodge sales electronically. This connector does exactly that, from the customer invoice you already raise.
What it does
Signed saveSales JSON
Builds the canonical, deterministically serialized ZRA Smart Invoice payload (header plus itemList) for both sales and credit notes, with fixed decimal precision (quantities to 4 dp, money to 2 dp) so the signing string is reproducible.
VAT and levies
Maps invoice lines onto the official ZRA tax labels: standard VAT 16% (A), lower (B), zero-rated (C), exempt (D), out-of-scope (E), plus the Tourism Levy 1.5% (TL) and Insurance Premium Levy 3% (IPL), reporting VAT and levies under separate totals.
TPIN validation
Real structural and mod-11 advisory checks for the 10-digit ZRA Taxpayer Identification Number, on your company and on partners, plus three-digit branch (bhfId) handling so input-VAT claims resolve.
VSDC client (BYOK)
Submit sales and credit notes and read back the receipt signature and internal data. Sandbox and production endpoints are pre-filled from ZRA's published VSDC hosts and remain fully editable. Your device serial and API key are bring-your-own-key and never leave your database.
Verification QR
Generates the ZRA invoice-verification QR (TPIN, branch, receipt signature and receipt number) plus a human-readable reference, rendered to a PNG for your document.
Built into invoicing
Validate, Generate and Lodge buttons live on the customer invoice, a Smart Invoice status follows the document state machine, and a posting hook flags posted invoices automatically. A guided onboarding wizard captures your TPIN, branch and VSDC connection in one step.
Built on the e-Invoice Core Engine
This connector reuses the shared e-Invoice Core Engine for canonical JSON building, the declarative validation framework, the BYOK REST transport and QR rendering — adding only the Zambia-specific tax model, field mapping and VSDC endpoints. Clean, auditable, no duplicated plumbing.
Compatible with Odoo 18 and Odoo 19 (Community and Enterprise).
Disclosure: this module transmits invoice data only to the ZRA VSDC endpoint you configure. No data is sent anywhere else, and your VSDC credentials never leave your database.
Odoo Proprietary License v1.0 This software and associated files (the "Software") may only be used (executed, modified, executed after modifications) if you have purchased a valid license from the authors, typically via Odoo Apps, or if you have received a written agreement from the authors of the Software (see the COPYRIGHT file). You may develop Odoo modules that use the Software as a library (typically by depending on it, importing it and using its resources), but without copying any source code or material from the Software. You may distribute those modules under the license of your choice, provided that this license is compatible with the terms of the Odoo Proprietary License (For example: LGPL, MIT, or proprietary licenses similar to this one). It is forbidden to publish, distribute, sublicense, or sell copies of the Software or modified copies of the Software. The above copyright notice and this permission notice must be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Please log in to comment on this module