E-File TDS Return

21522152

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

POST

/tin-fc/deductors/:tan/tdsrs/e-file

API EndpointAPI Endpoint

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

string

TAN of deductor

PDES03028F

Body

Param

Type

Description

zip

multipart/form-data

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

string

ID of the particular fvu upload. It will be used later on to check status.

f24cd229-42c8-43de-af79-8ce2d3c4c3db

status

string

The status the particular fvu upload.

JOBQUEUED

form

string

Type of form, for which FVU is uploaded Possible Values: Form 24Q, Form 26Q, Form 27Q

26Q

tan

string

TAN of deductor

PDES03028F

file_hash

string

File hash on Form 27A (generated by Utility)

00000000000013159000

financial_year

string

Financial year for which FVU is uploaded Format: FY 2020-21

FY 2020-21

quarter

string

Quarter for which FVU is uploaded Possible Values: Q1, Q2, Q3, Q4

Q4

barcode

string

Barcode on Form 27A (generated by Utility)

21060812395413159000


Did this page help you?