Service Directory > v32.1 > Staffing

 

Web Service: Staffing (v32.1)

The Staffing Web Service operations expose Workday Human Capital Management Business Services and data. These services pertain to staffing transactions for both employees and contingent workers, such as bringing employees and contingent workers on board.

Version

Operations

Operation Description
Add_Additional_Job Adds an additional job for an existing employee. Uses the Add Additional Job business process. 
Add_Retiree_Status Changes the status of a previously terminated worker to retiree. Uses the Add Retiree Status business process. 
Assign_Organization Assigns company, cost center, region, fund, grant, business unit, program, and custom organizations configured for staffing usage to a staffing position. Uses the Change Organization Assignments for Worker business process. 
Assign_Organization_Roles DEPRECATED DEPRECATED: This web service operation is deprecated. Please use the Assign_Roles web service operation instead. If you do use this web service operation, note that all new and existing assignees must be specified as role assignees. Any existing role assignees that are not included in the set of role assignees will be removed. Later-dated role assignments will not be updated with new or removed assignees. 
Assign_Roles Assigns roles to assignees and uses the Assign Roles business process. You may specify a worker or position. If you specify a worker as the event target or an assignee to add and the worker has multiple positions as of the role assignment effective date, the international assignment (IA) position will take precedence over the worker's primary position. Specifying a worker with multiple positions as an assignee to remove will remove all the positions for that worker for that role assignment. 
Change_Job Perform a job change on an employee or contingent worker. Uses the Change Job business process. The types of changes include transfer, promotion, demotion, lateral moves and any other change of data on the job. 
Change_Organization_Assignments Assigns company, cost center, region, fund, grant, business unit, program, gift and custom organizations configured for staffing usage to a filled position or position restriction. Uses the Change Organization Assignments for Worker business process. This is to be used as a replacement for the web service Assign Organization. 
Change_Work_Space Assign Work Space Location to a Position. Uses the Change Work Space business process. 
Close_Position This operation will invoke the Business Process to Close a Position. 
Contract_Contingent_Worker Contracts an existing pre-hire into a contingent worker position or job. Uses the Contract Contingent Worker business process. Note: pre-hire was previously called applicant. However, the web service operation and its elements are not yet renamed, so that existing integrations continue to work. 
Create_Position Creates/opens a position for a supervisory organization using the position management staffing model. Uses the Create Position business process. There are several sub-operations within this operation. Existing positions cannot be re-loaded into the system. You must use the Edit Position Restrictions operation to change a created position. 
Delete_Worker_Document Deletes worker documents that aren’t associated with business process events. 
Edit_Employee_Contract_Additional_Data Allows updating of effective dated custom objects for an ~Employee~ Contract. When updating custom objects that allow multiple instances, data for existing instances must appear in the request, otherwise it will be removed. 
Edit_Hiring_Restrictions This operation will edit the hiring restrictions for a job management supervisory organization. 
Edit_Position Edits a filled position. Uses the Edit Position business process. 
Edit_Position_Restrictions Edits an existing position restriction. Uses the Edit Position Restrictions business process. 
Edit_Position_Restrictions_Additional_Data Allows updating of effective-dated custom objects for position restrictions. When updating custom objects that allow multiple instances, data for existing instances must appear in the request, otherwise it will be removed. 
Edit_Service_Dates Sets a worker's service dates. Uses the Edit Service Dates business process. 
Edit_Worker_Additional_Data Allows updating of effective dated custom objects for a Worker. When updating custom objects that allow multiple instances, data for existing instances must appear in the request, otherwise it will be removed. 
End_Additional_Job Ends an employee's additional job. Uses the End Additional Job business process. 
End_Contingent_Worker_Contract Ends a contingent worker's contract. Uses the End Contingent Worker Contract Business Process. 
End_International_Assignment End international assignment for an employee 
Freeze_Position Invokes the Business Process to Freeze a Position 
Full-Service_Equivalent_Non-Standard_Worker_Categories Enable full-service equivalent (FSE) Non-Standard worker categories in your tenant by entering their Workday ID. 
Get_Applicants Returns information for pre-hires specified in the request. If the request does not specify a pre-hire, this operation returns information for all pre-hires. Note: pre-hire was previously called applicant. However, the web service operation and its elements are not yet renamed, so that existing integrations continue to work. 
Get_Change_Government_IDs This public web service request gets government IDs for a worker. The response can be used as input to the web service request Change Government IDs. 
Get_Change_Legal_Name This public web service request gets the legal name for a worker. The response can be used as input to the web service request Change Legal Name. All response fields are secured to their specific granular domains. 
Get_Change_Licenses This public web service request gets licenses for a worker. The response can be used as input to the web service request Change Licenses. 
Get_Change_Other_IDs This public web service request gets custom IDs for a worker. The response can be used as input to the web service request Change Other IDs. 
Get_Change_Passports_and_Visas This public web service request gets passport and visas for a worker. The response can be used as input to the web service request Change Passports and Visas. 
Get_Change_Preferred_Name This public web service request gets preferred name for a worker. The response can be used as input to the web service request Change Preferred Name. All response fields are secured to their specific granular domains. 
Get_Citizenship_Statuses Returns citizenship status details for the requested status. If the request does not specify a citizenship status, the operations returns details for all citizenship statuses. 
Get_Collective_Agreements Retrieves all collective agreements specified in the request. 
Get_Job_Classification_Groups Returns job classification group data. 
Get_Job_Families Returns job family data. 
Get_Job_Family_Groups Returns job family and job family group data. 
Get_Maintain_Notice_Periods_For_Country Get the Notice Period Rules for a single or many countries. 
Get_Maintain_Probation_Periods_For_Country Get the Probation Period Rules for a single or many countries. 
Get_Notice_Period_Eligibility_Rules Get Notice Period Eligibility Rules Web Service Task. This task returns all of the Notice Period Eligibility Rules specified in the request 
Get_Notice_Periods Returns employer and employee notice periods for a notice period target 
Get_Organizations Returns organization information for a type of organization. If the request does not specify an organization, the operation returns information for all organizations. 
Get_Positions Returns information for position management positions. If a position is filled, identifies the worker filling the position. 
Get_Probation_Period_Eligibility_Rules Get Probation Period Eligibility Rules Web Service Task. This task returns all of the Probation Period Eligibility Rules specified in the request 
Get_Probation_Period_Outcomes Get the Probation Period Outcomes for one or more countries. 
Get_Probation_Periods_For_Workers Return Employees Probation Periods 
Get_Role_Assignments_For_Role_Assigners This web service returns role assignments (the combination of assignable role and role assignees) for the role assigner(s) specified in the request. You must specify at least 1 role assigner. Only explicitly assigned role assignees are returned. Default and inherited role assignees are not returned. Optional request parameters include Assignable Roles, Effective Date and Time Zone. When no value is specified for 'Assignable Roles', role assignments for all roles are returned. When at least one value is specified for 'Assignable Roles', role assignments for only the specified roles are returned. When no effective date is specified, role assignments as of the current date are returned. When an effective date is specified, role assignments in effect as of the specified effective date are returned. You cannot specify a time zone in the request unless the 'Role Assignment Time Zone Option' field in Tenant Setup - System has a value. When no time zone is specified, role assignments as of the effective date and Pacific Standard time (PST) are returned. When a time zone is specified, role assignments as of the effective date and the specified time zone are returned. The count in the response filter applies to the number of role assigners returned. For the supervisory organization assignable role linked to the Workday Role of 'Manager', only the single assignment manager role assignee is returned when this role has multiple role assignees. 
Get_Student_Employment_Eligibility_Data Gets data from Workday for the Verify Student Employment Eligibility business process, which is used to evaluate student employment eligibility in an external system. Not intended for EIB use. 
Get_Student_Employment_Eligibility_Rule_Set Get Student Employment Eligibility Rule Set Data 
Get_Student_Employment_Eligibility_Rules Get Student Employment Eligibility Rule Data 
Get_Worker_Documents Returns worker document data. 
Get_Workers Returns public and private information for specified workers. 
Hire_Employee Hires a pre-hire (new or existing) into an employee position, headcount, or job. Uses the Hire Employee business process. Note: pre-hire was previously called applicant. However, the web service operation and its elements are not yet renamed, so that existing integrations continue to work. 
Import_Applicant This high-volume web service task creates Applicant data. 
Import_Assign_Matrix_Organization Assign ~workers~ to matrix organizations. 
Import_Change_Job This high-volume web service task performs a job change on an employee or contingent worker using the Change Job business process. The types of changes include transfer, promotion, demotion, lateral moves and any other change of data on the job. 
Import_Contract_Contingent_Worker This high-volume web service task contracts contingent workers. 
Import_End_Contingent_Worker_Contract This high-volume web service task ends contingent worker contracts. 
Import_External_Student_Information High Volume Web Service task for creating or updating a large volume of External Student Records for new or existing Students. This task can create a new Student with Personal Information only, and a reference to a Worker can be provided to create a new Student Role for an existing Worker. If a Worker reference is provided, personal information (name, contact information, IDs, etc.) cannot be supplied. This task is only intended for use in tenants that do not have Workday Student. External Student Records should not be created in a tenant in which Workday Student has been implemented. 
Import_Hire_Employee This high-volume web service task hires employees. 
Import_Remove_Matrix_Organization Remove ~workers~ from matrix organizations. 
Import_Swap_Positions Swap positions between ~employees~ or ~contingent workers~. Uses the Position Swap business process and creates the Change Job events on each ~worker~. 
Import_Terminate_Employee This high-volume web service task terminates employees. 
Maintain_Employee_Contracts Adds or updates employee contracts. Uses the Maintain Employee Contracts business process. 
Move_Workers_By_Organization The following Organizations are valid for this Web Service: Company, Cost Center, Region, Custom Orgs that are Unique and are part of Change Organization Assignment, Supervisory Organizations (except Headcount Management). Job Management Supervisory Organizations must have Hiring Restrictions defined. If the Organization is Supervisory, Position Management Positions, Job Management Positions, Position Restrictions can be moved (except Position Restrictions (and the filled positions) that are overlapped). If the Organization is not Supervisory, Position Restrictions, Headcount Restrictions, and all filled positions of any staffing model can be moved. 
No_Show Performs a No Show on an employee 
Put_Applicant Adds a new pre-hire (or updates an existing pre-hire) with the information supplied in the request. Note: pre-hire was previously called applicant. However, the web service operation and its elements are not yet renamed, so that existing integrations continue to work. 
Put_Assign_Matrix_Organization Assign ~workers~ to matrix organizations. 
Put_Citizenship_Status Adds or updates citizenship status. 
Put_Collective_Agreement Adds or updates a collective agreement. 
Put_Dependent DEPRECATED DEPRECATED: Adds or updates a dependent 
Put_Edit_Notice_Periods_Event Adds or updates notice period details. Uses the Edit Notice Periods business process. 
Put_Hire_Event_Proposed_Worker_ID This web service imports a Worker ID which will override the Workday generated ID. 
Put_Job_Classification_Group Adds or updates a job classification group and/or job classifications. 
Put_Job_Family Adds or updates a job family. 
Put_Job_Family_Group Adds or updates a job family group. Also adds or removes a group's associated job families. 
Put_Maintain_Notice_Periods_for_Country Maintain the Notice Periods table for a single country. 
Put_Maintain_Probation_Periods_For_Country Maintain the Probation Periods table for a single country. 
Put_Notice_Period_Eligibility_Rule Adds or updates a notice period eligibility rule. 
Put_Probation_Period_Eligibility_Rule Adds, updates or delete a probation period eligibility rule. 
Put_Probation_Period_Outcomes Put Probation Period Outcomes for a single country. 
Put_Remove_Matrix_Organization Remove ~workers~ from matrix organizations. 
Put_Student_Employment_Eligibility_Rule Creates a new or updates an existing Student Employment Eligibility Rule to be used in Student Employment Eligibility Rule Sets. 
Put_Student_Employment_Eligibility_Rule_Set Creates a new or updates an existing Student Employment Eligibility Rule Set to be used in Eligibility Verification 
Put_Student_Employment_Eligibility_Status Updates employment eligibility status and related reasons on the Student Employment Eligibility event, based on results from an external system. Not intended for EIB use. 
Put_Worker_Document Adds or updates a worker document. The operation adds documents not associated with events and those documents are not secured by the events. 
Remove_Retiree_Status Removes the retirement status from a retired employee. Uses the Remove Retiree Status business process. 
Set_Hiring_Restrictions This operation will create the hiring restrictions for a job management supervisory organization. 
Start_International_Assignment Start international assignment for an employee 
Switch_Primary_Job This operation will invoke the business process to switch a workers primary job with one of their additional jobs. Uses the Switch Primary Job business process. 
Terminate_Employee Terminates an employee.