Salary Details API

You can call this API to post the salary details of employees and also you can fetch, count and delete details posted using this API

Salary Details Entity

The various properties are explained below:

For convenience, an index (Sr. No) is given to each field. Numbers in descriptions (of totals) refer to the index of entities

Sr. No

Param

Type

Required

Description

1

id

32 bit hex

Yes

Salary Details ID

2

salary_detail_serial

decimal

No

Salary detaill serial

3

employee_pan

String

Yes

Employee PAN

4

employee_name

String

Yes

Employee Name

5

employee_code

String

No

Employee Code

6

employee_category

String

Yes

Employee Category Possible Values: Woman, Senior Citizen, Super Senior Citizen, Others

7

employment_from_date

Date

Yes

Employment Start Date, Format: DD/MM/YYYY

8

employment_to_date

Date

Yes

Employment To Date, Format: DD/MM/YYYY

9

financial_year

String

Yes

Financial year

Format: FY 2020-21

10

basic_salary

decimal

Yes

Basic Salary as per section 17(1)

(Should be >= 0)

11

perquisites

decimal

Yes

Perquisites as per section 17(2)

(Should be >= 0)

12

profit

decimal

Yes

Profit in lieu of salary as per section 17(3)

(Should be >= 0)

13

gross_salary

decimal

Yes

Gross Salary

(Sum of 10, 11, 12)

14

gross_salary_from_previous_employer

decimal

Yes

Gross Salary from pervious employer (Reported Taxable Amount on which tax is deducted by previous employer)

(Should be >= 0)

15

gross_total_salary

decimal

Yes

Gross total salary

(Sum of 13, 14)

16

standard_deduction

decimal

Yes

Standard Deduction

(Section 16 (ia))

(Value should be >= 0 and <= 50,000)

17

entertainment_allowance

decimal

Yes

Entertainment Allowance

(Section 16 (ii))

(Value should be >= 0 and <= 50,000)

18

professional_tax

decimal

Yes

Professional tax

(Section 16 (iii))

(Value should be >= 0 and <= 50,000)

19

total_deduction_us_16

decimal

Yes

Total Deduction under US 16

(Sum of 16, 17, 18)

20

travel_allowance

decimal

Yes

Travel Allowance / concession or assistance

(Should be >= 0)

21

retirement_gratuity

decimal

Yes

Death-cum-retirement gratuity

(Should be >= 0)

22

commuted_pension

decimal

Yes

Commuted value of pension

(Should be >= 0)

23

leave_encashment

decimal

Yes

Cash equivalent of leave salary encashment

(Should be >= 0)

24

house_rent_allowance

decimal

Yes

House Rent Allowance

(Should be >= 0)

25

payments_from_super_annuation_fund

decimal

Yes

Payments from Super Annuation Fund

26

other_allowance

decimal

Yes

Amount of any other exemption under section 10

(Should be >= 0)

27

total_allowance_us_10

decimal

Yes

Total Allowance under US 10

(Sum of 20, 21, 22, 23, 24, 26)

28

total_salary

decimal

Yes

Total Salary

Should be equal to 15 - (19 + 27)

29

total_house_property_income

decimal

Yes

Total House Property Income

(Income (including admissible loss under house property) under any head other than income head salaries offered forTDS)

(Negative values allowed)

30

total_other_income

decimal

Yes

Total Other Income

(Income under the head other sources offered for TDS)

31

gross_total_income

decimal

Yes

Gross Total Income

Should be equal to (28 + 29 + 30)

32

deduction_80_c

decimal

No

Deduction under 80 C

33

deduction_80_ccc

decimal

No

Deduction under 80 CCC

34

deduction_80_ccd1

decimal

No

Deduction under 80 CCD1

35

total_deduction_80_cce

decimal

No

Total Deduction under 80 CCE

(Sum of 32 + 33 + 34)

36

deduction_80_ccd1b

decimal

No

Deduction under 80 CCD1B

37

deduction_80_ccd2

decimal

No

Deduction under 80 CCD2

38

deduction_80_ccg

decimal

No

Deduction under 80 CCG

39

health_insurance_premium_category_80_d

String

No

Health Insurance premium category 80 D

40

health_insurance_premium_80_d

decimal

No

Health insurance premium 80 D amount

41

medical_expenditure_category_80_d

String

No

Medical Expenditure Category 80D

42

medical_expenditure_80_d

decimal

No

Medical Expenditure Category 80D amount

43

preventive_checkup_category_80_d

String

No

Preventive Checkup Category 80D

44

preventive_checkup_80_d

decimal

No

Preventive Checkup Category 80D amount

45

total_deduction_80_d

decimal

No

Total Deduction under 80D

(Sum of 40 + 42 + 44)

46

deduction_80_e

decimal

No

Deduction under 80E

47

deduction_80_g

decimal

No

Deduction under 80G

48

deduction_80_tta

decimal

No

Deduction under 80 TTA

49

deduction_80_ttb

decimal

No

Deduction under 80 TTB

50

eligibility_80_dd

String

No

Eligibility under 80 DD

51

deduction_80_dd

decimal

No

Deduction under 80 DD

52

eligibility_80_ddb

String

No

Eligibility under 80 DDB

53

deduction_80_ddb

decimal

No

Deduction under 80 DDB

54

eligibility_80_u

String

No

Eligibility under 80 U

55

deduction_80_u

decimal

No

Deduction under 80 U

56

deduction_80_ggc

decimal

No

Deduction under 80 GGC

57

deduction_80_gga

decimal

No

Deduction under 80 GGA

58

deduction_80_ee

decimal

No

Deduction under 80 EE

59

deduction_80_gg

decimal

No

Deduction under 80 GG

60

total_other_deduction_under_chapter_vi_a

decimal

No

Total other deduction under chapter 6A

61

total_deduction_under_chapter_vi_a

decimal

Yes

Total deduction under chapter 6A

(Sum of all deductions under VI A)

62

total_taxable_income

decimal

Yes

Total Taxable Income Value should be equal to field(31 - 61)

63

tax_on_total_income

decimal

Yes

Tax on Total Income

(Value should be >= 0 and

<= total_taxable_income(62))

64

rebate_us_87_a

decimal

Yes

Rebate under 87A

(Value should be >= 0)

65

surcharge

decimal

Yes

Surcharge

(Value should be >= 0 and

<= total_taxable_income(62))

66

education_cess

decimal

Yes

Educational Cess

(Value should be >= 0 and

<= total_taxable_income(62))

67

gross_tax_liability

decimal

Yes

Gross Tax Liability

(Value should be equal to sum of 63 + 65 + 66)

68

relief_us_89

decimal

Yes

Relief under 89

(Value should be >= 0 and

<= total_taxable_income(62))

69

net_tax_liablity

decimal

Yes

Net Tax Liability

(Value should be equal to sum of 63 + 65 + 66 - 68 - 64)

70

tds_on_salary

decimal

Yes

TDS on salary

(Total TDS by current employer for the whole year)

71

tds_on_other_than_salary

decimal

Yes

TDS on income other than salary

(Reported amount of TDS by previous employer)

72

total_tax_deducted_at_source

decimal

Yes

Total TDS (Sum of total tds of year from current employer, previous employer and tds on repayment of superannuation fund)

(Sum of field 70, 71, 85)

(Field 85 is not mandatory)

73

shortfall

decimal

Yes

Shortfall in tax deduction (+ve) / excess tax deduction (-ve)

(Value should be equal to 69 - 72)

74

is_tax_deducted_at_higher_rate

Boolean

No

Is tax deducted at higher rate?

75

is_aggreget_rent

Boolean

Yes

Whether aggregate rent payment exceeds rupees one lakh during previous year (Mention true OR false)

76

is_intrest_paid_to_lender

Boolean

Yes

Is interest paid to lender or not. (Whether Interest paid to the lender under the head 'Income from house property')

(Mention true OR false)

77

lenders

Array of Lender

No

List of Lenders

(Entity given below)

(If true is mentioned in field 76, including atleast 1 lender is mandatory, else not)

78

landlord

Array of Tax Payer

No

List of Landlords

(Entity given below)

(If true is mentioned in field 75, including atleast 1 landlord is mandatory, else not)

79

is_superannuation_paid

Boolean

No

Is superannuation paid or not

(Mention true OR false if applicable)

80

is_superannuation_fund_name

String

No

Superannuation fund name

(Mandatory if true is mentioned in field 79)

81

start_date_of_contribution

DateTime

No

Start date of Contribution

(Mandatory if true is mentioned in field 79)

(Format: DD/MM/YYYY)

82

end_date_of_contribution

DateTime

No

End date of Contribution

(Mandatory if true is mentioned in field 79)

(Format: DD/MM/YYYY)

83

superannuation_amount_repaid

decimal

No

Superannuation Amount Repaid

(Mandatory if true is mentioned in field 79)

(Value should be >= 0)

84

three_year_avg_tds

decimal

No

Average rate of deduction of tax during the preceding 3 years (Mandatory if true is mentioned in field 79)

(Decimal value should be

>= 0 and should have precision of 4 point)

85

tds_on_repayment

decimal

No

The amount of tax deducted on repayment of superannuation fund

(Mandatory if true is mentioned in field 79)

(Decimal value should be >= 0)

86

is_corrected

Boolean

No

Is TDS return corrected?

87

is_deleted

Boolean

No

Is TDS return deleted?

Lender Entity

The various properties are explained below:

Param

Type

Required

Description

lender_type

LenderType

No

Type of Lender Possible Values: Financial Institution, Employer, Other

id

32 bit hex

Yes

Lender ID

name

string

Yes

Name of Lender

pan

string

Yes

PAN of Lender

(If pan is not issued, if person is government employee, mention value GOVERNMENT, if person is Non Resident, mention value NONRESDENT, else mention OTHERVALUE)

pan_holder_type

string

No

PAN Holder Type

address

Address

No

Address of Lender

(Check entity in payer section)

contact

Contact

No

Contact of Lender

(Check entity in payer section)

residential_status

string

No

Residential Status Possible Values: Resident, Non Resident, Not Ordinarily Resident

Tax Payer Entity

The various properties are explained below:

Param

Type

Required

Description

id

32 bit hex

Yes

Lender ID

name

string

Yes

Name of Tax Payer

pan

string

Yes

PAN of Tax Payer

(If pan is not issued, if person is government employee, mention value GOVERNMENT, if person is Non Resident, mention value NONRESDENT, else mention OTHERVALUE)

pan_holder_type

string

No

PAN Holder Type

address

Address

No

Address of Tax Payer

(Check entity in payer section)

contact

Contact

No

Contact of Tax Payer

(Check entity in payer section)

residential_status

string

No

Residential Status Possible Values: Resident, Non Resident, Not Ordinarily Resident