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_idto 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.
| Version | Description | Link to the endpoint |
|---|---|---|
| 2.0 | E-file TDS by uploading TXT & CSI files on a pre-signed URL. | |
| 1.0 | This is the first version of the API. | |
Refer to our versioning policies here
Updated 5 months ago