1. REST API for Oracle Commerce Cloud 21B
  2. Tasks
  3. Admin
  4. Skus

updateSku

put

/ccadmin/v1/skus/{id}

Update Sku. Updates a SKU based on the input request parameters. **Requires the x-ccasset-language header so translated content can be set for a specific language.**

Request

Supported Media Types
Path Parameters
Header Parameters
Body ()
Root Schema : updateSku_request
Type: object
Show Source
Example:
{
    "productFamily":null,
    "bundleLinks":[
        {
            "item":{
                "repositoryId":"sku30001"
            },
            "quantity":1
        },
        {
            "item":{
                "repositoryId":"sku30002"
            },
            "quantity":2
        }
    ],
    "salePrice":"300",
    "nonreturnable":false,
    "displayName":"SKU One",
    "active":false,
    "listPrices":{
        "UsDollar":"500"
    },
    "salePrices":{
        "UsDollar":"300"
    },
    "configurationMetadata":[
        {
            "name":"bundleSelected",
            "repositoryId":"cmi10001",
            "value":"Better Double"
        }
    ],
    "productLine":null,
    "listVolumePrices":{
        "CaDollar":{
            "bulkPrice":{
                "numLevels":3,
                "levels":[
                    {
                        "price":19,
                        "levelMinimum":1,
                        "levelMaximum":5
                    },
                    {
                        "price":12.35,
                        "levelMinimum":21,
                        "levelMaximum":30
                    },
                    {
                        "price":10.25,
                        "levelMinimum":31
                    }
                ]
            }
        }
    },
    "soldAsPackage":false,
    "model":null,
    "discountable":true,
    "saleVolumePrices":{
        "CaDollar":{
            "bulkPrice":{
                "numLevels":3,
                "levels":[
                    {
                        "price":19,
                        "levelMinimum":1,
                        "levelMaximum":5
                    },
                    {
                        "price":12.35,
                        "levelMinimum":21,
                        "levelMaximum":30
                    },
                    {
                        "price":10.25,
                        "levelMinimum":31
                    }
                ]
            }
        }
    },
    "barcode":null,
    "listPrice":"500",
    "configurable":"false"
}
Nested Schema : configurationMetadata
Type: array
Array of configuration attributes associated with the SKU.
Show Source
Nested Schema : images
Type: array
Array of images to be associated to the SKU.
Show Source
Nested Schema : listVolumePrices
Type: object
Object with price group IDs as keys and list prices as values
Show Source
Nested Schema : saleVolumePrices
Type: object
Object with price group IDs as keys and sale prices as values
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : metadata
Type: object
Seo meta info.
Show Source
Nested Schema : PriceGroupID1
Type: object
List price of the product in price group 1
Show Source
Nested Schema : PriceGroupID2
Type: object
List price of the product in price group 2
Show Source
Nested Schema : pricingScheme
Type: object
Pricing scheme can be either tieredPrice or bulkPrice
Show Source
Nested Schema : levels
Type: array
Price levels array for volume price
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : pricingScheme
Type: object
Pricing scheme can be either tieredPrice or bulkPrice
Show Source
Nested Schema : levels
Type: array
Price levels array for volume price
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : PriceGroupID1
Type: object
Sale price of the product in price group 1
Show Source
Nested Schema : PriceGroupID2
Type: object
Sale price of the product in price group 2
Show Source
Nested Schema : pricingScheme
Type: object
Pricing scheme can be either tieredPrice or bulkPrice
Show Source
Nested Schema : levels
Type: array
Price levels array for volume price
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : pricingScheme
Type: object
Pricing scheme can be either tieredPrice or bulkPrice
Show Source
Nested Schema : levels
Type: array
Price levels array for volume price
Show Source
Nested Schema : items
Type: object
Show Source
Back to Top

Response

Supported Media Types

200 Response

Following model is returned when operation succeeds.
Body ()
Root Schema : updateSku_response
Type: object
Show Source
Nested Schema : configurationMetadata
Type: array
Array of configuration attributes associated with the SKU.
Show Source
Nested Schema : fullImageURLs
Type: array
Full Image URLs of SKU.
Show Source
Nested Schema : images
Type: array
Array of images for the SKU.
Show Source
Nested Schema : largeImageURLs
Type: array
Large Image URLs of SKU.
Show Source
Nested Schema : listVolumePrice
Type: object
List volume price of the SKU.
Show Source
Nested Schema : listVolumePrices
Type: object
Object with price group IDs as keys and list prices as values.
Show Source
Nested Schema : mediumImageURLs
Type: array
Medium Image URLs SKU.
Show Source
Nested Schema : saleVolumePrice
Type: object
Sale volume price of the SKU.
Show Source
Nested Schema : saleVolumePrices
Type: object
Object with price group IDs as keys and sale prices as values.
Show Source
Nested Schema : smallImageURLs
Type: array
Small Image URLs of SKU.
Show Source
Nested Schema : sourceImageURLs
Type: array
Source Image URLs of SKU.
Show Source
Nested Schema : thumbImageURLs
Type: array
Thumb Image URLs of SKU.
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : metadata
Type: object
Seo meta info.
Show Source
Nested Schema : tags
Type: array
Tags for the image.
Show Source
Nested Schema : pricingScheme
Type: object
Pricing scheme can be either tieredPrice or bulkPrice
Show Source
Nested Schema : levels
Type: array
Price levels array for volume price
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : PriceGroupID1
Type: object
List price of the SKU in price group 1
Show Source
Nested Schema : PriceGroupID2
Type: object
List price of the SKU in price group 2
Show Source
Nested Schema : pricingScheme
Type: object
Pricing scheme can be either tieredPrice or bulkPrice
Show Source
Nested Schema : levels
Type: array
Price levels array for volume price
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : pricingScheme
Type: object
Pricing scheme can be either tieredPrice or bulkPrice
Show Source
Nested Schema : levels
Type: array
Price levels array for volume price
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : pricingScheme
Type: object
Pricing scheme can be either tieredPrice or bulkPrice
Show Source
Nested Schema : levels
Type: array
Price levels array for volume price
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : PriceGroupID1
Type: object
Sale price of the Sku in price group 1
Show Source
Nested Schema : PriceGroupID2
Type: object
Sale price of the SKU in price group 2
Show Source
Nested Schema : pricingScheme
Type: object
Pricing scheme can be either tieredPrice or bulkPrice
Show Source
Nested Schema : levels
Type: array
Price levels array for volume price
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : pricingScheme
Type: object
Pricing scheme can be either tieredPrice or bulkPrice
Show Source
Nested Schema : levels
Type: array
Price levels array for volume price
Show Source
Nested Schema : items
Type: object
Show Source
Example Response (application/json)
{
    "productFamily":null,
    "dynamicPropertyMapLong":{
        "sku-MensApparel_color":2
    },
    "primaryThumbImageURL":null,
    "bundleLinks":[
        {
            "item":{
                "displayName":"Blue T Shirt",
                "repositoryId":"sku30001"
            },
            "quantity":1,
            "repositoryId":"skul10001"
        },
        {
            "item":{
                "displayName":"Red T Shirt",
                "repositoryId":"sku30002"
            },
            "quantity":1,
            "repositoryId":"skul10002"
        }
    ],
    "largeImage":null,
    "smallImage":null,
    "color":"Blue",
    "listVolumePrice":{
        "bulkPrice":{
            "numLevels":3,
            "levels":[
                {
                    "price":19,
                    "levelMinimum":1,
                    "levelMaximum":5
                },
                {
                    "price":12.35,
                    "levelMinimum":21,
                    "levelMaximum":30
                },
                {
                    "price":10.25,
                    "levelMinimum":31
                }
            ]
        }
    },
    "nonreturnable":false,
    "displayName":"sku One",
    "salePrices":{
        "UsDollar":"300"
    },
    "primaryFullImageURL":null,
    "listPrices":{
        "UsDollar":"500"
    },
    "configurationMetadata":[
        {
            "name":"bundleSelected",
            "repositoryId":"cmi10001",
            "value":"Better Double"
        }
    ],
    "productListingSku":null,
    "largeImageURLs":[
    ],
    "productLine":null,
    "listVolumePrices":{
        "CaDollar":{
            "bulkPrice":{
                "numLevels":3,
                "levels":[
                    {
                        "price":19,
                        "levelMinimum":1,
                        "levelMaximum":5
                    },
                    {
                        "price":12.35,
                        "levelMinimum":21,
                        "levelMaximum":30
                    },
                    {
                        "price":10.25,
                        "levelMinimum":31
                    }
                ]
            }
        }
    },
    "primaryLargeImageURL":null,
    "smallImageURLs":[
    ],
    "derivedSalePriceFrom":"UsDollar",
    "model":null,
    "thumbnailImage":null,
    "discountable":true,
    "barcode":null,
    "saleVolumePrices":{
        "CaDollar":{
            "bulkPrice":{
                "numLevels":3,
                "levels":[
                    {
                        "price":19,
                        "levelMinimum":1,
                        "levelMaximum":5
                    },
                    {
                        "price":12.35,
                        "levelMinimum":21,
                        "levelMaximum":30
                    },
                    {
                        "price":10.25,
                        "levelMinimum":31
                    }
                ]
            }
        }
    },
    "salePriceEndDate":null,
    "saleVolumePrice":{
        "bulkPrice":{
            "numLevels":3,
            "levels":[
                {
                    "price":19,
                    "levelMinimum":1,
                    "levelMaximum":5
                },
                {
                    "price":12.35,
                    "levelMinimum":21,
                    "levelMaximum":30
                },
                {
                    "price":10.25,
                    "levelMinimum":31
                }
            ]
        }
    },
    "salePriceStartDate":null,
    "images":[
    ],
    "quantity":null,
    "unitOfMeasure":null,
    "salePrice":"300",
    "primaryMediumImageURL":null,
    "fullImageURLs":[
    ],
    "dynamicPropertyMapBigString":{
    },
    "active":false,
    "thumbImageURLs":[
    ],
    "soldAsPackage":false,
    "mediumImageURLs":[
    ],
    "repositoryId":"sku1",
    "derivedListPriceFrom":"UsDollar",
    "primarySourceImageURL":null,
    "primarySmallImageURL":null,
    "sourceImageURLs":[
    ],
    "listPrice":"500",
    "configurable":"false"
}

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| |------------------|------------------| |26041|attempt to set or query property {0} with invalid enumeration value {1}.| |26051|Active property value can only be a Boolean.| |26300|The SKU {0} is already part of a SKU bundle| |26048|Missing variant property for item: {0}, {1}| |26301|Item is required for BundleLinks.| |26304|The SKU {0} is already a SKU bundle.| |26303|{0} is an invalid SKU ID.| |26306|Internal Error| |26305|The ID for the SKU bundle cannot be the same as the ID for one of its bundle links.| |26307|Invalid Quantity Value.|
Body ()
Root Schema : errorModel
Type: object
Show Source
Nested Schema : errors
Type: array
An optional list of errors if multiple errors were encountered
Show Source
Nested Schema : items
Type: object
Show Source
Back to Top