Prepare TDS Return
TDS return preparation can be an arduous task for Fin-Ops. Automate TDS return preparation using Sandbox APIs.
Overview
Use this API to prepare TDS return by posting a job to generate the TXT file
Problem
- Businesses need to file their TDS returns quarterly to be TDS compliant.
- Businesses that deduct TDS under sections 192 (Salary), 194 (Dividends), 194O (E-Commerce Transactions) & 194S (Transfer of Virtual Digital Assets) have volumetric transactions.
- This makes reporting prone to fat-fingering and other errors that can delay the process of filing the TDS Return and can incur interest & penalty costs.
Solution
- The API will automate the generation of the TXT file which is required to file quarterly TDS returns.
- Use the PUT request on the
presigned_url
to upload TDS deduction-related information. - Get
job_id
to obtain the TXT file using the Job status API. - You can also configure Postbacks to get notified when the Job is done.
Endpoint
HTTP Method | Resource |
---|---|
POST | tds-reporting/deductors/{tan}/tdsrs/{form}/async |
Request
Follow the below guidelines to pass TAN, form in the path parameter, and financial year, quarter, previous RRR number, and filing type in the query parameter.
Path Parameter
Param | Type | Description | Example |
---|---|---|---|
tan | string | TAN of deductor | MUMR09719B |
form | enum | TDS return form | 24Q , 26Q , 27Q |
Query Parameter
Param | Type | Description | Example |
---|---|---|---|
financial_year | string | Pattern : FYeters{1,4}-"data{1,2} | FY 2022-23 |
quarter | enum | Quarter. Possible values: Q1 , Q2 , Q3 , Q4 | Q3 |
previous_rrr_number | string | Pattern : amete{15} | |
filing_type | enum | TDS Return Filling type. Possible Values: Original Revised | Original |
Sample CURL Request
curl --request POST \
--url 'https://api.sandbox.co.in/tds-reporting/deductors/MUMR09719B/tdsrs/26Q/async?financial_year=FY%202022-23&quarter=Q4&previous_rrr_number=123456789012345&filing_type=Original' \
--header 'Authorization: xxxxxxxxxxxxxxxxxxxxxxx' \
--header 'accept: application/json' \
--header 'x-api-key: xxxxxxxxxxxxxxxxxxxxxxxx' \
--header 'x-api-version: 1.0'
Test Environment Available
Response
Param | Type | Description |
---|---|---|
code | number | HTTP response status code |
timestamp | number | Timestamp of the request |
transaction_id | string | API Transaction ID |
job_id | string | Unique Job ID to track the request |
presigned_url | string | S3 URL to make the PUT request |
PUT Request on Presigned URL
Once the job is successfully created, upload the payload using HTTP PUT method on generated presigned url. Read More
Payload
Response Caching
Response caching is not available for this API. Learn more about our response caching mechanism here
Wallet Charges
Since Prepare TDS Return API is a Paid API, a wallet charge will take place.
Versioning
This API is currently in major version 1.0. Refer to our versioning policies here
Updated 15 days ago