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

Compensation Slab — entity reference

One band of achievement on an incentive line and the reward it pays. When a compensation line is scored, each of the line's targets walks the line's slabs in Sequence Number order and the first slab whose band holds the member's achievement qualifies; each slab pays at most once per line. Bands are percentages of the member's quota for the period (achieved divided by quota times 100, rounded down) or, when the incentive line has Use Slab Absolute Value ticked, the achieved value itself against From Value and To Value. Monetary rewards of a line's qualifying slabs are combined by the line's Reward Applicability; gifts, points, discount group and scheme are copied onto the compensation line. Slabs are built with Reward in the line builder on the incentive plan's Related tab.

Fields

FieldLabelTypeRequiredWhat it does
AmountPercentageAmount PercentagePercentPercentage paid by Percentage On Value (of the achieved value) and by KPI Reward Value Percentage (of the KPI reward figure). Stored as a fraction with two decimals, so fractional percents such as 2.5 are not kept exactly. The plan builder shows it, as Incentive Percentage on Value, only for Percentage On Value.
CompensationTypeCompensation TypePickListWhat the slab pays. Fixed Amount pays Incentive Fixed Amount; Amount Per Unit pays Incentive Amount Per Unit times the achieved value; Amount Per Unit Incremental pays it on the part above the quota only, never below 0; Percentage On Value pays Amount Percentage of the achieved value; KPI Reward Value pays the member's KPI data reward for the qualifying target's KPI configuration and KPI Reward Value Percentage a percentage of it; Gifts and Discount Group pay no amount but are copied onto the compensation line. Slab Reward Percentage cannot name its reference line from the seeded screens and pays nothing, and Reward Points; and Percentage On Profit pay nothing. The engine also accepts Scheme Rewards, which is not in the seeded picklist. Values: Fixed Amount, Amount Per Unit, Amount Per Unit Incremental, Percentage On Value, KPI Reward Value, KPI Reward Value Percentage, Gifts, Discount Group, Reward Points;, Slab Reward Percentage.
CreatedByIdCreated ByLookup → UserAccountYes
CreatedDateTimeCreated DateDateAndTimeYes
CurrencyIsoCodeCurrency ISO CodeText
DiscountGroupIdDiscount GroupLookup → DiscountGroupDiscount group linked on the compensation line when a Discount Group slab qualifies. It is only recorded on the line; it does not change the discount on any document.
ExternalIdExternalText
FromPercentageFrom PercentagePercentLower bound of the percentage band (inclusive). Achievement is floor(achieved / quota x 100); empty counts as 0. Not read when the line uses absolute values. Stored as a fraction with two decimals, so keep it to whole percents; the plan builder accepts 0 to 100.
FromValueFrom ValueNumberLower bound of an absolute band, in the target's own units, read only when the incentive line has Use Slab Absolute Value ticked. A slab with neither From Value nor To Value never qualifies on an absolute line. Not shown in the plan builder.
GiftPointsReward PointsNumberReward points copied onto the compensation line together with Gifts.
GiftsGiftsPickListGift copied onto the compensation line when a Gifts slab qualifies; if two gift slabs qualify, the later one wins. The seeded picklist values are samples to replace; the plan builder takes free text. Values: Amazon Vouchers, iPhone X, Trip to Bali, Trip to Kerela, Discount Voucher.
IdIdGuidYes
IncentiveAmountPerUnitIncentive Amount Per UnitCurrencyAmount paid per unit of achieved value by Amount Per Unit, and per unit above the quota by Amount Per Unit Incremental. The plan builder only shows this box for Amount Per Unit.
IncentiveFixedAmountIncentive Fixed AmountCurrencyAmount paid when a Fixed Amount slab qualifies.
IncentiveLineIdIncentive LineLookup → IncentiveLineThe incentive line whose targets qualify this slab. Set by the plan builder.
IncentivePeriodIdIncentive PeriodLookup → IncentivePeriodShown on the slab forms but not read by the incentive engine: a slab applies to every period of its plan.
IncentivePlanIdIncentive PlanLookup → IncentivePlanThe incentive plan the slab belongs to. Set by the plan builder; the engine reaches slabs through their incentive line.
KPIConfigurationIdKPI ConfigurationLookup → KPIConfigurationLimits the slab to targets linked to this KPI configuration; a slab with a configuration never qualifies through a target without one. Empty means the slab serves every target on the line.
MemberResourceTypeMember Resource TypePickListShown on the slab forms but not read by the incentive engine. Values: Salesperson, Manager.
ModifiedByIdModified ByLookup → UserAccountYes
NameNameTextYes
OwnerIdOwnerLookup → UserAccountYes
PercentageonProfitPercentage on ProfitPercentNot read by the incentive engine; a Percentage On Profit slab pays nothing.
RecordTypeIdRecord TypeGuid, hidden
ReferenceIncentiveTargetIdReference Incentive TargetLookup → IncentiveTargetFor Amount Per Unit Incremental: the target whose above-quota result is paid on instead of the target that qualified the slab. It must be a target on the same incentive line, otherwise the slab pays 0.
ResourceRewardFieldNameResource Reward Field NameTextShown on the slab record page but not read by the incentive engine.
SchemeIdSchemeLookup → SchemeTrade scheme linked on the compensation line when a Scheme Rewards slab qualifies; that compensation type must first be added to the picklist. Only recorded on the line. Not shown in the plan builder.
SequenceNumberSequenceNumberNumberOrder in which the line's slabs are checked for each target; the first band that holds the achievement wins. The plan builder sets it from the row's position.
TargetPercentageTarget PercentageDecimalNot read by the incentive engine.
ToPercentageTo PercentagePercentUpper bound of the percentage band (inclusive). Empty or 0 means no upper limit, so the top band is From 100 with To left empty. On a saved slab, emptying the builder box does not clear the stored value; enter 0 instead.
ToValueTo ValueNumberUpper bound of an absolute band (inclusive), read only when the incentive line has Use Slab Absolute Value ticked; 0 means no upper limit. Not shown in the plan builder.
UIPropsUI PropsText
UpdatedDateTimeModified DateDateAndTimeYes

Actions

ActionLabelTypeWhat it does
BulkDeleteDeleteDeleteDelete
CloneCloneServerAction (Clone)Create a copy of this record
CreateCompensationSlabCreate Compensation SlabServerAction (CreateCompensationSlab)Seeded as a server action but no server handler implements it - executing it performs no server work; slabs are created directly through the data API.
DeleteDeleteDeleteDelete
DeleteInListDeleteDeleteDelete
EditEditEditEdit
EditInLineEditEditEdit
NewNewNewNew