Get Items

The GetItemsAsync() method retrieves all product items saved in Smart Invoice, including details such as name, description, price, quantity, category, and more.

This helps taxpayers keep their local systems synchronized with the ZRA’s Smart Invoice platform.

---

GetItemsAsync() Method

This method retrieves the list of items registered under a taxpayer’s Smart Invoice profile.

• Request Parameters: NB: These details are stored in the configuration files
  • TPIN – Taxpayer Identification Number (string, required)
  • Branch Id (bhfId) – Unique branch identifier (string, required)
  • Last Request Date – Date/time of last item retrieval (string, optional, format: yyyyMMddHHmmss)

---

Usage

Example Successful Response

{
  "success": true,
  "code": "000",
  "message": "Operation completed successfully",
  "timestamp": "2025-09-19 10:33:26",
  "data": [
    {
      "tpin": "1002890781",
      "bhfId": "000",
      "itemCd": "MJPROD012",
      "itemClsCd": "4319150100",
      "itemTyCd": "2",
      "itemNm": "Coca Cola 500ml",
      "itemStdNm": "Coca Cola 500ml",
      "orgnNatCd": "ZM",
      "pkgUnitCd": "BOX",
      "qtyUnitCd": "U",
      "vatCatCd": "A",
      "iplCatCd": "",
      "tlCatCd": "",
      "exciseTxCatCd": "",
      "btchNo": "",
      "bcd": "1234567890123",
      "dftPrc": 15.0,
      "manufactuterTpin": null,
      "manufacturerItemCd": null,
      "rrp": 0.0,
      "svcChargeYn": null,
      "rentalYn": null,
      "addInfo": "",
      "sftyQty": 10.0,
      "isrcAplcbYn": null,
      "useYn": null,
      "regrNm": null,
      "regrId": null,
      "modrNm": null,
      "modrId": null
    },
    {
      "tpin": "1002890781",
      "bhfId": "000",
      "itemCd": "TEST002",
      "itemClsCd": "4319150100",
      "itemTyCd": "2",
      "itemNm": "Test Product",
      "itemStdNm": "",
      "orgnNatCd": "ZM",
      "pkgUnitCd": "BOX",
      "qtyUnitCd": "U",
      "vatCatCd": "A",
      "iplCatCd": "",
      "tlCatCd": "",
      "exciseTxCatCd": "",
      "btchNo": "",
      "bcd": "",
      "dftPrc": 100.0,
      "manufactuterTpin": null,
      "manufacturerItemCd": null,
      "rrp": 0.0,
      "svcChargeYn": null,
      "rentalYn": null,
      "addInfo": "",
      "sftyQty": 0.0,
      "isrcAplcbYn": null,
      "useYn": null,
      "regrNm": null,
      "regrId": null,
      "modrNm": null,
      "modrId": null
    }
  ],
  "error": null
}