DigiTax Zimbabwe API Hub: DigiTax API and ZIMRA fiscalisation

DigiTax Zimbabwe API Hub contains guides and API reference pages for further understanding, equipping you on how to integrate with ZIMRA's Fiscal Data Management System (FDMS) to issue fiscalised receipts.

The DigiTax API for ZIMRA fiscalisation

Navigation

If you're new to the DigiTax Zimbabwe API Hub, learn how to navigate our pages here.

Support

If you get stuck, or have questions, email us OR
Talk to us via the DigiTax chat on the bottom right of any page.

ZIMRA integration with DigiTax

Explore this page and other detailed guide pages to gain understanding of ZIMRA's FDMS and how DigiTax integration works.

DigiTax Zimbabwe API Reference

Get the pre-requisites, explore the API endpoints, and learn its feature set via our interactive API reference here.

DigiTax is Global. Explore other supported countries below ...

You are currently reading a guide in the DigiTax Zimbabwe API Hub.

If you're looking for another country or the general homepage for DigiTax API, navigate to the DigiTax API homepage, or country-specific API hub pages (ordered alphabetically):

Electronic Tax Invoicing in Zimbabwe

Countries globally have been opting to digitize their tax systems by imposing e-Invoicing or Electronic Tax Invoicing and Reporting. Electronic Tax Invoicing is a nascent Fintech category globally.

Zimbabwe is one of these countries. Its tax authority, ZIMRA (Zimbabwe Revenue Authority), requires VAT-registered businesses to issue every sale through a registered fiscal device that reports to its Fiscal Data Management System (FDMS). In this documentation, DigiTax Zimbabwe API Hub, we shall simply refer to them as ZIMRA and FDMS.

Introduction to ZIMRA and DigiTax platform

ZIMRA

ZIMRA is the tax authority of the Government of Zimbabwe. It administers taxes in Zimbabwe, including VAT, and runs FDMS, the system that receives, checks and records every fiscal receipt.

FDMS and fiscal devices

FDMS is ZIMRA's system for fiscalisation. Each taxpayer branch has a fiscal device registered with ZIMRA. The device numbers and signs every receipt, chains it to the previous one, and sends it to FDMS. Sales are grouped into fiscal days that are opened and closed with ZIMRA. Learn more on this guide page.

DigiTax platform

DigiTax platform constitutes a suite of digital solutions crafted for effective, simple, and painless tax compliance through electronic tax invoicing. These solutions enable taxpayers (individuals and businesses) to generate, digitally sign, and transmit compliant invoices as per the tax authority's requirements.

For Zimbabwe, DigiTax acts as your fiscal device in the cloud. It registers the device with ZIMRA, signs and numbers your receipts, sends them to FDMS, and opens and closes your fiscal days for you.

More about DigiTax

The suite of digital solutions or products under DigiTax, through which one can issue ZIMRA fiscal receipts, are:

  • DigiTax Dashboard (Responsive, Web-Browser based, Desktop application)
  • DigiTax API (for system-to-system integration without the issue of platform hopping)

DigiTax connects with regional tax authorities/ regulators, so far:

  • DigiTax Kenya integrates you with KRA eTIMS (Kenya Revenue Authority)
  • DigiTax Nigeria integrates you with NRS (Nigeria Revenue Service)
  • DigiTax Tanzania integrates you with TRA VFD (Tanzania Revenue Authority)
  • DigiTax UAE integrates you with FTA (Federal Tax Authority)
  • DigiTax Zambia integrates you with ZRA Smart Invoice (Zambia Revenue Authority)
  • DigiTax Zimbabwe integrates you with ZIMRA FDMS (Zimbabwe Revenue Authority)

to offer you a streamlined invoicing system that ensures compliance and supports the growth of your business.

DigiTax - Tax Regulators

DigiTax API Features

The DigiTax API is built with various industry standards for API platforms in mind. Read more on the general overview of the DigiTax API on this reference page.

We invite you to use DigiTax Zimbabwe API to integrate your system with ZIMRA for automation and to reduce platform-hopping

Before you integrate

ZIMRA's rules shape how an integration has to behave. These are the ones that catch integrators out:

🚧

Close of day: a fiscal day is not a calendar day

A fiscal day lasts at most a fixed number of hours from when it opens (tax_payer_day_max_hrs, which ZIMRA sets for your device). It can run past midnight. DigiTax opens the day with your first receipt and closes it automatically before that limit, so you never open or close a day yourself. However, ZIMRA won't let a day close while it holds a receipt graded Red or Grey. A Grey grade clears by itself, but a day with a Red receipt can only be closed in ZIMRA's portal. Read Fiscal days before going live.

  • Never issue a FLAGGED receipt again. Once ZIMRA has received a receipt, it is fiscalised, even if ZIMRA flagged it. Issue a credit note only if the sale itself was wrong. See Receipt statuses and validation.
  • Receipts are chained and sent in order. If ZIMRA refuses a receipt, sending stops for the whole device until the cause is fixed. You can still issue receipts while sending is stopped, but they stay PENDING.
  • Validate before you send. Read your device's tax IDs from GET /resources/tax-categories, send a buyer's TIN only together with their registered name, and make sure your totals add up. See Receipt types and fields.

Recap

Welcome to the Less Taxing solution - DigiTax.




Did this page help you?