Understanding People & Jobs on our Public API

---

This deployment guide simply serves to helping bring to light the definitions and uses of people and job records within the intelliHR platform. The below will outline what each is and how each can be used and manipulated through intelliHR's API. 

---

This article covers:

• People
• Jobs & Effective Dates
• Concurrent Jobs, Terminations & Rehires

---

People

In intelliHR, every employee starts in our system as a person. The person model contains all the information about an employee, including:

• First, Last & Preferred Name 
• Title (e.g. "Mr") 
• Identification numbers 
• Date of birth 
• Email addresses 
• Phone numbers 
• Work rights information 
• Emergency contact information 
• Custom fields data

Think of people as an old school HR folder 📁 - when someone is about to join your business, you add all their information to the folder: contact information, any contracts they’ve signed, maybe even their resume. In intelliHR you can add training records, qualifications, performance information, diary notes and jobs to a person.

People can exist in our system and be provisioned a user account that allows them to log in to intelliHR. However, until an employee has a current job, they are not considered an ‘active’ employee. People can be managed and maintained via the people API.

---

Jobs & Effective Dates

Jobs are created on a person in intelliHR. intelliHR is a date effective system, meaning you can schedule jobs to commence in the future, or schedule a change to a job a few months before it occurs. Jobs can be managed and maintained via the jobs API.

Jobs are comprised of attributes that describe an employee’s place in the business such as their:

• Location 
• Position Title 
• Business Unit (Department) 
• Business Entity 
• Company/Job Start Date 
• Work Class & Work Type 
• Pay Grade 
• Remuneration Information 
• Recruitment Information 

---

Concurrent Jobs 👥

A person can hold multiple jobs at once in intelliHR. We refer to these additional jobs as concurrent jobs. When an employee has concurrent jobs, one job will always be the primary job - this is usually the employee’s substantive job. 

---

Terminations 🚷

Jobs in intelliHR can be created with an end date (think of fixed-term roles or casual staff), but in order for a job to be terminated, a company end date must be finalised. Jobs can be finalised via the end job API.

---

Rehires ⏎

When an employee leaves the business, their job and people records become inactive in intelliHR. However, if they return to the business, they can be reactivated by creating a new job against their person record.

Tip: For information on how to make use of the person and job API endpoints, contact your friendly intelliHR Integration Team! You can reach them at [e-mail]