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/Resource — entity reference
REFERENCE · Last reviewed

Resource — entity reference

A resource is the record for one person who does work in xMatix - a sales executive, service advisor, technician, driver, manager or back-office employee - and the record that documents, visits, timesheets, payslips, expense claims, leave and loans point to when they name a person. A user account decides how someone signs in; the resource decides who they are in the business. The two are linked through the resource's User field, and the active resource whose User is the signed-in account is treated as that user's own resource: it fills empty person fields on new records and gives new documents their company and branch. The Payroll Employee record and Resource Compensation records point to the resource, and payroll reads bank details and PAN from it. Resources appear in the Platform, Payroll and Rewards apps.

Fields

FieldLabelTypeRequiredWhat it does
AadhaarNumberAadhaar NumberTextThe person's Aadhaar number.
BankAccountNumberBank Account NumberTextThe bank account salary and reimbursements are paid to. Salary payment batches read it from the resource when they are generated.
BusinessHoursIdBusiness HoursLookup → BusinessHoursThe person's own working hours. Where consulted, for example to find the person's time zone for attendance, they take precedence over the default branch's hours.
CreatedByIdCreated ByLookup → UserAccountYes
CreatedDateTimeCreated DateDateAndTimeYes
DefaultBranchIdDefault BranchLookup → BranchThe branch this person normally works from. Only branches of the Default Partner Account are offered, and it must be set together with Default Partner Account - saving one without the other is refused.
DefaultPartnerAccountIdDefault Partner AccountLookup → AccountThe company this person normally works for. Only partner accounts are offered. It must be set together with Default Branch - saving one without the other is refused. When both are set, a new document this person creates with no company and no branch gets this pair. Otherwise the person's first current Partner Resource assignment is used, and failing that whichever default is set.
DepartmentDepartmentPickListThe person's department. Shipped values are IT, HR, Sales and Finance; the list can be extended. Values: IT, HR, Sales, Finance.
DesignationDesignationPickListThe person's job title. Shipped values are Software Engineer, HR Executive, Sales Executive and Sales Executive Financial Analyst; the list can be extended. Values: Software Engineer, HR Executive, Sales Executive, Sales Executive Financial Analyst.
EffectiveFromDateEffective From DateDateThe start of the person's validity window for automatic assignment rules: before this date the person is skipped as not effective yet. Nothing else reads it, and it is not on the shipped form.
EffectiveTillDateEffective Till DateDateThe end of the person's validity window for automatic assignment rules: after this date the person is skipped as no longer effective. It must be later than Effective From Date. It does not switch the resource off - clear Active for that.
EmployeeIdCodeText, uniqueYesThe person's staff or employee number, labelled Code and shown as Resource Id in the lists. Required and unique. It is a plain code: the payroll Employee record links to the resource itself, not to this code.
EmploymentTypeEmployment TypePickListPermanent or Contractual. Payroll uses the employment type on the Employee record instead. Values: Permanent, Contractual.
ExternalIdExternalText, uniqueAn identifier for this person in another system, used by integrations. Unique when set.
IdIdGuidYes
IFSCCodeIFSC CodeTextThe bank branch code of the person's bank account, read with the account number when salary payments are generated.
IncentiveResourceGroupIdIncentiveResourceGroupLookup → ResourceGroupPlaces the person in a resource group for incentive purposes.
IsActiveActiveBooleanWhether the resource is in use. New resources start inactive. Only an active resource acts as its user's own resource, can check in on the mobile app or is picked by automatic assignment, and documents naming an inactive resource that has partner-resource assignments are refused. Switch it off when someone leaves; their history is kept.
IsEligibleForPTIs Eligible for PTBooleanMarks the person as liable for professional tax so payroll configuration can distinguish them.
IsRelatedPartyRelated PartyBooleanMarks the person as a related party of the organization, such as a director, key manager or their relative. Related parties are included as persons in the related-party disclosure and statutory annual reports. Switch it on before choosing a Related Party Type.
JoiningDateJoining DateDateThe date the person joined. Recorded for HR purposes; calculations do not read it.
LabelResource LabelTextA secondary display text, separate from Name. Usually left empty.
LabourCostRatePerHourLabour Cost Rate Per HourDecimalWhat one hour of this person's time costs, used to cost their working hours in profitability analysis.
ManagerResourceIdManagerLookup → ResourceThe person's direct manager, as another resource. Requests that go to the manager, such as outlet transfer requests, use it, and on the mobile app a manager's team roster lists the active resources that name them here.
ModifiedByIdModified ByLookup → UserAccountYes
NameNameTextYesThe person's name as it appears in pickers and on documents.
OwnerIdOwnerLookup → UserAccountYes
PANNumberPAN NumberTextThe person's PAN, used for tax deducted from salary, TDS returns and PAN verification.
PanVerificationSourcePAN Verification SourceTextWhere the PAN verification result came from; the bulk verification import records its own source value.
PanVerificationStatusPAN VerificationPickListThe result of verifying this person's PAN with the tax department: Verified, Invalid or Name Mismatch; empty means never verified. Filled when a bulk PAN verification result file is imported on a TDS return. Values: Verified, Invalid, Name Mismatch.
PanVerifiedOnPAN Verified OnDateAndTimeWhen the PAN verification result was recorded.
ParentResourceIdParent ResourceLookup → ResourceA parent in a resource structure, kept separate from the reporting line held in Manager.
PFAccountPF AccountTextThe person's provident fund account number.
PhonePhoneTextThe person's contact phone number.
RecordTypeIdRecord TypeGuid, hidden
RelatedPartyEffectiveFromRelated Party FromDateThe date the related-party relationship began.
RelatedPartyEffectiveToRelated Party ToDateThe date the related-party relationship ended. It cannot be before Related Party From.
RelatedPartyRelationshipRelationshipTextA short description of the related-party relationship.
RelatedPartyTypeRelated Party TypePickListThe nature of the related-party relationship. Required when Related Party is on, and refused when it is off. Values: Director, Key Management Personnel, Relative of Director / KMP, Holding Company, Subsidiary Company, Fellow Subsidiary (Sister Concern), Associate / Joint Venture, Entity Controlled by Director / KMP, Promoter, Other.
ResourceTypeResourceTypeLongMultiLineTextA free-text classification beside Resource Type, with no fixed list of values. Organizations use it in their own filters and rules to select a group of people.
SalaryStructureIdSalary StructureLookup → SalaryStructureA salary structure kept for reference. Payroll does not use it: pay is calculated from the salary structure on the person's latest active Resource Compensation record.
SkipManagerResourceIdSkip ManagerLookup → ResourceThe manager one level above the direct manager, for skip-level approvals and escalation.
TypeResource TypePickListYesThe person's role: Service Advisor, Manager, Salesperson or Labour. Required. The All Managers and All Service Advisors list views filter on it; the shipped All Salespersons view filters on the value Sales Persons, which the shipped value Salesperson does not match. Values: Service Advisor, Manager, Salesperson, Labour.
UANUANTextThe person's provident fund universal account number.
UIPropsUI PropsText
UpdatedDateTimeModified DateDateAndTimeYes
UserIdUserLookup → UserAccountThe sign-in account of this person. The active resource whose User is the signed-in account is that user's own resource: it is stamped into empty person fields on new records and supplies their company and branch. Leave it empty for people who never sign in, and link each user to one resource only - with two, either may be picked.

Actions

ActionLabelTypeWhat it does
BulkDeleteDeleteDeleteDelete the selected records.
CloneCloneServerAction (Clone)Creates a copy of the resource as a new record, through the normal save, so validations such as the default company and branch rule apply. The shipped record page header does not show it.
DeleteDeleteDeleteDelete
DeleteInListDeleteDeleteDelete in a list page
EditEditEditEdit
EditInLineEditEditInlineEditInLine
EditInListEditEditInlineEdit in List Header
EditListRowEditEditEdit
EditPopupEditEditEdit
LatestForm16Latest Form 16ServerActionInactive. It only opened a layout of sample images, which was removed. Form 16 prints from the person's TDS certificate (Print Form 16).
NewNewNewNew

Validations

ValidationApplies toError messageNotes
Effective Till Date Rule ValidationEffectiveTillDate, ErrorEffective Till Date cannot be before Effective From DatePrevents Till Date from Older.

Lookup filters

FilterLookup fieldNotes
BranchFilterDefaultBranchId
PartnerAccountFilterDefaultPartnerAccountId