Service Directory > v31.2 > Financial_Management > Put_Withholding_Tax_Exemption
 

Operation: Put_Withholding_Tax_Exemption

This service operation will add or update Withholding Tax Exemptions.


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

Put Withholding Tax Exemption Request
 
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.   
Withholding_Tax_Exemption_Reference  Withholding_Tax_ExemptionObject  [0..1]  The reference to the Withholding Tax Exemption Object being updated. For new Withholding Tax Exemption Objects, this will not exist   
Withholding_Tax_Exemption_Data  Withholding_Tax_Exemption_Data  [0..1]  Element containing data for the Withholding Tax Exemption Object. 
Validation Description
You can't change the Supplier, Tax Rate, Effective Tax Percentage, Start Date, or End Date because this tax exemption is already in use: [Tax Exemption].   
 
Validation Description
The web service is set to add only, but the Withholding Tax Exemption already exists.   
top
 

Response Element: Put_Withholding_Tax_Exemption_Response

Put Withholding Tax Exemption Response
 
Parameter name Type/Value Cardinality Description Validations
@version string [0..1] Web Service version  
Withholding_Tax_Exemption_Reference  Withholding_Tax_ExemptionObject  [0..1]  Reference to the Withholding Tax Exemption.   
top
 

Withholding_Tax_ExemptionObject

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

Withholding_Tax_ExemptionObjectID

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

part of: Put_Withholding_Tax_Exemption_Request
Put Withholding Tax Exemption Request
 
Parameter name Type/Value Cardinality Description Validations
Withholding_Tax_Exemption_ID  string  [0..1]  Withholding Tax Exemption Reference ID   
Supplier_Reference  Resource_ProviderObject  [1..1]  Supplier for the Withholding Tax Exemption. 
Validation Description
Enter a valid Supplier.   
 
Tax_Exemption_Name  string  [1..1]  Withholding Tax Exemption Name.   
Tax_Exemption_Number  string  [0..1]  Withholding Tax Exemption Number.   
Affected_Tax_Rate_Reference  Tax_RateObject  [0..1]  Withholding Tax Rate for which the Withholding Tax Exemption applies to. 
Validation Description
Enter a Withholding Tax Rate that does not have Progressive Rate Threshholds.   
Withholding Tax Exemptions don't apply on Withholding Tax Rates with a realization point of Customer Invoice Self Withholding.   
 
Effective_Tax_Percentage  decimal (7, 4) >0   [0..1]  The effective tax percentage that will override the Withholding Tax Rate after the Withholding Tax Exemption is applied. 
Validation Description
Enter an Effective Tax Rate Percentage after exemption that is between 0% and 100%.   
 
Tax_Exemption_Start_Date  date  [0..1]  Date on which the Withholding Tax Exemption begins effect. 
Validation Description
Enter an Exemption Start Date that is before the Exemption End Date.   
You have more than 1 active withholding tax exemption for the same withholding tax rate(s); enter only 1 withholding tax exemption for a specified effective date range.   
 
Tax_Exemption_End_Date  date  [0..1]  Date for which the Withholding Tax Exemption stops effect. 
Validation Description
Enter an Exemption Start Date that is before the Exemption End Date.   
You have more than 1 active withholding tax exemption for the same withholding tax rate(s); enter only 1 withholding tax exemption for a specified effective date range.   
 
Inactive  boolean  [0..1]  Inactive Tax Exemption denotes whether or not the Withholding Tax Exemption is inactive.   
Validation Description
You can't change the Supplier, Tax Rate, Effective Tax Percentage, Start Date, or End Date because this tax exemption is already in use: [Tax Exemption].   
top
 

Resource_ProviderObject

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

Resource_ProviderObjectID

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

Tax_RateObject

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

Withholding_Tax_ExemptionReferenceEnumeration

part of: Withholding_Tax_ExemptionObjectID
Base Type
string
top
 

Resource_ProviderReferenceEnumeration

part of: Resource_ProviderObjectID
Base Type
string
top
 

Tax_RateReferenceEnumeration

part of: Tax_RateObjectID
Base Type
string
top