API v1 Reference

List Product Options

This method retrieves all available product options for a specific store product. Options are unique to each product, so this request must be used for each individual product.

Each option has a name and ID. Each option also has values that have their own names and IDs. Example:

Option Name: Shirt Size

Option Values: Small, Medium, Large, XL

REST

Request

https://api.neoncrm.com/neonws/services/api/store/listProductOptions?userSessionId=[session_id]&productId=78

Response

{
   "ListProductOptionsResponse":
   {
       "operationResult": "SUCCESS",
       "responseMessage": "3 records found.",
       "responseDateTime": "2014-09-11T09:51:40.847-05:00",
       "productOptions":
       {
           "option":
           [
               {
                   "optionId": 18,
                   "name": "Size",
                   "optionValues":
                   {
                       "optionValue":
                       [
                           {
                               "optionValueId": 44,
                               "name": "S"
                           },
                           {
                               "optionValueId": 45,
                               "name": "M"
                           },
                           {
                               "optionValueId": 46,
                               "name": "L"
                           },
                           {
                               "optionValueId": 47,
                               "name": "XL"
                           },
                           {
                               "optionValueId": 76,
                               "name": "XXL",
                               "priceAdjustment": 5
                           }
                       ]
                   }
               },
               {
                   "optionId": 32,
                   "name": "",
                   "optionValues":
                   {
                       "optionValue":
                       [
                           {
                               "optionValueId": 82,
                               "name": "red"
                           },
                           {
                               "optionValueId": 83,
                               "name": "blue"
                           },
                           {
                               "optionValueId": 84,
                               "name": "purple"
                           },
                           {
                               "optionValueId": 85,
                               "name": "yellow"
                           }
                       ]
                   }
               },
               {
                   "optionId": 34,
                   "name": "10% off",
                   "optionValues":
                   {
                       "optionValue":
                       [
                           {
                               "optionValueId": 90,
                               "name": "10% off",
                               "priceAdjustment": -50
                           }
                       ]
                   }
               }
           ]
       }
   }
}

Request Parameters

Name Required Description
productId Yes The ID of the product for which you would like to retrieve options.

Response Parameters

Name Required Description
productOptions.option.optionId Yes Product Option ID
productOptions.option.name Yes Name of the new product option
productOptions.optionValues.optionValue.optionValueId Yes An option value’s ID
productOptions.optionValues.optionValue.name Yes An option value’s name
productOptions.optionValues.optionValue.priceAdjustment This parameter should be repeated for each option value. Value can be either a positive or negative integer (-5, 2, 100)

Error Codes

Code Text Description
12202 Product id is invalid. This product does not exist. Ensure that the product ID is correct.