Accueil > Intégration par flux CSV ou XML

Integratie per flux CSV of XML

Inleiding

De producten van uw website kunnen op Spartoo geïntegreerd worden in de vorm van een CSV of XML databestand.
Het CSV of XML bestand met al de informatie over uw producten dient in dat geval toegankelijk te zijn op internet voor onze robot.

Onze robot zal ongeveer één keer per uur dit bestand laden en de informatie die erin te vinden is integreren.
Het bestand dient zo actueel mogelijk te zijn om te voorkomen dat uitgeputte artikelen nog op Spartoo aangeboden worden.

Het bestand dient al de gegevens te bevatten die nodig zijn om uw producten te kunnen klasseren en om uw voorraad bij te kunnen houden.

Elk veld kan verplicht, aanbevolen of facultatief zijn. Indien een verplicht veld leeg of niet goed ingevuld is, zal het product niet geïntegreerd worden.
U vindt hieronder een aantal voorbeelden van CSV of XML bestanden. Spartoo legt geen model van bestand op. Uw bestand dient echter wel al de nodige gegevens te bevatten.

Uw bestand dient idealiter de encodering UTF-8 te gebruiken. In andere gevallen verzoeken wij u ons op de hoogte te brengen zodat wij de behandeling van uw bestand kunnen configureren.
CSV bestanden dienen de punt-komma te gebruiken ';'. In andere gevallen verzoeken wij u ons op de hoogte te brengen zodat wij de behandeling van uw bestand kunnen configureren..

Als u nog geen bestandsserver deelt (ftp server) adviseert Spartoo Dropbox te gebruiken.
meer informatie

Omschrijving

Product of Hoofdproduct : Voor Spartoo komt een product overeen met een model en een kleur.
Voor een model waarvan er twee kleuren beschikbaar zijn, zullen er dus twee producten zijn (dus twee verschillende productreferenties)
Een product kan wel in verschillende maten beschikbaar zijn.
Deelproduct : Voor Spartoo komt een deelproduct overeen met een product en een andere maat.
Voor een model waarvan er één kleur en twee maten beschikbaar zijn, zullen er dus twee "deelproducten" zijn (dus één productreferentie en twee deelproduct referenties)
De voorraad dient verplicht gekoppeld te zijn aan het deelproduct. Dat is dan ook de enige verplichte informatie over deelproducten. Andere gegevens gaan vooral over de hoofdproducten en mogen opengelaten worden voor deelproducten.

Overzicht informatie voor flux CSV

Naam veld	Veld	Omschrijving
SKU / Productreferentie	Verplicht	Het veld kan SKU kind of ouder bevatten. In het geval dat het een SKU ouder bevat, is het veld verplicht en mag het alleen alfanumerieke karakters bevatten. Als het een SKU kind bevat, is het veld niet verplicht en kan het zowel alfanumerieke karakters bevatten als de karakters - (streepje) _ (laag streepje) en . (punt). Er kan een referentie opgegeven worden voor elk deelproduct (bijvoorbeeld de EAN code), maar dat is niet verplicht.
Hoofd/Deel	Verplicht voor CSV	Dit veld is verplicht indien het bestand een regel per product bevat en een regel per deelproduct In dat geval dient u ons een middel aan te reiken om hoofd- of deelproducten te onderscheiden Dit veld kan bijvoorbeeld "Hoofd" bevatten voor hoofdproducten en "Deel" voor deelproducten
Hoofd SKU	Verplicht voor CSV	Dit veld is verplicht indien het bestand een regel per product bevat en een regel per deelproduct Voor elk deelproduct moet duidelijk zijn met welk hoofdproduct het deelproduct overeenkomt. Dit veld dient dus de productreferentie van het hoofdproduct te bevatten.
Naam van het model	Aanbevolen	Er dienen geen andere gegevens vermeld te zijn (de categorie, kleur of merk van het product)
Naam van het merk	Verplicht
Geslacht	Verplicht	Geslacht van het product. Idealiter deze codes te gebruiken: H: Heren F: Dames M: Mix volwassenen B: Jongens G: Meisjes K: Mix kinderen
Prijs van het product	Verplicht	Dient verplicht vermeld te zijn in 'EUR'. De prijs geldt enkel voor het hoofdproduct. Het is niet mogelijk om andere prijzen op te geven voor deelproducten.
Categorie	Verplicht	Bevat de code van de categorie van het product. Bedankt om de macro-categorieën te vermijden (in het rood) en preciezer te richten op de andere categorieën. Indien u de Spartoo code niet kunt opgeven, kunt u de naam van de categorie opgeven. U dient dan de matching tool voor categorieën te gebruiken om uw categorieën overeen te doen komen met die van Spartoo. Bekijk de lijst met al de categoriecodes
Selectie	Facultatief	Staat toe om de context van de gebruikswijze van het product door middel van een id-lijst te specificeren. Alle contexten zijn hier beschikbaar.
Kortingsprijs	Aanbevolen	Dit houdt de nieuwe prijs na aftrek van de korting in. Als de kortingspercentage is ingevoerd en deze komt niet overeen met de kortingsprijs, wordt de kortingsprijs gehanteerd.
Kortingspercentage	Aanbevolen	Bevat het gewenste kortingspercentage. Alle kortingen worden door Spartoo afgerond (naar beneden) naar een veelvoud van 5%. Een korting van 27% zal bijvoorbeeld afgerond worden naar 25%.
Soort korting	Aanbevolen	Als de promotie een type uitverkoop is, dien je dit uit leggen in het bijbehorende veld.
Data promoties	Facultatief	U kunt een begin- en einddatum instellen voor promoties. Indien de data niet worden opgegeven, gaat de promotie onmiddellijk van start. Tijdens de sale kan het handig zijn om de begindatum van de promotie in te geven zodat de kortingen op het juiste moment ingaan, zonder de volgende integratie van het bestand dienen af te wachten.
Maat	Verplicht	Bevat de naam van de maat van het product. Indien het veld ontbreekt of leeg is, nemen we aan dat er maar één maat is voor dit product (ons size). Indien het om US textiel maten gaat, dient er een manier te zijn dat wij weten of het om een EU of US maat gaat: ofwel US aangeven in de naam van de maat, ofwel een veld toevoegen die aangeeft of de maat US is of niet.
Aantal op voorraad	Verplicht	De voorraad dient voor elke maat aangegeven te zijn. Om een product te desactiveren, dient u de voorraad op 0 te zetten. Wanneer de voorraad 0 is, staat het product op non-actief en verschijnt het niet meer op Spartoo.
EAN	Obligatoire	Code standard international qui identifie chaque produit et qui permet d’être présent sur google shopping et d’autres comparateurs de prix.
Foto's	Verplicht	Minstens één foto is verplicht. De bestandsnaam mag alleen aflanumerieke karakters te bevatten evenals karakters als "-" (tiret), "_" (tiret bas) en "." (point). Geaccuenteerde letters (bv. é, à nt ñ) zijn niet toegestaan. Wij raden aan om minstens 3 foto's te plaatsen. Wij kunnen maximum 8 foto's integreren. U dient ons de link naar de foto te bezorgen. De foto wordt maar één keer gedownload, wordt bewerkt naar de afmetingen van Spartoo en wordt daarna opgeslagen op onze servers. De foto's dienen opgemaakt te zijn in jpg formaat, vierkant van vorm te zijn en in minimum 350x350 pixels. Indien de kwaliteit van de foto's hoger is dan of gelijk aan 800x800 pixels, is een zoom op de website mogelijk.
Productinformatie	Aanbevolen	MPDOC_INTEG_LIST_INFO
Filter kleur	Aanbevolen	Tekstomschrijving van het product. De productomschrijving voegt zoveel mogelijk productinformatie toe om de klant te helpen een aankoopbeslissing te nemen. Een goede productbeschrijving is gedetailleerd en specifiek voor elk product. Hiervoor kan het de naam van het model, het merk, de kleur, de stijl van het product, het materiaal, enz. bevatten. Het is niet mogelijk om HTML in te voegen. JavaScript is niet toegestaan. Het is alleen zichtbaar op het productblad.
Kleur	Aanbevolen	Tekstveld voor kleur. Dit is zichtbaar in de productfiche.
Samenstelling	Facultatief	Enkel voor schoenen. We kunnen 4 verschillende samenstellingen integreren: Samenstelling schacht Samenstelling binnenvoering Samenstelling binnenzool Samenstelling buitenzool We hebben geen matching tool voor de samenstellingen, u dient dus de codes van Spartoo te gebruiken. Bekijk de lijst met al de codes betreffende samenstelling
Hakhoogte	Facultatief	Enkel voor damesschoenen (pumps, boots, etc ... ) Hoogte van de hak in cm.
Land van herkomst	Aanbevolen	Land van herkomst Zie mogelijke waarden
Code HS	Aanbevolen	De HS code van het product voor de douane
Aanvullende informatie	Aanbevolen	Lijst met door komma's gescheiden informatiecodes (ex: '120,521') Zie de mogelijk waarden
Seizoen	verplicht voor MPO	Seizoen van product bestaat uit een code "AH" (Herfst-Winter) of "PE" (Lente-Zomer) gevolgd door het jaar (ex: AH21, PE22)

Informatielijst voor de XML flux

/Nee

Tag	Omschrijving	Verplicht
reference_partenaire	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 (niet vereist voor maatprijzen)	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

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>
			<code_idu>string</code_idu>
			<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 tags "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 tags "info" mogelijk ... -->
			</extra_infos>
			<selections>
				<selection>int</selection>
				<!-- ... Meerdere tags "selection" mogelijk ... -->
			</selections>
	   </product>
	   <!-- ... Meerdere tags "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>
					<code_idu>string</code_idu>
					<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 tags "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 tags "language" mogelijk ... -->
					</languages>
				</size>
				<!-- ... Meerdere tags "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 tags "info" mogelijk ... -->
			</extra_infos>
			 <selections>
				<selection>int</selection>
				<!-- ... Meerdere tags "selection" mogelijk ... -->
			</selections>
	   </product>
	   <!-- ... Meerdere tags "product" mogelijk ... -->
   </products>
</root>

Voorbeelden van bestanden

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 )
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
200	Fatal	De maat xxx bestaat niet voor het merk xxx.
201	Fatal	De code EAN is verplicht
202	Fatal	De EAN-code xxx op de referentie xxx in maat xxx wordt al gebruikt.
203	Warning	De code EAN is heel kort of eindigt op '000'
204	Warning	De code EAN xxx bestaat in verschillende kopieën in de flux.
205	Fatal	Partnerreferentie te lang
23	Warning	Het formaat van de foto xxx is kleiner dan 350x350: dit zal een beeld van slechte kwaliteit opleveren op de website
24	Warning	Het formaat van de foto xxx is kleiner dan 350x350: deze zal niet afgebeeld worden op de website
25	Fatal	Maat xxx: Onmogelijk de voorraad te regulariseren
26	Fatal	Geen voorraad: het product zal niet worden aagemaakt
27	Fatal	Onmogelijk foto 1 (url xxx) te bekijken
28	Warning	Onmogelijk foto xxx (url xxx) te bekijken
281	Fatal	Foto te zwaar (xxxo)
30	Fatal	Het aantal van deze maat xxx is te groot (Quantité max : xxx)
31	Warning	Je account is niet op de site xxx geactiveerd
32	Fatal	Er is geen Nederlandstalige informatie beschikbaar voor dit product
33	Fatal	Een product van genre xxx kan niet behoren tot de categorie xxx
34	Fatal	Het woord xxx is geblokkeerd en zal niet meer in beeld komen.
35	Fatal	Productnaam te lang, mag alleen modelnaam bevatten. Fout(en) in land(en): xxx
341	Fatal	Het woord xxx is geblokkeerd en zal niet meer in beeld verschijnen bij de beschrijving van het product.
36	Fatal	Kan het product niet importeren: het product heeft een duplicatie van het maat / kleur-paar.
38	Fatal	De maat xxx kan slechts eenmaal worden gedefinieerd met referentie xxx
39	Warning	The partner reference is present several times in the flow, duplicates have been ignored
42	Warning	Het seizoen is niet geldig.
43	Warning	De productinformatie xxx komt overeen met een product_type = xxx en niet xxx.
44	Warning	De categorie xxx komt niet overeen met een product type xxx.
451	Fatal	Geen prijs voor de maat xxx van land xxx. (nodig voor een korting)
452	Warning	De einddatum van de korting is overschreden voor maat xxx van land xxx.
453	Fatal	"tarief" (xxx) ongeldig voor maat xxx van land xxx.
454	Fatal	"tarief" (xxx) > 85% voor maat xxx van land xxx.
455	Warning	De maat xxx heeft een prijs in een land (xxx) dat niet is gedefinieerd voor het product.
456	Warning	De maat xxx heeft een prijs xxx identiek aan de totale prijs in dit land.