Decrypted GST API
It is STRONGLY RECOMMANDED to use TaxProGSP.API.dll library to access production GST API securely where data gets encrypted at source application and decrypted on GSTN servers and vice versa. Using library or programming Encryption/Decryption in your application is the most secure way to access GST API; where GSP server just piplines and carries decrypted payload in either way.
Decrypted API is offered for developers unable to handle Encryption / Decryption logic or those not able to use FREE TaxProGSP.API library due to technical reasons:
Sample Decrypted Urls are provided below, which contains "/Dec/" additional path fragment in standard url provided by GSTIN.
Decrypted API has option to add aspid, password, gstin, authtoken as headers or as query string.
Other headers, query parameters, and body remains as per GSTIN Developer portal API specifications.
Decrypted GST API Sample Urls
Authenticate API GET Method:
OTP
http://gstsandbox.charteredinfo.com/taxpayerapi/dec/v0.2/authenticate?action=OTPREQUEST&gstin=33AANCS2882A1ZG&username=TN_NT2.2265
Header Parameter : aspid=<===YourAspId===>, password : <===YourAspAcPwd===>
AuthToken
http://gstsandbox.charteredinfo.com/taxpayerapi/dec/v0.2/authenticate?action=AUTHTOKEN&gstin=33AANCS2882A1ZG&username=TN_NT2.2265&OTP=575757
Header Parameter : aspid=<===YourAspId===>, password : <===YourAspAcPwd===>
RefreshToken
http://gstsandbox.charteredinfo.com/taxpayerapi/dec/v0.2/authenticate?action=REFRESHTOKEN&gstin=33AANCS2882A1ZG&username=TN_NT2.2265
Header Parameter :
aspid: <===YourAspId===>
password : <===YourAspAcPwd===>
AuthToken: 90c196eb253b4c458292b8f6ee8f27e4
API GET Method:
Ledgers:
http://gstsandbox.charteredinfo.com/taxpayerapi/dec/v0.3/ledgers?action=CASH&gstin=33AANCS2882A1ZG&username=TN_NT2.2265&fr_dt=01-01-2018&to_dt=28-02-2018
Header Parameter :
aspid: <===YourAspId===>
password : <===YourAspAcPwd===>
AuthToken: 90c196eb253b4c458292b8f6ee8f27e4
Returns:
Sample URL for GSTR-2A:
http://gstsandbox.charteredinfo.com/taxpayerapi/dec/v0.3/returns/gstr2a?action=B2B&gstin=33AANCS2882A1ZG&username=TN_NT2.2265&ret_period=092017
Header Parameter :
aspid: <===YourAspId===>
password : <===YourAspAcPwd===>
AuthToken: 90c196eb253b4c458292b8f6ee8f27e4
Sample URL for GSTR-2B:
http://gstsandbox.charteredinfo.com/taxpayerapi/dec/v1.0/returns/gstr2b?action=GET2B&gstin=33AANCS2882A1ZG&username=TN_NT2.2265&ret_period=012021&rtnprd=012021
Header Parameter :
aspid: <===YourAspId===>
password : <===YourAspAcPwd===>
AuthToken: 90c196eb253b4c458292b8f6ee8f27e4
API POST Method:
GST1:
http://gstsandbox.charteredinfo.com/taxpayerapi/dec/v1.1/returns/gstr1?action=RETSAVE&gstin=33AANCS2882A1ZG&username=TN_NT2.2265
Header Parameter :
aspid: <===YourAspId===>
password : <===YourAspAcPwd===>
authtoken: 90c196eb253b4c458292b8f6ee8f27e4
API PUT Method:
http://gstsandbox.charteredinfo.com/taxpayerapi/dec/v1.1/returns/gstr1?action=RETSAVE&gstin=33AANCS2882A1ZG&username=TN_NT2.2265&ret_period=032018
Header Parameter :
aspid: <===YourAspId===>
password : <===YourAspAcPwd===>
authtoken: 90c196eb253b4c458292b8f6ee8f27e4
Sample BODY:
{
"gstin": "33AANCS2882A1ZG",
"fp": "042018",
"gt": 0.0,
"cur_gt": 0.0,
"b2b": [
{
"ctin": "27GSPMH0042G1ZY",
"inv": [
{
"inum": "Apr001",
"idt": "01-04-2017",
"val": 10000.0,
"pos": "27",
"rchrg": "N",
"inv_typ": "R",
"itms": [
{
"num": 1,
"itm_det": {
"rt": 5.0,
"txval": 1000.0,
"camt": 25.0,
"samt": 25.0,
"csamt": 0.0
}
}
]
}
]
}
]
}
-----------
