Product Object
Field | Description | Required? | Best Practice? | |
productId | The associated product. | TRUE |
| |
productName | The Supplier name for the product | TRUE |
| |
LocationDecorationArray | An array of Location Decoration objects | TRUE |
| |
description | Basic product description or bulleted list of descriptions. | TRUE |
| |
priceExpiresDate | The date that the pricing in the ProductPriceGroupArray portion of the response expires. | FALSE | Yes | |
ProductMarketingPointArray | Marketing points type and content. An array of MarketingPoint objects. | FALSE | Yes | |
ProductKeywordArray | Array of keywords often used in searching for this product. An array of ProductKeyword objects. | FALSE | Yes | |
productBrand | The specific product brand | FALSE | Yes | |
export | Product status for export | TRUE |
| |
ProductCategoryArray | The product’s categorization array. An array of ProductCategory objects. | FALSE |
| |
RelatedProductArray | Products related to the quested product as Substitutable, CompanionSell, or Common Grouping (Family). An array of RelatedProduct objects. | FALSE |
| |
ProductPartArray | All part specific product data. An array of ProductPart objects. | TRUE |
| |
lastChangeDate | The date time stamp of the most recent change to this data in ISO 8601 format | TRUE |
| |
creationDate | The date time stamp when this products data initially became available in ISO 8601 format | TRUE |
| |
endDate | The Date this Product expires from Supplier availability in ISO 8601 format | FALSE |
| |
effectiveDate | The Date this Product initially becomes available from the Supplier in ISO 8601 format | FALSE |
| |
isCaution | Cautionary status to review for specific warnings about using product data. | TRUE |
| |
cautionComment | Product cautionary comments | FALSE |
| |
isCloseout | Indicates if the product is a closeout | TRUE |
| |
lineName | Line Name / Division to which this product belongs | FALSE | Yes | |
primaryImageURL | The URL of the product’s primary image. Any valid URL can be returned including prefixes like http and ftp. | FALSE |
| |
ProductPriceGroupArray | Marketing-oriented pricing information. Represented as an array of Product Price objects. Prices are List prices. | FALSE |
| |
complianceInfoAvailable | Indicates if there is information about this product via the Product Safety & Compliance service. | FALSE |
| |
unspscCommodityCode | The United Nations Standard Products and Services Code® (UNSPSC®) that best describes this product. Note that the enumerated values are the UNSPSC "Commodity" codes. For more information, refer to https://www.unspsc.org . | FALSE |
| |
imprintSize | The imprint Size | FALSE | Yes | |
defaultSetUpCharge | The default setup charge for this product. Can be a textual description. | FALSE | Yes | |
defaultRunCharge | The default RUN charge for this product. Can be a textual description. | FALSE |
| |
FobPointArray | An array of FOB points object | TRUE |
|
Location Decoration
Field | Description | Required? | Best Practice? |
locationName | Location name | TRUE |
|
maxImprintColors | The maximum number of imprint colors available, based on a decoration location and type. | FALSE | Yes |
decorationName | Decoration name | TRUE |
|
locationDecorationComboDefault | Is this the default location | TRUE |
|
priceIncludes | Does this include price | TRUE |
|
Product Part Object
Field | Description | Required? | Best Practice? |
partId | The part Id | TRUE |
|
description | Description | FALSE | Should be brief and describe part and not contain high level product descriptions. |
countryOfOrigin | Country of Origin | FALSE |
|
ColorArray | Information about the part colors | FALSE | Yes. Should not be used in place of unique parts. |
primaryMaterial | Primary material of construction | FALSE | Yes. |
SpecificationArray | Specifications | FALSE |
|
shape | General shape | FALSE |
|
ApparelSize | Used to describe an apparel size | FALSE |
|
Dimension | Physical dimensions and weight | FALSE | Yes. |
leadTime | Lead time in days | FALSE | Yes |
unspsc | United Nations Standard Products and Services Code (UNSPSC) | FALSE |
|
gtin | Global Trade Item Number (GTIN) | FALSE | Yes. Helps with marketing on Google Merchant Center. |
isRushService | Rush service | TRUE | Yes. Helps distributors filter products that can be rushed. |
ShippingPackageArray | Shipping package option details for the partPackaging Default package type; e.g. Carton, Box, Pallet. An array of ShippingPackage objects. | FALSE |
|
ProductPackagingArray | Packaging option details; e.g. Gift Box, Cello Pack, Sleeve. An array of ProductPackaging objects. | FALSE | Yes. Include all quantity and box size varations. |
endDate | The date this part expires from supplier availability in ISO 8601 format | FALSE |
|
effectiveDate | The Date this Part initially becomes available from the Supplier in ISO 8601 format | FALSE |
|
isCloseout | Indicates if a closeout | TRUE |
|
isCaution | Cautionary status to review for specific warnings about using product data | TRUE |
|
cautionComment | Cautionary comments | FALSE |
|
nmfcCode | National Motor Freight Classification Code | FALSE |
|
nmfcDescription | National Motor Freight Classification Description | FALSE |
|
nmfcNumber | National Motor Freight Classification Number | FALSE |
|
isOnDemand | Manufactured on demand / Made to order | TRUE |
|
isHazmat | Contains hazardous material. A nil value indicates this it is unknown or the data is not available by the supplier. | TRUE |
|
primaryColor | The "go to market" color. Represented as a Color Object. | FALSE |
|
Color Object
Field | Description | Required? | Best Practice? |
colorName | Supplier specific color name. Go to market color | TRUE |
|
hex | The HEX code representation. This is not a supplement for product color but data used for generating web user interfaces. | FALSE | Helps when displaying swatch colors. |
approximatePms | The PMS code representation. This is not a supplement for product color. | FALSE | Yes |
standardColorName | The standard color that best describes this color. Eventually may become an enumeration. | FALSE | Yes |
Product Price Group Object
Field | Description | Required? | Best Practice? |
groupName | Price group description | TRUE |
|
currency | The currency supported in ISO4217 format. | TRUE |
|
description | The description of the product price | FALSE | Yes |
ProductPriceArray | An array of Product Price objects | TRUE |
|
Product Price Object
Field | Description | Required? | Best Practice? |
quantityMax | The maximum quantity for which this price applies. | TRUE |
|
quantityMin | The minimum quantity for which this price applies. | TRUE |
|
price | The price value. | TRUE |
|
discountCode | The discount code. | FALSE | Yes |
Product Packaging Object
Field | Description | Required? | Best Practice? |
default | Boolean flag identifying the single default packaging for this package | TRUE |
|
packageType | The packaging specific type for this partId e.g. Gift Box, Cello Pack, Sleeve | TRUE |
|
description | The Packaging specific description | FALSE | Yes |
quantity | The partId unit Quantity included within this specific Packaging Option | TRUE |
|
dimensionUom | The unit of measure for the package | TRUE |
|
depth | The depth/length of the package in the dimensionUom unit of measure | FALSE | Yes |
height | The height of the package in the dimensionUom unit of measure | FALSE | Yes |
width | The width of the package in the dimensionUom unit of measure | FALSE | Yes |
weightUom | The weight unit of measure for the packageType | TRUE |
|
weight | The weight of the specific packageType | FALSE | Yes |
Shipping Package Object
Field | Description | Required? | Best Practice? |
packageType | The shipping package specific type for this shipping package e.g. Box, Carton, etc. | TRUE |
|
description | The shipping package specific description | FALSE | Yes |
quantity | The partId unit quantity included within this specific shipping packaging option | TRUE | Yes |
dimensionUom | The weight unit of measure for the packageType | TRUE |
|
depth | The depth/length of the shipping package in the dimensionUom unit of measure | FALSE | Yes |
height | The height of the shipping package in the dimensionUom unit of measure | FALSE | Yes |
width | The width of the shipping package in the dimensionUom unit of measure | FALSE | Yes |
weightUom | The weight unit of measure for the packageType | TRUE |
|
weight | The weight of the specific packageType | FALSE | Yes |