Overview

This API takes in Form 16 PDF as a multi-part file and converts into JSON format.

Problem

Taxpayer has a Form 16 PDF which cannot be directly consumed for ITR calculation hence PDF must be parsed to be consumed

Solution

The Form 16 API helps the Taxpayer to convert the uploaded Form 16 PDF to a JSON object. This JSON can then be used to calculate Income Tax Return based on details entailed in Taxpayer's Form 16.

Endpoint

HTTP Method	Resource
POST	form-16/pdf

Request

Body

Param	Type	Description	Example
form16	`pdf`	Upload file as a Multipart file	Form 16

Query Params

Param	Type	Description
email	`string`	email id
password	`string`	Password of encrypted Form 16

Sample Payload

Form 16

Response

Param	Type	Description	Example
form16	`json`	Converted JSON file of form 16	Sample JSON

Sample JSON

{
    "Part A": {
        "tds": [
            [
                "quarter",
                "receipt_number",
                "credit_amount",
                "tax_deducted",
                "tax_deposited"
            ],
            [
                "Q4",
                "QUIFEEGA",
                75000.0,
                2591.0,
                2591.0
            ],
            [
                "Q3",
                "FXISHVMI",
                225000.0,
                6795.0,
                6795.0
            ],
            [
                "Q2",
                "FXIVQNTO",
                450000.0,
                13234.0,
                13234.0
            ],
            [
                "Total",
                null,
                750000.0,
                22620.0,
                22620.0
            ]
        ],
        "employer": {
            "tan": "AHMS41521B",
            "address": {
                "area": "",
                "street": "1, Marine Drive, ",
                "postal_code": "400001"
            },
            "name": "Stark Industries",
            "pan": "ABCCD1469N"
        },
        "employee": {
            "address": {
                "area": "",
                "street": "5 Marine Drive, ",
                "postal_code": "400001"
            },
            "last_name": "STARK",
            "pan": "ACPPA2608F",
            "first_name": "TONY"
        }
    },
    "Part B": {
        "assessment_year": "2023-24",
        "employer": {
            "tan": "AHMS41521B",
            "address": {
                "area": "",
                "street": "1, Marine Drive, ",
                "postal_code": "400001"
            },
            "name": "Stark Industries",
            "pan": "ABCCD1469N"
        },
        "employee": {
            "address": {
                "area": "",
                "street": "5 Marine Drive, ",
                "postal_code": "400001"
            },
            "last_name": "STARK",
            "pan": "ACPPA2608F",
            "first_name": "TONY"
        },
        "details_of_salary_paid": {
            "surcharge": 0,
            "gross_salary": {
                "reported_total_amount_of_salary_received_from_other_employer": 0,
                "profits_in_lieu_of_salary_us_17_3": 0,
                "value_of_perquisites_us_17_2": 0,
                "salary_as_per_provisions_contained_in_section_17_1": 774366
            },
            "gross_total_income": 567293,
            "tax_payable": 0,
            "allowances_us_10": {
                "house_rent_allowance_us_10_13_a": 154873,
                "commuted_value_of_pension_us_10_10_a": 0,
                "death_cum_retirement_gratuity_us_10_10": 0,
                "total_amount_of_any_other_exemption_us_10": 0,
                "total_amount_of_exemption_claimed_us_10": 154873,
                "travel_concession_or_assistance_us_10_5": 0,
                "cash_equivalent_of_leave_salary_encashment_us_10_10_aa": 0
            },
            "total_amount_of_deductions_us_16": 52200,
            "health_and_eduction_cess": 0,
            "deduction_under_chapter_vi_a": {
                "deduction_us_80_ccc": {},
                "deduction_us_80_tta": {},
                "total_deduction_us_80_cce": {
                    "gross_amount": 100000,
                    "deductible_amount": 100000
                },
                "deduction_us_80_ccd_1": {},
                "deduction_us_80_d": {},
                "deduction_us_80_ccd_1_b": {},
                "deduction_us_80_e": {},
                "deduction_us_80_g": {},
                "total_deduction_us_80_ccd_2": {},
                "deduction_us_80_c": {
                    "gross_amount": 100000,
                    "deductible_amount": 100000
                }
            },
            "rebate_us_87_a": 10864,
            "opting_for_taxation_us_115_bac": "No",
            "relief_us_89": 0,
            "aggregate_deductible_amount_under_chapter_vi_a": 100000,
            "net_tax_payable": 0,
            "tax_on_total_income": 10864,
            "total_amount_of_other_income_reported_by_employee": 0,
            "other_income_reported_by_employee_us_192_2_b": {
                "income_under_the_head_other_sources_offered_for_tds": 0,
                "income_from_house_property_reported_by_employee_offered_for_tds": 0
            },
            "income_chargeable_under_the_head_salaries": 567293,
            "total_amount_of_salary_received_from_current_employer": 619493,
            "deduction_us_16": {
                "entertainment_allowance_us_16_ii": 0,
                "standard_deduction_us_16_ia": 50000,
                "tax_on_employment_us_16_iii": 2200
            },
            "total_taxable_income": 467293
        }
    }
}