Prepare TDS Return

TDS return preparation can be an arduous task for Fin-Ops. Automate TDS return preparation using Sandbox APIs.

API Pricing Image

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 MethodResource
POSTtds-reporting/deductors/{tan}/tdsrs/{form}/async

API Endpoint  Contact Us  Free Trial

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

ParamTypeDescriptionExample
tanstringTAN of deductorMUMR09719B
formenumerationTDS return form
Possible Values:
24Q
26Q
27Q
27Q

Query Parameter

ParamTypeDescriptionExample
financial_yearstringFinancial Year for which TDS is being filedFY 2022-23
quarterenumerationQuarter.
Possible values: Q1, Q2, Q3, Q4
Q3
previous_rrr_numberstringReceipt Number of previously filed TDS Return
filing_typeenumerationTDS 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

ParamTypeDescription
codestringHTTP response status code
timestampstringTimestamp of the request
transaction_idstringAPI Transaction ID
job_idstringUnique Job ID to track the request
presigned_urlstringS3 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 of 0.1 + GST per Payment record will be applicable.

Versioning

This API is currently in major version 1.0. Refer to our versioning policies here