Accueil > Intégration par flux CSV ou XML

Integrare cu flux CSV sau XML

Introducere

Produsele site-ului vostru pot fi integrate pe Spartoo cu flux CSV sau XML.
În acest caz, fișierul CSV sau XML conținând informațiile referitoare la toate produsele trebuie să fie accesibil pe web de către robotul nostru.

Robotul nostru va veni și va descărca aproximativ din oră în oră fișierul și va integra informațiile din interiorul acestuia.
Fișierul trebuie să fie actualizat cât mai repede posibil pentru a evita ca produsele epuizate să nu mai figureze pe Spartoo.

Fișierul trebuie să conțină toate informațiile necesare la categorisirea produselor voastre și la cuantificarea stocurile.

Fiecare câmp poate fi obligatoriu, recomandat sau facultativ. Dcaă unul dintre câmpurile obligatorii este vid sau completat greșit, produsul nu va fi integrat.
Veți găsi mai jos, câteva modele de fișier CSV sau XML. Modelul de fișier nu este impus la Spartoo. Cu toate acestea, fișierul vostru trebuie să cuprindă toate informațiile obligatorii.

În mod ideal, fișierul trebuie să utilizeze codificarea UTF-8.În caz contrar,vă rugăm anunțați-ne,pentru a configura procesarea fișierului.
Pentru fișierele CSV, fișierul trebuie să folosească punct și virgulă';'. În caz contrar, vă rugăm anunțați-ne pentru a configura procesarea fișierului.

Dacă nu dispuneți de un server de partajare de fișier (server ftp)Spartoo vă recomandă utilizarea Dropbox.
plus de informații

Definiție

Produs sau Produs parent : Pentru Spartoo, un produs corespunde unui model și unei culori.
Deci pentru modelul care are 2 culori, vor exista 2 produse ( prin urmare două id-uri produse diferite )
Cu toate acestea, un produs poate avea mai multe mărimi.
Produs child : Pentru Spartoo, un produs child corespunde unui produs și o mărime distinctă.
Deci pentru modelul care are o culoare și două mărimi, vor fi două "produse copii" ( prin urmare un singur id produs și două id-uri produs child )
Stocul trebuie să fie asociat în mod obligatoriu produsului child,este singura informație obligatorie pentru produsele child. Celelalte informații în principal se referă la produsele parents și pot fi omise pentru produsele child.

Lista de informații pentru flux CSV

Numele câmpului	Câmp	Descriere
SKU / Identificator produs	Obligatoriu	SKU identifică fiecare produs parent. Poate conține numai caractere alfanumerice precum și caracterele - (cratimă) _ (cratima de jos) și (punct). Se poate furniza un identificator pentru fiecare produs copil ( de exemplu, codul EAN ), dar nu este obligatoriu.
Parent / Child	Obligatoriu pentru CSV	Acest câmp este obligatoriu în cazul în care fișierul conține o linie pentru fiecare produs și o linie pentru fiecare produs copil În acest caz trebuie să ne furnizați un mijloc de identificare dacă linia este un produs sau un produs child Acest câmp poate conține de exemplu "Parent" pentru produsele parents și "Child" pentru produsele copii
Parent SKU	Obligatoriu pentru CSV	Acest câmp este obligatoriu în cazul în care fișierul conține o linie pentru fiecare produs și o linie pentru fiecare produs copil Pentru fiecare produs copil, trebuie să cunoaștem la ce produs parent corespunde produsul child. Acest câmp trebuie să conțină identificatorul produs al produsului parent.
Numele modelului	Recomandat	Acest câmp trebuiă să cuprindă doar numele modelului, el nu trebuie să conțină alte informații (categorie, culoare, brand)
Numele brandului	Obligatoriu
Code IDU	Recomandat	Ce champ contient le code IDU du produit (voir loi AGEC)	Tip	Obligatoriu	Tip de produs. În mod ideal, utilizați următoarele coduri: H : Bărbați F : Femei M : Adult mixed B : Băieți G : Fete K : Copii mixed
Prețul produit	Obligatoriu	Este obligatoriu să fie în în valută 'RON'. Prețul nu se aplică numai pentru produsele parent. Este imposibil de a avea prețuri diferite pentru produsele copii.
Categorie	Obligatoriu	Include codul categoriei produsului. Evitați categoriile macro (în roșu) și acordați prioritate celorlalți, mai precise. În cazul în care nune puteți furniza codul Spartoo, puteți introduce numele categoriei. Este necesar să folosiți dispozitivul de matching al categoriilor pentru corelarea categoriilor voastre cu categoriile Spartoo. Vizualizați lista de tuturor codurilor de categorii
Pret discount	Recomandat	Include prețul discount al produsului. Dacă rata de discount este respectată și că nu corepunde prețului redus, atunci prețul redus este ales
Rata de discount	Recomandat	Include rata de discount dorită. Toate reducerile vor fi rotunjite ( reduceri mai mici ) la Spartoo cu creșteri de 5%. De exemplu, o rată de de discount de 27% va fi rotunjită până la 25%.
Rata discount	Recomandat	În cazul în care o promoție este de tipul soldărilor, trebuie precizat în acest câmp.
Date de promoții	Facultativ	Promoțiile pot fi configurate cu o dată de deschidere și o dată de finală. În cazul în care aceste date nu sunt precizate, promoția începe imediat. Acest lucru poate fi interesant pentru perioada de solduri de a indica data de începere a promoțiilor,reducerile vor începe direct la ora corespunzătoare, fără afi nevoie să așteptați integrarea următorului fișier.
Mărimea	Obligatoriu	Include numele dela mărimea produsului. Dacă câmpul este absent sau el este gol, produsul va fi considerat ca având o mărime unică. În cazul mărimilor textile US,avem nevoie de o modalitate de a cunoaște dacă mărimea este EU sau US : fie indicați US la numele mărimii, ssau adăugați un câmp care indică că mărimea este US sau nu.
Cantitate în stoc	Obligatoriu	Pentru fiecare mărime, stocul trebuie precizat. Pentru a dezactiva un produs, stocul trebuie pus la 0. Când stocul este 0, produsul este dezactivat și nu mai apare la Spartoo.
EAN	Obligatoriu	Codul standard international care identifică fiecare produs și care permite prezența sa pe google shopping și alți comparatori de prețuri.
Fotografii	Obligatoriu	Cel puțin o fotografie este obligatorie. Noi recomandă să aveți cel puțin 3 fotografii. Noi putem integra maximum 8 fotografii. Trebuie s ne furnizați link-ul către fotografie. Fotografia va fi descărcată doar o singură dată, apoi ea va fi stocată pe serverele noastre, după care va fi redimensionată după dimensiunile Spartoo. Fotografiile trebuie să aibă un format jpg, pătrate și de cel puțin 350x350 pixeli. Dacă ele elles sunt mai mari sau egale cu 800x800 pixeli, va exista un zoom posibil pe site.
Descriere produs	Recomandat	Descriere text produs. Nu este posibil să inserați cod HTML, cu excepția punctului din linie: , ,precum si , și . Javascript nu este permis. Acesta va fi vizibil numai pe fișa produsului.
Culoare filtrului	Recomandat	Id-il Spartoo pentru culoare. Utilizat pentri filtrele din meniu. Dacă acest identificator nu este furnizat,este posibilitate să utilizați dispozitivul de matching culori pentru corelarea numelui culorilor voastre scu culorile Spartoo. Vizualizați lista pentru toate codurile de culori
Culoare	Recomandat	Câmp text pentru culoare. Va fi afișat pe foaia produsului.
Compoziții	Facultativ	Doar pentru les încălțăminte. Putem integra 4 compoziții diferite : Compoziția față exterioară Compoziția căptușeală Compoziția tălpii interioare Compoziția tălpii exterioare Noi nu avem dispozitiv de matching pentru compoziții, ca prin urmare este obligatoriu să utilizați codurile Spartoo. Vizualizați lista tuturor codurilor de compoziție
Înălțimea tocului	Facultativ	Doar pentru produsele de încălțăminte femei ( pantofi cu toc, cizme, etc ... ) Înălțimea tocului în centimetri. Se indică numai numărul și se folosește un punct pentru a separa unitatea de zecimală (exemplu: 1,7).
Țara de origine	Opțional	Țara de origine a țării Consultați valorile posibile
Cod HS	Opțional	Codul HS al produsului pentru uz vamal
Informații adiționale	Opțional	Listă de coduri de informații separate prin virgula (ex: '120,521') Consultați valorile posibile
Sezon	Obligatoriu pentru MPO	Sezonul produsului, format din codul "AH" (toamnă-iarnă) sau "PE" (primăvară-vară), urmat de an. (ex: AH21, PE22)

Lista de informații pentru fluxurile XML

Balise	Descriere	Obligattoriu
reference_partenaire	Codul de identificare al produsului furnizorului. Acesta este codul SKU care identifică un produs al unui brand într-o anumită culoare Codul de identificare al produsului poate conține doar caractere alfanumerice, precum și caracterele - (tiret) _ (tiret bas) et . (point).	Oui
product_name	Numele modeluui INu trebuie să conțină categoria, culoarea sau marca produsului De asemenea, nu trebuie să conțină caractere sau elemente html	Nu
manufacturers_name	Numele brandului produsuluit	Oui
code_idu	Code IDU de la produs (vezi legea AGEC)	Non
product_sex	Sex produs > Vezi valorile posibile	Oui
product_price	Prețul produsului în euro (nu este obligatoriu pentru prețurile pe mărimi)	Oui / Non
color_id	Culoare destinată filtrelor din meniuri Dacă nu este specificată, produsul nu va apărea în rezultatele căutării dacă un client utilizează un filtru după culoare > Vezi valorile posibile	Nu
product_style	Categoria produsului > Vezi valorile posibile	Oui
product_description	Descrierea produsului permite adăugarea unui număr cât mai mare de informații despre produse, care pot ajuta clientul să ia decizia de achiziție. Une bonne description produit est détaillée et spécifique pour chaque produit. În acest scop, ea poate conține denumirea modelului, marca, culoarea, stilul produsului, materialul etc. Il n'est pas possible d'y insérer de l'HTML, à l’exception du saut à la ligne: , " ", ainsi que , "", "" et . JavaScript nu este permis. Aceasta va fi vizibilă doar pe pagina produsului. Numărul maxim de caractere este de 65 000.	Nu
product_color	Câmp de text liber pentru culoare. Apare pe fișa produsului.	Nu
product_quantity	Stocul total al unui produs Se ignoră dacă se detectează una sau mai multe etichete size_quantity pentru produs. Pentru produsele cu mărime unică, este obligatorie prezența unei etichete product_quantity dacă baliza size_quantity nu este specificată..	Nu
size	Liste des tailles et leur stock. Facultatif pour les produits sans tailles ( Sacs / Accessoires ). Obligatoire Sinon.	Oui / Non
size_name	Nom de la taille > Voir les valeurs possibles	Oui
size_quantity	Pentru fiecare mărime, trebuie specificat stocul disponibil. Pentru a dezactiva un produs, trebuie să setați stocul la 0. Când stocul ajunge la 0, produsul este dezactivat și nu mai apare pe Spartoo.	Oui
size_reference	Referința produsului în funcție de mărime. Acest câmp este destinat exclusiv includerii în fișierele de export ale comenzilor sau retururilor.. O bună practică este generarea acestei referințe prin concatenarea câmpurilor reference_partenaire și size_name ” folosind o liniuță de jos "_".	Nu
ean	EAN de la produs la mărime Obligatoriu pentru prestarea serviciilor logistice	Non / Oui
foto	Lista fotografiilor și adresele URL ale acestora. Este obligatorie cel puțin o fotografie. Vă recomandăm să aveți cel puțin 3 fotografii. Putem include maximum 8 fotografii Fotografia va fi încărcată o singură dată, apoi va fi stocată pe serverele noastre, după ce va fi redimensionată la dimensiunile Spartoo. Fotografiile trebuie să fie în format jpg, pătrate și să aibă cel puțin 350x350 pixeli. Dacă au dimensiuni mai mari sau egale cu 800x800 pixeli, pe site va fi posibilă mărirea imaginii.	Oui
url1, url2 ... url8	Linkuri către fotografii Trebuie să ne furnizați un link către fiecare fotografie. Numele fișierului trebuie să conțină numai caractere alfanumerice, precum și caracterele „-” (liniuță), „_” (liniuță de subliniere) și „.” (punct). Spațiile, precum și literele accentuate (de exemplu, é, à și ñ) nu sunt permise.	Oui
country_origin	Țara de origine a produsului > Vezi valorile posibile	Non
code_hs	Codul vamal al produsului	Nu
heel_height	Înălțimea tocului în centimetri (cm). Valabil numai pentru încălțămintea de damă. Trebuie să folosiți un punct pentru a separa unitatea de zecimale (de exemplu: 1,5).	No
product_composition	Compoziția tălpii produsului. Numai pentru încălțăminte și genți > Vezi valorile posibile	Non
voering_composition	Compoziția căptușelii produsului. Valabil numai pentru încălțăminte și genți > Vezi valorile posibile	Non
first_composition	Compoziția tălpii interioare a produsului. Numai pentru încălțăminte > Vezi valorile posibile	Non
zool_composition	Compoziția tălpii exterioare a produsului. Numai pentru încălțăminte > Voir les valeurs possibles	Non
discount	Permite aplicarea unei promoții la produs sau la o mărime. Campul rate din campul discount se referă la reducerea procentuală a prețului față de valoarea de referință product_price. Campul price_discount du champ discount se referă la prețul redus al produsului. Procentul de reducere afișat va fi calculat. Dacă ambele câmpuri sunt prezente, câmpul price_discount are prioritate față de câmpul rate. Dacă reducerea este aplicată imediat, nu este necesar să se precizeze câmpul startdate. Dacăcampul stopdate dacă nu se specifică altfel, promoția va avea o durată implicită de o lună. Daca baliza sales este specificat, promoția va fi una de lichidare de stoc. În caz contrar, va fi o promoție clasică. Setarea acestui parametru permite afișarea produselor pe pagina de lichidare de stoc în perioadele de lichidare de stoc. (1 corespunde unei categorii de lichidare de stoc, iar 0 unei categorii de reduceri obișnuite)	Non
extra_infos	Permet de spécifier des informations complémentaires dépendantes du type de produit. Chaque information est constitué d'un id ( > Voir les valeurs ) et d'une valeur sous forme numérique.	Non
languages	Permite gestionarea distribuției în mai multe țări și specificarea datelor traduse, precum și a prețurilor diferite în funcție de țară (denumirea produsului, descrierea, prețul de bază, culoarea, codul IDU și promoția)). Fiecare bloc conține una sau mai multe etichete language caracterizate printr-un code de țară/limbă obligatorie (ex: FR, IT, DE, etc.). Gestionarea în funcție de mărime : Această etichetă poate fi adăugată și sub fiecare etichetă size pour appliquer des prix et des promotions spécifiques par taille et par pays. Reguli esențiale de comportament : • Stocuri globale : Nu este posibil să se gestioneze cantități diferite pentru fiecare țară. Stocul (cantitatea) rămâne strict global la nivel de dimensiune. • Dezactivarea produsului pe țări : Dacă o țară/limbă este eliminată din bloc languages la nivelul produsului (de exemplu: eticheta FR este prezentă, dar eticheta IT lipsește), produsul va fi dezactivat automat (retras) pentru această țară. • Retragerea unei țări de pe o mărime: Dacă o țară este exclusă din bloc languages la nivelul unei mărimi (de exemplu, mărimea 42), dar acea țară rămâne activă la nivelul general al produsului, mărimea 42 nu va fi dezactivată pentru aceasta țara, Ea va rămâne disponibilă la vânzare, dar nu va mai avea prețul specific pentru mărimea respectivă și se va alinia automat, în mod implicit (fallback), la prețul general al produsuluit (product_price) definit pentru această țară. Pentru a dezactiva complet o mărime, trebuie să setați stocul total al acesteia la 0.	Non

Format parametru xml

Câmpurile de text trebuie să fie protejate de balize CDATA dacă conține caractere speciale care ar putea face XML invalid.

Format mono country

<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>0/1</sales>
					</discount>
				</size>
				<!-- ... Mai multe balize "size" posibile ... -->
			</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>
				<!-- ... Mai multe balize "info" posibile ... -->
			</extra_infos>
	   </product>
	   <!-- ... Mai multe balize "product" posibile ... -->
   </products>
</root>

Format multi-țară

<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>0/1</sales>
					</discount>
				</language>
				<!-- ... Mai multe balize "language" posibile ... -->
			</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>0/1</sales>
							</discount>
						</language>
						<!-- ... Mai multe balize "language" posibile ... -->
					</languages>
				</size>
				<!-- ... Mai multe balize "size" posibile ... -->
			</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>
				<!-- ... Mai multe balize "info" posibile ... -->
			</extra_infos>
	   </product>
	   <!-- ... Mai multe balize "product" posibile ... -->
   </products>
</root>

Exemple de fișiere

Lista codurilor de eroare a produsului

Cod	Level	Descriere
1	Fatal	Referința partenerului nu este suficient de lungă
2	Fatal	Referința vânzător nu este validă, aceasta poate conține numai caractere alfanumerice
3	Warning	Numele produsului nu este specificat
4	Fatal	Brandul nu este specificat
5	Fatal	Stilul nu este valid, singurele valori posibile sunt: : H, F, M, K, G, B
6	Fatal	Prețul trebuie să fie un număr
7	Fatal	Prețul este negativ sau nu este indicat
8	Warning	Prețul pare foarte mare ( > 5000 Lei )
195	Fatal	Noul preț nu poate conține mai mult de xxx cifre
9	Fatal	Cantitatea trebuie să fie un număr întreg
10	Fatal	Cantitatea trebuie să fie pozitivă
11	Warning	Culoarea xxx nu există :produsul nu va fi disponibil utilizânf filtrele de culoare
13	Fatal	Categoria xxx nu există
14	Warning
15	Warning
16	Warning	Nici o listă de mărimi : utilizare mărime unică
17	Warning	Compoziția este specificată, dar nu este validă
18	Fatal	Fotografia 1 este obligatorie
19	Warning	Rata de discount a promoției trebuie să fie cuprinsă între 0 și 100, dacă nu promoția nu va fi luată în considerare
20	Warning	Mărimea xxx nu există
200	Warning	Mărimea xxx nu există pentru brandul xxx.
201	Fatal	Codul EAN este obligatoriu
202	Fatal	Codul EAN xxx de la referința xxx de mărime xxx este deja utilizat de către ref: xxx.
203	Warning	Codul EAN este prea scurt sau se termină cu "000".
204	Warning	Codul EAN xxx există în mai multe exemplare în flux.
205	Fatal	Referința partenerului este prea lungă
23	Warning	Fotografia xxx este mai mică decât 350x350 : ea va avea o calitate inferioară pe site
24	Warning	Fotografia xxx este mai mică decât 350x350 : aceasta nu va fi afișată pe site
25	Fatal	Taille xxx :
26	Fatal	Nu există stoc: produsul nu va fi conceput
27	Fatal	Nu se poate accesa la fotografia 1( url xxx )
28	Warning	Nu se poate accesa la fotografia xxx ( url xxx )
30	Fatal	Cantitatea mărimii xxx este prea mare (Cantitate max : xxx)
31	Warning	Contul vostru nu este activat pe site xxx
32	Fatal	Nici o informație de localizare pentru acest produs pentru această țară.
33	Fatal	Un produs de genul xxx nu poate aparține categoriei xxx
34	Fatal	Cuvântul xxx este în blacklist și nu trebuie să apară în denumirea sau descrierea produsului.
35	Fatal	Numele produsului este prea lung, trebuie să conțină doar numele modelului. Eroare (erori) la țara (țări): xxx
341	Fatal	Termenul xxx este în blacklist și nu trebuie să apară în descrierea produsului
36	Fatal	Imposibil de a importa produsul: produsul are deja o duplicare mărime / culoare.
38	Fatal	Mărimea xxx poate fi setată o singură dată pentru referința xxx
39	Warning	Referința partenerului este prezentă de mai multe ori în flux, duplicatele au fost ignorate
42	Warning	Sezonul nu este valid.
43	Warning	Informațiile privind produsul xxx corespunde unui product_type = xxx și nu xxx.
44	Warning	Categoria xxx nu corespunde la niciun tip de produs xxx dar xxx.
451	Fatal	Fara preț pentru marime xxx din tara xxx. (necesar pentru o reducere)
452	Warning	Data de încheiere a reducerii a fost depășită pentru mărimi xxx din țară xxx.
453	Fatal	"rată" (xxx) invalid pentru mărime xxx din țară xxx.
454	Fatal	"rată" (xxx) > 85% pentru mărime xxx din țară xxx.
455	Warning	Mărimea xxxare un preț într-o o țară (xxx)nu este definit pentru produs .
456	Warning	Mărimea xxx are un preț pe xxx identic cu prețul total din această țară .
194	Fatal	Căderea noului preț nu poate fi mai mare decât xxx%
54	warning	Mărimile pentru copii (xxx) nu pot fi atribuite pentru adulți ( F, B).

Saitoo - Assistant

⛶

Bonjour ! Comment puis-je vous aider aujourd'hui ?