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 Possible Values: `24Q`, `26Q`, `27Q`	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	The ID of this job. It will be used later on to check the 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 as per TIN-FC Charges will be applicable:

Number of Deductee Records in the TDS Return	Wallet Charges (Inclusive of GST)
Upto 100 records	59
Between 100-1000 records	252
More than 1000 records	819

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