updatePriceListGroup
put
/ccadmin/v1/priceListGroups/{id}
Update Price List Group. Updates an existing PriceListGroup based on PriceListGroup ID provided,specific properties have to be specified for getting them updated. Optionally takes the x-ccasset-language header to get translated content in another language.
Request
Supported Media Types
- application/json
Path Parameters
-
id: string
PriceListGroup ID corresponding to the PriceListGroup to be updated.
Query Parameters
-
includeAncestors(optional): boolean
If true, returns PriceListGroup's ancestor information in the response. Default is false.It can not be used to update base/ancestor price list groups. It is a read only property.
Header Parameters
-
X-CCAsset-Language: string
The asset language of the request
Root Schema : updatePriceListGroup_request
Type:
Show Source
object
-
basePriceListGroup(optional):
object basePriceListGroup
The base price list group of this price list group.
-
displayName(optional):
string
The display name of the PriceListGroup.
-
endDate(optional):
string
End date of the the associated list price list
-
includeAllProducts(optional):
boolean
If true, and active flag is also set to true then list price is mandatory for all products.
-
startDate(optional):
string
Start date of the the associated list price list
Example:
{
"endDate":"2017-03-12T00:00:00.000+05:30",
"displayName":"Canadian Dollar",
"basePriceListGroup":{
"id":"canadianDollarSale"
},
"includeAllProducts":false,
"startDate":"2016-03-11T00:00:00.000+05:30"
}
Nested Schema : basePriceListGroup
Type:
object
The base price list group of this price list group.
Show Source
-
id(optional):
string
Repository ID of the base price list group.
Response
Supported Media Types
- application/json
200 Response
Following model is returned when operation succeeds.
Root Schema : updatePriceListGroup_response
Type:
Show Source
object
-
active(optional):
boolean
indicates if the PriceListGroup is active
-
basePriceListGroup(optional):
object basePriceListGroup
The base price list group of this price list group.
-
currency(optional):
object currency
The currency data.
-
deleted(optional):
boolean
indicates if the PriceListGroup is deleted
-
displayName(optional):
string
display name of the PriceListGroup
-
endDate(optional):
string
End date of the the associated list price list
-
id(optional):
string
The ID of the PriceListGroup item
-
includeAllProducts(optional):
boolean
If true, indicates that all the products in the catalog should have prices for activation of the PLG
-
isPointsBased(optional):
boolean
If true, indicates the PriceListGroup was created with a point based currency
-
isTaxIncluded(optional):
boolean
Indicates whether prices are inclusive of tax.
-
listPriceList(optional):
object listPriceList
The price list for list prices
-
locale(optional):
string
locale of the the associated list price list
-
repositoryId(optional):
string
The ID of the PriceListGroup item
-
salePriceList(optional):
object salePriceList
The price list for sale prices
-
shippingSurchargePriceList(optional):
object shippingSurchargePriceList
The price list for shipping surcharge prices
-
startDate(optional):
string
Start date of the the associated list price list
-
taxCalculationType(optional):
string
Indicates how tax calls are made based on the PriceListGroup setting. For a monetary PriceListGroup, the possible values are calculateTax and doNotCalculateTax.??For a point based PriceListGroup, the possible values are doNotCalculateTax, calculateTaxWithCurrencyConversion and calculateTaxWithoutCurrencyConversion.
Nested Schema : basePriceListGroup
Type:
object
The base price list group of this price list group.
Show Source
-
displayName(optional):
string
Name of the base price list group.
-
id(optional):
string
Repository ID of the base price list group.
Nested Schema : currency
Type:
object
The currency data.
Show Source
-
currencyCode(optional):
string
The currency Code of the currency
-
displayName(optional):
string
The display Name of the currency
-
fractionalDigits(optional):
string
The currency Code of the currency
-
numericCode(optional):
string
The numeric Code of the currency
-
repositoryId(optional):
string
The repository Id of the currency
-
symbol(optional):
string
The symbol of the currency
Nested Schema : listPriceList
Type:
object
The price list for list prices
Show Source
-
repositoryId(optional):
string
Repository ID
Nested Schema : salePriceList
Type:
object
The price list for sale prices
Show Source
-
repositoryId(optional):
string
Repository ID
Nested Schema : shippingSurchargePriceList
Type:
object
The price list for shipping surcharge prices
Show Source
-
repositoryId(optional):
string
Repository ID
Example Response (application/json)
{
"isTaxIncluded":false,
"endDate":"2016-03-11T18:30:00.000Z",
"displayName":"Canadian Dollar",
"listPriceList":{
"repositoryId":"CanadianDollar_listPrice"
},
"active":false,
"basePriceListGroup":{
"displayName":"Canadian Dollar Sale",
"id":"canadianDollarSale"
},
"locale":"en_US",
"shippingSurchargePriceList":{
"repositoryId":"CanadianDollar_shippingSurchargePrice"
},
"repositoryId":"CanadianDollar",
"salePriceList":{
"repositoryId":"CanadianDollar_salePrice"
},
"currency":{
"symbol":"$",
"displayName":"US Dollar",
"repositoryId":"en_US",
"fractionalDigits":2,
"currencyCode":"USD",
"numericCode":"840"
},
"links":[
{
"rel":"self",
"href":"/priceListGroups/CanadianDollar"
}
],
"id":"CanadianDollar",
"includeAllProducts":false,
"startDate":"2016-03-10T18:30:00.000Z"
}
Default Response
The error response.
The following are the internal error codes thrown by this API when the request processing fails in Oracle Commerce Cloud:
|Error Code|Description|
|------------------|------------------|
|20187|No price list group found for the id : invalidId|
|13036|Locale key is not valid|
|20192|Attempt to change the value of a read only property id|
|20402|Attempt to change the value of a read only property locale|
|20403|Attempt to change the value of a read only property isTaxIncluded|
|20406|Attempt to change the value of a read only property taxCalculationType|
|20408|Include all Products cannot be set to true if there is a base price list group.|
Root Schema : errorModel
Type:
Show Source
object
-
devMessage(optional):
string
An optional non-localized message containing technical information for developers
-
errorCode(optional):
string
The numerical code identifying the error
-
errors(optional):
array errors
An optional list of errors if multiple errors were encountered
-
message(optional):
string
The localized message describing the error
-
moreInfo(optional):
string
An optional non-localized message with more information
-
o:errorPath(optional):
string
An optional machine readable description of where the error occurred
-
status(optional):
string
The HTTP status code
-
type(optional):
string
The URI to the HTTP state code definition
Nested Schema : errors
Type:
array
An optional list of errors if multiple errors were encountered
Show Source
Nested Schema : items
Type:
Show Source
object
-
devMessage(optional):
string
An optional non-localized message containing technical information for developers
-
errorCode(optional):
string
The numerical code identifying the error
-
message(optional):
string
The localized message describing the error
-
moreInfo(optional):
string
An optional non-localized message with more information
-
o:errorPath(optional):
string
An optional machine readable description of where the error occurred
-
status(optional):
string
The HTTP status code