Kumusoft Solutions
EFRIS API
Auth Service
EFRIS API
Auth Service
  1. EFRIS API
  • Get Current Taxpayer Details
    GET
  • Update AES Key
    POST
  • Get Efris Stock Items
    GET
  • Update Stock List
    POST
  • Verify TIN
    GET
  • Fiscalise
    POST
  • Preview Invoice
    POST
  • Issue CreditNote
    POST
  • Register EFRIS Product
    POST
  • Get Units Of Measure
    GET
  • Increase Stock
    POST
  • EFRIS Invoice Report
    POST
  • Invoice Details
    GET
  • Get Saved Items List
    GET
  • Get Master Data
    GET
  • Reduce stock
    POST
  1. EFRIS API

Get Efris Stock Items

GET
/efris/stock-items

Endpoint: Get Stock Items#

Retrieve stock items from EFRIS.
Method: GET
URL: {{baseUrl}}/efris/stock-items
Auth/Permissions: Ensure you have valid credentials and permission to access stock information. This endpoint is read-only.
EFRIS Document Page Number: 161
Interface Name: Goods/Services Inquiry
Interface Code: T127

Response#

On success, returns HTTP 200 with a JSON object containing:
success (boolean): Indicates whether the request was processed successfully.
msg (string): Status message from the server.
items (array of object): List of stock item records. Each object represents a single stock item with the fields below.

Stock Item Object Schema#

id (string): Unique identifier of the stock item.
goodsCode (string): Internal code for the item.
goodsName (string): Human-readable name of the item.
commodityCategoryCode (string): UNSPSC or internal commodity category code (e.g., "15101505").
commodityCategoryName (string): Name of the commodity category (e.g., "Diesel fuel").
goodsTypeCode (string): Item type code (e.g., "101").
measureUnit (string): Unit of measure code (e.g., "102").
haveCustomsUnit (string): Flag code indicating presence of customs unit ("101"/"102").
haveOtherUnit (string): Flag code indicating presence of other unit ("101"/"102").
havePieceUnit (string): Flag code indicating presence of piece unit ("101"/"102").
haveExciseTax (string): Flag code indicating the item is subject to excise tax ("101"/"102").
isExempt (string): Tax exemption flag code ("101"/"102").
isZeroRate (string): VAT zero-rated flag code ("101"/"102").
taxRate (string): Applicable tax/VAT rate as a decimal string (e.g., "0.18" for 18%).
serviceMark (string): Service mark flag code ("101"/"102").
source (string): Source code of the item record (e.g., "102").
statusCode (string): Status code of the item (e.g., "101").
currency (string): Currency code (e.g., "101").
unitPrice (string): Unit price as a string representing a numeric value (e.g., "5500").
stock (string): Current available quantity as a string representing a numeric value.
stockPrewarning (string): Threshold quantity for low-stock warnings as a string.
exclusion (string): Exclusion flag code ("101"/"102").
createDate (number): Epoch milliseconds when the item was created (e.g., 1760430886000).
updateDateStr (string): Last update timestamp as a formatted string.
dateFormat (string): Date format pattern for date-only values (e.g., "dd/MM/yyyy").
timeFormat (string): Date-time format pattern for timestamps (e.g., "dd/MM/yyyy HH24:mi:ss").
nowTime (string): Current server time string (e.g., "2025/11/03 15:59:57").
pageIndex (number): Pagination index (observed in response). May be 0 when pagination is not applied.
pageNo (number): Pagination page number (observed in response). May be 0 when pagination is not applied.
pageSize (number): Pagination page size (observed in response). May be 0 when pagination is not applied.
Notes on flag fields
Many flags use string codes like "101"/"102". Based on typical EFRIS conventions, "101" often denotes Yes/Active and "102" No/Inactive; confirm against your tenant’s configuration.

Example Response (200)#

{
  "success": true,
  "msg": "SUCCESS",
  "items": [
    {
      "commodityCategoryCode": "15101505",
      "commodityCategoryName": "Diesel fuel",
      "createDate": 1760430886000,
      "currency": "101",
      "dateFormat": "dd/MM/yyyy",
      "exclusion": "1",
      "goodsCode": "DFOO1",
      "goodsName": "Diesel Fuel",
      "goodsTypeCode": "101",
      "haveCustomsUnit": "102",
      "haveExciseTax": "102",
      "haveOtherUnit": "102",
      "havePieceUnit": "102",
      "id": "104261310283940036",
      "isExempt": "102",
      "isZeroRate": "102",
      "measureUnit": "102",
      "nowTime": "2025/11/03 15:59:57",
      "pageIndex": 0,
      "pageNo": 0,
      "pageSize": 0,
      "serviceMark": "102",
      "source": "102",
      "statusCode": "101",
      "stock": "49998",
      "stockPrewarning": "100",
      "taxRate": "0.18",
      "timeFormat": "dd/MM/yyyy HH24:mi:ss",
      "unitPrice": "5500",
      "updateDateStr": "14/10/2025 11:34:46"
    }
  ]
}

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************

Responses

đŸŸ¢200
application/json
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://auth.efris.kakasa.xyz/api/v1/efris/stock-items' \
--header 'Authorization: Bearer <token>'
Response Response Example
{}
Previous
Update AES Key
Next
Update Stock List
Built with