Skip to Content
Odoo Menu
  • Sign in
  • Try it free
  • Apps
    Finance
    • Accounting
    • Invoicing
    • Expenses
    • Spreadsheet (BI)
    • Documents
    • Sign
    Sales
    • CRM
    • Sales
    • POS Shop
    • POS Restaurant
    • Subscriptions
    • Rental
    Websites
    • Website Builder
    • eCommerce
    • Blog
    • Forum
    • Live Chat
    • eLearning
    Supply Chain
    • Inventory
    • Manufacturing
    • PLM
    • Purchase
    • Maintenance
    • Quality
    Human Resources
    • Employees
    • Recruitment
    • Time Off
    • Appraisals
    • Referrals
    • Fleet
    Marketing
    • Social Marketing
    • Email Marketing
    • SMS Marketing
    • Events
    • Marketing Automation
    • Surveys
    Services
    • Project
    • Timesheets
    • Field Service
    • Helpdesk
    • Planning
    • Appointments
    Productivity
    • Discuss
    • Approvals
    • IoT
    • VoIP
    • Knowledge
    • WhatsApp
    Third party apps Odoo Studio Odoo Cloud Platform
  • Industries
    Retail
    • Book Store
    • Clothing Store
    • Furniture Store
    • Grocery Store
    • Hardware Store
    • Toy Store
    Food & Hospitality
    • Bar and Pub
    • Restaurant
    • Fast Food
    • Guest House
    • Beverage Distributor
    • Hotel
    Real Estate
    • Real Estate Agency
    • Architecture Firm
    • Construction
    • Property Management
    • Gardening
    • Property Owner Association
    Consulting
    • Accounting Firm
    • Odoo Partner
    • Marketing Agency
    • Law firm
    • Talent Acquisition
    • Audit & Certification
    Manufacturing
    • Textile
    • Metal
    • Furnitures
    • Food
    • Brewery
    • Corporate Gifts
    Health & Fitness
    • Sports Club
    • Eyewear Store
    • Fitness Center
    • Wellness Practitioners
    • Pharmacy
    • Hair Salon
    Trades
    • Handyman
    • IT Hardware & Support
    • Solar Energy Systems
    • Shoe Maker
    • Cleaning Services
    • HVAC Services
    Others
    • Nonprofit Organization
    • Environmental Agency
    • Billboard Rental
    • Photography
    • Bike Leasing
    • Software Reseller
    Browse all Industries
  • Community
    Learn
    • Tutorials
    • Documentation
    • Certifications
    • Training
    • Blog
    • Podcast
    Empower Education
    • Education Program
    • Scale Up! Business Game
    • Visit Odoo
    Get the Software
    • Download
    • Compare Editions
    • Releases
    Collaborate
    • Github
    • Forum
    • Events
    • Translations
    • Become a Partner
    • Services for Partners
    • Register your Accounting Firm
    Get Services
    • Find a Partner
    • Find an Accountant
      • Get a Tailored Demo
    • Implementation Services
    • Customer References
    • Support
    • Upgrades
    Github Youtube Twitter Linkedin Instagram Facebook Spotify
    +32 2 290 34 90
    • Get a Tailored Demo
  • Pricing
  • Help
  1. APPS
  2. Localizations
  3. ZRA Smart Invoice — Base (Zambia) v 17.0
  4. Sales Conditions FAQ

ZRA Smart Invoice — Base (Zambia)

by AminiTech Solutions https://www.aminitechsolutions.com
Odoo
v 17.0 Third Party 2
Download for v 17.0 Deploy on Odoo.sh
Apps purchases are linked to your Odoo account, please sign in or sign up first.
Versions 17.0 18.0 19.0
You bought this module and need support? Click here!
Availability
Odoo Online
Odoo.sh
On Premise
Odoo Apps Dependencies Discuss (mail)
Lines of code 1565
Technical Name aminitech_zra_base
LicenseOPL-1
Websitehttps://www.aminitechsolutions.com
Versions 17.0 18.0 19.0
  • Description
  • Manifest
  • License
Free · For Odoo 17 · Community & Enterprise

ZRA Smart Invoice — Base (Zambia)

The free configuration layer for the AminiTech ZRA Smart Invoice suite. Connect to your VSDC, enter your taxpayer identity, validate customer TPINs and flip the transmission switch — then let the paid apps do the declaring. On its own the Base fiscalises nothing.

✅ Free ✅ Configuration only ✅ Direct to your own VSDC / OSDC
ZRA Smart Invoice — Base (Zambia)
Overview

Configure once — the paid apps do the rest

Set the connection up here, then install ZRA Invoicing, POS or Stock to declare documents through it. The Base declares nothing itself.

ZRA Smart Invoice settings: VSDC connection, TPIN, branch and device
01 · Connect

Configure once, in one place

One settings page holds everything the suite needs: your VSDC connection for Sandbox and Production, your 10-digit TPIN, the 3-character branch ID, the device serial, and the Initialize Device / Test Connection buttons. Set it up, and every paid app declares through this connection.

02 · Validate

Check a customer’s TPIN before you invoice

Every contact gains a Check TIN (ZRA) button that validates the TPIN against the ZRA and writes back the registered taxpayer name, a Valid/Invalid badge and the date checked. A thirty-second check that prevents a rejected declaration later.

A contact showing a validated ZRA TPIN with the registered name
The ZRA Smart Invoice User / Manager / Administrator roles
03 · Control

Three roles, credentials only admins can see

The Base installs the “ZRA Smart Invoice (Zambia)” privilege with three nested roles — User, Manager and Administrator. Only an Administrator sees the VSDC settings and keys; a multi-company rule keeps each company’s data to itself.

Configuration

Everything you configure, at a glance

✓
Transmission on/off
A single switch sends declarations in real time or holds them in the queue — per company.
✓
Sandbox & Production
Separate connection sets and a one-click switch; validate on the sandbox, then go live without retyping.
✓
One-click device init
Initialize Device runs the selectInitInfo handshake and stores your SDC ID, MRC No and keys.
✓
Connection test
Confirm the VSDC is reachable and your credentials are accepted before you declare anything.
✓
Keys stay in the VSDC
No client-side crypto to configure — the local VSDC holds the device keys.
✓
Endpoint overrides
Per-company JSON overrides for the paths your provisioned VSDC actually exposes.
✓
Default item class
A company-level UNSPSC fallback so declared lines are always coherent.
✓
Multi-company
Every setting is per company, each with its own connection, identity and queue.

The apps that do the work

Buy only what you need on this free Base, or take the all-in-one Suite.

ZRA Base
ZRA Base
Free engine · current
ZRA Invoicing
ZRA Invoicing
E-invoicing · view app
ZRA POS
ZRA POS
Point of Sale · view app
ZRA Stock
ZRA Stock
Stock & traders · view app
ZRA Manufacturing
ZRA Manufacturing
Manufacturing · view app
ZRA Importers
ZRA Importers
Imports · view app
ZRA Pro
ZRA Pro
Control tower · view app
ZRA Suite
ZRA Suite
All-in-one · view app

Frequently asked

Is the Base really free, and configuration-only?

Yes on both. It stores your VSDC connection and identity, validates TPINs, and carries the transmission switch. It declares no invoice, sale or stock on its own — add a paid app for that.

Do I need a VSDC before I install this?

Yes. ZRA Smart Invoice is reached through a VSDC you run yourself (a Java bridge, e.g. http://localhost:8080/zravsdc) or the ZRA’s hosted OSDC. Register your device on the Smart Invoice Taxpayer Portal, point the connector at it, and click Initialize Device.

Where does my data go?

From your database straight to the VSDC or OSDC you configured, and nowhere else. No third-party service sits in between.

Does it handle several companies or branches?

Yes — every setting is per company, each keeps its own number series, and a record rule keeps each company’s data to itself.

ZRA, Smart Invoice and the Zambia Revenue Authority name are the property of the Zambia Revenue Authority and are used here only to identify the system this connector integrates with. AminiTech Solutions is an independent software vendor and is not affiliated with, or endorsed by, the ZRA.

Availability
Odoo Online
Odoo.sh
On Premise
Odoo Apps Dependencies Discuss (mail)
Lines of code 1565
Technical Name aminitech_zra_base
LicenseOPL-1
Websitehttps://www.aminitechsolutions.com
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

  • The author can leave a single reply to each comment.
  • This section is meant to ask simple questions or leave a rating. Every report of a problem experienced while using the module should be addressed to the author directly (refer to the following point).
  • If you want to start a discussion with the author, please use the developer contact information. They can usually be found in the description.
Community
  • Tutorials
  • Documentation
  • Forum
Open Source
  • Download
  • Github
  • Runbot
  • Translations
Services
  • Odoo.sh Hosting
  • Support
  • Upgrade
  • Custom Developments
  • Education
  • Find an Accountant
  • Find a Partner
  • Become a Partner
About us
  • Our company
  • Brand Assets
  • Contact us
  • Jobs
  • Events
  • Podcast
  • Blog
  • Customers
  • Legal • Privacy
  • Security

Odoo is a suite of open source business apps that cover all your company needs: CRM, eCommerce, accounting, inventory, point of sale, project management, etc.

Odoo's unique value proposition is to be at the same time very easy to use and fully integrated.

Website made with