xMatix
Sign in Request demo
xMatix
PRODUCTS
SalesField SalesCRMRewardsClaimsInventoryProcurementWarehouse 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
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/Incentive Plan — entity reference
REFERENCE · Last reviewed

Incentive Plan — entity reference

The header of a sales-incentive program: who participates (memberType Resource, Partner, Branch or Customer, optionally narrowed by memberResourceType or memberResourceGroupId), over which window (periodType generates child IncentivePeriod rows on insert - Yearly, Quarterly, Monthly, Weekly, Bi Weekly, Daily), and what is measured and paid (child IncentiveLine rows pairing IncentiveTarget rows with CompensationSlab payout bands). Participants are enrolled as IncentiveResource rows with per-resource targets in IncentiveResourceTarget. The incentive engine only evaluates plans with Status Approved. Scope fields (branch, member type, partner account/group, period type, member resource type) are locked once transactions exist, and a plan cannot name both a partner account and a partner account group.

Fields

FieldLabelTypeRequiredWhat it does
AccountGroupIdAccount GroupLookup → AccountGroup
AccountIdAccountLookup → Account
BranchIdBranchLookup → Branch
BusinessHoursIdBusiness HoursLookup → BusinessHours
CompensationEligibilityCompensation EligibilityPickListValues: Any One Max, Any One Min, Formulae.
CompensationEligibilityFormulaCompensation Eligibility FormulaText
CopySourceTargetsCopy Source TargetsBooleanYesWrite-and-clear trigger flag: the save handler resets it to false after an update. No first-party code performs a target copy when it is set, so setting it currently has no other effect.
CreatedByIdCreated ByLookup → UserAccountYes
CreatedDateTimeCreated DateDateAndTimeYes
ExternalIdExternalText
IdIdGuidYes
MemberResourceGroupIdResource GroupLookup → ResourceGroup
MemberResourceTypeMember Resource TypePickListOptional narrowing of participating resources; only valid when MemberType is Resource - validation rejects it otherwise. Locked once transactions exist. Values: Service Advisor.
MemberTypeMember TypePickListWho participates: Resource, Partner, Branch or Customer. Decides which id on the IncentiveResource enrollment (resourceId, partnerAccountId, branchId or contactId) is matched against PerformanceKPI dimension keys. Locked once the plan has enrolled resources or targets. Values: Partner, Dealer, Branch, Resource, Role.
ModifiedByIdModified ByLookup → UserAccountYes
NameNameTextYes
OwnerIdOwnerLookup → UserAccountYes
PartnerAccountGroupIdAccount GroupLookup → AccountGroupMutually exclusive with PartnerAccountId and with BranchId - validation rejects a plan that sets the group together with either of them.
PartnerAccountIdAccountLookup → Account
PeriodEndDatePeriod End DateDateYes
PeriodStartDatePeriod Start DateDateYes
PeriodTypePeriod TypePickListYesYearly, Quarterly, Monthly, Weekly, Bi Weekly or Daily - drives the IncentivePeriod rows generated on insert. Daily, Weekly and Bi Weekly plans may span at most one year. Locked once transactions exist. Values: Weekly, Monthly, Yearly.
RecordTypeIdRecord TypeGuid, hidden
SourceIncentivePlanIdIncentive PlanLookup → IncentivePlanSelf-reference linking a plan derived from another plan back to its source; the source lists its derived plans.
StatusStatusPickListThe incentive engine only evaluates lines of plans with Status Approved; any other status leaves compensation lines unprocessed. Values: Draft, Pending Approval, Approved.
SupplierAccountIdAccountLookup → Account
UIPropsUI PropsText
UpdatedDateTimeModified DateDateAndTimeYes

Actions

ActionLabelTypeWhat it does
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 saves the record and performs no other work (the rewards designer creates CompensationSlab rows directly through the data API instead). Only a tenant automation script bound to this action name would give it behavior.
CreateIncentiveLineCreate Incentive LineServerAction (CreateIncentiveLine)Seeded as a server action but no server handler implements it - executing it saves the record and performs no other work (the rewards designer creates IncentiveLine rows directly through the data API instead). Only a tenant automation script bound to this action name would give it behavior.
CreateIncentiveTargetCreate Incentive TargetServerAction (CreateIncentiveTarget)Seeded as a server action but no server handler implements it - executing it saves the record and performs no other work (the rewards designer creates IncentiveTarget rows directly through the data API instead). Only a tenant automation script bound to this action name would give it behavior.
NewNewNewNew