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 azonosí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
code_idu A termék IDU-kódja (lásd az AGEC-törvényt) Nem
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ékleírás lehetővé teszi, hogy a termékekről minél több információt adjunk meg, amelyek segíthetnek a vásárlónak a vásárlási döntés meghozatalában.
A jó termékleírás részletes és minden egyes termékre vonatkozik. Ennek érdekében tartalmazhatja a modell nevét, a márkát, a színt, a termék stílusát, az anyagot stb.
HTML-kódot nem lehet beilleszteni, kivéve a sorváltást: <br>, valamint <b>, <i> és <u>. A JavaScript nem engedélyezett.
Ez kizárólag a termékleírásban lesz látható.
A megengedett karakterek száma 65 000. 		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éret nélküli termékeknél ( Táskák / Kiegészítők ). Ellenkező esetben kötelező. 		Igen / Nem
size_name Méret neve
> Lehetséges értékek megtekintése 		Igen
size_quantity Minden méret esetében meg kell adni a raktárkészletet.
Egy termék deaktiválásához a készletet 0-ra kell állítani.
Ha a készlet állása 0, a termék deaktiválásra került, és többé nem jelenik meg a Spartoo oldalon. 		Igen
size_reference A méret termék referenciája.
Ez a mező kizárólag a megrendelések vagy visszaküldések exportálásakor kerül visszaadásra. Bevált gyakorlat, hogy ezt a hivatkozást a reference_partenaire és a size_name mezők aláhúzásjel „_” segítségével történő összekapcsolásával hozzuk létre. 		Nem
ean Termék EAN méretre
A logisztikai szolgáltatáshoz elengedhetetlen		 Nem / Igen
fotók A fotók listája és azok URL-címei.
Legalább egy fotó feltöltése kötelező.
Javasoljuk, hogy legalább 3 fotót töltsön fel. Legfeljebb 8 fotót tudunk beilleszteni.
A fotó csak egyszer kerül feltöltésre, majd a Spartoo méretre átméretezés után a szerverünkön kerül tárolásra.
A fotóknak jpg formátumúaknak, négyzet alakúaknak és legalább 350x350 képpontosnak kell lenniük. Ha a képek mérete legalább 800x800 képpont, akkor a weboldalon nagyításra lesz lehetőség. 		Igen
url1, url2 ... url8 Linkek a fotókhoz
Minden fotóhoz meg kell adni egy linket. A fájlnév kizárólag alfanumerikus karaktereket, valamint a „-” (kötőjel), „_” (aláhúzás) és „.” (pont) karaktereket tartalmazhat. Szóközök, valamint ékezetes betűk (pl. é, à és ñ) nem megengedettek.
 Igen
country_origin A termék származási országa
> A lehetséges értékek megtekintése 		Nem
code_hs A termék vámkódja Nem
heel_height Sarokmagassság centiméterben (cm). Kizárólag a női cipőknél. A mértékegységet és a tizedesjegyeket ponttal kell elválasztani (például: 1.5). 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 Lehetővé teszi, hogy akciót alkalmazzunk egy termékre vagy egy méretre.
A discount mező rate mezője érinti az árkedvezményt százalékban a product_price mezőhöz viszonyítva.
A price_discount mező a discount mezőhöz tartozik, és a termék kedvezményes árát jelzi. A rendszer kiszámítja a megjelenített kedvezmény százalékát.
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. Ennek a beállításnak a megadása lehetővé teszi, hogy a termékek az akciók ideje alatt megjelenjenek az akciós oldalon. (Az 1 az „akció” kategóriát, a 0 pedig a „normál kedvezmény” kategóriát jelenti.) 		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
nyelvek Lehetővé teszi a több országra kiterjedő forgalmazás kezelését, valamint a fordított adatok és az országonként eltérő árak megadását (terméknév, leírás, alapár, szín, IDU-kód és akció).
Minden blokk egy vagy több language címkét tartalmaz, amelyeket egy kötelező code ország-/nyelvkód jellemez (pl.: FR, IT, DE stb.).

Méret szerinti kezelés : Ezt a címkét minden size címke alá is be lehet illeszteni, hogy méret- és országspecifikus árakat és akciókat alkalmazzunk.

A legfontosabb viselkedési szabályok :
• Globális készletek : Országonként eltérő mennyiségeket kezelni nem lehet. A készlet (mennyiség) méretét tekintve szigorúan globális marad.
• Termék deaktiválása országonként : Ha egy országot/nyelvet eltávolítanak a languages blokkból a termék szintjén (pl.: az FR címke jelen van, az IT címke viszont hiányzik), a termék automatikusan deaktiválásra kerül (visszavonásra kerül) az adott ország esetében.
• Egy ország eltávolítása egy méretből : Ha egy országot eltávolítanak a languages blokkból egy méret (pl.: 42-es méret) szintjén, de az ország a termék globális szintjén továbbra is aktív marad, akkor a 42-es méret nem lesz deaktiválva az adott ország számára. A termék továbbra is elérhető lesz a vásárláshoz, de elveszíti a mérethez kötött árát, és alapértelmezés szerint (fallback) automatikusan az adott országra meghatározott általános termékárhoz (product_price) igazodik. Egy méret teljes kikapcsolásához a teljes készletét 0-ra kell állítani. 		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>

Átviteli folyamat fájlon keresztül

A folyamat (XML vagy ZIP) fájlon keresztüli átvitele is lehetséges. Ehhez a kérés törzsének kizárólag a fájlt kell tartalmaznia.
A különböző paramétereket (mint például „partner”, „force_description”, „force_overwrite”, …) kötelezően GET-ben kell továbbítani.

Árak és kedvezmények méret szerint

Az ár- és kedvezménycímkék méret szerint lehetővé teszik a pontos árkülönbségek kezelését ugyanazon terméken belül.
Ezeket csak abban az esetben szabad használni, ha egy adott méret ára eltér az általános termékártól.
A termék szintjén meghatározott ár szolgál fő referenciaként. A méret-specifikus címkék célja, hogy csak kivételes esetekben írják felül ezt az árat (például speciális méretek, anyagköltség-többlet, részleges kifutó sorozat stb.).
Szigorúan tilos az ár- vagy kedvezménycímkék használata, ha minden méret ugyanazzal az árral rendelkezik, mint a fő termék. Ilyen esetben az árat csak a termék globális szintjén kell meghatározni.

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.
32 Fatal nem található semmilyen termékinformáció erre az országra vonatkozóan
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.
194 Fatal Az új ár csökkenése nem lehet magasabb xxx%-nál


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




Saitoo - Assistant
⛶
Bonjour ! Comment puis-je vous aider aujourd'hui ?