Accueil > Intégration par flux CSV ou XML

Integracija tok CSV ali XML

Predstavitev

Izdelke vašega spletnega mesta je mogoče integrirati v Spartoo s pomočjo vira CSV ali XML.
V tem primeru mora biti našemu robotu omogočeno spletno dostopanje do datoteke CSV ali XML, ki vsebujeta podatke o vseh vaših izdelkih.

Naš robot bo datoteke prenašal približno enkrat na uro in vključeval informacije, ki so v datotekah.
Datoteka mora biti čim bolj posodobljena. Tako lahko preprečimo, da bi se razprodani izdelki še vedno pojavljali na Spartoo.

Datoteka mora vsebovati vse informacije, potrebne za kategorizacijo vaših izdelkov in količinsko opredelitev vaših zalog.

Vsako polje je lahko obvezno, priporočeno ali neobvezno. Če je eno od obveznih polj prazno ali nepravilno izpolnjeno, izdelek ne bo integriran.
Spodaj boste našli nekaj predlog datotek CSV ali XML. Spartoo ne zahteva posebnega modela datoteke. Vaša datoteka pa mora vsebovati vse obvezne podatke.

Idealno bi bilo, da vaša datoteka uporablja kodiranje UTF-8. V nasprotnem primeru nam sporočite, da bomo konfigurirali obdelavo datoteke.
Za datoteke CSV mora datoteka uporabljati podpičje ';'. V nasprotnem primeru nam sporočite, da bomo konfigurirali obdelavo datoteke.


Če nimate strežnika za skupno rabo datotek (ftp strežnik), Spartoo priporoča uporabo Dropboxa.
plus d'information

Definicija

  • Izdelek ou «Produit parent» : Na Spartoo, en izdelek ustreza enemu modelu in barvi.
    Torej, za model, ki ima dve barvi, bosta dva izdelka (torej dva različna identifikatorja izdelka)
    Po drugi strani pa ima izdelek lahko več velikosti.

  • "Produit enfant": Na Spartoo, izdelek "enfant" ustreza točno določenemu izdelku in velikosti.
    Torej, za model, ki ima eno barvo in dve velikosti, bosta obstajala dva "produit enfant" ( torej en identifikator izdelka in dva podrejena identifikatorja izdelka "produit enfant")
    Zaloga mora biti obvezno povezana z "produit enfant". To so poleg tega edini obvezni podatki za otroške izdelke. Preostali podatki se v glavnem nanašajo na matične izdelke (produits parents) in jih lahko izpustite za "produit enfant".

    Seznam informacij o viru CSV

    Ime polja Polje Opis
    SKU/ID izdelka Obvezno To polje vsebuje vrednost »parent SKU« za zgornje vrstice in »child sku« za spodnje vrstice.
    "Zgornja številka" mora vsebovati samo alfanumerične znake (a-Z 0-9 . _ -). Presledki niso dovoljeni.
    "Otrok sku" lahko vsebuje katero koli vrsto znaka.
    Starš / Otrok Potrebno za CSV To polje je obvezno, če datoteka vsebuje eno vrstico na izdelek in eno vrstico na podrejeni izdelek
    V tem primeru moramo zagotoviti sredstvo za identifikacijo, ali je izdelek linijski ali podrejeni izdelek
    To polje lahko na primer vsebuje »Parent« za nadrejene izdelke in »Child« za podrejene izdelke
    Parent SKU Potrebno za CSV To polje je obvezno, če datoteka vsebuje eno vrstico na izdelek in eno vrstico na podrejeni izdelek
    Za vsak podrejeni izdelek je treba vedeti, kateri nadrejeni izdelek ustreza podrejenemu izdelku.
    To polje mora zato vsebovati identifikator matičnega izdelka.
    Ime modela Priporočeno To polje mora vsebovati samo ime modela, ne sme vsebovati drugih informacij (kategorija, barva, znamka)
    Blagovna znamka Obvezno
    Koda IDU Priporočeno To polje vsebuje IDU kodo izdelka (glejte zakon AGEC)
    Spol Obvezno Kategorija izdelka. Uporabiti morate naslednje kode:
    • M: moški
    • Ž: ženska
    • M: Za vse odrasle
    • B: Fant
    • G: Dekle
    • K : Za oba spola
    Cena izdelka Obvezno Mora biti v valuti 'EUR'.
    Cena velja samo za matični izdelek. Za otroške izdelke ni mogoče imeti različnih cen.
    Kategorija Obvezno Vsebuje kodo kategorije izdelka. Izogibajte se večjim kategorijam (rdeče) in dajte prednost bolj specifičnim.
    Če nam ne morete posredovati kode Spartoo, lahko vnesete ime kategorije. Nato boste morali uporabiti orodje za ujemanje kategorij, da svoje izbrane kategorije povežete z ustreznimi kategorijami Spartoo.

    Oglejte si seznam vseh kod kategorij
    Izbire Izbirno Omogoča določitev konteksta uporabe izdelka s seznama ID-jev.
    Nabor razpoložljivega konteksta je na voljo tukaj
    Cena s popustom Priporočeno Vsebuje znižano ceno izdelka.
    Če je višina popusta izpolnjena in se ne ujema s ceno s popustom, se upošteva cena s popustom.
    Višina popusta Priporočeno Vsebuje želeno višino popusta.
    Vsi popusti bodo zaokroženi (navzdol) za Spartoo v korakih po 5 %. Na primer, višina popusta 27 % bo zaokrožena na 25 %.
    Vrsta popusta Priporočeno Če je promocija vrsta razprodaje, jo je treba navesti v tem polju.
    Datumi promocije Izbirno Promocije je mogoče prilagajati z začetnim in končnim datumom.
    Če ti datumi niso navedeni, se bo promocija začela takoj.
    Za razprodaje je lahko zanimivo navesti datum začetka promocije, popusti se bodo tako začeli neposredno ob pravem času, ne da bi morali čakati na naslednjo integracijo datoteke.
    Velikost Obvezno Vsebuje velikost izdelka.
    Če polja ni ali če je prazno, se šteje, da ima izdelek univerzalno velikost.
    V primeru velikosti tekstila v ZDA potrebujemo način, kako ugotoviti, ali je velikost EU ali ZDA: navedite US v imenu velikosti ali dodajte polje, ki označuje, ali je velikost US ali ne.
    Količina na zalogi Obvezno Za vsako velikost je treba navesti zalogo.
    Za deaktivacijo izdelka mora biti zaloga nastavljena na 0.
    Ko je zaloga 0, je izdelek deaktiviran in ni več prikazan na Spartoo.
    EAN Obvezno Mednarodna standardna koda, ki identificira vsak izdelek in mu omogoča, da je prisoten na Google nakupovanju in drugih primerjalnikih cen.
    Slike Obvezno Vsaj ena fotografija je obvezna.
    Priporočamo vsaj 3 fotografije. Integriramo lahko največ 8 fotografij.
    Posredovati nam morate povezavo do fotografije. Ime datoteke mora vsebovati samo alfanumerične znake ter znake "-" (pomišljaj), "_" (podčrtaj) In "." (točka). Pozor: presledki v imenu datoteke niso dovoljeni, prav tako ne naglašene črke (npr. é, à in ñ).
    Fotografija bo naložena samo enkrat in nato shranjena na naših strežnikih, potem ko bo spremenjena v dimenzijah Spartoo.
    Fotografije morajo biti v formatu jpg, kvadratne in velikosti najmanj 350x350 slikovnih pik. Če so večje ali enake 800 x 800 slikovnih pik, bo na spletnem mestu možna povečava.
    Opis izdelka Priporočeno Besedni opis izdelka.
    Opis izdelka vam omogoča, da dodate čim več informacij o izdelkih, ki lahko kupcu pomagajo pri odločitvi o nakupu.
    Dober opis izdelka je podroben in specifičen za vsak izdelek. Za to lahko vsebuje ime modela, blagovno znamko, barvo, stil izdelka, material itd.
    HTML-ja ni mogoče vstaviti, razen pike v vrstici: <br>, ainsi que <b>, <i> et <u>. JavaScript ni dovoljen.
    Vidno bo samo na listi izdelka.
    Barva filtra Priporočeno Identifikator Spartoo za barvo. Uporablja se za filtre menijev.
    Če ta identifikator ni na voljo, je mogoče uporabiti orodje za ujemanje barv, da uskladite imena svojih barv s shranjenimi barvami Spartoo.

    Oglejte si seznam vseh barvnih kod
    Barva Priporočeno Besedilno polje za barvo. Bo prikazano na strani izdelka
    Sestave Izbirno Samo za čevlje.
    Združimo lahko 4 različne sestave:
    • Osnovna sestava
    • Sestava podloge
    • Sestava vložka
    • Sestava zunanjega podplata
    Nimamo orodja za ujemanje sestave, zato morate uporabiti kode Spartoo.

    Oglejte si seznam vseh kod sestave
    Višina pete Izbirno Samo za izdelke ženske obutve (čolnarke, škornji itd.)
    Višina pete v centimetrih. Navesti morate samo število in uporabiti piko, da ločite enoto od decimalnih mest (primer: 1,7)
    Država izvora Izbirno Država izvora države
    Oglejte si možne vrednosti
    Oznaka HS Izbirno Oznaka HS izdelka za carino
    Dodatne informacije Izbirno Seznam informacijskih kod, ločenih z vejico (npr. '120,521')
    Oglejte si možne vrednosti
    Sezona Obvezno za MPO Sezona izdelka, sestavljena iz kode "AH" (jesen-zima) ali "PE" (pomlad-poletje), ki ji sledi leto.
    (ex: AH21, PE22)

    Seznam informacij za vire XML

    Oznaka Opis Obvezno
    partner_reference Identifikator izdelka trgovca. To je šifra, ki identificira izdelek blagovne znamke v določeni barvi
    Identifikator izdelka lahko vsebuje samo alfanumerične znake ter znake - (vezaj) _ (pomišljaj) in . (točka).     		Da
    ime_izdelka Ime modela
    Ne sme vsebovati kategorije, barve ali znamke izdelka
    Prav tako ne sme vsebovati html znakov ali oznak
    		 Ne
    ime_proizvajalca Blagovna znamka izdelka Da
    idu_code IDU koda izdelka (glejte zakon AGEC) Ne
    product_sex Spol izdelka
    > Oglejte si možne vrednosti     		Da
    cena_izdelka Cena izdelka v evrih (ni obvezno za cene velikosti) Da /Ne
    barva_id Barva za menijske filtre
    Če ni navedeno, izdelek ne bo izstopal, če kupec uporabi barvni filter
    > Oglejte si možne vrednosti     		Ne
    slog_izdelka Kategorija izdelka
    > Oglejte si možne vrednosti     		Da
    opis_izdelka Opis izdelka. Pojavi se na listu izdelka. Ne
    barva_izdelka Prosto besedilno polje za barvo. Pojavi se na listu izdelka. Ne
    količina_izdelka Skupna zaloga izdelka
    Prezrto, če je za izdelek zaznana ena ali več oznak size_quantity.
    Za izdelke ene velikosti je zahtevana oznaka product_quantity, če oznaka size_quantity ni določena.     		Ne
    velikost Seznam velikosti in njihova zaloga.
    Izbirno za izdelke brez velikosti (torbe/dodatki). V nasprotnem primeru obvezno.     		Da / Ne
    ime_velikosti Ime velikosti
    > Oglejte si možne vrednosti     		Da
    velikost_količina Za vsako velikost je treba navesti zalogo.
    Če želite deaktivirati izdelek, morate zalogo nastaviti na 0.
    Ko je zaloga 0, je izdelek deaktiviran in ni več prikazan na Spartoo.     		Da
    size_reference Sklicevanje na velikost izdelka.
    To polje se uporablja samo za vrnitev v izvozih naročil ali vračilih. Dobra praksa je, da to referenco ustvarite tako, da polji reference_partenaire in size_name združite s podčrtajem »_«.     		Ne
    ean EAN izdelka glede na velikost
    Obvezno za logistično storitev    		 Ne / Da
    fotografije Seznam fotografij in njihov URL.
    Zahtevana je vsaj ena fotografija.
    Priporočamo vsaj 3 fotografije. Vključimo lahko največ 8 fotografij.
    Fotografija bo naložena samo enkrat, nato pa bo shranjena na naših strežnikih, potem ko bo spremenjena na dimenzije Spartoo.
    Fotografije morajo biti v formatu jpg, kvadratne in velikosti najmanj 350x350 slikovnih pik. Če so večje ali enake 800 x 800 slikovnih pik, bo na spletnem mestu možno povečavo.     		Da
    url1, url2 ... url8 Povezave do fotografij
    Posredovati nam morate povezavo do vsake fotografije. Ime datoteke mora vsebovati samo alfanumerične znake ter znake "-" (pomišljaj), "_" (podpomišljaj) In "." (točka). Presledki in naglašene črke (npr. é, à in ñ) niso dovoljeni.     		Da
    država_porekla Država porekla izdelka
    > Oglejte si možne vrednosti     		Ne
    code_hs Carinska oznaka izdelka Ne
    višina_pete Višina pete v centimetrih (cm). Samo za ženske čevlje. Za ločevanje enote od decimalk morate uporabiti piko (na primer: 1,5). Ne
    sestava_izdelka Sestava stebla izdelka. Samo za čevlje in torbe
    > Oglejte si možne vrednosti     		Ne
    voering_composition Sestava obloge izdelka. Samo za čevlje in torbe
    > Oglejte si možne vrednosti     		Ne
    prva_sestava Sestava vložka izdelka. Samo za čevlje
    > Oglejte si možne vrednosti     		Ne
    zool_composition Sestava podplata izdelka. Samo za čevlje
    > Oglejte si možne vrednosti     		Ne
    popust Omogoča uporabo promocije za izdelek ali velikost izdelka.
    Polje stopnja v polju popust zadeva znižanje cene v odstotkih v primerjavi s poljem product_price.
    Polje price_discount v polju discount se nanaša na znižano ceno izdelka. Prikazan odstotek popusta bo izračunan.
    Če sta prisotni obe polji, ima polje price_discount prednost pred poljem rate.
    Če je popust takojšen, polja začetni datum ni treba navesti. Če polje datum konca ni določeno, bo promocija privzeto trajala en mesec. Če je navedena oznaka sales, bo promocija prodajna promocija. V nasprotnem primeru bo šlo za klasično napredovanje. Določanje tega parametra omogoča, da so izdelki prisotni na prodajni strani med prodajnimi obdobji.     		Ne
    dodatne_informacije Omogoča podajanje dodatnih informacij glede na vrsto izdelka.
    Vsaka informacija je sestavljena iz ID-ja ( > Glej vrednosti ) in vrednosti v številčni obliki.     		Ne
    izbire Omogoča vam, da določite kontekste uporabe izdelka s seznamom ID-jev.
    Ves razpoložljiv kontekst je na voljo tukaj.     		Ne


    Format parametrov XML


    Besedilna polja je treba zaščititi z oznakami balises CDATA če vsebujejo posebne znake, zaradi katerih bi bil XML neveljaven.

    Format za eno državo

    <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>
				<!-- ... Več možnih oznak "size" ... -->
			</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>
				<!-- ... Več možnih oznak "info" ... -->
			</extra_infos>
			<selections>
				<selection>int</selection>
				<!-- ... Več možnih oznak "selection" ... -->
			</selections>
	   </product>
	   <!-- ... Več možnih oznak "product" ... -->
   </products>
</root>


    Format za več držav

    <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>
				<!-- ... Več možnih oznak "language" ... -->
			</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>
						<!-- ... Več možnih oznak "language" ... -->
					</languages>
				</size>
				<!-- ... Več možnih oznak "size" ... -->
			</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>
				<!-- ... Več možnih oznak "info" ... -->
			</extra_infos>
			 <selections>
				<selection>int</selection>
				<!-- ... Več možnih oznak "selection" ... -->
			</selections>
	   </product>
	   <!-- ... Več možnih oznak "product" ... -->
   </products>
</root>


    Primeri map

    Mape CSV

    Fichier CSV avec produit parent / produit enfant classique

    Fichier CSV Multi pays

    Mapa XML

    Exemple de fichier XML

    Fichiers XSD

    Fichier XSD Multi pays

    Seznam kod za napake spletnih storitev


    Koda Raven Opis
    1 Fatal Referenca partnerja ni dovolj dolga
    2 Fatal Referenca partnerja ni veljavna, vsebuje lahko le alfanumerični znake (črke in številke)
    3 Warning Ime izdelka ni določeno
    4 Fatal Znamka ni določena
    5 Fatal Spol ni veljaven, edine mogoče vrednosti so: H, F, M, K, G, B
    6 Fatal Cena mora biti zapisana v številkah
    7 Fatal cena je negativna ali ni navedena
    8 Warning Cena se nam zdi visoka ( > 1000€ )
    9 Fatal Količina mora biti celo število
    10 Fatal Količina mora biti pozitivna
    11 Warning Barva xxx ne obstaja: izdelek ne bo na voljo preko barvnih filtrov
    13 Fatal Kategorija xxx ne obstaja
    14 Warning Opis izdelka je prazen
    15 Warning Barva prikaza je prazna
    16 Warning Ni seznama velikosti: uporaba unikatne velikosti
    17 Warning Sestava je navedena, vendar ni veljavna
    18 Fatal Fotografija 1 je obvezna
    19 Warning Stopnja popusta promocije mora biti med 0 in 100, sicer promocija ne bo upoštevana
    20 Warning Velikost xxx ne obstaja
    200 Fatal Velikost xxx ne obstaja za znamko xxx.
    201 Fatal Koda EAN (črtna koda) je obvezna
    202 Fatal EAN kodo xxx na sklicu xxx v velikosti xxx že uporablja ref: xxx.
    203 Warning Koda EAN je prekratka ali se konča z "000"
    204 Warning Koda EAN xxx obstaja v toku v več kopijah.
    205 Fatal Predolga referenca
    23 Warning Fotografija xxx je manjša od 350x350 : na spletni strani bo slabe kakovosti
    24 Warning Fotografija xxx je manjša od 350x350, zaradi tega ne bo prikazana na spletni strani
    25 Fatal Velikost xxx : Ni mogoče urediti zalog
    26 Fatal Ni zalog: izdelek ne bo ustvarjen
    27 Fatal Ni mogoče dostopati do fotografije 1 ( url xxx )
    28 Warning Ni mogoče dostopati do fotografije xxx ( url xxx )
    281 Fatal Fotografija je prevelika (xxxo)
    30 Fatal Količina velikosti xxx je previsoka (maksimalna kvantiteta: xxx)
    31 Warning Vaš račun ni aktiviran na strani xxx
    32 Fatal za to državo ni bilo najdenih informacij o izdelku
    33 Fatal Izdelek xxx spol ne more pripadati kategoriji xxx
    34 Fatal Beseda xxx je na črnem seznamu in se ne sme pojaviti v imenu ali opisu izdelka.
    35 Fatal Ime izdelka je predolgo, vsebovati mora le ime modela. Napaka(-e) v zvezi z državo(-ami): xxx
    341 Fatal Beseda xxx je na black listi in se ne sme pojaviti v opisu izdelka.
    36 Fatal Ta izdelek je nemogoče dodati, ker gre za dvojni vnos velikosti/barve.
    38 Fatal Velikost xxx je lahko le enkrat opredeljena z referenco xxx
    39 Warning Referenca partnerskega prodajalca je ponovljena večkrat, dvojniki bodo ignorirani.
    42 Warning Sezona ni veljavna.
    43 Warning Informacija o izdelku xxx ustreza tipu izdelka = xxx in ne xxx.
    44 Warning Kategorija xxx ne ustreza vrsti izdelka xxx, temveč xxx.
    451 Fatal Ni cene za velikost xxx države xxx. (nujno za popust)
    452 Warning Končni datum za popust je bil presežen za velikost xxx države xxx.
    453 Fatal "stopnja" (xxx) neveljavna za velikost xxx države xxx.
    454 Fatal "stopnja" (xxx) > 85% za velikost xxx države xxx.
    455 Warning Velikost xxx ima ceno v državi(xxx), ki ni določena za izdelek.
    456 Warning Velikost xxx ima ceno na xxx, ki je enaka svetovni ceni v tej državi.