Úvod > Webservis > Přidat produkt

Aktualizace produktů

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

Tento webservice slouží k aktualizaci zásob produktů na webu Spartoo.
U každého odeslaného produktu vrátí webservice kód označující, zda všechno proběhlo v pořádku.

Tento webservice slouží k aktualizaci zásob produktů. Může být použit k odeslání celého katalogu nebo jen několika produktů.

Tento webservice funguje v režimu "Aktualizace" a nikoliv v režimu "Přepisování". To znamená, že produkty, které nejsou zaslány v XML, nebudou smazány
Chcete-li produkt z webu odebrat, musíte jeho zásoby nastavit na 0.

Seznam parametrů

Parametry tohoto webservisu musí být povinně v POST

Parametr Popis
partner Musí obsahovat váš jedinečný identifikátor:
xml Řetězec znaků XML obsahující seznam prvků, které se mají aktualizovat.


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


<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>
						<!-- ... Možné zadání více "language"  ... -->
					</languages>
					<!-- ... Možné zadání více "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 polí XML při zadání


Značka Popis Povinné
reference_partnera ID partnerského výrobku. Je to skladová jednotka, která identifikuje produkt značky v určité barvě.
Identifikátor produktu může obsahovat pouze alfanumerické znaky a také znaky – (pomlčka) _ (podrtžítko) a . (tečku). 		Ano
product_quantity Celková zásoba produktů
Ignorováno, pokud je pro produkt detekována jedna nebo více značek size_quantity.
U produktů s jednou velikostí je nutné mít značku product_quantity, pokud značka size_quantity není zaznačena. 		Ne
velikost Seznam velikostí a jejich zásob.
Volitelné pro produkty bez rozměrů (Tašky / Doplňky). Pokud ne, povinné. 		Ano / Ne
size_product Pro každou velikost mutí být zásoba specifikována.
Pokud chcete produkt deaktivovat, je nutné nastavit zásoby na 0.
Jestliže je sklad na 0, produkt je deaktivován a na Spartoo se již neobjevuje. 		Oui
size_reference Reference na velikost produktu. Ano
product_price Cena pro velikost Non
discount Umožňuje na produkt použít slevu.
Pole rate pole discount se týká snížení ceny v procentech ve srovnání s polem product_price Pole price_discount pole discount se týká zlevněné ceny produktu. Vypočte se zobrazené procento slevy.
Pokud jsou k dispozici obě pole, pole price_discount má přednost před polem rate.
Pokud je sleva okamžitá, není nutné zadávat pole startdate. Není-li polestopdate zadáno, bude mít akce výchozí dobu trvání jeden měsíc. Pokud je zadán tag sales , sleva se bude týkat výprodejů. Jinak půjde o klasickou slevu. Zadání tohoto parametru umožňuje, aby byly produkty přítomny na prodejní stránce během období výprodejů. 		Ne


Pří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>
						<!-- ... Možné zadání více "language"  ... -->
					</languages>
					<!-- ... Možné zadání více "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>

Formát XML zapsán obráceně


<catalogue>
	<products>
		<product>
			<reference_partenaire>string</reference_partenaire>
			<size_list>
				<size>
					<size_reference>string</size_reference>
					<errors>int</errors>
				</size>
			</size_list>
		</product>
		<!-- ... Možné zadání více "product"  ... -->
	</products>
</catalogue>


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ý
-13 Parametr products_size_reference není správný parametr nebo je prázdný
-15 Chyba v syntaxu (ve skladbě zápisu) XML, zkontrolujte váš XML soubor
-18 Skladová zásoba je totožná s původní, a proto nebyla aktualizována
-20 Není možné aktualizovat skladové zásoby. Velikost není pro tento produkt platná. Skladové zásoby pro tento produkt a velikost je 0.
-31 Tento size_reference neexistuje
-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.



Příklad vrácení XML


Příklad odpovědi web servisu KO :

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

Příklad odpovědi web servisu 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>