Sprejem > Web storitve > Uvoz izdelkov

Uvoz izdelkov

URL Webservice-a : https://sws.spartoo.si/mp/xml_import_products.php

Seznam nastavitev

Parametre te spletne storitve je potrebno obvezno prenesti v POST

Paramètre Opis
partenaire Mora vsebovati vaš edinstveni identifikator :
xml Niz znakov XML, ki vsebuje seznam elementov, ki jih želite ustvariti ali posodobiti


Izbirni parametri, ki jih je mogoče prenesti v POST

Paramètre Opis
force_description Nastavite na 1, če želite vsiliti posodobitev opisov izdelkov: izbrišite obstoječe opise, uredite opis izdelka z ničelno zalogo itd.
force_overwrite Nastavite na 1, če želite iz kataloga odstraniti nepravilne zaloge. Bodite pozorni, da boste preostali del kataloga poslali brez prepisovanja takoj zatem.


Format parametrov XML


Besedilna polja je treba zaščititi z oznakami balises CDATA če vsebujejo posebne znake, zaradi katerih bi bil XML neveljaven.

Format za eno državo

<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>
				<!-- ... Več možnih oznak "size" ... -->
			</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>
				<!-- ... Več možnih oznak "info" ... -->
			</extra_infos>
			<selections>
				<selection>int</selection>
				<!-- ... Več možnih oznak "selection" ... -->
			</selections>
		</product>
		<!-- ... Več možnih oznak "product" ... -->
	</products>
</root>


Format za več držav

<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>
				<!-- ... Več možnih oznak "language" ... -->
			</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>
						<!-- ... Več možnih oznak "language" ... -->
					</languages>
				</size>
				<!-- ... Več možnih oznak "size" ... -->
			</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>
				<!-- ... Več možnih oznak "info" ... -->
			</extra_infos>
			 <selections>
				<selection>int</selection>
				<!-- ... Več možnih oznak "selection" ... -->
			</selections>
		</product>
		<!-- ... Več možnih oznak "product" ... -->
	</products>
</root>


Opis vhodnih polj XML


Oznaka Opis Obvezno
partner_reference Identifikator izdelka trgovca. To je šifra, ki identificira izdelek blagovne znamke v določeni barvi
Identifikator izdelka lahko vsebuje samo alfanumerične znake ter znake - (vezaj) _ (pomišljaj) in . (točka). 		Da
ime_izdelka Ime modela
Ne sme vsebovati kategorije, barve ali znamke izdelka
Prav tako ne sme vsebovati html znakov ali oznak
 Ne
ime_proizvajalca Blagovna znamka izdelka Da
idu_code IDU koda izdelka (glejte zakon AGEC) Ne
product_sex Spol izdelka
> Oglejte si možne vrednosti 		Da
cena_izdelka Cena izdelka v evrih (ni obvezno za cene velikosti) Da /Ne
barva_id Barva za menijske filtre
Če ni navedeno, izdelek ne bo izstopal, če kupec uporabi barvni filter
> Oglejte si možne vrednosti 		Ne
slog_izdelka Kategorija izdelka
> Oglejte si možne vrednosti 		Da
opis_izdelka Opis izdelka. Pojavi se na listu izdelka. Ne
barva_izdelka Prosto besedilno polje za barvo. Pojavi se na listu izdelka. Ne
količina_izdelka Skupna zaloga izdelka
Prezrto, če je za izdelek zaznana ena ali več oznak size_quantity.
Za izdelke ene velikosti je zahtevana oznaka product_quantity, če oznaka size_quantity ni določena. 		Ne
velikost Seznam velikosti in njihova zaloga.
Izbirno za izdelke brez velikosti (torbe/dodatki). V nasprotnem primeru obvezno. 		Da / Ne
ime_velikosti Ime velikosti
> Oglejte si možne vrednosti 		Da
velikost_količina Za vsako velikost je treba navesti zalogo.
Če želite deaktivirati izdelek, morate zalogo nastaviti na 0.
Ko je zaloga 0, je izdelek deaktiviran in ni več prikazan na Spartoo. 		Da
size_reference Sklicevanje na velikost izdelka.
To polje se uporablja samo za vrnitev v izvozih naročil ali vračilih. Dobra praksa je, da to referenco ustvarite tako, da polji reference_partenaire in size_name združite s podčrtajem »_«. 		Ne
ean EAN izdelka glede na velikost
Obvezno za logistično storitev		 Ne / Da
fotografije Seznam fotografij in njihov URL.
Zahtevana je vsaj ena fotografija.
Priporočamo vsaj 3 fotografije. Vključimo lahko največ 8 fotografij.
Fotografija bo naložena samo enkrat, nato pa bo shranjena na naših strežnikih, potem ko bo spremenjena na dimenzije Spartoo.
Fotografije morajo biti v formatu jpg, kvadratne in velikosti najmanj 350x350 slikovnih pik. Če so večje ali enake 800 x 800 slikovnih pik, bo na spletnem mestu možno povečavo. 		Da
url1, url2 ... url8 Povezave do fotografij
Posredovati nam morate povezavo do vsake fotografije. Ime datoteke mora vsebovati samo alfanumerične znake ter znake "-" (pomišljaj), "_" (podpomišljaj) In "." (točka). Presledki in naglašene črke (npr. é, à in ñ) niso dovoljeni. 		Da
država_porekla Država porekla izdelka
> Oglejte si možne vrednosti 		Ne
code_hs Carinska oznaka izdelka Ne
višina_pete Višina pete v centimetrih (cm). Samo za ženske čevlje. Za ločevanje enote od decimalk morate uporabiti piko (na primer: 1,5). Ne
sestava_izdelka Sestava stebla izdelka. Samo za čevlje in torbe
> Oglejte si možne vrednosti 		Ne
voering_composition Sestava obloge izdelka. Samo za čevlje in torbe
> Oglejte si možne vrednosti 		Ne
prva_sestava Sestava vložka izdelka. Samo za čevlje
> Oglejte si možne vrednosti 		Ne
zool_composition Sestava podplata izdelka. Samo za čevlje
> Oglejte si možne vrednosti 		Ne
popust Omogoča uporabo promocije za izdelek ali velikost izdelka.
Polje stopnja v polju popust zadeva znižanje cene v odstotkih v primerjavi s poljem product_price.
Polje price_discount v polju discount se nanaša na znižano ceno izdelka. Prikazan odstotek popusta bo izračunan.
Če sta prisotni obe polji, ima polje price_discount prednost pred poljem rate.
Če je popust takojšen, polja začetni datum ni treba navesti. Če polje datum konca ni določeno, bo promocija privzeto trajala en mesec. Če je navedena oznaka sales, bo promocija prodajna promocija. V nasprotnem primeru bo šlo za klasično napredovanje. Določanje tega parametra omogoča, da so izdelki prisotni na prodajni strani med prodajnimi obdobji. 		Ne
dodatne_informacije Omogoča podajanje dodatnih informacij glede na vrsto izdelka.
Vsaka informacija je sestavljena iz ID-ja ( > Glej vrednosti ) in vrednosti v številčni obliki. 		Ne
izbire Omogoča vam, da določite kontekste uporabe izdelka s seznamom ID-jev.
Ves razpoložljiv kontekst je na voljo tukaj. 		Ne


Primer nastavitev xml

<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[Legende med legendami, Chuck Taylor All Star iz Conversa so superge, ki jih preprosto morate imeti.
Tokrat v visoki različici s platnenim vrhnjim delom in klasičnim navadnim potiskom - brezčasne in vedno modne!]]></product_description>
			<product_color><![CDATA[Rdeča]]></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>

Format izvoženega XML


<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>
				<!-- ... Več možnih oznak "error" ... -->
			</errors>
		</product>
		<!-- ... Več možnih oznak "product" ... -->
	</products>
	<errors>int</errors>
</root>


Seznam kod za napake spletnih storitev


Koda Opis
1 Ni napak v nastavitvah
-1 Nastavitev partenaire ni bila zaznana kot nastavitev ali pa je prazna
-2 Partnerske nastavitve ne obstajajo
-11 Nastavitev xml ni bila zaznana kot nastavitev ali pa je prazna
-15 Napaka v sintaksi XML, preverite datoteko XML
-428 Vaš račun je deaktiviran. Ne morete več naročati spletnih storitev
-429 V tekoči uri ste to spletno storitev prevečkrat naročili

Opis polj odzivov XML


Oznaka Opis
reference_partenaire ID partnerskega izdelka
status OK, če je izdelek dodan v bazo podatkov
KO če izdelka ni bilo mogoče dodati
action Seznam možnih ukrepanj :
  • created : izdelek je bil ustvarjen.
  • not created : Izdelek ni bil ustvarjen. Pozor: izdelek ima lahko status »OK« ampak ni bil dejansko ustvarjen zaradi določenega 'Warning'.
  • updated : izdelek je bil posodobljen.
  • not updated : Izdelek ni bil posodobljen. Pozor : izdelek ima lahko status »OK« ampak ni bil dejansko posodobljen zaradi določenega 'Warning'.
errors Seznam napak pri obdelavi:
  • id : koda napake izdelka
  • level : raven napake
    • Warning : ne preprečuje integracije izdelkov
    • Fatal : preprečuje integracijo izdelkov
  • description : description texte de l'erreur


Seznam kod za napake spletnih storitev


Koda Raven Opis
1 Fatal Referenca partnerja ni dovolj dolga
2 Fatal Referenca partnerja ni veljavna, vsebuje lahko le alfanumerični znake (črke in številke)
3 Warning Ime izdelka ni določeno
4 Fatal Znamka ni določena
5 Fatal Spol ni veljaven, edine mogoče vrednosti so: H, F, M, K, G, B
6 Fatal Cena mora biti zapisana v številkah
7 Fatal cena je negativna ali ni navedena
8 Warning Cena se nam zdi visoka ( > 1000€ )
81 Fatal Cena ne more biti višja od 180€
9 Fatal Količina mora biti celo število
10 Fatal Količina mora biti pozitivna
11 Warning Barva xxx ne obstaja: izdelek ne bo na voljo preko barvnih filtrov
13 Fatal Kategorija xxx ne obstaja
14 Warning Opis izdelka je prazen
15 Warning Barva prikaza je prazna
16 Warning Ni seznama velikosti: uporaba unikatne velikosti
17 Warning Sestava je navedena, vendar ni veljavna
18 Fatal Fotografija 1 je obvezna
19 Warning Stopnja popusta promocije mora biti med 0 in 100, sicer promocija ne bo upoštevana
20 Warning Velikost xxx ne obstaja
201 Fatal Koda EAN (črtna koda) je obvezna
202 Fatal EAN kodo xxx na sklicu xxx v velikosti xxx že uporablja ref: xxx.
205 Fatal Predolga referenca
23 Warning Fotografija xxx je manjša od 350x350 : na spletni strani bo slabe kakovosti
24 Warning Fotografija xxx je manjša od 350x350, zaradi tega ne bo prikazana na spletni strani
25 Fatal Velikost xxx : Ni mogoče urediti zalog
26 Fatal Ni zalog: izdelek ne bo ustvarjen
27 Fatal Ni mogoče dostopati do fotografije 1 ( url xxx )
28 Warning Ni mogoče dostopati do fotografije xxx ( url xxx )
30 Fatal Količina velikosti xxx je previsoka (maksimalna kvantiteta: xxx)
33 Fatal Izdelek xxx spol ne more pripadati kategoriji xxx
34 Fatal Beseda xxx je na črnem seznamu in se ne sme pojaviti v imenu ali opisu izdelka.
35 Fatal Ime izdelka je predolgo, vsebovati mora le ime modela. Napaka(-e) v zvezi z državo(-ami): xxx
341 Fatal Beseda xxx je na black listi in se ne sme pojaviti v opisu izdelka.
36 Fatal Ta izdelek je nemogoče dodati, ker gre za dvojni vnos velikosti/barve.
37 Fatal Za ta izdelek niste navedli veljavnih informacij glede jezika
38 Fatal Velikost xxx je lahko le enkrat opredeljena z referenco xxx
39 Warning Referenca partnerskega prodajalca je ponovljena večkrat, dvojniki bodo ignorirani.
451 Fatal Ni cene za velikost xxx države xxx. (nujno za popust)
452 Warning Končni datum za popust je bil presežen za velikost xxx države xxx.
453 Fatal "stopnja" (xxx) neveljavna za velikost xxx države xxx.
454 Fatal "stopnja" (xxx) > 85% za velikost xxx države xxx.
455 Warning Velikost xxx ima ceno v državi(xxx), ki ni določena za izdelek.
456 Warning Velikost xxx ima ceno na xxx, ki je enaka svetovni ceni v tej državi.


Primer vračila XML


Primer odgovora na spletno povpraševanje KO :

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

Primer odgovora na spletno povpraševanje OK :

<root>
	<products>
		<product>
		<reference_partenaire>EEAJBCC</reference_partenaire>
		<status>KO</status>
		<action>not created</action>
		<errors>
			<error>
				<id>14</id>
				<description>Opis izdelka je prazen</description>
				<level>warning</level>
			</error>
			<error>
				<id>4</id>
				<description>Znamka ni določena</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>

Datoteka XSD

Datoteka XSD Več držav