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 )
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
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.
38	Fatal	A(z) xxx méret csak egyszer állítható be a(z) xxx referenciához
39	Warning	A partnerhivatkozás többször szerepel, az ismétlődések figyelmen kívül lettek hagyva
451	Fatal	Nincs ár az ország xxx méretéhez xxx. (kedvezményhez szükséges)
452	Warning	A kedvezmény befejezési dátuma túllépte az ország xxx méretét xxx.
453	Fatal	"ráta" (xxx) érvénytelen az ország xxx méretéhez xxx.
454	Fatal	"ráta" (xxx) > 85% az ország xxx méreténél xxx.
455	Warning	A méretnek xxx ára van egy olyan országban (xxx), amely nincs meghatározva a termékhez.
456	Warning	A méret xxx ára a xxx-on megegyezik az ország globális árával.

Visszaküldött XML példái

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

<root>
	<products></products>
	<errors>-1</errors>
</root>

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

<root>
	<products>
		<product>
		<reference_partenaire>EEAJBCC</reference_partenaire>
		<status>KO</status>
		<action>not created</action>
		<errors>
			<error>
				<id>14</id>
				<description>A termék leírása üres</description>
				<level>warning</level>
			</error>
			<error>
				<id>4</id>
				<description>Nem adta meg a márkát</description>
				<level>fatal</level>
			</error>
		</errors>
		</product>
		<product>
			<reference_partenaire>KJHGFDS</reference_partenaire>
			<status>OK</status>
			<action>created</action>
		</product>
	</products>
	<errors>1</errors>
</root>

XSD Fájlok

XSD Fájl Több ország