Home > Webservices > Import van artikelen

Producten bijwerken

URL van de Webservice : https://sws.spartoo.be/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 afbakeningen "language" mogelijk ... -->
					</languages>
					<!-- ... Meerdere afbakeningen "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


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