Home > Webservices > Import produktów

Aktualizacja produktów

URL Webservice : https://sws.spartoo.pl/mp/xml_maj_stock_batch.php

Ten webservice służy do aktualizowania zapasów magazynowych produktów na stronie Spartoo.
Dla każdego wysłanego produktu, webservice wyśle kod wskazujący czy wszystko przebiegło pomyślnie czy nie.

Ten webservice służy do aktualizowania zapasów magazynowych produktów. Może być użyty do wysłania całego katalogu, lub jedynie kilku produktów.

Ten webservice działa w trybie "Aktualizacja", a nie "Zniszczenie". Oznacza to, że produkty które nie są wysłane w XML nie będą usunięte.
Aby usunąć produkt ze strony, należy zmienić jego zapas magazynowy na 0.

Lista parametrów

Parametry tego webservice muszą być obowiązkowo oznaczone jako POST

Parametry Opis
partner Musi zawierać Twój unikalny identyfikator:
xml Łańcuch znaków XML zawierających listę elementów do aktualizacji


Format parametru xml


Rubryki tekstowe muszą być chronione przez tagi CDATA, jeżeli zawierają znaki specjalne, które mogłyby spowodować nieprawidłowość 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>
						<!-- ... Różne tagi "language" możliwe ... -->
					</languages>
					<!-- ... Różne tagi "languages" możliwe ... -->
				</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>


Opis rubryk XML wprowadzenia


Tag Opis Obowiązkowy
reference_partenaire Numer identyfikacyjny produktu partnera. Jest to sku, który identyfikuje produkt danej marki w danym kolorze
Numer identyfikacyjny nie może zawierać znaków alfanumerycznych oraz znaków - (myślnik), _ (podkreślnik) i . (kropka). 		Oui
product_quantity Całkowity zapas magazynowy
Zignorowany jeśli jeden, lub kilka tagów size_quantity są wykryte dla produktu.
Dla produktów w uniwersalnym rozmiarze jest konieczny tag product_quantity jeśli tag size_quantity nie jest oznaczony. 		Nie
rozmiar Lista rozmiarów i ich zapas magazynowy.
Fakultatywny dla produktów bez rozmiau ( Torebki / Akcesoria). W innym przypadku obowiązkowy. 		Tak / Nie
size_quantity Dla każdego rozmiaru zapas magazynowy musi być sprecyzowany
Aby dezaktywować produkt należy ustawić jego zapas magazynowy na 0.
Jeśli zapas magazynowy wynosi 0 to produkt jest dezaktywowany i nie wyświetla się już w Spartoo. 		Tak
size_reference Odniesienie produktu do rozmiaru. Tak
product_price Cena za rozmiar Nie
zniżka Umożliwia zastosowanie promocji na produkt.
Pole rate z pola discount dotyczy procentowego obniżenia ceny w stosunku do pola product_price.
Pole price_discount z pola discount dotyczy obniżonej ceny produktu.Wyświetlony procent zniżki zostanie obliczony.
Jeśli oba pola są obecne, pole price_discount jest priorytetowe w stosunku do pola rate.
Jeśli rabat jest natychmiastowy, nie ma konieczności określania pola startdate. Jeśli pole stopdate nie zostanie określony, promocja będzie trwać domyślnie jeden miesiąc. Jeśli tag sales zostanie określony, zniżka będzie promocją wyprzedaży W przeciwnym razie będzie to klasyczna promocja. Określenie tego parametru pozwala na obecność produktów na stronie wyprzedaży w okresach wyprzedaży. 		Nie


Przykład 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>
						<!-- ... Różne tagi "language" możliwe ... -->
					</languages>
					<!-- ... Różne tagi "languages" możliwe ... -->
				</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>

Format XML zwrócony


<catalogue>
	<products>
		<product>
			<reference_partenaire>string</reference_partenaire>
			<size_list>
				<size>
					<size_reference>string</size_reference>
					<errors>int</errors>
				</size>
			</size_list>
		</product>
		<!-- ... Różne tagi "product" możliwe ... -->
	</products>
</catalogue>


Lista kodów błędów webservice


Kod Opis
1 Nie ma błędu parametrów
-1 Parametr partenaire nie uzyskał statusu parametru lub jest pusty
-2 Parametr firmy partnerskiej nie istnieje
-11 Parametr xml nie uzyskał statusu parametru lub jest pusty
-13 Parametr products_size_reference nie uzyskał statusu parametru lub jest pusty
-15 Błąd składniowy XML, należy sprawdzić plik XML
-18 Stan magazynu jest taki sam jak dotychczasowy, nie został on zatem zaktualizowany
-20 Nie można zaktualizować stanu magazynowego. Rozmiar nie jest już właściwy dla tego produktu, ilość produktu i tego rozmiaru wynosi 0.
-31 Ten rozmiar_referencyjny nie istnieje
-428 Twoje konto zostało dezaktywowane. Nie będziesz już mógł/mogła się do niego zalogować
-429 W ciągu ostatniej godziny wykonałeś/aś zbyt wiele połączeń z tym serwisem internetowym



Przykłady komunikatów XML


Przykład odpowiedzi na nieudane połączenie web service :

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

Przykład odpowiedzi na udane połączenie web service :

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