Home > Webservices > Import van artikelen

Producten bijwerken

URL van de Webservice : https://sws.spartoo.nl/mp/xml_maj_stock_batch.php

Deze webservice wordt gebruikt om de voorraad producten op de Spartoo-website bij te werken.
Voor elk verzonden product retourneert de webservice een code die aangeeft of alles goed is gegaan of niet.

Deze webservice wordt gebruikt om de voorraad producten bij te werken. Het kan worden gebruikt om de volledige catalogus of slechts enkele producten te verzenden.

Deze webservice werkt in de modus "Update" en niet in de modus "Overschrijven". Dat wil zeggen dat de producten die niet in de XML worden verzonden, niet worden verwijderd.
Om een ​​product van de site te verwijderen, moet u de voorraad op 0 zetten.

Lijst met parameters

De parameters van deze webservice moeten worden doorgezet als in POST

Parameter Omschrijving
partenaire Moet uw unieke ID bevatten : [ID]
xml XML-tekenreeks met de lijst met bij te werken elementen


Formaat van de XML parameter


De velden dienen beschermd te zijn door CDATA tags indien ze speciale karakters bevatten die de XML ongeldig zouden kunnen maken. 

<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>
						<!-- ... Meerdere tags "language" mogelijk ... -->
					</languages>
					<!-- ... Meerdere tags "languages" mogelijk ... -->
				</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>


Omschrijving van de velden van het XML databestand


Label Omschrijving Verplicht
referentie_partner Productcode van verkoper. Het is de sku die een product van een merk in een specifieke kleur identificeert
De product-ID mag alleen alfanumerieke tekens bevatten, evenals de tekens - (streepje) _ (onderstrepingsteken) en. (punt). 		Ja
artikel_aantal Totale voorraad van een product
Negeren als een of meer tags maat_aantal worden gedetecteerd voor het product.
Voor producten met een enkele grootte moet u een tag artikel_aantal hebben als de tag maat_aantal niet is voltooid. 		Nee
maat Lijst met maten en hun voorraad.
Optioneel voor producten zonder maten (tassen / accessoires). Anders verplicht. 		Ja / Nee
maat_aantal Voor elke maat moet de voorraad precies worden opgegeven..
Om een ​​product te deactiveren, moet u de voorraad op 0 zetten.
Wanneer de voorraad 0 is, is het product gedeactiveerd en verschijnt het niet meer op Spartoo. 		Ja
maat_referentie Product referentie naar maat. Ja


product_price Prijs voor de maat Prix pour la taille Non Kortingt Hiermee kun je een promotie op het product toepassen.
Het veld rate van het veld discount betreft de prijsverlaging als percentage van het veld product_price.
Het veld price_discount van het veld discount betreft de gereduceerde prijs van het product. Het weergegeven verminderingspercentage wordt berekend.
Als beide velden aanwezig zijn, heeft price_discount voorrang op het veldrate.
Als de korting onmiddellijk is, is het niet nodig om het veld startdate te specificeren. Als het veld stopdate niet is gespecificeerd, is de standaardduur van de promotie één maand. Als de sales is opgegeven, is de promotie een uitverkoopactie. Anders is het een klassieke promotie. Door deze parameter op te geven kunnen producten tijdens uitverkoopperiodes op de verkooppagina verschijnen. Nee

Voorbeeld van een XML parameter 

<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>
						<!-- ... Meerdere tags "language" mogelijk ... -->
					</languages>
					<!-- ... Meerdere tags "languages" mogelijk ... -->
				</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>

Formaat van de teruggestuurde XML data


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


Lijst met de foutcodes van de webservice


Code Omschrijving
1 Geen fouten in de parameters
-1 De parameter partenaire werd niet als parameter aangemaakt of is leeg
-2 De partenaire parameter bestaat niet
-11 De parameter xml werd niet als parameter aangemaakt of is leeg
-13 De parameter products_size_reference werd niet als parameter aangemaakt of is leeg
-15 Opmaakfout XML, gelieve uw bestand na te kijken
-18 De voorraad is dezelfde en werd dus niet vernieuwd
-20 Onmogelijk om de voorraad te actualiseren. De maat van dit product is niet langer beschikbaar, de voorraad van dit product in deze maat is 0.
-31 Deze maat_referentie bestaat niet
-428 Uw account is gedeactiveerd. U kunt niet langer gebruik maken van de webservices
-429 U heeft te veel gebruik gemaakt van deze webservice voor dit uur



Voorbeelden van XML retour


Voorbeeld KO :

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

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