Service Directory > v31.2 > Payroll > Import_Maintain_Payroll_Reporting_Codes_for_Workers
 

Operation: Import_Maintain_Payroll_Reporting_Codes_for_Workers

High Volume Web Service task for updating the payroll reporting codes for a large number of existing workers. This task can accept multiple elements, each of which takes in a worker, an effective date, and payroll reporting code(s). The web service then launches an Event that updates the relationship between the worker and their effective dated payroll reporting codes.


@ - A parameter name with this symbol denotes an XML attribute within the document instead of an XML element.


Contents

 

Web Service

 

Request

 

Response

 

Element(s)

 

Request Element: Import_Maintain_Payroll_Reporting_Codes_for_Worker_Request

Header element of the Import Maintain Payroll Reporting Codes for Worker Events web service task.
 
Parameter name Type/Value Cardinality Description Validations
@version string [0..1] Web Service version  
Worker_Payroll_Reporting_Code_Data  Maintain_Worker_Payroll_Reporting_Codes_Data__HV_  [0..*]  Header element of the Import Maintain Payroll Reporting Codes for Worker Events web service task. 
Validation Description
Position must be filled to be edited by this web service.   
Position [position] is not valid for this worker [worker] as of the effective date.   
 
top
 

Response Element: Put_Import_Process_Response

Put Import Process Response element
 
Parameter name Type/Value Cardinality Description Validations
@version string [0..1] Web Service version  
Import_Process_Reference  Web_Service_Background_Process_RuntimeObject  [0..1]  Web Service Background Process Runtime element   
Header_Instance_Reference  InstanceObject  [0..1]  Header Instance element   
top
 

Maintain_Worker_Payroll_Reporting_Codes_Data__HV_

part of: Import_Maintain_Payroll_Reporting_Codes_for_Worker_Request
Element containing singular Worker/Position, Effective Date, and Payroll Reporting Codes.
 
Parameter name Type/Value Cardinality Description Validations
Employee_Reference  EmployeeObject  [0..1]  Reference to the Employee whose position will have the payroll reporting codes edited. If the user has access to only one Position for the worker, that position will default into the position reference. If you choose to supply the Position Reference, the Employee Reference will default in from the position. 
Validation Description
Worker is required. If you entered a Position, then it is not filled by a valid worker.   
 
Position_Reference  Position_ElementObject  [0..1]  Reference to the Position having payroll reporting codes maintained. You can enter just the employee reference if the employee has only one position that you can edit. If the employee has more than one accessible position, you must enter the specific position reference here. 
Validation Description
Position must be submitted. If you submitted only a Worker reference, then this worker has more than one position you have access to. If you submitted a Position Management Position ID, and more than one worker is filling that position (it has been overlapped) - please submit the worker reference as well so we can identify which worker to process.   
Position submitted is not filled as of the effective date.   
 
Effective_Date  date  [1..1]  Date the changes to the payroll reporting codes will be effective. 
Validation Description
The effective date cannot be earlier than the hire date for this position: [hire date].   
The payroll reporting codes cannot be changed for position [position] because there is another pending payroll reporting codes event for this position effective on the same day.   
 
Payroll_Reporting_Code_Data  Maintain_Worker_Payroll_Reporting_Codes_Event_Data__HV_  [0..*]  Element containing a single Payroll Reporting Code Entry. 
Validation Description
The payroll reporting code ([code]) has a type ([type]) in common with one of the other payroll reporting code entries. Only one code per type is allowed.   
A Wyoming Corporate Officer Type payroll reporting code is needed when C - Corporate Officer (Wyoming Class Code Indicator) is selected.   
The C - Corporate Officer (Wyoming Class Code Indicator) code is needed when [code] is selected.   
 
Validation Description
Position must be filled to be edited by this web service.   
Position [position] is not valid for this worker [worker] as of the effective date.   
top
 

EmployeeObject

part of: Maintain_Worker_Payroll_Reporting_Codes_Data__HV_
 
Parameter name Type/Value Cardinality Description Validations
@Descriptor  string  [1..1]  Display information used to describe an instance of an object. This 'optional' information is for outbound descriptive purposes only and is not processed on inbound Workday Web Services requests.   
ID  EmployeeObjectID  [0..*]  Contains a unique identifier for an instance of an object.   
top
 

EmployeeObjectID

part of: EmployeeObject
Contains a unique identifier for an instance of an object.
 
Parameter name Type/Value Cardinality Description Validations
#text  string       
@type  WID, Employee_ID  [1..1]  The unique identifier type. Each "ID" for an instance of an object contains a type and a value. A single instance of an object can have multiple "ID" but only a single "ID" per "type".   
top
 

Position_ElementObject

part of: Maintain_Worker_Payroll_Reporting_Codes_Data__HV_
 
Parameter name Type/Value Cardinality Description Validations
@Descriptor  string  [1..1]  Display information used to describe an instance of an object. This 'optional' information is for outbound descriptive purposes only and is not processed on inbound Workday Web Services requests.   
ID  Position_ElementObjectID  [0..*]  Contains a unique identifier for an instance of an object.   
top
 

Position_ElementObjectID

part of: Position_ElementObject
Contains a unique identifier for an instance of an object.
 
Parameter name Type/Value Cardinality Description Validations
#text  string       
@type  WID, Position_ID  [1..1]  The unique identifier type. Each "ID" for an instance of an object contains a type and a value. A single instance of an object can have multiple "ID" but only a single "ID" per "type".   
top
 

Maintain_Worker_Payroll_Reporting_Codes_Event_Data__HV_

part of: Maintain_Worker_Payroll_Reporting_Codes_Data__HV_
Element containing a single Payroll Reporting Code Entry.
 
Parameter name Type/Value Cardinality Description Validations
Payroll_Reporting_Code_Reference  Payroll_Reporting_Code__All_Object  [0..1]  Reference for the payroll reporting codes. All payroll reporting codes the position should have as of the effective date need to be entered. The entry from the web service will replace any existing payroll reporting codes the position has. Sending an empty element will result in all payroll reporting codes being deleted for the position. Only code for a payroll reporting type can be entered. 
Validation Description
The type for the payroll reporting code [code] is no longer active.   
The payroll reporting code [code] is no longer active.   
 
Validation Description
The payroll reporting code ([code]) has a type ([type]) in common with one of the other payroll reporting code entries. Only one code per type is allowed.   
A Wyoming Corporate Officer Type payroll reporting code is needed when C - Corporate Officer (Wyoming Class Code Indicator) is selected.   
The C - Corporate Officer (Wyoming Class Code Indicator) code is needed when [code] is selected.   
top
 

Payroll_Reporting_Code__All_Object

part of: Maintain_Worker_Payroll_Reporting_Codes_Event_Data__HV_
 
Parameter name Type/Value Cardinality Description Validations
@Descriptor  string  [1..1]  Display information used to describe an instance of an object. This 'optional' information is for outbound descriptive purposes only and is not processed on inbound Workday Web Services requests.   
ID  Payroll_Reporting_Code__All_ObjectID  [0..*]  Contains a unique identifier for an instance of an object.   
top
 

Payroll_Reporting_Code__All_ObjectID

part of: Payroll_Reporting_Code__All_Object
Contains a unique identifier for an instance of an object.
 
Parameter name Type/Value Cardinality Description Validations
#text  string       
@type  WID, Payroll_Reporting_Code, Workday_Payroll_Reporting_Code  [1..1]  The unique identifier type. Each "ID" for an instance of an object contains a type and a value. A single instance of an object can have multiple "ID" but only a single "ID" per "type".   
@parent_id  string  [1..1]  Contains a unique identifier for an instance of a parent object   
@parent_type  WID, Payroll_Reporting_Type_Code  [1..1]  The unique identifier type of a parent object   
top
 

Web_Service_Background_Process_RuntimeObject

part of: Put_Import_Process_Response
 
Parameter name Type/Value Cardinality Description Validations
@Descriptor  string  [1..1]  Display information used to describe an instance of an object. This 'optional' information is for outbound descriptive purposes only and is not processed on inbound Workday Web Services requests.   
ID  Web_Service_Background_Process_RuntimeObjectID  [0..*]  Contains a unique identifier for an instance of an object.   
top
 

Web_Service_Background_Process_RuntimeObjectID

part of: Web_Service_Background_Process_RuntimeObject
Contains a unique identifier for an instance of an object.
 
Parameter name Type/Value Cardinality Description Validations
#text  string       
@type  WID, Background_Process_Instance_ID  [1..1]  The unique identifier type. Each "ID" for an instance of an object contains a type and a value. A single instance of an object can have multiple "ID" but only a single "ID" per "type".   
top
 

InstanceObject

part of: Put_Import_Process_Response
 
Parameter name Type/Value Cardinality Description Validations
@Descriptor  string  [1..1]     
ID  Instance_ID  [0..*]     
top
 

Instance_ID

part of: InstanceObject
 
Parameter name Type/Value Cardinality Description Validations
#text  string       
@parent_id  string  [1..1]     
@parent_type  string  [1..1]     
@type  string  [1..1]     
top
 

EmployeeReferenceEnumeration

part of: EmployeeObjectID
Base Type
string
top
 

Position_ElementReferenceEnumeration

part of: Position_ElementObjectID
Base Type
string
top
 

Payroll_Reporting_Code__All_ReferenceEnumeration

part of: Payroll_Reporting_Code__All_ObjectID
Base Type
string
top
 

Base Type
string

top
 

Web_Service_Background_Process_RuntimeReferenceEnumeration

part of: Web_Service_Background_Process_RuntimeObjectID
Base Type
string
top