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

Request

The API takes in the tan of the deductor as a path parameter and the zip file as a body.

Path Parameter

Body

📘

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