Accueil > Intégration par flux CSV ou XML

Integrace fluxu CSV nebo XML

Úvod

Produkty z vaší stránky mohou být integrovány na Spartoo přes flux CSV nebo XML.
V tomto případě soubory CSV nebo XML obsahují informace o všech vašich produktech a jsou dostupné na webu prostřednictvím našeho robota.

Náš robot stahuje každou hodinu soubor a integruje informace, které soubor obsahuje.
Soubor musí být co nejaktuálnější, aby nebyly nedostupné produkty zobrazovány na Spartoo.

Soubor musí obsahovat všechny nezbytné informace dle kategorizace produktů a jejich kvantifikaci dle skladových zásob.

Pole může být typu povinné, doporučené nebo volitelné. Pokud je povinné pole prázdné, nevyplněno, produkt nebude integrován.
Níže naleznete modely souborů CSV nebo XML. Model souborů je příkladem, není pro vás předpisem. Ale vždy musí soubor obsahovat všechny povinné informace.

V ideální případě používejte kódování UTF-8. Pokud používáte kódování jiné, informujte nás o tom, aby jsme soubor správně konfigurovali.
Pro soubory CSV musí soubor používat středník ';'. Pokud používáte jiné značení, informujte nás o tom, abychom mohli správně soubor konfigurovat.

Pokud nemáte k dispozici server pro sdílení souborů (ftp), Spartoo Vám doporučuje používat Dropbox.
více informací

Definice

Produkt nebo Produkt parent: na Spartoo každý produkt koresponduje jednomu modelu a jedné barvě.
Pro model, který má dvě barvy, budou vytvořeny dva produkty (dva identifikátory rozdílných produktů)
Ale jeden produkt může mít více velikostí.
Produkt child: na Spartoo produkt child koresponduje jednomu produktu a jedné samostatné velikosti.
Tedy pro model, který má jednu barvu a dvě velikosti, budou vytvořeny dva produkty child (jeden samostatný identifikátor produktu a dva identifikátoy pro produkt child).
Skladové zásoby musí být povinně spojený s produkty child. Toto je jediná povinná informace pro produkty child. Ostatní informace se týkají především produktů parents a pro produkty child mohou být vynechány.

Seznam informací

Název pole	Pole	Popis
SKU / Identifikace produktu	Povinné	SKU identifikuje každý parent produkt Může obsahovat alfanumerické znaky a také - (pomlčku) _ (podtržítko) a . (tečku). Jeden identifikant může vždy náležet jednomu produktu child (například kód EAN), ale není to podmínkou.
Parent / Child	Povinné pro CSV	Toto pole je povinné v případě, že soubor obsahuje pro každý řádek jeden produkt a pro každý řádek jeden child produkt V tomto případě nám prosím sdělte, jak rozlišujete v řádcích produkt a child produkt Pole může být například pro produkt parent označeno jako "Parent", pro child produkt jako "Child"
Parent SKU	Povinné pro CSV	Toto pole je povinné v případě, že soubor obsahuje pro každý řádek jeden produkt a pro každý řádek jeden child produkt Pro každý produkt child potřebujeme vědět, který produkt parent koresponduje jakému produktu child. Toto pole musí obsahovat identifikátor produktu partner.
Název modelu	Doporučeno	Toto pole musí obsahovat pouze název modelu, ne jiné informace (kategorii, barvu, značku)
Název značky	Povinné
Kód IDU	Doporučeno	Toto pole musí obsahovat kód produktu
Sex	Povinné	Pro koho je produkt určen. Ideálně používejte následující kódy: H: Muž F: Žena M: Unisex B: Chlapec G: Dívka K: Děti unisex
Cena produktu	Povinné	Musí být povinně uvedeno v měně: 'CZK'. Cena se aplikuje pouze na produkty parent. Není možné mít jiné ceny u produktů child.
Kategorie	Povinné	Obsahuje kód kategorie produktu. Vyhněte se prosím makro-kategoriím a upřednostněte jiné, přesnější kategorie. V případě, že nemáte kód Spartoo, můžete zadat název kategorie. Zde také musíte použít "matching" spárování kategorií, aby vaše kategorie byly totožné s kategoriemi Spartoo. Zobrazit seznam se všemi kódy kategorií
Výběry	Volitelné	Obsahuje informace o používání produktu prostřednictvím seznamu ID. Kompletní informace najdete zde.
Zvýhodněná cena	Doporučeno	Může obsahovat procentuální slevu nebo cenu již po slevě. Pokud je vyplněna hodnota slevy, která nekoresponduje se zvýhodněnou cenou, bere se v potaz zvýhodněná cena.
Hodnota slevy	Doporučeno	Obsahuje požadovanou hodnotu slevy. Spartoo slevy jsou zaokrouhleny (dolů) po 5%, například, pokud je sleva 27%, bude zaokrouhlena na 25%.
Datum slevy	Nepovinné	Slevy mohou být konfigurovány s datem záčátku a s datem koncem slev. Pokud nejsou data uvedena, sleva bude aplikována okamžitě. Toto může být velmi praktické, pokud zvolíte datum začátku slev, slevy začnou v požadovanou hodinu bez toho, aniž byste museli znovu něco integrovat do souboru.
Velikost	Povinné	Obsahuje název velikosti produktu. Pokud zůstane toto pole prázdné, produkt bude prezentován v unikátní velikost "one size". Pokud jsou velikosti v US značení, je potřeba, abyste uvedli, zda se jedná o EU nebo US: US můžete připsat k názvu velikosti nebo přidat pole, kde bude uvedeno US nebo nic.
Množství skladových zásob	Povinné	Pro každou velikost musí být přesně zadány skladové zásoby. Abyste produkt deaktivovali, stačí do skladové zásoby napsat 0. Pokud je skladová zásoba označena jako 0, produkt je deaktivován a není zobrazován na Spartoo.
EAN	Povinné	Mezinárodní standardní kód pomáhá identifikovat zboží pro google shopping a pro porovnávače cen.
Fotografie	Povinné	Miminálně jedna fotografie je povinná. Dopočujeme vložit pro jeden produkt minimálně 3 fotografie. Maximum je 8. Pro každou fotografii je potřeba nám dodat odkaz. Fotografie bude stáhnuta a od té doby bude uložena na našich serverech a bude převedena do požadovaných velikostí Spartoo. Fotografie musí mít formát JPG, musí být čtvercový a minimální velikost je 350x350 px. Pokud bude velikost větší nebo rovna 800x800px, bude možný zoom fotografie na stránce.
Popis produktu	Doporučeno	Popis produktu Není možné vložit HTML, kromě zalomení řádku: , stejně jako , a . Javascript není povolen. Bude viditelný pouze v popisu produktu.
Filtr barev	Doporučeno	Značení Spartoo barev. Je používáno pro filtrování produktů na stránce. Pokud není toto značení dodáno, je možné použít "matching" spárování barev, pro spárování vašich barev a barev Spartoo. Zobrazit seznám kódů s barvami
Barva	Doporučeno	Textové pole pro barvu. Bude zobrazena v popisu produktu
Složení	Volitelné	Pouze pro obuv. Rozlišujeme 4 základní složení: Složení svršku Složení podšívky Složení stélky Složení podrážky Nemáme možnost "matching" spárovat složení, je povinné používat kódy Spartoo. Zobrazit seznam kódů pro složení
Výška podpatku	Volitelné	Pouze pro dámskou obuv (lodičky, kozačky, atd...) Výška podpatku v centimetrech. Je třeba uvést pouze číslo a oddělit jednotku od desetinného čísla tečkou (příklad: 1.7).
Země původu	Volitelné	Země původu Zobrazit možné hodnoty
Kod HS	Volitelné	Kod HS produktu pro celní orgány
Dodatečné informace	Volitelné	Seznam informačních kódů oddělených čárkou (např. '120,521') Zobrazit dostupné hodnoty
Sezóna	Povinné pro produkty s více obrázky	Sezóna výrobku, která se skládá z kódu "AH" (podzim-zima) nebo "PE" (jaro-léto), za kterým následuje rok. (ex: AH21, PE22)

Seznam informací pro zdroje XML

Značení	Popis	Povinné
reference_partenaire	Značení produktu prodejce Identifikant nesmí obsahovat alfanumerické znaky a také znaky - (pomlčku) _ (podtržítko) a . (tečku).	Ano
product_name	Název modelu Nesmí obsahovat kategorii, barvu nebo značku produktu Nesmí obsahovat alfanumerické znaky nebo html jazyk	Ne
manufacturers_name	Název značky produktu	Ano
code_idu	Kód produktu IDU (viz AGEC)	Ne
product_sex	Pro koho je produkt určen >Zobrazit možnosti	Ano
product_price	Cena produktu	Ano
Ano / Ne
color_id	Barva pro filtrovací menu Pokud není uvedeno, produkt nebude na stránce při použití filtrů nalezen > Zobrazit možnosti	Ne
product_style	Kategorie produktu > Zobrazit možnosti	Ano
product_description	Popis produktu, zobrazí se na stránce u produktu.	Ne
product_color	Volné pole pro barvu, zobrazí se na stránce u produktu.	Ne
size	Zobrazit velikosti a jejich skladové zásoby. Nepovinné pro produkty bez velikostí (Tašky / Módní doplňky), jinak povinné.	Ano / Ne
size_name	Název velikosti > Zobrazit možnosti	Ne / Ano
size_quantity	Skladové zásoby pro tuto velikost	Ano
size_reference	Reference produktu dle velikosti Toto pole slouží k exportu informací o objednávkách a o vrácení. Dobré je vytvořit spojení mezi poli reference_partenaire a size_name s pomocí podtržítka "_".	Ne
ean	EAN produktu ve velikosti Povinné pro logistickou službu	Ne
fotografie	Seznam fotografií a jejich url. Je požadována alespoň jedna fotografie. Doporučujeme mít alespoň 3 fotografie. Můžeme integrovat maximálně 8 fotografií. Fotografie bude nahrána pouze jednou a po změně velikosti na rozměry Spartoo bude uložena na našich serverech Fotografie musí mít formát jpg, čtverec a velikost nejméně 350 x 350 pixelů. Pokud jsou větší než nebo se rovnají 800 x 800 pixelů, bude na stránce možné zvětšení.	Ano
url1, url2 ... url8	Odkazy na fotografie Je nutné poskytnout odkaz na každou fotografii. Název souboru musí obsahovat pouze alfanumerické znaky a také znaky "-" (pomlčka), "_" (podtržítko) a"." (tečka). Mezery ani písmena s diakritikou (například é a ň) nejsou povolena.	Oui
heel_height	Výška podpatku v centimetrech (cm). Pouze pro dámskou obuv. Pro oddělení jednotky od desetinného čísla je třeba použít tečku (např. 1.5).	product_composition	Složení svršku produktu. Pouze pro obuv. > Zobrazit možnosti	Ne
voering_composition	Složení podšívky produktu. Pouze pro obuv. > Zobrazit možnosti	Non
first_composition	Složení vnitřní stélky produktu. Pouze pro obuv. > Zobrazit možnosti	Ne
zool_composition	Složení podrážky produktu. Pouze pro obuv. > Zobrazit možnosti	Ne
sleva	Slouží k aplikace slevy na produkt nebo na velikost produktu. Pole sazba k poli sleva zobrazí slevu v % vztahující se k ceně produktu. Pole sleva z ceny k poli sleva se týká zlevněné ceny výrobku. Procentuální sleva tak bude přepočítána. Pokud jsou přítomny dvě pole - sleva z ceny má přednost před polem sazba. Pokud je sleva okamžitá, není potřeba zadávat datum se začátkem slev. Pokud není pole stopdatezadáno, bude mít akce výchozí dobu trvání jeden měsíc. Pokud je označení jako sleva, akce bude pojmenována jako slevy. Pokud ne, bude to klasická akce. Díky této informaci budou produkty k zobrazení na stránce v období slev v kategorii výprodeje a slevy .	Ne
extra_infos	Obsahuje doplňující informace k produktu. Každá informace má svoje id ( > Zobrazit možnosti) a hodnotu v numerickém provedení.	Ne
selections	Obsahuje informace o používání produktu prostřednictvím seznamu ID. Kompletní informace najdete zde.	Ne

Formát parametru xml

Textová pole musí být chráněna značením CDATA pokud obsahuje text speciální charaktery a interpunkci, jinak bude XML neplatný.

Formát pro jednu zemi

<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>
				<!-- ... Možné zadání více "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>
				<!-- ... Možné zadání více "info"  ... -->
			</extra_infos>
			<selections>
				<selection>int</selection>
				<!-- ... Možné zadání více "selection"  ... -->
			</selections>
	   </product>
	   <!-- ... Možné zadání více "product"  ... -->
   </products>
</root>

Formát pro více zemí

<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>
				<!-- ... Možné zadání více "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>
						<!-- ... Možné zadání více "language"  ... -->
					</languages>
				</size>
				<!-- ... Možné zadání více "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>
				<!-- ... Možné zadání více "info"  ... -->
			</extra_infos>
			 <selections>
				<selection>int</selection>
				<!-- ... Možné zadání více "selection"  ... -->
			</selections>
	   </product>
	   <!-- ... Možné zadání více "product"  ... -->
   </products>
</root>

Příklady souborů

Seznam chybných kódů zboží

Kód	Level	Popis
1	Fatal	Odkaz partnera není dostatečně dlouhý
2	Fatal	Popis produktu nelze potvrdit, nepoužívejte alfanumerické znaky.
3	Warning	Název produktu není specifikován
4	Fatal	Značka není specifikována
5	Fatal	Není zvoleno pohlaví, je možno vybírat pouze z: H, F, K, G, B
6	Fatal	Cena musí být číselný údaj
7	Fatal	cena je záporná nebo není specifikována
8	Warning	Cena se zdá být velmi vysoká ( > 1000€ )
9	Fatal	Počet musí být celé číslo
10	Fatal	Počet musí být kladné číslo
11	Warning	Barva xxx neexistuje: produkt nebude k dispozici při použití barevných filtrů na webu
13	Fatal	Kategorie xxx neexistuje
14	Warning	Popis produktu je prázdný
15	Warning	Popis barvy je prázdný
16	Warning	Velikostní seznam nedostupný: vyberte univerzální velikost
17	Warning	Složení je specifikováno, ale není platné
18	Fatal	Fotografie 1 je povinná
19	Warning	Procento slevy musí být číslo mezi 0 až 100, sleva není brána v potaz
20	Warning	Velikost xxx neexistuje
200	Fatal	Velikost xxx pro značku xxx neexistuje.
201	Fatal	Kód EAN je povinný
202	Fatal	EAN kód xxx na odkazu xxx ve velikosti xxx je již použit xxx.
203	Warning	Kód EAN je příliš krátký nebo končí na "000".
204	Warning	Kód EAN xxx existuje v datovém toku v několika kopiích.
205	Fatal	Reference partnera je příliš dlouhá
23	Warning	Fotografie xxx je menší než 350x350: kvalita bude na webu špatná
24	Warning	Fotografie xxx je menší než 350x350: nebude zobrazena na webu
25	Fatal	Rozměr xxx: není možno regulovat skladové zásoby
26	Fatal	Není skladem: produkt nebude vytvořen
27	Fatal	Není možný přístup k fotografii 1 ( url xxx )
28	Warning	Není možný přístup k fotografii ( url xxx )
281	Fatal	Velikost fotografie je příliš velká (xxxo)
30	Fatal	Množství velikosti xxx je příliš vysoké (Maximální výše: xxx)
31	Warning	Váš účet není aktivován xxx
32	Fatal	pro tuto zemi nebyly nalezeny žádné informace o produktu
33	Fatal	Produkt určený pro kategorii xxx nelze přiřadit ke kategorii xxx
34	Fatal	Slovo xxx jsme dali na seznam nežádoucích slov a nemělo by se objevit v názvu nebo popisu produktu.
35	Fatal	Název produktu je příliš dlouhý, musí obsahovat pouze název modelu. Chyba(y) v zemích: xxx
341	Fatal	Slovo xxx jsme dali na seznam nežádoucích slov a nemělo by se objevit v popisu produktu.
36	Fatal	Nemožné odeslat: produkt má duplikát velikost / barva.
38	Fatal	Velikost xxx lze nastavit pouze jednou jako referenci xxx.
39	Warning	Reference partnera je ve zdroji přítomna několikrát, duplikáty byly ignorovány
42	Warning	Sezóna není platná.
43	Warning	Informace o produktu xxx odpovídá typu produktu = xxx a nikoli xxx.
44	Warning	Kategorie xxx neodpovídá typu produktu xxx, ale produktu xxx.
451	Fatal	Nejedná se o cenu velikosti xxx země xxx. (nécessaire pour un discount)
452	Warning	Bylo překročeno datum ukončení slevy pro velikost xxx země xxx.
453	Fatal	"sazba" (xxx) neplatná pro velikost xxx země xxx.
454	Fatal	"sazba" (xxx) > 85% pro velikost xxx země xxx.
455	Warning	Velikost xxx má cenu v zemi (xxx), která není pro produkt definována.
456	Warning	Velikost xxx má cenu xxx shodnou s globální cenou v této zemi.