Accueil > Intégration par flux CSV ou XML

Integration via CSV eller XML flow

Introduktion

Produkterne fra din hjemmeside kan integreres hos Spartoo i CSV- eller XML-format.
I det tilfælde skal CSV- eller XML-filen indeholde informationer om alle de produkter, der skal være tilgængelige på nettet via vores system.

Vores system downloader filerne ca. hver time og integrerer informationerne.
Filen skal være opdateret så vidt muligt for at undgå, at udgåede varer ikke vises på Spartoo.dk

Filen skal indeholde alle de nødvendige oplysninger, der kategoriserer produkterne og angiver lagerbeholdningen.

Hvert felt kan være obligatorisk, anbefalet eller valgfrit. Hvis et obligatorisk felt er tomt eller ukorrekt udfyldt, bliver produktet ikke integreret.
Længere nede kan du se eksempler på CSV- og XML-filer. Det er ikke påkrævet fra Spartoos side at bruge fileksemplet. Filen skal dog indeholde de obligatoriske informationer.

Ideelt set bør filen bruge UTF-8-kodning. Hvis det ikke er tilfældet, bedes du oplyse os om det, så vi kan konfigurere filen.
Til CSV-format bør semi-kolon ';' anvendes. Hvis det ikke er tilfældet, bedes du oplyse os om det, så vi kan konfigurere filen.

Hvis du ikke har en fildelingsserver (ftp-server), anbefaler Spartoo dig at anvende Dropbox.
flere oplysninger

Definition

Produkt eller Hovedprodukt : Hos Spartoo svarer et produkt til en model og en farve.
Så hvis modelen findes i to farver, svarer det til to produkter (der er altså to forskellige produktids til to forskellige farver)
Et produkt kan dog have flere forskellige størrelser.
Underprodukt: Hos Spartoo er et underprodukt et produkt i en specifik størrelse.
Så hvis et produkt har en farve og fås i to forskellige størrelser, er der to "underprodukter" (så et produktid og to underproduktids) Lagerbeholdningen skal være forbundet med et underprodukt. Det er den eneste information, der er obligatorisk for et underprodukt. De andre oplysninger berører hovedsagelig hovedprodukterne og kan undlades ved underprodukterne.

Liste over informationer

Feltets navn	Felt	Beskrivelse
SKU / ProduktID	Obligatorisk	SKU identificerer hvert underprodukt eller hovedprodukt. I tilfælde hvor det drejer sig om et SKU hovedprodukt, er det obligatorisk at anvende de tilladte tegn (a-z 0-9) Hvis det drejer sig om et SKU underprodukt, er dette felt ikke nødvendigt, og det kan indeholde enhver type tegn.
Hovedprodukt / Underprodukt	Obligatorisk for CSV	Dette felt er obligatorisk, når filen har én ligne per produkt eller én ligne per underprodukt I så fald bedes du give os mulighed for at skelne mellem et produkt og et underprodukt Feltet kan for eksempel indeholde "Hoved" for hovedprodukter og "Under" for underprodukter
SKU for hovedprodukt	Obligatorisk for CSV	Dette felt er obligatorisk, når filen har én ligne per produkt eller én ligne per underprodukt For hvert underprodukt skal vi kunne vide, hvilket hovedprodukt underproduktet hører til. Feltet bør indeholde produktID'et for hovedproduktet.
Modelnavn	Anbefalet	Dette felt bør kun indeholde modelnavnet, det må ikke indeholde andre informationer (kategori, farve, mærke)
Mærke	Obligatorisk
Køn	Obligatorisk	Køn. Venligst anvend følgende koder: H: Herre F: Dame M: Unisex voksen B: Dreng G: Pige K:Unisex børn
Produktets pris	Obligatorisk	Skal angives i 'DKK'. Prisen skal kun angives for hovedproduktet. Det er ikke muligt at indikere forskellige priser for underprodukter.
Kategori	Obligatorisk	Indeholder koden for produktets kategori. Hvis du ikke har Spartoos kode, kan du skrive navnet på kategorien. Du skal i det tilfælde bruge matching-værktøjet til kategorier for at matche dine kategorier med Spartoos kategorier. Se listen over kategorikoder
Udvalg	Valgfri	Gør det muligt at præcisere den typiske brug af produktet ud fra en liste med varenumre. Listen af disse sammenhænge er tilgængelige her
Nedsat pris	Anbefalet	Hvis feltet med rabat i % er udfyldt og dette ikke stemmer overens med den angivne pris, er det den nedsatte pris der gælder. Alle rabatter bliver afrundet (rundet ned) af Spartoo til nærmeste 5 %. For eksempel en rabat på 27 % bliver afrundet til 25%.
Procent-værdien	Anbefalet	Indeholder den ønskede procent-værdi.
Datoer for tilbud	Valgfri	Tilbud kan konfigureres med en startdato og en slutdato. Hvis du ikke angiver en dato, starter tilbuddet med det samme. I forbindelse med udsalg er det en god idé at angive startdatoen, så starter tilbuddet på det rigtige tidspunkt, uden at skulle vente på næste integration af filen.
Størrelse	Obligatorisk	Indeholder navnet på produktets størrelse. Hvis feltet ikke er synligt, eller hvis det er tomt, betegnes produktet som onesize. Hvis der er tale om tekstiler med US-størrelser, skal vi kunne se, om der er tale om en EU- eller en US-størrelse: enten ved at indikere US i størrelsesnavnet eller ved at tilføje et felt der angiver, om det er en US-størrelse eller ej.
Antal på lager	Obligatorisk	Lagerbeholdningen skal angives for hver størrelse. For at deaktivere et produkt skal lagerbeholdningen angives som 0. Når lagerbeholdningen er markeret med 0, er produktet deaktiveret og bliver ikke længere vist på Spartoo.
EAN	Obligatorisk	En international standardkode, der identificerer hvert enkelt produkt og gør det muligt at være integreret på google shopping og andre prisportaler.
Billeder	Obligatorisk	Der skal være mindst et billede. Vi anbefaler, at der er mindst 3 billeder. Vi kan maksimalt integrerer 8 billeder. Du skal sende os et link til billedet. Filnavnet må kun indeholde alfanumeriske tegn samt tegnene "-" (bindestreg), "_" (understregning) og "." (punktum). Trykstærke bogstaver (fx é, à og ñ) er ikke tilladt. Billedet bliver kun downloadet en gang og bliver derefter gemt på vores servere efter at være blevet tilpasset dimensionerne hos Spartoo. Billederne skal være i jpg-format, firkantede og minimum 350x350 pixels. Hvis de er større eller lig med 800x800 pixels, vil det være muligt at zoome på hjemmesiden.
Produktbeskrivelse	Anbefalet	Tekst, der beskriver produktet. Produktbeskrivelsen gør det muligt at tilføje et maksimum af information vedrørende produkterne, der vil hjælpe kunden med at tage en beslutning om et køb. En god produktbeskrivelse er detaljeret og specifik til hvert enkelt produkt. Derfor kan den indeholde modelnavn, mærke, farve, produktstil, materiale, etc. Det er ikke muligt at tilføje HTML-koder, undtagen punktet ved linjen: ' '. Javascript er ikke tilladt. Den vil kun blive vist på produktsiden.
Farvefilter	Anbefalet	Spartoos ID for farven. Anvendes til filtrene i søgemenuerne. Hvis ID'et ikke er oplyst, kan du i det tilfælde bruge matching-værktøjet til farver for at matche dine navne på farver med Spartoos farver. Se listen over farvekoder
Farve	Anbefalet	Tekstfelt til farve. Vises på produktsiden
Materiale	Valgfri	Gælder kun for sko. Vi kan integrere følgende 4 bestanddele: Overdelens materiale Forets materiale Indersålens materiale Ydersålens materiale Vi har ikke et matching-værktøj for materialer, så det er obligatorisk at anvende Spartoos koder. Se listen over materialekoder
Hælhøjde	Valgfri	Gælder kun for damesko (pumps, støvler etc....) Hælens højde i centimeter. Kun tallet skal angives, og der skal anvendes et komma for at adskille enheden fra decimaltallet (eksempel: 1,7).

Kun for fodtøj til kvinder (pumps, støvler osv.)
Hælhøjde i cm. Oprindelsesland Fakultativ Landets oprindelsesland
Se de mulige værdier Kode HS Fakultativ Produktets HS-kode til toldformål Yderligere oplysninger Fakultativ Liste over oplysningskoder adskilt med kommaer (ex: '120,521')
Se de mulige værdier Sæson Obligatorisk for MPO Produktets sæson, bestående af koden "EV" (efterår-vinter) eller "FS" (forår-sommer) efterfulgt af årstallet.
(ex: AH21, PE22)

Liste over oplysninger for XML-feeds

Nej / Ja

Kode	Beskrivelse	Obligatorisk
reference_partner	Forhandlerens produkt-id Det er den sku, der identificerer et produkt af et mærke i en bestemt farve Produkt-id'et kan kun indeholde alfanumeriske tegn såvel som - (bindestreg) _ (underscore) og . (punktum).	Ja
product_name	Modelnavn Må ikke indeholde kategorien, farven eller mærkets navn Må heller ikke indeholde html koder eller tegn	Nej
manufacturers_name	Navn på mærket produktet kommer fra	Ja
product_sex	Produktets køn > Se valgmulighederne	Ja
product_price	Produktets pris i euro (ikke obligatorisk for priser i størrelse)	Ja / Nej
color_id	Farve til søgning i menuen Hvis den ikke er angivet, bliver produktet ikke vist, hvis en kunde filtrerer på farven > Se valgmulighederne	Nej
product_style	Produktets kategori > Se valgmulighederne	Ja
product_description	Produktbeskrivelse. Vises på produktsiden.	Nej
product_color	Fritekst-felt til farve. Vises på produktsiden.	Nej
size	Liste over størrelser og deres lagerbeholdningen Valgfri for produkter i onesize (Tasker / Accessories). Ellers obligatorisk.	Ja / Nej
size_name lang="en"	Navn på engelsk størrelse Kun obligatorisk for blive registreret på den engelske hjemmeside spartoo.co.uk Mulige værdier
size_name	Navn på størrelsen > Se valgmulighederne	Ja
size_quantity	Lagerbeholdningen for denne størrelse	Ja
size_reference	Produktets størrelsesreference. Dette felt bruges kun til at returnere eksport af bestillinger og returanmodninger. Det er god praksis at generere denne reference ved at kombinere reference_partenaire og size_name ved at bruge underscore "_".	Nej
billeder	Liste over billeder og deres url. Mindst et billede er påkrævet. Vi anbefaler at have mindst 3 billeder. Vi kan højst integrere 8 billeder. Billedet vil kun blive downloadet en gang, hvorefter det blive opbevaret på vores servere, efter at være blevet redigeret til de dimensioner der bruges i Spartoo. Billederne skal være i jpg format, firkantede og i en opløsning på mindst 350x350 pixels. Hvis de har en opløsning på mindst 800x800 pixels, så vil der være en zoom-funktion på web-siden.	Ja
url1, url2 ... url8	Links til billederne Vi skal have et link til hvert billede. Filnavnet må kun indeholde alfanumeriske tegn samt tegn såsom "-" (bindestreg), "_" (underscore) og "." (punktum). Mellemrum samt bogstaver med accent (ex. é, à et ñ) er ikke tilladte.	Ja
heel_height	Hælhøjde i centimeter (cm). Kun til damesko. Skal være i hele eller halve centimeter (f. eks. 6 eller 6,5).
ean	Produktets EAN i forhold til størrelse	Nej
product_composition	Materialesammensætningen af produktets overdel. Gælder kun for sko > Se valgmulighederne	Nej
voering_composition	Materialesammensætningen af produktets for. Gælder kun for sko > Se valgmulighederne	Nej
first_composition	Materialesammensætningen af produktets indersål. Gælder kun for sko > Se valgmulighederne /td>	Nej
zool_composition	Materialesammensætningen af produktets ydersål. Gælder kun for sko > Se valgmulighederne	Nej
discount	Gør det muligt at tilføje en rabat på produktet eller en størrelse. Feltet rate fra feltet discount angiver den procentvise rabat i forhold til feltet product_price. Feltet price_discount fra feltet discount angiver den nedsatte pris på produktet. Rabatprocenten bliver regnet ud. Hvis du kan se begge felter, har price_discount feltet prioritet over rate feltet. Hvis rabatten skal være med øjeblikkelig virkning, behøves startdate feltet ikke udfyldes. Hvis feltet stopdate ikke udfyldes, vil kampagnens standardvarighed være en måned. Hvis du inkluderer sales-variablen, bliver rabatten betragtet som et udsalgsrabat. Ellers er det en normal rabat. Denne parameter gør det muligt at inkluderer en varer på siden med udsalgsvarer.	Nej
selections	Gør det muligt at præcisere den typiske brug af produktet ud fra en liste med varenumre. Listen af disse sammenhænge er tilgængelige her.	Nej

Format på XML-parametren

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

Format til et 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>
				<!-- ... Flere muligheder for "size"-kode ... -->
			</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>
				<!-- ... Flere muligheder for "info"-kode ... -->
			</extra_infos>
			<selections>
				<selection>int</selection>
				<!-- ... Flere muligheder for "selection"-kode ... -->
			</selections>
	   </product>
	   <!-- ... Flere muligheder for "product"-kode ... -->
   </products>
</root>

Format til flere lande

<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>
				<!-- ... Flere muligheder for "language"-kode ... -->
			</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>
						<!-- ... Flere muligheder for "language"-kode ... -->
					</languages>
				</size>
				<!-- ... Flere muligheder for "size"-kode ... -->
			</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>
				<!-- ... Flere muligheder for "info"-kode ... -->
			</extra_infos>
			 <selections>
				<selection>int</selection>
				<!-- ... Flere muligheder for "selection"-kode ... -->
			</selections>
	   </product>
	   <!-- ... Flere muligheder for "product"-kode ... -->
   </products>
</root>

Fileksempler

Liste over fejlkoder ifm. produkt

Code	Niveau	Beskrivelse
1	Fatal	Partnerreferencen er for kort
2	Fatal	Partnerreferencen er ugyldig, den må kun indeholde alfanumeriske tegn
3	Warning	Der er ikke noget navn på varen
4	Fatal	Der er ikke oplyst mærke
5	Fatal	Kønnet er ikke gyldigt, de eneste mulige værdier er: H, F, M, K, G, B
6	Fatal	Prisen skal være et tal
7	Fatal	Prisen er negativ eller ikke angivet
8	Warning	Prisen ser ud til at være for høj ( > 1000€ )
9	Fatal	Antallet skal være et helt tal
10	Fatal	Antallet skal være et positivt tal
11	Warning	Farven xxx findes ikke: varen vil ikke være synlig i farvefiltret
13	Fatal	Kategorien xxx findes ikke
14	Warning	Produktbeskrivelsen er tom
15	Warning	Feltet med farven til produktbeskrivelsen er tomt
16	Warning	Ingen størrelsesliste: brug one size
17	Warning	Materialet er oplyst, men er ikke gyldigt
18	Fatal	Billede 1 er obligatorisk
19	Warning	Procenten på rabatten skal være et tal imellem 0 og 100, rabatten vil ikke blive taget i betragtning
20	Warning	Størrelse xxx findes ikke længere
200	Fatal	Størrelsen xxx findes ikke for mærket xxx.
201	Fatal	EAN-koden er obligatorisk
202	Fatal	EAN-koden xxx på referencen xxx i størrelse xxx er allerede brugt af referencen på : xxx.
203	Warning	EAN-koden er for kort eller ender med "000".
204	Warning	EAN-koden xxx findes i flere eksemplarer i strømmen.
205	Fatal	Partnerreferencen er for lang
23	Warning	Billedet xxx er mindre end 350x350: det giver dårlig kvalitet på hjemmesiden
24	Warning	Billedet xxx er mindre end 350x350: det bliver ikke vist på hjemmesiden
25	Fatal	Størrelse xxx: umuligt at opdatere lageret
26	Fatal	Intet på lager: produktet vil ikke blive oprettet
27	Fatal	Umuligt at få adgang til billede 1 ( url xxx )
28	Warning	Umuligt at få adgang til billede xxx ( url xxx )
281	Fatal	Foto for stort (xxxo)
30	Fatal	Antallet af varer i størrelse xxx er for højt (max. antal: xxx)
31	Warning	Din konto er ikke aktiveret på hjemmesiden xxx
32	Fatal	Der blev ikke fundet oplysninger om dette produkt på det pågældende land.
33	Fatal	Et produkt xxx kan ikke tilhøre kategorien xxx
34	Fatal	Ordet xxx er blacklistet og bør ikke forekomme i produktnavnet eller beskrivelsen.
35	Fatal	Produktnavnet er for langt, det skal blot indeholde navnet på modellen. Fejl vedrørende land(e): xxx
341	Fatal	Ordet xxx er blacklistet og bør ikke vises i produktbeskrivelsen.
36	Fatal	Umuligt at importere produktet: Produktet har en duplikat i relationen størrelse/farve.
38	Fatal	Størrelse xxx kan kun defineres én gang til produkt-idxxx
39	Warning	Partnerreferencen findes flere gange i dit feed. De ekstra kopier ignoreres.
42	Warning	Sæsonen er ikke gældende.
43	Warning	Produktinformation xxx svarer til en product_type= xxx og ikke xxx.
44	Warning	Kategorien xxx svarer ikke til en produkttype xxx.
451	Fatal	Ingen pris for størrelse xxx i land xxx. (påkrævet for at få rabat)
452	Warning	Slutdato for rabatten overskredet for størrelsen xxx i landet xxx.
453	Fatal	"sats" (xxx) ugyldig for størrelsen xxx i landet xxx.
454	Fatal	"sats" (xxx) > 85% for størrelsen xxx i landet xxx.
455	Warning	Størrelsen xxx har en pris i et land (xxx), der ikke er defineret for produktet.
456	Warning	Størrelsen xxx har en pris på xxx, der er identisk med den globale pris i dette land.