Get a Pricing Rule
get
/rest/v19/pricingSetup/rules/{ruleVariableName}
Use this endpoint to retrieve the specified pricing rule.
Request
Path Parameters
Query Parameters
-
expand: string
When this parameter is provided, the specified children are included in the resource payload (instead of just a link). More than one child can be specified using comma as a separator. Example: ?expand=ruleModels,customerSpecificConditions. To include all the children and grandchildren, specify the value of this query parameter to be "all".
-
fields: string
This parameter filters the resource attributes. Only the specified attributes are returned, which means that if no attributes are specified, all attributes are returned.
Response
Supported Media Types
- application/json
200 Response
Success
Root Schema : PricingRule
Type:
Show Source
object-
active:
boolean()
Title:
ActiveIndicates if the rule is active. -
anyProductCount:
integer()
Title:
Linked Any Product CountRead Only:trueThe count of Any Product items linked to this rule. -
bomCount:
integer()
Title:
Linked BOM CountRead Only:trueThe count of BOM items linked to this rule. -
createdBy:
Created By
Title:
Created ByRead Only:trueThe details of the user who created the record. -
customerSpecificConditions:
Customer Specific Conditions
Title:
Customer Specific ConditionsRead Only:trueThe collection of Customer specific conditions for the Pricing Rule.Note this is a child resource. -
dateAdded:
string(yyyy-MM-dd'T'HH:mm:ss.SSS'Z')
Title:
Date AddedRead Only:trueCreation date of the Pricing Rule. -
dateModified:
string(yyyy-MM-dd'T'HH:mm:ss.SSS'Z')
Title:
Date ModifiedRead Only:trueLast modified date of the Pricing Rule. -
description:
string()
Title:
DescriptionThe description of the Pricing Rule. -
editRestriction:
string()
Title:
Edit RestrictionRead Only:trueAllowed Values:[ "UNRESTRICTED", "ONLY_REORDERABLE", "RESTRICTED" ]Pricing Edit Restriction. -
endDate:
string()
Title:
End DateThe date after which the Pricing Rule will no longer be applicable. -
groupAccessEnabled:
boolean()
Title:
Group Access EnabledRead Only:trueIndicates whether the user has access to the groups segment -
lastModifiedBy:
Last Modified By
Title:
Last Modified ByRead Only:trueThe details of the user who modified the record. -
links:
array Links
Title:
LinksRead Only:trueThe link relations associated with the resource instance. -
name:
string()
Title:
NameThe name of the Pricing Rule. -
orderNumber:
integer()
Title:
Order NumberThe position(starting from 1) in a ordered list of Pricing Rules. -
productCount:
integer()
Title:
Linked Products CountRead Only:trueThe count of products linked to this rule. -
ruleConditionType:
string()
Title:
Rule Condition TypeAllowed Values:[ "alwaysTrue", "customerSpecific", "simple", "advanced" ]The condition type of the Pricing Rule. -
ruleModelCount:
integer()
Title:
Linked Price Models CountRead Only:trueThe count of price models linked to this rule. -
ruleModels:
Linked Pricing Models
Title:
Linked Pricing ModelsRead Only:trueThe collection of linked Price Models. Note this is a child resource. -
segmentLevelAccessType:
string()
Title:
Segment-level Access TypeRead Only:trueSegment-level Access Type -
simpleConditions:
Simple Conditions
Title:
Simple ConditionsThe collection of simple conditions for the Pricing Rule of simple type. This is optional for other condition type. -
startDate:
string()
Title:
Start DateThe date from which the Pricing Rule will be applicable. -
variableName:
string()
Title:
Variable NameThe Unique Variable Name of the Pricing Rule.
Nested Schema : Created By
Title:
Created ByRead Only:
trueThe details of the user who created the record.
Match All
The details of the user who created the record.
Show Source
Nested Schema : Customer Specific Conditions
Title:
Customer Specific ConditionsRead Only:
trueThe collection of Customer specific conditions for the Pricing Rule.Note this is a child resource.
Match All
The collection of Customer specific conditions for the Pricing Rule.Note this is a child resource.
Show Source
Nested Schema : Last Modified By
Title:
Last Modified ByRead Only:
trueThe details of the user who modified the record.
Match All
The details of the user who modified the record.
Show Source
Nested Schema : Links
Type:
arrayTitle:
LinksRead Only:
trueThe link relations associated with the resource instance.
Show Source
Nested Schema : Linked Pricing Models
Title:
Linked Pricing ModelsRead Only:
trueThe collection of linked Price Models. Note this is a child resource.
Match All
The collection of linked Price Models. Note this is a child resource.
Show Source
Nested Schema : Simple Conditions
Title:
Simple ConditionsThe collection of simple conditions for the Pricing Rule of simple type. This is optional for other condition type.
Match All
The collection of simple conditions for the Pricing Rule of simple type. This is optional for other condition type.
Show Source
Nested Schema : UserDetails
Type:
Show Source
object-
emailId:
string()
Title:
Email IdEmail Id of the user -
firstName:
string()
Title:
First NameFirst Name of the user -
lastName:
string()
Title:
Last NameLast Name of the user
Nested Schema : PricingResourceCollection_PricingCustomerSpecificCondition
Type:
Show Source
object-
count:
integer()
Title:
CountRead Only:trueThe number of resource instances returned in the current range. -
createdBy:
Created By
Title:
Created ByRead Only:trueThe details of the user who created the record. -
groupAccessEnabled:
boolean()
Title:
Group Access EnabledRead Only:trueIndicates whether the user has access to the groups segment -
hasMore:
boolean()
Title:
HasMoreRead Only:trueIndicates whether more resources are available on the server than the subset returned in the response. If the value is true, then there are more resources to retrieve from the server. The default value is false. -
items:
array items
-
lastModifiedBy:
Last Modified By
Title:
Last Modified ByRead Only:trueThe details of the user who modified the record. -
limit:
integer()
Title:
LimitRead Only:trueThe actual paging size used by the server. -
links:
array Links
Title:
LinksRead Only:trueThe link relations associated with the resource instance. -
offset:
integer()
Title:
OffSetRead Only:trueThe offset value used in the current page. -
segmentLevelAccessType:
string()
Title:
Segment-level Access TypeRead Only:trueSegment-level Access Type -
totalResults:
integer()
Title:
Total ResultsRead Only:trueCaptures the total count of the resource instances, which not only includes the instances in the current range, but all instances on the server that satisfy the request.
Nested Schema : Created By
Title:
Created ByRead Only:
trueThe details of the user who created the record.
Match All
The details of the user who created the record.
Show Source
Nested Schema : Last Modified By
Title:
Last Modified ByRead Only:
trueThe details of the user who modified the record.
Match All
The details of the user who modified the record.
Show Source
Nested Schema : Links
Type:
arrayTitle:
LinksRead Only:
trueThe link relations associated with the resource instance.
Show Source
Nested Schema : PricingCustomerSpecificCondition
Type:
Show Source
object-
active:
boolean()
Title:
ActiveIndicates whether the condition is active. -
createdBy:
Created By
Title:
Created ByRead Only:trueThe details of the user who created the record. -
customerId:
string()
Title:
Customer IDThe unique identifier of the customer.This should match the Account Lookup's Id field. -
customerName:
string()
Title:
Customer NameRead Only:trueThe name of the customer.This should match the value from Account Lookup's lookupCode -
dateAdded:
string(yyyy-MM-dd'T'HH:mm:ss.SSS'Z')
Title:
Date AddedRead Only:trueCreation date of the Pricing Rule. -
dateModified:
string(yyyy-MM-dd'T'HH:mm:ss.SSS'Z')
Title:
Date ModifiedRead Only:trueLast modified date of the Pricing Rule. -
endDate:
string(yyyy-MM-dd'T'HH:mm:ss.SSS'Z')
Title:
End DateThe date after which the condition will become inactive. -
groupAccessEnabled:
boolean()
Title:
Group Access EnabledRead Only:trueIndicates whether the user has access to the groups segment -
id:
integer()
Title:
IdRead Only:trueThe unique identifier of the customer specific condition. -
lastModifiedBy:
Last Modified By
Title:
Last Modified ByRead Only:trueThe details of the user who modified the record. -
links:
array Links
Title:
LinksRead Only:trueThe link relations associated with the resource instance. -
segmentLevelAccessType:
string()
Title:
Segment-level Access TypeRead Only:trueSegment-level Access Type -
startDate:
string(yyyy-MM-dd'T'HH:mm:ss.SSS'Z')
Title:
Start DateThe date after which the condition will become active.
Nested Schema : Created By
Title:
Created ByRead Only:
trueThe details of the user who created the record.
Match All
The details of the user who created the record.
Show Source
Nested Schema : Last Modified By
Title:
Last Modified ByRead Only:
trueThe details of the user who modified the record.
Match All
The details of the user who modified the record.
Show Source
Nested Schema : Links
Type:
arrayTitle:
LinksRead Only:
trueThe link relations associated with the resource instance.
Show Source
Nested Schema : PricingResourceCollection_PricingRuleModel
Type:
Show Source
object-
count:
integer()
Title:
CountRead Only:trueThe number of resource instances returned in the current range. -
createdBy:
Created By
Title:
Created ByRead Only:trueThe details of the user who created the record. -
groupAccessEnabled:
boolean()
Title:
Group Access EnabledRead Only:trueIndicates whether the user has access to the groups segment -
hasMore:
boolean()
Title:
HasMoreRead Only:trueIndicates whether more resources are available on the server than the subset returned in the response. If the value is true, then there are more resources to retrieve from the server. The default value is false. -
items:
array items
-
lastModifiedBy:
Last Modified By
Title:
Last Modified ByRead Only:trueThe details of the user who modified the record. -
limit:
integer()
Title:
LimitRead Only:trueThe actual paging size used by the server. -
links:
array Links
Title:
LinksRead Only:trueThe link relations associated with the resource instance. -
offset:
integer()
Title:
OffSetRead Only:trueThe offset value used in the current page. -
segmentLevelAccessType:
string()
Title:
Segment-level Access TypeRead Only:trueSegment-level Access Type -
totalResults:
integer()
Title:
Total ResultsRead Only:trueCaptures the total count of the resource instances, which not only includes the instances in the current range, but all instances on the server that satisfy the request.
Nested Schema : Created By
Title:
Created ByRead Only:
trueThe details of the user who created the record.
Match All
The details of the user who created the record.
Show Source
Nested Schema : Last Modified By
Title:
Last Modified ByRead Only:
trueThe details of the user who modified the record.
Match All
The details of the user who modified the record.
Show Source
Nested Schema : Links
Type:
arrayTitle:
LinksRead Only:
trueThe link relations associated with the resource instance.
Show Source
Nested Schema : PricingRuleModel
Type:
Show Source
object-
adjustmentType:
string()
Title:
The Adjustment Type of pricing modelRead Only:trueAllowed Values:[ "discountPercent", "discountAmount", "markupPercent", "markupAmount" ]Adjustment Type. -
createdBy:
Created By
Title:
Created ByRead Only:trueThe details of the user who created the record. -
dateAdded:
string(yyyy-MM-dd'T'HH:mm:ss.SSS'Z')
Title:
Date AddedRead Only:trueCreation Date of the Pricing Model to Pricing Rule link. -
dateModified:
string(yyyy-MM-dd'T'HH:mm:ss.SSS'Z')
Title:
Date ModifiedRead Only:trueLast modified date of the Pricing Model to Pricing Rule link. -
description:
string()
Title:
DescriptionRead Only:trueThe description of the linked Pricing Model. -
dynamicPricingType:
string()
Title:
Dynamic Pricing TypeRead Only:trueAllowed Values:[ "static", "advanced", "volume", "tiered", "rateCard", "attributeBasedCharge" ]The type of dynamic pricing applied by the linked Pricing Model. -
editRestriction:
string()
Title:
Edit RestrictionRead Only:trueAllowed Values:[ "UNRESTRICTED", "ONLY_REORDERABLE", "RESTRICTED" ]Pricing Edit Restriction. -
groupAccessEnabled:
boolean()
Title:
Group Access EnabledRead Only:trueIndicates whether the user has access to the groups segment -
hasBomItem:
boolean()
Title:
Has BOM ItemRead Only:trueIndicates whether this model has prices defined for BOM Items. -
hasChargeSupport:
boolean()
Title:
Has Charge SupportRead Only:trueIndicates whether this model has charge support. -
lastModifiedBy:
Last Modified By
Title:
Last Modified ByRead Only:trueThe details of the user who modified the record. -
links:
array Links
Title:
LinksRead Only:trueThe link relations associated with the resource instance. -
listType:
string()
Title:
The List Type for the pricing modelRead Only:trueAllowed Values:[ "priceList", "discountList", "advanced", "markupList", "advancedByTemplate" ]List Type. -
name:
string()
Title:
NameRead Only:trueThe name of the linked Pricing Model. -
orderNumber:
integer()
Title:
Order NumberThe position(starting from 1) of the linked Pricing Model within the Pricing Rule. -
ruleCount:
integer()
Title:
Linked Pricing Rules CountRead Only:trueThe count of pricing rules linked to this model. -
segmentLevelAccessType:
string()
Title:
Segment-level Access TypeRead Only:trueSegment-level Access Type -
valueType:
string()
Title:
Value TypeRead Only:trueAllowed Values:[ "absolutePrice", "discountAmount", "discountPercent", "markupAmount", "markupPercent", "advancedByTemplate" ]The type of discount applied by the linked Pricing Model. -
variableName:
string()
Title:
Variable NameThe Unique Variable Name of the linked Pricing Model.
Nested Schema : Created By
Title:
Created ByRead Only:
trueThe details of the user who created the record.
Match All
The details of the user who created the record.
Show Source
Nested Schema : Last Modified By
Title:
Last Modified ByRead Only:
trueThe details of the user who modified the record.
Match All
The details of the user who modified the record.
Show Source
Nested Schema : Links
Type:
arrayTitle:
LinksRead Only:
trueThe link relations associated with the resource instance.
Show Source
Nested Schema : SimpleConditions
Type:
Show Source
object-
ruleExpression:
string()
Title:
Rule ExpressionThe rule expression that will be evaluated. -
simpleConditionRows:
array Simple Condition Rows
Title:
Simple Condition RowsA list of Simple Condition Rows.
Nested Schema : Simple Condition Rows
Type:
arrayTitle:
Simple Condition RowsA list of Simple Condition Rows.
Show Source
Nested Schema : SimpleConditionRow
Type:
Show Source
object-
displayName:
string()
Title:
Display NameThe display name of the Simple Condition Row. -
index:
integer()
Title:
IndexThe index (starting from 1) of the Simple Condition Row. -
operator:
string()
Title:
OperatorAllowed Values:[ "NONE", "EQUAL_TO", "NOT_EQUAL_TO", "GREATER_THAN", "GREATER_THAN_EQUAL_TO", "LESS_THAN", "LESS_THAN_EQUAL_TO", "CONTAINS", "NOT_CONTAINS", "STARTS_WITH", "NOT_STARTS_WITH", "ENDS_WITH", "NOT_ENDS_WITH" ]The operation of the Simple Condition Row. -
value:
string()
Title:
Target ValueThe value to match. -
variableName:
string()
Title:
Simple Condition RowThe variable name of the Simple Condition Row.
Examples
The following examples show how to retrieve the specified pricing rule in Pricing Engine by submitting a GET request to the REST resource using cURL. For more information about cURL, see Use cURL.
curl - X GET -H "Authorization: Bearer <token>" - H "Content-type: application/json" https://sitename.oracle.com/rest/v19/pricingSetup/rules/US_enterprise_pricing_rule2
Response Body Sample
{
"active": true,
"name": "US Enterprise Pricing 2",
"variableName": "US_enterprise_pricing_rule2",
"startDate": "2021-04-23T18:25:43.511Z",
"endDate": "2032-04-23T18:25:43.511Z",
"description": "Pricing rule 2 for U.S. enterprise customers",
"ruleModelCount": 3,
"productCount": 18
}