E-File TDS Return
TDS returns have to be filed on a quarterly basis. Deductors can e-file their TDS return with ease by uploading TXT and CSI files.
Overview
Use this API to E-File TDS return through TIN FC by generating pre-signed URLs to upload TXT & CSI files.
Problem
- TDS return needs to be filed quarterly in order for the deductor to be TDS compliant.
- HRMS platforms facilitating the service filing of TDS returns have to do it one at a time by visiting the ITD Portal, making it time-consuming, error-prone & expensive.
Solution
- API that allows you to e-file your TDS return
- It will also provide you with a
job_id
to help keep track of your filing status.
Endpoint
HTTP Method | Resource |
---|---|
POST | /tds-compliance/tin-fc/deductors/:tan/tdsrs/:form/e-file |
Form 27A will be e-signed using the Responsible Person's name in the TXT file.
Request
Follow the below guidelines to pass the TAN of the deductor & Form to E-file your TDS return.
Path Parameter
Param | Type | Description | Example |
---|---|---|---|
tan | string | TAN of deductor | PDES03028F |
form | string | TDS return form | 26Q |
Query Parameter
Param | Type | Description | Example |
---|---|---|---|
financial_year | string | Financial Year | FY 2022-23 |
quarter | string | Quarter Possible Values: Q1 , Q2 , Q3 , Q4 | Q3 |
PUT Request on Presigned URL
Once the job is successfully created, upload the payload using HTTP PUT method on generated presigned url. Read More
Sample CURL Request
curl --request POST \
--url https://api.sandbox.co.in/tds-compliance/tin-fc/deductors/PDES03028F/tdsrs/26Q/e-file?financial_year=FY%202022-23&quarter=Q3\
--header 'Accept: application/json' \
--header 'Authorization: xxxxxxxxxxxxxxxxxxxx' \
--header 'Content-Type: application/json' \
--header 'x-api-key: xxxxxxxxxxxxxxxx' \
--header 'x-api-version: 1.0' \
Test Environment Available
Response
Param | Type | Description | Example |
---|---|---|---|
job_id | string | ID of the particular fvu upload. It will be used later on to check status. | f24cd229-42c8-43de-af79-8ce2d3c4c3db |
presigned_url_txt | string | Pre signed URL where you need to upload txt file | https://....... . |
presigned_url_csi | string | Pre signed URL where you need to upload csi file | https://..... . |
Response Caching
Response caching is not available for this API. Learn more about our response caching mechanism here
Wallet Charges
Since E-File TDS Return API is a Paid API, a wallet charge will take place.
Versioning
The API is currently in major version 2.0. Refer to the below table for the versioning history of this API along with the Changelog.
Refer to our versioning policies here
Updated 5 months ago