Service Directory > v31.2 > Financial_Management > Put_Withholding_Tax_Code
 

Operation: Put_Withholding_Tax_Code

This service operation will add or update Withholding Tax Codes. Withholding Tax codes group together multiple Withholding Tax Rates. For example, you could create a Withholding Tax Code for San Francisco, and include city, state, and county sales tax rates. Tax Code data includes the Tax Code ID, Tax Code Name, and the Tax Rate.


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

Put Withholding Tax Code Request
 
Parameter name Type/Value Cardinality Description Validations
@version string [0..1] Web Service version  
@Add_Only  boolean  [1..1]  Add Only   
Withholding_Tax_Code_Reference  Tax_CodeObject  [0..1]  Withholding Tax Code Reference   
Withholding_Tax_Code_Data  Withholding_Tax_Code_Data  [1..1]  Withholding Tax Code Data 
Validation Description
Tax Rates cannot be assigned to a Tax Code with a different Country.  Tax Rates cannot be assigned to a Tax Code with a different Country. 
Cannot mix gross tax type tax rates with net or tax type tax rates in a Tax Code  Cannot mix gross tax type tax rates with net or tax type tax rates in a Tax Code 
Invoice and payment realization types tax rates cannot both be part of a tax code  Invoice and payment realization types tax rates cannot both be part of a tax code 
You can't change the Country because this tax code is already in use: [Tax Code].   
 
Validation Description
The Tax Code submitted is not Withholding.   
The Web Service is set to Add Only, but the Withholding Tax Code already exists.   
top
 

Response Element: Put_Withholding_Tax_Code_Response

Put Withholding Tax Code Response
 
Parameter name Type/Value Cardinality Description Validations
@version string [0..1] Web Service version  
Withholding_Tax_Code_Reference  Tax_CodeObject  [0..1]  Withholding Tax Code Reference   
top
 

Tax_CodeObject

part of: Put_Withholding_Tax_Code_Request, Put_Withholding_Tax_Code_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  Tax_CodeObjectID  [0..*]  Contains a unique identifier for an instance of an object.   
top
 

Tax_CodeObjectID

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

Withholding_Tax_Code_Data

part of: Put_Withholding_Tax_Code_Request
Withholding Tax Code Data
 
Parameter name Type/Value Cardinality Description Validations
ID  string  [0..1]  ID   
Tax_Code_Name  string  [1..1]  Tax Code Name 
Validation Description
Enter a unique Tax Code Name. [name] is already in use.   
 
Country_Reference  CountryObject  [1..1]  Country Reference   
Tax_Rate_Reference  Tax_RateObject  [1..*]  Tax Rate Reference   
Validation Description
Tax Rates cannot be assigned to a Tax Code with a different Country.  Tax Rates cannot be assigned to a Tax Code with a different Country. 
Cannot mix gross tax type tax rates with net or tax type tax rates in a Tax Code  Cannot mix gross tax type tax rates with net or tax type tax rates in a Tax Code 
Invoice and payment realization types tax rates cannot both be part of a tax code  Invoice and payment realization types tax rates cannot both be part of a tax code 
You can't change the Country because this tax code is already in use: [Tax Code].   
top
 

CountryObject

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

CountryObjectID

part of: CountryObject
Contains a unique identifier for an instance of an object.
 
Parameter name Type/Value Cardinality Description Validations
#text  string       
@type  WID, ISO_3166-1_Alpha-2_Code, ISO_3166-1_Alpha-3_Code, ISO_3166-1_Numeric-3_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".   
top
 

Tax_RateObject

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

Tax_RateObjectID

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

Tax_CodeReferenceEnumeration

part of: Tax_CodeObjectID
Base Type
string
top
 

CountryReferenceEnumeration

part of: CountryObjectID
Base Type
string
top
 

Tax_RateReferenceEnumeration

part of: Tax_RateObjectID
Base Type
string
top