This object forms the basis of the Employees payment.
Name / Description | Type / Format | Example | |
---|---|---|---|
period
|
string
|
"Custom"
"Monthly"
"FourWeekly"
"Fortnightly"
"Weekly"
"Daily"
|
|
ordinal
Indicates whether to use first, second, third (etc) PaySchedule for this PayPeriod.
|
integer
int32
|
0
|
|
method
|
string
|
"Cash"
"Cheque"
"Credit"
"DirectDebit"
|
|
withholdTaxRefundIfPayIsZero
If you don't want negative PAYE values when the Gross pay is zero, set this to true
|
boolean
|
true
|
|
taxAndNi
|
TaxAndNi
|
{TaxAndNi}
|
|
fpsFields
|
FpsFields
|
{FpsFields}
|
|
tags
|
string[]
|
|
|
basis
|
string
|
"Hourly"
"Daily"
"Monthly"
|
|
nationalMinimumWage
|
boolean
|
true
|
|
payCode
If you want the Employees pay to be allocated to a code other than BASIC, specify it here
|
string
|
"string"
|
|
mileageVehicleType
|
string
|
"Car"
"Motorcycle"
"Cycle"
|
|
mapsMiles
The number of miles to pay for as Mileage Allowance Payments
|
integer
int32
|
0
|
|
payAmount
The amount the Employee is regularly paid each period
|
number
double
|
0.0
|
|
payAmountMultiplier
This property is irrelevant if the basis is Monthly.
But if the basis is Daily or Hourly then this property sets how many days/hours the employee should be paid for in the period. |
number
double
|
0.0
|
|
baseHourlyRate
This property is used to calculate values for PayCodes that are set as multiples of
the employees base hourly rate. Eg Overtime. If this is set as zero then we'll attempt to calculate a value based on the other fields |
number
double
|
0.0
|
|
baseDailyRate
This property is used to calculate values for PayCodes that are set as multiples of
the employees base daily rate. Eg sick. If this is set as zero then we'll attempt to calculate a value based on the other fields |
number
double
|
0.0
|
|
basicPay
The amount of basic pay the Employee is regularly paid each period
This amount is the combined total of all pay elements that contribute to basic pay |
number
double
|
0.0
|
|
autoAdjustForLeave
Automatically reduce the PayAmount when the Employee has Leave that is either Not Paid or has Statutory Pay.
Can only be set to True if the Basis is Monthly (ie, employee is not paid an hourly or daily rate). If set to false then you must manually reduce their payment to reflect any Leave |
boolean
|
true
|
|
niTable
|
string
|
"string"
|
|
regularPayLines
These are used to make additions/deductions to the pay for this Employee.
You do not need to include Pension, Tax, NI, Loan Repayments, etc as these will all be automatically created. |
PayLine[]
|
{PayLine}
|
{
"period": "Custom",
"ordinal": 0,
"method": "Cash",
"withholdTaxRefundIfPayIsZero": true,
"taxAndNi": {
"niTable": "string",
"secondaryClass1NotPayable": true,
"postgradLoan": true,
"postgraduateLoanStartDate": "2024-03-19",
"postgraduateLoanEndDate": "2024-03-19",
"studentLoan": "None",
"studentLoanStartDate": "2024-03-19",
"studentLoanEndDate": "2024-03-19",
"taxCode": "string",
"week1Month1": true,
"foreignTaxCredit": true
},
"fpsFields": {
"offPayrollWorker": true,
"irregularPaymentPattern": true,
"nonIndividual": true,
"hoursNormallyWorked": "LessThan16"
},
"tags": [
"string"
],
"basis": "Hourly",
"nationalMinimumWage": true,
"payCode": "string",
"mileageVehicleType": "Car",
"mapsMiles": 0,
"payAmount": 0.0,
"payAmountMultiplier": 0.0,
"baseHourlyRate": 0.0,
"baseDailyRate": 0.0,
"basicPay": 0.0,
"autoAdjustForLeave": true,
"niTable": "string",
"regularPayLines": [
{
"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-03-19",
"effectiveTo": "2024-03-19",
"department": "string",
"costCentre": "string",
"departmentId": "string",
"costCentreId": "string",
"isAutoGeneratedBasicPayLine": true,
"percentageOfEffectiveDays": 0.0,
"totalWorkingDays": 0.0,
"isAutomaticBackPay": true,
"ignoreInitialBackPay": true,
"initialBackPayPayRunId": 0,
"autoAdjustForLeave": true,
"contributesToBasicPay": true,
"calculateAsWhenPaid": true,
"totalPaidDays": 0.0,
"roleId": "string",
"employeeRoleReference": "string",
"earnedFrom": "2024-03-19",
"earnedTo": "2024-03-19",
"periodFrom": "2024-03-19",
"periodTo": "2024-03-19",
"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
}
]
}
- none -
Getting Started | Understanding PayOptions |
Getting Started | The Ordinal property |
Getting Started | Using Tags |