This guide will inform you on how to integrate BambooHR for Global Payroll and enable our helpful plugins.
For more information about using Global Payroll with Deel, please see Global Payroll Overview
In this article:
Onboarding the Global Payroll Employees plugin
Auto sync payslips and end of year tax documents plugin
Global Payroll - Time Off plugin
Global Payroll - One Time Payment plugin
Before you begin:
One must have both
- a valid BambooHR login
- You must be an Org Admin, IT Developer Admin, or Integrations Admin-People on Deel to set up this integration.
Note: It may take several hours for updates and profiles to appear on BambooHR.
Preparing your BambooHR
✅ Step 1 - Create the Pay Group in BambooHR
Pay Group is a standard field in BambooHR used for integrating with payroll providers to understand how the employee is getting paid.
You must have Admin permissions in BambooHR to proceed.
- Click on the Gear icon located at the top-right of your screen on BambooHR.
- Click on (1) Employee Fields in the left-hand menu
- In the sub-menu, find and select (2) Pay Groups
- To add a first Pay Group click (3) New Pay Group and create an option for each entity to set up Deel Global Payroll.
With at least one option defined, assign a value for any employee to be synced to Deel within the Job tab for each employee under compensation.
✅ Step 2 - Assign Pay Group to employees
One must have Admin permissions in BambooHR to edit employee data
- Go to the Job tab of an employee
- You view and edit employee details like Hire Date, Standard Hours Per Week, Pay Group, EEO Job Category, and more.
- Select the Pay Group from the dropdown options
- Click on Save Changes to apply the selected Pay Group for the employee.
Follow the above steps for all employees to be synced.
There may be a sync error if the country of employment of an employee does not match the entity country of the pay group.
Integrating Deel to BambooHR
✅ Step 1 - Select Apps & Integrations from your home page
You must be an Org Admin, Integrations Admin, or Integrations Admin-People to set up this integration.
✅ Step 2 - Click BambooHR
✅ Step 3 - Click Connect
✅ Step 4 - Enter BambooHR subdomain
Where can the BambooHR subdomain be found?
To locate your subdomain log in to BambooHR and view your URL.
A company subdomain is the string that precedes the BambooHR domain.
✅ Step 5 - Click Continue & Authenticate
Unless already logged in, there'll be a request to enter BambooHR username and password on a new tab.
Adblockers may need to disabled to see the new tab.
✅ Step 6 - Click Allow Access on the pop-up window
✅ Step 7 - Congratulations! Plugins can be enabled now
Onboarding the Global Payroll Employees plugin
The following steps will help decide which entity group to create or sync Global Payroll contracts for, according to the BBHR pay group.
This step is highly sensitive so ensure to be very careful!
✅ Step 1 - Select Entity
Select the (1) Onboarding for Global Payroll Employees plugin.
In the Entity settings page, select an entity from the existing list or click (2) Add to add a new one.
✅ Step 2 - Select a Pay Group Entity (with reference to BambooHR) that matches the entity country.
Note: Take extra care to correctly complete this step to ensure that the selected pay group corresponds to the desired entity payroll is being ran from.
✅ Step 3 - Add Group
Global Payroll contracts require a group.
Select an Organization reference and Group. Click Add
Repeat the above steps for any other desired entities
Please be aware that once a pay group and entity have been 'used', they cannot be reused.
It won't be possible to delete or alter these mappings once approved. If changes are needed, please contact the Deel support group.
Data Mapping
With a customized field setup, so data mapping is done on a case-by-case basis.
During the initial integration setup, Deel will install a default mapping packet. This can be customized to your needs.
Deel will help set up specialized data mapping, so please reach out to assigned onboarding manager or customer success manager for assistance.
Syncing data and log report
After completing the mapping there'll be the need to sync data by clicking Sync BambooHR in the integration.
A poll of client's HR system will now sync in details for all the employees with a mapped pay group.
See the last time that a sync was completed in the top left corner.
Payroll logs
To view the log report from the last sync, select the Payroll Logs tab.
Use this log report to open up a Bamboo profile or a Global Payroll contract (if available), to investigate any issue.
Auto Sync Payslip and End of Year tax documents plugin
This plugin allows clients to sync payslips and end-of-year tax documents of their Global Payroll employees to BambooHR.
This allows their group to have easy access to these documents on BambooHR.
Deel will sync these documents to the yearly payslips folder in BambooHR.
Deel can only sync payslips and tax documents beginning from when the plugin is first enabled.
To enable this plugin, Select the (1) Plugins tab and click (2) Enable Auto Sync Payslip and End of Year (Tax document)
Once this plugin is enabled, it will create a yearly folder and sync all payslips and the end-of-year tax documents into it.
Payslips and tax documents will sync to BambooHR when they are published in Deel.
Global Payroll Time Off plugin
This plugin makes client's HRIS the source of worker time-off reporting when using Deel.
Once configured, any group member working as a Deel Employee will enter time off into this HRIS instead of Deel.
To enable this plugin, click Enable on the Global Payroll Time Off plugin and begin matching the BambooHR time-off types to the Deel time-off types:
Global Payroll - One Time Payment
This plugin makes BambooHR the source of one-time payments when using Deel.
Once configured, any group member working as a Deel direct employee will enter one-time payments into this HRIS instead of Deel. This can only happen for Deel employees linked to a HRIS profile.
Each Deel one-time payment type needs to be matched with at least one one-time payment type from the BambooHR one-time payment type list to complete the setup.
Please note that the OTP sync to Global Payroll only supports the entity's currency as defined in Global Payroll.
Please ensure that any Variable Pay or Entitlement added in BambooHR follows the same currency used by the employee’s entity in Deel Global Payroll.
Frequently Asked Questions
[ACCORDION] What types of data can be mapped with this integration?
Currently there are three types of data that can be mapped
- Global Payroll contract fields
- Additional Information fields
- Annual Compensation
[ACCORDION] What field types are not supported?
Currently, these field types are not supported with the integration:
- Payroll items
[ACCORDION] How often will the integration sync?
The integration will automatically sync every 12 hours, at 30 minutes past the hour.
[ACCORDION] Will there be notifications of integration issues?
Yes, Deel will send out notifications of integration or global payroll sync issues. Specify an organization manager (or as many emails as needed) email to receive these notifications.
To do this:
✅ Step 1 - Go into the BambooHR integration and click on the inverted ellipsis (three dots) next to the Sync Integration button.
✅Step 2 - Select Email notifications settings from the list of options.
✅Step 3 - In the Email notifications settings drawer, click on the Add button to add an email notifications list.
[ACCORDION] Can workers be managed manually on Deel if BambooHR stops working?
Even if a client’s HRIS software stops working, onboarding and offboarding workers is still possible manually on Deel. To manage employee data manually, the sync with the HRIS software must be temporarily disabled.
To disable the sync:
✅ Step 1: From the Deel home page, select the Hub icon and Apps tab to search for BambooHR.
✅ Step 2: Within BambooHR, find the Global payroll - employee data sync plugin and click on Manage.
✅ Step 3: On the Global payroll employee data sync drawer, select the entity to be used.
✅ Step 4: Click on the ellipses (three dots), select Disable Syncing and confirm the change.
Keep in mind that data syncs from BambooHR to Deel. When the sync is enabled, all the data manually entered in Deel will be overwritten by the data in BambooHR.
Before re-enabling the sync, make sure:
- To add the worker(s) to BambooHR first.
- That the email and employee numbers in both systems match.