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

Aktualizácia produktov

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

Táto služba slúži na aktualizáciu skladových zásob na stránke Spartoo.
Za každý zaslaný produkt táto webová služba odošle kód s informáciou, či bol proces úspešný alebo nie.

Táto služba slúži na aktualizáciu skladových zásob. Môžete prostredníctvom nej zaslať obsah celého katalógu alebo len niektoré produkty.

Služba je založená na "Aktualizácii", nie "Zrušení". To znamená, že produkty, ktoré nie sú obsahom zaslaného XML, nebudú automaticky vamazané.
Pre odstránenie produktu zo stránky je potrebné nastaviť skladovú zásobu na 0.

Zoznam parametrov

Parametre tejto služby musia byť nastavené na POST

Parameter Popis
partner Musí obsahovať Vaše unikátne identifikačné číslo:
xml Súbor XML obsahujúci zoznam prvkov na aktualizáciu


Formát parametra xml


Textové polia musia byť chránené značkami CDATA , ak obsahujú špeciálne znaky, ktoré by spôsobili neplatnosť XML. 
<catalogue>
	<products>
		<product>
			<reference_partenaire>string</reference_partenaire>
			<size_list>
				<size>
					<size_reference>string</size_reference>
					<size_quantity>int</size_quantity>
					<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>
					<!-- ... Viacero možných tagov "languages" ... -->
				</size>
				<size>
					<size_reference>string</size_reference>
					<size_quantity>int</size_quantity>
				</size>
			</size_list>
		</product>
		<product>
			<reference_partenaire>string</reference_partenaire>
			<size_list>
				<size>
					<size_reference>string</size_reference>
					<size_quantity>int</size_quantity>
				</size>
				<size>
					<size_reference>string</size_reference>
					<size_quantity>int</size_quantity>
				</size>
			</size_list>
		</product>
	</products>
</catalogue>


Popis vstupných políčok XML


Tag Popis Povinné
reference_partenaire Identifikačné číslo obchodníka. Ide o hodnotu, ktorá identifikuje určitý produkt danej značky v presne stanovenej farbe
Identifikačné číslo produktu môže obsahovať iba alfanumerické znaky a tiež znaky ako - (pomlčka) _ (podtržník) a . (bodka). 		Áno
product_quantity Celkové zásoby produktu
Ignorujte, ak je pre daný produkt identifikovaný aspoň jeden alebo viacero tagov size_quantity.
Pre produkty s unikátnou veľkosťou je tag product_quantity povinný v prípade, že tag size_quantity nie je určený. 		Nie
size Zoznam veľkostí a ich zásob.
Dobrovoľné pre produkty bez veľkosti ( Tašky / Doplnky ). Pre zvyšné prípady povinné. 		Áno / Nie
size_quantity Skladové zásoby musia byť uvedené pre každú veľkosť.
Pre deaktiváciu produktu je potrebné uviesť skladovú zásobu 0.
Ak je pri skladovej zásobe uvedená 0, produkt je deaktivovaný a nezobrazuje sa na stránke Spartoo. 		Áno
size_reference Odkaz na produkt v danej veľkosti. Áno


Príklad parametru xml

<catalogue>
	<products>
		<product>
			<reference_partenaire>98</reference_partenaire>
			<size_list>
				<size>
					<size_reference>98_38</size_reference>
					<size_quantity>5</size_quantity>
					<languages>
						<language>
							<code>FR</code>
							<product_price>100.00</product_price>
							<discount>
								<startdate>1199170800</startdate>
								<stopdate>1204354800</stopdate>
								<price_discount>90.00</price_discount>
								<rate>10</rate>
								<sales/>
							</discount>
						</language>
						<!-- ... Viacero možných tagov "language" ... -->
					</languages>
					<!-- ... Viacero možných tagov "languages" ... -->
				</size>
				<size>
					<size_reference>98_39</size_reference>
					<size_quantity>7</size_quantity>
				</size>
			</size_list>
		</product>
		<product>
			<reference_partenaire>158_tailor</reference_partenaire>
			<size_list>
				<size>
					<size_reference>158_37</size_reference>
					<size_quantity>2</size_quantity>
				</size>
				<size>
					<size_reference>158_36</size_reference>
					<size_quantity>0</size_quantity>
				</size>
			</size_list>
		</product>
	</products>
</catalogue>

Obrátený formát XML


<catalogue>
	<products>
		<product>
			<reference_partenaire>string</reference_partenaire>
			<size_list>
				<size>
					<size_reference>string</size_reference>
					<errors>int</errors>
				</size>
			</size_list>
		</product>
		<!-- ... Viacero možných tagov "product" ... -->
	</products>
</catalogue>


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
-13 Parameter products_size_reference nebol správne zaregistrovaný alebo je prázdny
-15 Chyba syntaxu XML, overte súbor XML
-18 Skladové zásoby sú rovnaké ako pôvodné a tým pádom neboli aktualizované
-20 Nie je možné aktualizovať skladové zásoby. Veľkosť nie je platná pre tento produkt, skladové zásoby pre tento produkt a túto veľkosť sú nulové.
-31 Táto referencia na veľkosť neexistuje
-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



Príklady vrátenia XML


Príklad odpovede web servis KO :

<catalogue>
	<products></products>
	<errors>-1</errors>
</catalogue>

Príklad odpovede web servis OK :

<catalogue>
	<products>
		<product>
			<reference_partenaire>EEAJBCC</reference_partenaire>
			<size_list>
				<size>
					<size_reference>EEAJBCC_38</size_reference>
					<errors>1</errors>
				</size>
			</size_list>
		</product>
		<product>
			<reference_partenaire>KJHGFDS</reference_partenaire>
			<size_list>
				<size>
					<size_reference></size_reference>
					<errors>-13</errors>
				</size>
			</size_list>
		</product>
	</products>
</catalogue>