Image
abstract swish line in gradient colouring from pink to blue on a dark blue background

Event stream documentation

EmploymentPeriodStartDateChanged event

The payload for this event contains the Person id and reference number of the person whose employment start date has been changed and the revised start date.

An EmploymentPeriodStartDateChanged event will be raised when:

  • The Employment start date of an employee is modified

Field definitions for this event;

Field NameData TypeAdditional information
personIdguidn/a
personalReferenceNumberstringmax-length: 20
employmentStartDatedatethe revised start date of the person's Employment Period. The dateTime is in ISO format and should be in coordinated universal time (UTC) (e.g. 2019-05-02T15:17:00Z)
employmentPeriodIdguidthe identify of the employment period


Example of this event

{
          "personId": "",
          "personalReferenceNumber": "",
          "employmentStartDate": ""
          "employmentPeriodId": ""
          }
          

EmploymentPeriodCreated, EmploymentPeriodEnded and EmploymentPeriodReinstated event

An EmploymentPeriodCreated event will be raised when:

  • an employment period is created in hrm (currently in people first, this automatically happens when a person is created)

An EmploymentPeriodEnded event will be raised when:

  • a person is made a leaver (this effectively occurs when and end date is added to an employment period)

An EmploymentPeriodReinstated event will be raised when:

  • the action of making a person a leaver action is reverted (this effectively occurs when the end date is removed from an employment period)

Field definitions for this event;

Field NameData TypeAdditional information
personIdguidn/a
personalReferencestringmax-length: 20
startDatedateThe dateTime is in ISO format and should be in coordinated universal time (UTC) (e.g. 2019-05-02T15:17:00Z)
endDatedateThe dateTime is in ISO format and should be in coordinated universal time (UTC) (e.g. 2019-05-02T15:17:00Z)
employerNamestring80
isExitInterviewCompletedbooleann/a
lastPaymentDatedateThe dateTime is in ISO format and should be in coordinated universal time (UTC) (e.g. 2019-05-02T15:17:00Z)
lastWorkingDatedateThe dateTime is in ISO format and should be in coordinated universal time (UTC) (e.g. 2019-05-02T15:17:00Z)
reEmployablestringmax-length: 80
reEmployableCodestringmax-length: 40; reference-data
reasonForLeavingstringmax-length: 80
reasonForLeavingCodestringmax-length: 40; reference-data
forwardingAddressTypestringmax-length: 80
forwardingAddressTypeCodestringmax-length: 40; reference-data
line1stringmax-length: 80
line2stringmax-length: 80
line3stringmax-length: 80
line4stringmax-length: 80
line5stringmax-length: 80
line6stringmax-length: 80


Example of this event

{
  "personId": "",
  "personalReference": "",
  "startDate": "",
  "endDate": "",
  "employerName": "",
  "isExitInterviewCompleted": "",
  "lastPaymentDate": "",
  "lastWorkingDate": "",
  "reEmployable": "",
  "reEmployableCode": "",
  "reasonForLeaving": "",
  "reasonForLeavingCode": "",
  "forwardingAddressType": "",
  "forwardingAddressTypeCode": "",
  "forwardingAddress": ""{
    "line1": "",
    "line2": "",
    "line3": "",
    "line4": "",
    "line5": "",
    "line6": ""
  }
}
          

Looking for something specific?