Payroll Contribution Integrations

You can run your Payroll Contribution integration files from within the Integrations Dashboard.

The Integrations Dashboard enables you to run and view the results of integrations between UKG Pro products and other business partners. The Integrations Dashboard is the first page that appears when you log in to the Integration Platform. There are two main components to the Integrations Dashboard, the Integrations and Events pages.

Displays Integrations Dashboard Example Text

Access the Integrations Dashboard

From within Role Administration, you must first assign web access rights to the appropriate user roles in UKG Pro (Menu > System Configuration > Security > Role Administration > Select a Role > Web Access Rights > Integration Platform). Check the View and Edit access boxes so that users assigned to the role can access the integration.

To access the Integrations Dashboard:

https://integrations.ultipro.com/

At the Sign In page, enter your Company Access Code or Customer API Key. You can locate this information in UKG Pro > System Configuration > Security > Service Account Administration.
Check the I Agree to Terms and Conditions (Required) box.
Select Continue.
Note Multi-factor authentication (MFA) is required the first time you log in.
Complete the multi-factor authentication steps, as applicable.
Enter your UKG Pro credentials.
Select Sign In. The Integrations Dashboard displays.

Run a Payroll Contribution Integration

The Integrations Dashboard allows you to run an integration manually, monitor the status of the integration, and view the integration status.

From the Integrations page, locate your carrier's integration for Payroll Contribution.
Hover your mouse over the integration to display additional action item icons.
Select the Run icon. The Integration run page displays.
At the Date Range section, select the date that should be included in the output as the Start Date and End Date. For example, if the
- Check date is 01/05/2021, enter 01/05/2021 as both the Start Date and the End Date.
- Check dates are 01/05/2021 thru to 01/15/2021, enter 01/05/2021 as the Start Date and 01/15/2021 as the End Date.
At the Notifications section, to receive a notification email, you can enter one or more email addresses and select from these notification options: Start, Success, or Failure. Multiple email addresses must be separated by a comma.
From the Pay Group drop-down list, select one or more pay groups to include in this integration run.
At the Options section, select either Test or Production based on the file type the carrier is expecting for this integration. This indicator may be used in the file name and/or in the file header.
At the File Output section, check the Send to Carrier box to enable the Location selection options. These options vary by carrier. You may see either:
- One server listed that receives both Test and Production files.
- Two servers listed - a Test server and a separate Production server.
  Important Always confirm that the correct file type Option and Location are selected before moving on. Otherwise, if the Test file type is selected and a Production server is selected, then a Test file could be processed through a Production environment.
From the Payroll Sequence drop-down list, the default selection is All. You can choose to either run an integration for only the regular payroll or you can choose to include supplemental payrolls, as applicable.
- To run the integration for only the regular payroll, uncheck the All box. Then, check only the 1 box.
- To include supplemental payrolls, uncheck the All box. Then check the boxes 2 thru 9, as applicable.
Select Run. The Integrations page displays.
Select the Events page to view the integration.
- Select the link in the Event Date/Time column to view the event details.
- Select the link in the Event Status column to view the file details.

Re-Run an Integration

You may need to re-run an integration in the event that an integration failed or was not received by the vendor.

From the Events tab, search for the integration that you need to re-run.
Select the Event Date/Time link for that integration. The Event Details page displays.
Select the Actions drop-down menu and then select the Re-Run Integration option.
Note We recommend that you enter a Support Case if you attempted to re-run the integration twice and it continues to fail.

This document and all information contained herein are provided to you "AS IS" and UKG Inc. and its affiliates (collectively "UKG") make no representation or warranties with respect to the accuracy, reliability, or completeness of this document, and UKG specifically disclaims all warranties, including, but not limited to, implied warranties of merchantability and fitness for a particular purpose. The information in this document is subject to change without notice. The document and its content are confidential information of UKG and may not be disseminated to any third party. No part of this document or its content may be reproduced in any form or by any means or stored in a database or retrieval system without the prior written authorization of UKG. Nothing herein constitutes legal, tax, or other professional advice. All legal, tax, or other questions or concerns should be directed to your legal counsel, tax consultant, or other professional advisor. All company, organization, person, and event references are fictional. Any resemblance to actual companies, organizations, persons, and events is entirely coincidental.