Sprejem > Web storitve > Uvoz izdelkov

Posodobitev izdelkov

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

Ta spletna storitev se uporablja za posodabljanje zalog izdelkov na spletišču Spartoo.
Za vsak poslani izdelek bo spletna storitev poslala kodo, ki kaže, ali je šlo vse v redu ali ne.

Ta spletna storitev se uporablja za posodabljanje zalog izdelkov. Uporabite jo lahko za pošiljanje celotnega kataloga ali le nekaj izdelkov.

Spletna storitev deluje v načinu "Posodobitve" in ne v načinu "Pisanja preko". To pomeni, da izdelki, ki niso poslani v XML, ne bodo izbrisani.
Če želite izdelek odstraniti s spletišča, morate njegovo zalogo postaviti na 0.

Seznam nastavitev

Parametre te spletne storitve je treba obvezno posredovati v POST

Parameter Opis
partner Vsebovati mora vaš edinstven identifikator:
xml Znakovni niz XML, ki vsebuje seznam elementov za posodobitev


Format parametrov XML


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

<catalogue>
	<products>
		<product>
			<reference_partenaire>string</reference_partenaire>
			<size_list>
				<size>
					<size_reference>string</size_reference>
					<size_quantity>int</size_quantity>
					<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>
					<!-- ... Več možnih oznak "languages" ... -->
				</size>
				<size>
					<size_reference>string</size_reference>
					<size_quantity>int</size_quantity>
				</size>
			</size_list>
		</product>
		<product>
			<reference_partenaire>string</reference_partenaire>
			<size_list>
				<size>
					<size_reference>string</size_reference>
					<size_quantity>int</size_quantity>
				</size>
				<size>
					<size_reference>string</size_reference>
					<size_quantity>int</size_quantity>
				</size>
			</size_list>
		</product>
	</products>
</catalogue>


Opis vhodnih polj XML


Oznaka Opis Obvezno
reference_partenaire Identifikator izdelka trgovca. To je koda SKU, ki identificira izdelek blagovne znamke v določeni barvi
Identifikator izdelka lahko vsebuje samo alfanumerične znake, pa tudi znake - (vezaj) _ (podčrtaj) in . (pika). 		Da
product_quantity Skupna zaloga izdelka
Ne upošteva se, če je za izdelek zaznana ena ali več oznak size_quantity.
Za izdelke ene velikosti je obvezna oznaka product_quantity, če oznaka size_quantity ni navedena. 		Ne
size Seznam velikosti in njihove zaloge.
Neobvezno za izdelke brez velikosti (Torbe / dodatki). Obvezno, če ne. 		Da / Ne
size_quantity Za vsako velikost je treba navesti zalogo.
Za izključitev izdelka je treba zalogo nastaviti na 0.
Če je zaloga 0, je izdelek deaktiviran in se ne pojavlja več na spletišču Spartoo. 		Da
size_reference Referenčna oznaka velikosti izdelka. Da
cena izdelka Cena za velikost Ne
popust Omogoča upoštevanje promocije na izdelek.
Poljerate polja popust zadeva znižanje cene v odstotkih glede na poljecena_izdelka.
Polja popust polja popust zadeva znižano ceno izdelka. Izračunan bo prikazan odstotek popusta.
Če sta prisotni obe polji, je polje price_discount pomembnejše od polja rate.
Če je popust takojšen, ni treba navesti polja startdate. Če polje stopdate ni navedeno, bo promocija trajala en mesec. Če je oznaka sales navedena, bo promocija vezana na znižanja. V nasprotnem primeru bo šlo za klasično promocijo. Določitev tega paramaetra dovoljuje, da so produkti prisotni na strani znižanj med obdobji znižanj. 		Ne


Primer nastavitev xml

<catalogue>
	<products>
		<product>
			<reference_partenaire>98</reference_partenaire>
			<size_list>
				<size>
					<size_reference>98_38</size_reference>
					<size_quantity>5</size_quantity>
					<languages>
						<language>
							<code>FR</code>
							<product_price>100.00</product_price>
							<discount>
								<startdate>1199170800</startdate>
								<stopdate>1204354800</stopdate>
								<price_discount>90.00</price_discount>
								<rate>10</rate>
								<sales/>
							</discount>
						</language>
						<!-- ... Več možnih oznak "language" ... -->
					</languages>
					<!-- ... Več možnih oznak "languages" ... -->
				</size>
				<size>
					<size_reference>98_39</size_reference>
					<size_quantity>7</size_quantity>
				</size>
			</size_list>
		</product>
		<product>
			<reference_partenaire>158_tailor</reference_partenaire>
			<size_list>
				<size>
					<size_reference>158_37</size_reference>
					<size_quantity>2</size_quantity>
				</size>
				<size>
					<size_reference>158_36</size_reference>
					<size_quantity>0</size_quantity>
				</size>
			</size_list>
		</product>
	</products>
</catalogue>

Format izvoženega XML


<catalogue>
	<products>
		<product>
			<reference_partenaire>string</reference_partenaire>
			<size_list>
				<size>
					<size_reference>string</size_reference>
					<errors>int</errors>
				</size>
			</size_list>
		</product>
		<!-- ... Več možnih oznak "product" ... -->
	</products>
</catalogue>


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
-13 Nastavitev products_size_reference ni bila zaznana kot nastavitev ali pa je prazna
-15 Napaka v sintaksi XML, preverite datoteko XML
-18 Zaloga je enaka zalogi v bazi in zato ni bila posodobljena
-20 Zaloge ni mogoče posodobiti. Velikost za ta izdelek ne velja več, zaloga tega izdelka in ta velikost je 0.
-31 Ta referenca velikosti ne obstaja
-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



Primer vračila XML


Primer odgovora na spletno povpraševanje KO :

<catalogue>
	<products></products>
	<errors>-1</errors>
</catalogue>

Primer odgovora na spletno povpraševanje OK :

<catalogue>
	<products>
		<product>
			<reference_partenaire>EEAJBCC</reference_partenaire>
			<size_list>
				<size>
					<size_reference>EEAJBCC_38</size_reference>
					<errors>1</errors>
				</size>
			</size_list>
		</product>
		<product>
			<reference_partenaire>KJHGFDS</reference_partenaire>
			<size_list>
				<size>
					<size_reference></size_reference>
					<errors>-13</errors>
				</size>
			</size_list>
		</product>
	</products>
</catalogue>