Import Time Off Data
How do I import time off data?
Purpose: To teach you how to use the time off importer to import time off details of multiple employees at once.
Table of Contents
- Time Off settings
- Download the time off template
- Complete the policy assignments template
- Time off importer
- Match your data
-
Import results
-
What to do if you get a Time Off error while importing
- Time Off Error Message: "Employee is not assigned to the specified category."
- Time Off Error Message: “Policy effective date is before employee hire date”
- Time Off Error Message: “This policy doesn’t exist”
- Time Off Error Message: “Time off category not found”
- Time Off Error Message: “Employee already has this policy”
- Time Off Error Message: "Could not parse the date."
- Time Off Error Message: "An error occurred. We cannot handle your request at this time."
-
What to do if you get a Time Off error while importing
- Spot-check
- Do you need to import opening balances?
- Do you need to import balance adjustments?
- Do you need to import time off requests?
Do you prefer hands-on learning? Our interactive guides will guide you through different aspects of your BambooHR experience. We have an interactive guide specifically designed to show you how to import time off data. You can use the link below to access this guide. All you need to do is modify the "REPLACEME" with your BambooHR subdomain, and you can get started!
https://REPLACEME.bamboohr.com/home?pendo=j_gqe-tX8O4s_5NgPRvQdch2qmw
**CAUTION: Whenever using the importing feature, we recommend running a test import of a single line to catch any formatting errors in the prepared data. Once you have imported the single line data, double-check if the data has entered as expected, and then continue to import the remaining data.
Time Off settings
When you need to add a large amount of time off information to BambooHR, you can use the time off importer to help you get this information added more efficiently. The time off importer can import the following time off information of your employees:
- Policy assignments
- Opening balances
- Balance adjustments
- Time off requests
To access the time off importer, go to Time Off in Settings, click Overview, and click on the gear icon. Select Time Off Import...
Download the time off template
Select the type of information you would like to import in the drop-down menu. Then, select import template file.
Because there is specific information required for each import, we have created a template for you to fill out. You can add columns to the template for reference purposes (i.e., Employee Name). Note that you can only import the columns that are in the downloaded template.
To avoid errors, we recommend importing your data templates in the following order:
- Policy Assignment
- Opening Balance
- Balance Adjustment
- Time Off Requests
You are now ready to fill in the downloaded template. Please note that the example above is the policy assignment template, and you can find detailed information about all other time off import templates at the end of this article.
For the Policy Assignments template, enter the following data:
- Employee Name: I have added this column to the template for reference purposes only. This column will not import.*
- Employee #: The exact Employee # listed in BambooHR.*
- Accrual Policy: The name of the time off policy (not the type category name). You must enter the policy name exactly as it appears within BambooHR.
- Time Off Category: The time off category associated with the policy.
- Accrual Start: The date that you want the system to start accruing time off for an employee. For example, in row #2, Charlotte Abbott is being assigned the Vacation policy as of 1/1/2023. This means that the system will activate this policy and will start accruing as of 1/1/2023. Please note that dates must be in a format with the four-digit year.
After entering all of the appropriate data into the template, save the file as a .csv or .txt file. It is then ready for import. (See importing steps above.)
*Note: An easy way to get the Employee Name and Employee # into the template is to copy and paste the information from a custom report in BambooHR.
When assigning policies through import, all accruals and carryover loss will appear after a nightly system update at 1:00 a.m. (Mountain Time). You can use the calculate future balance tool to review changes before a nightly update.
Time off importer
To import your time off information, follow these three steps:
- Select the import type you want to complete.
- Click Choose File and select your .csv or .txt file from your computer.
- Click Upload File.
Match your data
After you have uploaded your file, map the data in the template to the corresponding fields within BambooHR.
- Import File Column: The column headers (Row 1) from your template.
- BambooHR Field: The fields that your data will import into within BambooHR. Since you have downloaded the template directly from BambooHR, the fields have matched up already. Note: If you have added any columns to the template (such as the Employee Name column), you will not import them, and make sure to select Do not import this field as shown above.
- Sample Data: The data from Row 2 of your import template. Double-check the data to ensure it looks correct.
If everything looks good, click Import.
Import results
After you have completed an import, a confirmation message will show. A green confirmation message will show if you imported all lines successfully. An orange-colored alert will show if any rows have errors. Click Show import details to display specific row-by-row information.
What's going on: You may have tried to import an opening balance, balance adjustment, or time off request before the policy assignment import. Make sure you have assigned employees to policies before attempting any other import types.
What’s going on: The Time Off Accrual Start Date, or policy effective date, cannot be before the Hire Date.
What’s going on: Time Off Policy name does not match the settings. The spelling, spacing, and capitalization must match exactly to settings.
What’s going on: Time Off Category name does not match the settings. The spelling, spacing, and capitalization must match exactly to the time off category in settings.
What’s going on: This error comes from the Policy Assignment importer. If you are not trying to assign a new policy, you may need to use a different time off importer option to accomplish your needs. Review the Time Off tab for the employee to verify the correct policy is assigned.
What's going on: This error happens because the date is not in a proper format. Make sure that your dates are listed as MM/DD/YYYY.
What's going on: This error message can occur for a number of reasons, but most commonly if you're trying to import too much data at once. If importing more than 400 rows of data, try breaking up the data into two smaller imports. If the error persists, please reach out to Support.
Spot-check
After you have completed an import, spot-check a few employees to ensure their entered information is correct.
For the opening balance template, enter the following data:
- Employee Name: I have added this column to the template for reference purposes only. I will choose not to import this column at the time data is entered through the importer.
- Employee #: The exact Employee # listed in BambooHR located on each employee's Personal Tab.*
- Opening Balance: (Number field) For a positive amount, the number should be entered as shown in lines 2, 3, and 5. For a negative amount (i.e., someone who has currently used more vacation time than they have), enter a negative number as shown in line 4.
- Time Off Category: The time off category that receives the amount listed in column C. The name of the type must match the name of the time off category within BambooHR.
- Effective Date: (Date field) The opening balance date. For example, If I were to add an opening balance for an employee as of May 1, 2022, and then put 5/1/2022 in column E. Please note that dates must be in a format with the four-digit year (mm/dd/yyyy). *If you use a different date format in your account, the import will automatically switch the dates to the correct format upon importing the spreadsheet.
After entering all of the appropriate data into the template, save the file as a .csv or .txt (Unicode Text) file.
*Note: An easy way to get the Employee Name and Employee # into the template is to copy and paste the information from a custom report in BambooHR.
For the balance adjustments template, enter the following data:
- Employee Name: I have added this column to the template for reference purposes only. This column will not import.
- Employee #: The Employee # listed in BambooHR.*
- Balance Adjustment: You can add an amount of time by entering a positive number or subtract an amount of time by entering a negative number. Note that you do not enter the time unit label of days or hours in this cell. The system already knows the appropriate information based on the type category.
- Time Off Category: The time off category that receives the amount listed in column C. The name of the category must match the name of the time off category within BambooHR.
- Comment: The note you want to appear with the balance adjustment.
- Effective Date: (Date field) The date that associates with a Balance Adjustment entry. Please note that dates must be in a format with the four-digit year.
After entering all of the appropriate data into the template, save the file as a .csv or .txt (Unicode Text) file. It is then ready for import. (See importing steps above.)
*Note: An easy way to get the Employee Name and Employee # into the template is to copy and paste the information from a custom report in BambooHR.
This template allows you to import a group of time off requests into the system all at once.
For the PTO Requests template, enter the following data:
- Employee Name: I have added this column to the template for reference purposes only. This column will not import.
- Employee #: The exact Employee # listed in BambooHR.*
- Date: The date of the time off request. If a request spans multiple days, you will need a separate line for each date in the request. Consecutive dates that span multiple rows in the spreadsheet will automatically group** as one request as long as they are of the same time off category. Note: Dates must be in a four-digit year format.
- Time Off Category: The time off category that the request will subtract from. The name of the category must match the category name within BambooHR.
- Amount Requested: The number of hours or days the employee will be taking off for the specific date(s) in the request. If the time off category tracks in days, the number cannot be greater than one. If the time off category tracks in hours, the number cannot be greater than 24. With this import, DO NOT enter a minus symbol in front of the time off request amount to indicate a negative amount ("-") because the system assumes that all values will deduct from the current existing balance. Do not enter days or hours in this field as the system automatically knows the time units based on the time off type category. (Note: If you enter a minus symbol in front of an amount in the Amount Requested column, the system will add that time amount to the employee's balance.)
- Note: The note associated with the time off request. If a request spans multiple days, the notes will compile together into one note. So if you have a request that covers multiple days, it is best to only add your note to the first day in the request, and it will apply to the entire request.
After entering all of the appropriate data into the template, save the file as a .csv or .txt file. It is then ready for import. (See importing steps above.)
*Note: An easy way to get the Employee Name and Employee # into the template is to copy and paste the information from a custom report in BambooHR.
** If one of the requests in a group of consecutively dated requests has an error when imported, the other requested days within the group will also show an error in the import. You will need to reimport the entirety of the request.
By importing, the system assumes that each time off request entered is already approved. All imported time off requests will automatically have an approved status, and the import will bypass the regular notification process.