Prepare TDS Return Async API

Post payments to prepare TDS return


Important Links

Run in PostmanRun in Postman API GuideAPI Guide


πŸ“˜

PUT Request on Presigned URL

Once the job is successfully created, upload the payload using HTTP PUT method on generated presigned url. Read More

Sample Payload

{
    "sheets": [
        {
            "name": "Payer",
            "blocks": [
                {
                    "name": "Payer",
                    "@entity": "list",
                    "items": [
                        [
                            "name",
                            "Acme Pvt Ltd"
                        ],
                        [
                            "tan",
                            "MUMR09719B"
                        ],
                        [
                            "pan",
                            "CKLPB3485H"
                        ],
                        [
                            "gstin",
                            "24ABACQ3770E1ZP"
                        ],
                        [
                            "street",
                            "A-901, Stark Tower"
                        ],
                        [
                            "area",
                            "Relief Road"
                        ],
                        [
                            "city",
                            "Ahmedabad"
                        ],
                        [
                            "state",
                            "Gujarat"
                        ],
                        [
                            "postal_code",
                            "380001"
                        ],
                        [
                            "email",
                            "[email protected]"
                        ],
                        [
                            "mobile",
                            "9876543210"
                        ]
                    ]
                },
                {
                    "name": "Responsible Person",
                    "@entity": "list",
                    "items": [
                        [
                            "designation",
                            "Finance Manager"
                        ],
                        [
                            "name",
                            "Tony Stark"
                        ],
                        [
                            "pan",
                            "AAAPA1111A"
                        ],
                        [
                            "street",
                            "A-901, Stark Tower"
                        ],
                        [
                            "area",
                            "Relief Road"
                        ],
                        [
                            "city",
                            "Ahmedabad"
                        ],
                        [
                            "state",
                            "Gujarat"
                        ],
                        [
                            "postal_code",
                            "380001"
                        ],
                        [
                            "email",
                            "[email protected]"
                        ],
                        [
                            "mobile",
                            "9876543210"
                        ]
                    ]
                }
            ]
        },
        {
            "name": "Payee",
            "blocks": [
                {
                    "name": "Payee",
                    "@entity": "table",
                    "header": [
                        [
                            "sr_no",
                            "pan",
                            "name"
                        ]
                    ],
                    "rows": [
                        [
                            1,
                            "COWPR1618C",
                            "Aarya Stark"
                        ],
                        [
                            2,
                            "PANNOTAVBL",
                            "Marya Stark"
                        ],
                        [
                            3,
                            "PANAPPLIED",
                            "Karya Stark"
                        ],
                        [
                            4,
                            "PANINVALID",
                            "Barya Stark"
                        ],
                        [
                            5,
                            "PANNOTREQD",
                            "Sarya Stark"
                        ]
                    ]
                }
            ]
        },
        {
            "name": "Challan",
            "blocks": [
                {
                    "name": "Challan",
                    "@entity": "table",
                    "header": [
                        [
                            "challan_serial",
                            "bsr_code",
                            "paid_date",
                            "minor_head",
                            "tds_amount",
                            "surcharge",
                            "education_cess",
                            "interest",
                            "late_filing_fees",
                            "other_penalty"
                        ]
                    ],
                    "rows": [
                        [
                            "12345",
                            "1234567",
                            1657152000000,
                            "(200) TDS Payable by Tax Payer",
                            20000,
                            0,
                            800,
                            80,
                            0,
                            0
                        ]
                    ]
                }
            ]
        },
        {
            "name": "Payment",
            "blocks": [
                {
                    "name": "Payment",
                    "@entity": "table",
                    "header": [
                        [
                            "payee_sr_no",
                            "challan_serial",
                            "bsr_code",
                            "section",
                            "credit_amount",
                            "credit_date",
                            "tds_amount",
                            "surcharge",
                            "education_cess",
                            "deduction_date",
                            "reason_for_lower_deduction",
                            "certificate_number"
                        ]
                    ],
                    "rows": [
                        [
                            1,
                            "12345",
                            "1234567",
                            "194 - Dividend",
                            20000,
                            1657152000000,
                            900,
                            0,
                            36,
                            1656547200000
                        ]
                    ]
                }
            ]
        }
    ]
}
{
    "sheets": [
        {
            "name": "Payer",
            "blocks": [
                {
                    "name": "Payer",
                    "@entity": "list",
                    "item": [
                        [
                            "name",
                            "Acme Pvt Ltd"
                        ],
                        [
                            "tan",
                            "MUMR09719B"
                        ],
                        [
                            "pan",
                            "CKLPB3485H"
                        ],
                        [
                            "gstin",
                            "24ABACQ3770E1ZP"
                        ],
                        [
                            "street",
                            "A-901, Stark Tower"
                        ],
                        [
                            "area",
                            "Relief Road"
                        ],
                        [
                            "city",
                            "Ahmedabad"
                        ],
                        [
                            "state",
                            "Gujarat"
                        ],
                        [
                            "postal_code",
                            "380001"
                        ],
                        [
                            "email",
                            "[email protected]"
                        ],
                        [
                            "mobile",
                            "9876543210"
                        ]
                    ]
                },
                {
                    "name": "Responsible Person",
                    "@entity": "list",
                    "item": [
                        [
                            "designation",
                            "Finance Manager"
                        ],
                        [
                            "name",
                            "Tony Stark"
                        ],
                        [
                            "PAN",
                            "AAAPA1111A"
                        ],
                        [
                            "street",
                            "A-901, Stark Tower"
                        ],
                        [
                            "area",
                            "Relief Road"
                        ],
                        [
                            "city",
                            "Ahmedabad"
                        ],
                        [
                            "state",
                            "Gujarat"
                        ],
                        [
                            "postal_code",
                            "380001"
                        ],
                        [
                            "email",
                            "[email protected]"
                        ],
                        [
                            "mobile",
                            "9876543210"
                        ]
                    ]
                }
            ]
        },
        {
            "name": "Payee",
            "blocks": [
                {
                    "name": "Payee",
                    "@entity": "table",
                    "header": [
                        [
                            "sr_no",
                            "pan",
                            "name",    
                            "tax_identification_number",
                            "street",
                            "area",
                            "city",
                            "state",
                            "postal_code",
                            "country",
                            "email",
                            "isd_code",
                            "mobile"
                        ]
                    ],
                    "rows": [
                        [
                            1,
                            "COWPR1618C",
                            "Aarya Stark",
                            "UAE1234567890",
                            "Box No. 24756",
                            "",
                            "Sharjah",
                            "Sharjah",
                            "24756",
                            "United Arab Emirates",
                            "[email protected]",
                            "971",
                            "2660839820"
                        ]
                    ]
                }
            ]
        },
        {
            "name": "Challan",
            "blocks": [
                {
                    "name": "Challan",
                    "@entity": "table",
                    "header": [
                        [
                            "challan_serial",
                            "bsr_code",
                            "paid_date",
                            "minor_head",
                            "tds_amount",
                            "surcharge",
                            "education_cess",
                            "interest",
                            "late_filing_fees",
                            "other_penalty"
                        ]
                    ],
                    "rows": [
                        [
                            "SN1234",
                            "1234567",
                            1657152000000,
                            200,
                            20000,
                            0,
                            800,
                            80,
                            0,
                            0
                        ]
                    ]
                }
            ]
        },
        {
            "name": "Payment",
            "blocks": [
                {
                    "name": "Payment",
                    "@entity": "table",
                    "header": [
                        [
                            "payee_sr_no",
                            "challan_serial",
                            "bsr_code",
                            "section",
                            "credit_amount",
                            "credit_date",
                            "tds_amount",
                            "surcharge",
                            "education_cess",
                            "deduction_date",
                            "reason_for_lower_deduction",
                            "certificate_number",
                            "applicability_of_tds_rate",
                            "nature_of_remittance",
                            "form_15ca_acknowledgement_number",
                            "grossing_up_indicator"
                        ]
                    ],
                    "rows": [
                        [
                            1,
                            "SN1234",
                            "1234567",
                            "194-S",
                            20000,
                            1657152000000,
                            900,
                            0,
                            36,
                            1656547200000
                        ]
                    ]
                }
            ]
        }
    ]
}
Language
Click Try It! to start a request and see the response here!