Pricing Rule REST APIs

Overview

These endpoints enable administration of Pricing Engine pricing rules using REST API services.

Administration

ClosedAdd Pricing Rule

Add Pricing RulePOST method

Description

Use this endpoint to add a pricing rule in Pricing Engine.

URI Endpoint

/rest/v17/pricingSetup/rules

Endpoint Parameters

None

HTTP Method

POST

Request Body Parameters

active

Indicates if the rule is active.

description

The description of the pricing rule.

endDate

The date after which the pricing rule will no longer be applicable.
Format: yyyy-MM-dd'T'HH:mm:ss.SSS'Z

name

The name of the pricing rule.

orderNumber

The linked model is added at the end with the highest order number. If the model needs to be linked at a specific orderNumber, then the orderNumber property can be specified.

ruleConditionType

The condition type of the pricing rule. Allowed values:"alwaysTrue", "customerSpecific", "simple", or "advanced".

ruleModels

A collection of Price Models linked to the pricing rule.

simpleConditions

An array of simple conditions for the pricing rule.

startDate

The date from which the pricing rule will be applicable.
Format: yyyy-MM-dd'T'HH:mm:ss.SSS'Z

variableName

The unique variable name of the pricing rule.

Response Body Parameters

JSON data for the added pricing rule.

ClosedURI Endpoint Sample

https://sitename.oracle.com/rest/v17/pricingSetup/rules


ClosedSample Request Body

{ "dateModified": "2022-12-02T17:02:43Z", "dateAdded": "2022-12-02T17:00:47Z", "name": "New Pricing Rule", "variableName": "newPricingRule", "ruleConditionType": "simple", "active": true, "simpleConditions": { "ruleExpression": "1", "simpleConditionRows": [{ "index": 1, "variableName": "itemQuantity", "displayName": "Item Quantity", "operator": "GREATER_THAN_EQUAL_TO", "value": "10.0" } ] } }


ClosedSample Response Body

{ "dateModified": "2022-12-02T17:09:16Z", "dateAdded": "2022-12-02T17:09:16Z", "name": "New Pricing Rule", "variableName": "newPricingRule", "orderNumber": 20, "ruleConditionType": "simple", "active": true, "simpleConditions": { "ruleExpression": "1", "simpleConditionRows": [{ "index": 1, "variableName": "itemQuantity", "displayName": "Item Quantity", "operator": "GREATER_THAN_EQUAL_TO", "value": "10.0" } ] } }


ClosedAdd Pricing Rule Customer Specific Condition

Add Pricing Rule Customer Specific ConditionPOST method

Description

Use this endpoint to add a customer specific condition for the specified pricing rule in Pricing Engine.

URI Endpoint

/rest/v17/pricingSetup/rules/{ruleVariableName}/customerSpecificConditions

Endpoint Parameters

ruleVariableName

The variable name of the pricing rule.

HTTP Method

POST

Request Body Parameters

active

Indicates if the customer specific condition is active.

customerId

The unique identifier of the customer.

customerName

The name of the customer.

endDate

The date after which the customer specific condition will no longer be applicable.
Format: yyyy-MM-dd'T'HH:mm:ss.SSS'Z

startDate

The date from which the customer specific condition will be applicable.
Format: yyyy-MM-dd'T'HH:mm:ss.SSS'Z

Response Body Parameters

JSON data for the added customer specific condition.

ClosedURI Endpoint Sample

https://sitename.oracle.com/rest/v17/pricingSetup/rules/newCSPPricingRule/customerSpecificConditions


ClosedSample Request Body

{ "active": true, "customerId": "1001", "customerName": "ABC Solutions, Inc.", "startDate": "2023-01-01T06:00:00Z", "endDate": "2023-01-31T06:00:00Z" }


ClosedSample Response Body

{ "id": 38824940, "active": true, "customerId": "1001", "customerName": "ABC Solutions, Inc.", "startDate": "2023-01-01T06:00:00Z", "endDate": "2023-01-31T06:00:00Z", "dateModified": "2022-12-02T17:43:22Z", "dateAdded": "2022-12-02T17:43:22Z" }


ClosedDelete Pricing Rule

Delete Pricing RuleDELETE method

Description

Use this endpoint to delete the specified pricing rule in Pricing Engine.

URI Endpoint

/rest/v17/pricingSetup/rules/{ruleVariableName}

Endpoint Parameters

ruleVariableName

The variable name of the pricing rule.

HTTP Method

DELETE

Request Body Parameters

None

Success Response

204

ClosedURI Endpoint Sample

https://sitename.oracle.com/rest/v17/pricingSetup/rules/cSPPricingRule


ClosedDelete Pricing Rule Customer Specific Condition

Delete Pricing Rule Customer Specific ConditionDELETE method

Description

Use this endpoint to delete the specified customer specific condition for a pricing rule in Pricing Engine.

URI Endpoint

/rest/v17/pricingSetup/rules/{ruleVariableName}/customerSpecificConditions/{conditionId}

Endpoint Parameters

ruleVariableName

The variable name of the pricing rule.

conditionId

The unique identifier of the customer specific condition.

HTTP Method

DELETE

Request Body Parameters

None

Success Response

204

ClosedURI Endpoint Sample

https://sitename.oracle.com/rest/v17/pricingSetup/rules/newCSPPricingRule/38824940


ClosedGet Pricing Rules

Get Pricing RulesGET Method

Description

Use this endpoint to retrieve all pricing rules in Pricing Engine.

URI Endpoint

/rest/v17/pricingSetup/rules

Endpoint Parameters

None

(Optional) This endpoint supports the following query specifications: expand, fields, finder, limit, offset, onlyData, orderby, and totalResults. For more information, see Manage Collections.

HTTP Method

GET

Request Body Parameters

None

Response Body Parameters

A collection of pricing rules.

active

Indicates if the rule is active.

createdBy

The details of the user who created the record.

customerSpecificConditions

A collection of Customer Specific Conditions.

dateAdded

Creation date of the pricing rule.
Format: yyyy-MM-dd'T'HH:mm:ss.SSS'Z

dateModified

Last modified date of the pricing rule.
Format: yyyy-MM-dd'T'HH:mm:ss.SSS'Z

description

The description of the pricing rule.

endDate

The date after which the pricing rule will no longer be applicable.
Format: yyyy-MM-dd'T'HH:mm:ss.SSS'Z

lastModifiedBy

The details of the user who modified the record.

name

The name of the pricing rule.

orderNumber

The position of the current pricing rule in an ordered list of all pricing rules.

productCount

The count of products linked to this rule.

ruleConditionType

The condition type of the pricing rule. Allowed values:"alwaysTrue", "customerSpecific", "simple", or "advanced".

ruleModelCount

The count of Price Models linked to this rule. (Read-only)

ruleModels

A collection of Price Models linked to the pricing rule.

simpleConditions

An array of simple conditions for the pricing rule.

startDate

The date from which the pricing rule will be applicable.
Format: yyyy-MM-dd'T'HH:mm:ss.SSS'Z

variableName

The unique variable name of the pricing rule.

ClosedURI Endpoint Sample

https://sitename.oracle.com/rest/v17/pricingSetup/rules

The following example includes the limit query specification to limit the pricing rules in the results to five per page, and the orderBy query specification to order the results by order number in ascending order.

https://sitename.oracle.com/rest/v17/pricingSetup/rules/?limit=5&orderby=orderNumber:ASC


ClosedSample Response Body

{ "items": [{ "dateModified": "2022-06-27T23:17:09Z", "dateAdded": "2022-06-27T23:16:44Z", "name": "Base Pricing Rule", "variableName": "basePricingRule", "orderNumber": 1, "ruleConditionType": "advanced", "active": true, "ruleModelCount": 2, "productCount": 3, "links": [{ "rel": "self", "href": "https://sitename.oracle.com/rest/v17/pricingSetup/rules/basePricingRule" }, { "rel": "parent", "href": "https://sitename.oracle.com/rest/v17/pricingSetup/rules" }, { "rel": "child", "href": "https://sitename.oracle.com/rest/v17/pricingSetup/rules/basePricingRule/ruleModels" }, { "rel": "child", "href": "https://sitename.oracle.com/rest/v17/pricingSetup/rules/basePricingRule/customerSpecificConditions" } ] }, { "dateModified": "2022-06-27T23:16:51Z", "dateAdded": "2022-06-22T20:37:40Z", "name": "Tier and Volume Pricing", "variableName": "tierAndVolumePricing", "orderNumber": 2, "ruleConditionType": "customerSpecific", "active": true, "ruleModelCount": 0, "productCount": 0, "links": [{ "rel": "self", "href": "https://sitename.oracle.com/rest/v17/pricingSetup/rules/tierAndVolumePricing" }, { "rel": "parent", "href": "https://sitename.oracle.com/rest/v17/pricingSetup/rules" }, { "rel": "child", "href": "https://sitename.oracle.com/rest/v17/pricingSetup/rules/tierAndVolumePricing/ruleModels" }, { "rel": "child", "href": "https://sitename.oracle.com/rest/v17/pricingSetup/rules/tierAndVolumePricing/customerSpecificConditions" } ] }, { "dateModified": "2022-06-27T23:16:51Z", "dateAdded": "2019-05-02T13:37:28Z", "name": "oRCL_pRC_runAllProfiles", "variableName": "oRCLpRCrunAllProfiles", "orderNumber": 3, "ruleConditionType": "advanced", "active": true, "ruleModelCount": 2, "productCount": 0, "links": [{ "rel": "self", "href": "https://sitename.oracle.com/rest/v17/pricingSetup/rules/oRCLpRCrunAllProfiles" }, { "rel": "parent", "href": "https://sitename.oracle.com/rest/v17/pricingSetup/rules" }, { "rel": "child", "href": "https://sitename.oracle.com/rest/v17/pricingSetup/rules/oRCLpRCrunAllProfiles/ruleModels" }, { "rel": "child", "href": "https://sitename.oracle.com/rest/v17/pricingSetup/rules/oRCLpRCrunAllProfiles/customerSpecificConditions" } ] }, { "dateModified": "2022-12-01T15:54:29Z", "dateAdded": "2019-11-04T14:56:12Z", "name": "CSP ABC Corp", "variableName": "cSPABCCorp", "orderNumber": 4, "ruleConditionType": "advanced", "active": true, "ruleModelCount": 1, "productCount": 0, "links": [{ "rel": "self", "href": "https://sitename.oracle.com/rest/v17/pricingSetup/rules/cSPABCCorp" }, { "rel": "parent", "href": "https://sitename.oracle.com/rest/v17/pricingSetup/rules" }, { "rel": "child", "href": "https://sitename.oracle.com/rest/v17/pricingSetup/rules/cSPABCCorp/ruleModels" }, { "rel": "child", "href": "https://sitename.oracle.com/rest/v17/pricingSetup/rules/cSPABCCorp/customerSpecificConditions" } ] }, { "dateModified": "2022-12-01T15:54:29Z", "dateAdded": "2021-06-22T12:03:11Z", "name": "Banking Rule", "variableName": "bankingRule", "orderNumber": 5, "ruleConditionType": "customerSpecific", "active": true, "ruleModelCount": 1, "productCount": 3, "links": [{ "rel": "self", "href": "https://sitename.oracle.com/rest/v17/pricingSetup/rules/bankingRule" }, { "rel": "parent", "href": "https://sitename.oracle.com/rest/v17/pricingSetup/rules" }, { "rel": "child", "href": "https://sitename.oracle.com/rest/v17/pricingSetup/rules/bankingRule/ruleModels" }, { "rel": "child", "href": "https://sitename.oracle.com/rest/v17/pricingSetup/rules/bankingRule/customerSpecificConditions" } ] } ], "offset": 0, "limit": 5, "count": 5, "hasMore": true, "links": [{ "rel": "canonical", "href": "https://sitename.oracle.com/rest/v17/pricingSetup/rules" }, { "rel": "self", "href": "https://sitename.oracle.com/rest/v17/pricingSetup/rules?offset=0&limit=5&orderby=orderNumber:ASC" }, { "rel": "next", "href": "https://sitename.oracle.com/rest/v17/pricingSetup/rules?offset=5&limit=5&orderby=orderNumber:ASC" } ] }


ClosedGet Pricing Rule

Get Pricing RuleGET Method

Description

Use this endpoint to retrieve the specified pricing rule in Pricing Engine.

URI Endpoint

/rest/v17/pricingSetup/rules/{ruleVariableName}

Endpoint Parameters

ruleVariableName

The variable name of the pricing rule.

(Optional) This endpoint supports the expand and fieldsquery specifications.
For more information, see Manage Collections.

HTTP Method

GET

Request Body Parameters None

Response Body Parameters

active

Indicates if the rule is active.

createdBy

The details of the user who created the record.

customerSpecificConditions

A collection of Customer Specific Conditions.

dateAdded

Creation date of the pricing rule.
Format: yyyy-MM-dd'T'HH:mm:ss.SSS'Z

dateModified

Last modified date of the pricing rule.
Format: yyyy-MM-dd'T'HH:mm:ss.SSS'Z

description

The description of the pricing rule.

endDate

The date after which the pricing rule will no longer be applicable.
Format: yyyy-MM-dd'T'HH:mm:ss.SSS'Z

lastModifiedBy

The details of the user who modified the record.

name

The name of the pricing rule.

orderNumber

The position of the current pricing rule in an ordered list of all pricing rules.

productCount

The count of products linked to this rule.

ruleConditionType

The condition type of the pricing rule. Allowed values:"alwaysTrue", "customerSpecific", "simple", or "advanced".

ruleModelCount

The count of Price Models linked to this rule. (Read-only)

ruleModels

A collection of Price Models linked to the pricing rule.

simpleConditions

An array of simple conditions for the pricing rule.

startDate

The date from which the pricing rule will be applicable.
Format: yyyy-MM-dd'T'HH:mm:ss.SSS'Z

variableName

The unique variable name of the pricing rule.

ClosedURI Endpoint Sample

https://sitename.oracle.com/rest/v17/pricingSetup/rules/US_enterprise_pricing_rule2


ClosedSample Response Body

{ "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 }


ClosedGet Pricing Rule Customer Specific Conditions

Get Pricing Rule Customer Specific ConditionsGET Method

Description

Use this endpoint to retrieve customer specific conditions for the specified pricing rule in Pricing Engine.

URI Endpoint

/rest/v17/pricingSetup/rules/{ruleVariableName}/customerSpecificConditions

Endpoint Parameters

ruleVariableName

The variable name of the pricing rule.

(Optional) This endpoint supports the following query specifications: fields, finder, limit, offset, onlyData, orderby, and totalResults. For more information, see Manage Collections.

HTTP Method

GET

Request Body Parameters

None

Response Body Parameters

An array of Customer Specific Conditions.

active

Indicates if the customer specific condition is active.

createdBy

The details of the user who created the record.

customerId

The unique identifier of the customer.

customerName

The name of the customer.

dateAdded

Creation date of the customer specific condition for the pricing rule.
Format: yyyy-MM-dd'T'HH:mm:ss.SSS'Z

dateModified

Last modified date of the customer specific condition for the pricing rule.
Format: yyyy-MM-dd'T'HH:mm:ss.SSS'Z

endDate

The date after which the customer specific condition will no longer be applicable.
Format: yyyy-MM-dd'T'HH:mm:ss.SSS'Z

id

The unique identifier of the customer specific condition.

lastModifiedBy

The details of the user who modified the record.

startDate

The date from which the customer specific condition will be applicable.
Format: yyyy-MM-dd'T'HH:mm:ss.SSS'Z

ClosedURI Endpoint Sample

https://sitename.oracle.com/rest/v17/pricingSetup/rules/bankingRule/customerSpecificConditions


ClosedSample Response Body

{ "items": [{ "id": 38581345, "active": true, "customerId": "1001", "customerName": "ABC Solutions, Inc.", "startDate": "2021-06-22T00:00:00Z", "endDate": "2021-12-31T23:59:59Z", "dateModified": "2021-06-22T12:03:34Z", "dateAdded": "2021-06-22T12:03:34Z", "links": [{ "rel": "self", "href": "https://sitename.oracle.com/rest/v17/pricingSetup/rules/bankingRule/customerSpecificConditions/38581345" }, { "rel": "parent", "href": "https://sitename.oracle.com/rest/v17/pricingSetup/rules/bankingRule/customerSpecificConditions" } ] } ], "offset": 0, "limit": 1000, "count": 1, "hasMore": false, "links": [{ "rel": "parent", "href": "https://sitename.oracle.com/rest/v17/pricingSetup/rules/bankingRule" }, { "rel": "canonical", "href": "https://sitename.oracle.com/rest/v17/pricingSetup/rules/bankingRule/customerSpecificConditions" }, { "rel": "self", "href": "https://sitename.oracle.com/rest/v17/pricingSetup/rules/bankingRule/customerSpecificConditions?offset=0&limit=1000" } ] }


ClosedGet Pricing Rule Customer Specific Condition

Get Pricing Rule Customer Specific ConditionGET Method

Description

Use this endpoint to retrieve the specified customer specific condition for a pricing rule in Pricing Engine.

URI Endpoint

/rest/v17/pricingSetup/rules/{ruleVariableName}/customerSpecificConditions/{conditionId}

Endpoint Parameters

ruleVariableName

The variable name of the pricing rule.

conditionId

The Id of the customer specific condition.

None

(Optional) This endpoint supports the fields query specification. For more information, see Manage Collections.

HTTP Method

GET

Request Body Parameters

None

Response Body Parameters

active

Indicates if the customer specific condition is active.

createdBy

The details of the user who created the record.

customerId

The unique identifier of the customer.

customerName

The name of the customer.

dateAdded

Creation date of the customer specific condition for the pricing rule.
Format: yyyy-MM-dd'T'HH:mm:ss.SSS'Z

dateModified

Last modified date of the customer specific condition for the pricing rule.
Format: yyyy-MM-dd'T'HH:mm:ss.SSS'Z

endDate

The date after which the customer specific condition will no longer be applicable.
Format: yyyy-MM-dd'T'HH:mm:ss.SSS'Z

id

The unique identifier of the customer specific condition.

lastModifiedBy

The details of the user who modified the record.

startDate

The date from which the customer specific condition will be applicable.
Format: yyyy-MM-dd'T'HH:mm:ss.SSS'Z

ClosedURI Endpoint Sample

https://sitename.oracle.com/rest/v17/pricingSetup/rules/bankingRule/customerSpecificConditions/38581345


ClosedSample Response Body

{ "id": 38581345, "active": true, "customerId": "1001", "customerName": "ABC Solutions, Inc.", "startDate": "2021-06-22T00:00:00Z", "endDate": "2021-12-31T23:59:59Z", "dateModified": "2021-06-22T12:03:34Z", "dateAdded": "2021-06-22T12:03:34Z", "links": [{ "rel": "self", "href": "https://sitename.oracle.com/rest/v17/pricingSetup/rules/bankingRule/customerSpecificConditions/38581345" }, { "rel": "parent", "href": "https://sitename.oracle.com/rest/v17/pricingSetup/rules/bankingRule/customerSpecificConditions" } ] }


ClosedGet Price Models Linked to a Pricing Rule

Get Price Models Linked to a Pricing RuleGET Method

Description

Use this endpoint to retrieve all the Price Models that are linked to the specified pricing rule in Pricing Engine.

URI Endpoint

/rest/v17/pricingSetup/rules/{ruleVariableName}/rulemodels

Endpoint Parameters

ruleVariableName

The variable name of the pricing rule.

(Optional) This endpoint supports the following query specifications: fields, limit, offset, onlyData, orderby, and totalResults, for more information, see Manage Collections.

HTTP Method

GET

Request Body Parameters

None

Response Body Parameters

An array of Price Models that are linked to the pricing rule.

createdBy

The details of the user who created the record.

dateAdded

Creation date of the Price Model pricing rule link.
Format: yyyy-MM-dd'T'HH:mm:ss.SSS'Z

dateModified

Last modified date of the Price Model pricing rule link.
Format: yyyy-MM-dd'T'HH:mm:ss.SSS'Z

description

The description of the linked Price Model.

dynamicPricingType

The type of dynamic pricing applied by the linked Price Model.

lastModifiedBy

The details of the user who modified the record.

name

The name of the linked Price Model.

orderNumber

The position of the linked Price Model within in the pricing rule.

ruleCount

The count of pricing rules linked to the Price Model.

valueType

The type of discount applied by the linked Price Model.

variableName

The unique variable name of the linked Price Model.

ClosedURI Endpoint Sample

https://sitename.oracle.com/rest/v17/pricingSetup/rules/oRCLpRCrunAllProfiles/ruleModels


ClosedSample Response Body

{ "items": [{ "variableName": "subscriptionCharges", "orderNumber": 1, "dateModified": "2019-05-06T05:03:51Z", "dateAdded": "2019-05-02T13:37:28Z", "name": "Subscription Charges", "ruleCount": 1, "links": [{ "rel": "self", "href": "https://sitename.oracle.com/rest/v17/pricingSetup/rules/oRCLpRCrunAllProfiles/ruleModels/subscriptionCharges" }, { "rel": "parent", "href": "https://sitename.oracle.com/rest/v17/pricingSetup/rules/oRCLpRCrunAllProfiles/ruleModels" } ], "valueType": "absolutePrice", "dynamicPricingType": "advanced" }, { "variableName": "configSMS", "orderNumber": 2, "dateModified": "2020-04-20T16:14:23Z", "dateAdded": "2020-04-20T16:14:23Z", "name": "Config SMS", "ruleCount": 1, "links": [{ "rel": "self", "href": "https://sitename.oracle.com/rest/v17/pricingSetup/rules/oRCLpRCrunAllProfiles/ruleModels/configSMS" }, { "rel": "parent", "href": "https://sitename.oracle.com/rest/v17/pricingSetup/rules/oRCLpRCrunAllProfiles/ruleModels" } ], "valueType": "absolutePrice", "dynamicPricingType": "advanced" } ], "offset": 0, "limit": 1000, "count": 2, "hasMore": false, "links": [{ "rel": "parent", "href": "https://sitename.oracle.com/rest/v17/pricingSetup/rules/oRCLpRCrunAllProfiles" }, { "rel": "canonical", "href": "https://sitename.oracle.com/rest/v17/pricingSetup/rules/oRCLpRCrunAllProfiles/ruleModels" }, { "rel": "self", "href": "https://sitename.oracle.com/rest/v17/pricingSetup/rules/oRCLpRCrunAllProfiles/ruleModels?offset=0&limit=1000" } ] }


ClosedLink a Price Model to a Pricing Rule

Link a Price Model to a Pricing RulePOST method

Description

Use this endpoint to link a Price Model to a pricing rule in Pricing Engine.

Note: This operation does not add a new Price Model.

URI Endpoint

/rest/v17/pricingSetup/rules/{ruleVariableName}/ruleModels

Endpoint Parameters

ruleVariableName

The variable name of the pricing rule.

HTTP Method

POST

Request Body Parameters

variableName

The variable name of the Price Model.

orderNumber

(optional) The linked model is added at the end of the linked Price Model list. If the Price Model needs a specific orderNumber, then the orderNumber property can be specified.

Response Body Parameters

JSON data for the linked Price Model.

ClosedURI Endpoint Sample

https://sitename.oracle.com/rest/v17/pricingSetup/rules/basePricingRule/ruleModels


ClosedSample Request Body

{ "variableName": "tierDiscountPricing" }


ClosedSample Response Body

{ "variableName": "tierDiscountPricing", "orderNumber": 2, "dateModified": "2022-12-02T21:02:13Z", "dateAdded": "2022-12-02T21:02:13Z", "name": "Tier Discount Pricing", "valueType": "discountAmount", "dynamicPricingType": "tiered" }


ClosedUpdate Pricing Rules

Update Pricing RulesPATCH method

Description

Use this endpoint to add, update, reorder, or delete pricing rules in Pricing Engine.

URI Endpoint

/rest/v17/pricingSetup/rules

Endpoint Parameters

None

HTTP Method

PATCH

Request Body Parameters

The array of pricing patch operations.

op

The operation to be performed. Allowed values: "add", "remove", and "replace".

path

The JSON pointer string for "path" property.

value

The target value. Refer to Add Pricing Rule for more information.

Success Response

204

ClosedURI Endpoint Sample

https://sitename.oracle.com/rest/v17/pricingSetup/rules


ClosedSample Request Body

{ [{ "op": "add", "path": "/", "value": { "active": true, "name": "US Enterprise Pricing", "variableName": "US_enterprise_pricing_rule", "startDate": "2021-04-23T18:25:43.511Z", "endDate": "2032-04-23T18:25:43.511Z", "description": "Pricing rule for U.S. enterprise customers" } }, { "op": "remove", "path": "/US_enterprise_pricing_rule_dummy" }, { "op": "replace", "path": "/Enterprise_pricing_new" "value": { "orderNumber": 3 } } ] }


ClosedUpdate Pricing Rule

Update Pricing RulePATCH method

Description

Use this endpoint to update the specified pricing rule in Pricing Engine.

URI Endpoint

/rest/v17/pricingSetup/rules/{ruleVariableName}

Endpoint Parameters

ruleVariableName

The variable name of the pricing rule.

HTTP Method

PATCH

Request Body Parameters

active

Indicates if the rule is active.

description

The description of the pricing rule.

endDate

The date after which the pricing rule will no longer be applicable.
Format: yyyy-MM-dd'T'HH:mm:ss.SSS'Z

name

The name of the pricing rule.

orderNumber

The linked model is added at the end with the highest order number. If the model needs to be linked at a specific orderNumber, then the orderNumber property can be specified.

ruleConditionType

The condition type of the pricing rule. Allowed values:"alwaysTrue", "customerSpecific", "simple", or "advanced".

ruleModels

A collection of Price Models linked to the pricing rule.

simpleConditions

An array of simple conditions for the pricing rule.

startDate

The date from which the pricing rule will be applicable.
Format: yyyy-MM-dd'T'HH:mm:ss.SSS'Z

Success Response

204

ClosedURI Endpoint Sample

https://sitename.oracle.com/rest/v17/pricingSetup/rules/US_enterprise_pricing_rule


ClosedSample Request Body

{ "active": false, "name": "US Enterprise Pricing (Inactive)" }


ClosedUpdate Pricing Rule Customer Specific Conditions

Update Pricing Rule Customer Specific ConditionsPATCH method

Description

Use this endpoint to update or delete customer specific conditions for the specified pricing rule in Pricing Engine.

URI Endpoint

/rest/v17/pricingSetup/rules/{ruleVariableName}/customerSpecificConditions

Endpoint Parameters

ruleVariableName

The variable name of the pricing rule.

HTTP Method

PATCH

Request Body Parameters

The array of pricing patch operations.

op

The operation to be performed. Allowed values: "add", "remove", and "replace".

path

The JSON pointer string for "path" property.

value

The target value. Refer to Add Customer Specific Condition for more information.

Success Response

204

ClosedURI Endpoint Sample

https://sitename.oracle.com/rest/v17/pricingSetup/rules/US_enterprise_pricing_rule


ClosedSample Request Body

[{ "op": "add", "path": "/", "value": { "active": true, "customerId": "usEnterprisePricing1", "startDate": "2021-04-23T18:25:43.511Z", "endDate": "2032-04-23T18:25:43.511Z" } }, { "op": "remove", "path": "/39854321" }, { "op": "replace", "path": "/13457765", "value": { "endDate": null } } ]


ClosedUpdate Pricing Rule Customer Specific Condition

Update Pricing Rule Customer Specific ConditionPATCH method

Description

Use this endpoint to update the specified customer specific condition for a pricing rule in Pricing Engine.

URI Endpoint

/rest/v17/pricingSetup/rules/{ruleVariableName}/customerSpecificConditions/{conditionId}

Endpoint Parameters

ruleVariableName

The variable name of the pricing rule.

conditionId

The unique identifier of the customer specific condition.

HTTP Method

PATCH

Request Body Parameters

active

Indicates if the customer specific condition is active.

endDate

The date after which the customer specific condition will no longer be applicable.
Format: yyyy-MM-dd'T'HH:mm:ss.SSS'Z

startDate

The date from which the customer specific condition will be applicable.
Format: yyyy-MM-dd'T'HH:mm:ss.SSS'Z

Success Response

204

ClosedURI Endpoint Sample

https://sitename.oracle.com/rest/v17/pricingSetup/rules/US_enterprise_pricing_rule/customerSpecificConditions/39854399


ClosedSample Request Body

{ "startDate": "2023-01-23T18:25:43.511Z", "endDate": "2024-01-23T18:25:43.511Z" }


ClosedUpdate Price Models Linked to a Pricing Rule

Update Price Models Linked to a Pricing RulePATCH method

Description

Use this endpoint to add, reorder, or delete Price Models that are linked to a Pricing Engine Rule.

URI Endpoint

/rest/v17/pricingSetup/rules/{ruleVariableName}/rulemodels

Endpoint Parameters

ruleVariableName

The variable name of the pricing rule.

HTTP Method

PATCH

Request Body Parameters

The array of pricing patch operations.

op

The operation to be performed. Allowed values: "add", "remove", and "replace".

Note: You can only link, unlink, or reorder Price Models using this endpoint.

  • The "add" operation is used to link a Price Model to a pricing rule.
    This operation does not add a new Price Model
  • The "remove" operation is used to unlink a Price Model to a pricing rule.
    This operation does not delete Price Model.
  • The "replace" operation is used to change the order position of the Price Model.

path

The JSON pointer string for "path" property.

value

The target value.

Success Response

204

ClosedURI Endpoint Sample

https://sitename.oracle.com/rest/v17/pricingSetup/rules/oRCLpRCrunAllProfiles


ClosedSample Request Body

[{ "op": "add", "path": "/", "value": { "variableName": "absolutePrice" } }, { "op": "replace", "path": "/configSMS", "value": { "orderNumber": 1 } }, { "op": "remove", "path": "/subscriptionCharges" } ]


ClosedUpdate Price Model Linked to a Pricing Rule

Update Price Model Linked to Pricing RulePATCH method

Description

Use this endpoint to change the order number for the specified Price Model.

URI Endpoint

/rest/v17/pricingSetup/rules/{ruleVariableName}/rulemodels/{modelVariableName}

Endpoint Parameters

ruleVariableName

The variable name of the pricing rule.

modelVariableName

The variable name of the Price Model.

HTTP Method

PATCH

Request Body Parameters

orderNumber

The position of the linked Price Model within the pricing rule.

Success Response

204

ClosedURI Endpoint Sample

https://sitename.oracle.com/rest/v17/pricingSetup/rules/oRCLpRCrunAllProfiles/ruleModels/subscriptionCharges


ClosedSample Request Body

{ "orderNumber": "5" }


ClosedUnlink a Price Model from a Pricing Rule

Unlink a Price Model from a Pricing RuleDELETE method

Description

Use this endpoint to unlink the specified Price Model from a pricing rule in Pricing Engine.

Note: This operation does not delete Price Model.

URI Endpoint

/rest/v17/pricingSetup/rules/{ruleVariableName}/rulemodels/{modelVariableName}

Endpoint Parameters

ruleVariableName

The variable name of the pricing rule.
 

modelVariableName

The variable name of the linked Price Model.

HTTP Method

DELETE

Request Body Parameters

None

Success Response

204

ClosedURI Endpoint Sample

https://sitename.oracle.com/rest/v17/pricingSetup/rules/oRCLpRCrunAllProfiles/ruleModels/subscriptionCharges


 

Related Topics

Related Topics Link IconSee Also