Dokumentacja XML Ceneo

Dokumentacja pliku XML – format Ceneo

Ważna informacja o wariantach:
W tym pliku jeden produkt występuje jako jedna pozycja <o>, a informacje o rozmiarach i ilościach wariantów przekazywane są wewnątrz sekcji <attrs> w polach Rozmiar oraz RozmiarIlosc.

Struktura pliku

Plik składa się z elementu głównego <offers>, w którym znajduje się lista produktów jako elementy <o>.

Każdy element <o> zawiera podstawowe dane w atrybutach oraz szczegóły w polach: <cat>, <n>, <imgs>, <desc>, <attrs>.

Przykład struktury pliku XML w standardzie Ceneo

Poniżej znajduje się przykładowy fragment pliku XML. Kod wyświetlany jest w formie technicznej i może zostać skopiowany.

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

Pola główne w elemencie <o> (atrybuty)

o id – identyfikator produktu w pliku (np. 2063)

o url – link do produktu

o price – cena produktu (np. 166.99)

o avail – dostępność (np. 1 = dostępny)

o stock – łączna ilość sztuk (suma stanów dla rozmiarów)

W praktyce stock jest sumą ilości z pola RozmiarIlosc. Przykład: L:6 + M:8 + S:10 + XL:24 = stock 48.

Nazwa, kategoria i opis

cat – kategoria produktu (np. Moda damska / Sukienki)

n – nazwa produktu

desc – opis produktu (może zawierać HTML)

Pole desc może zawierać elementy HTML (np. tabele rozmiarów). To, jak importer obsłuży HTML, zależy od systemu e-commerce.

Zdjęcia produktu

imgs – sekcja zdjęć produktu

imgs > main url – główne zdjęcie (URL w atrybucie)

imgs > i url – zdjęcia dodatkowe (0+)

Adresy zdjęć znajdują się w atrybucie url w tagach main oraz i.

Atrybuty produktu w <attrs>

Dodatkowe informacje znajdują się w sekcji attrs. Każdy atrybut ma formę: <a name="NAZWA">WARTOŚĆ</a>.

attrs > a name="Producent" – marka (np. numoco / numoco basic)

attrs > a name="Kod_producenta" – kod modelu (np. 478-1)

attrs > a name="EAN" – kod kreskowy EAN produktu

attrs > a name="Rozmiar" – lista rozmiarów oddzielonych średnikiem (np. L;M;S;XL)

attrs > a name="RozmiarIlosc" – rozmiar i ilość w formacie rozmiar:ilość (np. L:6;M:8;S:10;XL:24)

Rozmiar zawiera listę dostępnych rozmiarów (separator ;). RozmiarIlosc zawiera stany magazynowe dla rozmiarów w formacie rozmiar:ilość (również rozdzielone ;).

Rekomendowane mapowanie w integracji

Jeśli importer tworzy warianty po stronie sklepu, rekomendowane jest wykorzystanie: EAN jako identyfikatora produktu oraz pól Rozmiar i RozmiarIlosc do utworzenia wariantów i stanów magazynowych.

Do grupowania wariantów w ramach modelu pomocne jest pole Kod_producenta (np. 478-1), a rozmiary i ich ilości wynikają z RozmiarIlosc.

Podsumowanie techniczne

W tym formacie produkt jest jedną pozycją <o>, a dane wariantów (rozmiary i ilości) są przekazywane w attrs. Cena i dostępność dotyczą produktu, natomiast łączny stan magazynowy znajduje się w o stock.

1 produkt = 1 o rozmiary w attrs Rozmiar; RozmiarIlosc stock = suma rozmiarów zdjęcia w atrybucie url

Natychmiastowa wysyłka

Zamówienia złożone i opłacone do godz. 12:00 wysyłane są tego samego dnia (dotyczy dni roboczych).

Najbliższa wysyłka za::

godz.

min.

sek.