The product catalog transmitted to BeezUP is the first step to use our solution. Therefore, it is very important to respect the following instructions it to then have good results.
This section will present different points to follow.
SUMMARY
1. Compatible formats
BeezUP accepts CSV, XML or TXT catalog.
Files can be zipped up to reduce their size.
Here you can find a few indications of each format:
XML
- The file has to respect the XML norm
- The content of the file has to be inserted with the tag <catalog> or another name
- Every product is defined by a tag <product> which is child of the <catalog> tag
- Each attribute has to be in one tag and child of the <product> tag
- The file has to contain a BOM
CSV or TXT
- The first line has to contain the unique name of each column
- Each product has to contain all characteristics in a constant order
- An identical separator has to be present for the characteristics of each product
- Do not use a separator which appears in one of your content data
- Do not surround the characteristics with apostrophes or commas
- Do not put any "/n", nor "/n/r" in the characteristics of your products
- A maximum of 99 columns
To have the best listing possible, we advise you to export as many fields as possible and to do a product's export with as many attributes as possible.
To be more precise, 8 attributes at least have to be necessary, and you will find below a non-exhaustive list of the possible attributes:
Mandatory | Field | Data type | Example | Description |
Yes | Product reference | Numbers and/or letters | 4567 | Product reference, this product reference must be constant |
Recommended | MPN | Numbers and/or letters | 32PFL5522D | Manufacturer reference |
Recommended | EAN/UPC | 8 or 13 numbers | 8712581314750 | Universal product reference (European Article Number, Universal Product Code) |
Recommended | Brand | Text | Sony | Product brand |
Yes | Title | Text | Sony television AA456 HD 32 inch | Product title |
Recommended | Description | Text | This is a must have for all television show lovers. | Product description |
Yes | Price (including tax) | Number | 32.99 | Product price (tax included), without delivery fee and with eco-tax if applicable. Use only a single point or comma. Do not include spaces. |
Recommended | Old price (including tax) | Number | 39.99 | Product price (tax included), without delivery fee and with eco-tax if applicable. Use only a single point or comma. Do not include spaces. |
Recommended | State | 3 choices : "new", "used", "repackaged" | new | Product state |
| Warranty | Number of years | 2 | Product guarantee |
| Warranty details | Texte libre | Labor and parts | Labor and parts |
| Ecotax | Number | 0.1 | ATTENTION: make certain to include all required eco-taxe in "Price (including tax)" |
Recommended | URL product | URL | Link to your product | |
Recommended | URL image | URL | Link to your image | |
Recommended | Shipping cost | Number | 3.99 | Delivery cost (including tax) corresponds to the lowest delivery price, if free : 0 |
Recommended | Stock | 2 choices : "In stock", "Out of stock" | In stock | Indicate either "In stock" or "Out of stock". Note : If no info is transmitted, we consider that the product is "In stock" |
Recommended | Stock quantity | Number | 45 | Indicate the number of products in stock (ex : 36) |
Recommended | Delivery time | Number of days | 2 or 2-3 | The number(s) indicating the delivery time |
| Delivery information | Text | Delivery within 48 hours | Some channels offer you the possibility to provide data concerning delivery. It is possible to use this field for text descriptions. Be careful not to allow the comparison shopping sites to manage the field "delivery time". |
Yes | Category1 | Text | Clothing | It is recommended that you create as many columns as of category levels |
Recommended | Category2 | Text | Men |
|
Recommended | Category3 -> 8 | Text | ... |
|
Recommended | Category9 | Text | Pantalons à rayure |
|
| Gender | 5 choices : "Men", "Women", "Girls", "Boys", "Unisex" | Female |
|
Recommended | Color | Text | Blue | Colour of the product |
Recommended | Size | Text | S, M, L or 40, 41, 42, 43 | Product sizes separated by a comma |
| Material | Text | Cotton | Product material |
| Age range | Text | 5 years and more | Text indicating the age range, ex: 3-6 months, 5 years or more |
2. Availability of the catalog
Your catalog has to be generated in a dynamic way and put to our disposal on a HTTP/HTTPS server or a FTP server.
If you cannot put it at your disposal on a server, you have 2 possibilities:
to contact us so that we put at your disposal a server FTP (non free service), you will then have to update it on our ftp server.
to do by yourself manual updates from your computer and when you want.
3. Examples
To help you in order to get your feed, you will find in this article 2 examples of feed products regarding the BeezUP specifications:
👉 Examples of CSV/XMLcatalogs
4. Products variations
If your catalog contains products with variations (clothes or shoes, for example) AND that you want your products to be published on marketplaces, we invite you to consult this article here.
5. Export modules
BeezUP is used in Europe by many online shops, modules to create feeds and/or trackers have been created by e-commerce companies which are partners of BeezUP or by active members of open-source communities.
To check if a module exists for your e-commerce solution, we advise you to see this section.
⚠️ Important to remember: If you make modifications in the structure of your imported catalog, please inform BeezUP support by clicking the «Help» button after logging into your BeezUP account.
⏩ Next step: importation of a product catalogue