Documentație XML Ceneo

Documentație fișier XML – format Ceneo

Informații importante despre variante:
În acest fișier, un produs apare ca o singură poziție <o>, iar informațiile despre mărimi și cantitățile variantelor sunt transmise în interiorul secțiunii <attrs> în câmpurile Rozmiar și RozmiarIlosc.

Structura fișierului

Fișierul constă din elementul principal <offers>, în care se află lista de produse ca elemente <o>.

Fiecare element <o> conține date de bază în atribute și detalii în câmpurile: <cat>, <n>, <imgs>, <desc>, <attrs>.

Exemplu de structură fișier XML în standardul Ceneo

Mai jos se află un fragment de exemplu dintr-un fișier XML. Codul este afișat în formă tehnică și poate fi copiat.

<?xml version="1.0" encoding="UTF-8"?>
<offers xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="1">

	<o id="2063" url="https://www.numoco.com/p2063,478-1-maya-sukienka-z-dluzszym-tylem-dekoltem-i-paskiem-r-owe-kwiaty.html" price="166.99" avail="1" stock="48">
		<cat>
		  <![CDATA[ Moda damska / Sukienki ]]>
		</cat>
		<n>
		  <![CDATA[ 478-1 MAYA Sukienka z dłuższym tyłem, dekoltem i paskiem - RÓŻOWE KWIATY ]]>
		</n>
		<imgs>
		  <main url="https://www.numoco.com/galerie/4/478-1-maya-sukienka-z-dluzszy_15067.jpg"/>
		  <i url="https://www.numoco.com/galerie/4/478-1-maya-sukienka-z-dluzszy_15068.jpg"/>
		  <i url="https://www.numoco.com/galerie/4/478-1-maya-sukienka-z-dluzszy_15066.jpg"/>
		  <i url="https://www.numoco.com/galerie/4/478-1-maya-sukienka-z-dluzszy_15069.jpg"/>
		  <i url="https://www.numoco.com/galerie/4/478-1-maya-sukienka-z-dluzszy_15070.jpg"/>
		  <i url="https://www.numoco.com/galerie/4/478-1-maya-sukienka-z-dluzszy_15064.jpg"/>
		  <i url="https://www.numoco.com/galerie/4/478-1-maya-sukienka-z-dluzszy_15065.jpg"/>
		</imgs>
		<desc>
		  <![CDATA[ Maya - asymetryczna <strong>sukienka z dłuższym tyłem</strong>, dekoltem i paskiem. Wzór: różowe kwiaty na miętowym tle. Spódnica z dłuższym tyłem sprawdzi się idealnie w tańcu. Produkcja polska. Marka <strong>Numoco</strong>. <div class="sizes">Wymiary mierzone są na płasko - bez rozciągania materiału (+/- 2 cm)<br>Modelka na zdjęciu ma 170cm wzrostu i ma ubrany rozm. XS.</div> ]]>
		</desc>
		<attrs>
		  <a name="Producent">
			<![CDATA[ numoco ]]>
		  </a>
		  <a name="Kod_producenta">
			<![CDATA[ 478-1 ]]>
		  </a>
		  <a name="EAN">
			<![CDATA[ 5903133885887 ]]>
		  </a>
		  <a name="Rozmiar">
			<![CDATA[ L;M;S;XL ]]>
		  </a>
		  <a name="RozmiarIlosc">
			<![CDATA[ L:6;M:8;S:10;XL:24 ]]>
		  </a>
		</attrs>
	</o>
	<o id="2065" url="https://www.numoco.com/p2065,465-2-mia-plisowana-sukienka-midi-z-szerokim-paskiem-be-owa.html" price="79.99" avail="1" stock="77">
		<cat>
		  <![CDATA[ Moda damska / Sukienki ]]>
		</cat>
		<n>
		  <![CDATA[ 465-2 MIA Plisowana sukienka midi z szerokim paskiem - BEŻOWA ]]>
		</n>
		<imgs>
		  <main url="https://www.numoco.com/galerie/4/465-2-mia-plisowana-sukienka_15080.jpg"/>
		  <i url="https://www.numoco.com/galerie/4/465-2-mia-plisowana-sukienka_15079.jpg"/>
		  <i url="https://www.numoco.com/galerie/4/465-2-mia-plisowana-sukienka_15082.jpg"/>
		  <i url="https://www.numoco.com/galerie/4/465-2-mia-plisowana-sukienka_15081.jpg"/>
		  <i url="https://www.numoco.com/galerie/4/465-2-mia-plisowana-sukienka_15083.jpg"/>
		  <i url="https://www.numoco.com/galerie/4/465-2-mia-plisowana-sukienka_15078.jpg"/>
		</imgs>
		<desc>
		  <![CDATA[ MIA <strong>plisowana sukienka</strong> z okrągłym dekoltem, szerokim paskiem i krótkim rękawkiem. Uszyta z szyfonowego beżowego materiału na podszewce. Idealna sukienka na każdą okazję. Marka <strong>numoco</strong>. Produkcja europejska. <div class="sizes">Wymiary mierzone są na płasko (+/- 2 cm)<br>Modelka na zdjęciu ma 165cm wzrostu i ma ubrany rozm. UNI (XS - XL)<br></div> ]]>
		</desc>
		<attrs>
		  <a name="Producent">
			<![CDATA[ numoco basic ]]>
		  </a>
		  <a name="Kod_producenta">
			<![CDATA[ 465-2 ]]>
		  </a>
		  <a name="EAN">
			<![CDATA[ 5903133867104 ]]>
		  </a>
		  <a name="Rozmiar">
			<![CDATA[ UNI ]]>
		  </a>
		  <a name="RozmiarIlosc">
			<![CDATA[ UNI:77 ]]>
		  </a>
		</attrs>
	</o>
</offers>

Câmpuri principale în elementul <o> (atribute)

o id – identificatorul produsului în fișier (de ex. 2063)

o url – link către produs

o price – prețul produsului (de ex. 166.99)

o avail – disponibilitate (de ex. 1 = disponibil)

o stock – cantitatea totală (suma stocurilor pentru mărimi)

În practică, stock este suma cantităților din câmpul RozmiarIlosc. Exemplu: L:6 + M:8 + S:10 + XL:24 = stock 48.

Nume, categorie și descriere

cat – categoria produsului (de ex. Modă femei / Rochii)

n – numele produsului

desc – descrierea produsului (poate conține HTML)

Câmpul desc poate conține elemente HTML (de ex. tabele de mărimi). Modul în care importatorul gestionează HTML depinde de sistemul de e-commerce.

Imaginile produsului

imgs – secțiunea de imagini ale produsului

imgs > main url – imaginea principală (URL în atribut)

imgs > i url – imagini suplimentare (0+)

Adresele imaginilor se află în atributul url în tag-urile main și i.

Atributele produsului în <attrs>

Informații suplimentare se află în secțiunea attrs. Fiecare atribut are forma: <a name="NUME">VALOARE</a>.

attrs > a name="Producent" – marcă (de ex. numoco / numoco basic)

attrs > a name="Kod_producenta" – codul modelului (de ex. 478-1)

attrs > a name="EAN" – codul de bare EAN al produsului

attrs > a name="Rozmiar" – lista de mărimi separate prin punct și virgulă (de ex. L;M;S;XL)

attrs > a name="RozmiarIlosc" – mărime și cantitate în formatul mărime:cantitate (de ex. L:6;M:8;S:10;XL:24)

Rozmiar conține lista mărimilor disponibile (separator ;). RozmiarIlosc conține stocurile pentru mărimi în formatul mărime:cantitate (de asemenea separate prin ;).

Mapare recomandată în integrare

Dacă importatorul creează variante pe partea magazinului, se recomandă utilizarea: EAN ca identificator al produsului și câmpurile Rozmiar și RozmiarIlosc pentru crearea variantelor și stocurilor.

Pentru gruparea variantelor în cadrul modelului este util câmpul Kod_producenta (de ex. 478-1), iar mărimile și cantitățile lor rezultă din RozmiarIlosc.

Rezumat tehnic

În acest format, produsul este o singură poziție <o>, iar datele variantelor (mărimi și cantități) sunt transmise în attrs. Prețul și disponibilitatea se referă la produs, în timp ce stocul total se află în o stock.

1 produs = 1 o mărimi în attrs Rozmiar; RozmiarIlosc stock = suma mărimilor imagini în atributul url

Expediere imediată

Comenzile plasate și plătite până la ora 12:00 sunt expediate în aceeași zi (valabil în zilele lucrătoare).

Următoarea expediere în::

ore

minute

secunde