In order to list your products on ShopMania you must create and submit a product datafeed. A datafeed is a file in txt, CSV or XML format that contains detailed information about your products, such as: product name, price, category etc. The fields in a datafeed should be pipe - delimited (|), and the lines delimited by a new line (\n).
This is a standard formatting for a feed in txt and CSV:
category with full path | manufacturer | part number | merchant product code | product name | description | product URL | image URL | price | currency | shipping price | availability | GTIN (UPC/EAN/ISBN)
The following fields are mandatory: Category, MPC, Product name, Product URL, Image URL and Price. GTIN is also mandatory for books; in this case you should add the ISBN number. It is not enough to include these fields in your datafeed, but you must also make sure that the mandatory fields also include the correct information. Otherwise your feed may not be considered valid. However, for a correct product listing, we strongly recommend that you submit data for all the fields mentioned above and not only for the mandatory ones.
The fields inserted in the datafeed should contain the following data:
| Field | Description | Example |
|---|---|---|
| Category | Must contain your site’s category with the full path from the root category to the category where the products are listed. Limit: 255 characters |
Home Appliances > Small Personal Care Appliances > Shavers |
| Manufacturer | The manufacturer’s name or brand of the product. Limit: 100 characters |
Nokia |
| Model | The manufacturer’s assigned part number for the product (MPN, EAN, UPC or ISBN). Limit: 100 characters |
For the Graphic Card Gigabyte Nvidia GeForce 210 512MB DDR2, the model is "GV-N210OC-512I" |
| Merchant Code | A unique product code identifier by which the products are identified in your store. It’s recommended that the code does not change overtime. Limit: 100 characters |
12345, 12346, 123457 |
| Product name | The name of the product as it appears on your site. Limit: 255 characters |
Graphic card Gigabyte Nvidia GeForce 210 512MB |
| Product description | The product description; do not use HTML tags, Javascript code, images or any other type of multimedia file. Limit: 200 character |
The digital camera D3100 takes great photos in dark conditions and is used primarily in the semi-professional industry. |
| Product URL | The URL to the product page. | http://example.com/view-product?prod-id=12345 |
| Image URL | The URL to the product’s main image. We recommend submitting a large size image with good quality that matches your product. We do not allow any embedded information in the picture, such as watermark, logo or promotional text. |
http://example.com/images/12345.jpg |
| Product price | The product price must include all the taxes, except for the shipping cost, which must be displayed in a separate field. We do not allow prices that are available only for a specific customer category. The price should not contain the currency: ZAR |
120.45 |
| Currency | The price currency. | ZAR |
| Shipping cost | This is the product shipping cost. In order to display the shipping cost included in the feed you must check this option "Individual product shipping prices" in the Settings - Shipping settings section in your account. The shipping cost should be expressed in the same currency as the product price. The shipping cost must include all applicable taxes. Free shipping should be indicated by zero (0.00). | 2.5 |
| Availability | Contains specifications regarding the availability of a product. The values accepted for this field are:
- In stock: Include this value if you are certain that it will ship (or be in-transit to the customer) in 3 business days or less. For example, if you have the item available in your warehouse. - Available for order: Include this value if it will take 4 or more business days to ship it to the customer. For example, if you don’t have it in your warehouse at the moment, but are sure that it will arrive in the next few days. For unreleased products, use the value Preorder. - Out of stock: You’re currently not accepting orders for this product. - Preorder: You are taking orders for this product, but it’s not yet been released. Note: If you use other values for the availability information in your feed, you need to access your ShopMania control panel and to match these values to the ones used in the ShopMania system. |
In stock |
| GTIN (UPC/EAN/ISBN) | The primary set of unique product identifiers are the Global Trade Item Numbers (GTINs), which include UPC -
Universal Product Code, EAN - European Article Number (in Europe) and ISBN - International Standard Book Number.
These values are very important for matching users' queries to your products. It is mandatory to provide the ISBN for books. However we strongly recommend that you provide GTIN identifiers for all products, as this may become mandatory in the future. Please find more information about GTIN on Wikipedia. |
- UPC: a unique numerical identifier for commercial products that's usually associated with a barcode printed on retail merchandise;
12-digit number such as 001234567891 Please find more information about UPC on Wikipedia. - EAN: a unique numerical identifier for commercial products that's usually associated with a barcode printed on retail merchandise; 13-digit number such as 1001234567891 Please find more information about EAN on Wikipedia. - ISBN: a unique numerical identifier for commercial books that can be found on the back of the book along with the barcode; 10 or 13-digit number such as 0451524233 If you have both, only include 13-digit number; Please find more information about ISBN on Wikipedia. |
Listed in: Specifications on the datafeed