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

Payslip — entity reference

The employee-facing pay document generated from a PayrollRunDetail, carrying header totals plus year-to-date rollups and a masked bank account. The earning and deduction lines are NOT stored here — they are projected from PayrollRunComponentLine, so a payslip alone cannot answer component-level questions. PublishStatus gates visibility (employees are meant to see only Published slips), and a run whose slips are Published can no longer be recalculated; generation is idempotent, skipping any detail that already has a slip. YtdGross and YtdTax are summed only over the PayrollPeriods inside the fiscal year containing the run's period, falling back to an April–March year, so they are year-to-date and not lifetime-to-date. Keyed on ResourceId; the rendered PDF would be referenced by FileAssetId, but no first-party code renders or attaches one.

Fields

FieldLabelTypeRequiredWhat it does
BranchIdBranchLookup → Branch
CreatedByIdCreated ByLookup → UserAccountYes
CreatedDateTimeCreated DateDateAndTimeYes
EmployeeIdEmployeeLookup → Employee
FileAssetIdFile AssetGuidReserved for the rendered payslip PDF stored as a file asset.
GeneratedUtcGenerated UtcDateWhen the slip was created by the generation step, in UTC. It is not the pay date and not a publication timestamp — publication is tracked only by PublishStatus, which carries no date of its own.
GrossEarningsGross EarningsCurrency
IdIdGuidYes
LabelLabelText
LopDaysLop DaysDecimal
MaskedBankAccountMasked Bank AccountTextThe employee's bank account reduced to the literal prefix XXXX plus its last four digits, snapshotted from the Resource when the slip was generated. It is a display artefact only — it is never used to pay anyone, and it does not follow later changes to the employee's bank details.
ModifiedByIdModified ByLookup → UserAccountYes
NameDocument NumberText, uniqueYes
NetPayNet PayCurrency
OwnerIdOwnerLookup → UserAccountYes
PartnerAccountIdPartner AccountLookup → Account
PayableDaysPayable DaysDecimalThe days the employee was actually paid for in the period, copied from the run detail. It is calendar days in the period minus approved unpaid leave, not attended days — weekly offs and holidays are not deducted.
PayrollPeriodIdPayroll PeriodLookup → PayrollPeriodThe pay cycle the slip covers, taken from the source detail and falling back to the run's period. Use it rather than the generation timestamp when grouping slips by month.
PayrollRunDetailIdPayroll Run DetailLookup → PayrollRunDetailThe per-employee run summary this slip was generated from, and the idempotency key for generation: a detail that already has a slip is skipped when payslips are generated again. It is also the route to the component lines the printed breakdown is projected from.
PayrollRunIdPayroll RunLookup → PayrollRun
PublishStatusPublish StatusPickListValues: Draft, Published.
RecordTypeIdRecord TypeGuid, hidden
ResourceIdResourceLookup → Resource
TotalDeductionsTotal DeductionsCurrency
UIPropsUI PropsText
UpdatedDateTimeModified DateDateAndTimeYes
YtdGrossYtd GrossCurrency
YtdTaxYtd TaxCurrencySalary tax withheld so far in the fiscal year containing this run's period, summed across that year's payroll details for the same employee and company. It is bounded to the fiscal year (falling back to an April–March year when the company has no fiscal calendar), so it resets each year and is not a lifetime figure.

Actions

ActionLabelTypeWhat it does
BulkDeleteDeleteDeleteDelete the selected records.
CloneCloneServerAction (Clone)Create a copy of this record
DeleteDeleteDeleteDelete this Payslip.
DeleteRecordDeleteDeleteDelete
EditEditEditEdit this Payslip.
EditInLineEditEditInlineEdit
EditRecordEditEditEdit
Form16Form 16UIActionForm 16
NewNewNewCreate a Payslip.
PrintPayslipPrint PayslipPrintPrint the payslip as a PDF document.
TaxDeclarationTax DeclarationPrintTax Declaration
ViewViewViewView this Payslip.

Lookup filters

FilterLookup fieldNotes
BranchFilterBranchIdBranchFilter
PartnerAccountFilterPartnerAccountIdPartnerAccountFilter