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

Compensation — entity reference

The payout header for one incentive period of an incentive plan in the Rewards app. Process Compensation on the incentive period creates it once per period with Status Draft, copies the plan's account, branch and currency, adds one Compensation Line per plan member and sets Total Incentive Amount to the sum of the current members' lines (Override Incentive Amount first, then Incentive Amount). Later runs reuse the period's oldest record. New records are numbered from the COMP series. The header creates no journal, payment, payroll adjustment or claim, and no claim process marks it; payout is recorded on each line with Is Compensation Received. Deleting a header does not delete its lines.

Fields

FieldLabelTypeRequiredWhat it does
BranchIdBranchLookup → BranchThe branch the plan is scoped to. Copied from the plan when Process Compensation creates the record and never refreshed. Informational; nothing reads it.
CreatedByIdCreated ByLookup → UserAccountYes
CreatedDateTimeCreated DateDateAndTimeYes
CurrencyIsoCodeCurrency ISO CodeTextThe plan's currency code, copied when Process Compensation creates the record. Not on the seeded forms.
IdIdGuidYes
IncentivePeriodIdIncentive PeriodLookup → IncentivePeriodThe period this record covers. Process Compensation finds a period's record by this field alone and uses the oldest one. The picker is not filtered by plan.
IncentivePlanIdIncentive PlanLookup → IncentivePlanThe plan this record pays out. Set by Process Compensation from the period's plan. Informational: the incentive engine scores each line against the plan stored on the line.
ModifiedByIdModified ByLookup → UserAccountYes
NameNameTextYesThe record number, set automatically from the COMP numbering series on create, including for records Process Compensation creates, so it never carries the period's name.
OwnerIdOwnerLookup → UserAccountYes
PartnerAccountIdAccountLookup → AccountThe partner account the plan is scoped to. Copied from the plan when Process Compensation creates the record and never refreshed. Informational; nothing reads it.
RecordTypeIdRecord TypeGuid, hidden
StatusStatusPickListThe review state of the record. Process Compensation writes Draft when it creates the record; nothing else reads or changes it. The picklist ships with no values, so an administrator adds the review states (and Draft). The Incentives & Targets dashboard groups totals by it.
TotalIncentiveAmountTotal Incentive AmountCalculatedWhat the period pays in total. Written by every Process Compensation run as the sum of the current members' lines, using Override Incentive Amount where set and Incentive Amount otherwise; paid lines are included and lines of former members are left out. Saving a line does not update it. Editable through Edit, but the next run replaces it.
UIPropsUI PropsText
UpdatedDateTimeModified DateDateAndTimeYes

Actions

ActionLabelTypeWhat it does
CloneCloneServerAction (Clone)Create a copy of this record
DeleteDeleteDeleteDelete
EditEditEditEdit
NewNewNewNew