Version: eXtendPS-SE 1.4.3 and above
Audience: Administrator

Use Case

  • Hide an assembly item's components in the Product Data response.

Summary

Generally, for assembly items, their components are included in the Product Data response as parts. However, if a matrix assembly item is present, all of its child items will be sent as independent items, and their components will be sent as parts.

In some cases, users may not want to include assembly item components as parts in the response. To address this, we have a feature to suppress assembly item components. This article explains how to enable this feature and how it works.

Configuration

To Suppress Assembly Item Components

  1. Go to the eXtendPS-SE Product Data Setup screen at eXtendTech → eXtendPS-SE → Product Data Setup.
  2. On the Other Configuration subtab, check the Suppress Assembly Components checkbox. This will cause assembly items to be sent as standalone items, with their components suppressed in the Product Data response. If they are matrix items, they will be sent as normal matrix items in the response.
Image Placeholder

Product Data Response Examples

Below is an example response for the assembly item PS-SE Assembly. This item is a matrix assembly item, and its parts are: 
  1. PS-SE Assembly-GREEN
  2. PS-SE Assembly-RED
The components present on the items are:
  1. B11040023-ASH-4XL
  2. B11040023-ASH-3XL

"Product Sellable" Response when "Suppress Assembly Components" is Disabled 

In this case, the assembly components will be displayed as individual parts. The child items in the matrix will be treated as independent parent items, with their components being shown as their respective parts.
<?xml version="1.0" encoding="utf-8"?>
    <soap:Body>
        <GetProductSellableResponse xmlns="http://www.promostandards.org/WSDL/ProductDataService/1.0.0/">
            <ProductSellableArray>
                <ProductSellable>
                    <productId xmlns="http://www.promostandards.org/WSDL/ProductDataService/1.0.0/SharedObjects/">PS-SE Assembly</productId>
                    <partId xmlns="http://www.promostandards.org/WSDL/ProductDataService/1.0.0/SharedObjects/">B11040023-ASH-4XL</partId>
                </ProductSellable>

                <ProductSellable>
                    <productId xmlns="http://www.promostandards.org/WSDL/ProductDataService/1.0.0/SharedObjects/">PS-SE Assembly</productId>
                    <partId xmlns="http://www.promostandards.org/WSDL/ProductDataService/1.0.0/SharedObjects/">B11040023-ASH-3XL</partId>
                </ProductSellable>
            </ProductSellableArray>
        </GetProductSellableResponse>
    </soap:Body>
</soap:Envelope>

"Product Sellable" Response when "Suppress Assembly Components" is Enabled

In this case, the assembly item will function as a normal matrix item, and the matrix child items will be returned as their components.
<?xml version="1.0" encoding="utf-8"?>
    <soap:Body>
        <GetProductSellableResponse xmlns="http://www.promostandards.org/WSDL/ProductDataService/1.0.0/">
            <ProductSellableArray>
                <ProductSellable>
                    <productId xmlns="http://www.promostandards.org/WSDL/ProductDataService/1.0.0/SharedObjects/">PS-SE Assembly</productId>
                    <partId xmlns="http://www.promostandards.org/WSDL/ProductDataService/1.0.0/SharedObjects/">PS-SE Assembly-GREEN</partId>
                </ProductSellable>
                <ProductSellable>
                    <productId xmlns="http://www.promostandards.org/WSDL/ProductDataService/1.0.0/SharedObjects/">PS-SE Assembly</productId>
                    <partId xmlns="http://www.promostandards.org/WSDL/ProductDataService/1.0.0/SharedObjects/">PS-SE Assembly-RED</partId>
                </ProductSellable>
            </ProductSellableArray>
        </GetProductSellableResponse>
    </soap:Body>
</soap:Envelope>

Note: The Product Data service's getProduct response will use the same logic.