Ceneo XML dokumentacija

XML failo dokumentacija – „Ceneo“ formatas

Svarbi informacija apie variantus:
Šiame faile vienas produktas pateikiamas kaip viena pozicija <o>, o informacija apie dydžius ir variantų kiekius perduodama sekcijos <attrs> viduje laukuose Rozmiar bei RozmiarIlosc.

Failo struktūra

Failas susideda iš pagrindinio elemento <offers>, kuriame yra produktų sąrašas kaip elementai <o>.

Kiekvienas elementas <o> turi pagrindinius duomenis atributuose bei detales laukuose: <cat>, <n>, <imgs>, <desc>, <attrs>.

XML failo struktūros pavyzdys „Ceneo“ standarte

Žemiau pateikiamas pavyzdinis XML failo fragmentas. Kodas rodomas technine forma ir gali būti kopijuojamas.

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

Pagrindiniai laukai elemente <o> (atributai)

o id – produkto identifikatorius faile (pvz., 2063)

o url – nuoroda į produktą

o price – produkto kaina (pvz., 166.99)

o avail – prieinamumas (pvz., 1 = prieinama)

o stock – bendras vienetų kiekis (visų dydžių likučių suma)

Praktikoje stock yra kiekių iš lauko RozmiarIlosc suma. Pavyzdys: L:6 + M:8 + S:10 + XL:24 = stock 48.

Pavadinimas, kategorija ir aprašymas

cat – produkto kategorija (pvz., Moteriška mada / Suknelės)

n – produkto pavadinimas

desc – produkto aprašymas (gali turėti HTML)

Laukas desc gali turėti HTML elementų (pvz., dydžių lenteles). Tai, kaip importuotojas apdoros HTML, priklauso nuo el. prekybos sistemos.

Produkto nuotraukos

imgs – produkto nuotraukų sekcija

imgs > main url – pagrindinė nuotrauka (URL atribute)

imgs > i url – papildomos nuotraukos (0+)

Nuotraukų adresai yra atribute url žymose main bei i.

Produkto atributai sekcijoje <attrs>

Papildoma informacija yra sekcijoje attrs. Kiekvienas atributas turi formą: <a name="PAVADINIMAS">REIKŠMĖ</a>.

attrs > a name="Producent" – prekės ženklas (pvz., numoco / numoco basic)

attrs > a name="Kod_producenta" – modelio kodas (pvz., 478-1)

attrs > a name="EAN" – produkto EAN brūkšninis kodas

attrs > a name="Rozmiar" – dydžių sąrašas atskirtas kabliataškiais (pvz., L;M;S;XL)

attrs > a name="RozmiarIlosc" – dydis ir kiekis formatu dydis:kiekis (pvz., L:6;M:8;S:10;XL:24)

Rozmiar (dydis) turi prieinamų dydžių sąrašą (skirtukas ;). RozmiarIlosc (dydisKiekis) turi dydžių sandėlio likučius formatu dydis:kiekis (taip pat atskirta ;).

Rekomenduojamas susiejimas integracijoje

Jei importuotojas kuria variantus parduotuvės pusėje, rekomenduojama naudoti: EAN kaip produkto identifikatorių bei laukus Rozmiar ir RozmiarIlosc variantų ir sandėlio likučių sukūrimui.

Variantų grupavimui modelio rėmuose naudingas laukas Kod_producenta (pvz., 478-1), o dydžiai ir jų kiekiai išplaukia iš RozmiarIlosc.

Techninis apibendrinimas

Šiame formate produktas yra viena pozicija <o>, o variantų duomenys (dydžiai ir kiekiai) perduodami sekcijoje attrs. Kaina ir prieinamumas liečia produktą, o bendras sandėlio likutis yra lauke o stock.

1 produktas = 1 o dydžiai sekcijoje attrs Rozmiar; RozmiarIlosc stock = dydžių suma nuotraukos atribute url

Nedelsiant pristatymas

Užsakymai, pateikti ir apmokėti iki 12:00, išsiunčiami tą pačią dieną (taikoma darbo dienomis).

Artimiausias siuntimas už::

val.

min.

sek.