Version: eXtendPS-SE 1.3.38 and above
Audience: Administrator

Overview

This article explains how to configure inventory options for the PromoStandards Live Inventory service's GetFilterValues response in NetSuite. The configuration determines how color attributes, size attributes, and other item attributes are returned in the response.

Configuration

Inventory Options Configuration

To configure inventory options for the PromoStandards Live Inventory service:

  1. Go to eXtendTech → eXtendPS-SE → Inventory Setup.
  2. In the "WSDL Field Mapping" field group, specify the field IDs for the following attributes that will be used as filters:
    • "Color Attributes"
    • "Size Attributes"
    • "Non-Color-Size Attributes"
Image Placeholder

You can specify one or multiple field IDs (separated by commas) in these fields. When multiple field IDs are specified, the first non-empty value will be used when creating the live inventory response.

Image Placeholder

Additionally, a partID field value needs to be provided.

Image Placeholder

Note: No functional or hardcoded values can be provided for these fields. They must be NetSuite field ID references.

The "PartID", "Color Attributes", and "Size Attributes" field references will be used when creating responses for the getFilterValues request and getInventoryLevels request of the PromoStandards Live Inventory Service. In the getInventoryLevel response, an additional attribute called "attributeSelection" will be included. This attribute is used to display item options other than size and color, and it can be configured in the "Non-Color-Size Attributes" field.

Size Mapping Configuration

Starting from version 1.3.6.4 and above, the actual size values will be returned for sizes based on the size mapping to PromoStandards' defined sizes list. This mapping can be performed in eXtendTech → eXtendPS-SE → Product Data Setup. Unmapped sizes will not be included in the response.

Image Placeholder

getFilterValues Response Details

The following sections describe how the response is created based on different item types for the getFilterValues request:

Inventory/Non-Inventory Matrix Parent Item

Consider a matrix item with the code "snm-054X". This item could be either an inventory or non-inventory type. The child items of this matrix item have combinations of colors: "Blue" and "Green", and sizes: "L" and "S". Therefore, there are four child items in total:

  1. 054X-Blue-S
  2. 054X-Blue-L
  3. 054X-Green-S
  4. 054X-Green-L

In the response from the getFilterValues() function, you'll receive the above-mentioned item names in the "partIdArray" array object. The parent name and colors ("Blue" and "Green") will be listed in the "partColorArray" array object, and the sizes ("L" and "S") will be listed in the "LabelSizeArray" array object. A sample response to this scenario is shown below (Live Inventory 2.0.0).

    <soap:Body>
        <GetFilterValuesResponse xmlns="http://www.promostandards.org/WSDL/Inventory/2.0.0/">
            <FilterValues>
                <productId xmlns="http://www.promostandards.org/WSDL/Inventory/2.0.0/SharedObjects/">snm-054X</productId>
                <Filter xmlns="http://www.promostandards.org/WSDL/Inventory/2.0.0/SharedObjects/">
                    <partIdArray>
                        <partId>snm-054X : 054X-Blue-L</partId>
                        <partId>snm-054X : 054X-Blue-S</partId>
                        <partId>snm-054X : 054X-Green-L</partId>
                        <partId>snm-054X : 054X-Green-S</partId>
                    </partIdArray>
                    <LabelSizeArray>
                        <LabelSize>L</LabelSize>
                        <LabelSize>S</LabelSize>
                    </LabelSizeArray>
                    <PartColorArray>
                        <PartColor>Blue</PartColor>
                        <PartColor>Green</PartColor>
                    </PartColorArray>
                </Filter>
            </FilterValues>
        </GetFilterValuesResponse>
    </soap:Body>
</soap:Envelope>

Inventory/Non-Inventory Matrix Child Item

If you search for an inventory/non-inventory matrix child item, you'll only get one element under "partIdArray", "LabelSizeArray", and "PartColorArray" because there are no further child items for your matrix sub-item. In this example, if you search for the child item "054X-Blue-L", you'll get "054X-Blue-L" as the "partIDArray" element, "L" as the "LabelSizeArray" element, and "Blue" as the "PartColorArray" element. A sample response to this scenario is shown below (Live Inventory 2.0.0).

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope
<soap:Body>
<GetFilterValuesResponse
<FilterValues>
<productId
</productId>
<Filter
<partIdArray>
<partId>snm-054X : 054X-Blue-L</partId>
</partIdArray>
<LabelSizeArray>
<LabelSize>L</LabelSize>
</LabelSizeArray>
<PartColorArray>
<PartColor>Blue</PartColor>
</PartColorArray>
</Filter>
</FilterValues>
</GetFilterValuesResponse>
</soap:Body>
</soap:Envelope>

Inventory/Non-Inventory Parent Item

Not supported. The response will only provide details of the parent items, including their names under partIdArray, and their colors and sizes under partColorArray and partSizeArray respectively. However, it won't include information about the child items. The response will be similar to the example mentioned in "Inventory/Non-Inventory Matrix Child Item", but the item ID won't reference its parent, as this item doesn't have a parent item.

Inventory/Non-Inventory Child Item

The response will include only the details of the item options. This includes the name of the item (found under partIdArray), its parent item name, and its color and size (found under partColorArray and partSizeArray respectively). The format of the response will be similar to the XML example mentioned in "Inventory/Non-Inventory Matrix Child Item".

Inventory/Non-Inventory Item

In the response, you'll receive only the details of the item options. This includes the item's name, its parent item name, and its color and size. The item ID in the response won't reference its parent because this item doesn't have a parent item associated with it. The response will be similar to the XML example mentioned in "Inventory/Non-Inventory Matrix Child Item".

Assembly Matrix Parent Item

If the "Suppress Assembly Components" preference is enabled, the response will be similar to the response mentioned in "Inventory/Non-Inventory Matrix Parent Item". However, if the preference isn't enabled, the Assembly components will be included as item parts in the response.

Assembly Matrix Child Item

If the "Suppress Assembly Components" preference is enabled, the response will be similar to the response mentioned in "Inventory/Non-Inventory Matrix Child Item". However, if this preference isn't enabled, the Assembly components will be sent as item parts in the response.

Assembly Item

If the "Suppress Assembly Components" preference is enabled, the response will be similar to the response mentioned in "Inventory/Non-Inventory Matrix Child Item". However, if this preference isn't enabled, the Assembly components will be sent as item parts in the response.

Kit/Package Item

If the "Suppress Kit Components" preference is enabled, the response will be similar to the response mentioned in "Inventory/Non-Inventory Matrix Child Item". However, if this preference isn't enabled, the Kit components will be sent as item parts in the response.

Frequently Asked Questions (FAQs)

Q: Which inventory versions support the partIdArray response?
A: The partIdArray response is supported in Inventory 2.0.0.

Q: Are non-standard sizes returned in the response?
A: No. Non-standard sizes, such as 9XL, won't be returned in the response. This applies to eXtendPS-SE Version 1.3.6.4 and above.