# HR

HR integrations bring your people data into Peaky — employees, departments, contracts and wages — as headcount metrics for workforce and payroll planning. You find them under the **HR** tab on the **Integrations** page; their metrics get their own tab on **Metrics**.

The general flow is on [Connecting an Integration](/doc/connecting-integrations-XTfOCgvGYz). When your company has more than one legal entity, connect from the **Integrations** page of the entity whose people these are.

| Integration | How you connect | What Peaky syncs |
|-------------|-----------------|------------------|
| [Officient](#officient) | Sign in to Officient | Employees, with department, status, start and end date, and monthly wage |
| [SD Worx](#sd-worx) | Employer file number | Employees, with department, role, country, status, start and end date, FTE and wage history |

Odoo, connected under **Accounting & ERP**, brings in your people the same way when you sync its **HR** module — see [Odoo employees in Headcount](/doc/accounting-fSYP3czo81#odoo-employees-in-headcount).


---

## Officient


1. Find **Officient** under the **HR** tab and click **Connect**.
2. Sign in to Officient and approve access.
3. You return to Peaky; the card is marked **Connected** and the first sync starts.

**What syncs:** every **employee** — name, department (their team), status, start date, end date and monthly wage.

**Metrics:** each sync fills Peaky's people records, and the metrics are computed from them under **Headcount** on **Metrics**: **Employees** and **Contractors** (in FTE), **People**, **Hires**, **Leavers**, and **Wages** and **Average wage** for people allowed to see wages — by department. See [Metric Reference](/doc/metric-reference-mIcXe6HnqH#headcount). They replace the earlier **Active Employees**, **New Hires**, **Terminations** and **Average Wage**: formulas and views that used those were moved to their Headcount counterparts. Where a formula read one department of them, the earlier metrics stay until you change it, since the Headcount ones break down by department, role and country together.

When custom metrics are enabled for your company, the employees are also a table on the **Data** page, so you can build headcount metrics of your own.

When the **Headcount** page is enabled for your company, you see and edit those people on [Headcount](/doc/headcount-q5b7gWMPPG): their departments, dates and status, and a new wage whenever their monthly wage changes. People you edit there keep your edits through later syncs.


---

## SD Worx

SD Worx does not ask you to sign in. Peaky is registered with SD Worx as an integration partner, and SD Worx gives that registration access to the payroll files it is asked to. So connecting takes a single field: which payroll file Peaky should read.

**Before you connect**, ask SD Worx to give Peaky access to your employer file, and let Peaky support know which file it is. Once SD Worx has confirmed the access, we set the file up for your company — only your company can then connect it.


1. Find **SD Worx** under the **HR** tab and click **Connect**.
2. Open your SD Worx payroll environment, or any payslip, and copy the **employer file number** shown there — for example `1AB1234`. It is also called your dossier number, and is letters and digits only.
3. Paste it into **Employer file number** and click **Connect**.

Peaky checks the number against the payroll files SD Worx has given it access to, records which employer the connection reads, and marks SD Worx **Connected**.

**If the number is refused** with *This employer file number has not been set up for your company yet*, contact Peaky support: the file still has to be confirmed with SD Worx and set up for you. With *SD Worx has not granted Peaky access to this employer file number*, check the number first — a typo looks the same from Peaky's side — and then ask SD Worx to give Peaky access to that employer file. A message that *The SD Worx connection is not available yet* means the connection cannot be made at the moment; try again later.

**Connection links** do not apply: there is no sign-in for someone else to complete on your behalf.

**What syncs:** once a day, every **employee** with a contract in that payroll file — name, department (the cost centre their work schedule books to), role (the job description), country, status (**On leave** during a full-time leave such as parental leave or a career break), start date, end date, FTE (from their work regime) and their **wage history**: each monthly gross wage from the date it took effect, back to their hire date. An hourly wage is converted to a monthly one over a full-time week. Nothing else about the person is brought in — no national number, address, bank account or family details.

**Leavers:** someone whose contract ends keeps their place in Headcount, with their end date, so past months still count them. People who left before you connected SD Worx are not brought in.

**Metrics:** the same as for Officient above — each sync fills Peaky's people records and the **Headcount** metrics are computed from them. Wage changes are dated as SD Worx dated them, not on the day of the sync.

When custom metrics are enabled for your company, the employees and their wages are also tables on the **Data** page. Wage columns there are visible only to people with **Wages** → **View**, and no custom metric can be built on them — the wage metrics come from Headcount.

When the **Headcount** page is enabled for your company, you see and edit those people on [Headcount](/doc/headcount-q5b7gWMPPG). People you edit there keep your edits through later syncs.

**If SD Worx stops giving Peaky access** to the payroll file, the sync stops and the card asks you to **Update credentials**: check the employer file number, or ask SD Worx to give Peaky access to it again.