Service Directory > v31.2 > Financial_Management > Put_Transaction_Tax_Code
 

Operation: Put_Transaction_Tax_Code

This service operation will add or update Transaction Tax Codes. Transaction Tax Codes group together multiple tax rates. For example, you could create a 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_Tax_Code_Request

Element containing Tax Code reference for update and all Tax Code data items
 
Parameter name Type/Value Cardinality Description Validations
@version string [0..1] Web Service version  
@Add_Only  boolean  [1..1]  Add Only Flag. Indicates that the service is an add only, not an update.   
Tax_Code_Reference  Tax_CodeObject  [0..1]  Reference to an existing Tax Code for update only purposes   
Tax_Code_Data  Tax_Code_Data  [1..1]  Tax Code Data 
Validation Description
Tax Code Country needs to be the same as all the Tax Rate Countries that are associated with this Tax Code.   
You can't change the Country because this tax code is already in use: [Tax Code].   
Withholding Tax Rates cannot be added to Transaction Tax Code.   
Tax Code must be of type Transaction Tax Code.   
The maximum number of transaction tax rates is 6 for all transaction tax codes.  The maximum number of transaction tax rates is 6 for all transaction tax codes. 
 
Validation Description
The Web Service is set to Add Only; but the Tax Code already exists.   
Tax Code must be of type Transaction Tax Code.   
top
 

Response Element: Put_Tax_Code_Response

Element containing Put Tax Code Response Data
 
Parameter name Type/Value Cardinality Description Validations
@version string [0..1] Web Service version  
Tax_Code_Reference  Tax_CodeObject  [0..1]  This is the reference id value of the tax code. If this is blank, Workday will default in the default tax code from the invoice header if there is one. If the invoice line has a tax applicability value, Workday will validate that the invoice line also has a tax code.   
top
 

Tax_CodeObject

part of: Put_Tax_Code_Request, Put_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
 

Tax_Code_Data

part of: Put_Tax_Code_Request
Element containing all Tax Code data
 
Parameter name Type/Value Cardinality Description Validations
Tax_Code_ID  string  [0..1]  Tax Code ID. This is the Tax Code unique identifier   
Tax_Code_Name  string  [1..1]  Free form text field for a meaningful Tax Code Name 
Validation Description
Enter a unique Tax Code Name. [name] is already in use.  The Tax Code entered has already been used. 
 
Transaction_Tax_ID_Required  boolean  [0..1]  This indicator identifies that when this Tax Code is used within a transaction, the Company must have a Transaction Tax ID defined for the country associated with the Tax Code.   
Country_Reference  CountryObject  [1..1]  Reference to an existing Country   
Exempt [Choice]   boolean  [0..1]  Tax Exempt   
Tax_Rate_Reference  Tax_RateObject  [0..*]  Reference to an existing Tax Rate 
Validation Description
Tax Rate Reference is required if Tax Exempt is not true.  Tax Rate Reference is required if Tax Exempt is not true. 
 
Validation Description
Tax Code Country needs to be the same as all the Tax Rate Countries that are associated with this Tax Code.   
You can't change the Country because this tax code is already in use: [Tax Code].   
Withholding Tax Rates cannot be added to Transaction Tax Code.   
Tax Code must be of type Transaction Tax Code.   
The maximum number of transaction tax rates is 6 for all transaction tax codes.  The maximum number of transaction tax rates is 6 for all transaction tax codes. 
top
 

CountryObject

part of: 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: 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