> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qobra.co/llms.txt
> Use this file to discover all available pages before exploring further.

# HRIS Connector

## Introduction

Qobra connects seamlessly to 60+ HRIS, including `Workday`, `Lucca`,
`Factorial`, `ADP`, `Sage` and many more. You can access the whole
list [here](https://www.kombo.dev/integrations).

The integration is used to:

* synchronize users, management hierarchy, user groups, user attributes

* auto-provision users

## Sub-processing and security

To connect to all these HRIS systems, we rely on Kombo, a german subprocessor.
Kombo has been carefully audited on feature and security standards. They
follow the best security standards, and are `ISO27001`, `SOC 2 type 2`, and
`GDPR` compliant. You’ll find more information [here](https://security.kombo.dev/).

## Access

For each HRIS, you will be able to:

* choose the information scopes you give Qobra access to.

* connect your HRIS to Qobra via the most secured way available. For most
  systems, this will be Oauth 2.0, but it can sometimes be via an api key or
  a service user as shown below.

<CardGroup cols={2}>
  <Card>
    <img src="https://mintcdn.com/qobra/sIyoo6_tQQOIjBZ2/integration_documentation/images/kombo_screenshot_1.png?fit=max&auto=format&n=sIyoo6_tQQOIjBZ2&q=85&s=4d8647a3aae9a91572513860c09ab501" alt="HRIS integration scope" width="762" height="1362" data-path="integration_documentation/images/kombo_screenshot_1.png" />
  </Card>

  <Card>
    <img src="https://mintcdn.com/qobra/sIyoo6_tQQOIjBZ2/integration_documentation/images/kombo_screenshot_2.png?fit=max&auto=format&n=sIyoo6_tQQOIjBZ2&q=85&s=891db44cd2eff32258c3f4df1afd6cfe" alt="HRIS integration setup" width="764" height="1354" data-path="integration_documentation/images/kombo_screenshot_2.png" />
  </Card>
</CardGroup>

## Synchronization

### Scope & schedule

For all information synced with your HRIS, we do a full synchronization every
night. You can also trigger a synchronization when needed if you just
modified your HRIS data.

### User basic data

Once the integration is setup, you can in a single click import users. Their
name, email, and avatar will be synced with your HRIS.

<img alt="Import user from HRIS" src="https://mintcdn.com/qobra/sIyoo6_tQQOIjBZ2/integration_documentation/images/kombo_screenshot_3.png?fit=max&auto=format&n=sIyoo6_tQQOIjBZ2&q=85&s=1f48b872549af060eebadc0f84652068" width="60%" data-path="integration_documentation/images/kombo_screenshot_3.png" />

### Management hierarchy

Your management hierarchy will be synchronized by Qobra for each month,
even if your HRIS system doesn't track historical changes to the management
structure.

<img src="https://mintcdn.com/qobra/4g7tQyP7wYl6AlCt/integration_documentation/images/kombo_screenshot_4.png?fit=max&auto=format&n=4g7tQyP7wYl6AlCt&q=85&s=dee0aed05a5c6faf17fcf00ad475946e" alt="Management hierarchy for a given month" width="2024" height="1012" data-path="integration_documentation/images/kombo_screenshot_4.png" />

### User groups

The groups from your HRIS system can be synchronized as well. Data is
historicized by Qobra, even if your HRIS system doesn't track historical
changes to user groups.

<img src="https://mintcdn.com/qobra/sIyoo6_tQQOIjBZ2/integration_documentation/images/kombo_screenshot_5.png?fit=max&auto=format&n=sIyoo6_tQQOIjBZ2&q=85&s=ef3ea7429a1041126dfcbf56f1af02e4" alt="User groups synchronized with HRIS" width="1936" height="478" data-path="integration_documentation/images/kombo_screenshot_5.png" />

### Currencies

The currency of the imported users from your HRIS will be synchronized each night. By looking through the
employments returned by the HRIS it will pick the latest current employment and apply the found currency. If no currency is to be found
in the employments, it will use the company currency set in Qobra.

Important notice currently it is not possible for Qobra to synchronize the currency of the following HRIS:

* **Okta**
* **Zoho People**

If your HRIS is from the list above, the user currency will not be fetched. The user currency should be set directly in Qobra for each user.

### User attributes

You’ll find below a list of all supported user attributes (some might be disabled on specific HRIS systems).

| **User attribute**      | **Type**          |
| ----------------------- | ----------------- |
| Employee ID             | `String` (unique) |
| Employee number         | `String` (unique) |
| Job Title               | `String`          |
| Weekly hours            | `Number`          |
| Start date              | `Date`            |
| Termination date        | `Date`            |
| Employment Status       | `Picklist`        |
| Employment Type         | `Picklist`        |
| Legal entity > Name     | `String`          |
| Legal entity > City     | `String`          |
| Legal entity > Country  | `Picklist`        |
| Work Location > Name    | `String`          |
| Work Location > City    | `String`          |
| Work Location > Country | `Picklist`        |
