Skip to main content

CloudESD

The CloudESD API enables merchants to digitally sign and fiscalize receipts in compliance with ZIMRA (Zimbabwe Revenue Authority) regulations. The API handles receipt signing, submission to ZIMRA, and device management.

Base URL: https://zw.cloudesd.africa

Quick Start Checklist​

  1. Obtain your bearer token and tenant ID from the CloudESD portal.
  2. Construct your Base64-encoded authorization header. See Authentication.
  3. Call GET /api/device/{zimraDeviceId} to confirm your device is active and to discover available tax types and percentages.
  4. Ensure the device's FiscalDayStatus is FiscalDayOpened. See Device Constraints.
  5. Submit receipts via POST /api/receipt/sign.
  6. Store the VerificationCode, ZimraDeviceId and GlobalCounter from the response for your records -- you will need those to generate the QR code on the printed receipt. See Receipt Signing for details on how to generate the QR code and print the receipt.
  7. For credit and debit notes, ensure you keep the original invoice Reference to pass as OriginalReference. See Credit & Debit Notes.
  8. Poll GET /api/receipt/{reference} to retrieve the details of a previously submitted receipt.

Permitted Currencies​

Currencies must be valid ZIMRA-supported ISO 4217 codes, although the API will accept ZIG and automatically convert it to ZWG on your behalf. If you submit an unsupported currency, the error response will list the permitted currency codes.