Service Directory > v32.1 > Revenue_Management > Put_Revenue_Allocation_Configuration
 

Operation: Put_Revenue_Allocation_Configuration

This service operation will add or update the Tenant's Revenue Allocation Configuration. Revenue Allocation Configuration Data includes Allocation in Summary, Default Revenue Allocation Configuration Line Data, and Override Revenue Allocation Configuration Line Data. Default Revenue Allocation Configuration Line Data includes Lower Range Percentage, Upper Range Percentage, Allocation Basis, and Fair Value Price List. Override Revenue Allocation Configuration Line Data contains Override Revenue Allocation Configuration ID, Override Revenue Allocation Configuration Line, Company, Fair Value Price List, Lower Range Percentage, Upper Range Percentage, Revenue Allocation Calculation Basis, and Override Revenue Allocation Configuration Line Details Data. Override Revenue Allocation Configuration Line Details Data contains Override Revenue Allocation Configuration Line Details ID, Override Revenue Allocation Configuration Line Details, Sales Item Group, Sales Item, Lower Range Percentage, Upper Range Percentage, and Allocation Basis.


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

Element containing all Revenue Allocation Configuration data items for either an update or delete of tenant Revenue Allocation Configuration.
 
Parameter name Type/Value Cardinality Description Validations
@version string [0..1] Web Service version  
@Add_Only  boolean  [1..1]  Add only.   
Revenue_Allocation_Configuration_Data  Revenue_Allocation_Configuration_Data  [1..1]  Element containing Revenue Allocation System Configuration Request for create and update and all Revenue Allocation Configuration data items.   
Validation Description
The web service is set to add only, but the Revenue Allocation System Configuration already exists.  The Web Service is set to Add Only; documents cannot be resubmitted. 
top
 

Response Element: Put_Revenue_Allocation_Configuration_Response

Revenue Allocation Configuration Response. Contains the WID reference to the updated Revenue Allocation Configuration.
 
Parameter name Type/Value Cardinality Description Validations
@version string [0..1] Web Service version  
Revenue_Allocation_Configuration_Reference  Revenue_Allocation_System_ConfigurationObject  [0..1]  Response Element for Put Revenue Allocation System Configuration Response.   
top
 

Revenue_Allocation_Configuration_Data

part of: Put_Revenue_Allocation_Configuration_Request
Element contains all data necessary to create or update a Revenue Allocation Configuration.
 
Parameter name Type/Value Cardinality Description Validations
Allocate_Revenue_at_Summary_and_Prorate_at_Line  boolean  [0..1]  Determines whether to Allocate in Summary.   
Default_Revenue_Allocation_Configuration_Line_Data  Default_Revenue_Allocation_Configuration_Line_Data  [0..1]  Defines the Default Revenue Allocation Configuration Line   
Do_Not_Auto_Allocate_Revenue  boolean  [0..1]  When you select the Do Not Auto Allocate Revenue check box, you must manually recalculate the revenue allocation when running MEA.   
Override_Revenue_Allocation_Configuration_Line_Data  Override_Revenue_Allocation_Configuration_Line_Data  [0..*]  Defines the Revenue Allocation Configuration Lines that will override the Default Revenue Allocation Configuration Line.   
top
 

Default_Revenue_Allocation_Configuration_Line_Data

part of: Revenue_Allocation_Configuration_Data
Element contains all data necessary to create or update a Revenue Allocation Configuration.
 
Parameter name Type/Value Cardinality Description Validations
Lower_Range_Percentage  decimal (10, 4) >0   [0..1]  Lower Range Percentage for Default Revenue Allocation Configuration Line Data   
Upper_Range_Percentage  decimal (10, 4) >0   [0..1]  Upper Range Percentage for Default Revenue Allocation Configuration Line Data.   
Allocation_Basis_Reference  Revenue_Allocation_Calculation_BasisObject  [0..1]  Revenue Allocation Calculation Basis for Default Revenue Allocation Configuration Line. This field is a required field. 
Validation Description
Enter an Allocation Basis.   
 
Fair_Value_Price_List_Reference  Sales_Item_Fair_Value_Price_ListObject  [0..1]  Fair Value Price List for Default Revenue Allocation Configuration Line Data   
top
 

Revenue_Allocation_Calculation_BasisObject

part of: Override_Revenue_Allocation_Configuration_Line_Details_Data, Override_Revenue_Allocation_Configuration_Line_Data, Default_Revenue_Allocation_Configuration_Line_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  Revenue_Allocation_Calculation_BasisObjectID  [0..*]  Contains a unique identifier for an instance of an object.   
top
 

Revenue_Allocation_Calculation_BasisObjectID

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

Sales_Item_Fair_Value_Price_ListObject

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

Sales_Item_Fair_Value_Price_ListObjectID

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

Override_Revenue_Allocation_Configuration_Line_Data

part of: Revenue_Allocation_Configuration_Data
Element representing an Override Revenue Allocation Configuration Line.
 
Parameter name Type/Value Cardinality Description Validations
Override_Revenue_Allocation_Configuration_ID  string  [0..1]  Reference ID for Override Revenue Allocation Configuration Line.   
Override_Revenue_Allocation_Configuration_Reference  Revenue_Allocation_Configuration_LineObject  [0..1]  Reference to Override Revenue Allocation Configuration Line. 
Validation Description
Cannot reference the Default Revenue Allocation Configuration Line from Override Revenue Allocation Configuration Line Data.   
 
Company_Reference  CompanyObject  [0..1]  Company for Override Revenue Allocation Configuration Line. This field is required on the instance and must be unique across all Override Revenue Allocation Configuration Lines for the Revenue Allocation System Configuration. 
Validation Description
Enter a unique Company for the Revenue Allocation Configuration Line.   
Enter a Company.   
 
Fair_Value_Price_List_Reference  Sales_Item_Fair_Value_Price_ListObject  [0..1]  Fair Value Price List for Override Revenue Allocation Configuration Line. This field is required on the instance. 
Validation Description
Enter a Fair Value Price List.   
 
Lower_Range_Percentage  decimal (10, 4) >0   [0..1]  Lower Range Percentage for the Override Revenue Allocation Configuration Line. This field is required on the instance. 
Validation Description
Enter a Lower Range Percentage.   
 
Upper_Range_Percentage  decimal (10, 4) >0   [0..1]  Upper Range Percentage for Override Revenue Allocation Configuration Line. This field is required on the instance. 
Validation Description
Enter an Upper Range Percentage.   
 
Allocation_Basis_Reference  Revenue_Allocation_Calculation_BasisObject  [0..1]  Allocation Basis for Override Revenue Allocation Configuration Line. This field is required on the instance. 
Validation Description
Enter an Allocation Basis.   
 
Line_Override_Defaults_Data  Override_Revenue_Allocation_Configuration_Line_Details_Data  [0..*]  Revenue Allocation Configuration Line Override Details for Override Revenue Allocation Configuration Line.   
top
 

Revenue_Allocation_Configuration_LineObject

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

Revenue_Allocation_Configuration_LineObjectID

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

CompanyObject

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

CompanyObjectID

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

Override_Revenue_Allocation_Configuration_Line_Details_Data

part of: Override_Revenue_Allocation_Configuration_Line_Data
Element representing Revenue Allocation Configuration Line Override Details.
 
Parameter name Type/Value Cardinality Description Validations
Revenue_Allocation_Configuration_Line_Override_Details_ID  string  [0..1]  Revenue Allocation Configuration Line Override Details Reference ID.   
Revenue_Allocation_Configuration_Line_Override_Details_Reference  Revenue_Allocation_Configuration_Line_Override_DetailsObject  [0..1]  Revenue Allocation Configuration Line Override Details Reference. 
Validation Description
Enter a unique Sales Item Group for the Revenue Allocation Configuration Line Override Details.   
Enter either a Sales Item or a Sales Item Group for the Revenue Allocation Configuration Line Override Details.   
Enter a unique Sales Item for the Revenue Allocation Configuration Line Override Details.   
 
Sales_Item_Group_Reference  Sales_Item_GroupObject  [0..1]  Sales Item Group for Revenue Allocation Configuration Line Override Details. This field must be unique for all Revenue Allocation Configuration Line Override Details associated with the same Override Revenue Allocation Configuration Line. This field is also required on the instance. 
Validation Description
Select a sales item group that is part of the associated fair value price list for that row.   
 
Sales_Item_Reference  Sales_ItemObject  [0..1]  Sales Item for Revenue Allocation Configuration Line Override Details. This field must be unique across all Revenue Allocation Configuration Line Override Details associated with the same Override Revenue Allocation Configuration Line. This field is also required on the instance. 
Validation Description
Select a sales item that is part of the associated fair value price list for that row.   
 
Lower_Range_Percentage  decimal (10, 4) >0   [0..1]  Lower Range Percentage for Revenue Allocation Configuration Line Override Details. This field is required on the instance. 
Validation Description
Enter a Lower Range Percentage.   
 
Upper_Range_Percentage  decimal (10, 4) >0   [0..1]  Upper Range Percentage for Revenue Allocation Configuration Line Override Details. This field is required on the instance. 
Validation Description
Enter an Upper Range Percentage.   
 
Allocation_Basis_Reference  Revenue_Allocation_Calculation_BasisObject  [0..1]  Allocation Basis for Revenue Allocation Configuration Line Override Details. This field is required on the instance. 
Validation Description
Enter a Revenue Allocation Calculation Basis for the Revenue Allocation Configuration Line Override Details.   
 
top
 

Revenue_Allocation_Configuration_Line_Override_DetailsObject

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

Revenue_Allocation_Configuration_Line_Override_DetailsObjectID

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

Sales_Item_GroupObject

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

Sales_Item_GroupObjectID

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

Sales_ItemObject

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

Sales_ItemObjectID

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

Revenue_Allocation_System_ConfigurationObject

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

Revenue_Allocation_System_ConfigurationObjectID

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

Revenue_Allocation_Calculation_BasisReferenceEnumeration

part of: Revenue_Allocation_Calculation_BasisObjectID
Base Type
string
top
 

Sales_Item_Fair_Value_Price_ListReferenceEnumeration

part of: Sales_Item_Fair_Value_Price_ListObjectID
Base Type
string
top
 

Revenue_Allocation_Configuration_LineReferenceEnumeration

part of: Revenue_Allocation_Configuration_LineObjectID
Base Type
string
top
 

CompanyReferenceEnumeration

part of: CompanyObjectID
Base Type
string
top
 

Revenue_Allocation_Configuration_Line_Override_DetailsReferenceEnumeration

part of: Revenue_Allocation_Configuration_Line_Override_DetailsObjectID
Base Type
string
top
 

Sales_Item_GroupReferenceEnumeration

part of: Sales_Item_GroupObjectID
Base Type
string
top
 

Sales_ItemReferenceEnumeration

part of: Sales_ItemObjectID
Base Type
string
top
 

Revenue_Allocation_System_ConfigurationReferenceEnumeration

part of: Revenue_Allocation_System_ConfigurationObjectID
Base Type
string
top