API Endpoints Reference

Comprehensive REST API endpoint specifications for Mutero Virtual Fiscal Device Services.

Authentication Requirement

All endpoints require a valid Bearer API Key passed in the Authorization header (`Authorization: Bearer YOUR_API_KEY`).

POST

/vfd/receipts

Submit a new invoice or sales receipt payload for ZIMRA fiscal signing and QR verification URL generation.

Sample JSON Response (200 OK)json

{
  "success": true,
  "receipt_number": "ZIMRA-2026-0098475",
  "verification_url": "https://fdms.zimra.co.zw/verify/ZIMRA-2026-0098475",
  "zimra_signature": "MEQCID3k8A...=="
}

GET

/vfd/devices

List all active Virtual Fiscal Devices registered for your business.

Sample JSON Response (200 OK)json

{
  "devices": [
    {
      "id": "65f4e3a2b1c",
      "device_serial": "VFD-ZW-2026-0012",
      "status": "ACTIVE",
      "fiscal_day_open": true
    }
  ]
}

POST

/vfd/fiscal-days/open

Open a new 24-hour ZIMRA fiscal day for a Virtual Fiscal Device.

Sample JSON Response (200 OK)json

{
  "success": true,
  "fiscal_day_no": 142,
  "opened_at": "2026-08-01T06:00:00Z"
}

POST

/vfd/fiscal-days/close

Close current fiscal day and generate the official ZIMRA Z-Report summary.

Sample JSON Response (200 OK)json

{
  "success": true,
  "fiscal_day_no": 142,
  "total_sales": 15450.00,
  "total_vat": 2015.22,
  "z_report_signature": "MEQCIF98b...=="
}

GET

/vfd/integrations/tax-mapping

Retrieve tax code mapping rules configured for your accounting integrations.

Sample JSON Response (200 OK)json

{
  "mappings": [
    {
      "platform": "zoho_books",
      "external_tax_code": "V15",
      "zimra_tax_id": 1,
      "hs_code_default": "8471.30.00"
    }
  ]
}