Overview

This method provides the HSN description details for a given HSN Code.

The format and details of HSN API request is depicted in following table.

URL

<URL>/Master/GetHsnDetailsByHsnCode

Content-Type

application/json

Method

GET

URL Parameters

hsncode

URL Parameter Description

hsncode for which the details are required

Request Payload

Request Header

Attributes Description

client-id

clientid to be provided by E-WAY BILL SYSTEM

client-secret

Secret to be provided by E-WAY BILL SYSTEM

Gstin

GSTIN of Requester(Tax payer or Transporter)

authtoken

Authentication token returned by the E-way bill system

Response Payload

Attributes Description Value
Status Status of request 1 – Success ; 0 - Error

Encrypt(Base64(Response JSON),rek)

Response of HSN details Json string.

Encrypt(rek,sek)

Random encryption key which is encrypted using sek

Hmac ( Base64(JSON data ))

HMAC-SHA256 of Base64 data using AES key (rek) as HMAC Key

Sample Json for GetHSN (HSN details)

GetHSN Response

{
"status":"1",
    "data":"FNWLIGnnbZjmRd2yVAyouCM/Q/6IhGUreS0u9RwQ3/jxy5WzO21LfEDo0yRk6cRPZtMCdm2rdkNo1bd5ueiyHA==",
  "rek":"jqBN5+JqNQiWlyHTEMqAzb7MZwSJZz6Fw/lBkgou3CKx7Ez0tKl74s/ij5hOD+P9",
  "hmac":"N3mdYAT4Tq0zgh3Znok7rHTi692Xy1zhQUBGExjBVHI="
}

"data" JSON (corresponds to the data element of GetHSN Response(Success))

{
   "hsnCode":"1001",
  "hsnDesc":"WHEAT AND MESLIN - Durum wheat :"
}

JSON(in case of error)

{
  "status": "0",
  "error":{"errorCodes": 240}
}

Validations

Content will be updated shortly.