Workforce
      Back to home
      1. Help Center
      2. Integrations
      3. Workforce

      UKG Ready - Workforce Import Instructions

      Import your current employee roster from UKG Ready

      To import an employee roster from UKG Ready into Jirav, follow these steps:

      1. Connect UKG Ready to Jirav: 

        • Navigate to Setup ⚙️ > Actuals in Jirav.
        • Select "Connect" next to UKG.

      2. Authenticate UKG Ready:

        • To authenticate your UKG Ready account, you will need to provide the following information: Domain, Company Short Name, API Key, User ID and password.
        • Refer to Merge's "UKG Ready - How do I link my account?" guide for detailed instructions to obtain the Domain, Company Short Name, API Key, User ID and password from UKG.

      3. Confirm Connection:

        • After obtaining the Domain, Company Short Name, API Key, User ID and password from UKG, return to Jirav.
        • Enter the information from UKG when prompted.

        • Submit the information and await confirmation of a successful connection.
          Successful Integration SS
      4. Import Employee Roster:
        • Once UKG Ready is authorized for Jirav, the "Connect" button will change to "Import."
        • Click "Import" to synchronize the current employee roster with the Jirav Staffing table.

      Be Aware:

      The initial import process may take up to 24 hours to fully complete. During this time, it is possible you may see a partial list of employees as the import progresses in batches. Subsequent imports will be immediately available. 

      Helpful Hint:

      These instructions specifically apply to UKG Ready. UKG Pro is not supported at this time. 

      Mapping UKG Fields to Jirav

      The Jirav integration with UKG allows seamless import of key employee data to enhance workforce planning and financial forecasting. Below, we outline how Jirav maps various fields from UKG and provide troubleshooting steps for common configuration issues.

      Departments Mapping

      UKG allows multiple Cost Center fields, and Jirav specifically maps Departments using the third Cost Center field, regardless of its label in UKG. If Departments are not importing correctly, it may be due to this field not being configured in UKG.

      Resolution:

      • Ensure that the third Cost Center field in UKG is set up and assigned to the relevant employees.

      • Once configured, Departments should successfully import into Jirav.

      • Without a 3rd configured Cost Center, Departments will remain unassigned in Jirav.

      Roles Mapping

      Roles in Jirav are mapped to the "Jobs" field in UKG. If Roles are not appearing in Jirav, it is likely that Jobs have not been configured in UKG.

      Resolution:

      • Configure the "Jobs" field in UKG and ensure it is assigned to employees.

      • Once configured, Jobs should import as Roles into Jirav.

      • Without this setup, Roles will remain unassigned in Jirav.

      Compensation Data Mapping

      Jirav pulls compensation data from the "Base Compensation" field in UKG. For the integration to function correctly, this field must be set to either "Amount per Hour" or "Amount per Year."

      Resolution:

      • Verify that the Base Compensation field is set to the correct unit (Hourly or Annual Salary).

      • While UKG may display an annualized salary for reference, this may differ from the field used by the Jirav integration.

      • If the import appears incorrect, check the Base Compensation field for an affected employee and adjust as needed.

      • Employees setup with an unsupported Base Compensation, such as "Amount per Pay Period" will likely import unexpected amounts.

      For additional assistance, please ensure that your UKG configuration aligns with the above requirements. If issues persist, contact Jirav support with details, including screenshots of the relevant UKG settings, for further troubleshooting.