Read Form16

OCR API to read Form 16 PDF in to JSON. Form 16 JSON can be used to programatically prepare ITR.

Suggest Edits

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

Here is a sample 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
        }
    }
}

Updated about 1 month ago