Professional Documents
Culture Documents
Manual Shipping Costs Gls
Manual Shipping Costs Gls
Manual Shipping Costs Gls
Table of contents
General Information
File structure
Server requirements
Importation Guide for Prestashop Products
1.- Download.
2.- CSV importation.
2.1.- Categories.
2.2.- Products.
2.3.- Combinations.
2.4.- Manufacturers.
ANNEX 1: CSV products header
ANNEX 2: CSV categories header
ANNEX 3: CSV combinations header
ANNEX 4: Creating CSV files for updating
ANNEX 5: Possible errors caused (advanced level)
Blank screenshot
General Information
BigBuy updates its catalogue constantly with the aim of offering its clients the best possible
product offers for its online business. To access the new products in our product catalogue in
your dropshipping shop it is essential to synchronise and import these products as well as the
categories they belong to.
BigBuy has two available options for carrying out this continuous update:
1. FTP Synchronisation
CSV files are complete, but to be able to use them you must have knowledge on
programming or have a technician create a programme for you that allows you to
synchronise products.
2. Automatic Synchronisation
With this option, you only need to be concerned with the management of your
shop. This synchronisation is carried out every 2 hours without needing to do it
with CSV files. We update your products, stock and we manage your orders
automatically.
For more information, contact the sales team in the contact area of our BigBuy website.
In order to carry out the synchronisation of products and categories between your online
business and BigBuy you must download the necessary files, categories, products,
combinations and manufacturers available in your BigBuy administration panel.
If it is the first time that you are carrying out this process, then you must import the archives
completely and at all times follow the steps in the order mentioned further on.
If it is an update (second time or a follow-up), you must only import the file with the new
modifications following the steps mentioned further on.
If errors or problems occur when carrying out the process, please go to Annex 7.
Server requirements
Detailed below are the necessary requirements of your server so that the importation process
can be carried out satisfactorily.
● Your server must have a PHP memory limit of 512 MB in order to securely import
around 20 products each time.
● Your server must have a maximum time of 3600 seconds to allow the process to run
before the analyser stops (max_execution_time). The default value is 30. When the
PHP is executed from the command line, the default value is 0.
The web server may have other waiting time settings that could interrupt the
execution of the PHP. Apache has the timeout directive and IIS has the CGI timeout
function. Both are 300 seconds by default.
File download
We currently have CSV files divided into families of categories identified by an ID that appears
in the name of each file. In this way, you can import by categories, allowing you to avoid the
importation of those products that you do not want to have in your shop.
FTP
If you are accessing the archive through the FTP, the structure will be as follows:
- In the original file, you will see all the CSV files. These files will soon disappear and you
will find only the information of the updated product. You will not see any new
products or new categories.
- If you are accessing the folder ‘files’ you will find the new CSV structure, which is
detailed below:
file/categories/csv/prestashop/ (step 1)
In this file you will find a list of CSV archives for importing into Prestashop or any
platform for e-commerce with the following structure:
category_IDCATEGORY_LANGUAGE.csv
file/categories/csv/mapper_category.csv
In this file you will find the name of each corresponding IDCATEGORY in all languages.
/files/combinations/csv/prestashop (step 3)
In this file you will find a list of CSV archives for importing into Prestashop with the
following structure:
presta_combination_IDCATEGORY_LANGUAGE.csv
/files/manufacturer/csv/prestashop (step 4)
In this section, you will find a list of CSV archives for importing into Prestashop with
the following structure:
manufacturers_LANGUAGE.csv
/files/products/csv/prestashop
In this file, you will find a list of CSV archives for importing into Prestashop with the
following structure:
presta_product_IDCATEGORY_LANGUAGE.csv
/files/products/csv/standard (step 2)
In this section you will find a list of CSV archives for importing into any e-commerce
under the following structure:
product_IDCATEGORY_LANGUAGE.csv
/files/products/xml/standard
In the following file you will find a list of XML archives for importing into any e-
commerce under the following structure:
product_IDCATEGORY_LANGUAGE.csv
To link categories to their products and combinations you must download the CSV products
and combinations file with the same corresponding number to the previously downloaded
category.
BigBuy Panel
If you are accessing this archive through the BigBuy panel, the files to be downloaded are the
following:
You must go to the CSV/XML Archives tab and download the archives that you want and those
selected in the photo above.
To download them, you must click on them and then select the relative categories to said
archives and in the language you want to download (if you have a Pro pack you will only be
able to download the archives in one language, if you have a Premium or Business pack you
can download the archives in all available languages). Such archives are detailed below:
CSV Categories
This CSV will be used for importing into Prestashop, for any other platform you must
modify the files so that they are compatible with the structure of said platform.
CSV Products
This CSV will be used for importing into Prestashop, for any other platform you must
modify the files so that they are compatible with the structure of said platform.
CSV Combinations
This CSV will be used for importing into Prestashop, for any other platform you must
modify the files so that they are compatible with the structure of said platform.
CSV Manufacturer
This CSV will be used for importing into Prestashop, for any other platform you must
modify the files so that they are compatible with the structure of said platform.
Therefore, for the process to run as it should, you must have all the files:
Manufacturers Manufacturer.csv
The first step for importing the BigBuy catalogue is obtaining the CSV archives just as explained
previously (FTP access or through the BigBuy panel).
As a step before importing products you must carry out a series of modifications in the
categories section in the control panel of your Prestashop shop.
To do this, access the control panel of your Prestashop shop (control panel). On the menu to
the left-hand side select Catalogue → Categories (step 1).
For the languages Spanish and French, you must modify it by clicking on the icon to be
modified (step 3).
Once you are in modification, search for where it says Name. Then, replace the content with
Inicio for the Spanish language or with Accueil if it is for the French language. Lastly, press the
Save button.
NOTE: If it is the first time you are importing the new catalogue of BigBuy products (updated
on 23rd June 2016) you must import all of the categories. Once you have imported all of the
categories, you will be able to deactivate those that you do not want to display in your shop
directly from the administration panel in Prestashop.
If it is the first time that you are importing, start with the categories to avoid an error
occurring. This process may be tedious and slow as it must register that it needs to obtain
multiple images of all products and process different views of each one, which is quite time-
consuming.
If, on the other hand, you are carrying out an update (second time or later), you must take
two things into account:
1. For the CSVs you must leave all products, combinations, categories and manufacturers
whose date of creation or update is later than the last date that the CSV was imported
into your shop.
Follow the steps outlined in Annex 6 which are found at the end of the document for
eliminating categories, products, combinations and manufacturers that mustn’t be
imported.
Both for some CSVs and for others we must apply the filters in Excel (optional) and
save the results in a new comma-delimited CSV. Such information must be imported
into Prestashop.
2. It must be taken into account that as they already have content, you must not
overwrite the existing information because you will lose all of the previous updates.
Once we have the archives and we have reviewed the settings we can move on to the
importation of archives. To do this, follow the steps outlined below, ensuring at all times that
the correct entity is selected.
To import the archives go to the menu on the left-hand side in your control panel. Enter the
section Advanced Parameters → CSV Import (step 1).
- Categories
- Products
- Combinations
- Manufacturers
2.1.- Categories.
Categories are not usually updated frequently, and it could be a while until there are any
modifications made.
In order for the following image not to appear in the subcategories as they do not have an
image, you must deactivate them.
1. Go to Modules → Modules (step 1) and search for Topic configurator (step 2).
2. Click on modify.
3. In the Settings section (step 3) → Display subcategories (step 4), choose ‘NO’
4. Save
2.2.- Products.
The CSV of products is usually a large archive, which is why it is advisable to divide it with the
programme CSV Chunker. Click here to download. Although it all depends on the product
information we recommend splitting it up into 100 lines.
(http://doc.bigbuy.eu/wp-content/uploads/2015/02/CSV-Chunker.zip).
2.3.- Combinations.
Certain products have combinations that are recognised in other environments by the
attribute name. Said combinations may indicate a specific characteristic about an item such as
the size, colour, etc. In some cases they also indicate a variation on the original price of the
product.
For example: ‘The attribute or combination of ham is the weight and pack of sausages, the
price changes depending on the selection of those attributes’.
2.4.- Manufacturers.
Manufacturers are not usually updated frequently, and it may be a while until a modification is
made.
Importation process
Below you must carry out the following common steps for all entity types:
1. Upload a file (step 3). In the case of categories, combinations and manufacturers it is a
single attachment, but if there are several products, you must carry out the following
steps for each attachment. Once they have loaded a message will appear to state that
it has uploaded correctly.
2. Language of the file (step 4): Select the language in which the attachment is written.
3. ISO encode file (step 5): must always be NO.
4. Field separator (step 6): must always be ;
5. Multiple value separator (step 7): must always be ,
For Categories:
6. Delete all categories before import (step 8): If it is the first time you are importing you
should press YES, not NO.
7. Skip thumbnails regeneration (step 9): must always be NO
8. Force all ID numbers (step 10): must always be YES
For Products:
6. Delete all products before import (step 8): If it is a single archive and it is the first time
you must press YES, but if there are several as in the case of products, for the first
attachment you must select YES, but select NO for the rest.
7. Use product reference as key (step 9): must always be YES
8. Skip thumbnails regeneration (step 10): must always be NO
9. Force all ID numbers (step 11): must always be YES
For combinations:
6. Delete all combinations before import (step 8): if it is the first time you are importing
you must press YES, not NO.
7. Use product reference as key (step 9): must always be YES
For manufacturers:
6. Delete all manufacturers before import (step 8): if it is the first time you are importing
you must press YES, not NO.
7. Skip thumbnails regeneration (step 9): NO
8. Force all ID numbers (step 10): YES
For all:
10. Press the Next step button.
On the following screen you must carry out the following steps:
Lines to skip (step 1): You must take special care and make sure that a 1 appears. If it doesn’t
appear it will not take the headers into account, linking content will not be easy and it will
cause an error when importing the archives.
In the table (step 2) you must ensure that the importation column coincides correctly with the
content that we provide in the CSV column (drop-down lists). For example, if the urls of the
product photos are in the BigBuy CSV column, you must ensure that Prestashop has correctly
named them ‘urls of images (x,y,z…)’ in said column, as otherwise it will cause importation
errors.
NOTE: You can see the relationship between the columns in ANNEX 5 and the
specifications of each file in ANNEX 1, ANNEX 2, ANNEX 3 and ANNEX 4
To finish the importation process you must press the button Import CSV data.
IMPORTANT:
If problems occur during the importation process (page displays Internal Server Error) try it
again, and if the error occurs again you must consider dividing that file into smaller files.
When importing, problems highlighted in a red box may also occur, but they will not be of
great importance to you, as long as Prestashop informs you that they have been resolved in
another box below in red, with both displayed at the top of the page.
Ensure that the type is correct in the drop-down list of the CSV archive to be processed, as occasionally
through carelessness some categories or a different entity will remain selected.
DELETE_EXISTING_IMAGES
FEATURE
AVAILABLE_ONLINE_ONLY
CONDITION
CUSTOMIZABLE
UPLOADABLE_FILES
TEXT_FIELDS
OUT_OF_STOCK
ID_NAME_OF_SHOP
ADVANCED_STOCK_MANAGEMENT
DEPENDS_ON_STOCK
WAREHOUSE
Products
UPC UPC
Ecotax ECOTAX
Width WIDTH
Height HEIGHT
Depth DEPTH
Weight WEIGHT
Quantity QUANTITY
Minimal quantity MINIMAL_QUANTITY
Visibility VISIBILITY
Additional shipping cost ADDITIONAL_SHIPPING_COST
Unit UNIT
Unit Price UNIT_PRICE
Short description SHORT_DESCRIPTION
Description DESCRIPTION
Tags (x,y,z...) TAGS
Meta title META_TITLE
Meta keywords META_KEYWORDS
Meta description META_DESCRIPTION
URL rewritten URL_REWRITTEN
Text when in stock TEXT_WHEN_IN_STOCK
Text when backorder allowed TEXT_WHEN_BACKODER_ALLOWED
Available for order (0 = No, 1 = Yes) AVAILABLE_FOR_ORDER
Product available date PRODUCT_AVAILABLE_DATE
Product creation date PRODUCT_CREATION_DATE
PRODUCT_UPDATE_DATE
Show price (0 = No, 1 = Yes) SHOW_PRICE
Image URLs (x,y,z...) IMAGES_URL
Delete existing images (0 = No, 1 = Yes) DELETE_EXISTING_IMAGES
Feature(Name:Value:Position) FEATURE
Available online only (0 = No, 1 = Yes) AVAILABLE_ONLINE_ONLY
Condition CONDITION
Customizable (0 = No, 1 = Yes) CUSTOMIZABLE
Uploadable files (0 = No, 1 = Yes) UPLOADABLE_FILES
Text fields (0 = No, 1 = Yes) TEXT_FIELDS
Out of stock OUT_OF_STOCK
ID / Name of shop ID_NAME_OF_SHOP
Advanced stock management ADVANCED_STOCK_MANAGEMENT
Depends On Stock DEPENDS_ON_STOCK
Warehouse WAREHOUSE
Combinations
Manufacturers
http://notepad-plus-plus.org/
3. If it is not displayed correctly then hover the mouse over the first cell in the column, in
this case Q, and a downward arrow will appear, then click and you will have selected
the column. Afterwards right click on the mouse over the column and on the menu
that appears, select Cell format.
4.
5. In the pop-up window select Special on the menu on the left and then click accept.
6. After making that modification place the mouse over the first cell in the column, in this
case AF, and a downward arrow will appear, then click and drag without letting go and
select both columns.
7. Press Sort and filter and select Filter, and a drop-down arrow will appear in the
Created and Modified cell.
8. Drop down the list and select Filter by date and then personalised filter
9. In the pop-out window enter the criteria in order to get the products with a later
creation date to the one already shown.
10. When applying it all products with a later date than 1st November 2012 will remain.
Once the filter has been carried out, copy the result data in the new Excel, then save it
as comma-delimited CSV.
11. Open the CSV with the programme Notepad++ .
12. Click on Codification and then on Convert to UTF-8 and save the archive.
You can do the same for applying a filter by date of update in order to have all updated stock
products.
Occasionally when importing a CSV with many references, PRESTASHOP freezes with a blank
screenshot or as if it has crashed. (Both for hosting providers and when trying to import
locally).
That is usually due to the settings of your php.ini archive in the hosting. The execution time of
the script is too low and you would need to increase it.
In said archive there is a variable called max_execution_time, which should increase the value
due to the slowness of the importation. This usually occurs the first time you import the
PRODUCTS csv. The rest of the times that there are updates and less information is
transmitted, this shouldn’t happen. Definition of the parameter max_execution_time:
This value establishes the maximum time in seconds that it is allowed to run before the
analyzer stops. This helps to prevent badly written scripts from blocking the server. The default
value is 30. When the PHP is executed from the command line the default value is 0.
The web server may have other waiting time settings that may interrupt the execution of the
PHP. Apache has the timeout directive and IIS has the CGI timeout function. Both are 300
seconds by default. See the documentation on the web server for more specific information.
If the following message appears when opening the CSV with the Excel programme using a
MAC computer:
This problem is caused when you open a text archive or a CSV archive and the two first
characters of the archive are the upper-case letters ‘I’ and ‘D’. For example, the field ID.
https://support.microsoft.com/es-es/kb/323626
https://support.microsoft.com/en-us/kb/323626
https://support.microsoft.com/fr-fr/kb/323626
If it is the first time that you are importing our new catalogue and when uploading files of the
corresponding products to the categories you want to display in your shop, a list of categories
is shown, the only information of which is their ID, you must follow the following steps:
This is due to the fact that within the CSV of products in the categories column it refers to
categories that do not exist and Prestashop creates them with the only information it has
which are the IDs, which is why you must upload all categories and subcategories and then
deactivate those you do not wish to display.