Ceneo XML Documentation

XML File Documentation – Ceneo Format

Important information about variants:
In this file, one product appears as a single <o> item, and information about sizes and variant quantities is passed inside the <attrs> section in the fields Rozmiar and RozmiarIlosc.

File Structure

The file consists of the main element <offers>, which contains a list of products as <o> elements.

Each <o> element contains basic data in attributes and details in fields: <cat>, <n>, <imgs>, <desc>, <attrs>.

Example of XML File Structure in Ceneo Standard

Below is an example fragment of an XML file. The code is displayed in technical form and can be copied.

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

Main Fields in Element <o> (Attributes)

o id – product identifier in the file (e.g., 2063)

o url – link to the product

o price – product price (e.g., 166.99)

o avail – availability (e.g., 1 = available)

o stock – total quantity (sum of stock for all sizes)

In practice, stock is the sum of quantities from the RozmiarIlosc field. Example: L:6 + M:8 + S:10 + XL:24 = stock 48.

Name, Category, and Description

cat – product category (e.g., Women's Fashion / Dresses)

n – product name

desc – product description (may contain HTML)

The desc field may contain HTML elements (e.g., size charts). How the importer handles HTML depends on the e-commerce system.

Product Images

imgs – product images section

imgs > main url – main image (URL in attribute)

imgs > i url – additional images (0+)

Image addresses are found in the url attribute within main and i tags.

Product Attributes in <attrs>

Additional information is found in the attrs section. Each attribute has the form: <a name="NAME">VALUE</a>.

attrs > a name="Producent" – brand (e.g., numoco / numoco basic)

attrs > a name="Kod_producenta" – model code (e.g., 478-1)

attrs > a name="EAN" – product EAN barcode

attrs > a name="Rozmiar" – list of sizes separated by semicolons (e.g., L;M;S;XL)

attrs > a name="RozmiarIlosc" – size and quantity in format size:quantity (e.g., L:6;M:8;S:10;XL:24)

Rozmiar contains a list of available sizes (separator ;). RozmiarIlosc contains stock levels for sizes in the format size:quantity (also separated by ;).

Recommended Mapping in Integration

If the importer creates variants on the store side, it is recommended to use: EAN as the product identifier and fields Rozmiar and RozmiarIlosc to create variants and stock levels.

For grouping variants within a model, the Kod_producenta field (e.g., 478-1) is helpful, while sizes and their quantities result from RozmiarIlosc.

Technical Summary

In this format, the product is a single <o> item, and variant data (sizes and quantities) are passed in attrs. Price and availability apply to the product, while total stock is located in o stock.

1 product = 1 o sizes in attrs Rozmiar; RozmiarIlosc stock = sum of sizes images in url attribute

Immediate dispatch

Orders placed and paid for by 12:00 are dispatched the same day (applies to working days).

Next dispatch in::

hrs

mins

secs.