xMatix
Sign in Request demo
xMatix
PRODUCTS
SalesField Sales & SFACRMRewardsClaimsInventoryProcurementWarehouse ManagementField ServiceServiceSupportTelephony & MessagingFinance & AccountingPayrollExpense ManagementCommercePortalsAnalytics & ReportingData StudioMobile AppSee all products →
PLATFORM
Platform overviewApp BuilderAutomationIntegrationsSecurity & GovernanceChange ManagementDevelopers
SENSE AI
Sense AI overviewSense AssistSense ControlSense VisionAI StudioTrust & governanceIn Claude & ChatGPTUse cases
SOLUTIONS
Auto DMSConsumer Goods DMSSales Force Automation (SFA) FMCG & DistributionManufacturing & Dealer NetworksAutomotive & DealershipsPharma & HealthcareConsumer DurablesAgri-InputsBuilding MaterialsService NetworksWarehousing & 3PLFinancial AccountingERP SoftwareIndia GST ComplianceUAE VAT & e-InvoicingSaudi ZATCA & VATAll solutions →
RESOURCES
Knowledge CenterDeveloper & CLIBlogGuidesWhat is xMatix?Company facts
COMPANY
AboutCareersPartnersEventsContactAuthorsLegal
Sign in Request demo
Home/Docs/Entity Reference/Employee — entity reference
REFERENCE · Last reviewed

Employee — entity reference

The payroll record for a person: it links an existing Resource to the company that pays them and records their HR terms, dates and salary-tax election. The Resource stays the person's identity, so payroll postings, payslips, open items, loans, expense claims, leave and attendance are all keyed on the Resource, and bank account, IFSC, PAN and date of birth are held there. A payroll run includes every Employee that is not deleted, has a Resource, has a Payroll Company or Partner Account equal to the run's company, and whose Employment Status is not Exited; joining and exit dates, branch and pay type are not used to filter or prorate. One record per Resource is expected but not enforced, and a duplicate is calculated twice. Found in the Payroll app under Settings, People.

Fields

FieldLabelTypeRequiredWhat it does
BranchIdBranchLookup → BranchYesThe employer's branch, limited to the Partner Account's branches. Required. Payroll runs do not filter by it; the TDS work sheet shows it.
BusinessUnitIdBusiness UnitLookup → BusinessUnitFinance division. Recorded only; payroll does not read it.
ConfirmationDateConfirmation DateDateDate the person was confirmed. A validation refuses a date before Date Of Joining.
CostCenterIdCost CenterLookupHas no related list in the standard setup, so the lookup offers no values. Nothing reads it.
CreatedByIdCreated ByLookup → UserAccountYes
CreatedDateTimeCreated DateDateAndTimeYes
DateOfExitDate Of ExitDateLast day of employment. Posting a full and final settlement fills it from the Last Working Day when empty. Payroll does not read it; only Employment Status Exited stops pay. The shipped Date Of Exist validation has its condition reversed and refuses any exit date after the joining date, which also makes full and final posting fail, until an administrator corrects the condition to DateOfExit < DateOfJoining or deactivates the rule.
DateOfJoiningDate Of JoiningDateYesFirst day of employment. Required. Payroll does not prorate on it; a mid-month joiner is paid the full month unless approved unpaid leave or an adjustment reduces it.
DepartmentIdDepartmentLookupHas no related list in the standard setup, so the lookup offers no values. Nothing reads it.
EmployeeCodeEmployee CodeTextYesThe organisation's staff number for the person. Required but not checked for uniqueness. Shown on the TDS work sheet. Separate from the Employee ID text field on the Resource, which the mobile app shows; nothing keeps the two in step.
EmploymentStatusEmployment StatusPickListActive, On Notice or Exited (stored as Active, OnNotice, Exited); new records default to Active. Exited removes the person from every later payroll run and salary-TDS projection; On Notice is recorded only. Set to Exited by full and final posting. On the standard create form it is a free-text box, so the stored value must be typed exactly. Values: Active, On Notice, Exited.
EmploymentTypeEmployment TypePickListYesFull Time, Contract, Consultant, Intern or Permanent. Required. Recorded only; payroll treats every type the same. A free-text box on the standard create form. Values: Full Time, Contract, Consultant, Intern, Permanent.
EsiApplicableEsi ApplicableBooleanRecorded only. ESI is deducted when the salary structure has an ESI component, whatever this box says.
ExpenseAdvanceIdExpense AdvanceLookup → ExpenseAdvanceNot stored. Expense advances are keyed on the Resource.
ExpenseClaimIdExpense ClaimLookup → ExpenseClaimNot stored. Expense claims are keyed on the Resource.
ExpenseVoucherIdExpense VoucherLookup → ExpenseVoucherNot stored. An expense voucher carries its own Employee link.
GradeIdGradeLookup → GradeGrade master. Recorded only: expense-policy grade limits use the grade on the Resource.
IdIdGuidYes
KYCDocumentIdKYC DocumentLookup → KYCDocumentNot used. Look up a person's KYC documents directly.
LabelLabelText
LwfApplicableLwf ApplicableBooleanRecorded only. LWF comes from the salary structure's components, whatever this box says.
ModifiedByIdModified ByLookup → UserAccountYes
NameNameText, uniqueYesThe record's name, typed by the user. Required and unique across the tenant. The Employee document naming setting (series EMP) is inactive by default, so no name is generated.
OwnerIdOwnerLookup → UserAccountYes
PartnerAccountIdPartner AccountLookup → AccountYesThe legal employer, limited to the tenant's own companies. Required. A payroll run includes the person when this or Payroll Company equals the run's company.
PartnerResourceIdPartner ResourceLookup → PartnerResourceNot used by payroll.
PaymentSalaryDisbursementIdPayment (Salary Disbursement)Lookup → PaymentSalaryDisbursementNot stored. Salary payments are made through the salary payment batch, keyed on the Resource.
PayrollCompanyIdPayroll CompanyLookup → AccountThe company whose payroll runs include the person, when payroll runs under a different company from the Partner Account. A run matches either field, so a person whose two fields name different companies appears in both companies' runs.
PayslipIdPayslipLookup → PayslipNot used. Payslips are found through the payroll run details for the Resource.
PayTypePay TypePickListMonthly, Hourly, Daily or Piece Rate; defaults to Monthly. Recorded only: everyone is paid from their monthly structure, prorated by payable days. Values: Monthly, Hourly, Daily, Piece Rate.
PfApplicablePf ApplicableBooleanRecorded only. PF is deducted when the salary structure has a component with statutory type PF, whatever this box says.
PfWageCapOverridePf Wage Cap OverreCurrencyA personal PF wage ceiling. Recorded only; a ceiling is applied through the structure line's Max Amount.
ProbationEndDateProbation End DateDateEnd of probation. A validation refuses a date before Confirmation Date.
PtApplicablePt ApplicableBooleanRecorded only. Professional tax comes from a PT component on the salary structure, whatever this box says.
RecordTypeIdRecord TypeGuid, hidden
ResourceAvailabilityIdResource AvailabilityLookup → ResourceAvailabilityNot used. Attendance and leave are kept per day on the Resource.
ResourceCompensationIdResource CompensationLookup → ResourceCompensationNot used. Payroll takes the Resource's compensation record with the latest Effective From.
ResourceIdResourceLookup → ResourceYesThe person this record puts on payroll. Required. Payroll calculation, postings, payslips, open items and the TDS work sheet all work from this Resource.
SalaryComponentIdSalary ComponentLookup → SalaryComponentNot stored. Salary component lines belong to a salary structure.
SalaryPaymentModeSalary Payment ModePickListBank Transfer, Cash or Cheque; defaults to Bank Transfer. Recorded only: the salary payment batch always takes bank details from the Resource. Values: Bank Transfer, Cash, Cheque.
SalaryStructureIdSalary StructureLookup → SalaryStructureNot stored. The structure a person is paid from is named on their Resource Compensation record.
SettlementStatusSettlement StatusPickListActive, Exit In Process or Settled; defaults to Active and is set to Settled by full and final posting. Recorded only. Values: Active, Exit In Process, Settled.
TaxRegimeTax RegimePickListOld Regime or New Regime; defaults to New Regime. The salary-TDS projection applies the old regime only when this is Old; blank or New applies the new regime. Values: Old Regime, New Regime.
TdsApplicableTds ApplicableBooleanWhether salary TDS is projected and deducted. Left untouched (empty) counts as applicable; explicitly unticked removes the person from Project TDS, so no TDS is deducted.
UIPropsUI PropsText
UpdatedDateTimeModified DateDateAndTimeYes

Actions

ActionLabelTypeWhat it does
BulkDeleteDeleteDeleteDelete the selected records.
CloneCloneServerAction (Clone)Create a copy of this record
DeleteDeleteDeleteDelete this Employee.
DeleteRecordDeleteDeleteDelete
EditEditEditEdit this Employee.
EditInLineEditEditInlineEdit
EditRecordEditEditEdit
NewNewNewCreate a Employee.
ViewViewView, inactiveView this Employee.

Validations

ValidationApplies toError messageNotes
Date of ConfirmationConfirmationDate, ErrorConfirmation date cannot be less than Joining DateConfirmation date cannot be less than Joining Date
Date Of ExistDateOfExit, ErrorDate of exist cannot be less than Date of confirmationProbation End Date cannot be less than Confirmation Date
Probation End dateProbationEndDate, ErrorProbation End Date cannot be less than Confirmation Datedate

Lookup filters

FilterLookup fieldNotes
BranchFilterBranchId
PartnerAccountFilterPartnerAccountId