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

Payslip — entity reference

One employee's payslip for one payroll run: the month's totals, days paid, year-to-date figures and a masked bank account, copied from the run's employee row when Generate Payslips is run on a calculated payroll run. It holds totals only; the component breakdown stays on the run's component lines, reached through the Payroll Run Detail. Generation creates one Draft slip per employee row and skips rows that already have one. Recalculating the run deletes its slips, and is refused while any of them has Publish Status Published. Publish Payslips on the posted run renders each slip from the Payslip print template, stores the PDF on the slip (File Asset), sets it Published and notifies the employee by push and email; publishing again skips slips that already have their PDF. Print Payslip prints the same Payslip template, and Tax Declaration prints the Form 12BB template filled from the employee.

Fields

FieldLabelTypeRequiredWhat it does
BranchIdBranchLookup → BranchNot stored. Values entered here are not saved.
CreatedByIdCreated ByLookup → UserAccountYes
CreatedDateTimeCreated DateDateAndTimeYes
EmployeeIdEmployeeLookup → EmployeeNot stored. Values entered here are not saved; the employee is identified by Resource.
FileAssetIdFile AssetGuidThe payslip's PDF, rendered from the Payslip print template and stored by Publish Payslips. Publishing again after a correction stores a new version of the same file.
GeneratedUtcGenerated UtcDateWhen the slip was generated, in UTC. Not the pay date and not the date it was published.
GrossEarningsGross EarningsCurrencyTotal earnings for the month, copied from the run's employee row at generation. Not refreshed if the run changes; recalculate and generate again.
IdIdGuidYes
LabelLabelText
LopDaysLop DaysDecimalLoss-of-pay days in the period, copied from the run's employee row.
MaskedBankAccountMasked Bank AccountTextXXXX followed by the last four digits of the employee's bank account on the Resource when the slip was generated. Empty when the Resource has no account; not updated if the account changes later, and never used for payment.
ModifiedByIdModified ByLookup → UserAccountYes
NameDocument NumberText, uniqueYesThe payslip number. Set at generation from the tenant's active Payslip document numbering setting, or, when there is none, PS- followed by the generation date (DDMMYYYY) and a six-digit running number.
NetPayNet PayCurrencyGross earnings minus total deductions, copied from the run's employee row at generation.
OwnerIdOwnerLookup → UserAccountYes
PartnerAccountIdPartner AccountLookup → AccountThe company that pays the employee, copied from the payroll run. Year-to-date figures only count run rows of this company.
PayableDaysPayable DaysDecimalDays paid in the period, copied from the run's employee row: the calendar days of the period minus unpaid leave.
PayrollPeriodIdPayroll PeriodLookup → PayrollPeriodThe pay period the slip covers, taken from the run's employee row or, if that has none, from the run. Use it rather than Generated Utc to group slips by month.
PayrollRunDetailIdPayroll Run DetailLookup → PayrollRunDetailThe employee row of the run this slip was generated from, and the key that stops a second slip being generated for the same row. Open it to see the component lines behind the slip's totals.
PayrollRunIdPayroll RunLookup → PayrollRunThe payroll run the slip was generated from. Recalculating this run deletes the slip unless it is Published, in which case the recalculation is refused.
PublishStatusPublish StatusPickListDraft or Published. Generation writes Draft; Publish Payslips on the posted run writes Published once the slip's PDF is stored, and notifies the employee. It can also be typed in place on the payslip page. Exactly Published stops the payroll run from being recalculated. It does not lock the slip against editing. Values: Draft, Published.
RecordTypeIdRecord TypeGuid, hidden
ResourceIdResourceLookup → ResourceThe employee's person record, copied from the run's employee row. The masked bank account is taken from this record.
TotalDeductionsTotal DeductionsCurrencyTotal deductions for the month, copied from the run's employee row at generation.
UIPropsUI PropsText
UpdatedDateTimeModified DateDateAndTimeYes
YtdGrossYtd GrossCurrencyGross earnings so far in the fiscal year: the sum over every run row of the same employee and company whose payroll period falls in the fiscal year containing this run's period (the company's fiscal year, or April to March when none is defined). Includes this run and unposted runs, and is fixed when the slip is generated.
YtdTaxYtd TaxCurrencySalary TDS so far in the fiscal year, summed over the same run rows as Ytd Gross. Fixed when the slip is generated.

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 from the Payslip document template.
TaxDeclarationTax DeclarationPrintTax Declaration
ViewViewViewView this Payslip.

Lookup filters

FilterLookup fieldNotes
BranchFilterBranchIdBranchFilter
PartnerAccountFilterPartnerAccountIdPartnerAccountFilter