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_idto help keep track of your filing status.
Endpoint
| HTTP Method | Resource |
|---|---|
POST | /tds-compliance/tin-fc/deductors/:tan/tdsrs/:form/fvu/e-file |
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
| 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 | Q1, 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
| 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_zip | string | Pre signed URL where you need to upload zip file of FVU and Form27A | 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 1.0. Refer to our versioning policies here
Updated 5 months ago