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

Termékek importálása

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

Ez a webszervíz a termékek létrehozásához és frissítéséhez a Spartoo honlapján.
Minden elküldött termékhez, a webszervíz el fog küldeni egy hiba kódot, ami jelzi, hogy minden rendben van, avagy sem. Néhány hiba blokkoló (fatal - végzetes), mások nem (warning - figyelmeztető).

Ez a webszervíz arra szolgál, hogy terméket hozzon létre, valamint, hogy frissítse katalógusát. Elküldhető a teljes katalógus, vagy csak néhány termék.

Hívások sűrűsége:
- Ha ezt a webszervízt a teljes katalógus frissítésére használják, úgy javasoljuk, hogy ezt 6 óránként csak egyszer tegyék meg.
- Ha ezt a webszervízt részleges katalógus frissítésére használják (csak néhány termék vonatkozásában), úgy 10 percenként legfeljebb hívás engedélyezett.

Ez a webszervíz "Frissítés" módban működik, és nem működik "Felülírás" módban. Ez azt jelenti, hogy azon termékek, melyek nincsenek elküldve XML-ben, nem lesznek törölve.
Egy termék levételéhez az oldalról, a készletet 0-ra kell állítani.

Paraméterek listája

E webszervíz paramétereinek kötelezően a POST-on keresztül kell menniük

Paraméter	Leírás
partner	Tartalmaznia kell az Ön egyedi azonosítóját:
xml	XML karakterlánc, ami tartalmazza a létre hozandó, vagy a frissítendő elemek listáját

Opcionális paraméterek, amik a POST-on keresztül mehetnek

Paraméter	Leírás
force_description	Állítsa 1-esre, ha szeretné frissíteni a termékek leírásait: meglévő leírások törlése, készleten nem lévő termék leírásának szerkesztése, stb.
force_overwrite	Állítsa 1-esre, ha egy árzuhanásnak köszönhető integrációs hibákat szeretne javítani

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.

Egy országos formátum

<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>
				<!-- ... Több "size" jelzés lehetséges ... -->
			</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>
				<!-- ... Több "info" jelzés lehetséges ... -->
			</extra_infos>
			<selections>
				<selection>int</selection>
				<!-- ... Több "selection" jelzés lehetséges ... -->
			</selections>
		</product>
		<!-- ... Több "product" jelzés lehetséges ... -->
	</products>
</root>

Több országos formátum

<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>
				<!-- ... Több "language" jelzés lehetséges ... -->
			</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>
						<!-- ... Több "language" jelzés lehetséges ... -->
					</languages>
				</size>
				<!-- ... Több "size" jelzés lehetséges ... -->
			</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>
				<!-- ... Több "info" jelzés lehetséges ... -->
			</extra_infos>
			 <selections>
				<selection>int</selection>
				<!-- ... Több "selection" jelzés lehetséges ... -->
			</selections>
		</product>
		<!-- ... Több "product" jelzés lehetséges ... -->
	</products>
</root>

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

Jelzés	Leírás	Kötelező
reference_partenaire	Partner termék azonosítója. A sku azonosító által azaonosítható be a márka terméke egy bizonyos színben A termékazonosító csak alfanumerikus karaktereket tartalmazhat, valamint a következőket: – (kötőjel), _ (alsó kötőjel) és . (pont).	Igen
product_name	Modell neve Nem kell tartalmaznia a termék kategóriáját, színét vagy a márkáját. Nem kell tartalmaznia további karaktereket és html jelzéseket sem.	Nem
manufacturers_name	Termék márkájának neve	Igen
product_sex	Termék neme > Lehetséges értékek megtekintése	Igen
product_price	Termék ára forintban (méretárak esetén nem kötelező)	Igen / Nem
color_id	Szín a menü szűrőinek számára Ha a szín nincs megadva, akkor a termék nem fog megjelenni, ha az ügyfél szín szűrőt használ > Lehetséges értékek megtekintése	Nem
product_style	Termék kategória > Lehetséges értékek megtekintése	Igen
product_description	A termék leírása. Megjelenik a termék oldalán.	Nem
product_color	Szabad szöveges mező a szín számára. Megjelenik a termék oldalán.	Nem
product_quantity	Egy termék teljes készlete Figyelmen kívül kell hagyni, ha a termék kapcsán egy vagy több size_quantity jelzés van. Az egyméretes termékek kapcsán kötelező egy product_quantity jelzés ha a size_quantity jelzés nincs kitöltve.	Nem
size	A méretek és készletük listája. Fakultatív a mérete nélküli termékeknél ( Táskák / Kiegészítők ). Ellenkező esetben kötelező.	Igen / Nem
size_name	Méret > Lehetséges értékek megtekintése	Igen
size_name lang="en"	Angol méret Kizárólag a spartoo.co.uk angol oldalon megjelenőknek kötelező > Lehetséges értékek megtekintése	Nem / Igen
size_quantity	A termék készlete e méretben	Igen
size_reference	A méret termék referenciája. Ez a mező kizárólag a rendelések és visszaküldések exportjaiba történő visszalépésre szolgál. A helyes művelet, generálni ezt a referenciát, összekötve a mezőket reference_partenaire és size_name egy alsókötőjel "_" segítségével.	Nem
ean	Termék EAN méretre	Nem
url1, url2 ... url8	Legalább egy fotó kötelező. Legalább 3 fotót javasolunk. Maximum 8 fotót tudunk megjeleníteni. Szükséges a fotó linkjének megadása. A fájl neve csak alfanumerikus karaktereket tartalmazhat, így a "-" (kötőjel), "_" (alsó kötőjel) és "." pont, szünet, illetve a különleges betűk (pl.: é, à et ñ ) nem használhatóak. A fotó egyszer kerül letöltésre, majd a szerverünkön kerül tárolásra, miután a spartoo dimenzióira formáltuk. A fotóknak jpg. formátumban kell lenniük, négyzetesek és legalább 350x350 pixel. Ha nagyobbak, mint 800x800 pixel akkor lehetséges a zoomolás.	Igen
heel_height	Sarokmagassság centiméterbene (cm). Kizárólag a női cipőknél. 0,5 többszöröse kell, hogy legyen.	Nem
product_composition	Termék szárának összetétele. Kizárólag cipőknél. > Lehetséges értékek megtekintése	Nem
voering_composition	Termék bélésének összetétele. Kizárólag cipőknél. > Lehetséges értékek megtekintése	Nem
first_composition	A termék belső talpának összetétele. Kizárólag cipőknél. > Lehetséges értékek megtekintése	Nem
zool_composition	A termék külső talpának összetétele. Kizárólag cipőknél. > Lehetséges értékek megtekintése	Nem
discount	Termékre vagy méretre alkalmazható promóciók. A discount mező rate mezője érinti az árkedvezményt százalékban a product_price mezőhöz viszonyítva. A discount mező price_discount mezője érinti a fix áras kedvezményt. A kedvezmény százaléka számítva jelenik meg. Ha mindkét mező megjelenik, a price_discount mező élvez elsőbbséget a rate mezővel szemben. Ha a kedvezmény azonnali, nem szükséges pontosítani a startdate mezőt. Ha a sales jelzés pontosítva van, a promóció egy leárazás promóciója lesz. Ha nem, akkor egy klasszikus promóció lesz. Jelezze ezt a paramétert, ami lehetővé teszi a termékek megjelenését a leárazások oldalán a leárazások ideje alatt.	Nem
extra_infos	További információk megadásának lehetősége a termék típusától függően. Minden információ egy azonosítót ( > Értékek megtekintése ) és egy értéket képez numerikus formában.	Nem
selections	A termékhasználat kontextusának megállapítására való lehetőség egy azonosító lista által. Minden rendelkezésre álló kontextus elérhető itt.	Nem

Xml paraméter példája

<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[Mítoszi a mítoszok körében, a Converse Chuck Taylor All Star modellje kihagyhatatlan. 
Itt egy magasszárú verzió egy vászon szárral, ami klasszikus, egyszínű és nyomtatott, a kortalansággal és az örök divatossággal játszva ! ]]></product_description>
			<product_color><![CDATA[Piros]]></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>

Visszaküldött XML formátuma

<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>
				<!-- ... Több "error" jelzés lehetséges ... -->
			</errors>
		</product>
		<!-- ... Több "product" jelzés lehetséges ... -->
	</products>
	<errors>int</errors>
</root>

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
-15	XML szintaxis hiba, ellenőrizze az Ön XML fájlját
-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.

XML válasz mezőinek leírása

Jelzés	Leírás
reference_partenaire	Kereskedő termékazonosítója
status	OK, ha a termék be lett illesztve a megadott bázisba KO, ha a terméket nem lehetett beilleszteni
action	Lehetséges eljárások listája : létrehozva (created) : a termék létre lett hozva. nincs létrehozva (not created) : a termék nem lett létrehozva. Megjegyzés : egy terméknek lehet 'OK' státusza, de ettől még nem lett létrehozva néhány 'Warning' hibát követően. frissítve (updated) : a termék frissítve lett. nincs frissítve (not updated) : a termék nem lett frissítve. Megjegyzés : egy terméknek lehet 'OK' státusza, de ettől még nem frissült néhány 'Warning' hibát követően.
errors	Feldolgozási hibák listája : azonosító (id) : termék hibakód szint (level) : hiba szintje Figyelmeztetés (Warning) : n'empêche pas l'intégration du produit Végzetes (Fatal) : blokkolja a termék integrációját leírás (description) : hiba szöveges leírása

Termék hibakódok listája

Kód	Szint	Leírás
1	Fatal	A partner referencia nem megfelelő hosszúságú
2	Fatal	A partnerreferencia érvénytelen, ügyeljen arra, hogy csak betűket és számokat adjon meg
3	Warning	A termék neve nem pontosan van megadva
4	Fatal	Nem adta meg a márkát
5	Fatal	A nem nem érvényes, az egyedüli érvényes értékek a következők: H, F, M, K, G, B
6	Fatal	Az árat számban kell megadni
7	Fatal	Az árnak pozitív számnak kell lennie
8	Warning	Az ár túl magas ( > 320 000Ft )
195	Fatal	Az új ár nem tartalmazhat xxx-nél/-nál több számot
81	Fatal	Az ár nem lehet magasabb, mint 65000Ft
9	Fatal	A mennyiségnek egész számnak kell lennie
10	Fatal	Az összegnek pozitívnak kell lennie
11	Warning	A(z) xxx szín nem létezik: a terméket a színszűrőn keresztül nem tudja elérni
13	Fatal	A(z) xxx kategória nem létezik
14	Warning	A termék leírása üres
15	Warning	A kijelzőszín üres
16	Warning	Nincs méretlista: egyetlen méret használata
17	Warning	Az összetevő megadva, de érvénytelen
18	Fatal	Az 1. fénykép kötelező
19	Warning	A kedvezmény mértékének 0 és 100 között kell lennie, az akció nem lesz figyelembe véve
20	Warning	A következő méret nem létezik: xxx
200	Warning	A(z) xxx méret nem létezik a(z) xxx márkánál.
201	Fatal	Az EAN kód kötelező
202	Fatal	A(z) xxx EAN kód a(z) xxx referencia kapcsán, xxx méretben már felhasználásra került.
205	Fatal	Túl hosszú partner referencia
23	Warning	A xxx fotó kisebb mint 350x350: az oldalon rossz minőségben fog megjelenni
24	Warning	A xxx fotó kisebb mint 350x350: az oldalon nem lesz megjelenítve
25	Fatal	Méret: xxx - A készlet szabályozása nem lehetséges
26	Fatal	Nincs készleten: a termék nem lesz létrehozva
27	Fatal	Nem lehet elérni az 1. fotót ( url xxx )
28	Warning	Nem lehet elérni a(z) xxx fotót ( url xxx )
30	Fatal	A xxx méret mennyisége túl nagy (Maximális mennyiség: xxx)
33	Fatal	Egy xxx típusú termék nem tartozhat a következő kategóriába: xxx.
34	Fatal	A/Az xxx szó feketelistán szerepel és nem jelenhet meg a termék nevében.
35	Fatal	A termék neve túl hosszú, kizárólag a modell nevét kérjük megadni. Hiba ország(ok)nál: xxx
341	Fatal	A következő szó feketelistán van: xxx, ezért nem szerepelhet a termék leírásában.
36	Fatal	Nem lehetséges a terméket importálni: a terméknek méret / szín ismétlődése van.
37	Fatal	Ez a termék nem tartalmaz nyelvi információt egy aktív webhelyhez.