The simplest and most easy way to list your products on eCommerce UK is by connecting your e-commerce platform so our automatic import process will take care of the rest, alternatively you can use the classic FTP / WebURL method with a CSV/XML file.

If your e-commerce platform is not yet supported by our API quick import system, please upload your CSV to a server and specify the address during the onboarding process so we can import it.

Most e-commerce platforms have ready-to-go solutions for the generation of the product feed, you can find a list here.

It usually takes from few seconds to a minute for our system to process the information included in the CSV file .

Quality of information

eCommerce UK always strives to display correct and complete information on its portal. You should therefore try to update the data in the feed frequently and include all relevant information.

Wholesale prices are not accepted. If you have a specific price for bulk purchases, for example four pieces of a product, the price for the purchase of a single product should still be shown in the pricing file, regardless of how common the bulk purchase is among your customers.

If you have any questions about the price file, please do not hesitate to contact us.

API


Direct connection

eCommerce UK uses a proprietary technology that allows you to send the data of your products simply by connecting your e-commerce platform through API.

If you use one of these platforms

Magento
Shopify
BigCommerce
WooCommerce
Storeden
PrestaShop

you can send your catalog without having to upload any CSV file but simply connecting your e-commerce as shown in the video below.

FTP / CSV


Feed URL

The file should be placed on an HTTPS or FTP address from which we can retrieve it. If you have IP address restriction (such as a firewall), you need to make sure that our server (IP xxx.xxx.xxx.xxx) has access to the file.

Please do not use timestamps or other information that will dynamically change the feed URL as this will prevent us from fetching the file.

Coding

Use one of the following encodings for the CSV file:
UTF-8, UTF-16, ISO-8859-1, Windows-1252

Format

The format must be CSV. Note that the pricing file cannot be in Excel or any other non-text format. If you want to speed up our processing and your updates, compress the feed using gzip / zip.

CSV

The data must be structured in rows and columns, where one row represents a product and each column consists of fields with product information.

Each field or column must be separated by a comma (,).

Use "field qualifiers" at the beginning and end of each field. The recommended "field qualifiers" are single ('') or double ("") quotes.

Download> An example of a CSV file can be found here

Below you can see a video about how to upload your CSV file by inserting the link during the onboarding process.

Field specifications and order

This below is a list of recommended columns. The order in which they are in the file is not important but names cannot be changed or the file will not be valid anymore.

Fields must never contain HTML or javascript code or tags.

Fields

sku (required)
code (required)
mpn
qty (required)
name (required)
brand (required)
category
picture_url (required)
price (required)
product_url (required)
shipping_cost
max_delivery_days
delivery_label


XML

The fields of the XML file are the same of the CSV file except for the underscores which have been removed to be compatible with the XML standard.

Download> An example of a XML file can be found here

sku (required)
code (required)
mpn
qty (required)
name (required)
brand (required)
category
pictureurl (required)
price (required)
producturl (required)
shippingcost
maxdeliverydays
deliverylabel

Product Data


Sku

Use SKUs as IDs wherever possible. Since SKUs are unique, they can also help you avoid accidentally reusing IDs.

(OK) Sku: ABC123
(KO) Sku: 1

Code

The code field can contain different types of product code (EAN, GTIN, UPC, ISBN). It generally represents the barcode number and is unique. It is used to automatically recognize the product and make the products searchable in the barcode scanner in our app.
By including the EAN code, it will be possible to automatically match your products and publish them on eCommerce UK faster.

Example: 5030930122539

Mpn

Unique part number of the manufacturer. Different from the code field. This value is not used to automatically recognize the product.

Example: 2250-1500

Qty

The quantity is represented by an integer. When a product has no quantity or quantity 0, it is shown as unavailable.

Name

Any variant or model of a product must be clearly indicated. The search engine and filters of eCommerce Italy work using the information in this field. Try using the keywords you want to be found for.

(OK) Name: Apple iPhone 12, 256 GB, gray
(KO) Name: iPhone 12

Your product name will be used to match your product to our products and user search. Include the important details that define your product. Put the most important details first.
Users will usually only see the first 70 characters or less of your title, depending on the screen size.
Use keywords. Keywords will help link your product to a user's search and help the user recognize what you are selling.

Your keywords might include these types of product details:

Product name
Brand
Specific product details

Do not include any discount, sale or stock information in the name or the product will be discarded.

Brand

The brand of the product. It will show up in our filters.

Example: Nike

Category

Use the full "breadcrumb information". Where possible, we recommend that you include more granular categories as it classifies your product more accurately.

For example, Shoes> Sports Shoes> Running Shoes.

Remember not to confuse the different product types within the categories. An example is to avoid adding accessories for a camera within the camera category.

Use> or - to separate multiple levels into a category. Also, include a space before and after the> or - symbol.

Example: Clothing> Women> Dresses

For gender products (e.g. clothes and perfumes), it is important to divide them into Women, Men and Children. Our filters are based in part on category names.

(OK) Category: Clothing> Woman> Pants
(KO) Category: Fashion and clothing

Picture_url

Product image URL. CMYK format is not supported.

Example: https://www.mystore.com/product.jpg

Price

The price of the product must include VAT. Currency does not have to be indicated. Use a period as a decimal marker.

(OK) Price: 25.50
(KO) Price: $ 25.50 excluding VAT

Product_url

URL of the product in your store. It may also contain tracking parameters for analysis tools such as Google Analytics.
Example: https://www.mystore.com/product.html

Shipping_cost

The cost of shipping the product. The shipping cost must combine all the shipping / order costs for the consumer, such as environmental surcharge, freight surcharge, handling surcharge, packing fee, etc.

Example: 5.30

Max_delivery_days

The promised delivery time from the time of the order in the number of days. It is important that the turnaround time in the feed matches the information on your site.

(OK) max_delivery_days: 5
(KO): 5 working days

Delivery_label

Indicates the name of the shipping service that is generally used to ship goods to customers.

Example: UPS Ground