Úvod > Webservis > Přidat produkt

Import produktů

URL Webservisu : https://sws.spartoo.cz/mp/xml_import_products.php

Webservis slouží k tvorbě a aktualizaci produktů na Spartoo.
Pro každý odeslaný produkt odešle webservis kód, který vám označí, zda vše proběhlo v pořádku či ne. Některé chyby jsou závažné, blokují systém (fatal erreur), jiné ne (warning).

Webservise pracuje na základě aktualizace "up date" a ne "nahrazení". To znamená, že produkty, které nejsou odeslány v XML, nebudou smazány.
Abyste odstranili produkt z webu, stačí skladovou zásobu označit jako "0".

Seznam parametrů

Parametry webservisu musí být předány přes POST

Parametr	Popis
partenaire	Musí obsahovat váš unikátní identifikátor:
xml	Řetězec XML obsahuje seznam elementů, které si přejete vytvořit nebo aktualizovat

Volitelné parametry mohou být předány přes POST

Parametr	Popis
force_description	Vložte 1, pokud chcete aktualizovat popisy produktů: smazat popisy stávající, opravit popisy produktů, které již nejsou skladem, atd.
force_overwrite	Vložte 1, pokud chcete z katalogu odstranit chyby zásob. Dejte pozor, abyste ihned poté odeslali zbytek katalogu bez přepisu.
async	Nastavit na 1, pokud chcete použít asynchrone

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>
			<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>
					<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>

Popis polí XML při zadání

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

Příklad parametru xml

<root>
	<products>
		<product>
			<reference_partenaire>98</reference_partenaire>
			<product_name><![CDATA[ALL STAR HI]]></product_name>
			<manufacturers_name><![CDATA[Converse]]></manufacturers_name>
			<product_sex>M</product_sex>
			<product_price>64.99</product_price>
			<product_quantity>5</product_quantity>
			<color_id>8</color_id>
			<product_style>10010</product_style>
			<product_description><![CDATA[Nepřekonatelné, to jsou tenisky Chuck Taylor All Star od Converse. Zde v kotníkovém provedení, svršek je z plátna, potisk klasický, je to móda nestárnoucí a nadčasová!
]]></product_description>
			<product_color><![CDATA[Červená]]></product_color>
			<country_origin>73</country_origin>
			<code_hs>64059090</code_hs>
			<size_list>
			 <size>
				<size_name>38</size_name>
				<size_quantity>4</size_quantity>
				<size_reference>98_38</size_reference>
				<ean>123456789011></ean>
			 </size>
			 <size>
				<size_name>39</size_name>
				<size_quantity>1</size_quantity>
				<size_reference>98_39</size_reference>
				<ean>123456789012></ean>
			 </size>
			</size_list>
			<product_composition>4</product_composition>
			<photos>
				<url1>https://imgext.spartoo.com/photos/98/98/98_350_A.jpg</url1>
				<url2>https://imgext.spartoo.com/photos/98/98/98_350_B.jpg</url2>
				<url3>https://imgext.spartoo.com/photos/98/98/98_350_C.jpg</url3>
				<url4>https://imgext.spartoo.com/photos/98/98/98_350_D.jpg</url4>
				<url5>https://imgext.spartoo.com/photos/98/98/98_350_E.jpg</url5>
				<url6>https://imgext.spartoo.com/photos/98/98/98_350_F.jpg</url6>
				<url7>https://imgext.spartoo.com/photos/98/98/98_350_G.jpg</url7>
				<url8>https://imgext.spartoo.com/photos/98/98/98_350_H.jpg</url8>
			</photos>
			<discount>
				<startdate>1199170800</startdate>
				<stopdate>1204354800</stopdate>
				<rate>20</rate>
			</discount>
		</product>
	</products>
</root>

Formát XML zapsán obráceně

<root>
	<products>
		<product>
			<reference_partenaire>string</reference_partenaire>
			<status>string</status>
			<action>string</action>
			<errors>
				<error>
					<id>int</id>
					<description>string</description>
					<level>string</level>
				</error>
				<!-- ... Možné zadání více "error"  ... -->
			</errors>
		</product>
		<!-- ... Možné zadání více "product"  ... -->
	</products>
	<errors>int</errors>
</root>

Seznam kódů chyb webservice

Kód	Popis
1	Žádná chyba v parametrech nenalezena
-1	Parametr partenaire není správný parametr nebo je prázdný
-2	Partnerský parametr neexistuje
-11	Parametr xml není správný parametr nebo je prázdný
-15	Chyba v syntaxu (ve skladbě zápisu) XML, zkontrolujte váš XML soubor
-428	Váš účet byl deaktivován. Nemůžete již volat.
-429	Na tuto webovou službu jste volali příliš mnoho, limit je vyčerpán.

Popis pole odpovídající XML

Značka upozornění	Popis
reference_partenaire	Identifikace produktu partnera
status	OK, jestliže je zboží vloženo do databáze KO, jestliže zboží nemohlo být přidáno do databáze
akce	Seznam možných operací: created: produkt byl přidán. not created: produkt nebyl přidán. Poznámka: produkt může mít status 'OK', ale nebýt následně přidán, může být označek symbolem 'Warning'. updated: produkt byl aktualizován. not updated: produkt nebyl aktualizován. Poznámka: produkt může mít status 'OK', ale nebýt následně přidán, může být označek symbolem 'Warning'.
chyby	Seznam chyb procesu: id: kód chyby stupeň: míra chyby Warning: nebrází začlenění produktu Fatal: blokuje začlenění produktu popis: vysvětlení chyby

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€ )
195	Fatal	Nová cena nemůže zobrazovat více než xxx číslice
81	Fatal	Cena nemůže být vyšší než 4500,- Kč.
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	Warning	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.
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 )
30	Fatal	Množství velikosti xxx je příliš vysoké (Maximální výše: xxx)
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.
37	Fatal	Pro tento produkt nemáme platné jazykové informace pro aktivní web.
32	Fatal	pro tuto zemi nebyly nalezeny žádné informace o produktu
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
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.
194	Fatal	Změna ceny nesmí nesmí přesáhnout xxx%

Příklad vrácení XML

Příklad odpovědi web servisu KO :

<root>
	<products></products>
	<errors>-1</errors>
</root>

Příklad odpovědi web servisu OK :

<root>
	<products>
		<product>
		<reference_partenaire>EEAJBCC</reference_partenaire>
		<status>KO</status>
		<action>not created</action>
		<errors>
			<error>
				<id>14</id>
				<description>Popis produktu je prázdný</description>
				<level>warning</level>
			</error>
			<error>
				<id>4</id>
				<description>Značka není specifikována</description>
				<level>fatal</level>
			</error>
		</errors>
		</product>
		<product>
			<reference_partenaire>KJHGFDS</reference_partenaire>
			<status>OK</status>
			<action>created</action>
		</product>
	</products>
	<errors>1</errors>
</root>

Soubory XSD

Soubor XSD Multi země