Home > Webservices > Importer varer

Opdatering af produkter

URL til Webservices : https://sws.spartoo.dk/mp/xml_maj_stock_batch.php

Denne webservice bruges til at opdatere lagerbeholdningen af produkter på Spartoo-websiden.
For hvert sendt produkt returnerer webservicen en kode, der angiver, om alt gik godt eller ej.

Denne webservice bruges til at opdatere lagerbeholdningen af produkter. Den kan bruges til at sende hele kataloget eller blot enkelte produkter.

Denne webservice fungerer i tilstanden "Opdater" og ikke i tilstanden "Overskriv". Det vil sige, at de produkter, der ikke sendes i XML, ikke vil blive slettet.
For at fjerne et produkt fra websiden skal du sætte dets lager på 0.

Liste over parametre

Denne webservices parametre skal obligatorisk overgå til POST

Parameter Beskrivelse
partner Skal indeholde dit unikke id:
xml XML-karakterstreng, der indeholder listen over elementer, der skal opdateres


Format på XML-parametren


Felterne skal beskyttes af CDATA-koder, hvis de indeholder specielle tegn, der gør XML-filen ugyldig. 

<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>
						<!-- ... Flere muligheder for "language"-kode ... -->
					</languages>
					<!-- ... Flere muligheder for "languages"-kode ... -->
				</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>


Beskrivelse af felterne i XML


Kodelinje Beskrivelse Obligatorisk
partner_reference Samarbejdspartnerens produkt-id. Det er SKU'en som identificerer et produkt af et mærke og i en given farve
Produkt-id'et kan kun indeholde alfanumeriske tegn såvel som tegnene - (bindestreg) _ (underscore) og . (punktum). 		Ja
product_quantity Et produkts samlede lagerbeholdning
Ignorér hvis en eller flere size_quantity kodelinjer detekteres for produktet.
For produkter der kun findes i én størrelse er en product_quantity kodelinje obligatorisk hvis kodelinjen size_quantity ikke er opgivet. 		Nej
size Liste over størrelser og deres lagerbeholdning.
Valgfrit for produkter uden størrelser (Tasker/Accessories). Obligatorisk ellers. 		Ja/Nej
size_quantity For hver størrelse skal lagerbeholdningen præciseres.
For at deaktivere et produkt, skal lagerbeholdningen nedskrives til 0.
Når lagerbeholdningen er på 0, så er produktet deaktiveret og er ikke længere synligt på Spartoo. 		Ja
size_reference Produktets størrelsesreference Ja
product_price Pris for størrelsen Nej
tilbud Giver dig mulighed for at tilføje et tilbud på produktet.
Feltet prissats af feltet tilbud vedrører prisnedsættelsen som en procentdel af feltet product_price.
Feltet price_discount af feltet tilbud vedrører den nedsatte pris på produktet. Den viste rabatprocent vil blive beregnet.
Hvis begge felter er til stede, vil feltet price_discount have fortrinsret over feltet prissats.
Hvis tilbuddet er øjeblikkelig, er det ikke nødvendigt at angive startdate. Hvis feltet stopdate er angivet, vil kampagnens standardvarighed være en måned. Hvis sales er angivet, vil kampagnen være en udsalgskampagne. Ellers vil det være en klassisk kampagne. Ved at angive denne parameter kan produkter vises på salgssiden i udsalgsperioder. 		Nej


Eksempel på xml-parametre

<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>
						<!-- ... Flere muligheder for "language"-kode ... -->
					</languages>
					<!-- ... Flere muligheder for "languages"-kode ... -->
				</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>

Det returnerede XML-format


<catalogue>
	<products>
		<product>
			<reference_partenaire>string</reference_partenaire>
			<size_list>
				<size>
					<size_reference>string</size_reference>
					<errors>int</errors>
				</size>
			</size_list>
		</product>
		<!-- ... Flere muligheder for "product"-kode ... -->
	</products>
</catalogue>


Liste over fejlkoder hos webservices


Kode (kategori, materiale) Beskrivelse
1 Ingen fejlparametrer
-1 Parameteren partenaire er ikke blevet registreret eller er tom
-2 Forhandlerens parametre eksisterer ikke
-11 Parameteren xml er ikke blevet registreret eller er tom
-13 Parameteren products_size_reference er ikke blevet registreret eller er tom
-15 XML-syntaksfejl, tjek din XML-fil
-18 Lagerbeholdningen er den samme som i basen, så den er ikke blevet opdateret
-20 Det er ikke muligt at opdatere lagerbeholdningen. Størrelsen er ikke længere gyldig for denne model, lageret for denne vare og denne størrelse er i 0.
-31 Denne size_reference findes ikke.
-428 Din konto er deaktiveret. Du kan ikke længere benytte webservices
-429 Du har overskredet brugen af denne webservice inden for den seneste time



Eksempel på retur-XML


Prøvesvar på et opkald til webservicen KO :

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

Prøvesvar på et opkald til webservicen 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>