As well as the basic pay amount for an employee there are often additions and deductions such as bonuses.
These additions and deductions are represented using this model.
Name / Description | Type / Format | Example | |
---|---|---|---|
value
The amount to add or deduct (whether it is a deduction or addition depends on the PayCode used).
If the PayCode has a CalculationType other than FixedAmount then this field will be a percentage. If the PayCode has a MultiplierType other than None then this field will be readonly and automatically calculated. |
number
double
|
0.0
|
|
rate
If the related PayCode has a MultiplierType other than None then this field will be used as the rate per day or hour. Otherwise it isn't used
|
number
double
|
0.0
|
|
multiplier
If the related PayCode has a MultiplierType other than None then this field will be used as number of days or hours
|
number
double
|
0.0
|
|
description
A free form description to accompany this line. It will be displayed on the payslip.
|
string
|
"string"
|
|
attachmentOrderId
The Id of the associated AttachmentOrder. Only included if the Code is AEO
|
string
uuid
|
"string"
|
|
pensionId
The Id of the associated Pension. Only included if the Code is PENSION, PENSIONSS or PENSIONRAS
|
string
uuid
|
"string"
|
|
leaveId
The Id of the associated Leave. Only included if the PayLine is a result of a Leave with Statutory pay
|
string
uuid
|
"string"
|
|
loanId
The Id of the associated Loan, if any.
|
string
uuid
|
"string"
|
|
leaveStatutoryDaysPaid
If the PayLine is a result of a Leave with Statutory Pay then this property tells you how many days they've been paid for (based on their Working Pattern).
|
number
double
|
0.0
|
|
leaveStatutoryWeeksPaid
If the PayLine is a result of a Leave with Statutory Pay then this property tells you how many weeks they've been paid for (based on their Working Pattern).
|
number
double
|
0.0
|
|
code
The Code of the PayCode this line is assigned to. The PayCode determines the treatment of this line when it comes to NI, Tax and Pensions as well as whether it's a deduction or addition.
|
string
|
"string"
|
|
tags
|
string[]
|
|
|
childId
This is nothing but the UniqueId of the model.
|
string
uuid
|
"string"
|
|
isNetToGross
If the PayLine is a fixed amount addition without multiplier then this property may be set to true so that the amount of the addition to be considered a take home pay target.
|
boolean
|
true
|
|
targetNetToGrossValue
The original net fixed addition amount that is considered to be a take home pay target.
|
number
double
|
0.0
|
|
netToGrossDiscrepancy
The discrepancy between the targeted and the calculated grossed up value during a net to gross calculation.
|
number
double
|
0.0
|
|
effectiveFrom
The date the pay line starts being calculated in payrun
|
string
date
|
"2024-12-11"
|
|
effectiveTo
The date the pay line stops being calculated in payrun
|
string
date
|
"2024-12-11"
|
|
department
|
string
|
"string"
|
|
costCentre
|
string
|
"string"
|
|
departmentId
|
string
uuid
|
"string"
|
|
costCentreId
|
string
uuid
|
"string"
|
|
isAutoGeneratedBasicPayLine
|
boolean
|
true
|
|
percentageOfEffectiveDays
The percentage of working days the effective dates span for pro-rata'ing values, calculated/set during each payrun
|
number
double
|
0.0
|
|
totalWorkingDays
|
number
double
|
0.0
|
|
isAutomaticBackPay
Automatically calculate back pay and add or modify the necessary pay lines for this addition/deduction when a pay run is created.
Applicable only to employee level addition/deduction pay lines. If set to false then you must manually handle the calculation and adding of back pay lines. |
boolean
|
true
|
|
ignoreInitialBackPay
Skip the automatic backpay calculation on the first pay run, if the addition/deduction had been paid outside or Staffology.
If set to false, the automatic backpay calculation will be performed on the first pay run. |
boolean
|
true
|
|
initialBackPayPublicPayRunId
Used to mark the first payrun where this payline has been payrolled for backpay
|
string
uuid
|
"string"
|
|
autoAdjustForLeave
This sets whether the PayLine should be automatically adjusted or not for:
Leave Entries; Starters/Leavers; PayLine effectiveFrom and effectiveTo values falling mid-way through a PayRun |
boolean
|
true
|
|
contributesToBasicPay
Indicates whether this pay line contributes to the basic pay of the employee.
Will be set to true by default when IsAutoGeneratedBasicPayLine is true. |
boolean
|
true
|
|
calculateAsWhenPaid
Indicates whether this pay line should be treated as When Paid rather than When Earned
|
boolean
|
true
|
|
totalPaidDays
|
number
double
|
0.0
|
|
roleId
The employee role which is associated with this pay line.
If set to null, the pay line is not related with a role. |
string
uuid
|
"string"
|
|
employeeRoleReference
|
string
|
"string"
|
|
earnedFrom
Nullable DateTime property "EarnedFrom" in the PayLine model to store the start date of the PayLine's 'earned' period in a PayRun.
|
string
date
|
"2024-12-11"
|
|
earnedTo
Nullable DateTime property "EarnedTo" in the PayLine model to store the end date of the PayLine's 'earned' period in a PayRun.
|
string
date
|
"2024-12-11"
|
|
periodFrom
Nullable DateTime property "PeriodFrom" in the PayLine model to store the start date of the PayRun period the current PayLine is part of.
|
string
date
|
"2024-12-11"
|
|
periodTo
Nullable DateTime property "PeriodTo" in the PayLine model to store the end date of the PayRun period the current PayLine is part of.
|
string
date
|
"2024-12-11"
|
|
annualValue
The original value from the PayLine before we modify it
Currently only used when CalculationType is set to FixedAnnualAmount so we can determine whether the pay line value needs calculating or not To recalculate set to null with annual amount recorded in Value |
number
double
|
0.0
|
|
parentId
The Id of the associated employee level pay line, if the current line is a back pay line.
|
string
uuid
|
"string"
|
|
isAutoCalculatedBackPayLine
|
boolean
|
true
|
|
isZeroHoursTeachersBackPayLine
Indicates whether this pay line is a backdated pay claim line
belonging to a zero hours contract teacher. |
boolean
|
true
|
|
analysisCategoriesCodes
List of analysis Category Codes
|
AnalysisCategoryCodes[]
|
{AnalysisCategoryCodes}
|
|
analysisCategoryCodeIds
List of analysis Category Codes uniqueId
|
string[]
|
|
|
paySpineId
The Id of the associated pay spine.
|
string
uuid
|
"string"
|
|
paySpineGradeId
The Id of the associated pay spine grade.
|
string
uuid
|
"string"
|
|
spinalPointId
The Id of the associated spinal point.
|
string
uuid
|
"string"
|
|
londonAllowanceId
Used to set London allowance id for payline
|
integer
int32
|
0
|
|
fullTimeAnnualValue
Used to set Full Time Annual Value for payline
|
number
double
|
0.0
|
|
paySpine
PaySpine name based on PaySpineId
|
string
|
"string"
|
|
payGrade
PayGrade name based on PayGradeId
|
string
|
"string"
|
|
spinePoint
SpinePoint name based on SpinePointId
|
string
|
"string"
|
{
"value": 0.0,
"rate": 0.0,
"multiplier": 0.0,
"description": "string",
"attachmentOrderId": "string",
"pensionId": "string",
"leaveId": "string",
"loanId": "string",
"leaveStatutoryDaysPaid": 0.0,
"leaveStatutoryWeeksPaid": 0.0,
"code": "string",
"tags": [
"string"
],
"childId": "string",
"isNetToGross": true,
"targetNetToGrossValue": 0.0,
"netToGrossDiscrepancy": 0.0,
"effectiveFrom": "2024-12-11",
"effectiveTo": "2024-12-11",
"department": "string",
"costCentre": "string",
"departmentId": "string",
"costCentreId": "string",
"isAutoGeneratedBasicPayLine": true,
"percentageOfEffectiveDays": 0.0,
"totalWorkingDays": 0.0,
"isAutomaticBackPay": true,
"ignoreInitialBackPay": true,
"initialBackPayPublicPayRunId": "string",
"autoAdjustForLeave": true,
"contributesToBasicPay": true,
"calculateAsWhenPaid": true,
"totalPaidDays": 0.0,
"roleId": "string",
"employeeRoleReference": "string",
"earnedFrom": "2024-12-11",
"earnedTo": "2024-12-11",
"periodFrom": "2024-12-11",
"periodTo": "2024-12-11",
"annualValue": 0.0,
"parentId": "string",
"isAutoCalculatedBackPayLine": true,
"isZeroHoursTeachersBackPayLine": true,
"analysisCategoriesCodes": [
{
"analysisCategory": "string",
"analysisCategoryCode": "string",
"analysisCategoryId": "string",
"analysisCategoryCodeId": "string"
}
],
"analysisCategoryCodeIds": [
"string"
],
"paySpineId": "string",
"paySpineGradeId": "string",
"spinalPointId": "string",
"londonAllowanceId": 0,
"fullTimeAnnualValue": 0.0,
"paySpine": "string",
"payGrade": "string",
"spinePoint": "string"
}
- none -
- none -
Getting Started | Using Tags |