9.5.0.0
541 201 9965 Email Website
Contents
Search:

Home > Integrating > WSI Nodes > Product

Product

Description:

This node allows you to add or edit a product.

Full Syntax:

<Product Action="Add|Update|Delete|Nuke|Lookup" EnsureDefaultVariant="boolean" GUID="uniqueidentifier" SKU="string" Name="string" ID="integer">
<Name>string</Name>
<Summary>string</Summary>
<Description>string</Description>
<SpecTitle>string</SpecTitle>
<MiscText>string</MiscText>
<Notes>string</Notes>
<FroogleDescription>string</FroogleDescription>
<SKU>string</SKU>
<ManufacturerPartNumber>string</ManufacturerPartNumber>
<SwatchImageMap>string</SwatchImageMap>
<SE>
<SEName>string</SEName>
<SETitle>string</SETitle>
<SEKeywords>string</SEKeywords>
<SEDescription>string</SEDescription>
<SENoScript>string</SENoScript>
<SEAltText>string</SEAltText>
</SE>
<SizeOptionPrompt>string</SizeOptionPrompt>
<ColorOptionPrompt>string</ColorOptionPrompt>
<ProductType Name="string" ID="integer" GUID="uniqueidentifier"/>
<TaxClass Name="string" ID="integer" GUID="uniqueidentifier"/>
<SalesPrompt Name="string" ID="integer" GUID="uniqueidentifier"/>
<SpecCall>string</SpecCall>
<SpecsInline>string</SpecsInline>
<Display>
<XmlPackage>string</XmlPackage>
<ColWidth>integer</ColWidth>
<SkinID>integer</SkinID>
<TemplateName>string</TemplateName>
</Display>
<Images UseAppConfigs="boolean" >
<Icon Extension="gif|jpg|png|jpeg" Delete="boolean">base64 encoded image data here</Icon>
<Medium Extension="gif|jpg|png|jpeg" Delete="boolean">base64 encoded image data here</Medium>
<Large Extension="gif|jpg|png|jpeg" Delete="boolean">base64 encoded image data here</Large>
<ImageFilenameOverride></ImageFilenameOverride>
</Images>
<QuantityDiscount Name="string" ID="integer" GUID="uniqueidentifier"/>
<RelatedProducts>
<CX ID="integer" GUID="uniqueidentifier"/>
<CX ID="integer" GUID="uniqueidentifier"/>
<CX ID="integer" GUID="uniqueidentifier"/>
<CX ID="integer" GUID="uniqueidentifier"/>
<CX ID="integer" GUID="uniqueidentifier"/>
</RelatedProducts>
<UpsellProducts DiscountPercentage="">
<CX ID="integer" GUID="uniqueidentifier"/>
<CX ID="integer" GUID="uniqueidentifier"/>
<CX ID="integer" GUID="uniqueidentifier"/>
<CX ID="integer" GUID="uniqueidentifier"/>
<CX ID="integer" GUID="uniqueidentifier"/>
</UpsellProducts>
<RequiresProducts>
<CX ID="integer" GUID="uniqueidentifier"/>
<CX ID="integer" GUID="uniqueidentifier"/>
<CX ID="integer" GUID="uniqueidentifier"/>
<CX ID="integer" GUID="uniqueidentifier"/>
<CX ID="integer" GUID="uniqueidentifier"/>
</RequiresProducts>
<InventoryType>
<TrackInventoryBySizeAndColor></TrackInventoryBySizeAndColor>
<WarehouseLocation></WarehouseLocation>
</InventoryType>
<IsFeatured>boolean</IsFeatured>
<IsAKit>boolean</IsAKit>
<IsSystem>boolean</IsSystem>
<ShowBuyButton>boolean</ShowBuyButton>
<Published>boolean</Published>
<Wholesale>boolean</Wholesale>
<RequiresRegistration>boolean</RequiresRegistration>
<HidePriceUntilCart>boolean</HidePriceUntilCart>
<IsCallToOrder>boolean</IsCallToOrder>
<ExcludeFromPriceFeeds>boolean</ExcludeFromPriceFeeds>
<GoogleCheckoutAllowed>boolean</GoogleCheckoutAllowed>
<RequiresTextOption>boolean</RequiresTextOption>
<TextOptionMaxLength>integer</TextOptionMaxLength>
<TextOptionPrompt>string</TextOptionPrompt>
<AvailableStartDate>datetime</AvailableStartDate>
<AvailableStopDate>datetime</AvailableStopDate>
<StoreMappings AutoCleanup="boolean" PreserveExistingRecords="boolean">
<Store StoreId="int" StoreName="string" />
<Store StoreId="int" StoreName="string" />
</StoreMappings>
<Mappings AutoCleanup="boolean">
<Entity EntityType="Manufacturer|Distributor|Category|Section|Genre|Vector" Name="string" XPath="string" ID="integer" GUID="uniqueidentifier" DisplayOrder="integer"/>
<Entity EntityType="Manufacturer|Distributor|Category|Section|Genre|Vector" Name="string" XPath="string" ID="integer" GUID="uniqueidentifier" DisplayOrder="integer"/>
<Entity EntityType="Manufacturer|Distributor|Category|Section|Genre|Vector" Name="string" XPath="string" ID="integer" GUID="uniqueidentifier" DisplayOrder="integer"/>
<Entity EntityType="Manufacturer|Distributor|Category|Section|Genre|Vector" Name="string" XPath="string" ID="integer" GUID="uniqueidentifier" DisplayOrder="integer"/>
<Entity EntityType="Manufacturer|Distributor|Category|Section|Genre|Vector" Name="string" XPath="string" ID="integer" GUID="uniqueidentifier" DisplayOrder="integer"/>
</Mappings>
<ExtensionData>string</ExtensionData>
<ExtensionData2>string</ExtensionData2>
<ExtensionData3>string</ExtensionData3>
<ExtensionData4>string</ExtensionData4>
<ExtensionData5>string</ExtensionData5>
<Kit AutoCleanup="boolean"> <!-- only used if IsAKit is 1 -->
<KitGroup>
<Name>string</Name>
<Description>string</Description>
<DisplayOrder>integer</DisplayOrder>
<KitGroupTypeID>integer</KitGroupTypeID>
<IsRequired>boolean</IsRequired>
<IsReadOnly>integer</IsReadOnly> <KitItem>
<Name>string</Name>
<Description>string</Description>
<PriceDelta>decimal</PriceDelta>
<IsDefault>boolean</IsDefault>
<DisplayOrder>integer</DisplayOrder>
<TextOptionMaxLength>integer</TextOptionMaxLength>
<TextOptionWidth>integer</TextOptionWidth>
<TextOptionHeight>integer</TextOptionHeight>
<WeightDelta>decimal</WeightDelta>
<InventoryQuantityDelta>integer</InventoryQuantityDelta> </KitItem>
</KitGroup>
</Kit>
<Variants AutoCleanup="boolean">
<Variant Action="Add|Update|Delete|Nuke|Lookup" Name="string" SKUSuffix="" GUID="uniqueidentifier" ID="integer">
<IsDefault>boolean</IsDefault>
<Name>string</Name>
<Description>string</Description>
<SE>
<SEName>string</SEName>
<SEKeywords>string</SEKeywords>
<SEDescription>string</SEDescription>
<SENoScript>string</SENoScript>
<SEAltText>string</SEAltText>
</SE>
<FroogleDescription>string</FroogleDescription>
<SKUSuffix>string</SKUSuffix>
<ManufacturerPartNumber>string</ManufacturerPartNumber>

<GTIN>integer</GTIN>
<Price>decimal</Price>
<SalePrice>decimal</SalePrice>
<Weight>decimal</Weight>
<MSRP>decimal</MSRP>
<Cost>decimal</Cost>
<Points>integer</Points>
<Dimensions>string</Dimensions>
<Inventory>integer</Inventory>
<DisplayOrder>integer</DisplayOrder>
<Notes>string</Notes>
<IsTaxable>boolean</IsTaxable>
<IsShipSeparately>boolean</IsShipSeparately>
<IsDownload>boolean</IsDownload>
<DownloadLocation>string</DownloadLocation>
<FreeShipping>boolean</FreeShipping>
<Published>boolean</Published>
<Wholesale>boolean</Wholesale>
<IsRecurring>boolean</IsRecurring>
<RecurringInterval>integer</RecurringInterval>
<RecurringIntervalType>integer</RecurringIntervalType>
<RestrictedQuantities>string</RestrictedQuantities>
<MinimumQuantity>integer</MinimumQuantity>
<Images ClearBeforeImport="boolean">
<Icon Extension="gif|jpg|png|jpeg">base64 encoded image data here</Icon>
<Medium Extension="gif|jpg|png|jpeg">base64 encoded image data here</Medium>
<Large Extension="gif|jpg|png|jpeg">base64 encoded image data here</Large>
<ImageFilenameOverride></ImageFilenameOverride>
</Images>
<CustomerEntersPrice>boolean</CustomerEntersPrice>
<CustomerEntersPricePrompt>string</CustomerEntersPricePrompt>
<ExtensionData>string</ExtensionData>
<ExtensionData2>string</ExtensionData2>
<ExtensionData3>string</ExtensionData3>
<ExtensionData4>string</ExtensionData4>
<ExtensionData5>string</ExtensionData5>
<Sizes>
<Size SKUModifier="string" PriceDelta="decimal">red</Size>
<Size SKUModifier="string" PriceDelta="decimal">green</Size>
<Size SKUModifier="string" PriceDelta="decimal">blue</Size>
</Sizes>
<Colors>
<Color SKUModifier="string" PriceDelta="decimal">s</Color>
<Color SKUModifier="string" PriceDelta="decimal">m</Color>
<Color SKUModifier="string" PriceDelta="decimal">l</Color>
</Colors>
<InventoryBySizeAndColor>
<Inv Color="string" Size="string" Quantity="integer" VendorID="string" VendorFullSKU="string" ExtensionData="string"/>
<Inv Color="string" Size="string" Quantity="integer" VendorID="string" VendorFullSKU="string" ExtensionData="string"/>
<Inv Color="string" Size="string" Quantity="integer" VendorID="string" VendorFullSKU="string" ExtensionData="string"/>
<Inv Color="string" Size="string" Quantity="integer" VendorID="string" VendorFullSKU="string" ExtensionData="string"/>
</InventoryBySizeAndColor>
</Variant>
</Variants>
</Product>

Notes:

  • On a lookup, both a Name and a SKU node must be passed.
  • On an update, if you want to set a field to NULL or "empty string" use an empty element syntax (e.g. <Summary></Summary>).
  • On an update, if you want to leave the existing value on that field, omit the field from the Xml input document.
  • If an Update, Nuke, or Delete is done, the request should have an ID or GUID for the best processing. If none is provided, a lookup will be done based on the combination of product name and SKU, but this will slow down processing, especially on bulk updates.
  • Incremental updates are supported
  • You can assign your own GUID on product Add. The GUID and new ID will be returned to you for association within your calling system.
  • UseAppConfigs on the Image node tells WSI to use the image resize AppConfigs for any images you provide.
  • If the EnsureDefaultVariant attribute is set to true, WSI will pick one of the product's variants and flag it as the default.

Warnings:

Remember that between product data, variants, kits, inventory, entity mappings, etc a lot of tables are involved in product data. Be very sure that you understand the DB structure and how products are put together before doing any bulk product updates.



Actions
Print This Article
Bookmark
Email This Article
Previous Article
Next Article