Service Directory > v32.1 > Payroll > Put_Payroll_Federal_W-4_Tax_Election
 

Operation: Put_Payroll_Federal_W-4_Tax_Election

This web service operation is designed to put worker federal W-4 tax election data.


@ - 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: Put_Payroll_Federal_W-4_Tax_Election_Request

Put Payroll Payee W-4 Request Element
 
Parameter name Type/Value Cardinality Description Validations
@version string [0..1] Web Service version  
Payroll_Federal_W-4_Tax_Election_Data  Payroll_Federal_W-4_Tax_Election_Data  [1..1]  Element to hold all of the Data to Put or Get for a W-4 
Validation Description
Marital Status must be valid for Payroll Tax Authority.   
Exempt from NRA Additional Amount may only be True if Nonresident Alien is also True.   
Assign the worker to a pay group before adding tax elections.   
The Company specified is not valid for the Worker.   
 
top
 

Response Element: Put_Payroll_Federal_W-4_Tax_Election_Response

Put Payroll Payee W-4 Response Element
 
Parameter name Type/Value Cardinality Description Validations
@version string [0..1] Web Service version  
Payroll_Payee_W-4_Reference  Payroll_Payee_W-4Object  [0..1]  The Payroll Payee W-4 instance that is created as of the Put   
Put_Payroll_Federal_W-4_Tax_Election_Response_Data_Element  Put_Payroll_Federal_W-4_Tax_Election_Response_Data  [0..1]  The data that should be displayed for the instance of the W-4 that is created as of the Put   
top
 

Payroll_Federal_W-4_Tax_Election_Data

part of: Put_Payroll_Federal_W-4_Tax_Election_Request
Element to hold all of the Data to Put or Get for a W-4
 
Parameter name Type/Value Cardinality Description Validations
Worker_Reference  WorkerObject  [1..1]  Worker the W-4 is for   
Effective_as_of  date  [1..1]  The Effective date of the W-4   
Company_Reference  CompanyObject  [1..1]  The Company the W-4 is for   
Marital_Status_Reference  Payroll_Withholding_StatusObject  [0..1]  The Marital Status of the Worker that the W-4 is for   
Number_of_Allowances  decimal (5, 0) >0   [0..1]  The Number of Allowances on the W-4   
Additional_Amount  decimal (8, 2) >0   [0..1]  Additional Amount on the W-4   
Exempt  boolean  [0..1]  Exempt Indicator on the W-4   
Nonresident_Alien  boolean  [0..1]  Nonresident Alien Indicator on the W-4   
Exempt_from_NRA_Additional_Amount  boolean  [0..1]  New attribute, Exempt from NRA Additional Amount, added in W19. If worker is a Nonresident Alien, use this attribute to indicate whether the worker is subject to NRA Additional Amount.   
Lock_In_Letter  boolean  [0..1]  Lock in Letter Indicator on the W-4   
No_Wage_No_Tax  boolean  [0..1]  No Wage/No Tax Indicator on the W-4   
Validation Description
Marital Status must be valid for Payroll Tax Authority.   
Exempt from NRA Additional Amount may only be True if Nonresident Alien is also True.   
Assign the worker to a pay group before adding tax elections.   
The Company specified is not valid for the Worker.   
top
 

WorkerObject

part of: Payroll_Federal_W-4_Tax_Election_Data, Put_Payroll_Federal_W-4_Tax_Election_Response_Data
 
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  WorkerObjectID  [0..*]  Contains a unique identifier for an instance of an object.   
top
 

WorkerObjectID

part of: WorkerObject
Contains a unique identifier for an instance of an object.
 
Parameter name Type/Value Cardinality Description Validations
#text  string       
@type  WID, Contingent_Worker_ID, 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
 

CompanyObject

part of: Payroll_Federal_W-4_Tax_Election_Data, Put_Payroll_Federal_W-4_Tax_Election_Response_Data
 
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  CompanyObjectID  [0..*]  Contains a unique identifier for an instance of an object.   
top
 

CompanyObjectID

part of: CompanyObject
Contains a unique identifier for an instance of an object.
 
Parameter name Type/Value Cardinality Description Validations
#text  string       
@type  WID, Company_Reference_ID, Organization_Reference_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
 

Payroll_Withholding_StatusObject

part of: Payroll_Federal_W-4_Tax_Election_Data
 
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_Withholding_StatusObjectID  [0..*]  Contains a unique identifier for an instance of an object.   
top
 

Payroll_Withholding_StatusObjectID

part of: Payroll_Withholding_StatusObject
Contains a unique identifier for an instance of an object.
 
Parameter name Type/Value Cardinality Description Validations
#text  string       
@type  WID, Payroll_Marital_Status_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
 

Payroll_Payee_W-4Object

part of: Put_Payroll_Federal_W-4_Tax_Election_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  Payroll_Payee_W-4ObjectID  [0..*]  Contains a unique identifier for an instance of an object.   
top
 

Payroll_Payee_W-4ObjectID

part of: Payroll_Payee_W-4Object
Contains a unique identifier for an instance of an object.
 
Parameter name Type/Value Cardinality Description Validations
#text  string       
@type  WID, Payroll_Payee_Tax_Data_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
 

Put_Payroll_Federal_W-4_Tax_Election_Response_Data

part of: Put_Payroll_Federal_W-4_Tax_Election_Response
The data that should be displayed for the W-4 that was made as of the Put
 
Parameter name Type/Value Cardinality Description Validations
Worker_Reference  WorkerObject  [1..1]  The Worker Reference for the Worker that the W-4 was created for   
Effective_as_of  date  [1..1]  The Effective Date of the W-4 that was created as of the Put   
Company_for_Payroll_Payee_Tax_Data_Reference  CompanyObject  [1..1]  The Company Reference for the Company that the W-4 was created for   
top
 

WorkerReferenceEnumeration

part of: WorkerObjectID
Base Type
string
top
 

CompanyReferenceEnumeration

part of: CompanyObjectID
Base Type
string
top
 

Payroll_Withholding_StatusReferenceEnumeration

part of: Payroll_Withholding_StatusObjectID
Base Type
string
top
 

Payroll_Payee_W-4ReferenceEnumeration

part of: Payroll_Payee_W-4ObjectID
Base Type
string
top