New TDS Return APIs
As part of POST to GET, we have released new TDS Return APIs. While the methods to file TDS returns by providing TXT and CSI files or by submitting a zip file containing the FVU and Form 27A existed in previous contracts, we are enhancing the capabilities and streamlining the process with these new endpoints.
Moreover, with the introduction of the Fetch Jobs API, users can now easily track and retrieve the status of their TDS return jobs submitted through Sandbox APIs.
Using TXT & CSI
You can refer to the new endpoints for TDS Return APIs using TXT and CSI here
Consequently, the previous contracts have been deprecated.
Using FVU & Form 27A
You can refer to the new endpoints for TDS Return APIs using the zip of FVU & Form27A here
Consequently, the previous contracts have been deprecated.
Fetch Jobs API
Users can now utilize this API to Fetch TDS Return Jobs based on the provided tan
, quarter
, form
& financial_year
. Additionally, you have the option to retrieve jobs within a specified period for easier search and more flexible filtering.
{
"code": 200,
"timestamp": 1715757773000,
"transaction_id": "109469b2-0748-4135-a569-e86fc9e45756",
"data": {
"@entity": "in.co.sandbox.tds.compliance.e-file.paginated_list",
"items": [
{
"@entity": "in.co.sandbox.tds.compliance.e-file.job",
"job_id": "096c4812-1829-4ee1-a3c6-3bd291654b72",
"tan": "AHMS12345C",
"financial_year": "FY 2023-24",
"quarter": "Q2",
"form": "26Q",
"created_at": 1714529043000,
"updated_at": 1714529044000,
"status": "succeeded",
"return_receipt_number": 123456789012345
},
{
"@entity": "in.co.sandbox.tds.compliance.e-file.job",
"job_id": "096c4812-1829-4ee1-a3c6-3bd291654b72",
"tan": "AHMS12345C",
"financial_year": "FY 2023-24",
"quarter": "Q2",
"form": "26Q",
"created_at": 1714527043000,
"updated_at": 1714527044000,
"status": "failed",
"message": "Unacceptable FVU"
},
{
"@entity": "in.co.sandbox.tds.compliance.e-file.job",
"job_id": "096c4812-1829-4ee1-a3c6-3bd291654b72",
"tan": "AHMS12345C",
"financial_year": "FY 2023-24",
"quarter": "Q2",
"form": "26Q",
"created_at": 1714530043000,
"updated_at": 1714530044000,
"status": "failed",
"message": "Validation error"
}
],
"last_evaluated_key": "eydadadadada...=="
}
}