schemeJoinDate

Synopsis The date the entitled employee joins the scheme.
Where used

/contributions request

This field must only be provided if the autoEnrolmentStatus is Entitled. The field’s value must remain the same for all future contributions once the employee is enrolled. The value must be on or after the date the employer’s auto-enrolment duties begin.

Where a schemeJoinDate is provided and we hold an opt out date on the system, the latter of these dates will be used and the relevant rules will be applied.

Data type

String

Constraints/format

ISO8601-formatted date string

Example

...
"schemeJoinDate": "2017-01-26",
...

Related errors

D/X01 – not in the correct format

D/X02 – must be blank if auto-enrolment status is "Eligible"

D/X03 – must be blank if auto-enrolment status is "Non Eligible"

D/X04 – must be blank if auto-enrolment status is "Not Known"

D/X05 – must be blank if auto-enrolment status is "Not Applicable"

D/X08 – cannot be before employer staging date

D/X11 – cannot be before employee's date of birth

D/X12 – cannot be before employment start date

D/X13 – must be completed if auto-enrolment status is "Entitled"

See also

autoEnrolmentStatus

autoEnrolmentDate

employmentPeriod

optInDate