This guide shows you how to set common product catalog
options such as markups, discounts, and promotions using our XML price file.
We will take the XML Price File and breakdown each line and demonstrate how to configure. See the full document: XML Price File
cartid
This number must be unique throughout the entire price file.
If not, the catalog will not function correctly.
5
category
This is the product category. Only one per product.
Categories show up on the search page.
Desks
productid
The actual name of this product. Be as specific as possible
Office Desk
productdescription
Description of the product. This is a free form text description so you can
embed pictures and links if you wish.
Fancy Professional Hardwood Desk
uom
Unit of Measure for the product. The catalog does not perform any calculations
on the UOM to arrive at another price based on UOM.
Fancy Professional Hardwood Desk
mapprice
Minimum Advertised Price. Manufacturers often require their distributors to respect
MAP pricing to prevent cut-throat competition among local and regional distributors
over prices. There are various techniques you can use to respect MAP pricing while still offering
price incentives. The XML Shopping Cart employs shipping discounts and rebates to offset MAP pricing
requirements. A general rule for MAP pricing means the price of the product must always display
the MAP price throughout the product catalog, even through checkout and purchase. Using this feature generates the 'Promotion Discount' line in the subtotal.
$600.00
450.00
MAP pricing must be turned on using a configuration entry in the catalogs.config file
buyconversion and buyunit
Buy Conversion and Buy Unit are advanced features of the cart. These attributes are used when
a product is priced using one Unit of Measure but sold using another Unit of Measure. For example,
many building materials may be priced by the square foot but sold by the carton.
If a product
costs $2.00 per square foot and the carton contains 17.25 square feet, a customer must purchase an entire carton to obtain the product.
If the customer needs 5 cartons of materials, the cart will calculate the item charge as:
$2.00 x 17.25 x 5 units = $172.50
Square Feet
2.00
17.25
Carton
productimage
Name of the product image. Only the product name, no url paths necessary.
productname.jpg
The location of the product images is identified using a configuration entry in the catalogs.config file
relatedproducts
Contains the cart ids of the related products for this product. If you want to list similar
products alongside a product, identify the products by their cart ids and separate with a comma.
10,15,20,25,35,40,45,50
promotionstartdate and promotionexpiredate and promotionprice
Promotional periods have start and end dates. The price will change to the promotional price
while this period is active and revert to its original price after the period expires. All markups still apply
to the promotional prices. Promotions override price markups.
500.00
4/1/2010
5/1/2010
400.00
productattributes
Product Attributes is free form. You can enter any product attribute you wish. If you enter a manufacturer, this entry
will be included in the search by manufacturer list on the search page.
Custom product attribute
Furniture Builders
Finest Collection
10 Year Manufacture
10-14 days.
2
http://www.yourwebsite.com/specsheet_desk.htm
manufacturer
If you enter a manufacturer in the product attributes section, this entry
will be included in the search by manufacturer list on the search page.
Furniture Builders
minorder
Minimum Order ensures the customer must purchase a minimum amount. Small items generaly fall into this feature.
100
specsheet
If you include a specsheet tag, you may include a link
to another page for more detailed product specifications on complex products. This can be a pdf, another web page, picture, any item that can be linked to
on a web page.
100
accessories
Accessories are identified by their cart ids. If an entire category of products can be used
as the accessory line, enter the category instead of the accessory ids. Do not use both.
15,50,55,60,40,25