---
title: Job matching for payroll syncs
slug: job-matching-for-payroll-syncs
docTags: 
createdAt: 2022-12-01T14:56:37.000Z
---

ChartHop provides *Job code matching* which allows you to connect your open jobs and new hires between ChartHop and your payroll systems.

With job code matching you can create custom fields that map data between ChartHop and your preferred payroll system allowing you to:

- Match jobs between ChartHop and your payroll system without needing to rely on an ATS.
- Prevent the creation of duplicate jobs.

To use requisition code matching, your setup must do the following:

1. Your new roles must be opened directly in ChartHop.
2. New hire information must only come in from payroll syncs and **not** from an ATS.
3. Your payroll system must have some type of system where unique codes are assigned to jobs such as a job, requisition, or budget code, and those codes must be API accessible.

:::hint{type="success"}
### Use case: Syncing new hire information automatically into open ChartHop jobs

Anya's organization hires several new software engineers and captures the information in their payroll system, including a req code for each job. Anya wishes to sync the new hire data like salaries, addresses, phone numbers, emails, and other information from her payroll system into ChartHop. Anya's company does not integrate ChartHop with an ATS system.

- Within her payroll system, Anya uses a field called "**Req code**" to associate an alphanumeric code with new jobs.
- Anya creates a custom field in ChartHop called "**Req code**".
- Within ChartHop, Anya creates a new job of a **Software Engineer** and assigns the same req code as is associated with the open job in her payroll system such as **ENG-110.**

When Anya runs a new payroll sync, the jobs created in ChartHop with the matching **ENG-110** are updated with all the mapped information from the payroll system.
:::

## Set up job code matching

:::hint{type="warning"}
**Each job code value must be unique across your open jobs.**

If more than one open job in ChartHop has the same job matching code value, ChartHop will match the payroll record to whichever job had that code value set first. The other jobs with the same code will not receive the new hire data. To avoid missed syncs, make sure each open job has a distinct code value that corresponds to a single record in your payroll system.
:::

To configure your ChartHop organization for job code matching, you must:

1. Decide whether to use an existing ChartHop field or create a new field to be used for the matching job code.
2. Work with ChartHop implementation to have the new field mapped and the option turned on for your org.
3. After implementation, ensure that each time you open a job, you complete the ChartHop field. The value for the ChartHop field must match the expected value from your payroll system in order for new jobs to be synced.

:::hint{type="info"}
Configuring job code matching in your ChartHop organization requires the help of a ChartHop implementation specialist.
:::

## Related articles

- [Using a job matching field](https://docs.charthop.com/using-a-job-matching-field) - Step-by-step instructions for assigning a job matching code to an open job.
- [Creating job codes](https://docs.charthop.com/creating-job-codes) - Set up the job code catalog in Settings.