Accueil > Intégration par flux CSV ou XML

CSV vagy XML táblázat által történő integráció

Bevezetés

Az Ön oldalának a termékei integrálva lehetnek a Spartoo oldalára CSV vagy XML táblázatok által.
Ebben az esetben, a CSV vagy XML fájlnak tartalmaznia kell minden olyan termékének az információit, amelynek elérhetőnek kell lennie a weben a robotunk által.

A robotunk le fogja tölteni megközelítőleg óránként a fájlt és integrálni fogja a benne található információkat.
A fájlnak a lehető mindig naprakésznek kell lennie, így elkerülve a nem elérhető termékek megjelenését a Spartoo oldalán.

A fájlnak minden szükséges információt tartalmaznia kell a termékei kategorizálásáról és a készletei mennyiségéről.

Minden mező lehet kötelező, ajánlott, vagy fakultatív. Ha a kötelező mezők közül egy üres vagy rosszul van kitöltve, a termék nem lesz integrálva.
Lentebb találni fog néhány CSV vagy XML fájl modellt. A fájl modelljét a Spartoo nem köti meg. Azonban, az Ön fájljának minden kötelező információt tartalmaznia kell.

Ideális esetben, az Ön fájljának UTF-8-as kódolást kell használnia. Ellenkező esetben, kérem értesítsen bennünket, hogy konfigurálhassuk a fájl feldolgozását.
A CSV fájloknál, a fájlnak pontosvesszőt ';' kell használnia. Ellenkező esetben, kérem értesítsen bennünket, hogy konfigurálhassuk a fájl feldolgozását.

Amennyiben nincsen olyan szervere, mely alkalmas fájlok megosztására (ftp szerver), úgy a Spartoo a Dropbox használatát ajánlja.
további információ

Definíció

Termék vagy Felnőtt termék : A Spartoo-nál, egy termékhez egy szín és egy modell tartozik.
Tehát a modell, ami két színben elérhető, két terméket jelent ( tehát két különböző termékazonosítóval rendelkezik )
Mindazonáltal, egy termék elérhető lehet több méretben is.
Gyerek termék : A Spartoo-nál, egy gyerek termék egy terméket és egy különböző méretet jelent.
Tehát a modell, ami egy színben és két méretben elérhető, az kettő "gyerek termék"-nek minősül ( tehát egyetlen termék azonosító és kettő gyerek termék azonosító )
A készletnek kötelezően összhangban kell lennie a gyerek termékkel. Ez egyébként az egyetlen kötelező információ a gyerek termékek kapcsán. A többi információ a többi információ alapvetően a felnőtt termékeket érinti és hanyagolhatóak a gyerek termékekre.

Információk listája CSV flux-hoz

Mező neve	Mező<	Leírás
SKU / Termékazonosító	Kötelező	E mező a "felnőtt SKU" értéket tartalmazza szülő sorok számára és az "gyerek SKU" értéket a gyerek sorok számára. A "felnőtt sku" mezők csak alfanumerikus karaktereket tartlamzhatnak(a-Z 0-9 . _ -). A szünetek nem megengedettek. A "gyerek sku" mezők bármilyen karaktert tartalamzhatnak.
Felnőtt / Gyerek	Kötelező a CSV-hez<	Ez a mező kötelező abban az esetben, ha a fájl termékenként egy sort tartalmaz és egy sort gyerek termékenként Ebben az esetben meg kell adni számunkra egy azonosítási módot, ha egy sor egy termék vagy egy gyerektermék. Ez a mező tartalmazhatja például a "Felnőtt" szót a felnőtt termékeknél és a "Gyerek" szót a gyerek termékeknél
Felnőtt SKU	Kötelező a CSV-hez	Ez a mező kötelező abban az esetben, ha a fájl termékenként egy sort tartalmaz és egy sort gyerek termékenként Minden gyerektermékről tudnunk kell, hogy melyik felnőtt terméknek felel meg. Ennek a mezőnek tehát tartalmaznia kell a felnőtt termék termékazonosítóját.
Modell neve	Ajánlott	Ennek a mezőnek kizárólag a modell nevét kell tartalmaznia, más információt nem (kategória, szín, márka)
Márka neve	Kötelező
IDU kód	Ajánlott	Ez a mező tartalmazza a termék IDU kódját (lásd AGEC törvény)
Nem	Kötelező	Termék neme. A következő kódokat kell használni : H : Férfi F : Női M : Vegyes felnőtt B : Fiú G : Lány K : Vegyes gyerek
Termék ára	Kötelező	Kötelezően pénzben kell lennie 'HUF'. Az ár csak a felnőtt termékre vonatkozik. A gyerek termékeknek nem lehet más ára.
Kategória	Kötelező	Tartalmazza a termék kategóriájának kódját. Kérjük kerülni a makro-kategóriákat (pirosan) és előnyben részesíteni a többit, pontosabbat. Abban az esetben, ha nem tudja nekünk megadni a Spartoo kódot, megadhatja a kategória nevét. A kategóriaillesztő eszközt kell ekkor használni, hogy az Ön kategóriái megfeleljenek Spartoo kategóriáinak. Az összes kategória kód listájának megtekintése
Válogatások	Fakultatív	A termékhasználat kontextusait engedi pontosítani egy azonosító lista által. Az elérhető kontextusok együttese itt érhető el
Árkedvezmény	Ajánlott	Tartalmazza a termék kedvezményes árát. Ha a kedvezmény mértéke ki van töltve és az nem felel meg a diszkontált árnak, akkor a diszkontált ár az, ami számít.
Kedvezmény mértéke	Ajánlott	Tartalmazza a kívánt kedvezmény mértékét. Minden kedvezmény kerekítve lesz ( lefelé ) a Spartooáltal 5%-onként. Például, ha a kedvezmény mértéke 27%, az kerekítve lesz 25%-ra.
Kedvezmény típusa	Ajánlott	Ha egy promóció típusa leárazás, akkor azt kérjük itt jelölni.
Promóciók dátumai	Fakultatív	A promóciókhoz be lehet állítani egy kezdő és egy záró dátumot. Abban az esetben, amikor a dátum nincs pontosítva, a promóció azonnal kezdődik. Ez érdekes lehet a leárazások alatt, feltüntetni a promóció kezdeti dátumát, így a kedvezmények direkt módon a megfelelő időben fognak elindulni, a fájl következő integrációjának megvárása nélkül.
Méret	Kötelező	Tartalmazza a termék méretét. Ha a mező nem jelenik meg vagy ha üres, a termék egy méretűként fog megjelenni. Az amerikai textíliák esetében, tudnunk kell hogy a méretezés EU vagy US : vagy jelezni kell a méretnél, hogy US, vagy hozzá kell adni egy mezőt, ami jelzi, hogy a méret US vagy nem.
Készletmennyiség	Kötelező	Minden méretnél meg kell adni a pontos készletet. Egy termék deaktiválásához, a készletet 0-ra kell állítani. Amikor a készlet 0, a termék deaktiválva van, és nem jelenik meg többé a Spartoo oldalán.
EAN	Kötelező	A nemzetközi standard kód, ami azonosítja az egyes termékeket, és ami lehetővé teszi a google shopping felületén és más ár összehasonlító oldalakon való megjelenést.
Fotók	Kötelező	Minimum egy fotó kötelező. Javasoljuk, hogy legalább 3 fotóval rendelkezzen. Maximum 8 fotót tudunk integrálni. Meg kell adnia nekünk a linket a fotókhoz. A fájl neve kizárólag alfanumerikus karaktereket tartalmazhat, valamint "-" (kötőjelet), "_" (alsó kötőjelet) és "." (pontot). Figyelem: a fájlnévben a szóközök, továbbá az ékezetes betűk (pl. é, à és ñ) nem engedélyezettek. A fotó egyszer lesz feltöltve, utána pedig el lesz mentve a szerverünkön, miután át lett méretezve a Spartoo dimenziói szerint. A fotóknak jpg formátumban, négyzet alakúnak és minimum 350x350 megapixel felbontásúaknak kell lenniük. Ha 800x800 megapixelel egyenlőek vagy nagyobbak a fotók, lehetőség lesz nagyításra az oldalon.
Termékleírás	Ajánlott	Termék szöveges leírása. A termékleírás lehetővé teszi, hogy minél több olyan információt adjon hozzá a termékekről, amelyek segíthetik a vásárlót a vásárlási döntés meghozatalában. A jó termékleírás minden termékre részletes és specifikus. Éppen ezért, tartalmazhatja a modell nevét, márkáját, színét, a termék stílusát, az anyagot stb. Nem lehet HTML-t beszúrni, a következő kivételével: ' '. A javascript nem engedélyezett. Kizárólag a termék oldalán lesz látható.
Szín szűrő	Ajánlott	Spartoo azonosító színekhez. A menük szűréséhez használt. Ha az azonosító nincs megadva, lehetőség van a színegyeztető eszközt használni, hogy megegyezővé tegye az Ön színeinek neveit a Spartoo színeivel. Az összes színkód listájának megtekintése
Szín	Ajánlott	Szöveg mező a színnek. A termék oldalán fog megjelenni
Összetételek	Fakultatív	Kizárólag a cipőknél. 4 különböző összetétel tudunk integrálni : Szár összetétele Bélés összetétele Belső talp összetétele Külső talp összetétele Nem rendelkezünk eszközzel az összetételek egyeztetéséhez, tehát kötelezően a Spartoo kódjait kell használni. Az összes összetétel kód listájának megtekintése
Sarok magassága	Fakultatív	Kizárólag a női cipőkhöz ( félcipők, csizmák, stb ... ) Sarok magassága cm-ben.
Gyártási ország	Fakultatív	Az ország származási országa Lehetséges értékek megtekintése
HS kód	Fakultatív	A termék HS kódja a vámhatóságnak
További információk	Fakultatív	Az információs kódok listája vesszővel elválasztva (pl.: '120,521') Lehetséges értékek megtekintése

Információk listája az XML folyamatokhoz

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 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>
			<code_idu>string</code_idu>
			<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>
					<code_idu>string</code_idu>
					<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>

Fájl minták

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 )
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	Fatal	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.
203	Warning	Az EAN kód túl rövid vagy '000'-ra végződik
204	Warning	A(z) xxx EAN kód már több példányban is létezik a folyamatban.
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 )
281	Fatal	A fotó túl nagy (xxxo)
30	Fatal	A xxx méret mennyisége túl nagy (Maximális mennyiség: xxx)
31	Warning	Ügyfélfiókja nem került aktiválásra a xxx oldalon.
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.
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
42	Warning	A szezon nem érvényes.
43	Warning	xxx termékinformáció egy product_type = xxx terméknek felel meg, és nem egy xxx terméknek.
44	Warning	A/Az xxx kategória nem felel meg a/az xxx típusú terméknek, de a/az xxx típusú terméknek igen.
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.