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.
mai multe 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
Selecții	Facultativ	Permite specificarea contextelor de utilizare a produsului prin intermediul unei liste id Ansamblul contextului disponibil este furnizat ici
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: <br>, ainsi que <b>, <i> et <u> . 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	Obligatoriu
reference_partenaire	Identificator produs vânzător. Este sku-ul care identifică un produs al unui brand într-o culoare precisă Identificatorul produsului trebuie să conțină numai caractere alfanumerice precum și caractere - (cratimă) _ (cratimă jos) și . (punct).	Da
product_name	Numele modelului Nu trebuie să conțină categoria, culoarea sau brandul produsului Nu trebuie să conțină nici caractere sau nici balize html	Nu
manufacturers_name	Numele de brand al produsului	Da
cod_idu	Codul IDU al produsului (a se vedea Actul AGEC)	Nu
product_sex	Sex produs > Vizualizați valorile posibile	Da
product_price	Prețul produsului în euro	Da
color_id	Culoare destinată filtrelor din meniu Dacă ea nu este specificată, produsul nu va apărea dacă un client utilizează un filtru de culoare > Vedeți valorile posibile	Nu
product_style	Categoria produsului > Vedeți valorile posibile	Da
product_description	Descriptiv produs. Apare în fișa produsului.	Nu
product_color	Câmp text liber pentru culoare. Apare în fișa produsului.	Nu
product_quantity	Stocul total al produsului Ignorat dacă una sau mai multe balize size_quantity sunt detectate pentru produs. Pentru produsele cu mărime unică este nevoie obligatoriu de o baliză product_quantity dacă baliza size_quantity nu a fost furnizată.	Nu
size	Lista de mărimi și stocurile acestora. Facultativ pentru produsele fără mărimi (Genți / Accesorii). Obligatoriu În caz contrar.	Da / Non
size_name	Nume mărime > Vedeți valorile posibile	Da
size_quantity	Stoc produs pentru această mărime	Da
size_reference	Referință produs la mărime. Acest câmp este utilizat numai pentru a returna în exporturi comenzile sau returnările. Este o bună practică de a genera această referință prin concatenarea câmpurilor reference_partenaire și size_name cu ajutorul unei liniuțe jos "_".	Nu
ean	EAN de la produs la mărime Obligatoriu pentru serviciul de logistică	Nu
photos	Lista fotografiilor și adresa URL a acestora. Cel puțin o fotografie este obligatorie. Vă recomandăm să aveți cel puțin 3 fotografii. Putem integra maxim 8 fotografii. Fotografia va fi incărcată o singură dată, apoi stocată pe serverele noastre după redimensionarea după dimensiunile Spartoo. Fotografiile trebuie să fie în format jpg, pătrat și de minim 350x350 pixeli. Dacă acestea sunt mai mari sau egale cu 800x800 pixeli, va exista un posibil zoom pe site.	Da
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 "-" (cratime), "_" (subliniere) și „.” (Dot). Spațiile precum și literele accentuate (de exemplu é, à și ñ) nu sunt permise	Da
heel_height	Înălțimea tocului în centimetri (cm). Numai pentru încălțămintea pentru femei. Trebuie să fie un multiplu de 0,5.	No
product_composition	Compoziția părții exterioare a produsului, doar pentru încălțăminte și genți > Vedeți valorile posibile	Non
voering_composition	Compoziția căptușelii produsului. Doar pentru încălțăminte și genți > Vedeți valorile posibile	No
first_composition	Compoziția tălpii interioare a produsului. Doar pentru încălțăminte > Vedeți valorile posibile	Nu
zool_composition	Compoziția tălpii exterioare a produsului. Doar pentru încălțăminte > Vedeți valorile posibile	Nu
discount	Permite aplicarea unei promoții la produs. Câmpul rate din câmp discount se referă la reducerea prețului procentual în raport cu câmpul product_price. Câmpulprice_discount din câmp discount se referă la prețul redus al produsului. Procetajul de reducere afișat va fi calculat. Dacă ambele câmpuri sunt prezente, câmpul price_discount are prioritate pe câmpul rate. Dacă discount-ul este imediat, nu este nevoie să specificați câmpul startdate. Daca campulstopdate nu este specificat, durata predefinită a promoției va fi de o lună. Dacă baliza sales este precizată, promoția va fi o promoție de solduri. În caz contrar, va fi o promoție clasică. Specificând acest parametru va permite produselor să fie prezente pe pagina de solduri pe durata perioadelor de solduri.	Nu
extra_infos	Permite specificarea informațiile suplimentare în funcție de tipul de produs. Fiecare informație este constituită dintr-un id ( > Vedeți valorile ) și de o valoare sub formă digitală.	Nu
selecții	Permite specificarea contextelor de utilizares a produsului prin intermediul unei liste de id. Ansamblul contextului disponibil este furnizat aici.	Nu

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>
				</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>
			<selections>
				<selection>int</selection>
				<!-- ... Mai multe balize "selection" posibile ... -->
			</selections>
	   </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 />
					</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>
				</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>
			 <selections>
				<selection>int</selection>
				<!-- ... Mai multe balize "selection" posibile ... -->
			</selections>
	   </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 )
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	Fatal	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.
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 acesta trebuie să conțină numai numele modelului.
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ă .