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 a zip of FVU & Form27A

Overview

Use this API to E-File TDS return through TIN FC by generating pre-signed URLs to upload a zip file of FVU and Form27A

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/fvu/e-file

API Endpoint  Contact Us  Free Trial

📘

Form 27A will be e-signed using the Responsible Person's name in the FVU 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
quarterstringQuarterQ1, Q2, Q3, Q4

📘

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/fvu/e-file\
     --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_zipstringPre signed URL where you need to upload zip file of FVU and Form27Ahttps://.......

.

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 1.0. Refer to our versioning policies here