Device Initialization

Every fiscal device in Zambia must be registered with the ZRA (Zambia Revenue Authority) using three key identifiers which are stored in the configuration file:

• TPIN: The taxpayer’s identification number.
• Branch ID (bhfId): The unique identifier for the taxpayer’s branch.
• Device Serial Number (dvcSrlNo): The manufacturer-assigned serial number of the fiscal device.

These values are supplied when initializing the device.

InitializeDeviceAsync() method

This method is used to register and initialize a fiscal device with the ZRA fiscalization platform and it takes the above 3 parameters. It ensures the device is linked with the taxpayer’s credentials and branch information.

If the device is already initialized locally, it will return the existing device information instead of re-registering.

Usage

Device Initialization Response

{
  "success": true,
  "code": "000",
  "message": "Device already initialized locally",
  "timestamp": "2025-09-19 10:23:14",
  "data": {
    "tpin": "1002890781",
    "taxprNm": "Headquarter",
    "bsnsActv": null,
    "bhfId": "000",
    "bhfNm": "Headquarter",
    "bhfOpenDt": null,
    "prvncNm": "LUSAKA PROVINCE",
    "dstrtNm": "ISMTO_Lusaka",
    "sctrNm": "Lusaka",
    "locDesc": "",
    "hqYn": "Y",
    "mgrNm": "AXIS SOLUTIONS AFRICA LIMITED",
    "mgrTelNo": "0979196169",
    "mgrEmail": "accountszm@axissolafrica.com",
    "sdcId": "REVMAX-SMARTINV-001",
    "mrcNo": null,
    "lastSaleInvcNo": 0,
    "lastPchsInvcNo": 0,
    "lastSaleRcptNo": 0,
    "lastInvcNo": 0,
    "lastTrainInvcNo": 0,
    "lastProfrmInvcNo": 0,
    "lastCopyInvcNo": 0
  },
  "error": null
}