Retrieving Option Groups, Options, and List Prices for a Price List Product
This retrieves option groups, options, and list prices for a price list product.
API | Signature |
---|---|
getOptionGroupsForPriceListProduct | webService static Apttus_CPQApi.CPQ.ProductOptionGroupSearchResultDO getOptionGroupsForPriceListProduct(Id priceListId, Id productId) |
Parameters | ||
---|---|---|
Name | Type | Description |
pricelistId | ID | The Id of the price list. |
productId | ID | The Id of the product bundle. |
Response Data Object - Apttus_CPQApi.CPQ.ProductOptionGroupSearchResultDO | ||
---|---|---|
Name | Type | Description |
HasOptionGroups | Boolean | Indicates if the bundle has option groups. |
OptionGroups | List<Apttus_CPQApi.CPQ.ProductOptionGroupDO> | The list of product option group data objects. |
Data Object - Apttus_CPQApi.CPQ.ProductOptionGroupDO | ||
---|---|---|
Field | Type | Description |
ChildOptionGroups | List<Apttus_CPQApi.CPQ.ProductOptionGroupDO> | List of child option group data objects. |
HasChildOptionGroups | Boolean | Indicates whether there are child option groups. |
HasOptionComponents | Boolean | Indicates if the option group has product components. |
Label | String | The option group label. |
MaxOptions | Integer | Maximum number of options that can be selected from the group. |
MinOptions | Integer | Minimum number of options that must be selected from the group. |
Name | String | The option group name. |
OptionComponents | List<Apttus_CPQApi.CPQ.ProductOptionComponentDO> | List of product component data objects. |
ParentOptiongroupId | ID | Id of the parent option group. |
ProductOptionGroupId | ID | Id of the product option group. |
Data Object - Apttus_CPQApi.CPQ.ProductOptionComponentDO | ||
---|---|---|
Field | Type | Description |
ComponentId | ID | Id of the component. |
ComponentProductId | ID | Id of the component product. |
Description | String | The product description. |
HasPrices | Boolean | Indicates if there are list prices for the product. |
ImageUrl | String | The location of the image, if there is one, associated with the product. |
IsDefault | Boolean | Indicates if the option is included by default for the bundle. |
IsRequired | Boolean | Indicates if the option is mandatory for the bundle. |
Name | String | The product name. |
Prices | List<Apttus_CPQApi.CPQ.PriceDO> | List of price data objects. |
ProductCode | String | The product code. |
Data Object - Apttus_CPQApi.CPQ.PriceDO | ||
---|---|---|
Field | Type | Description |
ChargeType | String | The charge type. |
PriceItem | Apttus_Config2__PriceListItem__c object | The price list items for a price list. |
Value | Decimal | The list price. |
Code Sample
Using the sample below you enable the user to search and select products by a price list. You can then pass the IDs of the price list and product as arguments to the API. If in the result object HasOptionGroups returns true, fetch and display the option group components. If the option group components HasComponents=true display the option components such as quantity. For example if the user searches a product and clicks Search, invoke the API to fetch the option groups for that bundle.
Integration Details
Use the following information in your integrations with CPQ Web Services API. Refer to Integrating Conga with External Systems for information on how to get started.
Response/Request XML
Example Request
Example Response