LeaveSettings

Name / Description Type / Format Example
useDefaultHolidayType
If true then the value for HolidayType comes from the Employer record.
This property only appears if the LeaveSettings is a child of an Employee (not of an Employer)
boolean true
useDefaultAllowanceResetDate
If true then the value for the AllowanceResetDate comes from the Employer record.
This property only appears if the LeaveSettings is a child of an Employee (not of an Employer)
boolean true
useDefaultAllowance
If true then the value for the Allowance comes from the Employer record.
This property only appears if the LeaveSettings if a child of an Employee (not of an Employer)
boolean true
useDefaultAccruePaymentInLieu
If true then the value for AccruePaymentInLieu comes from the Employer record.
This property only appears if the LeaveSettings is a child of an Employee (not of an Employer)
boolean true
useDefaultAccruePaymentInLieuRate
If true then the value for AccruePaymentInLieuRate comes from the Employer record.
This property only appears if the LeaveSettings is a child of an Employee (not of an Employer)
boolean true
useDefaultHolidayAccrualBasis
If true then the value for HolidayAccrualBasis comes from the Employer record.
This property only appears if the LeaveSettings is a child of an Employee (not of an Employer)
boolean true
useDefaultAccruePaymentInLieuPayAutomatically
If true then the value for AccruePaymentInLieu comes from the Employer record.
This property only appears if the LeaveSettings is a child of an Employee (not of an Employer)
boolean true
useDefaultAccrueHoursPerDay
If true then the value for AccrueHoursPerDay comes from the Employer record.
This property only appears if the LeaveSettings is a child of an Employee (not of an Employer)
boolean true
useDefaultMaximumAccruePeriod
If true then the value for MaximumAccruePeriod comes from the Employer record.
This property only appears if the LeaveSettings is a child of an Employee (not of an Employer)
boolean true
allowanceResetDate
The date that the holiday allowance resets. Only the day/month part of the value is relevant.
string date "2024-12-22"
allowance
The number of days holiday an employee can take per year if HolidayType is Days.
Otherwise this is readonly and gives you the number of days accrued since the last reset
number double 0.0
adjustment
Adjustment to number of hours/days/weeks holiday this employee can take per year.
Will reset to 0 when the Allowance resets.
This property only appears if the LeaveSettings is a child of an Employee (not of an Employer)
number double 0.0
allowanceUsed
The number of days used from the allowance since last reset
number double 0.0
allowanceUsedPreviousPeriod
The number of days used in the 12 months prior to the last reset
number double 0.0
allowanceRemaining
The number of days remaining of the allowance until next reset
number double 0.0
holidayType string "Days" "Accrual_Money" "Accrual_Days" "Accrual_Hours"
accrueSetAmount
If true and HolidayType is Accrual_Days then the AccruePaymentInLieuRate will be treated as the set amount to accrue per period worked.
boolean true
accrueHoursPerDay
If HolidayType is Accrual_Days then this value is used to help convert hours worked into days accrued
number double 0.0
showAllowanceOnPayslip
If true then the remaining Allowance will be shown on the employees payslip.
boolean true
showAhpOnPayslip
If true then the AHP balance will be shown on the employees payslip.
boolean true
accruePaymentInLieuRate
The rate at which Payments in Lieu acrrue. Typically this should be 12.07%.
number double 0.0
accruePaymentInLieuAllGrossPay
Set to true if you want accrued holiday payments to be calculated on the total gross pay for the employee or just on the single regular pay element
boolean true
accruePaymentInLieuPayAutomatically
Set to true if you want employees to be automatically paid any outstanding holiday pay
boolean true
accruePayCodeSetUniqueId string uuid "string"
maximumAccruePeriod
The maximum number of hours capable of being accrued in a single period
number double 0.0
holidayAccrualBasis string "RegularPayOnly" "AllGrossPay" "PaycodeSet" "WorkingPatternHours"
holidayAccrualDefaultRateType string "HourlyRate" "AverageHolidayRate" "FixedPeriodAmount"
occupationalSicknessUniqueId string uuid "string"
accruedPaymentLiability
The total accrued payments for this employee over the lifetime of their employment so far
number double 0.0
accruedPaymentAdjustment
Any manual adjustment to the total accrued
number double 0.0
accruedPaymentPaid
The Total amount paid to this employee in lieu of holidays
number double 0.0
accruedPaymentBalance
The balance of what is owed to this employee in lieu of holidays
number double 0.0
accruedHoursAmount
The total accrued hours for this employee over the lifetime of their employment so far
number double 0.0
accruedHoursAdjustment
Any manual adjustment to the total hours accrued
number double 0.0
accruedHoursPaid
The Total amount of hours paid to this employee in lieu of holidays
number double 0.0
accruedHoursAmountLastPeriod
The total accrued hours for this employee in the last pay period
number double 0.0
paidHoursAmountLastPeriod
The number of hours paid against the pay code
number double 0.0
accruedHoursBalance
The balance of hours owed to this employee in lieu of holidays
number double 0.0
aggregatedServiceDate string date "2024-12-22"
useAggregatedServiceDate boolean true
useDefaultHolidayAccrualDefaultRateType
If true then the value for HolidayAccrualDefaultRateType comes from the Employer record.
boolean true
unauthorisedLeaveProRataRule string "WorkingPattern" "TwoSixtyDaysNotWorked" "TwoSixtyDaysWorked" "ThreeSixFiveDaysNotWorked" "ThreeSixFiveDaysWorked" "CalendarDays" "WorkingDays"
holidayLeaveProRataRule string "WorkingPattern" "TwoSixtyDaysNotWorked" "TwoSixtyDaysWorked" "ThreeSixFiveDaysNotWorked" "ThreeSixFiveDaysWorked" "CalendarDays" "WorkingDays"
sickLeaveProRataRule string "WorkingPattern" "TwoSixtyDaysNotWorked" "TwoSixtyDaysWorked" "ThreeSixFiveDaysNotWorked" "ThreeSixFiveDaysWorked" "CalendarDays" "WorkingDays"
parentalLeaveProRataRule string "WorkingPattern" "TwoSixtyDaysNotWorked" "TwoSixtyDaysWorked" "ThreeSixFiveDaysNotWorked" "ThreeSixFiveDaysWorked" "CalendarDays" "WorkingDays"
bereavementLeaveProRataRule string "WorkingPattern" "TwoSixtyDaysNotWorked" "TwoSixtyDaysWorked" "ThreeSixFiveDaysNotWorked" "ThreeSixFiveDaysWorked" "CalendarDays" "WorkingDays"
{
  "useDefaultHolidayType": true,
  "useDefaultAllowanceResetDate": true,
  "useDefaultAllowance": true,
  "useDefaultAccruePaymentInLieu": true,
  "useDefaultAccruePaymentInLieuRate": true,
  "useDefaultHolidayAccrualBasis": true,
  "useDefaultAccruePaymentInLieuPayAutomatically": true,
  "useDefaultAccrueHoursPerDay": true,
  "useDefaultMaximumAccruePeriod": true,
  "allowanceResetDate": "2024-12-22",
  "allowance": 0.0,
  "adjustment": 0.0,
  "allowanceUsed": 0.0,
  "allowanceUsedPreviousPeriod": 0.0,
  "allowanceRemaining": 0.0,
  "holidayType": "Days",
  "accrueSetAmount": true,
  "accrueHoursPerDay": 0.0,
  "showAllowanceOnPayslip": true,
  "showAhpOnPayslip": true,
  "accruePaymentInLieuRate": 0.0,
  "accruePaymentInLieuAllGrossPay": true,
  "accruePaymentInLieuPayAutomatically": true,
  "accruePayCodeSetUniqueId": "string",
  "maximumAccruePeriod": 0.0,
  "holidayAccrualBasis": "RegularPayOnly",
  "holidayAccrualDefaultRateType": "HourlyRate",
  "occupationalSicknessUniqueId": "string",
  "accruedPaymentLiability": 0.0,
  "accruedPaymentAdjustment": 0.0,
  "accruedPaymentPaid": 0.0,
  "accruedPaymentBalance": 0.0,
  "accruedHoursAmount": 0.0,
  "accruedHoursAdjustment": 0.0,
  "accruedHoursPaid": 0.0,
  "accruedHoursAmountLastPeriod": 0.0,
  "paidHoursAmountLastPeriod": 0.0,
  "accruedHoursBalance": 0.0,
  "aggregatedServiceDate": "2024-12-22",
  "useAggregatedServiceDate": true,
  "useDefaultHolidayAccrualDefaultRateType": true,
  "unauthorisedLeaveProRataRule": "WorkingPattern",
  "holidayLeaveProRataRule": "WorkingPattern",
  "sickLeaveProRataRule": "WorkingPattern",
  "parentalLeaveProRataRule": "WorkingPattern",
  "bereavementLeaveProRataRule": "WorkingPattern"
}
Contained in Models
Employee
Employer
HolidayReportLine
Consumed by Operations

- none -

Returned by Operations

- none -