TDS Calculator API
TDS Calculator is an API suite for calculating tax deducted at source (TDS) for salary and non-salary payments. Use these APIs to compute TDS amounts and rates for payroll and payouts—call synchronously for immediate results or asynchronously for bulk processing.Value proposition
Correct TDS calculation requires applying the right rates and rules for each payment type, recipient status, and Income Tax Act section. Manual computation is error-prone and slow, especially when processing high volumes of salary or vendor payments. TDS Calculator APIs automate these calculations. The APIs produce accurate deductions that comply with Income Tax Act provisions and reduce compliance risk.Salary TDS calculation
Compute TDS for employee salary payments and generate detailed workbooks.
Non-salary TDS calculation
Calculate TDS for contractor, vendor, and other non-salary payouts.
Sync and async modes
Use synchronous APIs for real-time results or async jobs for bulk processing.
Workbook input/output
Submit salary workbooks and get computed results with TDS details.
How it works
1
Choose calculation mode
Determine whether you need salary or non-salary TDS calculation.
2
Call non-salary calculator (if applicable)
Send payment details to the non-salary endpoint and receive computed TDS values.
3
Call salary sync (for single computations)
Submit the salary workbook and receive the computed output synchronously.
4
Submit salary job (for bulk processing)
Call the submit job endpoint to get a job ID and upload URL for large payroll files.
5
Upload input workbook
Use PUT request to upload the salary workbook to the provided upload URL.
6
Poll job status or receive webhook
Check job status periodically or configure a webhook to receive completion notification.
7
Download computed output
Retrieve the computed workbook with TDS values from the job result URL.
For bulk salary calculations, see the job-based API workflow guide.
API reference
Non-salary calculation
Calculate TDS for contractor and vendor payments.
Salary calculation (sync)
Compute salary TDS with immediate response.
Submit salary job
Initiate bulk salary TDS calculation job.
Poll salary job
Check status and retrieve results for bulk jobs.
API endpoints
Common use cases
Use TDS Calculator APIs when you need to:- Calculate TDS for contractor or vendor payouts before initiating payment
- Compute employee salary TDS during payroll processing and generate output workbook
- Run bulk salary TDS calculations for enterprises with large payroll files
- Integrate TDS computation into HRMS or ERP systems for monthly compliance workflows
Related resources
Job-based APIs
Understand async job workflows for bulk processing.
Webhooks
Configure webhooks for job completion notifications.
Error handling
Handle API errors and troubleshoot issues.
Authentication
Set up API authentication.
FAQ
What is TDS Calculator API?
What is TDS Calculator API?
TDS Calculator API is a Sandbox API suite that computes tax deducted at source (TDS) for salary and non-salary payments. The API applies Income Tax Act rules to calculate accurate TDS amounts based on payment type, recipient details, and applicable sections.
What is the difference between salary and non-salary TDS calculation?
What is the difference between salary and non-salary TDS calculation?
Salary TDS calculation applies to employee compensation and uses workbook-based input/output with detailed computation. Non-salary TDS calculation applies to payments like contractor fees, rent, and professional services, using a simpler request/response format. Both follow Income Tax Act provisions but use different rate structures and exemptions.
When should I use sync vs async salary calculation?
When should I use sync vs async salary calculation?
Use synchronous salary calculation via the salary sync endpoint for single employee computations with immediate response needs. Use asynchronous job-based calculation via submit job for bulk payroll processing with large workbooks. See the job-based API workflow for async details.
How do I process bulk salary TDS calculations?
How do I process bulk salary TDS calculations?
Submit a bulk calculation job using the submit job endpoint, which returns a job ID and upload URL. Upload your salary workbook via PUT request to the upload URL. Poll the poll job endpoint or configure a webhook to receive completion notification. Download the computed output from the result URL in the job response.
What format does the salary workbook use?
What format does the salary workbook use?
TDS Calculator accepts salary data in workbook format for both input and output. The input workbook contains employee salary details, deductions, and exemptions. The output workbook includes computed TDS amounts, applicable rates, and calculation breakdowns. Refer to the endpoint documentation for schema details.
What compliance requirements does TDS Calculator address?
What compliance requirements does TDS Calculator address?
TDS Calculator APIs help businesses comply with Income Tax Act TDS provisions. The APIs calculate accurate tax deductions so you can deposit payments on time, issue TDS certificates (Form 16/16A), and file quarterly returns correctly. See the TDS overview for the complete compliance workflow.
How do I handle errors in TDS calculation requests?
How do I handle errors in TDS calculation requests?
TDS Calculator APIs return standard error responses with error codes and messages. Common errors include invalid input data, missing required fields, or unsupported payment types. See the error handling guide for error code reference and troubleshooting steps.