Integration Overview
Employee Data Synchronization
Organization Structure Synchronization
Employee Data Synchronization Specifics
Position Synchronization
Filters
Important Notes
Time Off and Leave of Absence Data Synchronization
Important Notes
Schedule Data Synchronization
Important Notes
Integration Requirements
Humanity Application Requirements
Workday Application Requirements
Integration Setup Instructions
Integration Activation (Authentication)
Important Notes
Employee Sync Activation
Important Notes
Time Off and Leave of Absence Sync Activation
Important Notes
Schedule Sync Activation
Frequently Asked Questions
Workday is an industry-leading human capital management software for managing the entire employee life cycle of your business, from recruitment and onboarding to compensation and development.
This document provides a detailed overview of Humanity’s integration with Workday along with instructions for setting up and activating the integration.
Integration Overview
The integration is bi-directional and supports the following data synchronization:
From Workday to Humanity: Employee data synchronization, time Off data synchronization, and leave of absence data synchronization
From Humanity to Workday: Schedule data synchronization
The synchronization is automatically triggered every hour (counting from the completion of the last sync).
Workday is the source of truth for employee data (including organization Structure data), time off and leave of absence data. Data synced from Workday to Humanity shouldn’t be changed in Humanity.
Humanity is the source of truth for schedule data. Data synced from Humanity to Workday shouldn’t be changed in Workday.
Employee Data Synchronization
Organization Structure Synchronization
The synchronization of the organization structure from Workday to Humanity is the initial component of the employee data sync. The same sync is needed so to reflect the organization/hierarchical structure of the selected organization Hierarchy in Workday to the Group Account Platform (GAP) in Humanity, to which employees and their data will be allocated.
Upon the integration activation and the initial employee sync completion, all the organizations of the selected organization hierarchy in your Workday tenant will be reflected in child accounts in Humanity's GAP.
The integration supports an Employee Data sync for one of the following organization Hierarchy types:
Company Hierarchy
Cost Center Hierarchy
Location Hierarchy
Regional Hierarchy
The integration will synchronize only employee data for the specific hierarchy of the selected organization hierarchy type (i.e. company hierarchy is selected as the hierarchy type and XYZ Inc. is selected as the specific organization of the company hierarchy type).
The organization hierarchy type and the specific organization of that organization Hierarchy type, for which employee data will be synced, cannot be changed once chosen and the integration for those has been activated.
During the integration activation process, you will be able to choose whether to sync the last level of your selected Workday Organization Hierarchy (company/cost center/location/region) to account or location in Humanity. Your selected preference will be permanently saved and cannot be changed.
If you prefer to sync Workday company/cost center/location/region to location in Humanity, the job profile sync from Workday to humanity has to be activated during the integration setup.
The integration will recognize and synchronize the data from Workday to Humanity upon the following actions:
A new organization is created in the selected organization Hierarchy in Workday
An existing organization is moved into the selected organization hierarchy
An existing organization is deleted/deactivated from the selected organization hierarchy
Employee Data Synchronization Specifics
All workers from Workday will be synced to Humanity as users with “employee” account permissions. To set proper account permissions per user in Humanity, go to staff > access specific employee profile > permissions > account type > choose desired permission level.
The employee match during the initial sync will be by the employee’s Workday ID.
Upon the initial Employee sync, Humanity will automatically create user accounts for all employees that don’t have a Humanity account. Each newly created employee in Humanity will have a status which reflects the employee’s status in Workday. An “Active” status will be set for all employees that are active in Workday and a “Disabled” status will be set for employees that are inactive in Workday.
If the employee’s status is “Active,” an activation email (for password setup) won’t be sent to the user (employee).
If you would like to send an activation email (for password setup) to a specific, newly-created employee/user in Humanity, you will need to:
Set that user’s status in Humanity to “Inactive”.
Click on the Staff module and select “Not Activated” from the left side panel
Choose one of the available options - “Send Activation Email Now” (or “Manually Activate All” if you would like to send an activation email to all currently inactive users)
The following Employee data will be synced from Workday to Humanity:
Legal First Name
Legal Last Name
Work Phone Number
Home Phone Number (only if Work Phone not found)
Work Email Address
Home Email Address (only if Work Email not found)
Employee (Worker) Status
Employee (Worker) Hire Date
Employee (Worker) Time Zone
Employee ID/ Contingent Worker ID
The integration will recognize and synchronize the data from Workday to Humanity upon the following actions:
Employees created in Workday
Employees information updates in Workday - first name, last name, phone, email, status, time zone change, employee transferred from one organization to another in the same organization Hierarchy
Employees deactivated/terminated in Workday
Job Profile synchronization
The integration supports synchronization of employee’s (worker’s) job profile from Workday, to position in Humanity. The Job profile in Workday is the equivalent to Position in Humanity.
Employees’ (worker’s) Job Profile synced from Workday will be assigned as Position to that Employee’s (worker’s) in Humanity.
Activating the job profile sync is optional if all your employees (workers) have only one job profile and therefore one position assigned in Workday.
If your employees (workers) have more than one job profile in Workday, job profile sync is mandatory in order for integration to work properly.
Our recommendation is to activate job profile sync even if you have only single job profile/position employees (Workers), in order to ensure that integration will properly work if you decide to have multiple Job Profile/Position Employees (Workers) at some point in future.
The job profile sync can be activated only when setting up the employee sync configuration for the first time and once enabled, cannot be disabled afterwards. Upon job profile sync activation, the shifts that are being synced from Humanity to Workday will bear information about the Position for which shifts are created.
Shifts, which are created for the job profiles synced from Workday, will be synced from Humanity to Workday. Shifts are created manually in Humanity and don’t sync to Workday.
Positions manually created in Humanity will not be deleted/overridden by the integration with data from Workday. If you delete/change position which is synced from Workday, that data will be overridden with data from Workday with the next sync.
If an employee (worker) doesn't have job profile or a position in Workday or has a position but not job profile, then that employee (worker) will be synced to Humanity, but won't have assigned position. Consequently, shifts created for that employee won't be synced to Workday.
The integration will recognize and synchronize the data from Workday to Humanity upon the following actions:
Job profile created and assigned to employee (worker) in Workday
Job profile for employee (worker) updated in Workday
Job profile unassigned from employee (worker) in Workday
Wage synchronization
The integration supports the synchronization of an Employee’s (Worker’s) wages from Workday to Base Rate for their Position in Humanity. The Employee’s (Worker’s) wage data is pulled from Workday and assigned as Base Rate to the Employee’s (Worker’s) Position in Humanity.
The Wage sync activation is optional and can be done only when setting up the Employee sync configuration for the first time. Once enabled, it cannot be disabled.
The precondition for Wage sync activation is the activated Position sync with selected Workday Job Profiles to Humanity Positions option.
Humanity stores only hourly wage data. Therefore, it is recommended to sync only the hourly wage from Workday.
The integration will recognize and synchronize the data from Workday to Humanity upon the following actions:
Wage added to Employee’s (Worker’s) Position in Workday;
Wage for Employee’s (Worker’s) Position updated in Workday;
Wage removed from Employee’s (Worker’s) Position in Workday.
Certifications synchronization
The integration supports synchronization of Employee’ (Worker’s) Certifications from Workday to Skills in Humanity.
Employee’s (Worker’s) Certification synced from Workday will be assigned as a Skill to that Employee (Worker) in Humanity.
The Certification sync activation is optional and can be done only when setting up the Employee sync configuration for the first time. Once enabled, it cannot be disabled.
The integration will recognize and synchronize the data from Workday to Humanity upon the following actions:
Certification added to Employee (Worker) in Workday;
Certification expired/removed from Employee (Worker) in Workday.
Time Type and Employee Type Synchronization
The integration supports the synchronization of Employee Type and Time Type fields from Workday. The Employee and Time Type data is pulled from Workday and is assigned to the Employee’s profile in Humanity, as newly created custom fields.
The Time and Employee Type activation is optional and can be done only when the Employee sync is being configured for the first time. Once enabled, the sync cannot be disabled.
The integration will recognize and synchronize the data from Workday to Humanity upon the following actions:
Time Type/Employee Type defined for Employee (Worker) in Workday;
Time Type/Employee Type updated for Employee (Worker) in Workday.
Integration stores the values of Workday Time and Employee Type fields to the Humanity custom fields named WD Time Type and WD Employee Type. Those custom fields are created automatically if Sync Workday Employee Fields to Humanity Custom Fields is enabled.
During integration activation, the user can choose whether to sync only one or both fields. Based on their choice, the integration will create one or two custom fields in Humanity.
The WD Employee Type custom field in Humanity will contain all available types of both Employees (for example, Temporary, Seasonal, Regular, and others) and Contingent Worker (for example, Contractor, Vendor, and others) types in Workday.
The WD Time Type will contain available values of the Time Type field in Workday (for example, Full Time, Part-Time).
Position Synchronization
The integration supports the synchronization of Employee’s (Worker’s) Job Profile or Business Title from Workday, to Position in Humanity. The Job Profile or Business Title in Workday is equivalent to Position in Humanity.
Based on the chosen Position sync option, either Employees’ (Worker’s) Job Profile or Business Title synced from Workday will be assigned as Position to that Employee’s (Worker’s) in Humanity.
Possible Position sync options are:
Sync Workday Job Profiles to Humanity Positions
Sync Workday Business Titles to Humanity Positions
The Position Sync can be activated only when setting up the Employee sync configuration for the first time. Once enabled, it cannot be disabled.
Positions manually created in Humanity will not be deleted/overridden by the integration with data from Workday. However, if you delete/change Position in Humanity which is synced from Workday, that data will be overridden with data from Workday with the next sync.
Shifts created for Positions representing Job Profiles / Business Titles synced from Workday will be synced from Humanity to Workday. If Position sync is activated and Job Profile or Business Title option is selected, the shifts synced from Humanity to Workday will hold information about the Position for which the shifts are created. Please note that shifts created for Positions manually created in Humanity won’t sync to Workday.
The integration will recognize and synchronize the data from Workday to Humanity upon the following actions:
Job Profile / Business Title created and assigned to Employee (Worker) in Workday
Job Profile / Business Title for Employee (Worker) updated in Workday
Job Profile / Business Title unassigned from Employee (Worker) in Workday
Important Notes:
If all your Employees (Workers) have only one Position assigned in Workday, then activating the Position sync is not mandatory. Shifts will be synced from Humanity to Workday without the Position ID.
If your Employees (Workers) have more than one Position in Workday, Position sync activation (and choosing Job Profiles or Business Titles option) is mandatory in order for the integration to work properly.
We recommend that you activate the job profile sync even if your Employees (Workers) have only one Position. This way, the integration will still work properly if you decide to have multiple Position Employees (Workers) at some point in the future.
If an Employee (Worker) doesn't have a Job Profile or a Position assigned in Workday or has a Position but not a Job Profile assigned, then that Employee (Worker) will be synced to Humanity, but won't have an assigned Position.
If the Sync Workday Job Profiles to Humanity Positions option is selected and an Employee (Worker) has multiple Positions assigned in Workday, but has the same Business Title assigned for each Position, the integration will create only one Position in Humanity and assign it to Employee (Worker). In that case, Position information sent back as shift details to Workday will be related to Employee’s (Worker’s) primary Position in Workday.
Filters
Pay Rate Filter
The integration supports the synchronization of a specific employee subset (in the selected Organization Hierarchy) by the employee’s assigned Pay Rate.
Filtering by Pay Rate is optional. You can set one or more Pay Rates to filter employees by (i.e. Hourly and Salaried and Flat Rate).
This filter can be applied only during the initial setup of the Employee sync configuration. Once enabled, the filter cannot be disabled.
If an employee has multiple positions, the filters will only be applied to employee’s Primary Position.
Upon applying the filter, the integration will only sync the employees with a defined Pay Rate(s). This filter doesn't apply to Contingent Workers.
Contingent Workers Filter
In order for Contingent Workers to be synced from Workday to Humanity, that option has to be activated in the Filters section during the Employee data sync activation.
Activating the Contingent Workers sync is optional and if not applied, Contingent Workers won’t be synced.
The same as for Pay Rate filter, Contingent Workers activation can be performed only when setting up employee sync configuration for the first time. Once enabled, it can’t be disabled anymore.
Job Family & Job Category Filters
The integration also supports the synchronization of a specific employee subset (in the selected organization Hierarchy) by the Job Family and/or Job Category to which the employee’s assigned Position belongs.
Filtering by job family and/or job category is optional. You can set one or more Job Families and/or Job Categories by which to filter employees. When set for the first time, those filters cannot be changed.
If an employee holds multiple positions, the filters will only be applied to employee’s Primary Position.
Job Family and Job Category filter can be used independently or combined. If used together, integration will only sync employees whose Job Profile has both one of the selected Job Families and one of the selected Job Categories.
These filters can be applied only during the initial Employee sync configuration. Once enabled, the filters cannot be disabled.
Important Notes
If the manager role in a specific Workday Organization in the selected organization Hierarchy is inherited from one of the superior organizations, then that employee will not be visible in the Humanity account in which the Manager’s role is inherited.
If an employee is terminated (deactivated) and later re-hired in Workday, that employee will be reactivated in Humanity as well.
If an employee is terminated on a certain day, but their termination effective date is set to at least two days before, that employee won’t be picked up by the integration and terminated in Humanity. In order for an employee to be synced as terminated, termination effective date has to be set to maximum one day in the past from the day of termination action.
Email address sync: The integration will firstly search for a Primary Work Email address in Workday; if one is not set, it will search for a Work Email address to sync to Humanity. If that one is not set either, it will look for a Primary Home Email Address in Workday. If one is not set, it will finally look for a Home Email Address in Workday to sync to Humanity.
Phone Number sync: The integration will firstly search for a Primary Work Phone Number in Workday; if one is not set, it will look for a Work Phone Number in Workday. If that one is not set either, it will look for a Primary Home Phone Number in Workday. If one is not set, it will finally look for a Home Phone Number in Workday to sync to Humanity.
The integration currently doesn’t support the syncing of a Preferred Name (First and Last Name) from Workday to Humanity.
If a worker has two last names - Last Name and Secondary Last Name (i.e. Father's Family Name and Mother's Family Name), the integration will only sync the Last Name (i.e. Father's Family Name). At the moment, the Secondary Last Name (i.e. Mother's Family Name) will not be synced.
The Worker’s Work/Home Phone Number has to have at least 7 digits in order to be synced from Workday to Humanity.
Integration will synchronize Employee’s (Worker’s) assigned time zone if it is set in Workday as User’s time zone or Location time zone (time zone of the user's associated location).
Integration won’t synchronize Employee’s (Worker’s) assigned time zone if it is set in Workday as Tenant time zone. In order to handle this case, you would need to set Humanity’s master account time zone to the same time zone as your Workday’s tenant time zone. This will ensure that the user has the same time zone across both systems.
If Contingent Worker’s termination day in Workday is set on a certain date, he/she will be disabled in Humanity the day after.
Employee ID / Contingent Worker ID is visible in Humanity in Staff > Employee Profile > Edit Details as a value of the Employee ID field.
Once synced, Contingent Worker ID is formatted in Humanity as an alphanumeric value with a dash (i.e. 12345-C).
Time Off and Leave of Absence Data Synchronization
The Time Off (TO) and/or Leave of Absence (LOA) data that will be synced from Workday to Humanity includes:
Time Off and/or Leave of Absence type
Approved Time Off and/or Leave of Absence requests
The integration will recognize and sync data upon the following actions:
Approved TO and/or LOA request created in Workday
Approved TO and/or LOA request updated in Workday
Approved TO and/or LOA request deleted/removed/cancelled/rescinded in Workday
After TO and LOA sync is activated, the initial sync will import all changes made to TO and/or LOA requests which have been approved/rescinded 3 months in the past and 3 months in future counting from the date of the current sync runtime (i.e. if the current sync is running from January 1st, 2018, it will import all changes that occurred in the period from October 1st, 2017 to March 31st, 2018).
Each next sync will import only the changes that occurred between the last sync end and the next sync start time.
Leave Of Absence and/or Time Off sync activation can be activated only when setting up the Employee Sync configuration for the first time. Once the Leave Of Absence and/or Time Off sync has been activated, it cannot be deactivated afterward.
Important Notes
Synced, approved TO and/or LOA requests will be visible in the Humanity’s Dashboard “On Leave” widget, Leave module (Upcoming Time Off, Leave Balance), Schedule module (Schedule Overview, Leave Schedule, Staff Availability) and Staff module (within employee profile in the Leave section), Reports Module (Vacations, Vacation Summary reports).
TO and/or LOA request types in Workday may be in both hourly or daily units. All LOA requests and daily TO requests will be synced to Humanity as full-day requests. Approved hourly TO requests will be synced to Humanity so that the start and end hour of the TO request are shown (for example, 07/01/2020 8:45 am – 07/01/2020 11:15 am).
If an employee takes an hourly TO request (i.e. 3 hours on Thursday), that employee will be shown in the Leave Schedule as being unavailable for the whole day. The Manager will be able to see how many hours the employee is actually unavailable by pulling the “Vacation Summary” Report (in the Humanity Reports module). The information will be available in the “Comments” column.
For an accurate entitled TO and/or LOA days/hours amount, please reference Workday as the primary source of truth for TO and LOA data. This information will not be synced to Humanity. In Humanity, “Entitled Leave Days” for each synced TO and/or LOA type will be set to 365/366 days by default.
Overlapping TO and/or LOA requests created in Workday will not be synced. If there is one approved TO or LOA request in Workday, which is synced to Humanity for the date and time for which another TO or LOA request is approved in Workday, that second TO or LOA request will exist in Workday but won’t be synced to Humanity.
Schedule Data Synchronization
The schedule data that will be synced from Humanity to Workday includes:
Shift Start Time
Shift End Time
Shift User ID (representing the relation between the shift and user on that shift)
User ID
The integration will recognize and sync data from Humanity to Workday upon the following actions:
Shift for an employee is created and published in Humanity
Shift for an employee is updated/edited and published in Humanity
Published shift for an employee is deleted in Humanity
Important Notes
The integration will sync only published shifts. Unpublished shifts will not appear in Workday.
If an employee is set as “OnCall” for a shift or shifts, the integration will sync that/those shift(s) only if the “OnCall management” setting is turned on (Settings > ShiftPlanning).
Synced shifts will be visible in My Team's Schedule (manager view), My Schedule and View Schedule for Worker reports available in Workday’s Time Tracking module.
All synced shifts will have a Start Time and End Time in the worker’s (employee’s) assigned time zone synchronized from Workday to Humanity.
If the Worker’s (Employee’s) assigned time zone in Workday is the tenant time zone, all synced shifts for that worker will have the Start Time and End Time in the time zone which is set in the Humanity master account.
If the Worker (Employee) is terminated in Workday, he/she will be unassigned from all future shifts in Humanity starting from the effective date of the termination. All those future shifts will be removed from Workday.
If the Worker (Employee) is unassigned from some Job Profile in Workday, he/she will be unassigned from all future shifts in Humanity starting from the effective date of the Job Profile unassignment. All those future shifts will be removed from Workday.
Cover shift, created in Humanity, for Position which is not assigned to Worker (Employee), will be synced to Workday only if:
Job Profile Sync from Workday to Humanity is not activated
Worker (Employee) has only one Job Profile assigned in Workday.
Integration Requirements
To activate Humanity’s integration with Workday and enable data synchronization, a certain set of requirements related to the Humanity and Workday systems must be fulfilled.
Humanity Application Requirements
The integration user must have an active Humanity account with administrator access.
The Group Accounts Platform (GAP) module must be activated. Please contact your Humanity representative for details.
Within each account of your GAP structure (navigate to Group Accounts module > Manage Accounts > select specific account), the “Child of [account name]” setting will be automatically set when integrating to the proper account name and must not be changed.
Humanity’s master account Time Zone (Settings > Account > Timezone) must be set to the same time zone as your Workday’s tenant time zone. If you need assistance in matching time zones between Workday and Humanity, please contact Humanity Support (support@humanity.com).
In order to sync the time off and/or leave of absence data, the following settings must be in place:
Leave settings ( Settings > Leave and Availability) must be set to the values shown in the following screenshot.
The “deduct weekends from leave requests” setting under “advanced settings” for the leave module ('settings' > 'leave and availability') has to be set to deduct weekends, but also work days, if necessary. See the screenshot below.
In order to sync Schedule, the following settings, in Settings > Shiftplanning (Advanced), must be in place:
The “Use the Draft/Publish schedule method” setting must be turned on
The “Enable Shift Acknowledgment” setting must be turned off
Note: If the setting ‘Use the Draft/Publish schedule method’ is ON, the integration will not sync the shifts until they are published. If the setting ‘Use the Draft/Publish schedule method’ is OFF, all created shifts are automatically published and are therefore automatically synced in Workday.
Workday Application Requirements
The Integration System User and Integration Security Group for Integration System User have to be configured in Workday.
Create an Integration Security Group following these steps:
Run the “Create Security Group” task in Workday
Select the “Integration System Security Group (Unconstrained)”
Enter a Name (i.e. Humanity Integration Security Group)
Click OK
To grant the Security Group access to the domains required by the integration, follow these steps for each domain:
Access the “View Domain” report and find the required domain.
As a related action on the domain, select Domain > Edit Security Policy Permissions.
Add the previously created Security Group to the “Integration Permissions” and select Get and Put.
Access the “Activate Pending Security Policy Changes” task and activate the changes that you made in Step 3.
The Domains required by the integration can be found in the following documents:
Humanity-Workday Integration Security - domains for Authentication, Employee, organization structure and Schedule sync
Humanity-Workday RaaS Integration Security - domains for Time Off and Leave of Absence sync
Contact your Humanity representative in order to obtain these documents.
Check if a security policy for domain Process: Ad Hoc Schedule Processing is active following these steps:
Access the ‘View domain’ report.
Enter the ‘Process: Ad Hoc Schedule Processing’ for the domain name.
Click on the related action -> ‘Domain’ -> ‘View Security Policy’.
Security Policy should be active.
If the Security policy isn't activated then activate is by:
Click on the security policy related Action -> ‘Domain Security Policy’ -> ‘Enable’.
Access the ‘Activate Pending Security Policy Changes’ task and active the changes that you made.
Create an Integration System User following these steps:
Run the “Create Integration System User” task in Workday
Enter a User Name (i.e. Humanity Integration System User) and a Password
Keep the Session Timeout Minutes default value of 0 to prevent session expiration
Click OK
On the related actions on the created System User, select Security Profile > Assign Integration System Security Groups.
At the Integration System Security Group to Assign prompt, select the security group that you previously created.
Access the “Maintain Password Rules” task and add the integration system user to the “System Users exempt from password expiration” field.
Notes:
An expired session can cause the integration to time out before it successfully completes.
Use the “View Security Group” task to open the newly created security group in Workday.
All Workers (Employees) whose data would be synchronized between the two systems must be in the specific organization Hierarchy of the selected Organization Hierarchy type (Company/Cost Center/Location/Region Hierarchy) in Workday for which the integration will be activated. (i.e. the Company Hierarchy is selected as the type and XYZ Inc. Company Hierarchy is selected as the specific organization of the Company Hierarchy type).
The Default Time Entry Code assigned to the worker must have the Entry Method set as In/Out Only in order for the Schedule of that user to be synced from Humanity to Workday and to be visible in Workday.
As a precondition for Employee sync activation please make sure that each employee under your Workday account has Legal First Name, Legal Last Name, (Primary) Work Email and Hire Date defined - in order for these data to be synchronized to Humanity.
All Workers (Employees) whose data will be synchronized between two systems must be sitting in specific Organization Hierarchy of the selected Organization Hierarchy type (Company/Cost Center/Location/Region Hierarchy) in Workday for which integration will be activated. (i.e. Company Hierarchy is selected as the type and XYZ Inc. Company Hierarchy is selected as a specific organization of Company Hierarchy type).
The precondition for the Time Off sync activation is the creation of a custom report (RaaS - Report as a Service) in the Workday tenant - Time Off Report. This Report presents all changes related to Time Off requests which occur in Workday and which will be synced to Humanity, such as the creation, updating or deletion/removal of approved Time Off requests.
The precondition for Leave of Absence sync activation is the creation of two custom reports in your Workday tenant:
Leave of Absence Report - presents creation and update of approved Leave of Absence requests which occur in Workday and are synced to Humanity.
Deleted Leave of Absence Report - presents deletion/removal/cancellation/rescinding of approved Leave of Absence requests which occur in Workday and are synced to Humanity.
For obtaining definitions and instructions to generate each report (Time Off, Leave of Absence and Deleted Leave of Absence) please contact Humanity Support (support@humanity.com).
Integration Setup Instructions
Integration Activation (Authentication)
Log in to your Humanity account and click on the Settings gear in the upper right corner.
Choose the “Integrations” module listed under the “Integration” section on the left side panel.
Choose the Workday integration from the Integrations main page
4. On the next page, click the “Activate” button.
5. A sidebar will appear and you will be asked to fill in the following company information, then click the “Authorize” button:
a. Workday Integration User username@tenant name
b. Workday Integration User password
c. Workday Human Resources URL (WSDL)
d. Workday Time Tracking URL (WSDL)
e. Workday Integrations URL (WSDL)
6. Authentication between the two apps will be completed and the integration will be activated.
To locate Human Resources/Time Tracking/Integrations URL (WSDL):
Run the “Public Web Services” report
Find the desired web service in the “Web Service” column
In its related actions, go to Web Service > View WSDL
In the launched webpage, find the URL (WSDL) which is the value of ‘address location’
Each URL (WSDL) needs to have the Web Service version. The oldest supported Web Service version is v31.2.
Important Notes
If the “Integrations” module is not listed, please contact Humanity Support (support@humanity.com).
Any changes made to the login credentials or security setup of the Integration user (the user who activated the integration) will result in integration deactivation.
Any changes made to the Workday tenant Human Resources URL (WSDL), Time Tracking URL (WSDL) or Integrations URL (WSDL) will result in integration deactivation.
Employee Sync Activation
Before you enable the Employee sync via the Humanity Workday integration page, please make sure that each employee within your Workday account has the following defined: Legal First Name, Legal Last Name, Primary Work Email, and Start Date.
When the above-mentioned data is in place, you can proceed with the Employee sync activation according to the following steps:
In the Workday integration page, go to the Sync Details section, find Workday > Humanity Employee Sync, and expand the Show More dropdown.
Choose the Organization Hierarchy Type from the drop-down menu (for example, Location Hierarchy – as we chose in our example).
3. Choose the preferred mapping of Workday’s Company/ Cost Center/ Location/ Region to Humanity’s Account or Location.
4. Enter the Workday ID (WID) of the previously selected organization Hierarchy Type.
5. Enter the Organization Type WID.
6. Enter the WID of the specific Top-Level Organization in the selected organization Hierarchy.
7. [OPTIONAL & RECOMMENDED] Use the toggle to enable Position Sync.
8. Choose the preferred mapping of Workday’s Job Profiles/ Business Titles to Humanity Positions.
9. [OPTIONAL] Use the toggle to enable Sync Workday Wages to Humanity Wages.
10. [OPTIONAL] Enter the URL (WSDL) of Wages custom report into the “Wages Report URL” input field.
11. [OPTIONAL] Use the toggle to enable Sync Workday Certifications to Humanity Skills.
12. [OPTIONAL] Enter the URL (WSDL) of Certifications custom report into the Certifications Report URL input field.
13. [OPTIONAL] Use the toggle to enable Sync Workday Employee Fields to Humanity Custom Fields.
14. [OPTIONAL] Select preferred Employee Field(s)
15. [OPTIONAL] Click Show Filter.
16. [OPTIONAL] Turn on Include Contingent Workers.
17. [OPTIONAL] Enter the Pay Rate Name(s) and Pay Rate WID(s).
18. [OPTIONAL] Click Get Job Families.
19. [OPTIONAL] Select preferred Job Family(ies)
20. [OPTIONAL] Click Get Job Categories.
21. [OPTIONAL] Select preferred Job Category(ies)
22. Click Start Sync.
23. The Employee sync is now activated and the initial employee data sync will begin immediately.
24. You will receive an email notification upon the initial sync’s successful completion (applicable only if your Humanity admin account email is verified).
To locate the required Workday IDs in your Workday tenant:
Company/Cost Center/Location/Regional Hierarchy Type WID and Company/Cost Center/Location/Region Type WID
Run the “Organization Types” report
Find the desired Hierarchy Type (i.e. Company Hierarchy) and Organization Type (i.e. Company) in the “Organization Type Name” column
In the corresponding row of the “Related Tasks” column, go to Integration IDs > View IDs > Workday ID
Company/Cost Center/Location/Regional Hierarchy Top Level Organization WID
Using the “Search” feature, find the desired Organization Hierarchy (i.e. XYZ Inc. Company Hierarchy)
In its related actions, go to Integration IDs > View IDs > Workday ID
Important Notes
Organization Hierarchy Type, Organization Hierarchy Type WID, Organization Type WID, and Organization Hierarchy Top Level WID must all be defined in order for the Employee sync to be activated. Once defined, those values cannot be changed.
Organization Hierarchy Type WID, Organization Type WID, and Organization Hierarchy Top Level WID define the specific Organization Hierarchy, within the selected Organization Hierarchy type for which all data synchronization will apply.
Filtering Employees by Pay Rate is optional and can be applied only when setting up the Employee Sync configuration for the first time.
To apply the Pay Rate filter, both the Pay Rate Name and Pay Rate WID must be defined. Once defined, those values can’t be changed and the filter can’t be disabled.
If the Pay Rate filter is not enabled, all Employees in the selected Organization Hierarchy will be synced.
The initial Employee sync may last more than 60 minutes. No changes can be made to the integration configuration while the sync is running.
Time Off and Leave of Absence Sync Activation
In order to enable the Time Off sync and/or Leave of Absence sync, the requirements from the “Integration Requirements” section must be fulfilled.
Once activated, the Leave Of Absence and/or Time Off sync(s) cannot be deactivated.
Time Off sync activation steps:
Click on the “Show More” for Time Off sync, located in the Workday integration page “Sync Details” section.
2. Enter the URL (WSDL) of Time Off custom report into the “Time Off Report URL” input field.
3. Click “Start Sync”.
4. The Time Off sync is activated and the initial Time Off sync will begin once the next scheduled Employee sync has been completed.
Leave of Absence sync activation steps:
Click on the “Show More” for Leave of Absence sync, located in the Workday integration page “Sync Details” section.
2. Enter the URL (WSDL) of the Leave of Absence custom report into the “Leave of Absence Report URL” input field.
3. Enter the URL (WSDL) of the Deleted Leave of Absence custom report into the “Deleted Leave of Absence Report URL” input field.
4. Click “Start Sync”.
5. The Leave of Absence sync is activated and the initial Leave of Absence sync will begin once the next scheduled Employee sync has been completed.
To locate the required Report URLs (WSDLs):
Find the previously generated report (Time Off, Leave of Absence or Deleted Leave of Absence)
In the reports’ related actions, go to Web Service > View URLs > Workday XML > WSDL
Right-click on WSDL and select “Copy URL”
To locate Pay Rate Type Name and Pay Rate Type WID:
Run ‘View Pay Rate Types’ report
Select desired Pay Rate Type (i.e. Hourly) and click OK
Value of ‘Pay Type Name’ is Pay Rate Type Name that you need
Click on Pay Rate Type’s related actions, go to Integration IDs > View IDs > Workday ID
Value of Workday ID is the Pay Rate Type WID that you need
Important Notes
In order to activate the time off sync, the time off report URL must be defined.
In order to activate the leave of absence sync, the leave of absence Report URL and deleted leave of absence report URL must be defined.
Once defined, the report URLs’ values can’t be changed and the Leave Of Absence and/or Time Off sync(s) can’t be deactivated.
If the employee sync is deactivated and later reactivated, the previous leave Of Absence and/or Time Off sync configurations will remain the same as they were before the Employee sync was deactivated.
Time off and/or leave of absence requests (for Time Off and/or Leave of Absence types synced from Workday to Humanity – i.e. Workday - Vacation) must not be requested/approved in Humanity.
Upon Time Off (TO) and/or Leave of Absence (LOA) sync activation, the following settings will be automatically set and must not be changed in order for the TO and/or LOA sync(s) to work properly:
The settings under the “Current Leave Types” section ( Settings > Leave and Availability) will be set to the values shown in the following screenshot. These settings apply only to TO and/or LOA types synced from Workday to Humanity (i.e. Workday - Vacation).
Schedule Sync Activation
In order to enable the Schedule sync, the Employee data sync needs to be enabled first.
To enable the Schedule sync:
Click “Start Sync” button located in the Workday integration page “Sync Details” section.
2. The Schedule sync is activated and the initial Schedule sync will begin once the next scheduled Employee sync has been completed.
If you have any further queries, please don't hesitate to contact us at support@humanity.com.
Frequently Asked Questions
What will happen if I create, delete or change employee details in Humanity - i.e. employee’s time zone, phone number, first name, last name, etc.?
A: You should only create, delete or update this type of employee information in Workday because Workday is the single point of truth for employee data. Data entered/changed in Humanity won’t be picked up by Integration and synced to Workday, and will be overridden by data from Workday with next scheduled sync.
Is it required that each employee synced from Workday to Humanity has an email address set in Workday?
A: It isn’t required, but it is recommended. Providing an email address in Workday will allow users to receive various notifications from Humanity or instructions for account activation, password reset, etc.
How can I access multiple Humanity accounts if I need to schedule employees in those accounts?
A: You can use the admin user’s login credentials of the specific account you want to access. If multiple accounts you need to access have the same parent account in Humanity, you can use the Admin user’s login credentials of the parent account to access all it’s child accounts. To obtain each admin user’s login credentials please contact your admin user of the Humanity Master account.
Will the user’s permissions level set in Workday be reflected in Humanity?
A: Once all users in Workday have been synced to Humanity, they will have accounts will ‘employee’ permissions/access. Permission settings for your account have to be updated in the Humanity platform.
Will the manager of the specific company/cost center/location/regional hierarchy organization in Workday be synced to the corresponding Humanity account?
A: When users are synced to Humanity, their account represents his/her assigned Company/Cost Center/Location/Region in Workday. Users can’t be synced to Humanity accounts representing Company/Cost Center/Location/Region Hierarchy but only concrete Company/Cost Center/Location/Region in the hierarchy.
Once specific Company/Cost Center/Location/Regional Hierarchy organization in Workday is synced to the corresponding Humanity account, which user will be Administrator of that Humanity account?
A: Generic user named ‘admin’ will be the administrator of that Humanity account. This user is not synced from Workday, it is created by integration itself.
Will the integration sync moving of the employee from specific Company/Cost Center/Location/Region organization to specific Company/Cost Center/Location/Regional Hierarchy and vice versa?
A: No, integration will sync only moving of employees between the two Companies, Cost Centers, Locations or Regions (i.e. from Company 1 to Company 2, from Location X to Location Y, etc.). Therefore sync of moving the employees from specific organization to organization hierarchy (i.e. from Company X to Company Hierarchy XYZ), or between two organization hierarchies (i.e. from Company Hierarchy XYZ to Company Hierarchy ABC ) is not supported.
Will the Employee (Worker) be synced from Workday to Humanity if his/her email address is already taken by the other user in Humanity?
A: Yes, that Employee will be synced and his/her email address in Humanity will be saved as an original email address with added ‘+’ and random alphanumeric string in front of the ‘@’ symbol (i.e., if the original email is workday.user@domain.com, in Humanity, will be saved as workday.user+sh6vri580ck08wo@domain.com).
If the Employee has two different Job Profiles in two different Cost Centers/ Companies/ Locations/ Regions in Workday, how will that be reflected in Humanity?
A: If the chosen mapping of Workday’s Cost Center/ Company/ Location/ Region to Humanity is ‘Account’, then the employee will have only one Job Profile synced to Humanity - the Primary one. If the chosen mapping of Workday’s Cost Center/ Company/ Location/ Region to Humanity is ‘Location’, then the employee will have two different Job Profiles in two different Locations in Humanity. Humanity Location represents Workday Cost Center/ Company/ Location/ Region.