Accueil > Intégration par flux CSV ou XML

Integration by CSV or XML stream

Introduction

The products available on your website can be uploaded on Spartoo either by CSV or XLM flux.
In this case, the CSV or XLM file containing all of your product information must be available on the internet and accessible by our processor.

Every hour, our processor will download the file and it will integrate the information contained within the file.
The file must be as up to date as possible to prevent unavailable items from appearing as in stock on Spartoo.

The file must contain all the information necessary to categorise your products and quantify your stock.

Each field can be either obligatory, recommended, or optional. If one of the obligatory fields is empty or incorrectly filled in, the product will not be uploaded.
At the end you will find a few example CSV and XML file models. The file example is not used by Spartoo. However, your file must contain all of the obligatory information.

Ideally, your file should use UTF-8 encoding. If this isn't the case, please let us know so that we can configure the uploading of your file.
For CSV files, the file should use the semicolon ';'. If this is not the case, please let us know so that we can configure the uploading of your file.


If you do not have a file sharing server (ftp server) Spartoo advises you to use Dropbox.
more information

Definition

  • Product or Parent product : For Spartoo, a product refers to a style and a colour.
    So, for a style that comes in two colours, there will be two products (and two different product identification codes)
    However, a product can have multiple sizes.

  • Child product: For Spartoo, a child product refers to a product and a specific size.
    So, for a style that comes in one colour and two sizes, there will be two "child products"(one product identification code and two child product identification codes)
    The stock must be associated with a child product. This is the only required information for child products. Other information essentially concerns parent products and it may be omitted for child products.

Lista s informacijama za CSV sadržaj

Naziv polja Polje Opis
SKU / Identifikacijska oznaka proizvoda Obavezno Navedeno polje sadrži vrijednost "parent SKU" za polja koja se odnose na "parent", i "sku child" za polja koja se odnose na "child".
"Sku parent" može posjedovati samo alfanumeričke znakove (a-Z 0-9 . _ -). Razmaci nisu dopušteni.
"Sku child" može sadržavati bilo koju vrstu znakova.
Parent/Child Obavezno za CSV Navedeno polje obavezno je kada dokument sadrži jednu liniju za proizvod i jednu liniju za child proizvod.
U tom slučaju potrebno nam je pružiti način identifikacije kako bismo znali da li je određena linija proizvod ili child proizvod.
Ovo polje može, na primjer, sadržavati "Parent" za parent proizvode i "Child" za child proizvode.
Parent SKU Obavezno za CSV Ovo polje obavezno je kada dokument sadrži jednu liniju za proizvod i jednu liniju za child proizvod.
Za svaki child proizvod važno je da znamo kojem parent proizvodu pripada.
Ovo polje mora dakle sadržavati identifikacijsku oznaku parent proizvoda.
Naziv modela Preporučuje se Ovo polje mora sadržavati samo naziv modela, ne i ostale informacije (kategoriju, boju, marku i sl.)
Naziv marke Obavezno
Spol Obavezno Spol proizvoda. Bilo bi idealno kada bi sljedeće oznake bile upotrijebljene:
  • H : Muškarci
  • F : Žene
  • M : Uniseks (odrasli)
  • B : Dječaci
  • G : Djevojčice
  • K : Uniseks (djeca)
Cijena proizvoda Obavezno Cijena mora obavezno biti izražena u valuti 'EUR'.
Cijena se odnosi samo na parent proizvode. Nije moguće imati različite cijene za child proizvode.
Kategorija Obavezno Sadrži kod kategorije proizvoda. Molimo Vas da izbjegavate makro-kategorije (u crvenom) i koristite druge, koje su preciznije.
Ako ne možete navesti Spartoo kod, molimo vas da navedete naziv kategorije. Zatim će biti potrebno upotrijebiti alat za usklađivanje kategorija, kako bi vaše kategorije odgovarale Spartoo kategorijama.

Vidi listu sa svim kodovima kategorija
Selekcije Fakultativno Omogućuje određivanje konteksta za upotrebu proizvoda pomoću ID liste.
Svi konteksti dostupni su ovdje
Snižena cijena Preporučuje se Sadrži sniženu cijenu proizvoda.
Ako je stopa popusta unesena i ne odgovara sniženoj cijeni, snižena cijena je vrijednost koja će se uzeti u obzir.
Postotak popusta Preporučuje se Sadrži željenu stopu popusta.
Spartoo će vrijednosti svih popusta zaokružiti (prema niže) do 5%. Primjerice, popust od 27% će biti zaokružen na 25%.
Vrsta popusta Preporučuje se Ako je riječ o sezonskom sniženju, treba to precizirati u ovom polju.
Datumi sniženja Fakultativno Datumi početka i kraja sniženja mogu biti konfigurirani.
Ako navedeni datumi nisu precizirani, sniženje će početi istog trena.
Vrlo je poželjno navesti datum početka i kraja sezonskog sniženja, kako bi popusti počeli u pravom trenutku i kako bi se izbjeglo čekanje integracije dokumenta.
Veličina Obavezno Sadrži naziv veličine proizvoda.
Ako polje nije navedeno ili je prazno, smatrat će se da je riječ o univerzalnoj veličini.
U slučaju US veličina za tekstil, mora biti navedeno je li riječ o US ili EU veličinama: treba ili navesti US u nazivu veličine ili dodati polje koje precizira je li riječ o US veličini ili ne.
Količina na zalihi Obavezno Količina treba biti precizirana za svaku veličinu.
Ako želite deaktivirati određeni proizvod, trebate staviti 0 u polje zalihe.
Kada su zalihe na 0, proizvod je deaktiviran i više se ne prikazuje na stranici Spartoo.
EAN Obavezno Standardni međunarodni kod koji identificira svaki proizvod te koji omogućuje kupnju putem google shoppinga i drugih stranica za usporedbu cijena.
Slike Obavezno Obavezna je barem jedna slika.
Savjetujemo vam da imate minimalno tri slike. Maksimalni broj slika koji možemo integrirati je osam.
Morate nam poslati link prema slici. Naziv dokumenta mora sadržavati samo alfanumeričke znakove i znakove "-" (povlaka), "_" (donja crta) i "." (točka). Slova sa specijalnim znakovima nisu dozvoljena.
Slika će se samo jednom preuzeti, a zatim će se predimenzionirati u skladu sa Spartoo dimenzijama i pohraniti na našem serveru.
Slike moraju biti četverokutne, u jpg formatu i imati barem 350x350 piksela. Ako slike imaju 800x800 ili više piksela, opcija zoom-a bit će dostupna na stranici.
Opis proizvoda Preporučuje se Tekstualni opis proizvoda
Opis proizvoda omogućuje unos maksimalnog broja informacija o proizvodu, koje bi mogli pomoći klijentu pri odluci o kupnji.
Dobar opis proizvoda je onaj koji je detaljan i specifičan za svaki proizvod. Stoga je važno da sadrži naziv modela, marku, boju, stil proizvoda, sastav, itd.
Nije moguće umetnuti HTML, uz iznimku točke '
'. Javascript nije dopušten.
Opis proizvoda je vidljiv samo na stranici proizvoda.
Boja za filtere Preporučuje se Spartoo identifikator za boju. Koristi se za filtere u izborniku.
Ako navedeni identifikator nije naveden, moguće je upotrijebiti alat za podudaranje boja kako bi se nazivi boja uskladili sa Spartoo bojama.

Vidi listu svih kodova za boje
Boja Preporučuje se Polje za tekstualni unos boje. Bit će prikazan na stranici proizvoda.
Sastav Fakultativno Isključivo za obuću.
Moguće je unijeti četiri različita sastava:
  • Sastav gornjišta
  • Sastav podstave
  • Sastav uložne tabanice
  • Sastav potplata
Nemamo alat za usklađivanje sastava, stoga je obavezno korištenje Spartoo kodova.

Vidi listu svih kodova za sastav
Visina potpetice Fakultativno Isključivo za žensku obuću (salonke, čizme, itd.)
Visina potpetice mora biti izražena u cm.

Lista informacija za XML feed

Označiti Opis Obavezno
reference_partenaire Identifikator proizvoda prodavača
Identifikator proizvoda može sadržavati isključivo alfanumeričke znakove i sljedeće znakove - (povlaku) _ (donju crtu) i . (točku). 		Da
product_name Naziv modela
Ne smije sadržavati kategoriju, boju ili marku proizvoda.
Ne smije sadržavati html znakove ili oznake.
 Ne
manufacturers_name Naziv marke proizvoda Da
product_sex Spol proizvoda
> Vidi moguće unose 		Da
product_price Cijena proizvoda u eurima (nije obavezno za cijene veličine) Da / Ne
color_id Boja za filtere u izborniku.
Ako navedena boja nije precizirana, proizvod neće biti prikazan u rezultatima pretrage s pomoću filtera.
> Vidi moguće vrijednosti 		Ne
product_style Kategorija proizvoda
> Vidi moguće unose 		Da
product_description Opis proizvoda. Prikazuje se na stranici proizvoda. Ne
product_color Polje za tekstualni opis boje. Pojavljuje se na stranici proizvoda. Ne
size Lista veličina i njihova količina.
Fakultativno za proizvode bez veličine (torbe/modni dodaci). U svim ostalim slučajevima obavezno. 		Da/Ne
size_name Naziv veličine
> Vidi moguće unose 		Da
size_name lang="en" Naziv UK veličine
Obavezno samo za artikle koji će biti dostupni na engleskoj stranici spartoo.co.uk
> Vidi moguće unose 		Ne/ Da
size_quantity Količina proizvoda za određenu veličinu Da
size_reference Referenca proizvoda po veličini.
Ovo polje služi isključivo kako bi se poslalo u izvoz narudžbi ili povrata. Savjetujemo vam da generirate tu referencu spajanjem polja reference_partenaire i size_name s pomoću donje crte "_". 		Ne
ean EAN proizvoda po veličini Ne
photos Lista slika i njihov URL.
Obavezna je barem jedna slika.
Savjetujemo vam da imate minimalno tri slike. Maksimalni broj slika koji možemo integrirati je osam.
Slika će se samo jednom preuzeti, a zatim će se predimenzionirati u skladu sa Spartoo dimenzijama i pohraniti na našem serveru.
Slike moraju biti četverokutne, u jpg formatu i imati barem 350x350 piksela. Ako slike imaju 800x800 ili više piksela, opcija zoom-a bit će dostupna na stranici. 		Da
url1, url2 ... url8 Poveznice prema slikama
Potrebno je poslati nam link prema slici. Naziv dokumenta mora sadržavati samo alfanumeričke znakove i znakove "-" (povlaka), "_" (donja crta) i "." (točka). Slova sa specijalnim znakovima nisu dozvoljena.
 Da
heel_height Visina potpetice izražena u centimetrima (cm). Samo za žensku obuću. Mora biti više od 0,5. Ne
product_composition Sastav gornjišta proizvoda. Samo za obuću.
> Vidi moguće unose 		Ne
voering_composition Sastav podstave proizvoda. Samo za obuću.
> Vidi moguće unose 		Ne
first_composition Sastav uložne tabanice. Samo za obuću
> Vidi moguće unose 		Ne
zool_composition Sastav potplata. Samo za obuću.
> Vidi moguće unose 		Ne
discount Omogućuje da se sniženje primijeni na proizvod ili na veličinu.
Polje rate u polju discount odnosi se na postotak sniženja koji se referira na polje product_price.
Polje price_discount u polju discount odnosi se na popust uključen u fiksnu cijenu. Postotak sniženja će se izračunati.
Ako su oba polja prisutna, polje price_discount ima prednost pred poljem rate.
Ako je riječ o popustu koji će odmah biti aktiviran, nije potrebno odrediti polje startdate. Ako je polje sales određeno, sniženje će biti dio sezonskog sniženja. U suprotnom, bit će riječ o klasičnom sniženju. Određivanje ovog polja uvjetuje da će proizvodi biti prikazani na početnoj stranici za vrijeme sezonskog sniženja. 		Ne
extra_infos Omogućuje unos dodatnih informacija.
Svaka informacija sastoji se od id-a ( > Vidi vrijednosti ) i numeričkog unosa. 		Ne
selections Omogućuje određivanje konteksta za upotrebu proizvoda s pomoću ID liste.
Svi konteksti dostupni su ovdje. 		Ne


XML parameter format


The text fields must be protected by CDATA tags if they contain special characters that would make the XML invalid.

Format single country

<root>
   <products>
	   <product>
			<reference_partenaire>string</reference_partenaire>
			<product_name>string</product_name>
			<manufacturers_name>string</manufacturers_name>
			<code_idu>string</code_idu>
			<product_sex>char</product_sex>
			<product_price>float</product_price>
			<product_quantity>int</product_quantity>
			<color_id>int</color_id>
			<product_style>int</product_style>
			<product_description>string</product_description>
			<product_color>string</product_color>
			<heel_height>float</heel_height>
			<country_origin>int</country_origin>
			<code_hs>int</code_hs>
			<size_list>
				<size>
					<size_name>string</size_name>
					<size_quantity>int</size_quantity>
					<size_reference>string</size_reference>
					<ean>string</ean>
					<code_hs>int</code_hs>
					<product_price>float</product_price>
					<discount>
						<startdate>timestamp</startdate>
						<stopdate>timestamp</stopdate>
						<price_discount>float</price_discount>
						<rate>int</rate>
						<sales/>
					</discount>
				</size>
				<!-- ... Multiple "size" tags possible ... -->
			</size_list>
			<product_composition>int</product_composition>
			<voering_composition>int</voering_composition>
			<first_composition>int</first_composition>
			<zool_composition>int</zool_composition>
			<photos>
			   <url1>url</url1>
			   <url2>url</url2>
			   <url3>url</url3>
			   <url4>url</url4>
			   <url5>url</url5>
			   <url6>url</url6>
			   <url7>url</url7>
			   <url8>url</url8>
			</photos>
			<discount>
			   <startdate>timestamp</startdate>
			   <stopdate>timestamp</stopdate>
			   <price_discount>float</price_discount>
			   <rate>int</rate>
			   <sales>0/1</sales>
			</discount>
			<extra_infos>
				<info>
					<id>int</id>
					<value>float</value>
				</info>
				<!-- ... Multiple "info" tags possible ... -->
			</extra_infos>
			<selections>
				<selection>int</selection>
				<!-- ... Multiple "selection" tags possible ... -->
			</selections>
	   </product>
	   <!-- ... Multiple "product" tags possible ... -->
   </products>
</root>


Format multi country

<root>
   <products>
	   <product>
			<reference_partenaire>string</reference_partenaire>
			<manufacturers_name>string</manufacturers_name>
			<product_sex>char</product_sex>
			<product_quantity>int</product_quantity>
			<color_id>int</color_id>
			<product_style>int</product_style>
			<heel_height>float</heel_height>
			<country_origin>int</country_origin>
			<code_hs>int</code_hs>
			<languages>
				<language>
					<code>string</code>
					<product_name>string</product_name>
					<product_description>string</product_description>
					<code_idu>string</code_idu>
					<product_color>string</product_color>
					<product_price>float</product_price>
					<discount>
					   <startdate>timestamp</startdate>
					   <stopdate>timestamp</stopdate>
					   <price_discount>float</price_discount>
					   <rate>int</rate>
					   <sales />
					</discount>
				</language>
				<!-- ... Multiple "language" tags possible ... -->
			</languages>
			<size_list>
				<size>
					<size_name>string</size_name>
					<size_quantity>int</size_quantity>
					<size_reference>string</size_reference>
					<ean>string</ean>
					<code_hs>int</code_hs>
					<languages>
						<language>
							<code>string</code>
							<product_price>float</product_price>
							<discount>
								<startdate>timestamp</startdate>
								<stopdate>timestamp</stopdate>
								<price_discount>float</price_discount>
								<rate>int</rate>
								<sales/>
							</discount>
						</language>
						<!-- ... Multiple "language" tags possible ... -->
					</languages>
				</size>
				<!-- ... Multiple "size" tags possible ... -->
			</size_list>
			<product_composition>int</product_composition>
			<voering_composition>int</voering_composition>
			<first_composition>int</first_composition>
			<zool_composition>int</zool_composition>
			<photos>
			   <url1>url</url1>
			   <url2>url</url2>
			   <url3>url</url3>
			   <url4>url</url4>
			   <url5>url</url5>
			   <url6>url</url6>
			   <url7>url</url7>
			   <url8>url</url8>
			</photos>
			<extra_infos>
				<info>
					<id>int</id>
					<value>float</value>
				</info>
				<!-- ... Multiple "info" tags possible ... -->
			</extra_infos>
			 <selections>
				<selection>int</selection>
				<!-- ... Multiple "selection" tags possible ... -->
			</selections>
	   </product>
	   <!-- ... Multiple "product" tags possible ... -->
   </products>
</root>


File Examples

CSV files

CSV file with classic parent / child product

Fichier CSV Multi pays

XML files

XML file example

File example XML Multi country

Files XSD

File XSD Multi country

List of product error codes
Code Level Description
1 Fatal The partner reference is not long enough
2 Fatal The partner reference is not valid, it can only contain alphanumeric characters
3 Warning Ime proizvoda nije određeno
4 Fatal Marka nije određena
5 Fatal Rod nije ispravan, samo sljedeće oznake su moguće: H, F, M, K, G, B
6 Fatal Cijena mora biti izražena u numeričkim znakovima
7 Fatal Cijena mora biti izražena u pozitivnom obliku
8 Warning Cijena se čini previsoka ( > 1000 € )
9 Fatal The amount must be a whole number
10 Fatal Količina treba biti u pozitivnom obliku
11 Warning The colour xxx does not exist: the product will not be available through the colour filters
13 Fatal Kategorija xxx ne postoji
14 Warning Opis proizvoda je prazan
15 Warning The colour description is empty
16 Warning No size list: use a single size
17 Warning The composition is specified, but is invalid
18 Fatal Photo 1 is required
19 Warning The rate of discount must be between 0 and 100, the discount will not be taken into account
20 Warning Veličina xxx ne postoji
201 Fatal EAN barkod je obavezan
202 Fatal EAN kod xxx za referencu xxx u veličini xxx je već upotrijebljen.
205 Fatal Referenca partnera je preduga
23 Warning The photo xxx is smaller than 350x350: it will be of poor quality on the website
24 Warning The photo xxx is smaller than 350x350: it will not be displayed on the website
25 Fatal Size xxx: Unable to regulate stock
26 Fatal Not in stock: Product will not be created
27 Fatal Nije moguće pristupiti slici 1 ( url xxx )
28 Warning Nije moguće pristupiti slici xxx ( url xxx )
30 Fatal The amount of the size xxx is too large (Max amount: xxx)
31 Warning Vaš račun nije aktiviran na stranici xxx
32 Fatal no product information found for this country
33 Fatal A xxx product cannot be put under the category xxx
34 Fatal The word xxx is blacklisted and it should not appear in the product name, nor in the product description.
35 Fatal Naziv proizvoda je predugačak, mora sadržavati samo ime modela. Pogreške u zemlji(ama): xxx
341 Fatal The word xxx is blacklisted and should not appear in the product description.
36 Fatal Nije moguće unijeti proizvod: veličina/boja proizvoda su duplicirani
38 Fatal Veličina xxx može samo jednom biti definirana referencom xxx.
39 Warning The partner reference is present several times in the flow, duplicates have been ignored
42 Warning The season is not valid.
43 Warning The product information xxx corresponds to a product_type = xxx and not xxx.
451 Fatal Nema cijene za veličinu xxx zemlje xxx. (nécessaire pour un discount)
452 Warning Datum završetka popusta je premašen za veličinu xxx zemlje xxx.
453 Fatal "stopa" (xxx) nevažeća je za veličinu xxx zemlje xxx.
454 Fatal "stopa" (xxx) > 85% za veličinu xxx zemlje xxx.
455 Warning Veličina xxx ima cijenu u zemlji (xxx) koja nije definirana za proizvod.
456 Warning Veličina xxx ima cijenu na xxx identičnu globalnoj cijeni u ovoj zemlji.