E-File TDS Return


Overview
The API allows you to E-File TDS return through TIN FC by accepting a zip
file that must contain an FVU file and a PDF file (Form 27A) and queues a JOB and returns the job_id
.
Problem
- You wish to integrate the filing of TDS returns into your workflow.
Solution
- This API allows you to file your returns & can be added into your workflows.
- It will also provide you with a job id to help you track your filing status.
Did you know?
You can generate the FVU file for your TDS Return by using the Income Tax Department utility to prepare it using TXT file of TDS return and CSI file containing the list of challans for specific quarters!
Form 27A will be e-signed using the name provided in our Profile section and submitted to NSDL through TIN FC
To update your name under Profile, follow the below steps:
Log on to the Sandbox Dashboard and click on Profile Icon > My Profile > Name
Endpoint
HTTP Method | Resource |
---|---|
| /tin-fc/deductors/:tan/tdsrs/e-file |
Request
The API takes in the tan of the deductor as a path parameter and the zip file as a body.
Path Parameter
Param | Type | Description | Example |
---|---|---|---|
tan |
| TAN of deductor | PDES03028F |
Body
Param | Type | Description |
---|---|---|
zip |
| Zip file of FVU and Form 27A files of the TDS filer. |
Each e-TDS/TCS return is to be submitted along with a signed copy of the control chart (Form 27A).
It is mandatory to submit Form 27A generated by TDS/TCS FVU (File Validation Utility) duly signed, along with the TDS/TCS statement(s).
Once the values are added, Your curl will look something like this
curl --request POST \
--url https://api.sandbox.co.in/tin-fc/deductors/%20PDES03028F/tdsrs/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' \
--data '
{
"zip": "data:application/x-zip-compressed;name=FVU&Form27A.zip;base64,UEsDBBQAAAAIAOI27FQOiMD+DAIAADcDAAAMAAAAZG93bmxvYWQuanBnlVI/b9NQEP/ds508O47wS902hJS6BqlOFEUhRAIkEE6RK4gUya36ASoGJFbEwPhmj3wCgxi6MyNl6MDIwMCfhex8B3MvRC3qxp3e6d67f7+7d9W36heC2eGzQxABxIxqiefZm5cvgPkcfQASDrVgYW2nDpyVDszoxoV+TMmlj9i41NdktItT/cQTyFqtXnNkvV53Xen5YdNvNPzrrY1r4U5n9+ZOp9uNbg/3o3hwq9tN7vUGozuTyWR3/8Gj++OHw7uTsUlCruv6Db/dbLbHe9298X9TtYCSWGJpUQyhyFJUnWObx2EG8g+RqLOhHdBVC6lXb9myeTXAtHmOUF19RfUDvkVczFJ4jN9pUXBaYwhCI+1caFnaJj4skao0M9qC7yplkY2M32gkNFCgME8SMlF9cxeJ4cYniROaMqcLYvk6Q4KcQgq9mR5wwBfOHGvzc1CnLEQv5bKtM5GA6ybmvViDPeC0kCWLDleBLvUHhrNJT5GfeZJBiH4S8LRS+1iDjhiu2RfYdPA3PurZzvZnNy05iemJyadVnwKBUdIcItYrLr3CiWiK3D4ya+WxU46yZmyy4WeI0Obx8BgWHGQ7C4M01gEyTOeQslzBpCYDQFTG7zWXJPZWeegxohNOyc0wZipDjiwK459Ci6F20q3Vamawax/foZfa2IKKxFeEKEUO8yUYoMVOpVV9/wNQSwECFAAUAAAACADiNuxUDojA/gwCAAA3AwAADAAAAAAAAAAAAAAAAAAAAAAAZG93bmxvYWQuanBnUEsFBgAAAAABAAEAOgAAADYCAAAAAA=="
}
'
Test Data Not Available
Instead, input valid credentials along with
live_key
to use the API.
Response
Param | Type | Description | Example |
---|---|---|---|
job_id |
| ID of the particular | f24cd229-42c8-43de-af79-8ce2d3c4c3db |
status |
| The status the particular | JOBQUEUED |
form |
| Type of form, for which FVU is uploaded Possible Values: Form 24Q, Form 26Q, Form 27Q | 26Q |
tan |
| TAN of deductor | PDES03028F |
file_hash |
| File hash on Form 27A (generated by Utility) | 00000000000013159000 |
financial_year |
| Financial year for which FVU is uploaded Format: FY 2020-21 | FY 2020-21 |
quarter |
| Quarter for which FVU is uploaded Possible Values: Q1, Q2, Q3, Q4 | Q4 |
barcode |
| Barcode on Form 27A (generated by Utility) | 21060812395413159000 |
Updated about 1 month ago