createSku
post
/ccadmin/v1/skus
Create Sku. Create a SKU for product based on the input request parameters. The request contains dynamic properties associated with product type. **Requires the x-ccasset-language header so translated content can be set for a specific language.**
Request
Supported Media Types
- application/json
Header Parameters
- X-CCAsset-Language
-
Type:
stringRequired:trueThe asset language of the request
Body Parameter
Root Schema : createSku_request
{
"productFamily":null,
"salePriceStartDate":"2017-11-11T18:30:00.000Z",
"quantity":15,
"productId":"xsku100234",
"color":"Brown",
"unitOfMeasure":null,
"nonreturnable":false,
"salePrice":"10",
"displayName":"SKU One",
"active":true,
"listPrices":{
"defaultPriceGroup":"20"
},
"salePrices":{
"defaultPriceGroup":"10"
},
"productLine":null,
"listVolumePrices":{
"UsDollar":{
"bulkPrice":{
"numLevels":3,
"levels":[
{
"price":19,
"levelMinimum":1,
"levelMaximum":5
},
{
"price":12.35,
"levelMinimum":21,
"levelMaximum":30
},
{
"price":10.25,
"levelMinimum":31
}
]
}
}
},
"size":"Small",
"model":null,
"id":"sku1",
"barcode":null,
"saleVolumePrices":{
"UsDollar":{
"bulkPrice":{
"numLevels":3,
"levels":[
{
"price":19,
"levelMinimum":1,
"levelMaximum":5
},
{
"price":12.35,
"levelMinimum":21,
"levelMaximum":30
},
{
"price":10.25,
"levelMinimum":31
}
]
}
}
},
"configurable":"false",
"listPrice":"20",
"salePriceEndDate":"2018-03-11T18:30:00.000Z"
}
- active
-
Type:
booleanIndicates whether SKU is active or inactive. Inactive SKUs will not appear on the storefront. This property value defaults to true. - barcode
-
Type:
stringBarcode property of the SKU. - configurable
-
Type:
booleanIndicates whether the SKU is configurable or not. - displayName
-
Type:
stringDisplay name of the SKU. - id
-
Type:
stringRequired:trueVariant ID. - images
-
Type:
arrayimagesAdditional Properties Allowed:Array of images to be associated to the SKU. - includePrices
-
Type:
booleanBoolean flag to determine whether to include price maps for the skus in the response. - listPrice
-
Type:
numberList price of the SKU in the default price group. Required if listPrices does not set the price for the default price group. - listVolumePrices
-
Type:
objectlistVolumePricesAdditional Properties Allowed:Object with price group IDs as keys and List prices as volumes. - model
-
Type:
stringModel property of the SKU. - nonreturnable
-
Type:
booleanIndicates whether the SKU is returnable or not. - priceListGroupId
-
Type:
stringPrice list group id for adding the prices to the SKU in the response. - productFamily
-
Type:
stringProduct Family property of the SKU. - productId
-
Type:
stringRequired:trueID corresponding to the product. - productLine
-
Type:
stringProduct line property of the SKU. - productListingSku
-
Type:
booleanThis is true if this sku is the listing sku for a particular variant. - quantity
-
Type:
integerQuantity of the SKU. - salePrice
-
Type:
numberSale price of the SKU in the default price group. - salePriceEndDate
-
Type:
stringSale Price End Date of SKU. - salePriceStartDate
-
Type:
stringSale Price start date of the SKU. - saleVolumePrices
-
Type:
objectsaleVolumePricesAdditional Properties Allowed:Object with price group IDs as keys and Sale Prices as values. - unitOfMeasure
-
Type:
stringUnit Of Measure property of the SKU.
Nested Schema : images
Nested Schema : listVolumePrices
Type:
objectObject with price group IDs as keys and List prices as volumes.
- PriceGroupID1
-
Type:
objectPriceGroupID1Additional Properties Allowed:List price of the product in price group 1 - PriceGroupID2
-
Type:
objectPriceGroupID2Additional Properties Allowed:List price of the product in price group 2
Nested Schema : saleVolumePrices
Type:
objectObject with price group IDs as keys and Sale Prices as values.
- PriceGroupID1
-
Type:
objectPriceGroupID1Additional Properties Allowed:Sale price of the product in price group 1 - PriceGroupID2
-
Type:
objectPriceGroupID2Additional Properties Allowed:Sale price of the product in price group 2
Nested Schema : items
Type:
object- metadata
-
Type:
objectmetadataAdditional Properties Allowed:Seo meta info. - name
-
Type:
stringThe name of image. - path
-
Type:
stringThe relative path to the image. - repositoryId
-
Type:
stringRequired:trueThe repository Id of the image. - url
-
Type:
stringThe complete url of the image.
Nested Schema : metadata
Type:
objectSeo meta info.
- altText
-
Type:
stringAlt text for the image. - titleText
-
Type:
stringTitle text for the image.
Nested Schema : PriceGroupID1
Type:
objectList price of the product in price group 1
- pricingScheme
-
Type:
objectpricingSchemeAdditional Properties Allowed:Pricing scheme can be either tieredPrice or bulkPrice
Nested Schema : PriceGroupID2
Type:
objectList price of the product in price group 2
- pricingScheme
-
Type:
objectpricingSchemeAdditional Properties Allowed:Pricing scheme can be either tieredPrice or bulkPrice
Nested Schema : pricingScheme
Type:
objectPricing scheme can be either tieredPrice or bulkPrice
- levels
-
Type:
arraylevelsAdditional Properties Allowed:Price levels array for volume price - numLevels
-
Type:
numberNumber of levels in the volume price
Nested Schema : levels
Nested Schema : items
Type:
object- levelMaximum
-
Type:
numberminimum quantity for price level - levelMinimum
-
Type:
numberminimum quantity for price level - price
-
Type:
numberprice value for price level
Nested Schema : pricingScheme
Type:
objectPricing scheme can be either tieredPrice or bulkPrice
- levels
-
Type:
arraylevelsAdditional Properties Allowed:Price levels array for volume price - numLevels
-
Type:
numberNumber of levels in the volume price
Nested Schema : levels
Nested Schema : items
Type:
object- levelMaximum
-
Type:
numberminimum quantity for price level - levelMinimum
-
Type:
numberminimum quantity for price level - price
-
Type:
numberprice value for price level
Nested Schema : PriceGroupID1
Type:
objectSale price of the product in price group 1
- pricingScheme
-
Type:
objectpricingSchemeAdditional Properties Allowed:Pricing scheme can be either tieredPrice or bulkPrice
Nested Schema : PriceGroupID2
Type:
objectSale price of the product in price group 2
- pricingScheme
-
Type:
objectpricingSchemeAdditional Properties Allowed:Pricing scheme can be either tieredPrice or bulkPrice
Nested Schema : pricingScheme
Type:
objectPricing scheme can be either tieredPrice or bulkPrice
- levels
-
Type:
arraylevelsAdditional Properties Allowed:Price levels array for volume price - numLevels
-
Type:
numberNumber of levels in the volume price
Nested Schema : levels
Nested Schema : items
Type:
object- levelMaximum
-
Type:
numberminimum quantity for price level - levelMinimum
-
Type:
numberminimum quantity for price level - price
-
Type:
numberprice value for price level
Nested Schema : pricingScheme
Type:
objectPricing scheme can be either tieredPrice or bulkPrice
- levels
-
Type:
arraylevelsAdditional Properties Allowed:Price levels array for volume price - numLevels
-
Type:
numberNumber of levels in the volume price
Nested Schema : levels
Nested Schema : items
Type:
object- levelMaximum
-
Type:
numberminimum quantity for price level - levelMinimum
-
Type:
numberminimum quantity for price level - price
-
Type:
numberprice value for price level
Response
Supported Media Types
- application/json
200 Response
Following model is returned when operation succeeds.
Body
Root Schema : createSku_response
- active
-
Type:
booleanIndicates whether SKU is active or inactive. Inactive SKUs will not appear on the storefront. This property value defaults to true. - barcode
-
Type:
stringBarcode property of the sku. - bundleLinks
-
Type:
arraybundleLinksAdditional Properties Allowed:Array of bundle links associated with the SKU. - configurable
-
Type:
booleanIndicates whether the SKU is configurable or not. - displayName
-
Type:
stringDisplay name of the SKU. - fullImageURLs
-
Type:
arrayfullImageURLsAdditional Properties Allowed:Full Image URLs of SKU. - images
-
Type:
arrayimagesAdditional Properties Allowed:Array of images for the SKU. - largeImage
-
Type:
integerLarge image of the SKU. - largeImageURLs
-
Type:
arraylargeImageURLsAdditional Properties Allowed:Large Image URLs of SKU. - listPrice
-
Type:
numberList price of the SKU. - listVolumePrice
-
Type:
objectlistVolumePriceAdditional Properties Allowed:List volume price of the SKU. - listVolumePrices
-
Type:
objectlistVolumePricesAdditional Properties Allowed:Object with price group IDs as keys and list prices as values. - mediumImageURLs
-
Type:
arraymediumImageURLsAdditional Properties Allowed:Medium Image URLs SKU. - model
-
Type:
stringModel property of the SKU. - nonreturnable
-
Type:
booleanDetermines SKU product is returnable or not - primaryFullImageURL
-
Type:
stringPrimary full image URL. - primaryLargeImageURL
-
Type:
stringPrimary Large Image URL of SKU. - primaryMediumImageURL
-
Type:
stringPrimary Medium Image URL ID of SKU. - primarySmallImageURL
-
Type:
stringPrimary Small Image URL of SKU. - primarySourceImageURL
-
Type:
stringPrimary Source Image URL of SKU. - primaryThumbImageURL
-
Type:
stringPrimary Thumb Image URL of SKU. - productFamily
-
Type:
stringProduct Family property of the SKU. - productLine
-
Type:
stringProduct line property of the SKU. - productListingSku
-
Type:
booleanThis is true if this sku is the listing sku for a particular variant. - quantity
-
Type:
integerQuantity of the SKU. - repositoryId
-
Type:
stringRepository ID of the SKU. - salePrice
-
Type:
stringSale price of the SKU. - salePriceEndDate
-
Type:
integerSale price end date of the SKU. - salePriceStartDate
-
Type:
stringSale price start date of the SKU. - saleVolumePrice
-
Type:
objectsaleVolumePriceAdditional Properties Allowed:Sale volume price of the SKU. - saleVolumePrices
-
Type:
objectsaleVolumePricesAdditional Properties Allowed:Object with price group IDs as keys and sale prices as values. - smallImage
-
Type:
integerSmall image of the SKU. - smallImageURLs
-
Type:
arraysmallImageURLsAdditional Properties Allowed:Small Image URLs of SKU. - sourceImageURLs
-
Type:
arraysourceImageURLsAdditional Properties Allowed:Source Image URLs of SKU. - thumbImageURLs
-
Type:
arraythumbImageURLsAdditional Properties Allowed:Thumb Image URLs of SKU. - thumbnailImage
-
Type:
stringThumbnail image of the SKU. - unitOfMeasure
-
Type:
stringUnit Of Measure property of the SKU.
Nested Schema : bundleLinks
Nested Schema : fullImageURLs
Nested Schema : images
Nested Schema : largeImageURLs
Nested Schema : listVolumePrice
Type:
objectList volume price of the SKU.
- pricingScheme
-
Type:
objectpricingSchemeAdditional Properties Allowed:Pricing scheme can be either tieredPrice or bulkPrice
Nested Schema : listVolumePrices
Type:
objectObject with price group IDs as keys and list prices as values.
- PriceGroupID1
-
Type:
objectPriceGroupID1Additional Properties Allowed:List price of the SKU in price group 1 - PriceGroupID2
-
Type:
objectPriceGroupID2Additional Properties Allowed:List price of the SKU in price group 2
Nested Schema : mediumImageURLs
Nested Schema : saleVolumePrice
Type:
objectSale volume price of the SKU.
- pricingScheme
-
Type:
objectpricingSchemeAdditional Properties Allowed:Pricing scheme can be either tieredPrice or bulkPrice
Nested Schema : saleVolumePrices
Type:
objectObject with price group IDs as keys and sale prices as values.
- PriceGroupID1
-
Type:
objectPriceGroupID1Additional Properties Allowed:Sale price of the Sku in price group 1 - PriceGroupID2
-
Type:
objectPriceGroupID2Additional Properties Allowed:Sale price of the SKU in price group 2
Nested Schema : smallImageURLs
Nested Schema : sourceImageURLs
Nested Schema : thumbImageURLs
Nested Schema : items
Type:
object- item
-
Type:
objectitemAdditional Properties Allowed:The SKU that will be included into this bundle link - quantity
-
Type:
integerThe quantity of the item - repositoryId
-
Type:
stringThe id of the bundle link
Nested Schema : item
Type:
objectThe SKU that will be included into this bundle link
- displayName
-
Type:
stringThe name of the SKU included in the bundle link - repositoryId
-
Type:
stringThe id of the SKU included in the bundle link
Nested Schema : items
Type:
object- metadata
-
Type:
objectmetadataAdditional Properties Allowed:Seo meta info. - name
-
Type:
stringName of the image to be updated. - path
-
Type:
stringPath of the image to be updated. - repositoryId
-
Type:
stringRepository ID of the image. - tags
-
Type:
arraytagsAdditional Properties Allowed:Tags for the image. - url
-
Type:
stringThe complete url of the image.
Nested Schema : metadata
Type:
objectSeo meta info.
- altText
-
Type:
stringAlt text for image. - titleText
-
Type:
stringTitle text for image.
Nested Schema : pricingScheme
Type:
objectPricing scheme can be either tieredPrice or bulkPrice
- levels
-
Type:
arraylevelsAdditional Properties Allowed:Price levels array for volume price - numLevels
-
Type:
numberNumber of levels in the volume price
Nested Schema : levels
Nested Schema : items
Type:
object- levelMaximum
-
Type:
numberminimum quantity for price level - levelMinimum
-
Type:
numberminimum quantity for price level - price
-
Type:
numberprice value for price level
Nested Schema : PriceGroupID1
Type:
objectList price of the SKU in price group 1
- pricingScheme
-
Type:
objectpricingSchemeAdditional Properties Allowed:Pricing scheme can be either tieredPrice or bulkPrice
Nested Schema : PriceGroupID2
Type:
objectList price of the SKU in price group 2
- pricingScheme
-
Type:
objectpricingSchemeAdditional Properties Allowed:Pricing scheme can be either tieredPrice or bulkPrice
Nested Schema : pricingScheme
Type:
objectPricing scheme can be either tieredPrice or bulkPrice
- levels
-
Type:
arraylevelsAdditional Properties Allowed:Price levels array for volume price - numLevels
-
Type:
numberNumber of levels in the volume price
Nested Schema : levels
Nested Schema : items
Type:
object- levelMaximum
-
Type:
numberminimum quantity for price level - levelMinimum
-
Type:
numberminimum quantity for price level - price
-
Type:
numberprice value for price level
Nested Schema : pricingScheme
Type:
objectPricing scheme can be either tieredPrice or bulkPrice
- levels
-
Type:
arraylevelsAdditional Properties Allowed:Price levels array for volume price - numLevels
-
Type:
numberNumber of levels in the volume price
Nested Schema : levels
Nested Schema : items
Type:
object- levelMaximum
-
Type:
numberminimum quantity for price level - levelMinimum
-
Type:
numberminimum quantity for price level - price
-
Type:
numberprice value for price level
Nested Schema : pricingScheme
Type:
objectPricing scheme can be either tieredPrice or bulkPrice
- levels
-
Type:
arraylevelsAdditional Properties Allowed:Price levels array for volume price - numLevels
-
Type:
numberNumber of levels in the volume price
Nested Schema : levels
Nested Schema : items
Type:
object- levelMaximum
-
Type:
numberminimum quantity for price level - levelMinimum
-
Type:
numberminimum quantity for price level - price
-
Type:
numberprice value for price level
Nested Schema : PriceGroupID1
Type:
objectSale price of the Sku in price group 1
- pricingScheme
-
Type:
objectpricingSchemeAdditional Properties Allowed:Pricing scheme can be either tieredPrice or bulkPrice
Nested Schema : PriceGroupID2
Type:
objectSale price of the SKU in price group 2
- pricingScheme
-
Type:
objectpricingSchemeAdditional Properties Allowed:Pricing scheme can be either tieredPrice or bulkPrice
Nested Schema : pricingScheme
Type:
objectPricing scheme can be either tieredPrice or bulkPrice
- levels
-
Type:
arraylevelsAdditional Properties Allowed:Price levels array for volume price - numLevels
-
Type:
numberNumber of levels in the volume price
Nested Schema : levels
Nested Schema : items
Type:
object- levelMaximum
-
Type:
numberminimum quantity for price level - levelMinimum
-
Type:
numberminimum quantity for price level - price
-
Type:
numberprice value for price level
Nested Schema : pricingScheme
Type:
objectPricing scheme can be either tieredPrice or bulkPrice
- levels
-
Type:
arraylevelsAdditional Properties Allowed:Price levels array for volume price - numLevels
-
Type:
numberNumber of levels in the volume price
Nested Schema : levels
Nested Schema : items
Type:
object- levelMaximum
-
Type:
numberminimum quantity for price level - levelMinimum
-
Type:
numberminimum quantity for price level - price
-
Type:
numberprice value for price level
Example application/json
{
"productFamily":null,
"dynamicPropertyMapLong":{
"sku-MensApparel_color":2
},
"primaryThumbImageURL":null,
"bundleLinks":[
],
"largeImage":null,
"smallImage":null,
"color":"Blue",
"listVolumePrice":null,
"nonreturnable":false,
"displayName":"Sku One",
"salePrices":{
"defaultPriceGroup":null
},
"primaryFullImageURL":null,
"listPrices":{
"defaultPriceGroup":null
},
"productListingSku":null,
"largeImageURLs":[
],
"productLine":null,
"listVolumePrices":{
"defaultPriceGroup":null
},
"primaryLargeImageURL":null,
"smallImageURLs":[
],
"model":null,
"thumbnailImage":null,
"barcode":null,
"saleVolumePrices":{
"defaultPriceGroup":null
},
"salePriceEndDate":null,
"saleVolumePrice":null,
"salePriceStartDate":null,
"images":[
],
"quantity":null,
"unitOfMeasure":null,
"salePrice":null,
"primaryMediumImageURL":null,
"fullImageURLs":[
],
"dynamicPropertyMapBigString":{
},
"active":true,
"thumbImageURLs":[
],
"mediumImageURLs":[
],
"repositoryId":"sku1",
"primarySourceImageURL":null,
"primarySmallImageURL":null,
"sourceImageURLs":[
],
"listPrice":30,
"configurable":false
}
Default Response
The error response
Body
Root Schema : errorModel
Type:
object- devMessage
-
Type:
stringAn optional non-localized message containing technical information for developers - errorCode
-
Type:
stringThe numerical code identifying the error - errors
-
Type:
arrayerrorsAdditional Properties Allowed:An optional list of errors if multiple errors were encountered - message
-
Type:
stringThe localized message describing the error - moreInfo
-
Type:
stringAn optional non-localized message with more information - o:errorPath
-
Type:
stringAn optional machine readable description of where the error occurred - status
-
Type:
stringThe HTTP status code - type
-
Type:
stringThe URI to the HTTP state code definition
Nested Schema : errors
Nested Schema : items
Type:
object- devMessage
-
Type:
stringAn optional non-localized message containing technical information for developers - errorCode
-
Type:
stringThe numerical code identifying the error - message
-
Type:
stringThe localized message describing the error - moreInfo
-
Type:
stringAn optional non-localized message with more information - o:errorPath
-
Type:
stringAn optional machine readable description of where the error occurred - status
-
Type:
stringThe HTTP status code
Examples
Sample Request:
{
"productFamily": null,
"salePriceStartDate": "2017-11-11T18:30:00.000Z",
"quantity": 15,
"productId": "xsku100234",
"color": "Brown",
"unitOfMeasure": null,
"nonreturnable": false,
"salePrice": "10",
"displayName": "SKU One",
"active": true,
"listPrices": {"defaultPriceGroup": "20"},
"salePrices": {"defaultPriceGroup": "10"},
"productLine": null,
"listVolumePrices": {"UsDollar": {"bulkPrice": {
"numLevels": 3,
"levels": [
{
"price": 19,
"levelMinimum": 1,
"levelMaximum": 5
},
{
"price": 12.35,
"levelMinimum": 21,
"levelMaximum": 30
},
{
"price": 10.25,
"levelMinimum": 31
}
]
}}},
"size": "Small",
"model": null,
"id": "sku1",
"barcode": null,
"saleVolumePrices": {"UsDollar": {"bulkPrice": {
"numLevels": 3,
"levels": [
{
"price": 19,
"levelMinimum": 1,
"levelMaximum": 5
},
{
"price": 12.35,
"levelMinimum": 21,
"levelMaximum": 30
},
{
"price": 10.25,
"levelMinimum": 31
}
]
}}},
"configurable": "false",
"listPrice": "20",
"salePriceEndDate": "2018-03-11T18:30:00.000Z"
}
Sample Response Payload returned by endpoint:
{
"productFamily": null,
"dynamicPropertyMapLong": {"sku-MensApparel_color": 2},
"primaryThumbImageURL": null,
"bundleLinks": [],
"largeImage": null,
"smallImage": null,
"color": "Blue",
"listVolumePrice": null,
"nonreturnable": false,
"displayName": "Sku One",
"salePrices": {"defaultPriceGroup": null},
"primaryFullImageURL": null,
"listPrices": {"defaultPriceGroup": null},
"productListingSku": null,
"largeImageURLs": [],
"productLine": null,
"listVolumePrices": {"defaultPriceGroup": null},
"primaryLargeImageURL": null,
"smallImageURLs": [],
"model": null,
"thumbnailImage": null,
"barcode": null,
"saleVolumePrices": {"defaultPriceGroup": null},
"salePriceEndDate": null,
"saleVolumePrice": null,
"salePriceStartDate": null,
"images": [],
"quantity": null,
"unitOfMeasure": null,
"salePrice": null,
"primaryMediumImageURL": null,
"fullImageURLs": [],
"dynamicPropertyMapBigString": {},
"active": true,
"thumbImageURLs": [],
"mediumImageURLs": [],
"repositoryId": "sku1",
"primarySourceImageURL": null,
"primarySmallImageURL": null,
"sourceImageURLs": [],
"listPrice": 30,
"configurable": false
}