An object representing an employment period for a particular employee.
In WorkBright, an employee may have multiple Employments – one for each season they are hired to work. Even if your business does not operate seasonally, each employee will have at least one Employment object created when they are first added to the system.
At any given time, a WorkBright accounts operates under a single, active season (also referred to as the "current" season). If an employee has an Employment record for the active season, then they are said to be "employed." When an employee is employed for the active season, they can also be deactivated, e.g. if they resigned or were terminated. Deactivated employees, as well as employees who were not hired for the active season ("unemployed"), do not have access to WorkBright.
| Attributes | Type | Description |
|---|---|---|
id | Integer | Identifier for this employment. |
employee_id | Integer | Identifier of the employee. |
hire_date | String (format: YYYY-MM-DD) | The employee's hire date. |
start_date | String (format: YYYY-MM-DD) | The employee's start date. |
end_date | String (format: YYYY-MM-DD) | The employee's end date, if applicable. |
onboarding_start_date | String (format: YYYY-MM-DD) | The date an employee should begin onboarding. |
employee_document_options | Object | If Remote I-9 is enabled on the account, will return the Boolean values for the staff member i9_remote_countersign_authorized and i9_remote_reverification_authorized, otherwise will return {}. |
status | String | The employment status of the employee. One of: active, inactive or unemployed. |
status_note | String | If deactivated, the accompanying note or reason. |
status_changed_by | String | Name of individual who last changed employee's status. |
status_changed_at | String (format: ISO 8601) | Timestamp of when employee's employment status was last changed. |
season_id | Integer | The ID of the Season this employment is for. |
active_season | Boolean | Whether or not the season_id represents the current, active season in the system. |
onboarding_email_sent_at | String (format: ISO 8601 ) | Timestamp of when employee's onboarding email was sent. |
onboarding_started | Boolean | Whether or not the employee has started the onboarding process. |