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

Salary Component — entity reference

One line of a salary structure: which payroll component is paid and how its amount is worked out. The payroll run works out a structure's active lines in Sequence order. Fixed, Manual and Formula lines pay their Value (formula text is not evaluated). Percentage lines pay Value per cent of the compensation record's CTC when Is Percentage of CTC is on, otherwise of the earlier line whose Component Name matches Percentage Of. A PT line with Calculation Type Slab reads the professional tax slabs, and a TDS line takes the month's tax projection. Min Amount and Max Amount then clamp the amount, and proratable lines are reduced for loss-of-pay days. The linked payroll component's type, statutory type, taxability, proration and GL accounts override the line's own fields; a line with no payroll component gets no GL accounts, so the run cannot be posted. Lines are added from the structure's Components tab; the inline card has no Component Name or Sequence, so set both on the line's record page.

Fields

FieldLabelTypeRequiredWhat it does
CalculationTypeCalculation TypePickListFixed, Formula, Percentage, Slab or Manual. Percentage is calculated from CTC or an earlier line, and Slab is calculated from the professional tax slabs only on a component with Statutory Type PT. A component with Statutory Type TDS takes the month's tax projection whatever this field says. Everything else, including blank, pays Value. Values: Fixed, Formula, Percentage, Slab, Manual.
ComponentNameComponent NameTextThe line's name, and the key other lines use in Percentage Of. Name the basis line exactly Basic (capital letters don't matter). Not on the inline card that adds a line; set it on the line's record page. A line with no name cannot be used as a basis.
ComponentTypeComponent TypePickListEarning, Deduction, EmployerContribution or Reimbursement. Used only when the line has no payroll component; otherwise the component's type wins. Blank counts as Earning. Values: Earning, Deduction, EmployerContribution, Reimbursement.
CreatedByIdCreated ByLookup → UserAccountYes
CreatedDateTimeCreated DateDateAndTimeYes
EffectiveFromEffective FromDateNot read by the run: every active line applies in every period. Not on the standard forms.
EffectiveToEffective ToDateNot read by the run: switch Is Active off to retire a line. Not on the standard forms.
EmployeeIdEmployeeLookup → EmployeeNot stored. Lines belong to a structure, not to a person.
FormulaFormulaTextA formula expression. Not evaluated by the run; the line pays its Value.
IdIdGuidYes
IsActiveIs ActiveBooleanWhether the run uses the line. Blank counts as active. Switch it off to retire a line; the standard pages have no delete for lines.
IsPercentageofCTCIs Percentage of CTCBooleanTake the percentage of the person's monthly CTC from their compensation record. Wins over Percentage Of.
MaxAmountMax AmountCurrencyA ceiling for the amount, for example a PF wage ceiling, applied before proration. Read by the run, but not on the standard line forms until an administrator adds it.
MinAmountMin AmountCurrencyA floor for the amount, applied before proration. Read by the run, but not on the standard line forms until an administrator adds it.
ModifiedByIdModified ByLookup → UserAccountYes
NameNameTextYesThe line's number, filled from the SC document series when the line is saved. Click it on the structure's Components tab to open the line.
OwnerIdOwnerLookup → UserAccountYes
PayrollComponentIdPayroll ComponentLookup → PayrollComponentThe payroll component the line pays. Its Component Type, Statutory Type, Taxability, Is Proratable and both GL accounts override the line's own fields and are copied onto each calculated line. Always fill it: without it the calculated line has no GL accounts and posting fails. The picker lists the components of every company.
PercentageOfPercentage OfPickListFor a Percentage line, the Component Name of the earlier line it is a percentage of. The list offers Basic, CTC and Taxable Income, but only Basic can match a line, and only if a line is named Basic. CTC and Taxable Income give 0; use Is Percentage of CTC for CTC. Values: Basic, CTC, Taxable Income.
ProrataPro-rataBooleanReduce the amount for loss-of-pay days. Used only when the line has no payroll component; otherwise the component's Is Proratable decides.
RecordTypeIdRecord TypeGuid, hidden
SalaryStructureIdSalary StructureLookup → SalaryStructureThe structure the line belongs to. Filled when the line is added from the structure's Components tab.
SequenceSequenceNumberThe order in which the run works out the lines, lowest first. A Percentage line can only use a line with a lower Sequence, and professional tax uses the gross of the lines before it. Starts at 0 and is not on the inline card, so set it on every line; lines with the same Sequence come in no fixed order. Also the line's order on the register when its payroll component has no sort order.
StatutoryFlagStatutory FlagPickListNone, PF, ESI, TDS, PT, LWF or Gratuity. Used only when the line has no payroll component; otherwise the component's Statutory Type decides. Values: None, PF, ESI, TDS, PT, LWF, Gratuity.
SubscriptionKeySubscription KeyGuid, hiddenYes
TaxableTaxableBooleanMarks the calculated amount taxable. Used only when the line has no payroll component; otherwise the component's Taxability decides.
UpdatedDateTimeModified DateDateAndTimeYes
ValueValueNumberThe amount for a Fixed line, or the percentage for a Percentage line (40 means 40 per cent). Defaults to 0.

Actions

ActionLabelTypeWhat it does
CloneCloneServerAction (Clone)Create a copy of this record
DeleteDeleteDeleteDelete
EditEditEditInlineEdit
EditInRowEditEditEdit
NewNewNewNew
NewInlineNewNewInlineNew