Fiscal Devices

Learn how to register, activate, and manage fiscal devices for ZIMRA compliance.

Available to:
Business Owner Manager

Understanding Fiscal Devices

Fiscal devices are essential for ZIMRA compliance in Zimbabwe.

A fiscal device is a certified electronic device that records all sales transactions and transmits them to ZIMRA. In VasBox, these are virtual fiscal devices managed through software.

Why Required?

ZIMRA mandates fiscal devices to ensure accurate tax collection and prevent revenue leakage.

Device-Branch Link

Each device is assigned to a specific branch. Transactions are recorded against that branch.

Virtual vs Physical Devices

VasBox uses virtual fiscal devices, which means no physical hardware is required. All fiscalization happens through secure software integration with ZIMRA.

Device Lifecycle

Every fiscal device goes through these stages from creation to operation.

Step 1

Create Entry

Add device details to VasBox

Step 2

Register with ZIMRA

Submit to ZIMRA for approval

Step 3

Await Approval

ZIMRA reviews registration

Step 4

Activate

Activate after approval

Step 5

Ready for Use

Process transactions

Device Status Meanings

Pending Awaiting registration
Registered Registered, awaiting activation
Active Ready for transactions
Suspended Temporarily disabled
Blocked Blocked by ZIMRA

Viewing Your Devices

Access and monitor all fiscal devices from the device management page.

Device Management
app.vasbox.co.zw

Fiscal Devices

Add Device
HQ-DEVICE-001
Headquarters Branch
Active Cert: Valid
Last sync: 2 minutes ago
DT-DEVICE-002
Downtown Branch
Pending
Awaiting ZIMRA approval
1
2
3
View and manage all your fiscal devices
  1. 1Click to register a new fiscal device
  2. 2Current device status (Pending, Active, etc.)
  3. 3Certificate validity indicator

Registering a New Device

Step-by-step guide to register a fiscal device with ZIMRA.

Prerequisites

  • Active VasBox subscription
  • At least one branch configured
  • Business ZIMRA integration active
1
Navigate to Device Management

Go to Dashboard → Devices and click the Add Device button.

2
Enter Device Information

Fill in the required device details:

Device Registration Form
app.vasbox.co.zw
e.g., VB-2024-001234
VasBox Virtual
Select branch...
Online (Recommended)
Enter device details for ZIMRA registration
3
Submit for Registration

Click Register Device to submit to ZIMRA. The device will enter Pending status while ZIMRA processes the registration.

4
Wait for ZIMRA Approval

ZIMRA typically processes registrations within 24-48 hours. You'll see the status change to Registered when approved.

Activating a Device

After registration approval, activate your device to start processing transactions.

1
Verify Registration Complete

Ensure the device status shows Registered before proceeding.

2
Initiate Activation

Click the Activate button on the device card. VasBox will request activation from ZIMRA.

3
Certificate Generation

Upon activation, ZIMRA generates a digital certificate for your device. This certificate authenticates all transactions.

Certificate propagation

Certificate propagation can take up to 4 hours. During this time, some operations may be limited. Wait for the certificate status to show "Valid" before processing transactions.
4
Verify Activation

Once complete, the device status will show Active and certificate status will show Valid.

Certificate Management

Understanding and managing device certificates.

Device certificates are digital credentials that authenticate your device with ZIMRA. They have an expiration date and must be renewed periodically.

Certificate Status Types

Pending Certificate being generated
Active Certificate valid and operational
Expired Certificate needs renewal

Certificate renewal

VasBox automatically notifies you when certificates are approaching expiration. Renew promptly to avoid service interruption.

Device Operations

Day-to-day device management tasks.

Ping Device

Test connectivity with ZIMRA. Use this to verify your device can communicate with ZIMRA servers.

Check Status

Retrieve current device status from ZIMRA, including sync status and configuration.

Refresh Configuration

Pull latest tax configurations and settings from ZIMRA.

Suspend Device

Temporarily disable a device. Use when replacing hardware or troubleshooting.

Troubleshooting

Common device issues and how to resolve them.

Registration stuck at Pending

If registration remains pending for more than 48 hours:
  • Verify your TIN and VAT numbers are correct
  • Check your ZIMRA station assignment
  • Contact ZIMRA directly if the issue persists

Activation failures

If activation fails:
  • Ensure registration was successful first
  • Wait a few minutes and retry
  • Check your internet connection

Certificate not propagating

If the certificate status remains "Pending" after 4 hours:
  • Try refreshing the device configuration
  • Contact VasBox support for assistance