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:
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:
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"}