Test Cases

Endpoints


Compliance API

Search TAN API

TANResponseRemark
MUMR09719B200Valid TAN (Company)
AHMJ09719B200Valid TAN (Individual)
AABC23456D200No Records Found
DABC2345DD422Invalid TAN Pattern
EABC23456N500Failed to get TAN

Section 206AB & 206CCA Sync API

ResponsePANRemark
200XXXPX1234ASpecified PAN
200XXXPX1234BNot-Specified PAN
200AXXPX1234ZSpecified PAN - Special Case
200XXXPX1234JInvalid PAN
422XXXPX123EEInvalid PAN pattern

Section 206AB & 206CCA Bulk API (Submit Job)

List of PANsResponseRemark
XXXPX1234A
XXXPX1234B
AXXPX1234Z
200Job Queued
AXXPX1234Z
XXXPX1234J
XXXPX1234F
200Max Limit Reached
XXXPX1234A
XXXPX1234B
AXXPX123EE
422Incorrect Body/pattern

Section 206AB & 206CCA Bulk API (Poll Job)

job_idResponseRemark
2aa54d2b-68f6-4871-866a-4eba957a8672200Job Queued
f845f37e-7f05-4de9-a282-a3b23b9d370a200Job Done
6e8d1908-c062-4846-a811-8f73054acd65200Job Failed

TDS Return API using TXT & CSI (Submit Job)

TANResponseRemark
AHMA09719B200Job will be successful
MUMR09719B200Job will fail with the message: Regular Statement with the same TAN, Financial Year, FORM, and Quarter is already furnished
AABC23456D200Job will fail with the message: TAN present in the Statement/Application is not valid, kindly furnish a valid TAN
PDES03028E200Job will fail with the message: The statement cannot be filed before the end of the relevant quarter of the current Financial Year
BLRC23456F200Job will fail and will provide a Validation Report URL
DABC2345DD422Invalid TAN Pattern
EABC23456N422Invalid Form
FABC23456O500Internal Server Error

TDS Return API using TXT & CSI (Poll Job)

job_idResponseRemark
2aa54d2b-68f6-4871-866a-4eba957a8672200Job Queued Response
f845f37e-7f05-4de9-a282-a3b23b9d370a200Job Done Response
6e8d1908-c062-4846-a811-8f73054acd65200Job Failed: Regular Statement with the same TAN, Financial Year, FORM, and Quarter is already furnished
4d7b01e7-7297-46d3-86fc-47e11d2db3a5200Job Failed: TAN present in the Statement/Application is not valid, kindly furnish a valid TAN
12e4ec35-3322-4adc-983b-f3a4beff5c4d200Job Failed: The statement cannot be filed before the end of the relevant quarter of the current Financial Year
37777de-4ab7-4532-9bc5-009c8cfaedf4200Job Failed with Validation Report URL
a75b67be-8b33-431f-bc40-76b7be68bcd2422Invalid TAN Pattern
e2c3ca8b-2d36-4b2d-b6a3-a778ab7adf51422Invalid Form
e605e5dc-1d2f-424f-a677-c49ba3305711500Internal Server Error
7baed565-4dc2-46a1-89c2-be35a0a38081521Data not found

TDS Return API using FVU & Form 27A (Submit Job)

TANResponseRemark
AHMA09719B200The job will be successful
MUMR09719B200The job will fail with the message: Regular Statement with the same TAN, Financial Year, FORM, and Quarter is already furnished
AABC23456D200The job will fail with the message: Unacceptable FVU
PDES03028E200The job will fail with the message: Invalid Archive
BLRC23456F200The job will fail with the message: Invalid Number of entries in Archive: 1
HYDC23456G200The job will fail with the message: Form Type Mismatch
MUMC23456H200The job will fail with the message: Quarter Mismatch
DELC23456I200The job will fail with the message: Barcode Mismatch
PUNC23456J200The job will fail with the message: Financial Year Mismatch
KOLT23456K200The job will fail with the message: TAN Mismatch
BABC23456L200The job will fail with the message: FVU Missing
CABC23456M200The job will fail with the message: Form 27A missing
DABC2345DD422Invalid TAN Pattern
EABC23456N422Invalid Form
FABC23456O500Internal Server Error

TDS Return API using FVU & Form 27A (Poll Job)

job_idResponseRemark
2aa54d2b-68f6-4871-866a-4eba957a8672200Job Queued Response
f845f37e-7f05-4de9-a282-a3b23b9d370a200Job Done Response
6e8d1908-c062-4846-a811-8f73054acd65200Job Failed: Regular Statement with the same TAN, Financial Year, FORM, and Quarter is already furnished
d75c3d26-4f81-451f-ab38-e217ea801ea1200Job Failed: Unacceptable FVU
d1213059-ec22-4e10-b0c1-a91814377001200Job Failed: Invalid Archive
3b979ce9-ef4e-4157-a4a3-51e8747e76d7200Job Failed: Invalid Number of entries in Archive: 1
d6f5b340-440b-400c-9b86-16e691e768b0200Job Failed: Form Type Mismatch
7a62876a-d638-430c-ad77-8fe33d9e63d5200Job Failed: Quarter Mismatch
6b11d176-b3c5-483c-9052-b533a6e92377200Job Failed: Barcode Mismatch
7928082e-34ca-474c-ba05-4ede9598b9b5200Job Failed: Financial Year Mismatch
5fd2679f-040f-435c-a285-df5817a150b5200Job Failed: TAN Mismatch
9bf0b6f8-5957-484f-9aea-0d235054974c200Job Failed: FVU Missing
b411fbee-68e4-4da3-9f62-8de8ca09a74c200Job Failed: Form 27A missing
a75b67be-8b33-431f-bc40-76b7be68bcd2422Invalid TAN Pattern
e2c3ca8b-2d36-4b2d-b6a3-a778ab7adf51422Invalid Form
e605e5dc-1d2f-424f-a677-c49ba3305711500Internal Server Error
7baed565-4dc2-46a1-89c2-be35a0a38081521Data not found

TDS Certificate API - Authenticate TRACES Session

usernamepasswordtanResponseRemark
TestSucess12sessionSucessfulAHMA09719B200Success, Access token generated
TestFailed39sessionFailedAHMA09719B403Bad Credentials
TestUser32TestPassword94MUMR09719B403Insufficient Privilege Error
TestUser30TestPassword54MUMR09T19B422Incorrect Body/Pattern
TestError45ErrorPass59PDES03028F500Internal Server Error

TDS Certificate API - Download Form 16A (Submit Job)

Test Payloads

{
  "bsr_code": "1234567",
  "challan_date": 1670783400000,
  "challan_serial_no": "01234",
  "provisional_receipt_number": "990000123469999",
  "challan_amount": 20000,
  "unique_pan_amount_combination_for_challan": [
    [
      "sr_no",
      "pan",
      "total_amount_deposited_against_pan"
    ],
    [
      1,
      "XXXPX1234A",
      2000
    ],
    [
      2,
      "XXXPX1234B",
      6000
    ],
    [
      3,
      "AXXPX1234Z",
      12000
    ]
  ]
}
{
  "bsr_code": "2345678",
  "challan_date": 1670783400000,
  "challan_serial_no": "12345",
  "provisional_receipt_number": "990000123469999",
  "challan_amount": 1000,
  "unique_pan_amount_combination_for_challan": [
    [
      "sr_no",
      "pan",
      "total_amount_deposited_against_pan"
    ],
    [
      1,
      "XXXPX1234A",
      250
    ],
    [
      2,
      "XXXPX1234J",
      250
    ],
    [
      3,
      "XXXPX1234D",
      500
    ]
  ]
}
{
    "bsr_code": "122456",
    "challan_date": 1670783400000,
    "challan_serial_no": "12234",
    "provisional_receipt_number": "990000123469999",
    "challan_amount": 9000.0,
    "unique_pan_amount_combination_for_challan": [
        [
            "sr_no",
            "pan",
            "total_amount_deposited_against_pan"
        ],
        [
            1,
            "XXXPX1234J",
            3000
        ],
        [
            2,
            "XXXPX1234J",
            3000
        ],
        [
            3,
            "XXXPX1234J",
            3000
        ]
        
    ]
}
{
  "bsr_code": "1234577",
  "challan_date": 1670783400000,
  "challan_serial_no": "01233",
  "provisional_receipt_number": "990000123469999",
  "challan_amount": 15000,
  "unique_pan_amount_combination_for_challan": [
    [
      "sr_no",
      "pan",
      "total_amount_deposited_against_pan"
    ],
    [
      1,
      "XXXPX1234A",
      5000
    ],
    [
      2,
      "XXXPX1234B",
      5000
    ],
    [
      3,
      "AXXPX1234Z",
      5000
    ]
  ]
}
{
    "bsr_code": "234567",
    "challan_date": 1670783400000,
    "challan_serial_no": "91234",
    "provisional_receipt_number": "990000123469999",
    "challan_amount": 18000.0,
    "unique_pan_amount_combination_for_challan": [
        [
            "sr_no",
            "pan",
            "total_amount_deposited_against_pan"
        ],
        [
            1,
            "XXXPX1234A",
            2000
        ],
        [
            2,
            "XXXPX1234B",
            6000
        ],
        [
            3,
            "AXXPX123EE",
            10000
        ]
        
    ]
}
{
  "bsr_code": "1234566",
  "challan_date": 1670783400000,
  "challan_serial_no": "01244",
  "provisional_receipt_number": "990000123469999",
  "challan_amount": 30000,
  "unique_pan_amount_combination_for_challan": [
    [
      "sr_no",
      "pan",
      "total_amount_deposited_against_pan"
    ],
    [
      1,
      "XXXPX1234A",
      2000
    ],
    [
      2,
      "XXXPX1234B",
      6000
    ],
    [
      3,
      "AXXPX1234Z",
      12000
    ]
  ]
}

TDS Certificate API - Download Form 16A (Poll Job)

TANjob_idResponseRemark
MUMR09719B2aa54d2b-68f6-4871-866a-4eba957a8672200Job Queued Response
AHMA09719Bf845f37e-7f05-4de9-a282-a3b23b9d370a200Job Done Response
PDES03028Ed75c3d26-4f81-451f-ab38-e217ea801ea1200Job Failed: No Form 16A
AABC23456D6e8d1908-c062-4846-a811-8f73054acd65200Job Failed: Invalid KYC data

Reporting API

Submit Job API

TANFormQuarterRemarks
AHMA09719B26Q-The job will be successful
AHMA09719B27Q-The job will be successful
AHMA09719B24Q-The job will be successful
AHMA09719B24QQ4The job will be successful
BLRC23456F--Job failed with Validation report
DABC2345DD--Invalid TAN Pattern
EABC23456N--Invalid Form

Poll Job API

Job IDRemarks
46d96540-e4e0-4188-81f5-959f4732490fJob Done Response for Form 26Q
5c9f6262-49c0-4ae7-8e60-9a6404ef748fJob Done Response for Form 27Q
ef528abe-d259-49f9-8e57-ec33c703f03fJob Done Response for Form 24Q
5631a2b1-b9e9-4189-8304-524d5cd080bfJob Done Response for Form 24Q (Q4)
77a45361-9646-4ee0-93ed-9471bb8a615eJob failed with a Validation report

Calculator API

Non-Salary Payments API

DataResponseRemarks
Payload 1200Success - TDS u/s 194BA
Payload 2200Success - TDS u/s 194C
Payload 3200Success - TDS u/s 194C
Payload 4200Success - TDS u/s 194LC
Payload 5200Success - TDS u/s 195

Test Payloads

{
    "@entity": "in.co.sandbox.tds.calculator.non_salary.request",
    "deductee_type": "individual",
    "is_pan_available": true,
    "residential_status": "resident",
    "is_206ab_applicable": false,
    "is_pan_operative": false,
    "nature_of_payment": "winnings_from_online_games",
    "credit_amount": 84232,
    "credit_date": 1694131200000
}
{
    "@entity": "in.co.sandbox.tds.calculator.non_salary.request",
    "deductee_type": "individual",
    "is_pan_available": true,
    "residential_status": "resident",
    "is_206ab_applicable": true,
    "is_pan_operative": true,
    "nature_of_payment": "sales_and_marketing_services",
    "credit_amount": 250000,
    "credit_date": 1699315200000
}
{
    "@entity": "in.co.sandbox.tds.calculator.non_salary.request",
    "deductee_type": "company",
    "is_pan_available": false,
    "residential_status": "resident",
    "is_206ab_applicable": false,
    "is_pan_operative": false,
    "nature_of_payment": "tender_fees",
    "credit_amount": 90500,
    "credit_date": 1685577600000
}
{
    "@entity": "in.co.sandbox.tds.calculator.non_salary.request",
    "deductee_type": "individual",
    "is_pan_available": true,
    "residential_status": "non_resident",
    "is_206ab_applicable": false,
    "is_pan_operative": true,
    "nature_of_payment": "interest_payment_from_indian_company_or_business_trust",
    "credit_amount": 7423,
    "credit_date": 1696636800000
}
{
    "@entity": "in.co.sandbox.tds.calculator.non_salary.request",
    "deductee_type": "body_of_individuals",
    "is_pan_available": true,
    "residential_status": "non_resident",
    "is_206ab_applicable": false,
    "is_pan_operative": true,
    "nature_of_payment": "fees_for_technical_service",
    "credit_amount": 25000,
    "credit_date": 1699315200000
}