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:
string
Required:true
The 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:
boolean
Indicates whether SKU is active or inactive. Inactive SKUs will not appear on the storefront. This property value defaults to true. - barcode
-
Type:
string
Barcode property of the SKU. - configurable
-
Type:
boolean
Indicates whether the SKU is configurable or not. - displayName
-
Type:
string
Display name of the SKU. - id
-
Type:
string
Required:true
Variant ID. - images
-
Type:
array
imagesAdditional Properties Allowed:Array of images to be associated to the SKU. - includePrices
-
Type:
boolean
Boolean flag to determine whether to include price maps for the skus in the response. - listPrice
-
Type:
number
List price of the SKU in the default price group. Required if listPrices does not set the price for the default price group. - listVolumePrices
-
Type:
object
listVolumePricesAdditional Properties Allowed:Object with price group IDs as keys and List prices as volumes. - model
-
Type:
string
Model property of the SKU. - nonreturnable
-
Type:
boolean
Indicates whether the SKU is returnable or not. - priceListGroupId
-
Type:
string
Price list group id for adding the prices to the SKU in the response. - productFamily
-
Type:
string
Product Family property of the SKU. - productId
-
Type:
string
Required:true
ID corresponding to the product. - productLine
-
Type:
string
Product line property of the SKU. - productListingSku
-
Type:
boolean
This is true if this sku is the listing sku for a particular variant. - quantity
-
Type:
integer
Quantity of the SKU. - salePrice
-
Type:
number
Sale price of the SKU in the default price group. - salePriceEndDate
-
Type:
string
Sale Price End Date of SKU. - salePriceStartDate
-
Type:
string
Sale Price start date of the SKU. - saleVolumePrices
-
Type:
object
saleVolumePricesAdditional Properties Allowed:Object with price group IDs as keys and Sale Prices as values. - unitOfMeasure
-
Type:
string
Unit Of Measure property of the SKU.
Nested Schema : images
Nested Schema : listVolumePrices
Type:
object
Object with price group IDs as keys and List prices as volumes.
- PriceGroupID1
-
Type:
object
PriceGroupID1Additional Properties Allowed:List price of the product in price group 1 - PriceGroupID2
-
Type:
object
PriceGroupID2Additional Properties Allowed:List price of the product in price group 2
Nested Schema : saleVolumePrices
Type:
object
Object with price group IDs as keys and Sale Prices as values.
- PriceGroupID1
-
Type:
object
PriceGroupID1Additional Properties Allowed:Sale price of the product in price group 1 - PriceGroupID2
-
Type:
object
PriceGroupID2Additional Properties Allowed:Sale price of the product in price group 2
Nested Schema : items
Type:
object
- metadata
-
Type:
object
metadataAdditional Properties Allowed:Seo meta info. - name
-
Type:
string
The name of image. - path
-
Type:
string
The relative path to the image. - repositoryId
-
Type:
string
Required:true
The repository Id of the image. - url
-
Type:
string
The complete url of the image.
Nested Schema : metadata
Type:
object
Seo meta info.
- altText
-
Type:
string
Alt text for the image. - titleText
-
Type:
string
Title text for the image.
Nested Schema : PriceGroupID1
Type:
object
List price of the product in price group 1
- pricingScheme
-
Type:
object
pricingSchemeAdditional Properties Allowed:Pricing scheme can be either tieredPrice or bulkPrice
Nested Schema : PriceGroupID2
Type:
object
List price of the product in price group 2
- pricingScheme
-
Type:
object
pricingSchemeAdditional Properties Allowed:Pricing scheme can be either tieredPrice or bulkPrice
Nested Schema : pricingScheme
Type:
object
Pricing scheme can be either tieredPrice or bulkPrice
- levels
-
Type:
array
levelsAdditional Properties Allowed:Price levels array for volume price - numLevels
-
Type:
number
Number of levels in the volume price
Nested Schema : levels
Nested Schema : items
Type:
object
- levelMaximum
-
Type:
number
minimum quantity for price level - levelMinimum
-
Type:
number
minimum quantity for price level - price
-
Type:
number
price value for price level
Nested Schema : pricingScheme
Type:
object
Pricing scheme can be either tieredPrice or bulkPrice
- levels
-
Type:
array
levelsAdditional Properties Allowed:Price levels array for volume price - numLevels
-
Type:
number
Number of levels in the volume price
Nested Schema : levels
Nested Schema : items
Type:
object
- levelMaximum
-
Type:
number
minimum quantity for price level - levelMinimum
-
Type:
number
minimum quantity for price level - price
-
Type:
number
price value for price level
Nested Schema : PriceGroupID1
Type:
object
Sale price of the product in price group 1
- pricingScheme
-
Type:
object
pricingSchemeAdditional Properties Allowed:Pricing scheme can be either tieredPrice or bulkPrice
Nested Schema : PriceGroupID2
Type:
object
Sale price of the product in price group 2
- pricingScheme
-
Type:
object
pricingSchemeAdditional Properties Allowed:Pricing scheme can be either tieredPrice or bulkPrice
Nested Schema : pricingScheme
Type:
object
Pricing scheme can be either tieredPrice or bulkPrice
- levels
-
Type:
array
levelsAdditional Properties Allowed:Price levels array for volume price - numLevels
-
Type:
number
Number of levels in the volume price
Nested Schema : levels
Nested Schema : items
Type:
object
- levelMaximum
-
Type:
number
minimum quantity for price level - levelMinimum
-
Type:
number
minimum quantity for price level - price
-
Type:
number
price value for price level
Nested Schema : pricingScheme
Type:
object
Pricing scheme can be either tieredPrice or bulkPrice
- levels
-
Type:
array
levelsAdditional Properties Allowed:Price levels array for volume price - numLevels
-
Type:
number
Number of levels in the volume price
Nested Schema : levels
Nested Schema : items
Type:
object
- levelMaximum
-
Type:
number
minimum quantity for price level - levelMinimum
-
Type:
number
minimum quantity for price level - price
-
Type:
number
price 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:
boolean
Indicates whether SKU is active or inactive. Inactive SKUs will not appear on the storefront. This property value defaults to true. - barcode
-
Type:
string
Barcode property of the sku. - bundleLinks
-
Type:
array
bundleLinksAdditional Properties Allowed:Array of bundle links associated with the SKU. - configurable
-
Type:
boolean
Indicates whether the SKU is configurable or not. - displayName
-
Type:
string
Display name of the SKU. - fullImageURLs
-
Type:
array
fullImageURLsAdditional Properties Allowed:Full Image URLs of SKU. - images
-
Type:
array
imagesAdditional Properties Allowed:Array of images for the SKU. - largeImage
-
Type:
integer
Large image of the SKU. - largeImageURLs
-
Type:
array
largeImageURLsAdditional Properties Allowed:Large Image URLs of SKU. - listPrice
-
Type:
number
List price of the SKU. - listVolumePrice
-
Type:
object
listVolumePriceAdditional Properties Allowed:List volume price of the SKU. - listVolumePrices
-
Type:
object
listVolumePricesAdditional Properties Allowed:Object with price group IDs as keys and list prices as values. - mediumImageURLs
-
Type:
array
mediumImageURLsAdditional Properties Allowed:Medium Image URLs SKU. - model
-
Type:
string
Model property of the SKU. - nonreturnable
-
Type:
boolean
Determines SKU product is returnable or not - primaryFullImageURL
-
Type:
string
Primary full image URL. - primaryLargeImageURL
-
Type:
string
Primary Large Image URL of SKU. - primaryMediumImageURL
-
Type:
string
Primary Medium Image URL ID of SKU. - primarySmallImageURL
-
Type:
string
Primary Small Image URL of SKU. - primarySourceImageURL
-
Type:
string
Primary Source Image URL of SKU. - primaryThumbImageURL
-
Type:
string
Primary Thumb Image URL of SKU. - productFamily
-
Type:
string
Product Family property of the SKU. - productLine
-
Type:
string
Product line property of the SKU. - productListingSku
-
Type:
boolean
This is true if this sku is the listing sku for a particular variant. - quantity
-
Type:
integer
Quantity of the SKU. - repositoryId
-
Type:
string
Repository ID of the SKU. - salePrice
-
Type:
string
Sale price of the SKU. - salePriceEndDate
-
Type:
integer
Sale price end date of the SKU. - salePriceStartDate
-
Type:
string
Sale price start date of the SKU. - saleVolumePrice
-
Type:
object
saleVolumePriceAdditional Properties Allowed:Sale volume price of the SKU. - saleVolumePrices
-
Type:
object
saleVolumePricesAdditional Properties Allowed:Object with price group IDs as keys and sale prices as values. - smallImage
-
Type:
integer
Small image of the SKU. - smallImageURLs
-
Type:
array
smallImageURLsAdditional Properties Allowed:Small Image URLs of SKU. - sourceImageURLs
-
Type:
array
sourceImageURLsAdditional Properties Allowed:Source Image URLs of SKU. - thumbImageURLs
-
Type:
array
thumbImageURLsAdditional Properties Allowed:Thumb Image URLs of SKU. - thumbnailImage
-
Type:
string
Thumbnail image of the SKU. - unitOfMeasure
-
Type:
string
Unit Of Measure property of the SKU.
Nested Schema : bundleLinks
Nested Schema : fullImageURLs
Nested Schema : images
Nested Schema : largeImageURLs
Nested Schema : listVolumePrice
Type:
object
List volume price of the SKU.
- pricingScheme
-
Type:
object
pricingSchemeAdditional Properties Allowed:Pricing scheme can be either tieredPrice or bulkPrice
Nested Schema : listVolumePrices
Type:
object
Object with price group IDs as keys and list prices as values.
- PriceGroupID1
-
Type:
object
PriceGroupID1Additional Properties Allowed:List price of the SKU in price group 1 - PriceGroupID2
-
Type:
object
PriceGroupID2Additional Properties Allowed:List price of the SKU in price group 2
Nested Schema : mediumImageURLs
Nested Schema : saleVolumePrice
Type:
object
Sale volume price of the SKU.
- pricingScheme
-
Type:
object
pricingSchemeAdditional Properties Allowed:Pricing scheme can be either tieredPrice or bulkPrice
Nested Schema : saleVolumePrices
Type:
object
Object with price group IDs as keys and sale prices as values.
- PriceGroupID1
-
Type:
object
PriceGroupID1Additional Properties Allowed:Sale price of the Sku in price group 1 - PriceGroupID2
-
Type:
object
PriceGroupID2Additional 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:
object
itemAdditional Properties Allowed:The SKU that will be included into this bundle link - quantity
-
Type:
integer
The quantity of the item - repositoryId
-
Type:
string
The id of the bundle link
Nested Schema : item
Type:
object
The SKU that will be included into this bundle link
- displayName
-
Type:
string
The name of the SKU included in the bundle link - repositoryId
-
Type:
string
The id of the SKU included in the bundle link
Nested Schema : items
Type:
object
- metadata
-
Type:
object
metadataAdditional Properties Allowed:Seo meta info. - name
-
Type:
string
Name of the image to be updated. - path
-
Type:
string
Path of the image to be updated. - repositoryId
-
Type:
string
Repository ID of the image. - tags
-
Type:
array
tagsAdditional Properties Allowed:Tags for the image. - url
-
Type:
string
The complete url of the image.
Nested Schema : metadata
Type:
object
Seo meta info.
- altText
-
Type:
string
Alt text for image. - titleText
-
Type:
string
Title text for image.
Nested Schema : pricingScheme
Type:
object
Pricing scheme can be either tieredPrice or bulkPrice
- levels
-
Type:
array
levelsAdditional Properties Allowed:Price levels array for volume price - numLevels
-
Type:
number
Number of levels in the volume price
Nested Schema : levels
Nested Schema : items
Type:
object
- levelMaximum
-
Type:
number
minimum quantity for price level - levelMinimum
-
Type:
number
minimum quantity for price level - price
-
Type:
number
price value for price level
Nested Schema : PriceGroupID1
Type:
object
List price of the SKU in price group 1
- pricingScheme
-
Type:
object
pricingSchemeAdditional Properties Allowed:Pricing scheme can be either tieredPrice or bulkPrice
Nested Schema : PriceGroupID2
Type:
object
List price of the SKU in price group 2
- pricingScheme
-
Type:
object
pricingSchemeAdditional Properties Allowed:Pricing scheme can be either tieredPrice or bulkPrice
Nested Schema : pricingScheme
Type:
object
Pricing scheme can be either tieredPrice or bulkPrice
- levels
-
Type:
array
levelsAdditional Properties Allowed:Price levels array for volume price - numLevels
-
Type:
number
Number of levels in the volume price
Nested Schema : levels
Nested Schema : items
Type:
object
- levelMaximum
-
Type:
number
minimum quantity for price level - levelMinimum
-
Type:
number
minimum quantity for price level - price
-
Type:
number
price value for price level
Nested Schema : pricingScheme
Type:
object
Pricing scheme can be either tieredPrice or bulkPrice
- levels
-
Type:
array
levelsAdditional Properties Allowed:Price levels array for volume price - numLevels
-
Type:
number
Number of levels in the volume price
Nested Schema : levels
Nested Schema : items
Type:
object
- levelMaximum
-
Type:
number
minimum quantity for price level - levelMinimum
-
Type:
number
minimum quantity for price level - price
-
Type:
number
price value for price level
Nested Schema : pricingScheme
Type:
object
Pricing scheme can be either tieredPrice or bulkPrice
- levels
-
Type:
array
levelsAdditional Properties Allowed:Price levels array for volume price - numLevels
-
Type:
number
Number of levels in the volume price
Nested Schema : levels
Nested Schema : items
Type:
object
- levelMaximum
-
Type:
number
minimum quantity for price level - levelMinimum
-
Type:
number
minimum quantity for price level - price
-
Type:
number
price value for price level
Nested Schema : PriceGroupID1
Type:
object
Sale price of the Sku in price group 1
- pricingScheme
-
Type:
object
pricingSchemeAdditional Properties Allowed:Pricing scheme can be either tieredPrice or bulkPrice
Nested Schema : PriceGroupID2
Type:
object
Sale price of the SKU in price group 2
- pricingScheme
-
Type:
object
pricingSchemeAdditional Properties Allowed:Pricing scheme can be either tieredPrice or bulkPrice
Nested Schema : pricingScheme
Type:
object
Pricing scheme can be either tieredPrice or bulkPrice
- levels
-
Type:
array
levelsAdditional Properties Allowed:Price levels array for volume price - numLevels
-
Type:
number
Number of levels in the volume price
Nested Schema : levels
Nested Schema : items
Type:
object
- levelMaximum
-
Type:
number
minimum quantity for price level - levelMinimum
-
Type:
number
minimum quantity for price level - price
-
Type:
number
price value for price level
Nested Schema : pricingScheme
Type:
object
Pricing scheme can be either tieredPrice or bulkPrice
- levels
-
Type:
array
levelsAdditional Properties Allowed:Price levels array for volume price - numLevels
-
Type:
number
Number of levels in the volume price
Nested Schema : levels
Nested Schema : items
Type:
object
- levelMaximum
-
Type:
number
minimum quantity for price level - levelMinimum
-
Type:
number
minimum quantity for price level - price
-
Type:
number
price 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:
string
An optional non-localized message containing technical information for developers - errorCode
-
Type:
string
The numerical code identifying the error - errors
-
Type:
array
errorsAdditional Properties Allowed:An optional list of errors if multiple errors were encountered - message
-
Type:
string
The localized message describing the error - moreInfo
-
Type:
string
An optional non-localized message with more information - o:errorPath
-
Type:
string
An optional machine readable description of where the error occurred - status
-
Type:
string
The HTTP status code - type
-
Type:
string
The URI to the HTTP state code definition
Nested Schema : errors
Nested Schema : items
Type:
object
- devMessage
-
Type:
string
An optional non-localized message containing technical information for developers - errorCode
-
Type:
string
The numerical code identifying the error - message
-
Type:
string
The localized message describing the error - moreInfo
-
Type:
string
An optional non-localized message with more information - o:errorPath
-
Type:
string
An optional machine readable description of where the error occurred - status
-
Type:
string
The 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 }