Import af produkter

URL til Webservices : https://sws.spartoo.dk/mp/xml_import_products.php

Liste over parametre

parametrene for denne webservice skal sendes i POST

Parametre beskrivelse partner Skal indeholde dine bruger-oplysninger : xml Kæden af XML tegn skal indeholde en række elementer til oprettelse og opdatering

Valgfrie Parametre der kan sendes i POST

Parametre Beskrivelse force_beskrivelse Sæt til 1 hvis man ønsker en opdatering af produktbeskrivelserne: slet de eksisterende beskrivelser, rediger beskrivelsen af et produkt der ikke er på lager, osv. force_overwrite Sæt til 1 hvis man ønsker at fjerne lagerfejl fra kataloget. Sørg for at sende resten af kataloget uden overskrivning umiddelbart derefter.

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

Beskrivelse af felterne i XML

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

Eksempel på xml-parametre

<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[Chuck Taylor All Star fra Converse er en legendarisk model, der ikke er til at komme uden om. 
Her er den i høj version med overdel i ensfarvet tekstil, der både gør den tidløs og klassisk!
]]></product_description>
			<product_color><![CDATA[Rød]]></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>

Det returnerede XML-format

<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>
				<!-- ... Flere muligheder for "error"-kode ... -->
			</errors>
		</product>
		<!-- ... Flere muligheder for "product"-kode ... -->
	</products>
	<errors>int</errors>
</root>

Liste over fejlkoder hos webservices

Kode (kategori, materiale)	Beskrivelse
1	Ingen fejlparametrer
-1	Parameteren partenaire er ikke blevet registreret eller er tom
-2	Forhandlerens parametre eksisterer ikke
-11	Parameteren xml er ikke blevet registreret eller er tom
-15	XML-syntaksfejl, tjek din XML-fil
-428	Din konto er deaktiveret. Du kan ikke længere benytte webservices
-429	Du har overskredet brugen af denne webservice inden for den seneste time

Beskrivelse af svarfelterne i XML

Kode	Beskrivelse
reference_partenaire	Forhandlerens produktid
status	OK hvis produktet er integreret i databasen KO hvis produktet ikke er integreret
action	Mulige aktioner: created: produktet er oprettet. not created: produktet er ikke oprettet. NB! et produkt kan have status 'OK' uden at være oprettet som følge af en eller flere 'Warning'. updated: produktet er opdateret. not updated: produktet er ikke opdateret. NB! et produkt kan have status 'OK' uden at være opdateret som følge af en eller flere 'Warning'.
fejl	Liste over fejlregistreringer: id : produktets fejlkode level: fejlniveau Warning: forhindrer ikke integrationen af produktet Fatal: blokerer integrationen af produktet beskrivelse: tekstbeskrivelse af fejlen

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€ )
81	Fatal	Prisen må ikke være over 180€ / 1350 DKK
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
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.
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 )
30	Fatal	Antallet af varer i størrelse xxx er for højt (max. antal: xxx)
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.
37	Fatal	Dette produkt indeholder ingen sprogoplysninger.
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.
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.

Eksempel på retur-XML

Prøvesvar på et opkald til webservicen KO :

<root>
	<products></products>
	<errors>-1</errors>
</root>

Prøvesvar på et opkald til webservicen OK :

<root>
	<products>
		<product>
		<reference_partenaire>EEAJBCC</reference_partenaire>
		<status>KO</status>
		<action>not created</action>
		<errors>
			<error>
				<id>14</id>
				<description>Produktbeskrivelsen er tom  </description>
				<level>warning</level>
			</error>
			<error>
				<id>4</id>
				<description>Der er ikke oplyst mærke</description>
				<level>fatal</level>
			</error>
		</errors>
		</product>
		<product>
			<reference_partenaire>KJHGFDS</reference_partenaire>
			<status>OK</status>
			<action>created</action>
		</product>
	</products>
	<errors>1</errors>
</root>

Filer XSD

Filer XSD Multi lande