Service Directory > v31.2 > Financial_Management > Put_1042-S_Income_Code
 

Operation: Put_1042-S_Income_Code

This web service allows you to add or update 1042-S Income Codes as well as Withholding Spend Categories or Hierarchies. Income Code for 1042-S data includes Withholding Spend Categories or Spend Category Hierarchies for all Income Codes, plus: Income Code, Description, Spend Categories or Spend Category Hierarchies.


@ - 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_1042-S_Income_Code_Request

Put 1042-S Income Code 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. If an existing instance is found and this flag is set there will be an error.   
Income_Code_for_1042-S_Reference  Income_Code_for_1042-SObject  [0..1]  Reference to an Existing 1042-S Income Code   
Income_Code_for_1042-S_Data  Income_Code_for_1042-S_Data  [0..1]  1042-S Income Code Data 
Validation Description
A Spend Category Hierarchy on this Income Code contains Spend Categories being used in another Income Code.   
 
Validation Description
Add Only is True but the reference ID is already in use. Verify that you are sending the correct ID - or set Add Only to false if you want to update the existing entry. ID: [ID] In Use on: [Used]   
top
 

Response Element: Put_1042-S_Income_Code_Response

Put 1042-S Income Code Response
 
Parameter name Type/Value Cardinality Description Validations
@version string [0..1] Web Service version  
Income_Code_for_1042-S_Reference  Income_Code_for_1042-SObject  [0..1]  Reference to the newly created or updated 1042-S Income Code.   
top
 

Income_Code_for_1042-SObject

part of: Put_1042-S_Income_Code_Request, Put_1042-S_Income_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  Income_Code_for_1042-SObjectID  [0..*]  Contains a unique identifier for an instance of an object.   
top
 

Income_Code_for_1042-SObjectID

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

Income_Code_for_1042-S_Data

part of: Put_1042-S_Income_Code_Request
1042-S Income Code Data
 
Parameter name Type/Value Cardinality Description Validations
Income_Code  string (2)   [0..1]  1042-S Income Code 
Validation Description
Income code must be two digits.   
 
Description  string  [0..1]  1042-S Income Code Description   
Spend_Categories_or_Hierarchies_Reference  Spend_Category_or_HierarchyObject  [0..*]  Spend Categories or Spend Category Hierarchies mapped for Spend to the 1042-S Income Code. 
Validation Description
A Spend Category selected is under a Spend Category Hierarchy also selected for this Income Code.   
A Spend Category for a Spend Category Hierarchy selected is used by an existing Income Code.   
A parent Spend Category Hierarchy for a Spend Category selected is used by an existing Income Code.   
A Spend Category selected is already used by an existing Income Code.   
A Spend Category Hierarchy selected is already used by an existing Income Code.   
Spend Categories or Hierarchies can't be simultaneously used for Income Code and Withholding Mapping.   
 
Federal_Withholding_Spend_Categories_or_Hierarchies_Reference  Spend_Category_or_HierarchyObject  [0..*]  Spend Categories or Spend Category Hierarchies mapped for Federal Withholding to the 1042-S Income Code. 
Validation Description
Spend Categories or Hierarchies may not be simultaneously mapped to State and Federal Withholding.   
 
State_Withholding_Spend_Categories_or_Hierarchies_Reference  Spend_Category_or_HierarchyObject  [0..*]  Spend Categories or Spend Category Hierarchies mapped for State Withholding to the 1042-S Income Code.   
Validation Description
A Spend Category Hierarchy on this Income Code contains Spend Categories being used in another Income Code.   
top
 

Spend_Category_or_HierarchyObject

part of: Income_Code_for_1042-S_Data, Income_Code_for_1042-S_Data, Income_Code_for_1042-S_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  Spend_Category_or_HierarchyObjectID  [0..*]  Contains a unique identifier for an instance of an object.   
top
 

Spend_Category_or_HierarchyObjectID

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

Income_Code_for_1042-SReferenceEnumeration

part of: Income_Code_for_1042-SObjectID
Base Type
string
top
 

Spend_Category_or_HierarchyReferenceEnumeration

part of: Spend_Category_or_HierarchyObjectID
Base Type
string
top