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:
| Field | What it tells you |
|---|---|
status | UNREGISTERED 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_test | true for ZIMRA's test environment, whose receipts carry no tax effect. false for production. Set when the business was created |
is_live | Whether the device is set up to transact in that environment |
zimra_device_id, device_serial_no | The device as registered with ZIMRA. Empty until it is registered |
tax_identification_number, vat_number, branch_name, branch_address | The taxpayer and branch details ZIMRA holds. vat_number is empty for a taxpayer not registered for VAT |
tax_payer_day_max_hrs | The longest a fiscal day may stay open, in hours |
last_fiscal_day_no, last_receipt_global_no | ZIMRA's counters. The next day and receipt are numbered one higher |
certificate_valid_till | When the device's certificate expires. DigiTax renews it before then |
receipt_submission | Whether 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: trueandis_live: trueand 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 isACTIVE,is_liveturnstrueand your receipts go to ZIMRA's production FDMS.
Learn more
Updated about 2 hours ago