Service Directory > v31.2 > Payroll_FRA > Import_Withholding_Tax_Rates
 

Operation: Import_Withholding_Tax_Rates

This public web service operation is designed to bulk add ~Worker~ Withholding Tax Rates data from external systems into Workday


@ - 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_Withholding_Tax_Rates_Request

Import Withholding Tax Rates Request
 
Parameter name Type/Value Cardinality Description Validations
@version string [0..1] Web Service version  
SIREN  string  [1..1]  SIREN   
Effective_Date  date  [0..1]  Effective Date   
Payee_Withholding_Tax_Data  Payee_Withholding_Tax_Data  [0..*]  Payee Withholding Tax Data 
Validation Description
Only numeric values are allowed for Tax Rate Identifier.   
Rate Identifier must not be filled when neutral rate applies.   
Enter a rate identifier.   
Rate must not be filled when neutral rate applies   
Unable to load rate for worker with NTT [NTT] (rate: [rate], tax rate identifier: [identifier]). Enter a worker with a valid Social Security Number. For workers with only a Numéro Technique Temporaire, access the Add Worker FRA Tax Elections task to manually add the rate.   
Unable to load rate for [worker text] with SSN [SSN] (rate: [rate], tax rate identifier: [identifier]). A withholding tax for the same date already exists. Access the Add Worker FRA Tax Elections task to manually add the rate for [workers].   
Unable to load rate for worker with Social Security Number [NIR] (rate: [rate], tax rate identifier: [identifier]). Enter a worker with a valid Social Security Number.   
 
Validation Description
Enter a valid company. The company with this SIREN [SIREN] is not valid.   
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
 

Payee_Withholding_Tax_Data

part of: Import_Withholding_Tax_Rates_Request
Payee Withholding Tax Data
 
Parameter name Type/Value Cardinality Description Validations
Employee_Social_Security_Number [Choice]   string  [1..1]  Employee Social Security Number   
Employee_Temporary_Number [Choice]   string  [1..1]  Employee Temporary Number (NTT)   
Neutral_Rate  boolean  [0..1]  Neutral Rate   
Rate  decimal (4, 2) >0   [0..1]  Rate   
Rate_Identifier  string (18)   [0..1]  Rate Identifier   
Validation Description
Only numeric values are allowed for Tax Rate Identifier.   
Rate Identifier must not be filled when neutral rate applies.   
Enter a rate identifier.   
Rate must not be filled when neutral rate applies   
Unable to load rate for worker with NTT [NTT] (rate: [rate], tax rate identifier: [identifier]). Enter a worker with a valid Social Security Number. For workers with only a Numéro Technique Temporaire, access the Add Worker FRA Tax Elections task to manually add the rate.   
Unable to load rate for [worker text] with SSN [SSN] (rate: [rate], tax rate identifier: [identifier]). A withholding tax for the same date already exists. Access the Add Worker FRA Tax Elections task to manually add the rate for [workers].   
Unable to load rate for worker with Social Security Number [NIR] (rate: [rate], tax rate identifier: [identifier]). Enter a worker with a valid Social Security Number.   
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
 

Web_Service_Background_Process_RuntimeReferenceEnumeration

part of: Web_Service_Background_Process_RuntimeObjectID
Base Type
string
top