ZIMRA and the Fiscal Data Management System

How ZIMRA's FDMS works, and how DigiTax acts as your fiscal device

ZIMRA

The Zimbabwe Revenue Authority (ZIMRA) administers taxes in Zimbabwe, including VAT. ZIMRA requires VAT-registered businesses to fiscalise their sales: every receipt is issued through a fiscal device that ZIMRA has registered, and is reported to ZIMRA.

FDMS

The Fiscal Data Management System (FDMS) is ZIMRA's system for receiving and checking fiscal receipts. FDMS:

  • registers fiscal devices and issues each one a certificate
  • gives each device its configuration, such as its taxes, the longest a fiscal day may stay open and how often the device must report in
  • receives each receipt, grades it Red, Grey or Yellow if it breaks a rule, and keeps ZIMRA's totals for the day
  • opens and closes fiscal days, the periods that receipts are grouped into and reported by

Fiscal devices

A fiscal device numbers, signs and sends receipts. Each receipt carries:

  • a receipt counter, which restarts at 1 on each fiscal day, and a receipt global number, which keeps counting across days
  • a hash of its contents, chained to the previous receipt of the same day, and the device's signature over that hash
  • a verification code and a QR code that a buyer can use to check the receipt with ZIMRA

Because receipts are chained, they must reach ZIMRA in order. A gap or a refused receipt affects the receipts after it. See Receipt statuses and validation.

DigiTax as your fiscal device

With DigiTax, you don't need hardware. DigiTax holds the device's certificate securely and does the device's work for you:

  • Registration. DigiTax registers your device with ZIMRA, using the device ID and activation key ZIMRA issued to you.
  • Certificates. Each device authenticates to FDMS with its own certificate (mutual TLS). DigiTax renews it automatically before it expires (certificate_valid_till).
  • Receipts. DigiTax checks, numbers, signs and stores each receipt as soon as you issue it, then sends it to FDMS in the background.
  • Fiscal days. DigiTax opens a fiscal day with your first receipt and closes it automatically before ZIMRA's time limit. See Fiscal days.
  • Reporting in. DigiTax pings FDMS as often as ZIMRA's configuration asks (reporting_frequency_minutes).

Your device's registration

GET /fdms-info returns your device as ZIMRA holds it:

FieldWhat it tells you
statusUNREGISTERED until the device is registered, PENDING while registration completes, ACTIVE once it holds a valid certificate, FAILED if ZIMRA rejected the registration (see status_reason), BLOCKED if it can't fiscalise
is_testtrue for ZIMRA's test environment, whose receipts carry no tax effect. false for production. Set when the business was created
is_liveWhether the device is set up to transact in that environment
zimra_device_id, device_serial_noThe device as registered with ZIMRA. Empty until it is registered
tax_identification_number, vat_number, branch_name, branch_addressThe taxpayer and branch details ZIMRA holds. vat_number is empty for a taxpayer not registered for VAT
tax_payer_day_max_hrsThe longest a fiscal day may stay open, in hours
last_fiscal_day_no, last_receipt_global_noZIMRA's counters. The next day and receipt are numbered one higher
certificate_valid_tillWhen the device's certificate expires. DigiTax renews it before then
receipt_submissionWhether sending receipts to ZIMRA is running or halted, and how many receipts are waiting. See Receipt statuses and validation

Test and production

  • A test business is linked to a test device that DigiTax has already registered on ZIMRA's test FDMS, so it shows is_test: true and is_live: true and can issue receipts straight away. That device is shared with other test businesses. See Prerequisites.
  • A production business starts UNREGISTERED. To go live, get your device ID and activation key from ZIMRA and contact DigiTax support to register the device. Once it is ACTIVE, is_live turns true and your receipts go to ZIMRA's production FDMS.

Learn more


Did this page help you?