Početna > Webservisi > Import products

Ažuriranje proizvoda

Webservice URL : https://sws.spartoo.com.hr/mp/xml_maj_stock_batch.php

Ovaj webservis služi za ažuriranje zaliha proizvoda na stranici Spartoo.
Webservis će za svaki poslani proizvod poslati natrag kod koji će naznačiti je li sve prošlo u redu ili ne.

Ovaj webservis služi za ažuriranje zaliha proizvoda. Može se koristiti za slanje cijelog kataloga ili samo određenih proizvoda.

Ovaj webservis funkcionira u smislu „ažuriranja“, ne „brisanja“. To znači da proizvodi koji nisu poslani u XML-u, neće biti izbrisani.
Ako želite ukloniti neki proizvod sa stranice, morate staviti njegove zalihe na nulu.

Lista parametara

Parametri ovog webservisa moraju obavezno proći kroz POST

Parametar Opis
Partner Mora sadržavati jedinstveni identifikator:
xml XML niz znakova koji sadrži popis elemenata za ažuriranje


XML parameter format


The text fields must be protected by CDATA tags if they contain special characters that would make the XML invalid. 

<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>
						<!-- ... Multiple "language" tags possible ... -->
					</languages>
					<!-- ... Multiple "languages" tags possible ... -->
				</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>


Entry XML field description


Oznaka Opis Obavezno
reference_partenaire Oznaka proizvoda trgovca. Riječ je o sku oznaci koja identificira određeni proizvod marke u određenoj boji.
Oznaka proizvoda može sadržavati samo alfanumeričke znakove, kao i znakove - (crtica) _ (donja crta) i . (točka). 		Da
product_quantity Sveukupne zalihe jednog proizvoda
Zanemariti ako su jedna ili više size_quantity oznaka utvrđene za proizvod.
Za proizvode univerzalnih veličina obavezno treba navesti oznaku product_quantity, ako oznaka size_quantity nije navedena. 		Ne
Veličina Popis veličina i njihovih zaliha.
Fakultativno za proizvode bez veličina (torbe/modni dodaci). U suprotnom obavezno. 		Da / Ne
size_quantity Zalihe trebaju biti precizirane za svaku veličinu.
Želite li deaktivirati određeni proizvod, morate staviti 0 za njegove zalihe.
Kada su zalihe na nuli, proizvod je deaktiviran i više se neće prikazati na stranici Spartoo. 		Da
size_reference Referenca proizvoda po veličini. Da
cijena_proizvoda Cijena za veličinu Ne
popust Omogućuje vam primjenu promocije na proizvod.
Polje rate u polju discount odnosi se na smanjenje cijene u postotku u usporedbi s poljem product_price.
Polje price_discount u polju discount odnosi se na sniženu cijenu proizvoda. Prikazani postotak popusta će se izračunati.
Ako su prisutna oba polja, polje price_discount ima prednost nad poljem rate.
Ako je popust trenutačni, nema potrebe za navođenjem polja startdate. Ako polje datum završetka nije navedeno, promocija će imati zadano trajanje od mjesec dana. Ako je navedena oznaka sales, promocija će biti promocija prodaje. Inače će to biti klasična promocija. Određivanje ovog parametra omogućuje proizvodima da budu prisutni na prodajnoj stranici tijekom razdoblja prodaje. 		Ne


XML parameter example

<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>
						<!-- ... Multiple "language" tags possible ... -->
					</languages>
					<!-- ... Multiple "languages" tags possible ... -->
				</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>

XML format returned 


<catalogue>
	<products>
		<product>
			<reference_partenaire>string</reference_partenaire>
			<size_list>
				<size>
					<size_reference>string</size_reference>
					<errors>int</errors>
				</size>
			</size_list>
		</product>
		<!-- ... Multiple "product" tags possible ... -->
	</products>
</catalogue>


List of webservice error codes


Kod Opis
1 Nema pogreške u parametrima
-1 The parameter partenaire has not been set up or it is empty
-2 The parameter partenaire does not exist
-11 The parameter xml has not been set up or it is empty
-13 The parameter products_size_reference has not been set up or it is empty
-15 XML syntax error, verify your XML file
-18 The stock is the same as database and it has not been updated
-20 Unable to update stock. Size is no longer valid for the product, the stock for this product and this size is 0.
-31 Size_reference does not exist
-428 Vaš račun je deaktiviran. Više ne možete koristiti web servise.
-429 Prekoračili ste broj mogućih korištenja navedenog webservisa u posljednjih sat vremena.



XML return examples


Primjer neispravnog odgovora na poziv web servisa :

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

Primjer ispravnog odgovora na poziv web servisa :

<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>