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

Professional Tax Slab — entity reference

One band of a company's professional tax schedule: a monthly gross-pay range and the PT amount to deduct for it, with an optional different amount for February. When a payroll run is calculated, a salary-structure line whose payroll component has Statutory Type PT and whose Calculation Type is Slab takes its amount from these rows instead of from its own Value. The run loads every active slab of the run's company, matches the gross pay worked out by the lines before the PT line, and uses the matching band with the highest From Amount. State Code and Effective From are recorded but not used to choose a band, so keep only the current schedule active for each payroll company. Slabs are found under Payroll, Settings, Statutory Compliance.

Fields

FieldLabelTypeRequiredWhat it does
CreatedByIdCreated ByLookup → UserAccountYes
CreatedDateTimeCreated DateDateAndTimeYes
EffectiveFromEffective FromDateThe date the band's schedule applies from, for your records. The calculation does not read it: an older and a newer band that are both active compete on the gross amount alone, so untick Is Active on the bands a revision replaces.
FebruaryPTFebruary PTCurrencyThe amount used instead of Monthly PT when the payroll period's End Date is in February, for states that collect a different figure that month. Blank means Monthly PT is used in February too. It is not on the seeded create or record forms, so an administrator adds it to the form layout before it can be entered.
FromAmountFrom AmountCurrencyThe bottom of the monthly gross-pay band, inclusive. Blank counts as 0. When more than one active band contains the gross, the band with the highest From Amount is used.
IdIdGuidYes
IsActiveIs ActiveBooleanTicked by default. Only active slabs are used, and a blank value counts as active. Untick it to retire a band while keeping it for reference.
LabelLabelTextAn optional caption. It is on no seeded form and nothing reads it.
ModifiedByIdModified ByLookup → UserAccountYes
MonthlyPTMonthly PTCurrencyThe professional tax deducted in a month whose gross pay falls in this band, rounded to two decimals. Use 0 for an exempt band.
NameNameText, uniqueYesThe slab's identifier. It is filled automatically from the PTS numbering series when the slab is saved, and must be unique across the tenant.
OwnerIdOwnerLookup → UserAccountYes
PartnerAccountIdPartner AccountLookup → AccountThe company whose payroll uses this band; the picker lists your own companies only. A run uses only the slabs of its own company, so a slab with no company, or with another company, is never applied. If left blank it is filled from your default company in Company Access when you have one.
RecordTypeIdRecord TypeGuid, hidden
StateCodeState CodeTextThe state whose schedule this band belongs to, as free text of up to 10 characters. It is for your reference only: the payroll calculation does not filter by state, so bands of several states for the same company are pooled and compete on the gross amount alone.
ToAmountTo AmountCurrencyThe top of the monthly gross-pay band, inclusive. Blank means no upper limit. Gross pay is worked out to two decimals, so a gap between one band's To Amount and the next band's From Amount (for example 10,000 and 10,001) leaves amounts in between with no band and no professional tax.
UIPropsUI PropsText
UpdatedDateTimeModified DateDateAndTimeYes

Actions

ActionLabelTypeWhat it does
CloneCloneServerAction (Clone)Create a copy of this record
DeleteDeleteDeleteDelete this ProfessionalTaxSlab.
DeleteBulkDeleteDeleteDeleteBulk
DeleteEntityDeleteDeleteDeleteEntity
EditEditEditEdit this ProfessionalTaxSlab.
EditEntityEditEditEditEntity
NewNewNewCreate a ProfessionalTaxSlab.
ViewViewViewView this ProfessionalTaxSlab.

Lookup filters

FilterLookup fieldNotes
PartnerAccountFilterPartnerAccountId