Update a pricing logic algorithm
patch
https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/productCatalogManagement/v1/pricingLogicAlgorithm/{id}
Updates the pricing logic algorithm with the specified ID.
Request
Path Parameters
-
id(required): string
The ID of the resource item.
Supported Media Types
- application/json
Root Schema : PlaQuantityRangeOracle
Title:
PlaQuantityRangeOracleMatch All
Show Source
-
object
PricingLogicAlgorithm
Title:
PricingLogicAlgorithmDiscriminator:{ "propertyName":"@type", "mapping":{ "PricingLogicAlgorithm":"#/components/schemas/PricingLogicAlgorithm", "PlaQuantityRangeOracle":"#/components/schemas/PlaQuantityRangeOracle" } }The pricing logic algorithm resource. -
object
type
Nested Schema : PricingLogicAlgorithm
Type:
objectTitle:
PricingLogicAlgorithmDiscriminator: @type
Discriminator Values
The pricing logic algorithm resource.
Show Source
-
@baseType: string
The base type of the pricing logic algorithm.
-
@schemaLocation: string
The URI of the schema that defines the pricing logic algorithm.
-
@type(required): string
The class type of the pricing logic algorithm.
-
customProfileSpec: array
customProfileSpec
A list of custom profile specifications associated with the pricing logic algorithm.
-
description: string
The description of this pla.
-
href: string
The hyperlink reference to the pricing logic algorithm.
-
id: string
Maximum Length:
30The ID of the pricing logic algorithm. -
lastUpdate: string
(date-time)
The date and time when the pricing logic algorithm was last updated.
-
lifecycleStatus: string
The status of the pricing logic algorithm.
-
name: string
The name of the pricing logic algorithm.
-
plaSpecification: object
PlaSpecificationRef
Title:
PlaSpecificationRefA pricing logic algorithm specification reference. A PricingLogicAlgorithmSpec is a detailed description of a tangible or intangible object made available externally in the form of a PricingLogicAlgorithm to customers or other parties playing a party role. -
validFor: object
TimePeriod
Title:
TimePeriodThe period for which the productOffering is valid. -
version: string
The pla version.
Nested Schema : type
Type:
Show Source
object-
applicationName: string
The name of the application associated with the pricing logic algorithm quantity range.
-
created: string
(date-time)
The date and time of the creation.
-
createdBy: string
The name of the person who created item.
-
externalId: string
The ID of the external associated with the pricing logic algorithm quantity range.
-
lastUpdate: string
(date-time)
The date and time when the pricing logic algorithm quantity range was last updated.
-
lastUpdatedBy: string
The name of the person who updated item.
-
plaCharacteristic: array
plaCharacteristic
A list of pla characteristics associated with the pricing logic algorithm quantity range.
-
pricingType: string
Allowed Values:
[ "SIMPLE", "TIERED" ]The type or classification of the pricing logic algorithm quantity range. Valid values are SIMPLE, and TIERED. -
project: object
ProjectRef
Title:
ProjectRefThe project reference resource. -
tierRange: array
tierRange
A list of tier ranges associated with the pricing logic algorithm quantity range.
-
versionState: number
The version state of the Pricing Logic Algorithm.
Nested Schema : plaCharacteristic
Type:
arrayA list of pla characteristics associated with the pricing logic algorithm quantity range.
Show Source
-
Array of:
object PlaCharacteristicOracle
Title:
PlaCharacteristicOracleA use of the ProdSpecCharacteristicValue by a ProductOffering to which additional properties (attributes) apply or override the properties of similar properties contained in ProdSpecCharacteristicValue.
Nested Schema : ProjectRef
Type:
objectTitle:
ProjectRefThe project reference resource.
Show Source
-
href: string
The hyperlink reference to the project reference.
-
id(required): string
The ID of the project reference.
-
name: string
The name of the project reference.
-
version: string
The version of the project.
Nested Schema : tierRange
Type:
arrayA list of tier ranges associated with the pricing logic algorithm quantity range.
Show Source
-
Array of:
object TierRangeOracle
Title:
TierRangeOracleContains the minimum and maximum quantity for which the pricing is applicable.
Nested Schema : PlaCharacteristicOracle
Type:
objectTitle:
PlaCharacteristicOracleA use of the ProdSpecCharacteristicValue by a ProductOffering to which additional properties (attributes) apply or override the properties of similar properties contained in ProdSpecCharacteristicValue.
Show Source
-
description: string
A narrative that explains in detail what the productSpecCharacteristic is.
-
name: string
The name of the pricing logic algorithm characteristic.
-
plaCharacteristicValue: array
plaCharacteristicValue
A list of pla characteristic values associated with the pricing logic algorithm characteristic.
-
valueType: string
The type or classification of the pricing logic algorithm characteristic.
Nested Schema : plaCharacteristicValue
Type:
arrayA list of pla characteristic values associated with the pricing logic algorithm characteristic.
Show Source
-
Array of:
object PlaCharacteristicValueOracle
Title:
PlaCharacteristicValueOracleA number or text that can be assigned to a ProductSpecCharacteristic.
Nested Schema : PlaCharacteristicValueOracle
Type:
objectTitle:
PlaCharacteristicValueOracleA number or text that can be assigned to a ProductSpecCharacteristic.
Show Source
-
unitOfMeasure: string
Allowed Values:
[ "NONE", "SECOND", "MINUTE", "HOUR", "DAY", "MONTH", "BYTE", "KILOBYTE", "MEGABYTE", "GIGABYTE", "PAGES", "MOVIES", "TIME_INTERVAL", "QUANTITY", "MBPS", "GBPS" ]The unit can be minutes or GB. -
value:
value
A discrete value that the characteristic can take on. The value type is defined by the valueType characteristic.
Nested Schema : value
A discrete value that the characteristic can take on. The value type is defined by the valueType characteristic.
Match One Schema
Show Source
Nested Schema : value-oneOf[1]
Type:
objectNested Schema : TierRangeOracle
Type:
objectTitle:
TierRangeOracleContains the minimum and maximum quantity for which the pricing is applicable.
Show Source
-
inclusivity: string
Allowed Values:
[ "UPPER_INCLUSIVE", "LOWER_INCLUSIVE" ]Specifies whether to include the upper limit or lower limit. Valid values are UPPER_INCLUSIVE and LOWER_INCLUSIVE. -
maxQuantity: integer
A maximum quantity of something, typically the total of a thing or things in number, size, value, extent, or money.
-
minQuantity: integer
A minimum quantity of something, typically the total of a thing or things in number, size, value, extent, or money.
-
productOfferingPrice: array
productOfferingPrice
A list of product offering prices associated with the tier range.
Nested Schema : productOfferingPrice
Type:
arrayA list of product offering prices associated with the tier range.
Show Source
-
Array of:
object ProductOfferingPriceRef
Title:
ProductOfferingPriceRefThe productPriceOffering reference. An amount, usually of money, that is asked for or allowed when a ProductOffering is bought, rented, or leased.
Nested Schema : ProductOfferingPriceRef
Type:
objectTitle:
ProductOfferingPriceRefThe productPriceOffering reference. An amount, usually of money, that is asked for or allowed when a ProductOffering is bought, rented, or leased.
Show Source
-
@baseType: string
The base type of the product offering price reference.
-
@referredType(required): string
The actual type of the target instance when needed for disambiguation.
-
@schemaLocation: string
(uri)
The URI of the schema that defines the product offering price reference.
-
@type(required): string
The class type of the product offering price reference.
-
href: string
The hyperlink reference to the product offering price reference.
-
id(required): string
The ID of the product offering price reference.
-
name: string
The name of the product offering price reference.
-
refId: string
The ID of the ref associated with the product offering price reference.
-
refName: string
The name of the ref associated with the product offering price reference.
-
version: string
The version of a related entity.
-
versionState: number
The version state of the reference.
Response
Supported Media Types
- application/json
200 Response
The pricing logic algorithm was updated successfully.
Root Schema : PlaQuantityRangeOracle
Title:
PlaQuantityRangeOracleMatch All
Show Source
-
object
PricingLogicAlgorithm
Title:
PricingLogicAlgorithmDiscriminator:{ "propertyName":"@type", "mapping":{ "PricingLogicAlgorithm":"#/components/schemas/PricingLogicAlgorithm", "PlaQuantityRangeOracle":"#/components/schemas/PlaQuantityRangeOracle" } }The pricing logic algorithm resource. -
object
type
Nested Schema : PricingLogicAlgorithm
Type:
objectTitle:
PricingLogicAlgorithmDiscriminator: @type
Discriminator Values
The pricing logic algorithm resource.
Show Source
-
@baseType: string
The base type of the pricing logic algorithm.
-
@schemaLocation: string
The URI of the schema that defines the pricing logic algorithm.
-
@type(required): string
The class type of the pricing logic algorithm.
-
customProfileSpec: array
customProfileSpec
A list of custom profile specifications associated with the pricing logic algorithm.
-
description: string
The description of this pla.
-
href: string
The hyperlink reference to the pricing logic algorithm.
-
id: string
Maximum Length:
30The ID of the pricing logic algorithm. -
lastUpdate: string
(date-time)
The date and time when the pricing logic algorithm was last updated.
-
lifecycleStatus: string
The status of the pricing logic algorithm.
-
name: string
The name of the pricing logic algorithm.
-
plaSpecification: object
PlaSpecificationRef
Title:
PlaSpecificationRefA pricing logic algorithm specification reference. A PricingLogicAlgorithmSpec is a detailed description of a tangible or intangible object made available externally in the form of a PricingLogicAlgorithm to customers or other parties playing a party role. -
validFor: object
TimePeriod
Title:
TimePeriodThe period for which the productOffering is valid. -
version: string
The pla version.
Nested Schema : type
Type:
Show Source
object-
applicationName: string
The name of the application associated with the pricing logic algorithm quantity range.
-
created: string
(date-time)
The date and time of the creation.
-
createdBy: string
The name of the person who created item.
-
externalId: string
The ID of the external associated with the pricing logic algorithm quantity range.
-
lastUpdate: string
(date-time)
The date and time when the pricing logic algorithm quantity range was last updated.
-
lastUpdatedBy: string
The name of the person who updated item.
-
plaCharacteristic: array
plaCharacteristic
A list of pla characteristics associated with the pricing logic algorithm quantity range.
-
pricingType: string
Allowed Values:
[ "SIMPLE", "TIERED" ]The type or classification of the pricing logic algorithm quantity range. Valid values are SIMPLE, and TIERED. -
project: object
ProjectRef
Title:
ProjectRefThe project reference resource. -
tierRange: array
tierRange
A list of tier ranges associated with the pricing logic algorithm quantity range.
-
versionState: number
The version state of the Pricing Logic Algorithm.
Nested Schema : plaCharacteristic
Type:
arrayA list of pla characteristics associated with the pricing logic algorithm quantity range.
Show Source
-
Array of:
object PlaCharacteristicOracle
Title:
PlaCharacteristicOracleA use of the ProdSpecCharacteristicValue by a ProductOffering to which additional properties (attributes) apply or override the properties of similar properties contained in ProdSpecCharacteristicValue.
Nested Schema : ProjectRef
Type:
objectTitle:
ProjectRefThe project reference resource.
Show Source
-
href: string
The hyperlink reference to the project reference.
-
id(required): string
The ID of the project reference.
-
name: string
The name of the project reference.
-
version: string
The version of the project.
Nested Schema : tierRange
Type:
arrayA list of tier ranges associated with the pricing logic algorithm quantity range.
Show Source
-
Array of:
object TierRangeOracle
Title:
TierRangeOracleContains the minimum and maximum quantity for which the pricing is applicable.
Nested Schema : PlaCharacteristicOracle
Type:
objectTitle:
PlaCharacteristicOracleA use of the ProdSpecCharacteristicValue by a ProductOffering to which additional properties (attributes) apply or override the properties of similar properties contained in ProdSpecCharacteristicValue.
Show Source
-
description: string
A narrative that explains in detail what the productSpecCharacteristic is.
-
name: string
The name of the pricing logic algorithm characteristic.
-
plaCharacteristicValue: array
plaCharacteristicValue
A list of pla characteristic values associated with the pricing logic algorithm characteristic.
-
valueType: string
The type or classification of the pricing logic algorithm characteristic.
Nested Schema : plaCharacteristicValue
Type:
arrayA list of pla characteristic values associated with the pricing logic algorithm characteristic.
Show Source
-
Array of:
object PlaCharacteristicValueOracle
Title:
PlaCharacteristicValueOracleA number or text that can be assigned to a ProductSpecCharacteristic.
Nested Schema : PlaCharacteristicValueOracle
Type:
objectTitle:
PlaCharacteristicValueOracleA number or text that can be assigned to a ProductSpecCharacteristic.
Show Source
-
unitOfMeasure: string
Allowed Values:
[ "NONE", "SECOND", "MINUTE", "HOUR", "DAY", "MONTH", "BYTE", "KILOBYTE", "MEGABYTE", "GIGABYTE", "PAGES", "MOVIES", "TIME_INTERVAL", "QUANTITY", "MBPS", "GBPS" ]The unit can be minutes or GB. -
value:
value
A discrete value that the characteristic can take on. The value type is defined by the valueType characteristic.
Nested Schema : value
A discrete value that the characteristic can take on. The value type is defined by the valueType characteristic.
Match One Schema
Show Source
Nested Schema : value-oneOf[1]
Type:
objectNested Schema : TierRangeOracle
Type:
objectTitle:
TierRangeOracleContains the minimum and maximum quantity for which the pricing is applicable.
Show Source
-
inclusivity: string
Allowed Values:
[ "UPPER_INCLUSIVE", "LOWER_INCLUSIVE" ]Specifies whether to include the upper limit or lower limit. Valid values are UPPER_INCLUSIVE and LOWER_INCLUSIVE. -
maxQuantity: integer
A maximum quantity of something, typically the total of a thing or things in number, size, value, extent, or money.
-
minQuantity: integer
A minimum quantity of something, typically the total of a thing or things in number, size, value, extent, or money.
-
productOfferingPrice: array
productOfferingPrice
A list of product offering prices associated with the tier range.
Nested Schema : productOfferingPrice
Type:
arrayA list of product offering prices associated with the tier range.
Show Source
-
Array of:
object ProductOfferingPriceRef
Title:
ProductOfferingPriceRefThe productPriceOffering reference. An amount, usually of money, that is asked for or allowed when a ProductOffering is bought, rented, or leased.
Nested Schema : ProductOfferingPriceRef
Type:
objectTitle:
ProductOfferingPriceRefThe productPriceOffering reference. An amount, usually of money, that is asked for or allowed when a ProductOffering is bought, rented, or leased.
Show Source
-
@baseType: string
The base type of the product offering price reference.
-
@referredType(required): string
The actual type of the target instance when needed for disambiguation.
-
@schemaLocation: string
(uri)
The URI of the schema that defines the product offering price reference.
-
@type(required): string
The class type of the product offering price reference.
-
href: string
The hyperlink reference to the product offering price reference.
-
id(required): string
The ID of the product offering price reference.
-
name: string
The name of the product offering price reference.
-
refId: string
The ID of the ref associated with the product offering price reference.
-
refName: string
The name of the ref associated with the product offering price reference.
-
version: string
The version of a related entity.
-
versionState: number
The version state of the reference.
400 Response
Your request couldn't be processed because it contains missing or invalid information, such as a validation error on an input field, a missing required value, and so forth.
Root Schema : Error
Type:
objectTitle:
ErrorThe error resource.
Show Source
-
@schemaLocation: string
The URI of the schema that defines the error.
-
@type: string
The class type of a REST resource.
-
code(required): string
Application related code (as defined in the API or from a common list).
-
message: string
The text that provides more details and corrective actions related to the error. This can be shown to a client user.
-
reason(required): string
The text that explains the reason for error. This can be shown to a client user.
-
referenceError: string
The URL pointing to documentation describing the error.
-
status: string
The status of the error.
401 Response
Your request isn't authorized. The authentication credentials included with this request are missing or invalid.
Root Schema : Error
Type:
objectTitle:
ErrorThe error resource.
Show Source
-
@schemaLocation: string
The URI of the schema that defines the error.
-
@type: string
The class type of a REST resource.
-
code(required): string
Application related code (as defined in the API or from a common list).
-
message: string
The text that provides more details and corrective actions related to the error. This can be shown to a client user.
-
reason(required): string
The text that explains the reason for error. This can be shown to a client user.
-
referenceError: string
The URL pointing to documentation describing the error.
-
status: string
The status of the error.
404 Response
The resource with the specified URI couldn't be found.
Root Schema : Error
Type:
objectTitle:
ErrorThe error resource.
Show Source
-
@schemaLocation: string
The URI of the schema that defines the error.
-
@type: string
The class type of a REST resource.
-
code(required): string
Application related code (as defined in the API or from a common list).
-
message: string
The text that provides more details and corrective actions related to the error. This can be shown to a client user.
-
reason(required): string
The text that explains the reason for error. This can be shown to a client user.
-
referenceError: string
The URL pointing to documentation describing the error.
-
status: string
The status of the error.
405 Response
HTTP action specified in the request (DELETE, GET, POST, PUT) isn't supported for this request URI.
Root Schema : Error
Type:
objectTitle:
ErrorThe error resource.
Show Source
-
@schemaLocation: string
The URI of the schema that defines the error.
-
@type: string
The class type of a REST resource.
-
code(required): string
Application related code (as defined in the API or from a common list).
-
message: string
The text that provides more details and corrective actions related to the error. This can be shown to a client user.
-
reason(required): string
The text that explains the reason for error. This can be shown to a client user.
-
referenceError: string
The URL pointing to documentation describing the error.
-
status: string
The status of the error.
500 Response
The server encountered something unexpected that prevented it from completing the request.
Root Schema : Error
Type:
objectTitle:
ErrorThe error resource.
Show Source
-
@schemaLocation: string
The URI of the schema that defines the error.
-
@type: string
The class type of a REST resource.
-
code(required): string
Application related code (as defined in the API or from a common list).
-
message: string
The text that provides more details and corrective actions related to the error. This can be shown to a client user.
-
reason(required): string
The text that explains the reason for error. This can be shown to a client user.
-
referenceError: string
The URL pointing to documentation describing the error.
-
status: string
The status of the error.
Examples
The following example shows how to update a pricing logic algorithm by submitting a PATCH request on the REST resource using cURL.
cURL Command
curl -u username:password -X PATCH
https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/productCatalogManagement/v1/pricingLogicAlgorithm/mypla00010
-H 'Content-Type: application/json' -D @update_pla.json | json_pp
Example of Request Body
The following example shows the contents of the request body in JSON format.
{
"description" : "Pricing Logic Algorithm for Tiered Pricing",
"validFor": {
"startDateTime": "2024-08-09T00:00:00.000Z",
"endDateTime": "2028-08-09T00:00:00.000Z"
}
}Example of Response Body
The following example shows the contents of the response body in JSON
format.
{
"id": "PLA_001",
"href": "https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/productCatalogManagement/v1/pricingLogicAlgorithm/PLA_001",
"name": "Tier PLA",
"description" : "Pricing Logic Algorithm for Tiered Pricing",
"validFor": {
"startDateTime": "2024-08-09T00:00:00.000Z",
"endDateTime": "2028-08-09T00:00:00.000Z"
}
"@type": "PlaQuantityRangeOracle",
"@baseType": "PricingLogicAlgorithm",
"version": "1.0",
"created": "2025-02-17T12:56:40.000Z",
"createdBy": "booth",
"lastUpdate": "2025-02-17T12:56:40.031Z",
"lastUpdatedBy": "booth",
"lifecycleStatus": "In design",
"versionState": 0,
"plaSpecification": {
"id": "PLAspec1",
"name": "PLA Spec",
"version": "1.0",
"href": "https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/productCatalogManagement/v1/pricingLogicAlgorithmSpecification/PLAspec1",
"@referredType": "PricingLogicAlgorithmSpecOracle",
"@type": "PlaSpecificationRef"
}
}