Főoldal > Webszervíz > Termékek importja

Termékek frissítése

Webszervíz URL-je : https://sws.spartoo.hu/mp/xml_maj_stock_batch.php

E webservice arra szolgál, hogy a Spartoo oldalán elérhető termékeinek készletét frissítse.
Minden termék kapcsán, a webservice egy kódot küld vissza, miszerint minden rendben ment vagy sem.

E webservice arra szolgál, hogy a termékek készletét frissítse. A teljes katalógust frissítheti, vagy csak néhány terméket.

E webservice "Frissítés" módban működik és nem "Felülírás" módban. Ami azt jelenti, hogy azon termékek, melyek nem XML-ben kerülnek elküldésre nem kerülnek törlésre.
Amennyiben szeretne egy terméket levenni az oldalról, úgy állítsa a készletet 0-ra.

Paraméterek listája

E webservice paramétereit kötelezően POST-ban kell megadni

Paramèter Leírás
partner Tartalmaznia kell egyedi azonosítóját:
xml XML típusú lánc, mely tartalamzza a frissítendő elemeket


XML paraméter formátuma


A szöveg mezőknek védve kell lenniük a CDATA jelzés által, ha tartalmaznak speciális karaktereket, amik érvénytelené teszik az XML-t. 

<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>
						<!-- ... Több "language" jelzés lehetséges ... -->
					</languages>
					<!-- ... Több "languages" jelzés lehetséges ... -->
				</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>


Az XML mezők bemenetének leírása


Balise Description Obligatoire
partner_hivatkozás Kereskedői termékazonosító. A sku azonosítja be egy márka termékét egy bizonyos színben.
A termék azonosítója kizárólag alfanumerikus karaktereket tartalmazhat és a következő karaktereket - (kötőjelet) _ (alsó vonást) és . (pontot). 		Igen
termék_mennyiség Egy termék teljes készlete
Figyelmen kívül hagyja, ha egy vagy több size_quantity címke tartozik a termékhez.
Az egy méretes termékekek esetén kötelező a product_quantity címke, ha nincs size_quantity címke megadva. 		Nem
méret Méretek és készleteik listája.
Választható a méret nélküli termékek esetén (Táskák/Kiegészítők). Ellenkező esetben kötelező. 		Igen/Nem
méret_mennyiség Minden méret esetén meg kell adni készletet.
Egy termék deaktivilásához a készletet 0-ra kell állítani.
Amikor a készlet 0, a termék deaktiválásra kerül, és nem jelenik meg a Spartoo oldalán. 		Igen
méret_referencia Termékreferencia a méretre vonatkozóan. Igen
termék_ár Méret szerinti ár Nem
kedvezmény A termékre vonatkozó promóció alkalmazására szolgál.
A kedvezmény mezőben található árfolyam mező a termék_ár mezőhöz képest a százalékos árcsökkentésre utal.
Az ár_kedvezmény mező a kedvezmény mezőben a termék kedvezményes árára utal. A megjelenített kedvezmény százalékos értéke kiszámításra kerül.
Ha mindkét mező jelen van, az ár_kedvezmény mező elsőbbséget élvez az árfolyam mezővel szemben.
Ha az árengedmény azonnali, nem szükséges megadni a kezdési dátum mezőt. Ha a stopdátum mező nincs megadva, az akció alapértelmezett időtartama egy hónap. Ha az értékesítési címke meg van adva, az akció értékesítési akció lesz. Ellenkező esetben klasszikus promóció lesz. Ennek a paraméternek a megadása lehetővé teszi a termékek megjelenítését az értékesítési oldalon az értékesítési időszakok alatt. 		Non


Xml paraméter példája

<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>
						<!-- ... Több "language" jelzés lehetséges ... -->
					</languages>
					<!-- ... Több "languages" jelzés lehetséges ... -->
				</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>

Visszaküldött XML formátuma


<catalogue>
	<products>
		<product>
			<reference_partenaire>string</reference_partenaire>
			<size_list>
				<size>
					<size_reference>string</size_reference>
					<errors>int</errors>
				</size>
			</size_list>
		</product>
		<!-- ... Több "product" jelzés lehetséges ... -->
	</products>
</catalogue>


Webszervíz hibakódjainak listája


Kód Leírás
1 Nincs paraméter hiba
-1 A partenaire paraméter nem ment át a paramétereken vagy üres
-2 A partner paraméter nem létezik
-11 A xml paraméter nem ment át a paramétereken vagy üres
-13 A products_size_reference paraméter nem ment át a paramétereken vagy üres
-15 XML szintaxis hiba, ellenőrizze az Ön XML fájlját
-18 A készlet ugyanaz, mint, ami ebben a bázisban megtalálható, tehát nem lett frissítve
-20 Nem lehetséges a készlet frissítése. A méret már nem érvényes erre a termékre, a készlet ehhez a termékhez és ez a méret 0-n van.
-31 Ez a/az size_reference nem létezik
-428 Fiókja deaktiválásra került. A webservices már nem áll rendelkezésére.
-429 Túl sokszor lépett kapcsolatba a webservice-szel az elmúlt egy órában.



Visszaküldött XML példái


Mintaválasz egy webszolgáltatás hívásra KO :

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

Mintaválasz egy webszolgáltatás hívásra 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>