1. REST API for Oracle Commerce Cloud December 2017
  2. Tasks
  3. Agent
  4. Sku

getSku

get

/ccagent/v1/skus/{id}

Get Sku. Returns sku details with pricing and variant information. Unlike the getSku endpoint of Admin, this endpoint returns pricing and variants details of Sku. Takes X-CCAgentContext header which is a JSON object with 'shopperProfileId' as a property. If 'shopperProfileId' is not provided, it is considered as an anonymous profile.Additonally takes x-ccsite header to return the sku's of that site'

Request

Supported Media Types
  • application/json
Path Parameters
id
Type: string
Required: true
Sku Id.
Query Parameters
catalogId
Type: string
ID of catalog. If a catalogId is not passed, the catalog associated with the shopperProfileId passed in the X-CCAgentContext header is used. If no shopperProfileId is passed in the header, default catalog associated with the site is used.
showNotForIndividualSale
Type: boolean
Required: true
To retrieve not for indivisal Sale items. If showNotForIndividualSale is not passed the sku will return if it exists
skuId
Type: string
Required: true
Sku Id.
Header Parameters
x-ccsite
Type: string
the site id on which the orders is laced

Response

Supported Media Types
  • application/json
200 Response
Following model is returned when operation succeeds.
Body
Root Schema : getSku_response
Nested Schema : fullImageURLs
Type: array
The array of full image URLs
Nested Schema : images
Type: array
Image URLs of SKU.
Nested Schema : largeImageURLs
Type: array
Large Image URLs of SKU.
Nested Schema : listPrices
Type: object
list prices of the product in respective price list groups
Nested Schema : listVolumePrices
Type: object
list volume prices of the product in respective price list groups
Nested Schema : mediumImageURLs
Type: array
medium image urls path
Nested Schema : parentProducts
Type: array
The list of parent products for the SKU.
Nested Schema : productListingSku
Type: object
product listing SKU property of the SKU
Nested Schema : productVariantOptions
Type: array
The selected options for the SKU.
Nested Schema : salePrices
Type: object
sale prices of the product in respective price list groups
Nested Schema : saleVolumePrices
Type: object
Sale volume prices of the product in respective price list groups
Nested Schema : smallImage
Type: array
The array of small image URLs
Nested Schema : smallImageURLs
Type: array
small image url paths
Nested Schema : sourceImageURLs
Type: array
Source Image URLs of SKU.
Nested Schema : thumbImageURLs
Type: array
Thumb Image URLs of SKU
Nested Schema : variantValuesOrder
Type: object
Object having various variant property as key and ordered values array as the value.
Nested Schema : items
Type: object
Nested Schema : defaultProductListingSku
Type: object
default SKU for the product
Nested Schema : fullImageURLs
Type: array
full image url paths
Nested Schema : largeImageURLs
Type: array
The array of large image URLs
Nested Schema : listPrices
Type: object
list prices of the product in respective price list groups
Nested Schema : listVolumePrices
Type: object
list volume prices of the product in respective price list groups
Nested Schema : mediumImageURLs
Type: array
Medium Image URLs SKU.
Nested Schema : salePrices
Type: object
sale prices of the product in respective price list groups
Nested Schema : saleVolumePrices
Type: object
Sale volume prices of the product in respective price list groups
Nested Schema : shippingSurcharges
Type: object
Extra handling costs for shipping the product in respective price list groups
Nested Schema : smallImageURLs
Type: array
The urls of the small image.
Nested Schema : sourceImageURLs
Type: array
source image urls of the product
Nested Schema : thumbImageURLs
Type: array
Thumb Image URLs of product
Nested Schema : items
Type: object
Example application/json

{
    "links":[
        {
            "rel":"self",
            "href":"http://localhost:9080/ccagent/v1/variants/camcordersku_1_3"
        }
    ],
    "autoWrap":true,
    "items":[
        {
            "template":null,
            "dynamicPropertyMapLong":{
                "sku-camcorder_zoom":0,
                "sku-camcorder_color":2
            },
            "replacementProducts":null,
            "bundleLinks":[
            ],
            "largeImage":null,
            "dynamicAttributes":{
            },
            "smallImage":null,
            "fixedReplacementProducts":[
            ],
            "color":"Neon",
            "endDate":null,
            "derivedCatalogs":[
            ],
            "nonreturnable":false,
            "displayName":null,
            "onlineOnly":false,
            "description":null,
            "type":"sku-camcorder",
            "itemAcl":null,
            "translations":{
            },
            "unit_of_measure":null,
            "onSale":false,
            "dynamicPropertyMapString":{
            },
            "siteIds":[
            ],
            "id":"camcordersku_1_3",
            "thumbnailImage":null,
            "computedCatalogs":[
            ],
            "discountable":true,
            "wholesalePrice":null,
            "salePriceEndDate":null,
            "catalogsReplacementProducts":[
            ],
            "salePriceStartDate":null,
            "quantity":null,
            "salePrice":597,
            "skuInfos":{
            },
            "zoom":"2x optical/130x digital",
            "creationDate":"2015-03-30T06:53:04.000Z",
            "version":1,
            "parentProducts":[
                {
                    "longDescription":"Record footage in 720p resolution with this Samsung F980BN\n                HMX-F90BN/XAA flash memory camcorder, which features a CMOS sensor to help you capture high-definition\n                videos. The 2. LCD display provides a clear view for shooting or reviewing images.\n            ",
                    "primaryThumbImageURL":"/ccstore/v1/images/?source=http://localhost:9080/file/products/Samsung_F90BN_LARGE.jpg&height=100&width=100",
                    "largeImage":null,
                    "smallImage":null,
                    "listVolumePrice":{
                        "bulkPrice":{
                            "numLevels":2,
                            "levels":[
                                {
                                    "price":21,
                                    "levelMinimum":1,
                                    "levelMaximum":10
                                },
                                {
                                    "price":10,
                                    "levelMinimum":11
                                }
                            ]
                        }
                    },
                    "displayName":"Samsung - F90BN HD Flash Memory Camcorder",
                    "orderLimit":null,
                    "description":null,
                    "primaryFullImageURL":"/ccstore/v1/images/?source=http://localhost:9080/file/products/Samsung_F90BN_LARGE.jpg",
                    "largeImageURLs":[
                        "/ccstore/v1/images/?source=http://localhost:9080/file/products/Samsung_F90BN_LARGE.jpg&height=940&width=940"
                    ],
                    "primaryLargeImageURL":"/ccstore/v1/images/?source=http://localhost:9080/file/products/Samsung_F90BN_LARGE.jpg&height=940&width=940",
                    "smallImageURLs":[
                        "/ccstore/v1/images/?source=http://localhost:9080/file/products/Samsung_F90BN_LARGE.jpg&height=300&width=300"
                    ],
                    "id":"camcorder_1",
                    "childSKUs":[
                        {
                            "repositoryId":"camcordersku_1_1"
                        },
                        {
                            "repositoryId":"camcordersku_1_2"
                        },
                        {
                            "repositoryId":"camcordersku_1_3"
                        },
                        {
                            "repositoryId":"camcordersku_1_4"
                        }
                    ],
                    "saleVolumePrice":{
                        "tieredPrice":{
                            "numLevels":2,
                            "levels":[
                                {
                                    "price":18,
                                    "levelMinimum":1,
                                    "levelMaximum":10
                                },
                                {
                                    "price":8,
                                    "levelMinimum":11
                                }
                            ]
                        }
                    },
                    "salePrice":null,
                    "primaryMediumImageURL":"/ccstore/v1/images/?source=http://localhost:9080/file/products/Samsung_F90BN_LARGE.jpg&height=475&width=475",
                    "fullImageURLs":[
                        "/ccstore/v1/images/?source=http://localhost:9080/file/products/Samsung_F90BN_LARGE.jpg"
                    ],
                    "active":true,
                    "thumbImageURLs":[
                        "/ccstore/v1/images/?source=http://localhost:9080/file/products/Samsung_F90BN_LARGE.jpg&height=100&width=100"
                    ],
                    "productImages":[
                        {
                            "repositoryId":"camcorderImg"
                        }
                    ],
                    "route":"/product/camcorder_1",
                    "mediumImageURLs":[
                        "/ccstore/v1/images/?source=http://localhost:9080/file/products/Samsung_F90BN_LARGE.jpg&height=475&width=475"
                    ],
                    "repositoryId":"camcorder_1",
                    "primarySourceImageURL":"/ccstore/v1/images/?source=http://localhost:9080/file/products/Samsung_F90BN_LARGE.jpg&height=300&width=300",
                    "primarySmallImageURL":"/ccstore/v1/images/?source=http://localhost:9080/file/products/Samsung_F90BN_LARGE.jpg&height=300&width=300",
                    "sourceImageURLs":[
                        "/ccstore/v1/images/?source=http://localhost:9080/file/products/Samsung_F90BN_LARGE.jpg&height=300&width=300"
                    ],
                    "avgCustRating":null,
                    "listPrice":null
                }
            ],
            "auxiliaryMedia":{
            },
            "manufacturer_part_number":null,
            "catalogs":[
            ],
            "repositoryId":"camcordersku_1_3",
            "fulfiller":null,
            "dynamicPropertyMapDouble":{
            },
            "startDate":null,
            "listPrice":699.99
        },
        [
            {
                "optionValue":"Neon",
                "optionName":"color"
            },
            {
                "optionValue":"2x optical/130x digital",
                "optionName":"zoom"
            }
        ]
    ]
}
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| |------------------|------------------| |30015|SiteId passed in x-ccsite header is currently inactive| |30014|SiteId passed in x-ccsite header is invalid or the site was deleted| |20033|Illegal to use catalog ID when custom catalogs are not in use.| |26069|Internal Error.| |26050|Variants Internal Error.| |26061|Cannot Find Null Sku.| |26060|Cannot Find Sku.|
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 Response Payload returned by endpoint:

{
  "links": [{
    "rel": "self",
    "href": "http://localhost:9080/ccagent/v1/variants/camcordersku_1_3"
  }],
  "autoWrap": true,
  "items": [
    {
      "template": null,
      "dynamicPropertyMapLong": {
        "sku-camcorder_zoom": 0,
        "sku-camcorder_color": 2
      },
      "replacementProducts": null,
      "bundleLinks": [],
      "largeImage": null,
      "dynamicAttributes": {},
      "smallImage": null,
      "fixedReplacementProducts": [],
      "color": "Neon",
      "endDate": null,
      "derivedCatalogs": [],
      "nonreturnable": false,
      "displayName": null,
      "onlineOnly": false,
      "description": null,
      "type": "sku-camcorder",
      "itemAcl": null,
      "translations": {},
      "unit_of_measure": null,
      "onSale": false,
      "dynamicPropertyMapString": {},
      "siteIds": [],
      "id": "camcordersku_1_3",
      "thumbnailImage": null,
      "computedCatalogs": [],
      "discountable": true,
      "wholesalePrice": null,
      "salePriceEndDate": null,
      "catalogsReplacementProducts": [],
      "salePriceStartDate": null,
      "quantity": null,
      "salePrice": 597,
      "skuInfos": {},
      "zoom": "2x optical/130x digital",
      "creationDate": "2015-03-30T06:53:04.000Z",
      "version": 1,
      "parentProducts": [{
        "longDescription": "Record footage in 720p resolution with this Samsung F980BN\n                HMX-F90BN/XAA flash memory camcorder, which features a CMOS sensor to help you capture high-definition\n                videos. The 2. LCD display provides a clear view for shooting or reviewing images.\n            ",
        "primaryThumbImageURL": "/ccstore/v1/images/?source=http://localhost:9080/file/products/Samsung_F90BN_LARGE.jpg&height=100&width=100",
        "largeImage": null,
        "smallImage": null,
        "listVolumePrice": {"bulkPrice": {
          "numLevels": 2,
          "levels": [
            {
              "price": 21,
              "levelMinimum": 1,
              "levelMaximum": 10
            },
            {
              "price": 10,
              "levelMinimum": 11
            }
          ]
        }},
        "displayName": "Samsung - F90BN HD Flash Memory Camcorder",
        "orderLimit": null,
        "description": null,
        "primaryFullImageURL": "/ccstore/v1/images/?source=http://localhost:9080/file/products/Samsung_F90BN_LARGE.jpg",
        "largeImageURLs": ["/ccstore/v1/images/?source=http://localhost:9080/file/products/Samsung_F90BN_LARGE.jpg&height=940&width=940"],
        "primaryLargeImageURL": "/ccstore/v1/images/?source=http://localhost:9080/file/products/Samsung_F90BN_LARGE.jpg&height=940&width=940",
        "smallImageURLs": ["/ccstore/v1/images/?source=http://localhost:9080/file/products/Samsung_F90BN_LARGE.jpg&height=300&width=300"],
        "id": "camcorder_1",
        "childSKUs": [
          {"repositoryId": "camcordersku_1_1"},
          {"repositoryId": "camcordersku_1_2"},
          {"repositoryId": "camcordersku_1_3"},
          {"repositoryId": "camcordersku_1_4"}
        ],
        "saleVolumePrice": {"tieredPrice": {
          "numLevels": 2,
          "levels": [
            {
              "price": 18,
              "levelMinimum": 1,
              "levelMaximum": 10
            },
            {
              "price": 8,
              "levelMinimum": 11
            }
          ]
        }},
        "salePrice": null,
        "primaryMediumImageURL": "/ccstore/v1/images/?source=http://localhost:9080/file/products/Samsung_F90BN_LARGE.jpg&height=475&width=475",
        "fullImageURLs": ["/ccstore/v1/images/?source=http://localhost:9080/file/products/Samsung_F90BN_LARGE.jpg"],
        "active": true,
        "thumbImageURLs": ["/ccstore/v1/images/?source=http://localhost:9080/file/products/Samsung_F90BN_LARGE.jpg&height=100&width=100"],
        "productImages": [{"repositoryId": "camcorderImg"}],
        "route": "/product/camcorder_1",
        "mediumImageURLs": ["/ccstore/v1/images/?source=http://localhost:9080/file/products/Samsung_F90BN_LARGE.jpg&height=475&width=475"],
        "repositoryId": "camcorder_1",
        "primarySourceImageURL": "/ccstore/v1/images/?source=http://localhost:9080/file/products/Samsung_F90BN_LARGE.jpg&height=300&width=300",
        "primarySmallImageURL": "/ccstore/v1/images/?source=http://localhost:9080/file/products/Samsung_F90BN_LARGE.jpg&height=300&width=300",
        "sourceImageURLs": ["/ccstore/v1/images/?source=http://localhost:9080/file/products/Samsung_F90BN_LARGE.jpg&height=300&width=300"],
        "avgCustRating": null,
        "listPrice": null
      }],
      "auxiliaryMedia": {},
      "manufacturer_part_number": null,
      "catalogs": [],
      "repositoryId": "camcordersku_1_3",
      "fulfiller": null,
      "dynamicPropertyMapDouble": {},
      "startDate": null,
      "listPrice": 699.99
    },
    [
      {
        "optionValue": "Neon",
        "optionName": "color"
      },
      {
        "optionValue": "2x optical/130x digital",
        "optionName": "zoom"
      }
    ]
  ]
}