Service Directory > v29.2 > Staffing

 

Web Service: Staffing (v29.2)

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. 
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 
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_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_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_Periods_For_Workers Return Employees Probation Periods 
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_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. 
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. 
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_Citizenship_Status Adds or updates citizenship status. 
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_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 
Swap_Positions Swap positions between ~employees~ or contingent ~workers~. Uses the Position Swap business process and creates the Change Job events on each ~worker~. 
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.