GST Large Files API
If number of Invoices to be downloaded is greater than 10,000 then token will be generated and returned in response to Get Data API call.
TaxPayer (or ASP) needs to get FileDetails using the token after the 'est' Estimated time returned along with token
{"est":"30","token":"9a8f880b60804e44add8361696d16e86"}
Get File Details API (API Action = 'FILEDET') returns list of urls along with file encryption key 'ek'. The list of files returned as response to the API needs to be downloaded one by one (in production over MPLS link to GSTN server) through GSP connectivity.
Sample response from GSTN to FILEDET API:
File Details Response;
{
"urls": [
{
"ul": "/returns/16012021/R1/7613eb66a13d4b269de42e91bfcf2ad2/returns_16012021_R1_27GSPMH0992G1ZF_b2b_0.tar.gz?md5=1m6TtTHIGszV2B6NaanPww&expires=1610868095",
"ic": 10000,
"hash": "38f46b623fdc8b937fab139c8d4660a15f9dbf07dce188fe279ba52f7c3e2780"
},
{
"ul": "/returns/16012021/R1/7613eb66a13d4b269de42e91bfcf2ad2/returns_16012021_R1_27GSPMH0992G1ZF_b2b_1.tar.gz?md5=VPGuLi0C9U3EGUhgYh3KLQ&expires=1610868095",
"ic": 4702,
"hash": "1d795e19921d5d13510bda6f4db40ed5f3d78a963486a111734791f716f88d1a"
}
],
"ek": "11VZrNwzUoUy4ykr3wEKzxb7SeNpjDbQ0vJKBTFV+Kg=",
"fc": 2
}
TaxPro GSP provides DownloadGstrFile api for this. The api needs to be called before file expiry date to download the file successfully.
HTTP Method: POST
Headers or Query String Param:
|
Property
|
Description
|
Data Type
|
|
aspid
|
AspUserId provided by GSP.
|
String
|
|
password
|
Asp Password.
|
String
|
|
gstin
|
GSTIN (mostly for logging and billing purpose)
|
String
|
Sample Url:
https://gstapi.charteredinfo.com/aspapi/v1.0/downloadgstrfile?aspid=<===YourAspId===>&password=<===YourAspPassword===>&gstin=<===YourGstin===>
Body: Single Item from the urls list returned by FILEDET api call.
{
"ul": "/returns/16012021/R1/7613eb66a13d4b269de42e91bfcf2ad2/returns_16012021_R1_27GSPMH0992G1ZF_b2b_0.tar.gz?md5=1m6TtTHIGszV2B6NaanPww&expires=1610868095",
"ic": 10000,
"hash": "38f46b623fdc8b937fab139c8d4660a15f9dbf07dce188fe279ba52f7c3e2780"
}
Response: Read as Binary File.
