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 MethodResource
POST/tds-compliance/tin-fc/deductors/:tan/tdsrs/:form/e-file

API Endpoint  Contact Us  Free Trial

📘

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

ParamTypeDescriptionExample
tanstringTAN of deductorPDES03028F
formstringTDS return form26Q

Query Parameter

ParamTypeDescriptionExample
financial_yearstringFinancial YearFY 2022-23
quarterstringQuarter
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

ParamTypeDescriptionExample
job_idstringID of the particular fvu upload. It will be used later on to check status.f24cd229-42c8-43de-af79-8ce2d3c4c3db
presigned_url_txtstringPre signed URL where you need to upload txt filehttps://.......

.
presigned_url_csistringPre signed URL where you need to upload csi filehttps://.....

.

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.

VersionDescriptionLink to the endpoint
2.0E-file TDS by uploading TXT & CSI files on a pre-signed URL.API Endpoint
1.0This is the first version of the API.API Endpoint

Refer to our versioning policies here