Športové novinky, zľavy a porovnanie ponúk na jednom mieste.

Zoneo

Integrácie

ZONEO Product Feed XML v1.0

Technická dokumentácia pre e-shopy a integrátorov. Aktuálna verzia podporuje iba kompletný XML feed.

Noindex dokumentácia Verzia 1.0

A. Úvod

ZONEO XML Feed v1.0 je technický kontrakt pre import produktových ponúk do ZONEO. Feed je navrhnutý ako feed predajných ponúk: 1 item = 1 konkrétna ponuka / 1 konkrétna varianta.

Povinné: Aktuálne podporujeme iba type="full".

Varianty sa prepájajú cez VARIANT_GROUP_ID. Partner posiela originálne obrázky, ZONEO interne generuje verejné miniatúry a obrázkové deriváty.

Verzia

1.0

stabilný kontrakt pre aktuálne spustenie

Typ feedu

full

rozdielový feed nie je súčasťou v1.0

Kódovanie

UTF-8

slovenské znaky posielajte priamo v XML

Model

1 ITEM = 1 ponuka

každá predajná varianta je samostatný ITEM

B. Rýchly štart

Ak pripravujete export prvýkrát, začnite minimálnym príkladom a postupne doplňte varianty, kategorizáciu, športové filtre a galériu. Tento postup znižuje počet chýb pri prvom importe.

1. Vygenerujte kompletné XML

Export musí mať koreňový element ZONEO_FEED, atribúty version="1.0" a type="full" a obsahovať bloky FEED_INFO, SHOP a ITEMS.

2. Naplňte povinné polia

Každý publikovateľný ITEM potrebuje stabilné ID, názov, URL, cenu, menu, dostupnosť, kategóriu, obrázok, značku alebo výrobcu a aspoň jeden identifikátor.

3. Varianty posielajte samostatne

Veľkosti, farby alebo iné predajné varianty neposielajte ako jeden riadok. Zoskupte ich cez VARIANT_GROUP_ID a PARENT_PRODUCT_ID.

4. Pridajte športové parametre

Základné facety patria do hlavných polí, špecializované parametre patria do ATTRIBUTES. Zlepší to vyhľadávanie, filtre aj párovanie produktov.

5. Overte chyby pred odoslaním

Kritická chyba musí zastaviť export alebo import. Varovanie nezastaví import, ale znižuje kvalitu publikácie a mapovania.

C. Kontrakt verzie 1.0

Verzia 1.0 je stabilný full-feed kontrakt. ZONEO prijíma celý aktuálny stav katalógu partnera, nepoužíva delta zmeny a interné normalizácie Zoneo nie sú súčasťou externého XML.

Pravidlo Hodnota Úroveň
Koreňový element ZONEO_FEED s version="1.0" a type="full". ERROR
Jedinečnosť ITEM_ID musí byť unikátny v rámci SHOP_ID a stabilný medzi exportmi. ERROR
URL Všetky URL polia musia byť absolútne http:// alebo https:// URL. ERROR
Cena PRICE_VAT je decimal s bodkou a musí byť >= 0. ERROR
Dostupnosť AVAILABILITY@code musí byť jedna z povolených enum hodnôt. ERROR
Kategória Vyžaduje sa CATEGORY_PATH alebo CATEGORY_ID; najlepšie posielať oboje. ERROR
Obrázok MAIN_IMAGE musí byť verejne dostupná absolútna URL bez watermarku. ERROR
Identifikátory Pošlite aspoň jeden z SKU, EAN, GTIN, MPN, MERCHANT_PRODUCT_REF. ERROR

D. Základná štruktúra feedu

Koreňová štruktúra je pevná: ZONEO_FEED / FEED_INFO / SHOP / ITEMS / ITEM.

Root schéma 

<?xml version="1.0" encoding="UTF-8"?>
<ZONEO_FEED version="1.0" type="full">
    <FEED_INFO>...</FEED_INFO>
    <SHOP>...</SHOP>
    <ITEMS>
        <ITEM>...</ITEM>
    </ITEMS>
</ZONEO_FEED>

Krátky validný príklad nájdeš v súbore docs/examples/xml/minimal-full-feed.xml.

E. ITEM model

Jeden <ITEM> reprezentuje jednu konkrétnu predajnú ponuku. Ak má produkt viac variantov (farba/veľkosť), každá varianta je samostatný item.

  • PARENT_PRODUCT_ID prepája item na parent produkt partnera.
  • VARIANT_GROUP_ID grupuje varianty jedného produktu.
  • Model je navrhnutý pre jednoduché partner exporty a spoľahlivý ingest.

F. Povinné polia

Pole Typ Povinné Popis Príklad Poznámka
ITEM_ID string áno Unikátny identifikátor ponuky. RUN-XPRO3-BLK-42 Unikát v rámci SHOP_ID.
PRODUCT_URL url áno URL produktu/varianty v e-shope. https://shop.sk/produkt/x Absolútna URL.
NAME string áno Názov ponuky. Trailové topánky X-Pro 3 Bez nebezpečného HTML.
PRICE_VAT decimal áno Aktuálna cena s DPH. 129.90 Musí byť >= 0.
CURRENCY string áno Mena ceny. EUR ISO 4217.
AVAILABILITY element áno Dostupnosť itemu. <AVAILABILITY code="in_stock">Skladom</AVAILABILITY> code musí byť z enumu.
CATEGORY_PATH alebo CATEGORY_ID string áno Kategorizácia produktu. Beh > Bežecké topánky > Trailové Musí existovať aspoň jedno.
MAIN_IMAGE url áno Hlavný obrázok ponuky. https://cdn.shop.sk/p/main.jpg Absolútna URL.
BRAND alebo MANUFACTURER string áno Značka alebo výrobca. Salomon Musí existovať aspoň jedno.
SKU/EAN/GTIN/MPN/MERCHANT_PRODUCT_REF string áno Stabilný identifikátor pre párovanie. EAN 8591234567890 Musí existovať aspoň jeden z tejto skupiny.

H. Kompletná referenčná tabuľka polí

Referencia je rozdelená na feed/shop/item/media/price/sport/attributes vrstvy.

Úroveň feedu

XML element / cesta Typ Povinné? Popis Príklad hodnoty Poznámka / pravidlo
ZONEO_FEED@version string áno Verzia feedu. 1.0 v1.0 fixná.
ZONEO_FEED@type enum áno Typ feedu. full Rozdielový feed sa teraz nerieši.
FEED_INFO/GENERATED_AT datetime áno Čas exportu. 2026-03-29T10:00:00Z ISO 8601.
FEED_INFO/LOCALE string áno Jazyk a región feedu. sk_SK Štartovacie locale pre slovenský trh.
FEED_INFO/COUNTRY string áno Krajina. SK ISO alpha-2.
FEED_INFO/CURRENCY string áno Predvolená mena. EUR ISO 4217.

Úroveň obchodu

XML element / cesta Typ Povinné? Popis Príklad hodnoty Poznámka / pravidlo
SHOP/SHOP_ID string áno ID partnera. partner-001 Stabilné ID.
SHOP/SHOP_NAME string áno Názov obchodu. SportShop Názov partnera.
SHOP/SHOP_URL url áno Web shopu. https://www.sportshop.sk Absolútna URL.
SHOP/CONTACT_EMAIL string áno Kontakt pre feed incidenty. feed@sportshop.sk Kanál technickej podpory.

Základ ITEMu

XML element / cesta Typ Povinné? Popis Príklad hodnoty Poznámka / pravidlo
ITEM_ID string áno Unikátny identifikátor ponuky. RUN-XPRO3-BLK-42 Unikát v rámci SHOP_ID.
PRODUCT_URL url áno URL produktu/varianty v e-shope. https://shop.sk/produkt/x Absolútna URL.
NAME string áno Názov ponuky. Trailové topánky X-Pro 3 Bez nebezpečného HTML.
PRICE_VAT decimal áno Aktuálna cena s DPH. 129.90 Musí byť >= 0.
CURRENCY string áno Mena ceny. EUR ISO 4217.
AVAILABILITY element áno Dostupnosť itemu. <AVAILABILITY code="in_stock">Skladom</AVAILABILITY> code musí byť z enumu.
CATEGORY_PATH alebo CATEGORY_ID string áno Kategorizácia produktu. Beh > Bežecké topánky > Trailové Musí existovať aspoň jedno.
MAIN_IMAGE url áno Hlavný obrázok ponuky. https://cdn.shop.sk/p/main.jpg Absolútna URL.
BRAND alebo MANUFACTURER string áno Značka alebo výrobca. Salomon Musí existovať aspoň jedno.
SKU/EAN/GTIN/MPN/MERCHANT_PRODUCT_REF string áno Stabilný identifikátor pre párovanie. EAN 8591234567890 Musí existovať aspoň jeden z tejto skupiny.
SHORT_DESCRIPTION string odporúčané Krátky popis pre zoznam a detail. Ľahké trailové topánky. Zvyšuje kvalitu verejného zobrazenia.
DESCRIPTION string odporúčané Plný popis produktu. Kompletný technický popis... Pomáha SEO aj technickej podpore.
VARIANT_GROUP_ID string odporúčané Skupina variantov. VG-RUN-XPRO3 Stabilný kľúč skupiny.
PARENT_PRODUCT_ID string odporúčané Nadradený produkt v systéme partnera. RUN-XPRO3 Spája varianty.
SPORT, DISCIPLINE string odporúčané Športový kontext. beh, trail-running Kľúčové pre verejné filtre.
COLOR, SIZE, SIZE_SYSTEM string odporúčané Variantové osi. black, 42, EU Dôležité pre facety.
OLD_PRICE_VAT decimal odporúčané Pôvodná cena. 159.90 Pomáha zobraziť zľavu.
STOCK_QUANTITY integer odporúčané Počet kusov na sklade. 8 Presnejšia dostupnosť.
DELIVERY_DAYS_MIN/MAX integer odporúčané Rozsah doručenia. 1 / 2 Zlepšuje používateľský zážitok a dôveru.
IMAGES/IMAGE list odporúčané Ďalšie obrázky produktu. <IMAGE type="gallery">...</IMAGE> Pohľady v galérii.
ATTRIBUTES block odporúčané Športovo špecifické parametre. drop, terrain, waterproof Špecializované filtre.

Identifikátory a značka

XML element / cesta Typ Povinné? Popis Príklad hodnoty Poznámka / pravidlo
BRAND string podmienečne Značka produktu. Salomon Vyžaduje sa BRAND alebo MANUFACTURER.
MANUFACTURER string podmienečne Výrobca produktu. Salomon Použite, ak značka nie je dostupná.
MODEL string odporúčané Model produktu. X-Pro 3 Silný signál pre párovanie spolu so značkou.
SKU string podmienečne Skladové číslo obchodu. RUN-XPRO3-BLK-42 Súčasť identifikátorovej skupiny.
EAN / GTIN string odporúčané Globálny produktový identifikátor. 8591234567890 Najsilnejší signál pre párovanie.
MPN string odporúčané Výrobný identifikátor. XPRO3-BLK-42 Používajte spolu s BRAND.

Kategórie

XML element / cesta Typ Povinné? Popis Príklad hodnoty Poznámka / pravidlo
CATEGORY_PATH string podmienečne Kategóriový strom obchodu. Beh > Bežecké topánky > Trailové Odporúčané pre presné mapovanie.
CATEGORY_ID string podmienečne Interný kľúč kategórie partnera. run-trail-shoes Stabilný medzi exportmi.
CATEGORY_NAME string voliteľné Názov koncovej kategórie. Trailové bežecké topánky Pomocný text pre podporu a audit.
ZONEO_CATEGORY_HINT string voliteľné Pomocný signál na mapovanie do stromu ZONEO. beh/bezecke-topanky/trailove Zvyšuje presnosť a rýchlosť mapovania.
PRODUCT_TYPE string voliteľné Typ produktu nezávislý od kategórie. running-shoes Doplnková semantika.

Varianty

XML element / cesta Typ Povinné? Popis Príklad hodnoty Poznámka / pravidlo
PARENT_PRODUCT_ID string odporúčané Nadradený produkt v systéme partnera. RUN-X3 Spája varianty rovnakého produktu.
VARIANT_GROUP_ID string odporúčané Stabilná skupina variantov. VG-RUN-X3 Rovnaká hodnota pre varianty jedného produktu.
IS_VARIANT boolean voliteľné Príznak predajnej varianty. true Používajte true/false.
PRIMARY_VARIANT_LABEL string voliteľné Krátky názov varianty. 42 EU / čierna Pomáha verejnému zobrazeniu aj podpore.

Obrázky a médiá

XML element / cesta Typ Povinné? Popis Príklad hodnoty Poznámka / pravidlo
MAIN_IMAGE url áno Hlavný obrázok. https://cdn.shop.sk/p/main.jpg Bez watermarkov.
IMAGES/IMAGE url voliteľné Obrázky galérie. <IMAGE type="gallery"...> type, sort_order, alt, title.
VIDEO_URL url voliteľné Video produktu. https://cdn.shop.sk/v/prod.mp4 Voliteľné.
SIZE_CHART_URL url voliteľné Tabuľka veľkostí. https://cdn.shop.sk/charts/size.pdf Voliteľné.

Ceny a dostupnosť

XML element / cesta Typ Povinné? Popis Príklad hodnoty Poznámka / pravidlo
PRICE_VAT decimal áno Cena s DPH. 129.90 >= 0.
OLD_PRICE_VAT decimal voliteľné Pôvodná cena. 159.90 >= PRICE_VAT.
CURRENCY string áno Mena položky. EUR ISO 4217.
AVAILABILITY@code enum áno Stav dostupnosti. in_stock Povolený enum.
STOCK_QUANTITY integer odporúčané Počet kusov. 8 Ne-negatívne.
DELIVERY_DAYS_MIN/MAX integer odporúčané Rozsah doručenia. 1 / 2 MIN <= MAX.
SHIPPING_PRICE decimal odporúčané Cena dopravy. 0.00 Voliteľné.
FREE_SHIPPING_FROM decimal odporúčané Hranica dopravy zdarma. 50.00 Voliteľné.

Športové polia

XML element / cesta Typ Povinné? Popis Príklad hodnoty Poznámka / pravidlo
SPORT string odporúčané Šport. beh Hlavný filter.
DISCIPLINE string odporúčané Disciplína. trail-running Hlavný filter.
GENDER string/enum odporúčané Pohlavie. male Odporúčaná riadená slovná zásoba.
AGE_GROUP string/enum odporúčané Veková skupina. adult Odporúčaná riadená slovná zásoba.
SEASON string/enum odporúčané Sezóna. year-round Odporúčaná riadená slovná zásoba.
COLOR, SIZE, SIZE_SYSTEM string odporúčané Variantové osi. black / 42 / EU Facety.
MATERIAL string odporúčané Materiál. synthetic-mesh Facety.

ATTRIBUTES

XML element / cesta Typ Povinné? Popis Príklad hodnoty Poznámka / pravidlo
ATTRIBUTES/ATTRIBUTE@code string áno Strojový kľúč atribútu. drop Stabilný kľúč.
ATTRIBUTES/ATTRIBUTE@label string odporúčané Zobrazovaný názov atribútu. Drop Používa sa vo verejnom zobrazení.
ATTRIBUTES/ATTRIBUTE@type enum áno Typ hodnoty. decimal string/integer/decimal/boolean.
ATTRIBUTES/ATTRIBUTE@unit string voliteľné Jednotka. mm Voliteľné.
ATTRIBUTES/ATTRIBUTE@filterable boolean odporúčané Príznak filtrovateľnosti. true true/false.
ATTRIBUTES/ATTRIBUTE value áno Hodnota atribútu. 8 Zodpovedá typu.

Obsah a dôvera

XML element / cesta Typ Povinné? Popis Príklad hodnoty Poznámka / pravidlo
FEATURES/FEATURE list voliteľné Krátke produktové benefity. <FEATURE>Priedušný zvršok</FEATURE> Použiteľné na detail produktu.
BENEFITS string voliteľné Textové zhrnutie benefitov. Stabilita v teréne Bez marketingového balastu.
PACKAGE_CONTENT string voliteľné Obsah balenia. 1x kettlebell Dôležité pre výbavu a sady.
RETURN_DAYS integer odporúčané Lehota vrátenia. 14 Dôveryhodnostný signál.
WARRANTY_MONTHS integer odporúčané Záruka v mesiacoch. 24 Dôveryhodnostný signál.

I. Varianty

Rôzne veľkosti/farby musia byť samostatné ITEMy. Spoločný produkt prepájaj cez VARIANT_GROUP_ID.

Ukážka variantu 

<ITEM>
    <ITEM_ID>RUN-X3-BLK-42</ITEM_ID>
    <PARENT_PRODUCT_ID>RUN-X3</PARENT_PRODUCT_ID>
    <VARIANT_GROUP_ID>VG-RUN-X3</VARIANT_GROUP_ID>
    <IS_VARIANT>true</IS_VARIANT>
    <COLOR>black</COLOR>
    <SIZE>42</SIZE>
    <SIZE_SYSTEM>EU</SIZE_SYSTEM>
</ITEM>

Referenčný súbor: docs/examples/xml/full-feed-variants.xml.

J. Obrázky

  • MAIN_IMAGE je povinné.
  • IMAGES/IMAGE je voliteľná galéria.
  • Všetky URL musia byť absolútne.
  • Partner posiela originály, ZONEO generuje miniatúry a ďalšie deriváty interne.

Partner feed nemusí obsahovať predgenerované miniatúry (thumb/small/medium/large).

K. Ceny a dostupnosť

Ceny a dostupnosť sú vždy na úrovni konkrétneho ITEMu (varianta/ponuka).

Povinné: PRICE_VAT, CURRENCY, AVAILABILITY.

Odporúčané: OLD_PRICE_VAT, STOCK_QUANTITY, DELIVERY_DAYS_MIN/MAX, SHIPPING_PRICE.

in_stock out_of_stock preorder backorder discontinued on_request

L. Identifikátory

Pre párovanie produktov sú najdôležitejšie identifikátory a signály značky.

Pole Účel Priorita pre párovanie
EAN/GTINGlobálny identifikátorNajvyššia
MPN + BRANDVýrobný identifikátorVysoká
MODEL + BRANDModelová zhodaStredná
SKU/MERCHANT_PRODUCT_REFInterný kľúč obchoduV rámci obchodu

M. Kategorizácia

  • CATEGORY_PATH je odporúčaná cesta partner kategórie.
  • CATEGORY_ID je interný kľúč kategórie partnera.
  • ZONEO_CATEGORY_HINT pomáha mapovaniu na interný strom ZONEO.

Partner nemusí poznať interný ZONEO taxonomy strom. Hint je voliteľný pomocný signál.

N. Športové polia a filtre

Bežné filtre majú vlastné hlavné polia. Špecializované parametre, ktoré sa líšia podľa športu, patria do bloku ATTRIBUTES.

Hlavné polia: SPORT, DISCIPLINE, GENDER, AGE_GROUP, SEASON, COLOR, SIZE, SIZE_SYSTEM, MATERIAL

ATTRIBUTES: špecifické parametre ako drop, terrain, certification, frame_size, wheel_size.

Produkt Šport Odporúčané atribúty
Bežecké topánky beh terrain, drop, cushioning, waterproof, size_system
Bicykel cyklistika frame_size, wheel_size, brake_type, material
Futbalová lopta futbal ball_size, surface, panel_count
Jednoručná činka / kettlebell fitness weight_kg, material, coating
Turistický batoh turistika capacity_l, waterproof, weight
Hokejka hokej handedness, flex, length, blade_curve
Fitness podložka fitness thickness_mm, material, anti_slip
Cyklistická prilba cyklistika helmet_type, size, certification

O. ATTRIBUTES

ATTRIBUTES slúžia na športovo špecifické parametre bez nutnosti meniť koreňovú schému.

Štruktúra ATTRIBUTES 

<ATTRIBUTES>
    <ATTRIBUTE code="drop" label="Drop" type="decimal" unit="mm" filterable="true">8</ATTRIBUTE>
    <ATTRIBUTE code="terrain" label="Terén" type="string" filterable="true">trail</ATTRIBUTE>
    <ATTRIBUTE code="waterproof" label="Vodoodolnosť" type="boolean" filterable="true">false</ATTRIBUTE>
</ATTRIBUTES>
Attribute časť Typ Povinné? Poznámka
codestringánoStabilný strojový kľúč.
labelstringodporúčanéZobrazovaný názov pre verejný web a podporu.
typeenumánostring|integer|decimal|boolean
unitstringvoliteľnéJednotka (mm, g, l...).
filterablebooleanodporúčanéSignál pre facet index.
valuetext/valueánoHodnota atribútu.

P. Validačné pravidlá

Validácia je rozdelená na technickú, biznis a publikačnú vrstvu.

ERROR

ERROR

Item/feed sa nedá spracovať alebo publikovať.

  • Chýba ITEM_ID
  • Neplatná URL
  • Chýba PRICE_VAT
  • Duplicitné ITEM_ID

WARNING

WARNING

Feed sa spracuje, ale kvalita dát je znížená.

  • Chýba EAN
  • Chýba DESCRIPTION
  • Chýba STOCK_QUANTITY

INFO / ODPORÚČANIE

INFO / ODPORÚČANIE

Odporúčania na zlepšenie párovania produktov a kvality verejného zobrazenia.

  • Doplniť CATEGORY_HINT
  • Doplniť športové atribúty
  • Doplniť galériu

Detailný model nájdeš v docs/integrations/zoneo-xml-feed-validation.md.

Q. Najčastejšie chyby partnerov

Problém Dopad Ako opraviť
Chýba MAIN_IMAGE ERROR Poslať absolútnu URL hlavného obrázka pre každý publikovateľný ITEM.
Relatívna URL ERROR Používať iba plné URL s http/https.
Neplatná mena ERROR Používať ISO 4217 kód (napr. EUR).
Duplicitné ITEM_ID ERROR Zabezpečiť stabilné unikátne ID v rámci obchodu.
Chýba identifikátorový blok ERROR Doplniť aspoň jeden z SKU/EAN/GTIN/MPN/MERCHANT_PRODUCT_REF.
Zle rozdelené varianty WARNING Každú predajnú variantu posielať ako samostatný ITEM s VARIANT_GROUP_ID.
Neplatná dostupnosť ERROR Použiť len povolené enum hodnoty kódu dostupnosti.
Nesprávny formát ceny ERROR Používať decimal s bodkou, bez lokálnych formátov.
Nerealistický CATEGORY_PATH WARNING Posielať stabilnú kategóriovú hierarchiu obchodu, konzistentnú naprieč exportmi.

R. Ukážkové XML feedy

Všetky príklady sú uložené v docs/examples/xml/ a sú konzistentné s v1.0 kontraktom.

minimal-full-feed.xml

Minimálny validný kompletný feed s jedným ITEM.

Prvý smoke test integrácie a overenie povinného minima.

docs/examples/xml/minimal-full-feed.xml

minimal-full-feed.xml 

<?xml version="1.0" encoding="UTF-8"?>
<ZONEO_FEED version="1.0" type="full">
    <FEED_INFO>
        <GENERATED_AT>2026-03-29T08:00:00Z</GENERATED_AT>
        <LOCALE>sk_SK</LOCALE>
        <COUNTRY>SK</COUNTRY>
        <CURRENCY>EUR</CURRENCY>
        <FORMAT_VERSION>1.0</FORMAT_VERSION>
    </FEED_INFO>
    <SHOP>
        <SHOP_ID>partner-demo</SHOP_ID>
        <SHOP_NAME>Demo Sport Shop</SHOP_NAME>
        <SHOP_URL>https://www.demo-sport.sk</SHOP_URL>
        <CONTACT_EMAIL>feed@demo-sport.sk</CONTACT_EMAIL>
    </SHOP>
    <ITEMS>
        <ITEM>
            <ITEM_ID>RUN-001-42-BLK</ITEM_ID>
            <PRODUCT_URL>https://www.demo-sport.sk/produkt/run-001-42-black</PRODUCT_URL>
            <NAME>Bežecké topánky Run 001</NAME>
            <PRICE_VAT>99.90</PRICE_VAT>
            <CURRENCY>EUR</CURRENCY>
            <AVAILABILITY code="in_stock">Skladom</AVAILABILITY>
            <CATEGORY_PATH>Beh &gt; Bežecké topánky</CATEGORY_PATH>
            <MAIN_IMAGE>https://cdn.demo-sport.sk/products/run-001-main.jpg</MAIN_IMAGE>
            <BRAND>DemoRun</BRAND>
            <SKU>RUN-001-42-BLK</SKU>
        </ITEM>
    </ITEMS>
</ZONEO_FEED>

full-feed-complete.xml

Kompletný feed s viacerými športovými typmi produktov.

Referenčný príklad pre širší produkčný export.

docs/examples/xml/full-feed-complete.xml

full-feed-complete.xml 

<?xml version="1.0" encoding="UTF-8"?>
<ZONEO_FEED version="1.0" type="full">
    <FEED_INFO>
        <GENERATED_AT>2026-03-29T10:00:00Z</GENERATED_AT>
        <LOCALE>sk_SK</LOCALE>
        <COUNTRY>SK</COUNTRY>
        <CURRENCY>EUR</CURRENCY>
        <FORMAT_VERSION>1.0</FORMAT_VERSION>
        <ENVIRONMENT>production</ENVIRONMENT>
    </FEED_INFO>
    <SHOP>
        <SHOP_ID>partner-complete</SHOP_ID>
        <SHOP_NAME>Sport Complete Shop</SHOP_NAME>
        <SHOP_URL>https://www.sport-complete.sk</SHOP_URL>
        <CONTACT_EMAIL>feed@sport-complete.sk</CONTACT_EMAIL>
        <SUPPORT_CONTACT>+421901222333</SUPPORT_CONTACT>
        <STORE_ID>main-store</STORE_ID>
        <STORE_NAME>Sport Complete Central</STORE_NAME>
    </SHOP>
    <ITEMS>
        <ITEM>
            <ITEM_ID>RUN-ALPHA-42-BLK</ITEM_ID>
            <MERCHANT_PRODUCT_REF>RUN-ALPHA</MERCHANT_PRODUCT_REF>
            <PARENT_PRODUCT_ID>RUN-ALPHA</PARENT_PRODUCT_ID>
            <VARIANT_GROUP_ID>VG-RUN-ALPHA</VARIANT_GROUP_ID>
            <IS_VARIANT>true</IS_VARIANT>
            <PRIMARY_VARIANT_LABEL>Čierna / 42</PRIMARY_VARIANT_LABEL>
            <NAME>Bežecké topánky Alpha Trail 42</NAME>
            <SHORT_DESCRIPTION>Trailový model s vyšším gripom.</SHORT_DESCRIPTION>
            <DESCRIPTION>Univerzálna trailová obuv pre tréning aj dlhšie výbehy v kopcoch.</DESCRIPTION>
            <PRODUCT_URL>https://www.sport-complete.sk/produkt/alpha-trail-42-black</PRODUCT_URL>
            <BRAND>AlphaSport</BRAND>
            <MANUFACTURER>AlphaSport</MANUFACTURER>
            <MODEL>Alpha Trail</MODEL>
            <SKU>RUN-ALPHA-42-BLK</SKU>
            <MPN>ALPHA-TRAIL-42-BLK</MPN>
            <EAN>8597000000042</EAN>
            <CATEGORY_ID>9001</CATEGORY_ID>
            <CATEGORY_NAME>Trailové bežecké topánky</CATEGORY_NAME>
            <CATEGORY_PATH>Beh &gt; Bežecké topánky &gt; Trailové</CATEGORY_PATH>
            <ZONEO_CATEGORY_HINT>beh/bezecke-topanky/trailove</ZONEO_CATEGORY_HINT>
            <SPORT>beh</SPORT>
            <DISCIPLINE>trail-running</DISCIPLINE>
            <GENDER>male</GENDER>
            <AGE_GROUP>adult</AGE_GROUP>
            <SEASON>year-round</SEASON>
            <TERRAIN>trail</TERRAIN>
            <COLOR>black</COLOR>
            <SIZE>42</SIZE>
            <SIZE_SYSTEM>EU</SIZE_SYSTEM>
            <MATERIAL>synthetic-mesh</MATERIAL>
            <WEIGHT>289</WEIGHT>
            <DROP>8</DROP>
            <PRICE_VAT>119.90</PRICE_VAT>
            <OLD_PRICE_VAT>149.90</OLD_PRICE_VAT>
            <SALE_PRICE_VAT>119.90</SALE_PRICE_VAT>
            <CURRENCY>EUR</CURRENCY>
            <VAT_RATE>23</VAT_RATE>
            <PRICE_VALID_FROM>2026-03-28T00:00:00Z</PRICE_VALID_FROM>
            <PRICE_VALID_TO>2026-04-07T23:59:59Z</PRICE_VALID_TO>
            <AVAILABILITY code="in_stock">Skladom</AVAILABILITY>
            <STOCK_QUANTITY>12</STOCK_QUANTITY>
            <DELIVERY_DAYS_MIN>1</DELIVERY_DAYS_MIN>
            <DELIVERY_DAYS_MAX>2</DELIVERY_DAYS_MAX>
            <DELIVERY_TEXT>U vás do 1-2 pracovných dní.</DELIVERY_TEXT>
            <SHIPPING_PRICE>0.00</SHIPPING_PRICE>
            <FREE_SHIPPING_FROM>60.00</FREE_SHIPPING_FROM>
            <SHIPPING_NOTE>Doprava zdarma nad 60 EUR.</SHIPPING_NOTE>
            <MAIN_IMAGE>https://cdn.sport-complete.sk/products/run-alpha-42-main.jpg</MAIN_IMAGE>
            <IMAGES>
                <IMAGE type="gallery" sort_order="1">https://cdn.sport-complete.sk/products/run-alpha-42-1.jpg</IMAGE>
                <IMAGE type="gallery" sort_order="2">https://cdn.sport-complete.sk/products/run-alpha-42-2.jpg</IMAGE>
            </IMAGES>
            <VIDEO_URL>https://cdn.sport-complete.sk/videos/run-alpha.mp4</VIDEO_URL>
            <FEATURES>
                <FEATURE>Vysoký grip</FEATURE>
                <FEATURE>Stabilná päta</FEATURE>
                <FEATURE>Priedušný zvršok</FEATURE>
            </FEATURES>
            <ATTRIBUTES>
                <ATTRIBUTE code="terrain" label="Terén" type="string" filterable="true">trail</ATTRIBUTE>
                <ATTRIBUTE code="drop" label="Drop" type="decimal" unit="mm" filterable="true">8</ATTRIBUTE>
                <ATTRIBUTE code="waterproof" label="Vodoodolnosť" type="boolean" filterable="true">false</ATTRIBUTE>
            </ATTRIBUTES>
            <RETURN_DAYS>14</RETURN_DAYS>
            <WARRANTY_MONTHS>24</WARRANTY_MONTHS>
        </ITEM>
        <ITEM>
            <ITEM_ID>CYC-HELM-DELTA-M</ITEM_ID>
            <PARENT_PRODUCT_ID>CYC-HELM-DELTA</PARENT_PRODUCT_ID>
            <VARIANT_GROUP_ID>VG-CYC-HELM-DELTA</VARIANT_GROUP_ID>
            <IS_VARIANT>true</IS_VARIANT>
            <NAME>Cyklistická helma Delta M</NAME>
            <PRODUCT_URL>https://www.sport-complete.sk/produkt/helma-delta-m</PRODUCT_URL>
            <BRAND>RideSafe</BRAND>
            <SKU>CYC-HELM-DELTA-M</SKU>
            <MPN>DELTA-M</MPN>
            <GTIN>08590001110002</GTIN>
            <CATEGORY_PATH>Cyklistika &gt; Helmy &gt; MTB helmy</CATEGORY_PATH>
            <SPORT>cyklistika</SPORT>
            <DISCIPLINE>mtb</DISCIPLINE>
            <GENDER>unisex</GENDER>
            <AGE_GROUP>adult</AGE_GROUP>
            <SEASON>spring-summer-autumn</SEASON>
            <SIZE>M</SIZE>
            <SIZE_SYSTEM>INT</SIZE_SYSTEM>
            <COLOR>blue</COLOR>
            <PRICE_VAT>89.90</PRICE_VAT>
            <CURRENCY>EUR</CURRENCY>
            <VAT_RATE>23</VAT_RATE>
            <AVAILABILITY code="preorder">Predobjednávka</AVAILABILITY>
            <DELIVERY_DAYS_MIN>5</DELIVERY_DAYS_MIN>
            <DELIVERY_DAYS_MAX>8</DELIVERY_DAYS_MAX>
            <DELIVERY_TEXT>Dodanie 5-8 pracovných dní.</DELIVERY_TEXT>
            <SHIPPING_PRICE>3.90</SHIPPING_PRICE>
            <FREE_SHIPPING_FROM>100.00</FREE_SHIPPING_FROM>
            <MAIN_IMAGE>https://cdn.sport-complete.sk/products/cyc-helm-delta-main.jpg</MAIN_IMAGE>
            <IMAGES>
                <IMAGE type="gallery" sort_order="1">https://cdn.sport-complete.sk/products/cyc-helm-delta-1.jpg</IMAGE>
                <IMAGE type="gallery" sort_order="2">https://cdn.sport-complete.sk/products/cyc-helm-delta-2.jpg</IMAGE>
            </IMAGES>
            <ATTRIBUTES>
                <ATTRIBUTE code="helmet_type" label="Typ helmy" type="string" filterable="true">mtb</ATTRIBUTE>
                <ATTRIBUTE code="certification" label="Certifikácia" type="string" filterable="true">EN1078</ATTRIBUTE>
            </ATTRIBUTES>
            <RETURN_DAYS>14</RETURN_DAYS>
            <WARRANTY_MONTHS>24</WARRANTY_MONTHS>
        </ITEM>
        <ITEM>
            <ITEM_ID>FB-BALL-MATCH-5</ITEM_ID>
            <PARENT_PRODUCT_ID>FB-BALL-MATCH</PARENT_PRODUCT_ID>
            <VARIANT_GROUP_ID>VG-FB-BALL-MATCH</VARIANT_GROUP_ID>
            <IS_VARIANT>true</IS_VARIANT>
            <NAME>Futbalová lopta Match size 5</NAME>
            <PRODUCT_URL>https://www.sport-complete.sk/produkt/futbalova-lopta-match-5</PRODUCT_URL>
            <BRAND>GoalPro</BRAND>
            <MODEL>Match</MODEL>
            <SKU>FB-BALL-MATCH-5</SKU>
            <EAN>8580009900005</EAN>
            <CATEGORY_PATH>Futbal &gt; Lopty &gt; Tréningové lopty</CATEGORY_PATH>
            <SPORT>futbal</SPORT>
            <DISCIPLINE>football</DISCIPLINE>
            <GENDER>unisex</GENDER>
            <AGE_GROUP>adult</AGE_GROUP>
            <SEASON>year-round</SEASON>
            <SURFACE>grass</SURFACE>
            <SIZE>5</SIZE>
            <SIZE_SYSTEM>BALL</SIZE_SYSTEM>
            <PRICE_VAT>34.90</PRICE_VAT>
            <OLD_PRICE_VAT>44.90</OLD_PRICE_VAT>
            <CURRENCY>EUR</CURRENCY>
            <VAT_RATE>23</VAT_RATE>
            <AVAILABILITY code="backorder">Na objednávku</AVAILABILITY>
            <DELIVERY_DAYS_MIN>3</DELIVERY_DAYS_MIN>
            <DELIVERY_DAYS_MAX>6</DELIVERY_DAYS_MAX>
            <DELIVERY_TEXT>Na objednávku, dodanie 3-6 dní.</DELIVERY_TEXT>
            <SHIPPING_PRICE>4.50</SHIPPING_PRICE>
            <MAIN_IMAGE>https://cdn.sport-complete.sk/products/fb-ball-match-5-main.jpg</MAIN_IMAGE>
            <IMAGES>
                <IMAGE type="gallery" sort_order="1">https://cdn.sport-complete.sk/products/fb-ball-match-5-1.jpg</IMAGE>
                <IMAGE type="gallery" sort_order="2">https://cdn.sport-complete.sk/products/fb-ball-match-5-2.jpg</IMAGE>
            </IMAGES>
            <ATTRIBUTES>
                <ATTRIBUTE code="ball_size" label="Veľkosť lopty" type="integer" filterable="true" variant_axis="true">5</ATTRIBUTE>
                <ATTRIBUTE code="surface" label="Povrch" type="string" filterable="true">grass</ATTRIBUTE>
            </ATTRIBUTES>
            <RETURN_DAYS>14</RETURN_DAYS>
            <WARRANTY_MONTHS>24</WARRANTY_MONTHS>
        </ITEM>
        <ITEM>
            <ITEM_ID>HIKE-BACKPACK-35</ITEM_ID>
            <PARENT_PRODUCT_ID>HIKE-BACKPACK</PARENT_PRODUCT_ID>
            <NAME>Turistický batoh Summit 35L</NAME>
            <PRODUCT_URL>https://www.sport-complete.sk/produkt/summit-batoh-35l</PRODUCT_URL>
            <BRAND>SummitGear</BRAND>
            <SKU>HIKE-BACKPACK-35</SKU>
            <MPN>SUM35-GR</MPN>
            <GTIN>08590002223335</GTIN>
            <CATEGORY_PATH>Turistika &gt; Batohy &gt; Turistické batohy</CATEGORY_PATH>
            <ZONEO_CATEGORY_HINT>turistika/batohy/turisticke</ZONEO_CATEGORY_HINT>
            <SPORT>turistika</SPORT>
            <DISCIPLINE>hiking</DISCIPLINE>
            <GENDER>unisex</GENDER>
            <AGE_GROUP>adult</AGE_GROUP>
            <SEASON>spring-summer-autumn</SEASON>
            <COLOR>green</COLOR>
            <MATERIAL>ripstop-nylon</MATERIAL>
            <CAPACITY>35</CAPACITY>
            <PRICE_VAT>119.00</PRICE_VAT>
            <CURRENCY>EUR</CURRENCY>
            <VAT_RATE>23</VAT_RATE>
            <AVAILABILITY code="in_stock">Skladom</AVAILABILITY>
            <STOCK_QUANTITY>9</STOCK_QUANTITY>
            <DELIVERY_DAYS_MIN>1</DELIVERY_DAYS_MIN>
            <DELIVERY_DAYS_MAX>2</DELIVERY_DAYS_MAX>
            <DELIVERY_TEXT>U vás do 1-2 dní.</DELIVERY_TEXT>
            <SHIPPING_PRICE>0.00</SHIPPING_PRICE>
            <FREE_SHIPPING_FROM>70.00</FREE_SHIPPING_FROM>
            <MAIN_IMAGE>https://cdn.sport-complete.sk/products/hike-backpack-35-main.jpg</MAIN_IMAGE>
            <IMAGES>
                <IMAGE type="gallery" sort_order="1">https://cdn.sport-complete.sk/products/hike-backpack-35-1.jpg</IMAGE>
                <IMAGE type="gallery" sort_order="2">https://cdn.sport-complete.sk/products/hike-backpack-35-2.jpg</IMAGE>
            </IMAGES>
            <ATTRIBUTES>
                <ATTRIBUTE code="capacity_l" label="Objem" type="decimal" unit="l" filterable="true">35</ATTRIBUTE>
                <ATTRIBUTE code="waterproof" label="Vodoodolnosť" type="boolean" filterable="true">true</ATTRIBUTE>
            </ATTRIBUTES>
            <RETURN_DAYS>14</RETURN_DAYS>
            <WARRANTY_MONTHS>24</WARRANTY_MONTHS>
        </ITEM>
    </ITEMS>
</ZONEO_FEED>

full-feed-variants.xml

Feed orientovaný na varianty (farba/veľkosť).

Overenie správneho zoskupenia variantov.

docs/examples/xml/full-feed-variants.xml

full-feed-variants.xml 

<?xml version="1.0" encoding="UTF-8"?>
<ZONEO_FEED version="1.0" type="full">
    <FEED_INFO>
        <GENERATED_AT>2026-03-29T08:30:00Z</GENERATED_AT>
        <LOCALE>sk_SK</LOCALE>
        <COUNTRY>SK</COUNTRY>
        <CURRENCY>EUR</CURRENCY>
        <FORMAT_VERSION>1.0</FORMAT_VERSION>
    </FEED_INFO>
    <SHOP>
        <SHOP_ID>partner-variants</SHOP_ID>
        <SHOP_NAME>Variant Sport</SHOP_NAME>
        <SHOP_URL>https://www.variant-sport.sk</SHOP_URL>
        <CONTACT_EMAIL>xml@variant-sport.sk</CONTACT_EMAIL>
    </SHOP>
    <ITEMS>
        <ITEM>
            <ITEM_ID>RUN-X3-BLK-42</ITEM_ID>
            <PARENT_PRODUCT_ID>RUN-X3</PARENT_PRODUCT_ID>
            <VARIANT_GROUP_ID>VG-RUN-X3</VARIANT_GROUP_ID>
            <IS_VARIANT>true</IS_VARIANT>
            <NAME>Run X3 trail topánky</NAME>
            <PRODUCT_URL>https://www.variant-sport.sk/produkt/run-x3-black-42</PRODUCT_URL>
            <BRAND>TrailForge</BRAND>
            <SKU>RUN-X3-BLK-42</SKU>
            <MPN>TX3-BLK-42</MPN>
            <CATEGORY_PATH>Beh &gt; Bežecké topánky &gt; Trailové</CATEGORY_PATH>
            <SPORT>beh</SPORT>
            <DISCIPLINE>trail-running</DISCIPLINE>
            <COLOR>black</COLOR>
            <SIZE>42</SIZE>
            <SIZE_SYSTEM>EU</SIZE_SYSTEM>
            <PRICE_VAT>129.90</PRICE_VAT>
            <OLD_PRICE_VAT>149.90</OLD_PRICE_VAT>
            <CURRENCY>EUR</CURRENCY>
            <AVAILABILITY code="in_stock">Skladom</AVAILABILITY>
            <MAIN_IMAGE>https://cdn.variant-sport.sk/products/run-x3-black-42-main.jpg</MAIN_IMAGE>
        </ITEM>
        <ITEM>
            <ITEM_ID>RUN-X3-BLK-43</ITEM_ID>
            <PARENT_PRODUCT_ID>RUN-X3</PARENT_PRODUCT_ID>
            <VARIANT_GROUP_ID>VG-RUN-X3</VARIANT_GROUP_ID>
            <IS_VARIANT>true</IS_VARIANT>
            <NAME>Run X3 trail topánky</NAME>
            <PRODUCT_URL>https://www.variant-sport.sk/produkt/run-x3-black-43</PRODUCT_URL>
            <BRAND>TrailForge</BRAND>
            <SKU>RUN-X3-BLK-43</SKU>
            <MPN>TX3-BLK-43</MPN>
            <CATEGORY_PATH>Beh &gt; Bežecké topánky &gt; Trailové</CATEGORY_PATH>
            <SPORT>beh</SPORT>
            <DISCIPLINE>trail-running</DISCIPLINE>
            <COLOR>black</COLOR>
            <SIZE>43</SIZE>
            <SIZE_SYSTEM>EU</SIZE_SYSTEM>
            <PRICE_VAT>129.90</PRICE_VAT>
            <OLD_PRICE_VAT>149.90</OLD_PRICE_VAT>
            <CURRENCY>EUR</CURRENCY>
            <AVAILABILITY code="in_stock">Skladom</AVAILABILITY>
            <MAIN_IMAGE>https://cdn.variant-sport.sk/products/run-x3-black-43-main.jpg</MAIN_IMAGE>
        </ITEM>
        <ITEM>
            <ITEM_ID>RUN-X3-RED-42</ITEM_ID>
            <PARENT_PRODUCT_ID>RUN-X3</PARENT_PRODUCT_ID>
            <VARIANT_GROUP_ID>VG-RUN-X3</VARIANT_GROUP_ID>
            <IS_VARIANT>true</IS_VARIANT>
            <NAME>Run X3 trail topánky</NAME>
            <PRODUCT_URL>https://www.variant-sport.sk/produkt/run-x3-red-42</PRODUCT_URL>
            <BRAND>TrailForge</BRAND>
            <SKU>RUN-X3-RED-42</SKU>
            <MPN>TX3-RED-42</MPN>
            <CATEGORY_PATH>Beh &gt; Bežecké topánky &gt; Trailové</CATEGORY_PATH>
            <SPORT>beh</SPORT>
            <DISCIPLINE>trail-running</DISCIPLINE>
            <COLOR>red</COLOR>
            <SIZE>42</SIZE>
            <SIZE_SYSTEM>EU</SIZE_SYSTEM>
            <PRICE_VAT>124.90</PRICE_VAT>
            <OLD_PRICE_VAT>149.90</OLD_PRICE_VAT>
            <CURRENCY>EUR</CURRENCY>
            <AVAILABILITY code="in_stock">Skladom</AVAILABILITY>
            <MAIN_IMAGE>https://cdn.variant-sport.sk/products/run-x3-red-42-main.jpg</MAIN_IMAGE>
        </ITEM>
    </ITEMS>
</ZONEO_FEED>

full-feed-running-shoes.xml

Detailný príklad pre bežecké topánky.

Športové filtre, veľkosti, terén a technické atribúty.

docs/examples/xml/full-feed-running-shoes.xml

full-feed-running-shoes.xml 

<?xml version="1.0" encoding="UTF-8"?>
<ZONEO_FEED version="1.0" type="full">
    <FEED_INFO>
        <GENERATED_AT>2026-03-29T09:00:00Z</GENERATED_AT>
        <LOCALE>sk_SK</LOCALE>
        <COUNTRY>SK</COUNTRY>
        <CURRENCY>EUR</CURRENCY>
        <FORMAT_VERSION>1.0</FORMAT_VERSION>
    </FEED_INFO>
    <SHOP>
        <SHOP_ID>partner-running</SHOP_ID>
        <SHOP_NAME>RunLab</SHOP_NAME>
        <SHOP_URL>https://www.runlab.sk</SHOP_URL>
        <CONTACT_EMAIL>feed@runlab.sk</CONTACT_EMAIL>
    </SHOP>
    <ITEMS>
        <ITEM>
            <ITEM_ID>RUN-TRAIL-PRO-42</ITEM_ID>
            <PARENT_PRODUCT_ID>RUN-TRAIL-PRO</PARENT_PRODUCT_ID>
            <VARIANT_GROUP_ID>VG-RUN-TRAIL-PRO</VARIANT_GROUP_ID>
            <IS_VARIANT>true</IS_VARIANT>
            <NAME>Trail Pro 4 pánske bežecké topánky</NAME>
            <SHORT_DESCRIPTION>Ľahký trail model na technický terén.</SHORT_DESCRIPTION>
            <DESCRIPTION>Topánky s priemerným tlmením, dropom 8 mm a vysokou priľnavosťou na mokrom teréne.</DESCRIPTION>
            <PRODUCT_URL>https://www.runlab.sk/produkt/trail-pro-4-42</PRODUCT_URL>
            <BRAND>RunLab</BRAND>
            <MODEL>Trail Pro 4</MODEL>
            <SKU>RUN-TRAIL-PRO-42</SKU>
            <MPN>TRP4-BLK-42</MPN>
            <EAN>8591112223334</EAN>
            <CATEGORY_PATH>Beh &gt; Bežecké topánky &gt; Trailové</CATEGORY_PATH>
            <ZONEO_CATEGORY_HINT>beh/bezecke-topanky/trailove</ZONEO_CATEGORY_HINT>
            <SPORT>beh</SPORT>
            <DISCIPLINE>trail-running</DISCIPLINE>
            <GENDER>male</GENDER>
            <AGE_GROUP>adult</AGE_GROUP>
            <SEASON>year-round</SEASON>
            <TERRAIN>trail</TERRAIN>
            <COLOR>black</COLOR>
            <SIZE>42</SIZE>
            <SIZE_SYSTEM>EU</SIZE_SYSTEM>
            <MATERIAL>synthetic-mesh</MATERIAL>
            <WEIGHT>285</WEIGHT>
            <DROP>8</DROP>
            <CUSHIONING>medium</CUSHIONING>
            <WATERPROOF>false</WATERPROOF>
            <PRICE_VAT>139.90</PRICE_VAT>
            <OLD_PRICE_VAT>169.90</OLD_PRICE_VAT>
            <CURRENCY>EUR</CURRENCY>
            <VAT_RATE>23</VAT_RATE>
            <AVAILABILITY code="in_stock">Skladom</AVAILABILITY>
            <STOCK_QUANTITY>7</STOCK_QUANTITY>
            <DELIVERY_DAYS_MIN>1</DELIVERY_DAYS_MIN>
            <DELIVERY_DAYS_MAX>2</DELIVERY_DAYS_MAX>
            <DELIVERY_TEXT>U vás do 1-2 pracovných dní.</DELIVERY_TEXT>
            <SHIPPING_PRICE>0.00</SHIPPING_PRICE>
            <FREE_SHIPPING_FROM>60.00</FREE_SHIPPING_FROM>
            <MAIN_IMAGE>https://cdn.runlab.sk/products/trail-pro-4-main.jpg</MAIN_IMAGE>
            <IMAGES>
                <IMAGE type="gallery" sort_order="1">https://cdn.runlab.sk/products/trail-pro-4-1.jpg</IMAGE>
                <IMAGE type="gallery" sort_order="2">https://cdn.runlab.sk/products/trail-pro-4-2.jpg</IMAGE>
            </IMAGES>
            <ATTRIBUTES>
                <ATTRIBUTE code="terrain" label="Terén" type="string" filterable="true">trail</ATTRIBUTE>
                <ATTRIBUTE code="drop" label="Drop" type="decimal" unit="mm" filterable="true">8</ATTRIBUTE>
                <ATTRIBUTE code="waterproof" label="Vodoodolnosť" type="boolean" filterable="true">false</ATTRIBUTE>
                <ATTRIBUTE code="weight" label="Hmotnosť" type="decimal" unit="g" filterable="false">285</ATTRIBUTE>
            </ATTRIBUTES>
            <RETURN_DAYS>14</RETURN_DAYS>
            <WARRANTY_MONTHS>24</WARRANTY_MONTHS>
        </ITEM>
    </ITEMS>
</ZONEO_FEED>

full-feed-bike-product.xml

Príklad pre cyklistický produkt.

Rám, veľkosť kolies, brzdy a cyklistické parametre.

docs/examples/xml/full-feed-bike-product.xml

full-feed-bike-product.xml 

<?xml version="1.0" encoding="UTF-8"?>
<ZONEO_FEED version="1.0" type="full">
    <FEED_INFO>
        <GENERATED_AT>2026-03-29T09:15:00Z</GENERATED_AT>
        <LOCALE>sk_SK</LOCALE>
        <COUNTRY>SK</COUNTRY>
        <CURRENCY>EUR</CURRENCY>
        <FORMAT_VERSION>1.0</FORMAT_VERSION>
    </FEED_INFO>
    <SHOP>
        <SHOP_ID>partner-bike</SHOP_ID>
        <SHOP_NAME>BikeWorld</SHOP_NAME>
        <SHOP_URL>https://www.bikeworld.sk</SHOP_URL>
        <CONTACT_EMAIL>xml@bikeworld.sk</CONTACT_EMAIL>
    </SHOP>
    <ITEMS>
        <ITEM>
            <ITEM_ID>BIKE-XC-ALU-M</ITEM_ID>
            <PARENT_PRODUCT_ID>BIKE-XC-ALU</PARENT_PRODUCT_ID>
            <VARIANT_GROUP_ID>VG-BIKE-XC-ALU</VARIANT_GROUP_ID>
            <IS_VARIANT>true</IS_VARIANT>
            <NAME>Horský bicykel XC Alu 29 M</NAME>
            <SHORT_DESCRIPTION>Hardtail bicykel pre rekreačné aj športové jazdenie.</SHORT_DESCRIPTION>
            <DESCRIPTION>Hliníkový rám, 29" kolesá, hydraulické brzdy a 1x12 pohon.</DESCRIPTION>
            <PRODUCT_URL>https://www.bikeworld.sk/produkt/xc-alu-29-m</PRODUCT_URL>
            <BRAND>TrailBike</BRAND>
            <MANUFACTURER>TrailBike Europe</MANUFACTURER>
            <MODEL>XC Alu 29</MODEL>
            <SKU>BIKE-XC-ALU-M</SKU>
            <MPN>XCALU29-M</MPN>
            <GTIN>08590001122334</GTIN>
            <CATEGORY_PATH>Cyklistika &gt; Bicykle &gt; Horské bicykle</CATEGORY_PATH>
            <ZONEO_CATEGORY_HINT>cyklistika/bicykle/horske</ZONEO_CATEGORY_HINT>
            <SPORT>cyklistika</SPORT>
            <DISCIPLINE>mtb</DISCIPLINE>
            <GENDER>unisex</GENDER>
            <AGE_GROUP>adult</AGE_GROUP>
            <SEASON>year-round</SEASON>
            <FRAME_SIZE>M</FRAME_SIZE>
            <WHEEL_SIZE>29</WHEEL_SIZE>
            <BRAKE_TYPE>hydraulic-disc</BRAKE_TYPE>
            <COLOR>graphite</COLOR>
            <MATERIAL>aluminium</MATERIAL>
            <WEIGHT>13.2</WEIGHT>
            <PRICE_VAT>1299.00</PRICE_VAT>
            <CURRENCY>EUR</CURRENCY>
            <VAT_RATE>23</VAT_RATE>
            <AVAILABILITY code="preorder">Predobjednávka</AVAILABILITY>
            <STOCK_QUANTITY>0</STOCK_QUANTITY>
            <DELIVERY_DAYS_MIN>5</DELIVERY_DAYS_MIN>
            <DELIVERY_DAYS_MAX>10</DELIVERY_DAYS_MAX>
            <DELIVERY_TEXT>Dodanie 5-10 pracovných dní.</DELIVERY_TEXT>
            <SHIPPING_PRICE>9.90</SHIPPING_PRICE>
            <FREE_SHIPPING_FROM>1500.00</FREE_SHIPPING_FROM>
            <MAIN_IMAGE>https://cdn.bikeworld.sk/products/xc-alu-29-m-main.jpg</MAIN_IMAGE>
            <IMAGES>
                <IMAGE type="gallery" sort_order="1">https://cdn.bikeworld.sk/products/xc-alu-29-m-1.jpg</IMAGE>
                <IMAGE type="gallery" sort_order="2">https://cdn.bikeworld.sk/products/xc-alu-29-m-2.jpg</IMAGE>
            </IMAGES>
            <ATTRIBUTES>
                <ATTRIBUTE code="wheel_size" label="Veľkosť kolies" type="decimal" unit="in" filterable="true">29</ATTRIBUTE>
                <ATTRIBUTE code="frame_material" label="Materiál rámu" type="string" filterable="true">aluminium</ATTRIBUTE>
                <ATTRIBUTE code="brake_type" label="Typ brzd" type="string" filterable="true">hydraulic-disc</ATTRIBUTE>
            </ATTRIBUTES>
            <RETURN_DAYS>14</RETURN_DAYS>
            <WARRANTY_MONTHS>24</WARRANTY_MONTHS>
        </ITEM>
    </ITEMS>
</ZONEO_FEED>

full-feed-fitness-product.xml

Príklad pre fitness produkt (kettlebell).

Jednoduchý produkt s hmotnosťou, materiálom a galériou.

docs/examples/xml/full-feed-fitness-product.xml

full-feed-fitness-product.xml 

<?xml version="1.0" encoding="UTF-8"?>
<ZONEO_FEED version="1.0" type="full">
    <FEED_INFO>
        <GENERATED_AT>2026-03-29T09:30:00Z</GENERATED_AT>
        <LOCALE>sk_SK</LOCALE>
        <COUNTRY>SK</COUNTRY>
        <CURRENCY>EUR</CURRENCY>
        <FORMAT_VERSION>1.0</FORMAT_VERSION>
    </FEED_INFO>
    <SHOP>
        <SHOP_ID>partner-fitness</SHOP_ID>
        <SHOP_NAME>FitMarket</SHOP_NAME>
        <SHOP_URL>https://www.fitmarket.sk</SHOP_URL>
        <CONTACT_EMAIL>feed@fitmarket.sk</CONTACT_EMAIL>
    </SHOP>
    <ITEMS>
        <ITEM>
            <ITEM_ID>FIT-KB-16</ITEM_ID>
            <PARENT_PRODUCT_ID>FIT-KB</PARENT_PRODUCT_ID>
            <VARIANT_GROUP_ID>VG-FIT-KB</VARIANT_GROUP_ID>
            <IS_VARIANT>true</IS_VARIANT>
            <NAME>Kettlebell 16 kg</NAME>
            <SHORT_DESCRIPTION>Liatinový kettlebell pre silový a kondičný tréning.</SHORT_DESCRIPTION>
            <DESCRIPTION>Kompaktný kettlebell s ergonomickou rukoväťou a odolným povrchom.</DESCRIPTION>
            <PRODUCT_URL>https://www.fitmarket.sk/produkt/kettlebell-16kg</PRODUCT_URL>
            <BRAND>CoreLift</BRAND>
            <MODEL>KB Iron</MODEL>
            <SKU>FIT-KB-16</SKU>
            <MPN>KB-IRON-16</MPN>
            <EAN>8581234500016</EAN>
            <CATEGORY_PATH>Fitness &gt; Činky &gt; Kettlebell</CATEGORY_PATH>
            <ZONEO_CATEGORY_HINT>fitness/cinky/kettlebell</ZONEO_CATEGORY_HINT>
            <SPORT>fitness</SPORT>
            <DISCIPLINE>strength-training</DISCIPLINE>
            <GENDER>unisex</GENDER>
            <AGE_GROUP>adult</AGE_GROUP>
            <SEASON>year-round</SEASON>
            <MATERIAL>cast-iron</MATERIAL>
            <WEIGHT>16000</WEIGHT>
            <PRICE_VAT>49.90</PRICE_VAT>
            <OLD_PRICE_VAT>59.90</OLD_PRICE_VAT>
            <CURRENCY>EUR</CURRENCY>
            <VAT_RATE>23</VAT_RATE>
            <AVAILABILITY code="in_stock">Skladom</AVAILABILITY>
            <STOCK_QUANTITY>24</STOCK_QUANTITY>
            <DELIVERY_DAYS_MIN>1</DELIVERY_DAYS_MIN>
            <DELIVERY_DAYS_MAX>3</DELIVERY_DAYS_MAX>
            <DELIVERY_TEXT>U vás do 1-3 pracovných dní.</DELIVERY_TEXT>
            <SHIPPING_PRICE>4.90</SHIPPING_PRICE>
            <FREE_SHIPPING_FROM>80.00</FREE_SHIPPING_FROM>
            <MAIN_IMAGE>https://cdn.fitmarket.sk/products/kettlebell-16-main.jpg</MAIN_IMAGE>
            <IMAGES>
                <IMAGE type="gallery" sort_order="1">https://cdn.fitmarket.sk/products/kettlebell-16-1.jpg</IMAGE>
                <IMAGE type="gallery" sort_order="2">https://cdn.fitmarket.sk/products/kettlebell-16-2.jpg</IMAGE>
            </IMAGES>
            <ATTRIBUTES>
                <ATTRIBUTE code="weight_kg" label="Hmotnosť" type="decimal" unit="kg" filterable="true" variant_axis="true">16</ATTRIBUTE>
                <ATTRIBUTE code="material" label="Materiál" type="string" filterable="true">cast-iron</ATTRIBUTE>
                <ATTRIBUTE code="coating" label="Povrch" type="string" filterable="false">powder-coat</ATTRIBUTE>
            </ATTRIBUTES>
            <RETURN_DAYS>14</RETURN_DAYS>
            <WARRANTY_MONTHS>24</WARRANTY_MONTHS>
        </ITEM>
    </ITEMS>
</ZONEO_FEED>

S. Checklist pred odoslaním

Pred prvým odoslaním odporúčame prejsť tento checklist. Pomáha zachytiť chyby, ktoré by inak zhoršili import, párovanie produktov, kategorizáciu alebo verejné zobrazenie produktov.

Technická kontrola

  • Feed je validné XML v UTF-8 bez neuzavretých tagov a bez nebezpečného HTML v názvoch alebo popisoch.
  • Root má version="1.0" a type="full".
  • Každý ITEM má stabilný ITEM_ID, PRODUCT_URL, NAME, PRICE_VAT, CURRENCY, AVAILABILITY, kategóriu, obrázok a značku alebo výrobcu.
  • Varianty majú samostatné ITEMy a spoločné VARIANT_GROUP_ID.
  • Ceny používajú bodku, menu je ISO 4217 a stará cena nie je nižšia ako aktuálna cena.
  • Obrázky a produktové URL sú verejne dostupné cez HTTPS.
  • Kategórie sú stabilné naprieč exportmi a obsahujú čo najpresnejšiu kategóriovú cestu obchodu.
  • Športové filtre a ATTRIBUTES sú doplnené pri produktoch, kde dávajú zmysel.
  • Export neobsahuje duplicitné ITEM_ID v rámci jedného shopu.

Kvalita dát

  • Používajte stabilné ITEM_ID a nemeňte ich pri každom exporte.
  • Každú predajnú variantu posielajte ako samostatný ITEM.
  • Neposielajte nekvalitné názvy s HTML alebo skriptami.
  • Nepoužívajte obrázky s vodoznakom.
  • Zlepšujte párovanie cez EAN/GTIN/MPN/BRAND.
  • Udržujte presné skladové dáta a reálne rozsahy doručenia.
  • Pravidelne validujte feed pred odoslaním.