Get Standard Codes

The GetStandardCodesAsync() method facilitates access to predefined values utilized in API requests to represent specific attributes concisely.
These constant codes convey essential information such as:

Units of measurement
Packaging units
Sale types
Product types
Taxation types
Commercial invoice statuses, etc.

These codes must be retrieved and stored locally in the taxpayer’s system to ensure consistent and valid transaction requests.

GetStandardCodesAsync() Method

This method is used to retrieve a comprehensive list of standard codes along with their descriptions from the ZRA fiscalization system.
The retrieved values must be stored in the taxpayer’s system for use in subsequent transaction requests.

Request Parameters:
NB: These details are stored in the configuration files
- TPIN – Taxpayer Identification Number
- Branch Id – Unique branch identifier
- Last Request Date – (Optional) If provided, only codes updated since this date will be returned

Usage

Example Successful Response

{
  "success": true,
  "code": "000",
  "message": "Device already initialized locally",
  "timestamp": "2025-09-19 15:42:46",
  "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
}

Main Menu:
1. Device Initialization
2. Code Data Operations
3. Item Operations
4. Sales Operations
5. Purchase Operations
6. Stock Operations
7. Import Operations
8. Commercial Invoice Operations
9. RRP Operations
10. Principal Operations
11. Invoice Query Operations
12. Branch Operations
13. Exit
Select an option: 2

Code Data Operations Test
=========================
1. Get Standard Codes
2. Get Classification Codes
Select an option: 1
15:43:05 INFO Getting standard codes with 25 second timeout
15:43:05 INFO Using 926 cached standard codes
15:43:05 INFO Retrieved 926 standard codes successfully
Raw JSON Response:
{
  "success": true,
  "code": "000",
  "message": "Operation completed successfully",
  "timestamp": "2025-09-19 15:43:05",
  "data": [
    {
      "cdCls": "04",
      "cdClsNm": "Taxation Type",
      "cd": "A",
      "cdNm": "Standard Rated(16%)",
      "userDfnNm1": null
    },
    {
      "cdCls": "04",
      "cdClsNm": "Taxation Type",
      "cd": "B",
      "cdNm": "Minimum Taxable Value (MTV-16%)",
      "userDfnNm1": null
    },
    {
      "cdCls": "04",
      "cdClsNm": "Taxation Type",
      "cd": "C1",
      "cdNm": "Exports(0%)",
      "userDfnNm1": null
    },
    {
      "cdCls": "04",
      "cdClsNm": "Taxation Type",
      "cd": "C2",
      "cdNm": "Zero-rating LPO",
      "userDfnNm1": null
    },
    {
      "cdCls": "04",
      "cdClsNm": "Taxation Type",
      "cd": "C3",
      "cdNm": "Zero-rated by nature",
      "userDfnNm1": null
    },
    {
      "cdCls": "04",
      "cdClsNm": "Taxation Type",
      "cd": "D",
      "cdNm": "Exempt",
      "userDfnNm1": null
    },
    {
      "cdCls": "04",
      "cdClsNm": "Taxation Type",
      "cd": "RVAT",
      "cdNm": "Reverse VAT",
      "userDfnNm1": null
    },
    {
      "cdCls": "04",
      "cdClsNm": "Taxation Type",
      "cd": "E",
      "cdNm": "Disbursement",
      "userDfnNm1": null
    },
    {
      "cdCls": "04",
      "cdClsNm": "Taxation Type",
      "cd": "TOT",
      "cdNm": "TOT",
      "userDfnNm1": null
    },
    {
      "cdCls": "05",
      "cdClsNm": "Country",
      "cd": "AC",
      "cdNm": "ASCENSION ISLAND ",
      "userDfnNm1": null
    },
    {
      "cdCls": "05",
      "cdClsNm": "Country",
      "cd": "AD",
      "cdNm": "ANDORRA",
      "userDfnNm1": null
    },
    {
      "cdCls": "05",
      "cdClsNm": "Country",
      "cd": "AE",
      "cdNm": "UNITED ARAB EMIRATES ",
      "userDfnNm1": null
    },
    {
      "cdCls": "05",
      "cdClsNm": "Country",
      "cd": "AG",
      "cdNm": "ANTIGUA AND BARBUDA",
      "userDfnNm1": null
    },
    {
      "cdCls": "05",
      "cdClsNm": "Country",
      "cd": "AI",
      "cdNm": "ANGUILLA",
      "userDfnNm1": null
    },
    {
      "cdCls": "05",
      "cdClsNm": "Country",
      "cd": "AL",
      "cdNm": "ALBANIA ",
      "userDfnNm1": null
    },
    {
      "cdCls": "05",
      "cdClsNm": "Country",
      "cd": "AM",
      "cdNm": "ARMENIA",
      "userDfnNm1": null
    },
    {
      "cdCls": "05",
      "cdClsNm": "Country",
      "cd": "AN",
      "cdNm": "NETHERLANDS ANTILLES ",
      "userDfnNm1": null
    },
    {
      "cdCls": "05",
      "cdClsNm": "Country",
      "cd": "AO",
      "cdNm": "ANGOLA",
      "userDfnNm1": null
    },
    {
      "cdCls": "05",
      "cdClsNm": "Country",
      "cd": "AQ",
      "cdNm": "ANTARCTICA",
      "userDfnNm1": null
    },
    {
      "cdCls": "05",
      "cdClsNm": "Country",
      "cd": "AR",
      "cdNm": "ARGENTINA",
      "userDfnNm1": null
    },
    {
      "cdCls": "05",
      "cdClsNm": "Country",
      "cd": "AS",
      "cdNm": "AMERICAN SAMOA",
      "userDfnNm1": null
    },
    {
      "cdCls": "05",
      "cdClsNm": "Country",
      "cd": "AT",
      "cdNm": "AUSTRIA",
      "userDfnNm1": null
    },
    {
      "cdCls": "05",
      "cdClsNm": "Country",
      "cd": "AU",
      "cdNm": "AUSTRALIA",
      "userDfnNm1": null
    },
    {
      "cdCls": "05",
      "cdClsNm": "Country",
      "cd": "AW",
      "cdNm": "ARUBA",
      "userDfnNm1": null
    },
    {
      "cdCls": "05",
      "cdClsNm": "Country",
      "cd": "AX",
      "cdNm": "ALAND ISLANDS",
      "userDfnNm1": null
    },
    {
      "cdCls": "05",
      "cdClsNm": "Country",
      "cd": "AZ",
      "cdNm": "AZERBAIJAN",
      "userDfnNm1": null
    },
    {
      "cdCls": "05",
      "cdClsNm": "Country",
      "cd": "BA",
      "cdNm": "BOSNIA AND HERZEGOVINA ",
      "userDfnNm1": null
    },
    {
      "cdCls": "05",
      "cdClsNm": "Country",
      "cd": "BB",
      "cdNm": "BARBADOS ",
      "userDfnNm1": null
    },
    {
      "cdCls": "05",
      "cdClsNm": "Country",
      "cd": "BD",
      "cdNm": "BANGLADESH ",
      "userDfnNm1": null
    },
    {
      "cdCls": "05",
      "cdClsNm": "Country",
      "cd": "BE",
      "cdNm": "BELGIUM ",
      "userDfnNm1": null
    },
    {
      "cdCls": "05",
      "cdClsNm": "Country",
      "cd": "BF",
      "cdNm": "BURKINA FASO ",
      "userDfnNm1": null
    },
    {
      "cdCls": "05",
      "cdClsNm": "Country",
      "cd": "BG",
      "cdNm": "BULGARIA ",
      "userDfnNm1": null
    },
    {
      "cdCls": "05",
      "cdClsNm": "Country",
      "cd": "BH",
      "cdNm": "BAHRAIN",
      "userDfnNm1": null
    },
    {
      "cdCls": "05",
      "cdClsNm": "Country",
      "cd": "BI",
      "cdNm": "BURUNDI ",
      "userDfnNm1": null
    },
    {
      "cdCls": "05",
      "cdClsNm": "Country",
      "cd": "BJ",
      "cdNm": "BENIN ",
      "userDfnNm1": null
    },
    {
      "cdCls": "05",
      "cdClsNm": "Country",
      "cd": "BM",
      "cdNm": "BERMUDA ",
      "userDfnNm1": null
    },
    {
      "cdCls": "05",
      "cdClsNm": "Country",
      "cd": "BN",
      "cdNm": "BRUNEI DARUSSALAM ",
      "userDfnNm1": null
    },
    {
      "cdCls": "05",
      "cdClsNm": "Country",
      "cd": "BO",
      "cdNm": "BOLIVIA ",
      "userDfnNm1": null
    },
    {
      "cdCls": "05",
      "cdClsNm": "Country",
      "cd": "BR",
      "cdNm": "BRAZIL ",
      "userDfnNm1": null
    },
    {
      "cdCls": "05",
      "cdClsNm": "Country",
      "cd": "BS",
      "cdNm": "BAHAMAS ",
      "userDfnNm1": null
    },
    {
      "cdCls": "05",
      "cdClsNm": "Country",
      "cd": "BT",
      "cdNm": "BHUTAN ",
      "userDfnNm1": null
    },
    {
      "cdCls": "05",
      "cdClsNm": "Country",
      "cd": "BV",
      "cdNm": "BOUVET ISLAND ",
      "userDfnNm1": null
    },
    {
      "cdCls": "05",
      "cdClsNm": "Country",
      "cd": "BW",
      "cdNm": "BOTSWANA ",
      "userDfnNm1": null
    },
    {
      "cdCls": "05",
      "cdClsNm": "Country",
      "cd": "BY",
      "cdNm": "BELARUS ",
      "userDfnNm1": null
    },
    {
      "cdCls": "05",
      "cdClsNm": "Country",
      "cd": "BZ",
      "cdNm": "BELIZE ",
      "userDfnNm1": null
    },
    {
      "cdCls": "05",
      "cdClsNm": "Country",
      "cd": "CA",
      "cdNm": "CANADA ",
      "userDfnNm1": null
    },
    {
      "cdCls": "05",
      "cdClsNm": "Country",
      "cd": "CC",
      "cdNm": "COCOS (KEELING) ISLANDS ",
      "userDfnNm1": null
    },
    {
      "cdCls": "05",
      "cdClsNm": "Country",
      "cd": "CD",
      "cdNm": "CONGO, DEMOCRATIC REPUBLIC ",
      "userDfnNm1": null
    },
    {
      "cdCls": "05",
      "cdClsNm": "Country",
      "cd": "PT",
      "cdNm": "PORTUGAL ",
      "userDfnNm1": null
    },
    {
      "cdCls": "05",
      "cdClsNm": "Country",
      "cd": "PW",
      "cdNm": "PALAU ",
      "userDfnNm1": null
    },
    {
      "cdCls": "05",
      "cdClsNm": "Country",
      "cd": "PY",
      "cdNm": "PARAGUAY ",
      "userDfnNm1": null
    },
    {
      "cdCls": "05",
      "cdClsNm": "Country",
      "cd": "QA",
      "cdNm": "QATAR ",
      "userDfnNm1": null
    },
    {
      "cdCls": "05",
      "cdClsNm": "Country",
      "cd": "RE",
      "cdNm": "REUNION ",
      "userDfnNm1": null
    },
    {
      "cdCls": "05",
      "cdClsNm": "Country",
      "cd": "RO",
      "cdNm": "ROMANIA ",
      "userDfnNm1": null
    },
    {
      "cdCls": "05",
      "cdClsNm": "Country",
      "cd": "RS",
      "cdNm": "SERBIA ",
      "userDfnNm1": null
    },
    {
      "cdCls": "05",
      "cdClsNm": "Country",
      "cd": "RU",
      "cdNm": "RUSSIAN FEDERATION ",
      "userDfnNm1": null
    },
    {
      "cdCls": "05",
      "cdClsNm": "Country",
      "cd": "RW",
      "cdNm": "RWANDA ",
      "userDfnNm1": null
    },
    {
      "cdCls": "05",
      "cdClsNm": "Country",
      "cd": "SA",
      "cdNm": "SAUDI ARABIA ",
      "userDfnNm1": null
    },
    {
      "cdCls": "05",
      "cdClsNm": "Country",
      "cd": "SB",
      "cdNm": "SOLOMON ISLANDS ",
      "userDfnNm1": null
    },
    {
      "cdCls": "05",
      "cdClsNm": "Country",
      "cd": "SC",
      "cdNm": "SEYCHELLES ",
      "userDfnNm1": null
    },
    {
      "cdCls": "05",
      "cdClsNm": "Country",
      "cd": "SD",
      "cdNm": "SUDAN ",
      "userDfnNm1": null
    },
    {
      "cdCls": "05",
      "cdClsNm": "Country",
      "cd": "SE",
      "cdNm": "SWEDEN ",
      "userDfnNm1": null
    },
    {
      "cdCls": "05",
      "cdClsNm": "Country",
      "cd": "SG",
      "cdNm": "SINGAPORE ",
      "userDfnNm1": null
    }
}

Getting Started

Branches

Standard Codes

Items

Sales Operations

Purchases Operations

Stock Information

Import Information

RRP Operations

Principal Operations

Invoice Query Operations

Get Standard Codes