Uvítanie > Webové služby > Import tovaru

Import tovaru

URL webovej služby : https://sws.spartoo.sk/mp/xml_import_products.php

Táto webová služba slúži na aktualizáciu produktov na stránke Spartoo.
Pre každý odoslaný produkt zašle webová službachybový kód, ktorý bude indikovať, či všetko prebehlo v poriadku alebo nie. Niektoré chyby sú blokačné (fatálne), iné nie (slúžia iba na upozornenie).

Táto webová služba slúži na vytváranie produktov a aktualizáciu katalógu. Môže byť využitá na zaslanie celého katalógu alebo vybraných produktov.

Frekvencia požiadaviek:
- Ak službu používate na aktualizáciu celého katalógu, odporúčame použiť ju najviac 1x za 6 hodín.
- Ak službu používate len na čiastočnú aktualizáciu (len niekoľko produktov), maximálna odporúčaná frekvencia je 10 minút.

Táto webová služba funguje v mode "Aktualizácia" a nie v mode "Prepisovanie". To znamená, že produkty, ktoré nie sú zaslané v súbore XML, nebudú vymazané.
Pre odstránenie určitých produktu zo stránky treba nastaviť stav jeho skladových zásob na 0.

Zoznam parametrov

Parametre tejto webovej služby sa musia odovzdať vo forme POST

Parametre Popis
partnerský predajca Musí obsahovať Vaše unikátne identifikačné číslo:
xml Treba vytvoriť alebo aktualizovať reťaz znakov XML, ktorá obsahuje zoznam elementov


Nepovinné parametre, ktoré môžu prejsť do POST

Parametre Popis
popis sily Zadajte 1 pokiaľ si želáte vynútiť aktualizáciu popisov tovaru: zmazať existujúce popisy, upraviť popis jedného produktu s nulovými skladovými zásobami, atď.
sila overwrite Nastavte na 1, ak chcete z katalógu odstrániť chyby zásob. Dávajte pozor, aby ste bezprostredne potom odoslali zvyšok katalógu bez overwrite.


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


Popis vstupných políčok XML


> 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


Prí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[Chuck Taylor All Star od značky Converse sú nenahraditeľnými a skutočne mýtickými teniskami. 
Tu ich nájdete v členkovej verzii so zvrškom z textilu a s klasickou jednofarebnou potlačou, vďaka čomu sú nadčasové a nikdy nevyjdú z módy!]]></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>

Obrátený formát XML


<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>
				<!-- ... Viacero možných tagov "error" ... -->
			</errors>
		</product>
		<!-- ... Viacero možných tagov "product" ... -->
	</products>
	<errors>int</errors>
</root>


Zoznám chybových kódov webovej služby


Kód Popis
1 Bezchybné parametre
-1 Parameter partenaire nebol správne zaregistrovaný alebo je prázdny
-2 Parametre partnera neexistujú
-11 Parameter xml nebol správne zaregistrovaný alebo je prázdny
-15 Chyba syntaxu XML, overte súbor XML
-428 Váš účet bol deaktivovaný. Odteraz nemáte možnosť zadávať požiadavky webservices
-429 Za túto hodinu ste dosiahli príliš veľký počet požiadaviek webservice

Popis políčok odpovede XML


Balise Popis
reference_partenaire Identifikačné číslo produktu predajcu
status OK ak je produkt vložený do databázy
KO ak produkt nebol správne vložený
čo treba spraviť Zoznam možností:
  • created: produkt bol vytvorený.
  • not created: produkt nebol vytvorený. Poznámka: produkt môže byť označený ako "OK" ale nemusí byť vytvorený na základe určitých varovaní označených ako "Warning".
  • updated: produkt bol aktualizovaný.
  • not updated: produkt nebol aktualizovaný. Poznámka: produkt môže byť označený ako "OK" ale nemusí byť aktualizovaný na základe určitých varovaní označených ako "Warning".
chyby Zoznam možných chýb pri spracovaní:
  • id: kód chyby produktu
  • level: úroveň chyby
    • Warning: nebráni integrácii produktu
    • Fatal: blokuje integráciu produktu
  • popis: textový popis chyby


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)
81 Fatal Cena nemôže byť vyššia ako 180 €
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
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.
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 )
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.
37 Fatal Tento produkt neobsahuje žiadne jazykové informácie pre aktívnu stránku.
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é
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.


Príklady vrátenia XML


Príklad odpovede web servis KO :

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

Príklad odpovede web servis 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ázdny</description>
				<level>warning</level>
			</error>
			<error>
				<id>4</id>
				<description>Značka nebola uvedená</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>

Súbory XSD

Súbory XSD Multi krajiny