Add a Price Model Item Charge
post
/rest/v19/pricingSetup/models/{modelVariableName}/priceModelItems/{priceModelItemId}/charges
Use this endpoint to add a price model item charge.
Request
Supported Media Types
- application/json
Path Parameters
Root Schema : PricingCharge
Type:
Show Source
object-
blockPrices:
array Block Prices
Title:
Block PricesThe block price. -
blockSize:
number()
Title:
Block SizeThe block size. -
chargeDefinition:
string()
Title:
Charge DefinitionRead Only:trueDisplay Name of the Charge Definition. -
chargeDefinitionCode:
string()
Title:
Charge Definition CodeThe unique code of the Charge Definition. -
chargeDefinitionId:
integer()
Title:
Charge Definition IDRead Only:trueID of the Charge Definition. -
chargeType:
string()
Title:
Charge TypeThe category of charge. -
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. -
dateModified:
string(yyyy-MM-dd'T'HH:mm:ss.SSS'Z')
Title:
Date ModifiedRead Only:trueLast modified date. -
dynamicPricingType:
string()
Title:
Dynamic Pricing TypeAllowed Values:[ "static", "advanced", "volume", "tiered", "rateCard", "attributeBasedCharge" ]The dynamic pricing type of the charge. -
endDate:
string(yyyy-MM-dd'T'HH:mm:ss.SSS'Z')
Title:
End DateThe date at which the Charge will end. -
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 Charge. -
integrationId:
string()
Title:
Integration IdRate Plan Charge ID from SCM. -
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. -
pricePeriod:
string()
Title:
Price PeriodThe billing period. -
prices:
array Prices
Title:
PricesThe item prices. -
priceType:
string()
Title:
Price TypeThe type of charge. -
pricingMatrixVariableName:
string()
Title:
Pricing Matrix Variable NamePricing Matrix variable name (Preview only. Not available for use.) -
primaryCharge:
boolean()
Title:
Primary ChargeIndicates whether this is the primary charge. -
quantityAggregation:
boolean()
Title:
Quantity AggregationIndicates whether to use aggregated quantity when calculating unit price for tiered-pricing. -
rateCardName:
string()
Title:
Rate Card NameRead Only:trueRate Card name (Preview only. Not available for use.) -
rateCardVariableName:
string()
Title:
Rate Card Variable NameRate Card variable name (Preview only. Not available for use.) -
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 from which the Charge will be applicable. -
templateVariableName:
string()
Title:
Pricing Matrix Template Variable NameThe pricing matrix emplate variable name. -
tiers:
array Tiers
Title:
TiersThe charge tiers. -
usageUOM:
string()
Title:
Usage UOMThe unit of measure for the charge.
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 : PricingCurrencyValues
Type:
Show Source
object-
currencyCode:
string()
Title:
Currency CodeThe currency code. -
value:
number()
Title:
ValueThe currency value.
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 : ChargeTier
Type:
Show Source
object-
blockPrices:
array Block Prices
Title:
Block PricesThe block price for the corresponding tier. -
blockSize:
number()
Title:
Block SizeThe block size for the corresponding tier. -
prices:
array Prices
Title:
PricesThe prices. -
rangeFrom:
number()
Title:
Range FromThe starting range of the Charge. -
rangeTo:
number()
Title:
Range ToRead Only:trueThe ending range of the Charge.
Nested Schema : Block Prices
Type:
arrayTitle:
Block PricesThe block price for the corresponding tier.
Show Source
Response
Supported Media Types
- application/json
200 Response
Success
Root Schema : PricingCharge
Type:
Show Source
object-
blockPrices:
array Block Prices
Title:
Block PricesThe block price. -
blockSize:
number()
Title:
Block SizeThe block size. -
chargeDefinition:
string()
Title:
Charge DefinitionRead Only:trueDisplay Name of the Charge Definition. -
chargeDefinitionCode:
string()
Title:
Charge Definition CodeThe unique code of the Charge Definition. -
chargeDefinitionId:
integer()
Title:
Charge Definition IDRead Only:trueID of the Charge Definition. -
chargeType:
string()
Title:
Charge TypeThe category of charge. -
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. -
dateModified:
string(yyyy-MM-dd'T'HH:mm:ss.SSS'Z')
Title:
Date ModifiedRead Only:trueLast modified date. -
dynamicPricingType:
string()
Title:
Dynamic Pricing TypeAllowed Values:[ "static", "advanced", "volume", "tiered", "rateCard", "attributeBasedCharge" ]The dynamic pricing type of the charge. -
endDate:
string(yyyy-MM-dd'T'HH:mm:ss.SSS'Z')
Title:
End DateThe date at which the Charge will end. -
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 Charge. -
integrationId:
string()
Title:
Integration IdRate Plan Charge ID from SCM. -
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. -
pricePeriod:
string()
Title:
Price PeriodThe billing period. -
prices:
array Prices
Title:
PricesThe item prices. -
priceType:
string()
Title:
Price TypeThe type of charge. -
pricingMatrixVariableName:
string()
Title:
Pricing Matrix Variable NamePricing Matrix variable name (Preview only. Not available for use.) -
primaryCharge:
boolean()
Title:
Primary ChargeIndicates whether this is the primary charge. -
quantityAggregation:
boolean()
Title:
Quantity AggregationIndicates whether to use aggregated quantity when calculating unit price for tiered-pricing. -
rateCardName:
string()
Title:
Rate Card NameRead Only:trueRate Card name (Preview only. Not available for use.) -
rateCardVariableName:
string()
Title:
Rate Card Variable NameRate Card variable name (Preview only. Not available for use.) -
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 from which the Charge will be applicable. -
templateVariableName:
string()
Title:
Pricing Matrix Template Variable NameThe pricing matrix emplate variable name. -
tiers:
array Tiers
Title:
TiersThe charge tiers. -
usageUOM:
string()
Title:
Usage UOMThe unit of measure for the charge.
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 : PricingCurrencyValues
Type:
Show Source
object-
currencyCode:
string()
Title:
Currency CodeThe currency code. -
value:
number()
Title:
ValueThe currency value.
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 : ChargeTier
Type:
Show Source
object-
blockPrices:
array Block Prices
Title:
Block PricesThe block price for the corresponding tier. -
blockSize:
number()
Title:
Block SizeThe block size for the corresponding tier. -
prices:
array Prices
Title:
PricesThe prices. -
rangeFrom:
number()
Title:
Range FromThe starting range of the Charge. -
rangeTo:
number()
Title:
Range ToRead Only:trueThe ending range of the Charge.
Nested Schema : Block Prices
Type:
arrayTitle:
Block PricesThe block price for the corresponding tier.
Show Source
Examples
The following example shows how to add a charge for the specified Price Model Item by submitting a POST request to the REST resource using cURL. For more information about cURL, see Use cURL.
curl - X POST -H "Authorization: Bearer <token>" - H "Content-type: application/json" https://sitename.oracle.com/rest/v19/pricingSetup/models/_defaultPriceModel/priceModelItems/36947090/charges
Request Body Sample
{
"chargeDefinitionCode": "ONE_TIME_SALES_PRICE",
"primaryCharge": false,
"dynamicPricingType": "static",
"priceType": "One Time",
"prices": [{
"currencyCode": "USD",
"value": 59.99
}
]
}Response Body Sample
{
"id": 36988774,
"dateModified": "2023-09-22T15:01:38Z",
"dateAdded": "2023-09-22T15:01:38Z",
"prices": [{
"currencyCode": "USD",
"value": 59.99
}
],
"chargeDefinition": "One-time Price",
"chargeDefinitionCode": "ONE_TIME_SALES_PRICE",
"chargeDefinitionId": 36895950,
"primaryCharge": false,
"chargeType": "ORA_SALE",
"priceType": "One Time",
"dynamicPricingType": "static",
"globalMarkets_c": "northAmerica_c"
}