Accueil > Intégration par flux CSV ou XML

Integrácia fluxu CSV alebo XML

Úvod

Produkty z Vašej stránky môžu byť integrované na stránku Spartoo cez flux CSV alebo XML.
V tom prípade musia byť súbory CSV alebo XML, ktoré obsahujú informácie o všetkych Vašich produktoch, prístupné na internete pre nášho robota.

Náš robot sťahuje približne každú hodinu aktuálne súbory a integruje na stránku informácie, ktoré sú v súboroch uložené.
Súbor by mal byť čo najaktuálnejší, aby sa predišlo situácii, že sa na stránke Spartoo budú zobrazovať produkty, ktoré už nie sú dostupné.

Súbor musí obsahovať všetky potrebné informácie pre kategorizáciu produktov a pre kvantovanie stavu skladových zásob.

Políčka na vyplnenie sú buď povinné, odporučené alebo nepovinné. Pokiaľ je jedno povinné políčko nevyplnené alebo zle vyplnené, produkt nebude integrovaný.
Nižšie nájdete niekoľko modelových príkladov súborov CSV alebo XML. Modelový príklad súboru nie je strikne vyžadovaný spoločnosťou Spartoo. Napriek tomu musí súbor obsahovať všetky povinné informácie.

Ideálne by Váš súbor mal používať kódovanie UTF-8. Pokiaľ tomu tak nie je, prosíme Vás, aby ste nás na túto skutočnosť upozornili, aby sme mohli konfigurovať úpravu súboru.
Pri súboroch CSV musí súbor obsahovať bodkočiarku ";". Pokiaľ tomu tak nie je, prosíme Vás, aby ste nás na túto skutočnosť upozornili, aby sme mohli konfigurovať úpravu súboru.


Ak nemáte prístup k zdieľaným súborom (server ftp), Spartoo vám odporúča použiť Dropbox.
viac informácií

Definícia

  • Produkt alebo hlavný produkt: Pre Spartoo zodpovedá hlavný produkt určitému modelu a jeho farebnému prevedeniu.
    Takže pre model, ktorý existuje v 2 farebných prevedeniach, sa jedná o dva produkty, ktoré zodpovedajú dvom rôznym identifikačným číslam produktov.
    Jeden takýto produkt však môže existovať vo viacerých veľkostiach.

  • Vedľajší produkt: Pre Spartoo zodpovedá vedľajší produkt určitému modelu a jeho špecifickej veľkosti.
    Takže pre model, ktorý existuje v jednom farebnom prevedení a v dvoch rozličných veľkostiach, budú dva vedľajšie produkty (jedno jediné identifikačné číslo pre produkt a dve identifikačné čísla vedľajších produktov).
    Skladové zásoby musia zodpovedať počtu vedľajších produktov. To je zároveň aj jediná povinná ifnormácia pre všetky vedľajšie produkty. Ostatné informácie sa týkajú výhradne hlavných produktov a môžu byť vynechané pri vedľajších produktoch.

Zoznam informácií pre tok CSV

Názov políčka Políčko Popis
SKU / Identifikačné číslo produktu Povinné Políčko môže obsahovať hodnotu SKU čísla hlavného alebo vedľajšieho produktu.
V prípade, že obsahuje SKU číslo hlavného produktu, môže obsahovať iba povolené znaky (a-Z 0-9 . _ -)
V prípade, že obsahuje SKU číslo vedľajšieho produktu, políčko nie je povinné a môže obsahovať akékoľvek znaky.
Hlavný produkt / Vedľajší produkt Povinné pre CSV Vyplnenie tohto políčka je povinné v prípade, že súbor obsahuje jeden riadok pre hlavný produkt a jeden riadok pre vedľajší produkt.
V tom prípade nám treba poskytnúť návod, ako budeme môcť identifikovať, či riadok patrí hlavnému alebo vedľajšiemu produktu.
Toto políčko môže napríklad obsahovať poznámku "Parent" pre hlavné produkty a "Child" pre vedľajšie produkty.
Hlavný produkt SKU Povinné pre CSV Vyplnenie tohto políčka je povinné v prípade, že súbor obsahuje jeden riadok pre hlavný produkt a jeden riadok pre vedľajší produkt.
Pri každom vedľajšom produkte potrebujeme vedieť, ku ktorému hlavnému produktu zodpovedá aký vedľajší produkt.
Toto políčko musí teda obsahovať identifikačné číslo hlavného produktu.
Názov modelu Odporučené Toto políčko musí výhradne obsahovať len názov modelu, nesmie obsahovať iné informácie (kategóriu, farbu, značku)
Názov značky Povinné
Kód IDU Odporúča sa Toto pole obsahuje kód IDU produktu (voir loi AGEC)
Pohlavie Povinné Pre aké pohlavie je produkt určený? Treba použiť nasledovné označenia:
  • H: pánsky
  • F: dámsky
  • M: unisex dospelí
  • B: chlapec
  • G: dievča
  • K: unisex deti
Cena tovaru Povinné Musí byť povinne udaná v mene "EUR".
Cena sa aplikuje výhradne na hlavný produkt. Nie je možné stanoviť iné ceny pre vedľajšie produkty.
Kategória Povinné Obsahuje kód kategórie produktu. Vyhnite sa, prosím, mikrokategóriám (označeným na červeno) a uprednostnite iné, presnejšie kategórie.
V prípade, že nemôžete použiť kód Spartoo, môžete použiť meno kategórie. V tom prípade treba použiť nástroj kategórií "matching", aby Vaše kategórie zodpovedali kategóriám používaným na stránke Spartoo.

Pozrieť si zoznam veštkých kódov pre kategórie
Výbery Voliteľné Umožňuje špecifikovať kontext používania produktu pomocou zoznamu identifikačných čísel.
Všetky dostupné kontexty sú k dispozícii tu
Znížená cena Odporučené Obsahuje zníženú cenu produktu.
Ak je výška zľavy vyplnená a pritom nezodpovedá výslednej zníženej cene, do úvahy sa berie zadaná znížená cena.
Percento zľavy Odporučené Obsahuje zvolené percento zľavy.
Všetky zľavy sú zaokrúhľované spoločnosťou Spartoo a to smerom nadol k najbližším 5%. Napríklad, percento zľavy 27% bude zaokrúhlené na 25%.
Typ zľavy Odporučené Ak je zľava v rámci výpredaju, treba túto skutočnosť upresniť v tomto políčku.
Dátumy zliav a výpredajov Voliteľné Zľavy môžu byť konfigurované k dátumu ich začiatku a konca.
V prípade, že tieto dátumy nie sú špecifikované, zľava začína okamžite.
V prípade výpredaju môže byť zaujímavé špecifikovať dátum začiatku a konca výpredajov, v tom prípade začnú zľavy v určitý špecifický moment a nebude treba čakať na budúcu integráciu súboru.
Veľkosť Povinné Obsahuje názov veľkosti produktu.
Ak je políčko neprítomné alebo prázdne, bude považovaná veĺkosť produktu ako unikátna.
V prípade veľkosti textilu udanej v mernej jednotke US budeme potrebovať upresniť, či sa jedná o merné jednotky EU alebo US. V tom prípade zadajte US do názvu veľkosti, alebo pridajte políčko, ktoré udáva, či je veľkosť v mernej jednotke US alebo nie.
Počet kusov na sklade Povinné Pre každú veľkosť musíte udať počet kusov na sklade.
Pre dezaktiváciu produktu na stránke treba nastaviť jeho skladové zásoby na 0.
Keď sú skladové zásoby nastavené na 0, produkt je dezaktivovaný a už sa nezobrazuje na stránke Spartoo.
EAN Povinné Štandartný medzinárodný kód pre identifikáciu každého jedného produktu umožňuje jeho zobrazenie na platforme google shopping a na iných porovnávačoch cien.
Fotografie Povinné Povinná je prinajmenšom jedna fotografia.
Odporúčame Vám poskytnúť aspoň 3 kvalitné fotografie. Na stránku môžeme zaintegrovať maximálne 8 fotografií.
Treba nám poskytnúť odkaz na každú fotografiu. Názov dokumentu môže obsahovať jedine znaky abecedy a čísla, rovnako ako znaky "-" (pomlčka), "_" (podtržník) a "." (bodka). Písmená s diakritikou (ako napríklad é, à a ñ) nie sú povolené.
Fotografia bude stiahnutá len jeden krát, následne bude uložená na našom serveri po tom, ako bude jej veľkosť upravená na správnu veľkosť, ktorú používame na Spartoo.
Fotografie musia byť vo formáte jpg, vo formáte štvorca a musia mať rozlíšenie aspoň 350x350 pixelov. Pokiaľ majú rozlíšenie rovné alebo vyšeie ako 800x800 pixelov, na stránke bude možné zobraziť aj zoom na produkty.
Popis tovaru Odporučené Textový popis tovaru.
Popis produktu umožňuje poskytnúť maximum informácii a pomáha pri nákupnom rozhodovaní zákazníka.
Každý produkt by mal obsahovať detailný a špecifický popis. Môže obsahovať názov modelu, farebné prevedenie, informácie o štýle, materiály a podobne.
Nie je sem možné vložiť popis HTML, s výnimkou ukončenia odstavca: <br>, ainsi que <b>, <i> et <u>. '
'. Javascript nie je povolený.
Popis tovaru bude zobrazený iba na stránke s tovarom.
Farba pre filter na stránke Odporučené Identifikátor Spartoo pre farbu produktu. Používa sa pri filtroch v menu.
Pokiaľ nezadáte tento identifikátor, je možné použiť nástroj "matching" farieb, pri ktorom budú názvy farieb zodpovedať farbám používaným na stránke Spartoo.

Pozrieť si zoznam všetkých farebných kódov
Farba Odporučené Textové políčko pre farbu produktu bude zobrazené v popise tovaru.
Zloženie Voliteľné Platí jedine pre obuv.
Môžete udať 4 rôzne zloženia produktu:
  • Zloženie zvršku
  • Zloženie podšívky/li>
  • Zloženie vnútornej stielky
  • Zloženie vonkajšej podrážky
Nedisponujeme nástrojom "matching" pre zloženie produktov, preto treba povinne používať kódy Spartoo.

Pozrieť si zoznam všetkých kódov zloženia produktov.
Výška podpätku Voliteľné Platí jedine pre dámsku obuv (lodičky, čižmy, atď.)
Výška podpätku v cm. Malo by sa uvádzať len číslo a na oddelenie jednotky od desatinného čísla by sa mala použiť bodka (príklad: 1,7)
Ďalšie informácie Voliteľné Zoznam informačných kódov oddelených čiarkou (napr.: '120,521')
Zobraziť možné hodnoty
Sezóna Povinné pre MPO Sezóna produktu pozostávajúca z kódu „AH“ (jeseň-zima) alebo „PE“ (jar-leto), za ktorým nasleduje rok.
(napr.: FW21, SS22)

Zoznam informácií pre XML feed

> Pozrieť si možnosti
Tag Popis Povinné
reference_partenaire Identifikačné číslo partnerského produktu. Je to SKU číslo, ktoré identifikuje produkt určitej značky a farby
Identifikačné číslo môže obsahovať iba alfanumerické znaky a tiež znaky ako - (pomlčka) _ (podtržník) a . (bodka). 		Áno
idu_code Kód UDI produktu (pozri zákon AGEC) Nie
product_name Názov modelu
Nesmie obsahovať kategóriu, farbu alebo značku produktu
Tiež nesmie obsahovať znaky alebo tagy html
 Nie
manufacturers_name Názov značky produktu Oui
product_sex Pohlavie, pre kt. je produkt určený
> Pozrieť si možnosti 		Áno
product_price Cena produktu v mene euro Áno
color_id Farba určená pre filtre v menu
Ak nie je uvedená, produkt sa zákazníkovi neukáže, pokiaľ si tovar vyfiltruje podľa určitej farby
> Pozrieť si možnosti 		Nie
product_style Kategória produktu
> Pozrieť si možnosti 		Áno
product_description Popis produktu. Zobrazuje sa na stránke s produktom. Nie
product_color Voľné textové políčko pre farbu produktu. Zobrazuje sa na stránke s produktom. Nie
product_quantity Celkové skladové zásoby produktu
Neberie sa v úvahu ak je pre produkt identifikovaný 1 alebo viacero tagov size_quantity.
Pre produkty s iba jednou veľkosťou je tag product_quantity nevyhnutný ak nie je uvedený tag size_quantity. 		Nie
Veľkosť Zoznam veľkostí a im zodpovedajúce skladové zásoby.
Voliteľné pre produkty, ktorých veľkosť je univerzálna ( Tašky / Doplnky). V opačnom prípade je zadanie veľkosti povinné. 		Áno / Nie
size_name Názov veľkosti
> Pozrieť si možnosti 		Áno Nie / Áno
size_quantity Skladové zásoby produktu pre túto veľkosť Oui
size_reference Referenčné označenie tovaru pre veľkosť
Toto políčko slúži iba na preposlanie v exportoch objednávok a vráteniach. Je praktické generovať toto referenčné označenie spojením políčok reference_partenaire a size_name za pomoci podtržníka "_". 		Nie
EAN EAN pre veľkosť produktu Nie
fotografie Zoznam fotografií a ich url.
Povinná je minimálne jedna fotografia.
Odporúčame minimálne 3 fotografie. Maximálny počet fotiek je 8.
Fotografia bude stiahnutá len raz, po úprave veľkosti na rozmery Spartoo bude následne uložená na našich serveroch.
Fotografie musia byť vo formáte jpg, musia mať štvorcový tvar a minimálny rozmer 350x350 pixelov. Ak sú väčšie alebo rovné 800x800 px, na stránke bude možnosť zoomovania. 		Oui
url1, url2 ... url8 Linky k fotografiám
Ku každej fotografii je potrebné poskytnúť link. Názov súboru môže obsahovať výlučne abecedné a číselné znaky, "-" (spojovník) , "_" (podtržník) a "." (bodku). Medzery a písmena s diakritikou (ako napr. é, à alebo ň) nie sú povolené. 		Oui
heel_height Výška podpätku v centimetroch (cm). Iba pre dámsku obuv. Na oddelenie jednotky od desatinných miest sa musí použiť čiarka (napríklad: 1,5). Nie
product_composition Zloženie zvršku produktu. Iba pre obuv a tašky.
> Pozrieť si možnosti 		Nie
voering_composition Zloženie podšívky produktu. Iba pre obuv a tašky.
> Pozrieť si možnosti 		Nie
first_composition Zloženie vnútornej stielky produktu. Iba pre obuv.
> Pozrieť si možnosti 		Nie
zool_composition Zloženie vonkajšej podrážky produktu. Iba pre obuv.
> Pozrieť si možnosti 		Nie
Zľava Umožňuje uplatnenie zľavy na produkt.
Políčko rate (percento zľavy) políčka discount (zľava) sa týka zľavy z ceny v percentách product_price.
Políčko price_discount políčka discount (zľava) sa týka zľavnenej ceny produktu. Percento zobrazenej zľavy bude následne vypočítané.
Ak sú vyplnené obe políčka, políčko price_discount má prioritu nad políčkom rate (percento zľavy).
Ak je zľava okamžitá, nie je potrebné upresniť políčko startdate. Ak políčko stopdate nie je nie je zadané, zľava bude mať predvolenú dobu trvania jeden mesiac. Aj je tag sales (výpredaj) upresnený, zľava bude výpredajovou zľavou. V opačnom prípade sa bude jednať o klasickú zľavu. Zadanie tohto parametru umožňuje, aby bol produkt prítomný na stránke s ostatnými produktami vo výpredaji počas obdobia výpredajov. 		Nie
extra_infos Umožňuje špecifikovať dodatočné informácie pre určitý typ produktov.
Každá informácia je zložená z identifikátora ( > Pozrieť si možnosti ) a jednej hodnoty v numerickej podobe. 		Nie
Výbery Slúži na špecifikáciu produktu za pomoci zoznamu identifikátorov.
Všetky možné kontexty sú k dispozícii po kliknutí sem. 		Nie


Formát parametra xml


Textové polia musia byť chránené značkami CDATA , ak obsahujú špeciálne znaky, ktoré by spôsobili neplatnosť XML.

Formát mono krajiny

<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>
				<!-- ... Viacero možných tagov "size" ... -->
			</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>
				<!-- ... Viacero možných tagov "info" ... -->
			</extra_infos>
			<selections>
				<selection>int</selection>
				<!-- ... Viacero možných tagov "selection" ... -->
			</selections>
	   </product>
	   <!-- ... Viacero možných tagov "product" ... -->
   </products>
</root>


Formát multi krajiny

<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>
				<!-- ... Viacero možných tagov "language" ... -->
			</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>
						<!-- ... Viacero možných tagov "language" ... -->
					</languages>
				</size>
				<!-- ... Viacero možných tagov "size" ... -->
			</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>
				<!-- ... Viacero možných tagov "info" ... -->
			</extra_infos>
			 <selections>
				<selection>int</selection>
				<!-- ... Viacero možných tagov "selection" ... -->
			</selections>
	   </product>
	   <!-- ... Viacero možných tagov "product" ... -->
   </products>
</root>


Príklady súborov

Súbory CSV

Súbor CSV s rodičovským produktom / klasickým detským produktom

Súbor CSV pre viacero krajín

Súbory XML

Príklad súboru XML Mono krajina

Príklad súboru XML Multi krajina

Súbory XSD

Súbor XSD Multi krajina

Zoznam chybových kódov pre produkty


Kód Level Popis
1 Fatal Referenčné číslo partnera nie je dostatočne dlhé
2 Fatal Referenčné číslo partnera nie je platné. Môže obsahovať len alfanumerické znaky.
3 Warning Názov produktu nebol uvedený
4 Fatal Značka nebola uvedená
5 Fatal Druh je neplatný, jediné možné hodnoty sú: H, F, M, K, G, B
6 Fatal Cena musí byť uvedená ako číslo
7 Fatal Cena je záporná alebo nie je uvedená
8 Warning Cena sa nám zdá príliš vysoká (>1000 eur)
9 Fatal Množstvo musí byť celočíselné číslo
10 Fatal Množstvo musí byť kladné
11 Warning Farba xxx neexistuje: tovar nebude vyhladateľný cez filter farieb
13 Fatal Kategória xxx neexistuje
14 Warning Popis produktu je prázdny
15 Warning Farba zobrazenia je prázdna
16 Warning Žiaden zoznam veľkostí: použitie jedinej veľkosti
17 Warning Zloženie bol uvedené, ale nie je platné
18 Fatal Fotka 1 je povinná
19 Warning Diskontná sadzba promo akcie musí byť v rozpätí 0 až 100, promo akcia nebude zaregistrovaná
20 Warning Veľkosť xxx neexistuje
200 Fatal Veľkosť xxx pre značku xxx neexistuje.
201 Fatal Kód EAN je povinný
202 Fatal EAN kód xxx na referencii xxx vo veľkosti xxx už používa ref: xxx.
203 Warning Kód EAN je príliš krátky alebo končí na "000".
204 Warning EAN kód xxx existuje v niekoľkých kópiách v toku.
205 Fatal Referencia partnera je príliš dlhá
23 Warning Fotografia xxx je menšia ako 350x350: na stránkach bude mať zlú kvalitu
24 Warning Fotka xxx je menšia ako 350x350: na stránkach nebude zobrazená
25 Fatal Veľkosťxxx: Sklad nie je možné regulovať
26 Fatal Žiaden sklad: produkt nebude vytvorený
27 Fatal Nie je možné získať prístup k fotke 1 ( url xxx )
28 Warning Nie je možné získať prístup k fotke xxx ( url xxx )
281 Fatal Fotka je príliš veľká (xxxo)
30 Fatal Množstvo veľkosti xxx je príliš vysoké (Max. množstvo: xxx)
33 Fatal Tovar patriaci do kategórie xxx nemôže patriť do kategórie xxx
34 Fatal Slovo xxx nie je vhodné a nemalo by sa v žiadnom prípade objaviť v názve alebo popise tovaru.
35 Fatal Názov produktu je príliš dlhý, má obsahovať iba názov modelu
341 Fatal Slovo xxx nie je vhodné a nemalo by sa v žiadnom prípade objaviť v popise tovaru.
36 Fatal Produkt nie je možné vložiť: pre daný produkt existuje duplikát veľkosti/farby.
38 Fatal Veľkosť xxx môže byť na daný tovar xxx použitá len raz
39 Warning Odkaz na partnera sa vyskytuje viackrát, duplicity boli ignorované
42 Warning Sezóna je neplatná.
43 Warning Informácia o výrobku xxx zodpovedá typu výrobku = xxx a nie xxx.
44 Warning Kategória xxx nezodpovedá typu produktu xxx ale xxx.
451 Fatal Žiadna cena za veľkosť xxx pre krajinu xxx. (nutná zľava)
452 Warning Prekročený dátum ukončenia zľavy pre veľkosť xxx v krajine xxx.
453 Fatal "sadzba" (xxx) je neplatná pre veľkosť xxx a krajinu xxx.
454 Fatal "sadzba" (xxx) > 85% pre veľkosť xxx a krajinu xxx.
455 Warning Veľkosť xxx má cenu v krajine (xxx), ktorá nie je pre produkt definovaná.
456 Warning Veľkosť xxx má cenu v krajine xxx identickú s globálnou cenou v tejto krajine.