TaxPro GST Lib
User guide (Under Construction)

GSTR-1 Return using EVC

Step-1: Get GSTR-1 Return Summary:

First get Summary for GSTR-1 after all data upload and data is finalize.

Sandbox URL: https://gstsandbox.charteredinfo.com/taxpayerapi/dec/v4.0/returns/gstr1

Method: GET: All Parameter Value must be URL Encoded

URL Parameter:

Parameter	Sample Value	Remark
action	RETSUM	API Action
aspid	XXXXXXXXXX	ASP User ID
userrole	GSTR1	Form Name
rtn_typ	GSTR1	Form Name
gstin	33AANCS2882A1ZG	GSTIN of TaxPayer
username	TN_NT2.2265	GST User Name
ret_period	122022	Return Period (MMYYYY)
authtoken	c02990e6737f4d4d886254523c3ab576	Auth Token Value

Header Parameter:

Parameter	Sample Value	Remark
state-cd	27	State Code
api_version	3.0	API Version
userrole	GSTR1	Form Name
rtn_typ	GSTR1	Form Name
password	XXXXXXXXXX	ASP Password

Step1-Response = Take the response of Step-1 as it is without indentation [in case of postman take response from Raw Tab]. This response need to post in request body of GSTR-1 Return File API.

Step-2: Get EVC OTP for Filing Return:

Sandbox URL: https://gstsandbox.charteredinfo.com/taxpayerapi/dec/v1.0/authenticate

Method: GET: All Parameter Value must be URL Encoded

URL Parameter:

Parameter	Sample Value	Remark
action	EVCOTP	API Action
aspid	XXXXXXXXXX	ASP User ID
gstin	33AANCS2882A1ZG	GSTIN of TaxPayer
username	TN_NT2.2265	GST User Name
pan	AAAPC9999A	PAN of Authorize Person for Signing Return
form_type	R1	Form TYPE for GSTR1 = R1
authtoken	c02990e6737f4d4d886254523c3ab576	Auth Token Value

eader Parameter:

Parameter	Sample Value	Remark
password	XXXXXXXXXX	ASP Password

EVCOTP = 123456 [OTP Received on Mobile and Email of Authorize Person]

Step-3: Call GSTR-1 Return File API:

Sandbox URL: https://gstsandbox.charteredinfo.com/taxpayerapi/dec/v4.0/returns/gstr1

Method: POST: All Parameter Value must be URL Encoded

URL Parameter:

Parameter	Sample Value	Remark
action	RETFILE	API Action
aspid	XXXXXXXXXX	ASP User ID
gstin	33AANCS2882A1ZG	GSTIN of TaxPayer
username	TN_NT2.2265	GST User Name
ret_period	122022	Return Filing Period (MMYYYY)
authtoken	c02990e6737f4d4d886254523c3ab576	Auth Token Value
st	EVC	Sign Type [EVC/DSC]
sid	AAAPC9999A\|123456	PAN\|EVCOTP (Pan of Authorize Person)
sign	tYKUd8VIHmyo7h%2FHGoHpFA7oFO%2FIn7DA0%2FyIHBGzK%2Bo%3D	HMAC-SHA256 of Base64String(GetBytes(Base64String(Step1-Response))) using Key as Base64String(PAN\|EVCOTP)

Header Parameter:

Parameter	Sample Value	Remark
state-cd	27	State Code
api_version	4.0	API Version
userrole	GSTR1	Form Name
rtn_typ	GSTR1	Form Name
password	XXXXXXXXXX	ASP Password

Request Body : Step1-Response

Response : {"ack_num": "ASDFSDF1241343"}