Home > Webservices > Import van artikelen

Import van de producten

URL van de Webservice : https://sws.spartoo.be/mp/xml_import_products.php

Deze webservice dient om producten op de site van Spartoo aan te maken en om ze te vernieuwen.
Voor elk product zal de webservice een foutcode terugsturen om aan te geven of alles goed verlopen is of niet. Bepaalde fouten leiden tot een blokkering (fataal),andere niet (warning).

Deze webservice werkt als "Update" en niet als "Verwijderend". Dit wilt zeggen dat producten die niet in het XML bestand werden verzonden, niet verwijderd worden.

Frequentie van oproepen:
- Wanneer deze webservice wordt gebruikt om de catalogus volledig bij te werken, raden we aan deze om de 6 uur te gebruiken.
- Wanneer deze webservice wordt gebruikt om een gedeeltelijke update uit te voeren (alleen voor sommige producten), accepteren we een maximale frequentie van één oproep om de 10 minuten.

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

Lijst met parameters

De parameters van deze webservice dienen verplicht in POST te zijn

Parameter	Omschrijving
partenaire	Dit dient uw unieke ID te bevatten:
xml	XML karakters die de lijst van producten bevatten

Optionele parameters die kunnen worden doorgegeven in POST

Parameter	Beschrijving
force_description	Te zetten op 1 indien je productbeschrijvingen spoedig wenst up te daten: verwijderen van bestaande productbeschrijvingen, wijzigen van een productbeschrijving bij voorraad 0 etc.
force_overwrite	Te zetten op 1 indien je fouten gelinkt aan een belangrijke prijswijziging wenst te corrigeren

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.

Formaat enkel land

<root>
	<products>
		<product>
			<reference_partenaire>string</reference_partenaire>
			<product_name>string</product_name>
			<manufacturers_name>string</manufacturers_name>
			<product_sex>char</product_sex>
			<product_price>float</product_price>
			<product_quantity>int</product_quantity>
			<color_id>int</color_id>
			<product_style>int</product_style>
			<product_description>string</product_description>
			<product_color>string</product_color>
			<heel_height>float</heel_height>
			<country_origin>int</country_origin>
			<code_hs>int</code_hs>
			<size_list>
				<size>
					<size_name>string</size_name>
					<size_quantity>int</size_quantity>
					<size_reference>string</size_reference>
					<ean>string</ean>
					<code_hs>int</code_hs>
					<product_price>float</product_price>
					<discount>
						<startdate>timestamp</startdate>
						<stopdate>timestamp</stopdate>
						<price_discount>float</price_discount>
						<rate>int</rate>
						<sales/>
					</discount>
				</size>
				<!-- ... Meerdere afbakeningen "size" mogelijk ... -->
			</size_list>
			<product_composition>int</product_composition>
			<voering_composition>int</voering_composition>
			<first_composition>int</first_composition>
			<zool_composition>int</zool_composition>
			<photos>
				<url1>url</url1>
				<url2>url</url2>
				<url3>url</url3>
				<url4>url</url4>
				<url5>url</url5>
				<url6>url</url6>
				<url7>url</url7>
				<url8>url</url8>
			</photos>
			<discount>
				<startdate>timestamp</startdate>
				<stopdate>timestamp</stopdate>
				<price_discount>float</price_discount>
				<rate>int</rate>
				<sales>0/1</sales>
			</discount>
			<extra_infos>
				<info>
					<id>int</id>
					<value>float</value>
				</info>
				<!-- ... Meerdere afbakeningen "info" mogelijk ... -->
			</extra_infos>
			<selections>
				<selection>int</selection>
				<!-- ... Meerdere afbakeningen "selection" mogelijk ... -->
			</selections>
		</product>
		<!-- ... Meerdere afbakeningen "product" mogelijk ... -->
	</products>
</root>

Formaat meerdere landen

<root>
	<products>
		<product>
			<reference_partenaire>string</reference_partenaire>
			<manufacturers_name>string</manufacturers_name>
			<product_sex>char</product_sex>
			<product_quantity>int</product_quantity>
			<color_id>int</color_id>
			<product_style>int</product_style>
			<heel_height>float</heel_height>
			<country_origin>int</country_origin>
			<code_hs>int</code_hs>
			<languages>
				<language>
					<code>string</code>
					<product_name>string</product_name>
					<product_description>string</product_description>
					<product_color>string</product_color>
					<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>
			<size_list>
				<size>
					<size_name>string</size_name>
					<size_quantity>int</size_quantity>
					<size_reference>string</size_reference>
					<ean>string</ean>
					<code_hs>int</code_hs>
					<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>
				</size>
				<!-- ... Meerdere afbakeningen "size" mogelijk ... -->
			</size_list>
			<product_composition>int</product_composition>
			<voering_composition>int</voering_composition>
			<first_composition>int</first_composition>
			<zool_composition>int</zool_composition>
			<photos>
				<url1>url</url1>
				<url2>url</url2>
				<url3>url</url3>
				<url4>url</url4>
				<url5>url</url5>
				<url6>url</url6>
				<url7>url</url7>
				<url8>url</url8>
			</photos>
			<extra_infos>
				<info>
					<id>int</id>
					<value>float</value>
				</info>
				<!-- ... Meerdere afbakeningen "info" mogelijk ... -->
			</extra_infos>
			 <selections>
				<selection>int</selection>
				<!-- ... Meerdere afbakeningen "selection" mogelijk ... -->
			</selections>
		</product>
		<!-- ... Meerdere afbakeningen "product" mogelijk ... -->
	</products>
</root>

Omschrijving van de velden van het XML databestand

Tag	Omschrijving	Verplicht
partner_referentie	Productreferentie van de partner. Dit is de sku die een product van een merk in een bepaalde kleur identificeert De product referentie mag enkel alfanumerieke karakters bevatten en de karakters - (streepje) _ (laag streepje) en . (punt).	Ja
product_name	Naam van heent model Het veld dient niet de categorie, kleur of merk van het product te bevatten	Nee
manufacturers_name	Naam van het merk van het product	Ja
product_sex	Geslacht van het product > Bekijk de mogelijke waarden	Ja
product_price	Prijs van het product in euro	Ja
color_id	Kleur bestemd voor de filters van het menu Indien de kleur niet is opgegeven, zal het product niet verschijnen worden wanneer een klant filtert op kleur > Bekijk de mogelijke kleuren	Nee
product_style	Categorie van het product > Bekijk de mogelijke waarden	Ja
product_description	Omschrijving van het product. Verschijnt in de productfiche.	Nee
product_color	Vrij tekstveld voor de kleur. Verschijnt in de productfiche.	Nee
size	Lijst van de maten en de voorraad ervan. Facultatief voor de producten zonder maat (Tassen/Accessoires). Zoniet verplicht.	Ja / Nee
size_name	Naam van de maat > Bekijk de mogelijke waarden	Ja
size_quantity	Voorraad van het product voor deze maat	Ja
size_reference	Productreferentie per maat. Dit veld dient enkel ingevuld te zijn voor de export van bestellingen en retourzendingen.	Non
ean	EAN van het product per maat	Nee
foto's	Lijst van de foto's en hun url Op ze minst één foto is verplicht We raden aan om minimaal 3 foto's te hebben. Wij kunnen maximaal 8 foto's intergreren. De foto wordt slechts één keer geüpload en wordt opgeslagen op onze servers, nadat het formaat is aangepast naar Spartoo-afmetingen. Foto's moeten in jpg-formaat, vierkant en minimaal 350x350 pixels zijn. Als ze groter zijn dan of gelijk zijn aan 800x800 pixels, is er een mogelijke zoomlens op de site.	Ja
url1, url2 ... url8	Link naar de foto's Graag een link naar elke foto verstrekken. De bestandsnaam mag alleen alfanumerieke tekens bevatten, evenals de tekens "-" (koppelteken), "_" (onderstrepingsteken) en "." (DOT). Spaties en letters met accenten (bijv. É, à en ñ) zijn niet toegestaan.	Ja
heel_height	Hakhoogte in centimeter (cm). Alleen voor damesscheonen. Moet een veelvoud van 0,5 zijn.	Nee
product_composition	Samenstelling van de schacht van het product. Enkel voor schoenen > Bekijk de mogelijke waarden	Nee
voering_composition	Samenstelling van de binnenvoering van het product. Enkel voor schoenen > Bekijk de mogelijke waarden	Nee
first_composition	Samenstelling van de binnenzool van het product. Enkel voor schoenen > Bekijk de mogelijke waarden	Non
zool_composition	Samenstelling van de buitenzool van het product. Enkel voor schoenen > Bekijk de mogelijke waarden	Nee
discount	Laat toe een korting toe te passen op het product. Het veld rate bij het veld discount is de korting op de prijs in percentage berekend op het veld product_price. Het veld price_discount van het veld discount is de korting in vaste prijs. Het weergegeven kortingspercentage wordt berekend. Indien de twee velden worden weergegeven, heeft het veld price_discount voorrang op het veld rate. Indien de discount onmiddellijk ingaat, is het niet nodig om het veld startdate in te geven. Als de tag sales staat aangevinkt, is deze aanbieding een sales aanbieding. Indien dat niet zo is, gaat het om een klassieke aanbieding. Deze parameter aanvinken laat toe een artikel te tonen op de pagina SALE tijdens de salesperiode.	Nee
selections	Geeft toegang om de gebruikerscontext van een product door middel van een id-lijst te specificeren. Het sjabloon voor de beschikbare contexten is hier te vinden.	Non

Voorbeeld van een XML parameter

<root>
	<products>
		<product>
			<reference_partenaire>98</reference_partenaire>
			<product_name><![CDATA[ALL STAR HI]]></product_name>
			<manufacturers_name><![CDATA[Converse]]></manufacturers_name>
			<product_sex>M</product_sex>
			<product_price>64.99</product_price>
			<product_quantity>5</product_quantity>
			<color_id>8</color_id>
			<product_style>10010</product_style>
			<product_description><![CDATA[Het meest mytische model van Converse, de Chuck Taylor All Star, is een must-have. 
Zie hier een hoge versie met een textielen schacht en een klassieke opdruk. Het is een tijdloos en modieus model!
]]></product_description>
			<product_color><![CDATA[Rood]]></product_color>
			<country_origin>73</country_origin>
			<code_hs>64059090</code_hs>
			<size_list>
			 <size>
				<size_name>38</size_name>
				<size_quantity>4</size_quantity>
				<size_reference>98_38</size_reference>
				<ean>123456789011></ean>
			 </size>
			 <size>
				<size_name>39</size_name>
				<size_quantity>1</size_quantity>
				<size_reference>98_39</size_reference>
				<ean>123456789012></ean>
			 </size>
			</size_list>
			<product_composition>4</product_composition>
			<photos>
				<url1>https://imgext.spartoo.com/photos/98/98/98_350_A.jpg</url1>
				<url2>https://imgext.spartoo.com/photos/98/98/98_350_B.jpg</url2>
				<url3>https://imgext.spartoo.com/photos/98/98/98_350_C.jpg</url3>
				<url4>https://imgext.spartoo.com/photos/98/98/98_350_D.jpg</url4>
				<url5>https://imgext.spartoo.com/photos/98/98/98_350_E.jpg</url5>
				<url6>https://imgext.spartoo.com/photos/98/98/98_350_F.jpg</url6>
				<url7>https://imgext.spartoo.com/photos/98/98/98_350_G.jpg</url7>
				<url8>https://imgext.spartoo.com/photos/98/98/98_350_H.jpg</url8>
			</photos>
			<discount>
				<startdate>1199170800</startdate>
				<stopdate>1204354800</stopdate>
				<rate>20</rate>
			</discount>
		</product>
	</products>
</root>

Formaat van de teruggestuurde XML data

<root>
	<products>
		<product>
			<reference_partenaire>string</reference_partenaire>
			<status>string</status>
			<action>string</action>
			<errors>
				<error>
					<id>int</id>
					<description>string</description>
					<level>string</level>
				</error>
				<!-- ... Meerdere afbakeningen "error" mogelijk ... -->
			</errors>
		</product>
		<!-- ... Meerdere afbakeningen "product" mogelijk ... -->
	</products>
	<errors>int</errors>
</root>

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
-15	Opmaakfout XML, gelieve uw bestand na te kijken
-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

Omschrijving van de velden van het XML antwoord

Tag	Omschrijving
reference_partenaire	Product ID van de verkoper
status	OK indien het product werd ingevoerd in de database KO indien het product niet kon worden ingevoerd
action	Lijst met mogelijke handelingen: created: het artikel is aangemaakt. not created: het artikel is niet aangemaakt. Opmerking: het is mogelijk dat een artikel de status OK heeft maar dat het niet is aangemaakt door een 'Warning'. updated: het artikel werd vernieuwd. not updated : het artikel werd niet vernieuwd. Opmerking: het is mogelijk dat een artikel de status OK heeft maar dat het niet vernieuwd werd door een 'Warning'.
errors	Lijst met fouten: id: code voor fout met product level: foutniveau Warning: verhindert de integratie van het product niet Fatal: blokkeert de integratie van het product omschrijving: tekstomschrijving van de fout

Lijst met codes van de productfouten

Code	Level	Description
1	Fatal	De partner referentie is niet lang genoeg
2	Fatal	De partner referentie is niet geldig, deze bestaat slechts uit alfanumerieke tekens
3	Warning	Productnaam is niet aangegeven
4	Fatal	Het merk is niet aangegeven
5	Fatal	Het type is niet geldig, u kunt alleen filteren op: H , F , M, K , G , B
6	Fatal	De prijs moet een cijfer zijn
7	Fatal	De prijs moet een positief cijfer zijn
8	Warning	De prijs lijkt ons erg hoog (> 1000 €)
195	Fatal	De nieuwe prijs mag niet meer dan xxx cijfers bevatten.
81	Fatal	De prijs kan niet hoger zijn dan 180.00 euro
9	Fatal	De hoeveelheid moet een heel getal zijn
10	Fatal	De hoeveelheid moet een positief getal zijn
11	Warning	De kleur xxx bestaat niet: u zult het product niet kunnen vinden met de filters
13	Fatal	De categorie xxx bestaat niet
14	Warning	De product omschrijving is leeg
15	Warning	De kleur omschrijving is leeg
16	Warning	Geen lijst met maten, gebruik slechts één maat
17	Warning	De samenstelling is aangegeven, maar niet geldig
18	Fatal	Foto 1 is verplicht
19	Warning	Het kortingspercentage moet tussen 0 en 100 liggen, de korting wordt niet in acht genomen
20	Warning	De maat xxx bestaat niet