Académique Documents
Professionnel Documents
Culture Documents
When saving the CSV file, it must have the file extension .csv, otherwise it will not
be recognized as a valid CSV file.
The CSV file must also be encoded in UTF-8 (Unicode). The easiest method of
ensuring that the file is in the correct file type and UTF-8 is to export your existing
products as a CSV file from DaWanda. This and other methods of obtaining a CSV
file in the correct format are covered in the next section.
The next step is to add your product information to the CSV template. Proceed
to the next section, 3.2.
Each row represents a different listing, and all the information relating to your
products has been divided into different sections in the columns along the
top, e.g. the listing title, the product price, etc.
These rows must now be populated with your product information. Certain
columns must be completed before the CSV file can be uploaded, others are
optional. The compulsory columns are listed below:
Table 1: required columns. For a full list of the required and additional columns, and a brief
description of each, see 7.2.1.
Note: prices must be added under the cents column heading of the
DaWanda CSV file in euro cents. This means a price of 10 must be
entered into the CSV template as 1000.
If your prices have too many decimal places after converting them into
Euros, simply round them up to the nearest ten cents before multiplying
by 100.
Example:
Two of the required columns are the Shipping profiles ID and DaWanda
categories ID. DaWanda category IDs assign which category in the catalog your
product will be added to. Shipping Profile IDs assign the shipping costs for your
listings.
If you haven't yet set up shipping profiles in your DaWanda shop, you can do so
here.
1. Access the CSV page (you will need to be logged in to view this page).
2. In the Meta Data tab, click Shipping Profiles and Categories CSV to
download your shipping profile IDs and DaWanda category IDs. As before,
download the Excel only template if you use Microsoft Excel, and if you use
any other spreadsheet application, choose the Standard template.
3. Open these files using your spreadsheet application. They should look similar
to Figure 5 and Figure 6 below.
Figure 7: searching for the appropriate category ID. Hoodies have the category ID 418 and belong to
the category Accessories, under the sub-category Shawls & Scarves
2. Once you have found the correct category ID for your product, copy and paste
it into the relevant row in your CSV template under the heading category_id.
Figure 8: pasting the DaWanda category ID into the appropriate column in the DaWanda CSV
template
Once all products have been added to the CSV file and all required
columns have been populated, it is ready to be saved. Proceed to the next
section where we will cover additional recommended fields to add to your
CSV file.
The following fields described in this section are not currently enforced by the CSV
Upload Tool and can be omitted from the CSV file without triggering any errors
during the import process. However, if these fields are left blank then they will
automatically be set to default values by the system after the CSV file is imported.
Figure 10: recommended fields to include in the CSV to avoid default values being set by the system
The Delivery Time is an estimate for the length of time it will take for the item to
arrive at the customers delivery address. This estimate should factor in the time
required to prepare and package the item for delivery and an average shipping time
for the chosen delivery service provider. The Delivery Time is set on a per product
basis.
10 weeks 27
9 weeks 26
8 weeks 25
7 weeks 24
6 weeks 23
5 weeks 22
4 weeks 21
15-21 days 15
10-14 days 14
6-9 days 13
3-5 days 12
1-2 days 11
Every product on DaWanda has a specified Product Type. There are three possible
Product Types:
Physical product this is the default product type. It refers to tangible goods
that can be held and must be delivered by post.
Digital product refers to products that can be downloaded and are not
delivered by post.
Service refers to services rendered that can neither be delivered by post
nor downloaded.
The Product Type field is under the heading typology on the CSV template. The
possible values are as follows:
Physical (default) 0
Digital 1
Service 2
Note: if no Product Type is specified for a product on the CSV file under the heading
typology then the system will automatically set the default value of 0 (Physical).
The Returns Policy is the info text that appears alongside a DaWanda product,
informing the customer of their rights in the event of defective goods being delivered.
This is set on a per product basis.
In order to set the Returns Policy for a product via the CSV file, it is necessary to first
create at least one Returns Policy using the My DaWanda shop management tools.
This generates an ID that can be added against a product, under the heading
return_policy_id on the CSV file.
Note: it is very important to have at least one Returns Policy set up for your
DaWanda store, preferably set as the standard Returns Policy, which the system can
assign to a new product in the event you do not specify this yourself. If there is no
Returns Policy set up for your store, then product creation will fail.
5. Enter the text for the Returns Policy, which is the text customers will see
when browsing the product in your store. Ensure the text is in the correct
language for the selected tab.
Figure 12: entering the title and text for a new Returns Policy
2. Under the Your Return Policies header, click either the Standard (if you use
any spreadsheet application other than MS Excel) or Excel (if you use MS
Excel) link to download a CSV file containing a list of all your Returns Policies.
3. Open the CSV file in your spreadsheet application. There are two columns, id
and title (Figure 14).
The six-digit number shown in the ID column is the unique identifier of the Returns
Policy. Enter this under the heading return_policy_id on the CSV file for any
product, to specify that Returns Policy for that particular product.
After a product has been assigned a Returns Policy, then exporting a list of your
products as a CSV file will also reveal the Returns Policy ID for each product under
the return_policy_id heading.
Important: once you have set a standard Returns Policy, this will be
automatically assigned to all existing and new products in your store,
unless you specify a different Returns Policy for a product when it is
created.
If you do not have a standard Returns Policy set up, and you do not
assign a Returns Policy during product creation, the product creation
process will fail. It is therefore imperative that you set up at least one
Returns Policy for your DaWanda store and define it as the standard (as
per step 9 in section 3.2.2.3.1).
2. Select Active Listings. A list of currently active products within the store is
displayed.
4. In the Edit Listings window that appears, click Set to Automatically Renew.
3.3
All versions of Microsoft Excel automatically encode CSV files in UTF-8, there is no
need to specify this. Follow these steps to ensure the file format is correct:
Figure 15: setting the file type and file extension in Microsoft Excel 2013
4. Click Save. If a dialog appears asking if you want to keep using this format,
click Yes (see 11).
It may be necessary to specifically set UTF-8 encoding when saving CSV files with
LibreOffice.
Follow these steps to ensure the file format and encoding is correct:
Figure 17: setting the file type and file extension in LibreOffice
The CSV file is now ready for uploading. Proceed to the next section (3.5) for
instructions on how to do this.
4. Double click the CSV file or click it once and then click Open.
5. The file name of the CSV file now appears alongside the Browse/Choose File
button. To immediately publish the products in the CSV after upload, click the
Publish products instantly check box. If left unchecked, the products will be
saved as draft listing in your shop after upload (not visible in the shop).
7. Check your email account. If there were problems with the CSV file, then an
email will arrive with the subject DaWanda product CSV upload encountered
some errors.
8. Click the link in the email to download a version of the file that failed to upload
containing updated information that explains why the upload failed. To locate
this information, open the CSV download and scroll across to the last column
with the heading 'errors'. This column will contain information on which rows
from your file could not be uploaded, and why.
Figure 22: products listed in the Drafts folder after successful CSV upload
9. If the CSV upload was successful, you will receive an email with the subject
Your DaWanda CSV product upload was successful. Log in to My
DaWanda. The products you uploaded via CSV should be present in the
Active or Draft Listings section, depending on whether or not you clicked the
Publish products instantly check box in step 5.
DaWanda uses the unique product_id field to identify your products, and if a CSV
file is uploaded containing a row with a recognized product_id value, the listing will
be updated according to the data in the CSV file.
Alternatively, the SKU field can be used instead to identify your products.
The only required fields when updating an existing product is the Product ID
or the SKU and the field that is to be updated. However, when updating
multiple products in this way, it is recommended to leave the Title field present
to help you identify products more easily.
Follow these steps to export a CSV file containing your active listings:
The next step is to remove any listings from the spreadsheet that you do not
wish to update and (optionally) add additional column headers. Proceed to 4.2.
Once all product rows have been modified as required, the CSV file is ready to
be saved and uploaded. Saving the CSV file is covered in section 3.2.2.4 and
uploading the CSV file is covered in section 3.5 (the processes are exactly the
same when updating listings via CSV).
The following example demonstrates how to update only the availability (e.g. the
available quantity) of an active DaWanda product using CSV export and upload:
Figure 23: opening the exported CSV file downloaded from My DaWanda
9. Delete all product rows from the CSV file which do not require updating.
Leave only the product(s) which are to have the availability updated.
Figure 24: deleting all but the product that is to be updated (SKU: 11122)
10. The exported file will have many column headers that are not required when
updating a product. Delete all column headers except the Product ID or the
SKU, the Title and the Availability.
Figure 25: deleting the column headers which are not required for updating the product
11. Make the required changes to the availability of the product(s) by entering a
new quantity into the available column.
12. Save the file as a CSV file in the correct format, as detailed in section
3.2.2.4.
An SKU is a Stock Keeping Unit, and is a unique identifier or number that some
businesses use to distinguish their products and manage their inventory. It is not a
compulsory field and should be left blank unless you have an established SKU
product management system. If left blank, DaWanda will assign an SKU for you.
When updating products via CSV, DaWanda is able to identify products using either
the SKU or Product ID.
If you want to edit existing active listings via CSV, make sure that you export your
active listings via the CSV export tab. You will see that these listings will include a
Product ID, which ensures that, when you reupload your edited CSV file, the existing
listings are updated as opposed to duplicate listings being created.
When updating products via CSV, DaWanda is able to identify products using either
the SKU or Product ID.
To list products in multiple languages, add the following column headers for the
languages you wish to support:
Title_in_xx
Description_in_xx
Where xx is the language code for the desired language as per the following table:
Once the column headers have been added, add the title/description in the
appropriate language for each product row. The example CSV file shown below
demonstrates additional German language support:
Standard CSV templates use a comma as the separating value, whereas Excel CSV
template uses tab as a separator. Only download and fill in the Excel CSV file if you
are using Microsoft excel on your computer to sert up your CSV file. If you use any
other spreadsheet software, (like Libreoffice calc), then download and fill in the
'standard' CSV file.
The character set should be Unicode UTF-8. The language for the column headers
should be English. See 2.2.1 for precise instructions on how to save files in the
correct format.
The required separator for the DaWanda CSV file is comma or tabs.
Shop categories are something that Sellers set up to help organise the listings in
their shop and make it easier for buyers to browse their inventory. For example, a
Fashion seller might have shop categories like 'Hoodies', 'Summer Dresses' or
'Spring Collection 2014', where buyers can look through products relevant to these
categories.
To set these categories up, go to Edit Shop Categories in My DaWanda, and click
Add a new shop category. Once you've set up your shop categories, export them
from the Meta Data tab, and assign them to your listings in the same way as you
would assign the DaWanda categories, under the column heading Shop Category
ID.
Refer to 5.1.4 for information on the difference between these two templates.
http://en.dawanda.com/csv/meta_data
When saved with the spreadsheet application as a CSV file (with the file extension
.csv), the data is converted into the following format:
Each row is a separate line, with the columns from the spreadsheet divided up using
commas. Because of the ease with which CSV files can be read, modified and
created using spreadsheet applications, it is a very common file format for the import
and export of web application data.
The DaWanda CSV file requirements are a little more complex than the example
shown above, but follow the same principle. Each row contains a separate product,
with the individual data fields defined on the first row as column headers.
The Description is for information purposes only and should not be added to the
CSV file. The Expected Format Example shows an example data entry in the
expected format.
The following data columns must be present in the CSV file, or it will be rejected by
the CSV Upload Tool:
Once added to a spreadsheet, the example shown above would look like this:
Note: that the data in the cells D2 (image_1) and F2 (title_in_en) are not fully
visible as the column is not wide enough. This is no problem as long as the data is
complete within the cell when clicked. There is no need to adjust the column widths
or enable word wrap, as these settings will not be retained when the file is saved in
CSV format.
A current list of DaWanda categories and your unique shipping profiles can be
downloaded as CSV files from the following page:
http://en.dawanda.com/csv/meta_data
The downloaded CSV files can be opened with the same spreadsheet application
you are using to create your product CSV file with. Simply copy the required
categories and shipping profiles from the downloaded CSV file into the required cells
in your product CSV file.
Prices must be added under the cents column heading of the DaWanda CSV file in
cents of whatever the store currency is.
For example, if a product is selling for 50 then enter the price as 5000 (multiply the
price by 100).
Reminder: the CSV file will be rejected if it does not contain all of the
column headers in the table in 7.2.1.
The following data columns are optional when creating a CSV file. They can be
omitted from the file and it will still be recognized, as long as the required columns
(see 7.2.1) are present:
If you experience any issues with the CSV Upload Tool, feel free to contact
csv@dawanda.com
The CSV Upload Tool and associated documentation is 2014 DaWanda GmbH
DaWanda GmbH
Windscheidstr. 18
10627 Berlin
http://www.dawanda.com