In order to use Litmos' ADP WorkforceNow (WFN) integration, a WFN license of version 12.0 or higher is required and the Litmos app must be purchased from the ADP Marketplace.
Additionally, the user completing this setup in ADP will become the 'integration user' for the two systems. They will also need an Account Owner profile in Litmos to enable the sync (https://support.litmos.com/hc/en-us/articles/115000045834-ADP-Integration-Enable-the-ADP-Employee-Sync) for the first time. Following the first sync, any Account Owner can perform a manual sync if needed.
Subscribe to the Litmos app on the ADP Marketplace:
To get started, a subscription must be purchased from the ADP Marketplace. There is an option to "Start A Free Trial" or "choose an edition to purchase". Choosing to start a free trial will initiate a 14 day free trial of the SAP Litmos app on the ADP Marketplace. This is only allowed while choosing the "Pro Edition".
The "Create Order" page will appear after choosing to start a trial or a paid edition. The price at checkout will be $0.00 if the free trial edition is selected, otherwise the edition cost will display on the page.
Once the edition has been reviewed and "continue" is selected, the purchaser will be routed to the "Billing Details" page. Once the billing details are entered, the purchaser will proceed to the "Confirm Order" page.
Existing Litmos customers will need to enter a subscription code when purchasing the Connector Edition. This step needs to be completed before the purchaser can advance to the billing details page.
The subscription code for the Connector edition is found in the SAP Litmos Training account by navigating to Account --> Integrations --> ADP integration.
Once the code has been entered, the purchaser will press "continue" to be routed to the "Billing Details" page. Once the billing details are entered, the purchaser will proceed to the "Confirm Order" page.
Once the order has been placed for the selected edition, the purchaser will be redirected to the "My Apps" page and the SAP Litmos Training app will display on the page.
Provide Consent to share data with SAP Litmos Training:
After clicking on the SAP Litmos Training app tile on the "My Apps" page, the purchaser will be routed to an ADP User Consent page. This is where an ADP administrator with "Practitioner" permissions must click "Confirm" to provide SAP Litmos Training app consent to read the user's basic contact information for single-sign on purposes.
Once this consent has been allowed, this person will sign into Litmos as an Account Owner and will become the Litmos "integration user" for all integration activities (i.e. creating/updating employee records in SAP Litmos Training from ADP WFN). Each user that performs SSO into Litmos from the ADP Marketplace will be required to allow consent for this.
Important note: The Litmos username for this person will be either the ADP work email address or the ADP associate Id. If there is no work email address on the ADP employee profile for this person, the ADP Associate ID will be used as the Litmos username.
Next, this Account Owner will need to provide consent to the SAP Litmos application to call the ADP WFN Worker Demographics API. This is different from application consent, which is purely for SSO. This person will need to access the ADP Consent Manager to complete these steps.
Once consent has been approved for the SAP Litmos Training app and the SAP Litmos Training API, they will appear as "approved" under the list of applications that have been granted consent.
Assign employees to the Litmos app or setup a Quick Link within ADP:
To assign the Litmos app to ADP employees in the ADP Marketplace, an ADP administrator will navigate to the "Manage Apps" --> "Assign Apps" and perform the assignment of the Litmos app to ADP employees.
Important Note: Please contact ADP if you do not see your ADP employees in the ADP Marketplace by emailing email@example.com.
If you do not wish to use the ADP Marketplace for single-sign on into Litmos, an alternative option is to setup a "Quick Link" to Litmos on the Home tab in ADP. In order to set this up, you must log into ADP as an Administrator with Practitioner access and then click on the user profile drop-down in the top right corner to access the Configuration menu item:
Once the Configuration menu is opened, an Administrator Portal will show options to configure Pages, Home and Theme. Open "Pages" and then select "Quick Links" to advance to the Quick Links setup:
Once the Quick Link setup is open, click on the "add" sign to open the Quick Link editor. This will open an ADP HTML Editor, where an image icon can be configured to have an HTML link underneath the icon.
- Workforce Now customers will place this link underneath the icon:
- Workforce Now Canada customers will place this link underneath the icon:
- Vantage customers will place this link underneath the icon:
Note: Users can have their Litmos profiles created via ADP SSO. This method will create the profile with their ADP personal email as the Litmos "Username". To avoid having a profile created via the ADP SSO, complete the first manual sync in Litmos before giving users access to the App in the ADP marketplace or the ADP SSO link.
Once the Quick Link is configured and saved, the Quick Link will display on the "Home" tab under the "Quick Links" panel in ADP for employee access: