Troubleshoot: Import offices and departments

HRIS_Link_permissions.png

When your organization implements HRIS Link, you must specify a notification email address. Greenhouse will send an email to this address after every HRIS Link run, confirming if the run succeeded or failed. If HRIS Link fails, the notification email includes details on the error that occurred, as well as a Workflow ID. The Greenhouse Support team can use these details to help troubleshoot and diagnose the issue.

In most cases, if an error occurs while HRIS Link is attempting to create or update an office or department, the error will prevent the office or department from being created or updated in Greenhouse Recruiting.

Email subject Error information Issue User solution

HRIS Link: Office import completed with errors

or

HRIS Link: Department import completed with errors

Creation failed: Validation failed: Name has already been taken This error message occurs when HRIS Link attempts to create a new office or department in Greenhouse Recruiting, but the office or department name included in the HRIS Report matches an existing office or department in Greenhouse Recruiting. 1. Audit your HRIS to confirm the office or department does not exist twice in the HRIS.
2. If the office or department name exists twice in the HRIS, update or remove the duplicate so the name and external ID are unique.
3. If the office or department name doesn't exist twice in the HRIS, audit the Organization page in Greenhouse (Configure Configure.png > Organization) to ensure the external ID on the Greenhouse Recruiting office matches the external_id value included in the HRIS Report.
4. Wait 15 minutes for office import or department import to run once again.
5. If the issue persists, click here to open a ticket with the Greenhouse Support team.
HRIS Link: Office import completed with errors
or
HRIS Link: Department import completed with errors
Resource not found This error may be caused by an issue with the on-behalf-of user’s (named: HRIS Link) permissions, HRIS Link Harvest API key permissions, or access to the HRIS Report URL. 1. Verify the Greenhouse Recruiting on-behalf-of user is active and has the appropriate permissions.
2. Verify the HRIS Link Harvest API key has proper permissions.
3. Verify the HRIS Report URL is valid and accessible via the ISU.
4. If the issue persists, click here to open a ticket with the Greenhouse Support team.

 

Additional resources