Pension



The pension entity represents the default configuration of an employer's pension scheme; it is a revisible object so that changes to the scheme over time are correctly represented in the payroll history. See revisible objects for more information on revisions and how they work.

Pension [Schema]

Name Type Required Description
EffectiveDate xsd:date yes The date the revision will come into effect.
Revision Revision yes The revision number of the pension scheme.
Code SystemCode no Allows an override of the default pay code used by the pension scheme.
SchemeName xsd:string ( max: 250) yes The name of the pension scheme.
ProviderName xsd:string ( max: 250) yes The name of the pension provider.
ProviderEmployerRef xsd:string ( max: 100) yes The reference issued by the pension provider.
Group xsd:string ( max: 100) no The group name within the pension scheme.
SubGroup xsd:string ( max: 100) no The sub-group name within the pension scheme.
EmployeeContributionCash Money no The employee's gross cash contribution.
EmployerContributionCash Money no The employer's gross cash contribution.
EmployeeContributionPercent Percentage no The employee's percentage contribution from their pensionable pay.
EmployerContributionPercent Percentage no The employer's percentage contribution from the employee's pensionable pay.
LowerThreshold Money no The lower earning threshold; only pensionable pay above this value will be included for calculating contributions. Threshholds are predominantly used for triggering Auto Enrolment contributions; see Auto Enrolment for more information..
UpperThreshold Money no The upper earning threshold; only pensionable pay beow this value will be included for calculating contributions. Threshholds are predominantly used for triggering Auto Enrolment contributions; see Auto Enrolment for more information..
TaxationMethod PensionTaxationMethod yes The taxation method to use when calculating pension contributions; this should be mandated by your pension provider.
ContributionDeductionDay DayOfMonth no The normal day of the month when contributions will be deducted.
PensionablePayCodes SystemCode
(list of)
yes The list of pay codes that contribute to the pensionable pay amount.
QualifyingPayCodes SystemCode
(list of)
yes The list of pay codes that contribute to the qualifying earnings pay amount.