1. REST API for Oracle Commerce Cloud December 2017
  2. Tasks
  3. Admin
  4. Prices

updatePrices

put

/ccadmin/v1/prices

Update Prices. Updates a list of prices or creates a new price item if there isn't one.

Request

Supported Media Types
  • application/json
Body Parameter
Root Schema : updatePrices_request
Nested Schema : items
Type: array
List of Prices
Nested Schema : items
Type: object
Nested Schema : volumePrice
Type: object
Volume price of the price item
Nested Schema : pricingScheme
Type: object
Pricing scheme can be either tieredPrice or bulkPrice
Nested Schema : levels
Type: array
Price levels array for volume price
Nested Schema : items
Type: object

Response

Supported Media Types
  • application/json
200 Response
Following model is returned when operation succeeds.
Body
Root Schema : updatePrices_response
Nested Schema : items
Type: array
List of Prices
Nested Schema : items
Type: object
Nested Schema : volumePrice
Type: object
Volume price of the price item
Nested Schema : pricingScheme
Type: object
Pricing scheme can be either tieredPrice or bulkPrice
Nested Schema : levels
Type: array
Price levels array for volume price
Nested Schema : items
Type: object
Example application/json

{
    "items":[
        {
            "productId":"prod10014",
            "priceListId":"listPrices",
            "listPrice":50
        },
        {
            "productId":"prod10014",
            "volumePrice":{
                "bulkPrice":{
                    "numLevels":3,
                    "levels":[
                        {
                            "price":19,
                            "levelMaximum":5,
                            "levelMinimum":1
                        },
                        {
                            "price":12.35,
                            "levelMaximum":30,
                            "levelMinimum":21
                        },
                        {
                            "price":10.25,
                            "levelMinimum":31
                        }
                    ]
                }
            },
            "priceListId":"listPrices",
            "skuId":"sku10040"
        }
    ]
}
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| |------------------|------------------| |100173|Input data is missing.| |100174|Invalid input data.| |100175|Not a valid input format for the data.| |100176|Input items to be updated exceeded the max limit 25.|
Body
Root Schema : errorModel
Type: object
Nested Schema : errors
Type: array
An optional list of errors if multiple errors were encountered
Nested Schema : items
Type: object

Examples

Sample Request:

{"items": [
  {
    "productId": "prod10014",
    "priceListId": "listPrices",
    "listPrice": 50
  },
  {
    "productId": "prod10014",
    "volumePrice": {"bulkPrice": {
      "numLevels": 3,
      "levels": [
        {
          "price": 19,
          "levelMaximum": 5,
          "levelMinimum": 1
        },
        {
          "price": 12.35,
          "levelMaximum": 30,
          "levelMinimum": 21
        },
        {
          "price": 10.25,
          "levelMinimum": 31
        }
      ]
    }},
    "priceListId": "listPrices",
    "skuId": "sku10040"
  }
]}

Sample Response Payload returned by endpoint:

{"items": [
  {
    "productId": "prod10014",
    "priceListId": "listPrices",
    "listPrice": 50
  },
  {
    "productId": "prod10014",
    "volumePrice": {"bulkPrice": {
      "numLevels": 3,
      "levels": [
        {
          "price": 19,
          "levelMaximum": 5,
          "levelMinimum": 1
        },
        {
          "price": 12.35,
          "levelMaximum": 30,
          "levelMinimum": 21
        },
        {
          "price": 10.25,
          "levelMinimum": 31
        }
      ]
    }},
    "priceListId": "listPrices",
    "skuId": "sku10040"
  }
]}