Przejdź do głównej treści

Zoneo XML Feed v1.0

Pełna specyfikacja eksportu ofert produktowych dla polskiego sklepu. Nazwy elementów XML i wartości słownikowe zapisuj dokładnie tak, jak w dokumentacji. Nazwy produktów i opisy przekazuj po polsku.

Wprowadzenie Link do sekcji Wprowadzenie

Zoneo XML Feed v1.0 służy do importu ofert produktowych. Jeden element ITEM opisuje jedną konkretną ofertę lub jeden sprzedawany wariant. Feed obejmuje pełny aktualny eksport sklepu, a nie wyłącznie zmiany od poprzedniego pliku.

Obecnie obsługiwany jest wyłącznie type="full". Zachowuj stałe identyfikatory ofert, produktów nadrzędnych i grup wariantów.

Wersja

1.0

obowiązujący format techniczny

Typ feedu

full

wersja 1.0 nie obsługuje eksportu przyrostowego

Kodowanie

UTF-8

polskie znaki zapisuj bezpośrednio w XML

Model

1 ITEM = 1 oferta

każdy sprzedawany wariant stanowi osobny ITEM

Szybki start Link do sekcji Szybki start

1. Wygeneruj pełny plik XML

Element główny ZONEO_FEED musi mieć version="1.0" i type="full" oraz zawierać sekcje FEED_INFO, SHOP i ITEMS.

2. Uzupełnij wymagane dane

Każda oferta potrzebuje stałego ID, nazwy, adresu produktu, ceny, waluty, dostępności, kategorii, zdjęcia, marki lub producenta oraz co najmniej jednego identyfikatora produktu.

3. Rozdziel warianty

Rozmiary, kolory i inne sprzedawane warianty eksportuj jako osobne elementy ITEM. Łącz je przez VARIANT_GROUP_ID i PARENT_PRODUCT_ID.

4. Dodaj parametry sportowe

Podstawowe filtry umieść w polach oferty, parametry szczegółowe w ATTRIBUTES, a dodatkowe jawne filtry w opcjonalnej sekcji FILTERS.

5. Sprawdź plik przed zgłoszeniem

Usuń błędy krytyczne i przejrzyj ostrzeżenia. Poprawność składni i schematu nie zastępuje kontroli jakości oferty ani zatwierdzenia sklepu.

Struktura pliku i reguły formatu Link do sekcji Struktura pliku i reguły formatu

Sekcja FEED_INFO opisuje eksport, SHOP zawiera dane sklepu, a ITEMS jest listą ofert ITEM. Dla polskiego rynku używaj pl_PL, PL i PLN. Zapisuj liczby z kropką, czas w ISO 8601, a znaki specjalne zgodnie z XML, np. & zamiast samego znaku & w tekście.

Szkielet pełnego feedu

<?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>
Reguły formatu Zoneo XML v1.0
RegułaWartośćPoziom
Element głównyZONEO_FEED z version="1.0" i type="full".ERROR
UnikalnośćITEM_ID jest unikalny w ramach SHOP_ID i nie zmienia się między eksportami.ERROR
Adresy URLWszystkie adresy URL są bezwzględne i zaczynają się od http:// lub https://.ERROR
CenaPRICE_VAT to liczba dziesiętna z kropką, nie mniejsza niż 0.ERROR
DostępnośćAVAILABILITY@code zawiera jedną z dozwolonych wartości słownikowych.ERROR
KategoriaWymagane jest CATEGORY_PATH lub CATEGORY_ID. Zalecamy oba pola.ERROR
ZdjęcieMAIN_IMAGE to publicznie dostępny, bezwzględny adres zdjęcia bez znaku wodnego.ERROR
IdentyfikatoryWymagany jest co najmniej jeden z: SKU, EAN, GTIN, MPN, MERCHANT_PRODUCT_REF.ERROR
BiddingITEM/BIDDING/MAX_CPC jest rezerwą techniczną dla przyszłej funkcji. Obecnie wartości z feedu nie sterują stawkami ani naliczaniem opłat.INFO

Pola wymagane Link do sekcji Pola wymagane

Wymagane pola oferty
Pole / ścieżkaTypWymagalnośćOpisPrzykładUwagi
ITEM_IDstringtakStały, unikalny identyfikator oferty.RUN-XPRO3-BLK-42Unikalny w ramach SHOP_ID. Nie zmieniaj go przy kolejnych eksportach.
PRODUCT_URLurltakAdres produktu lub konkretnego wariantu w sklepie.https://example.com/produkty/buty-42Bezwzględny adres http/https. Bezpośrednio do oferty sklepu.
NAMEstringtakNazwa oferty.Buty do biegania X-Pro 3Czytelny polski tekst bez skryptów i niebezpiecznego HTML.
PRICE_VATdecimaltakAktualna cena brutto.129.90Liczba z kropką, nie mniejsza niż 0.
CURRENCYstringtakWaluta ceny oferty.PLNKod ISO 4217. Dla polskiego rynku PLN.
AVAILABILITYelementtakDostępność oferty.<AVAILABILITY code="in_stock">W magazynie</AVAILABILITY>Atrybut code musi zawierać dozwoloną wartość słownikową.
CATEGORY_PATH lub CATEGORY_IDstringtakKategoria produktu.Bieganie > Buty do biegania > TerenoweWymagane jest co najmniej jedno z tych pól.
MAIN_IMAGEurltakGłówne zdjęcie oferty.https://example.com/images/buty.jpgPublicznie dostępny bezwzględny adres zdjęcia bez znaku wodnego.
BRAND lub MANUFACTURERstringtakMarka lub producent.PrzykładowaMarkaWymagane jest co najmniej jedno z tych pól.
SKU/EAN/GTIN/MPN/MERCHANT_PRODUCT_REFstringtakStały identyfikator do łączenia produktów.SKU RUN-XPRO3-BLK-42Wymagany jest co najmniej jeden identyfikator z tej grupy.

Pełna tabela referencyjna pól Link do sekcji Pełna tabela referencyjna pól

„Warunkowo” oznacza zależność od pozostałych pól. Kategoria wymaga CATEGORY_PATH lub CATEGORY_ID, marka wymaga BRAND lub MANUFACTURER, a oferta co najmniej jednego identyfikatora produktu. Pola wewnątrz opcjonalnej sekcji są wymagane, gdy wysyłasz tę sekcję.

Dane feedu
Pole / ścieżkaTypWymagalnośćOpisPrzykładUwagi
ZONEO_FEED@versionstringtakWersja formatu.1.0Stała wartość dla tego formatu.
ZONEO_FEED@typeenumtakTyp eksportu.fullEksport przyrostowy nie jest obsługiwany w wersji 1.0.
FEED_INFO/GENERATED_ATdatetimetakCzas wygenerowania eksportu.2026-10-22T10:00:00ZFormat ISO 8601 z informacją o strefie czasowej.
FEED_INFO/LOCALEstringtakJęzyk i region feedu.pl_PLPolski feed dla rynku PL.
FEED_INFO/COUNTRYstringtakKraj feedu.PLDwuliterowy kod ISO kraju.
FEED_INFO/CURRENCYstringtakDomyślna waluta feedu.PLNKod ISO 4217 zgodny z rynkiem i walutą ofert.
Dane sklepu
Pole / ścieżkaTypWymagalnośćOpisPrzykładUwagi
SHOP/SHOP_IDstringtakStały identyfikator sklepu.sklep-001Nie zmieniaj go między eksportami.
SHOP/SHOP_NAMEstringtakNazwa sklepu.Przykładowy sklep sportowyRzeczywista nazwa sklepu partnera.
SHOP/SHOP_URLurltakStrona sklepu.https://example.comBezwzględny adres http/https.
SHOP/CONTACT_EMAILstringtakKontakt techniczny dotyczący feedu.feed@example.comAktualny adres osoby lub zespołu odpowiedzialnego za eksport.
Podstawowe dane ITEM
Pole / ścieżkaTypWymagalnośćOpisPrzykładUwagi
ITEM_IDstringtakStały, unikalny identyfikator oferty.RUN-XPRO3-BLK-42Unikalny w ramach SHOP_ID. Nie zmieniaj go przy kolejnych eksportach.
PRODUCT_URLurltakAdres produktu lub konkretnego wariantu w sklepie.https://example.com/produkty/buty-42Bezwzględny adres http/https. Bezpośrednio do oferty sklepu.
NAMEstringtakNazwa oferty.Buty do biegania X-Pro 3Czytelny polski tekst bez skryptów i niebezpiecznego HTML.
PRICE_VATdecimaltakAktualna cena brutto.129.90Liczba z kropką, nie mniejsza niż 0.
CURRENCYstringtakWaluta ceny oferty.PLNKod ISO 4217. Dla polskiego rynku PLN.
AVAILABILITYelementtakDostępność oferty.<AVAILABILITY code="in_stock">W magazynie</AVAILABILITY>Atrybut code musi zawierać dozwoloną wartość słownikową.
CATEGORY_PATH lub CATEGORY_IDstringtakKategoria produktu.Bieganie > Buty do biegania > TerenoweWymagane jest co najmniej jedno z tych pól.
MAIN_IMAGEurltakGłówne zdjęcie oferty.https://example.com/images/buty.jpgPublicznie dostępny bezwzględny adres zdjęcia bez znaku wodnego.
BRAND lub MANUFACTURERstringtakMarka lub producent.PrzykładowaMarkaWymagane jest co najmniej jedno z tych pól.
SKU/EAN/GTIN/MPN/MERCHANT_PRODUCT_REFstringtakStały identyfikator do łączenia produktów.SKU RUN-XPRO3-BLK-42Wymagany jest co najmniej jeden identyfikator z tej grupy.
SHORT_DESCRIPTIONstringzalecaneKrótki opis oferty.Lekkie buty do biegania w terenie.Pomaga przedstawić produkt na liście i w szczegółach.
DESCRIPTIONstringzalecanePełny opis produktu.Opis konstrukcji, zastosowania i parametrów produktu.Przekazuj rzeczywiste cechy, bez skryptów i niebezpiecznego HTML.
VARIANT_GROUP_IDstringzalecaneStały identyfikator grupy wariantów.VG-RUN-XPRO3Taka sama wartość dla wariantów jednego produktu.
PARENT_PRODUCT_IDstringzalecaneIdentyfikator produktu nadrzędnego w systemie sklepu.RUN-XPRO3Łączy warianty tego samego produktu.
SPORT, DISCIPLINEstringzalecaneSport i dyscyplina.bieganie, trail-runningDane wykorzystywane przy kategoryzacji i filtrowaniu.
COLOR, SIZE, SIZE_SYSTEMstringzalecaneKolor, rozmiar i system rozmiarów.black, 42, EUPrzekazuj oddzielnie dla każdego wariantu.
OLD_PRICE_VATdecimalzalecanePoprzednia cena brutto.159.90Nie może być niższa niż PRICE_VAT. Przekazuj wyłącznie zgodne z prawdą dane cenowe.
STOCK_QUANTITYintegerzalecaneLiczba sztuk w magazynie.8Nieujemna liczba całkowita.
DELIVERY_DAYS_MIN/MAXintegerzalecaneMinimalny i maksymalny czas dostawy w dniach.1 / 2Osobne pola DELIVERY_DAYS_MIN i DELIVERY_DAYS_MAX. MIN nie może przekraczać MAX.
IMAGES/IMAGElistzalecaneDodatkowe zdjęcia produktu.<IMAGE type="gallery" sort_order="1">https://example.com/images/buty-bok.jpg</IMAGE>Opcjonalne atrybuty: type, sort_order, alt, title.
ATTRIBUTESblockzalecaneSzczegółowe parametry sportowe.drop, terrain, waterproofStałe kody, typy danych i jednostki ułatwiają filtrowanie.
Identyfikatory i marka
Pole / ścieżkaTypWymagalnośćOpisPrzykładUwagi
BRANDstringwarunkowoMarka produktu.PrzykładowaMarkaWymagane jest BRAND lub MANUFACTURER.
MANUFACTURERstringwarunkowoProducent produktu.PrzykładowyProducentUzupełnij, gdy marka nie jest dostępna.
MODELstringzalecaneModel produktu.X-Pro 3Pomaga łączyć oferty tego samego produktu.
SKUstringwarunkowoKod magazynowy produktu w sklepie.RUN-XPRO3-BLK-42Zachowaj stałą wartość.
EAN / GTINstringzalecaneGlobalny identyfikator produktu.08591234000001Zapisuj jako tekst, zachowując początkowe zera. Używaj rzeczywistego kodu produktu.
MPNstringzalecaneKod produktu nadany przez producenta.XPRO3-42-BLKPomaga łączyć oferty, gdy EAN nie jest dostępny.
Kategorie
Pole / ścieżkaTypWymagalnośćOpisPrzykładUwagi
CATEGORY_PATHstringwarunkowoPełna ścieżka kategorii sklepu.Bieganie > Buty do biegania > TerenoweStała, możliwie dokładna hierarchia kategorii.
CATEGORY_IDstringwarunkowoWewnętrzny identyfikator kategorii sklepu.run-trail-shoesStały między eksportami. Wymagane jest CATEGORY_ID lub CATEGORY_PATH.
CATEGORY_NAMEstringopcjonalneNazwa kategorii końcowej.Terenowe buty do bieganiaDodatkowy kontekst dla mapowania i obsługi technicznej.
ZONEO_CATEGORY_HINTstringopcjonalnePomocnicza wskazówka mapowania do kategorii Zoneo.bieganie/buty-do-biegania/terenoweNie zastępuje wymaganej kategorii ani zatwierdzenia mapowania.
PRODUCT_TYPEstringopcjonalneRodzaj produktu niezależny od kategorii.running-shoesUżywaj spójnych wartości słownikowych.
Warianty
Pole / ścieżkaTypWymagalnośćOpisPrzykładUwagi
PARENT_PRODUCT_IDstringzalecaneIdentyfikator produktu nadrzędnego w systemie sklepu.RUN-XPRO3Łączy warianty tego samego produktu.
VARIANT_GROUP_IDstringzalecaneStały identyfikator grupy wariantów.VG-RUN-XPRO3Taka sama wartość dla wariantów jednego produktu.
IS_VARIANTbooleanopcjonalneOznaczenie sprzedawanego wariantu.trueDozwolone wartości: true i false.
PRIMARY_VARIANT_LABELstringopcjonalneKrótka nazwa wariantu.42 EU / czarnyUłatwia prezentację oferty i obsługę techniczną.
Zdjęcia i multimedia
Pole / ścieżkaTypWymagalnośćOpisPrzykładUwagi
MAIN_IMAGEurltakGłówne zdjęcie oferty.https://example.com/images/buty.jpgPublicznie dostępny bezwzględny adres zdjęcia bez znaku wodnego.
IMAGES/IMAGEurlopcjonalneDodatkowe zdjęcia produktu.<IMAGE type="gallery" sort_order="1">https://example.com/images/buty-bok.jpg</IMAGE>Opcjonalne atrybuty: type, sort_order, alt, title.
VIDEO_URLurlopcjonalneAdres filmu o produkcie.https://example.com/videos/produkt.mp4Opcjonalny bezwzględny adres http/https.
SIZE_CHART_URLurlopcjonalneAdres tabeli rozmiarów.https://example.com/rozmiary.pdfOpcjonalny bezwzględny adres http/https.
Ceny i dostępność
Pole / ścieżkaTypWymagalnośćOpisPrzykładUwagi
PRICE_VATdecimaltakAktualna cena brutto.129.90Liczba z kropką, nie mniejsza niż 0.
OLD_PRICE_VATdecimalopcjonalnePoprzednia cena brutto.159.90Nie może być niższa niż PRICE_VAT. Przekazuj wyłącznie zgodne z prawdą dane cenowe.
CURRENCYstringtakWaluta ceny oferty.PLNKod ISO 4217. Dla polskiego rynku PLN.
AVAILABILITY@codeenumtakKod dostępności.in_stockUżywaj wyłącznie wartości z podanego słownika.
STOCK_QUANTITYintegerzalecaneLiczba sztuk w magazynie.8Nieujemna liczba całkowita.
DELIVERY_DAYS_MIN/MAXintegerzalecaneMinimalny i maksymalny czas dostawy w dniach.1 / 2Osobne pola DELIVERY_DAYS_MIN i DELIVERY_DAYS_MAX. MIN nie może przekraczać MAX.
SHIPPING_PRICEdecimalzalecaneKoszt dostawy.9.90W walucie oferty. Przekazuj rzeczywiste warunki dostawy.
FREE_SHIPPING_FROMdecimalzalecanePróg darmowej dostawy.199.00W walucie oferty. Uzupełnij, jeśli ma zastosowanie.
Bidding w feedzie Zoneo XML
Pole / ścieżkaTypWymagalnośćOpisPrzykładUwagi
BIDDINGblockopcjonalneOpcjonalna sekcja maksymalnej ceny za kliknięcie.<BIDDING>...</BIDDING>Bezpośrednie dziecko ITEM. Kolejność bezpośrednich pól ITEM w XSD jest dowolna. Funkcja obecnie nieaktywna.
BIDDING/MAX_CPCdecimaltak, w tej sekcjiPrzyszła maksymalna stawka CPC netto w głównej jednostce waluty.0.25Wartość dodatnia, kropka i najwyżej dwa miejsca po przecinku. 0.25 ilustruje zapis. Nie jest stawką zalecaną ani minimalną. Zero nie służy do wyłączania kampanii.
MAX_CPC@placementstringtak, w tej sekcjiKod miejsca emisji.product_detailDozwolone miejsce w tym formacie Zoneo XML.
MAX_CPC@currencystringtak, w tej sekcjiWaluta maksymalnej stawki CPC.PLNMusi dokładnie odpowiadać ITEM/CURRENCY, walucie feedu i rynku.
Pola sportowe
Pole / ścieżkaTypWymagalnośćOpisPrzykładUwagi
SPORTstringzalecaneSport.bieganiePodstawowy kontekst dla filtrów.
DISCIPLINEstringzalecaneDyscyplina.trail-runningDokładniejsze określenie sportu.
GENDERstring/enumzalecanePrzeznaczenie według płci.unisexZalecane wartości słownikowe podano poniżej.
AGE_GROUPstring/enumzalecaneGrupa wiekowa.adultZalecane wartości słownikowe podano poniżej.
SEASONstring/enumzalecaneSezon.all-seasonZalecane wartości słownikowe podano poniżej.
COLOR, SIZE, SIZE_SYSTEMstringzalecaneKolor, rozmiar i system rozmiarów.black, 42, EUPrzekazuj oddzielnie dla każdego wariantu.
MATERIALstringzalecaneMateriał produktu.synthetic-meshZachowuj spójne nazewnictwo materiałów.
ATTRIBUTES
Pole / ścieżkaTypWymagalnośćOpisPrzykładUwagi
ATTRIBUTES/ATTRIBUTE@codestringtakStały kod maszynowy atrybutu.dropNie tłumacz kodów. Nazwa dla użytkownika należy do label.
ATTRIBUTES/ATTRIBUTE@labelstringzalecaneNazwa atrybutu wyświetlana użytkownikowi.AmortyzacjaDla polskiego feedu przekazuj polską nazwę.
ATTRIBUTES/ATTRIBUTE@typeenumtakTyp wartości atrybutu.decimalDozwolone: string, integer, decimal, boolean, enum.
ATTRIBUTES/ATTRIBUTE@unitstringopcjonalneJednostka wartości.mmOpcjonalna. Oddziel liczbę od jednostki.
ATTRIBUTES/ATTRIBUTE@filterablebooleanzalecaneOznaczenie parametru do filtrowania.trueDozwolone wartości: true i false.
ATTRIBUTES/ATTRIBUTEvaluetakWartość atrybutu.8Musi odpowiadać zadeklarowanemu typowi.
FILTERS
Pole / ścieżkaTypWymagalnośćOpisPrzykładUwagi
FILTERSblockopcjonalneOpcjonalna sekcja jawnych filtrów.<FILTERS>...</FILTERS>Używaj, jeśli eksport zawiera gotowe filtry.
FILTERS/FILTER@codestringtakKod maszynowy filtra.surfaceZachowuj te same kody między eksportami.
FILTERS/FILTERvaluetakWartość filtra.roadJeśli istnieje odpowiadające pole bezpośrednio w ITEM, ma ono pierwszeństwo przed FILTERS.
Treść i informacje o ofercie
Pole / ścieżkaTypWymagalnośćOpisPrzykładUwagi
FEATURES/FEATURElistopcjonalneKrótka cecha lub zaleta produktu.<FEATURE>Oddychająca cholewka</FEATURE>Jedna cecha na element FEATURE.
BENEFITSstringopcjonalneOpis zalet produktu.Stabilność w terenieKonkretne, zgodne z produktem informacje.
PACKAGE_CONTENTstringopcjonalneZawartość opakowania.1 × kettlebellIstotne zwłaszcza dla zestawów i wyposażenia.
RETURN_DAYSintegerzalecanePodany przez sklep termin zwrotu w dniach.14Opis warunków oferty. Pole nie ustanawia ani nie ogranicza praw klienta.
WARRANTY_MONTHSintegerzalecanePodany okres gwarancji w miesiącach.24Przekazuj wyłącznie rzeczywiste warunki gwarancji produktu.

Warianty Link do sekcji Warianty

Każdy rozmiar, kolor i inna osobno sprzedawana konfiguracja ma własne ITEM_ID, cenę, dostępność i adres prowadzący do właściwej oferty. Warianty jednego produktu łącz przez wspólne VARIANT_GROUP_ID i PARENT_PRODUCT_ID. Kolor i rozmiar przekazuj w osobnych polach, zamiast dopisywać wszystkie możliwości do jednej nazwy.

Fragment oferty: klucze wariantu

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

Fragment pokazuje klucze wariantu. Pełny ITEM musi zawierać również wszystkie wymagane pola oferty.

Zdjęcia i multimedia Link do sekcji Zdjęcia i multimedia

MAIN_IMAGE jest głównym zdjęciem oferty. Dodatkowe zdjęcia przekazuj jako IMAGES/IMAGE. Wszystkie adresy muszą być bezwzględne i publicznie dostępne, bez logowania. Używaj zdjęć produktu bez znaków wodnych i treści reklamowych. Zalecamy HTTPS.

Opcjonalny atrybut type ma wartości main, gallery, swatch, size-chart, packaging, lifestyle. Atrybut sort_order określa kolejność. alt i title opisują zdjęcie. Film i tabelę rozmiarów można dodać przez VIDEO_URL i SIZE_CHART_URL.

Ceny i dostępność Link do sekcji Ceny i dostępność

PRICE_VAT oznacza aktualną cenę brutto. Używaj kropki dziesiętnej, bez symbolu waluty i separatorów tysięcy. Cena nie może być ujemna. OLD_PRICE_VAT jest opcjonalna i nie może być niższa niż cena aktualna. Waluta oferty i feedu na rynku polskim to PLN.

Kod AVAILABILITY@code wybierz z poniższej listy. Tekst wewnątrz elementu może być po polsku, np. „W magazynie”. STOCK_QUANTITY jest nieujemną liczbą całkowitą. DELIVERY_DAYS_MIN nie może przekraczać DELIVERY_DAYS_MAX.

  • in_stock
  • out_of_stock
  • preorder
  • backorder
  • discontinued
  • on_request

in_stock — w magazynie, out_of_stock — brak w magazynie, preorder — przedsprzedaż, backorder — zamówienie z późniejszą dostawą, discontinued — produkt wycofany, on_request — dostępność na zapytanie. Koszt dostawy i próg darmowej dostawy przekazuj przez SHIPPING_PRICE i FREE_SHIPPING_FROM.

Bidding w feedzie Zoneo XML Link do sekcji Bidding w feedzie Zoneo XML

W przygotowaniu · obecnie nieaktywne

Opcjonalne BIDDING należy umieścić bezpośrednio w ITEM, poza FEED_INFO, SHOP i ATTRIBUTES. Kolejność bezpośrednich pól ITEM w schemacie jest dowolna. Nie zmieniaj wersji feedu: nadal obowiązuje version="1.0".

Fragment ITEM: opcjonalna sekcja BIDDING

<BIDDING>
  <MAX_CPC placement="product_detail" currency="PLN">0.25</MAX_CPC>
</BIDDING>

MAX_CPC określa przyszłą maksymalną cenę netto za kliknięcie w głównej jednostce waluty, z placement="product_detail". Wartość musi być dodatnia, mieć kropkę i najwyżej dwa miejsca po przecinku. Waluta musi dokładnie odpowiadać walucie oferty, feedu i rynku. Wartość 0 nie służy do wyłączania kampanii.

Wartość 0.25 pokazuje wyłącznie poprawny zapis. Nie jest ceną zalecaną ani minimalną. Wartości BIDDING z XML obecnie nie wpływają na stawki, emisję ani naliczanie opłat. Samo dodanie tej sekcji nie aktywuje kampanii i nie zmienia warunków współpracy.

Identyfikatory Link do sekcji Identyfikatory

ITEM_ID identyfikuje ofertę w sklepie. Do łączenia produktów wymagany jest dodatkowo co najmniej jeden z: SKU, EAN, GTIN, MPN, MERCHANT_PRODUCT_REF. Globalne kody zapisuj jako tekst z zachowaniem początkowych zer. Nie wymyślaj brakujących kodów. Uzupełnij rzeczywistą markę BRAND lub producenta MANUFACTURER, a w miarę możliwości również MODEL.

Kategorie Link do sekcji Kategorie

Wymagane jest CATEGORY_PATH lub CATEGORY_ID. Zalecamy oba pola. Przekazuj stałe identyfikatory i pełną hierarchię sklepu, np. „Bieganie > Buty do biegania > Terenowe”. CATEGORY_NAME opisuje kategorię końcową, ZONEO_CATEGORY_HINT pomaga w mapowaniu, a PRODUCT_TYPE określa rodzaj produktu niezależnie od drzewa kategorii. Wskazówka nie zastępuje weryfikacji mapowania przez Zoneo.

Atrybuty i filtry sportowe Link do sekcji Atrybuty i filtry sportowe

Podstawowe cechy umieszczaj w polach SPORT, DISCIPLINE, GENDER, AGE_GROUP, SEASON, COLOR, SIZE, SIZE_SYSTEM i MATERIAL. Poniższe wartości słownikowe pozostają kodami technicznymi i nie podlegają tłumaczeniu.

GENDER
male, female, unisex, kids
AGE_GROUP
adult, kids, junior, senior
skill_level / level
all-levels, beginner, intermediate, advanced, professional
SEASON
spring-summer, autumn-winter, all-season
PRODUCT_TYPE
running-shoes, yoga-mat, cycling-helmet, adjustable-dumbbell, hiking-backpack, soccer-ball, hockey-stick, swim-goggles, ski-jacket, whey-protein, protein
Atrybuty według rodzaju produktu
ProduktSportPrzykładowe atrybuty
Buty do bieganiabieganiedrop, surface, terrain, cushioning, waterproof, reflective, pronation_support
Mata do jogijogathickness, material, non_slip, latex_free, carry_strap, practice_type
Kask rowerowykolarstwohelmet_size, head_circumference, ventilation_channels, fit_system, certification, removable_padding
Hantel / kettlebellfitnessitem_weight, material, training_type, grip, coating, shape, commercial_use
Plecak turystycznyturystykacapacity, back_system, rain_cover, hydration_compatible, hip_belt, water_resistance
Piłka nożnapiłka nożnaball_size, surface, construction, material, fifa_quality, training_match, bladder
Kij hokejowyhokejhandedness, flex, blade_curve, stick_length, material, kick_point, level
Okulary pływackiepływanielens_type, uv_protection, anti_fog, strap_type, bridge, lens_material, seal_material
Kurtka narciarskasporty zimowewater_column, breathability, insulation, hood, snow_skirt, ski_pass_pocket, fit
Odżywka białkowaodżywki dla sportowcówflavour, package_weight, protein_per_serving, servings, protein_source, gluten_free, lactose_free

Sekcje ATTRIBUTES i FILTERS Link do sekcji Sekcje ATTRIBUTES i FILTERS

Każdy ATTRIBUTE ma stały code, nazwę label, type i wartość zgodną z typem. Dozwolone typy: string, integer, decimal, boolean, enum. Jednostkę zapisuj w unit, a możliwość filtrowania w filterable="true". Wartości logiczne to true i false.

Atrybuty produktu

<ATTRIBUTES>
    <ATTRIBUTE code="drop" label="Drop" type="decimal" unit="mm" filterable="true">8</ATTRIBUTE>
    <ATTRIBUTE code="surface" label="Nawierzchnia" type="enum" filterable="true">road</ATTRIBUTE>
    <ATTRIBUTE code="cushioning" label="Amortyzacja" type="enum" filterable="true">medium</ATTRIBUTE>
    <ATTRIBUTE code="reflective" label="Elementy odblaskowe" type="boolean" filterable="true">true</ATTRIBUTE>
</ATTRIBUTES>

FILTERS jest opcjonalnym zbiorem gotowych filtrów. Każdy FILTER ma kod i wartość. Jeżeli ta sama cecha występuje w polu bezpośrednio w ITEM, to pole ma pierwszeństwo przed FILTERS.

Jawne filtry produktu

<FILTERS>
    <FILTER code="sport">bieganie</FILTER>
    <FILTER code="surface">road</FILTER>
    <FILTER code="cushioning">medium</FILTER>
</FILTERS>
Katalog atrybutów sportowych
KodTypJednostkaWartościZastosowanie
product_typeenum-running-shoes, yoga-mat, cycling-helmet, adjustable-dumbbell, hiking-backpack, soccer-ball, hockey-stick, swim-goggles, ski-jacket, whey-protein, proteinRodzaj produktu do łączenia ofert, wyszukiwania i filtrów.
genderenum-male, female, unisex, kidsPrzeznaczenie produktu według płci.
age_groupenum-adult, junior, kids, seniorGrupa wiekowa.
skill_level / levelenum-all-levels, beginner, intermediate, advanced, professionalPoziom zaawansowania użytkownika.
seasonenum-spring-summer, autumn-winter, all-seasonSezonowość produktu.
item_weightdecimalg lub kgliczbaMasa produktu, a nie przesyłki.
item_length / item_width / item_heightdecimalcm lub mmliczbaWymiary produktu, a nie opakowania.
surface / terrainenum-road, asphalt, trail, track, grass, artificial-turf, indoor, mixedNawierzchnia dla biegania, sportów piłkarskich i innych dyscyplin.
dropdecimalmmliczbaRóżnica wysokości podeszwy pod piętą i palcami.
cushioningenum-low, medium, highPoziom amortyzacji obuwia.
pronation_supportenum-neutral, stability, supinationRodzaj wsparcia stopy w obuwiu.
waterproof / reflectiveboolean-true, falseWodoodporność i elementy odblaskowe obuwia lub odzieży.
thicknessdecimalmmliczbaGrubość maty.
non_slip / latex_free / carry_strapboolean-true, falseWłaściwości maty do jogi lub pilatesu.
practice_type / training_typeenum-yoga-pilates, strength-trainingRodzaj treningu.
helmet_size / head_circumferencestring / decimalcm dla obwodunp. M, 54-58Rozmiar kasku i obwód głowy.
ventilation_channelsinteger-liczbaLiczba otworów wentylacyjnych.
fit_systemenum-dial-fitSystem regulacji kasku.
gripenum/string-knurled-steel lub własny tekstRodzaj uchwytu hantla.
coatingenum-rubberPowłoka sprzętu fitness.
shapeenum-round, hex, rectangularKształt hantla lub sprzętu.
package_itemsintegerpcsliczbaLiczba sztuk w opakowaniu.
capacitydecimallliczbaPojemność plecaka lub naczynia.
back_systemenum-ventilatedSystem nośny plecaka.
rain_cover / hydration_compatible / hip_beltboolean-true, falseWyposażenie plecaka turystycznego.
water_resistanceenum-water-resistantOdporność plecaka lub sprzętu na wodę.
ball_sizestring-np. 5Rozmiar piłki.
constructionenum-machine-stitchedKonstrukcja piłki.
fifa_qualityboolean-true, falseOznaczenie jakości piłki nożnej.
training_match / bladderenum-training-match, butylPrzeznaczenie i dętka piłki.
handednessenum-left, rightStrona trzymania kija.
flex / stick_lengthdecimalflex lub cmliczbaElastyczność i długość kija hokejowego.
blade_curve / kick_pointstring / enum-low, mid, high dla kick_pointProfil łopatki i punkt ugięcia kija.
lens_typeenum-clear, smoke, mirrored, polarizedRodzaj soczewek okularów sportowych lub pływackich.
anti_fog / uv_protectionboolean-true, falseOchrona przed parowaniem i promieniowaniem UV.
strap_type / bridgeenum-double-silicone, adjustablePasek i mostek nosowy.
lens_material / seal_materialenum-polycarbonate, siliconeMateriał soczewek i uszczelki.
swim_useenum-pool-training, open-water, competition, recreationalZastosowanie okularów pływackich.
water_column / breathabilityintegermm / g/m2/24hliczbaWodoodporność i oddychalność odzieży outdoorowej lub narciarskiej.
insulationenum-syntheticRodzaj ocieplenia odzieży.
hoodenum/boolean-removable, fixed lub true/falseRodzaj kaptura.
snow_skirt / ski_pass_pocketboolean-true, falseWyposażenie kurtki narciarskiej.
flavourenum/string-vanilla, chocolate, strawberry lub własny tekstSmak odżywki.
package_weightdecimalgliczbaMasa opakowania odżywki.
protein_per_serving / sugar_per_servingdecimalgliczbaIlość białka i cukru w porcji.
servingsinteger-liczbaLiczba porcji.
protein_sourceenum-whey, casein, plantŹródło białka.
gluten_free / lactose_free / veganboolean-true, falseWłaściwości dietetyczne produktu.
supplement_formenum-powder, capsules, tablet, liquidPostać suplementu.
mix / blendstring-krótki tekstMieszanka lub receptura produktu.

Walidacja Link do sekcji Walidacja

Sprawdź składnię XML, strukturę i typy pól, następnie reguły oferty oraz jakość treści. Zgodność ze schematem XML nie dowodzi dostępności zdjęć, poprawnego mapowania kategorii ani spełnienia warunków publikacji.

ERROR

Błąd uniemożliwia przetworzenie feedu lub publikację oferty.

  • Brak ITEM_ID
  • Nieprawidłowy URL
  • Brak PRICE_VAT
  • Powtórzone ITEM_ID

WARNING

Feed można przetworzyć, ale jakość danych jest obniżona.

  • Brak EAN
  • Brak DESCRIPTION
  • Brak STOCK_QUANTITY

INFO / ZALECENIE

Wskazówki poprawiające łączenie produktów, filtrowanie i prezentację.

  • Uzupełnij ZONEO_CATEGORY_HINT
  • Dodaj parametry sportowe
  • Dodaj galerię zdjęć

Najczęstsze błędy Link do sekcji Najczęstsze błędy

Najczęstsze błędy i sposoby ich poprawy
ProblemPoziomJak poprawić
Brak MAIN_IMAGEERRORDodaj publiczny, bezwzględny adres głównego zdjęcia do każdej oferty.
Względny adres URLERRORUżywaj pełnych adresów zaczynających się od http:// lub https://.
Nieprawidłowa walutaERRORDla polskiego rynku stosuj PLN zgodnie z ISO 4217.
Powtórzone ITEM_IDERRORNadaj każdej ofercie i każdemu wariantowi własne stałe ID w ramach sklepu.
Brak identyfikatora produktuERRORUzupełnij co najmniej jedno z: SKU, EAN, GTIN, MPN, MERCHANT_PRODUCT_REF.
Połączone warianty sprzedażoweWARNINGEksportuj każdy wariant jako osobny ITEM, łącząc je przez VARIANT_GROUP_ID.
Nieprawidłowa dostępnośćERRORUżyj jednej z dozwolonych wartości AVAILABILITY@code.
Nieprawidłowy zapis cenyERRORStosuj liczbę dziesiętną z kropką, bez symbolu waluty i separatorów tysięcy.
BIDDING na niewłaściwym poziomieBIDDINGUmieść sekcję bezpośrednio w ITEM, poza FEED_INFO, SHOP i ATTRIBUTES. Kolejność bezpośrednich pól ITEM jest dowolna.
Nieprawidłowe MAX_CPC lub walutaBIDDINGUżyj product_detail, liczby dodatniej z kropką i najwyżej dwoma miejscami po przecinku oraz waluty zgodnej z ofertą i rynkiem.
Niespójna ścieżka kategoriiWARNINGPrzekazuj rzeczywistą, stałą hierarchię kategorii sklepu.

Przykładowy feed Link do sekcji Przykładowy feed

Dziesięć fikcyjnych ofert z polskimi opisami i walutą PLN, w tym dwa warianty obuwia. Adresy example.com i obrazy zastępcze służą wyłącznie do testowania formatu. Przed zgłoszeniem sklepu zastąp je własnymi ofertami, cenami, danymi kontaktowymi i zdjęciami.

Otwórz przykładowy plik XML

Przykładowy polski feed Zoneo XML

<?xml version="1.0" encoding="UTF-8"?>
<!-- Fikcyjne oferty do testowania formatu. Zastąp danymi własnego sklepu; BIDDING jest obecnie nieaktywne. -->
<ZONEO_FEED version="1.0" type="full">
    <FEED_INFO>
        <GENERATED_AT>2026-10-22T10:00:00Z</GENERATED_AT>
        <LOCALE>pl_PL</LOCALE>
        <COUNTRY>PL</COUNTRY>
        <CURRENCY>PLN</CURRENCY>
        <FORMAT_VERSION>1.0</FORMAT_VERSION>
        <ENVIRONMENT>staging</ENVIRONMENT>
    </FEED_INFO>
    <SHOP>
        <SHOP_ID>przykladowy-sklep-pl</SHOP_ID>
        <SHOP_NAME>Przykładowy sklep sportowy</SHOP_NAME>
        <SHOP_URL>https://example.com</SHOP_URL>
        <CONTACT_EMAIL>feed@example.com</CONTACT_EMAIL>
    </SHOP>
    <ITEMS>
        <ITEM>
            <ITEM_ID>PL-RUN-42</ITEM_ID>
            <MERCHANT_PRODUCT_REF>PL-RUN-42</MERCHANT_PRODUCT_REF>
            <PARENT_PRODUCT_ID>PL-ROADFLEX</PARENT_PRODUCT_ID>
            <VARIANT_GROUP_ID>PL-VG-ROADFLEX</VARIANT_GROUP_ID>
            <IS_VARIANT>true</IS_VARIANT>
            <PRIMARY_VARIANT_LABEL>42 EU / czarny</PRIMARY_VARIANT_LABEL>
            <NAME>Buty do biegania RoadFlex, rozmiar 42</NAME>
            <SHORT_DESCRIPTION>Lekkie buty treningowe na asfalt z amortyzacją i elementami odblaskowymi.</SHORT_DESCRIPTION>
            <DESCRIPTION>Lekkie buty treningowe na asfalt z amortyzacją i elementami odblaskowymi.</DESCRIPTION>
            <PRODUCT_URL>https://example.com/produkty/run-42</PRODUCT_URL>
            <BRAND>PrzykładowaMarka</BRAND>
            <SKU>PL-RUN-42</SKU>
            <CATEGORY_ID>pl-running-shoes</CATEGORY_ID>
            <CATEGORY_PATH>Bieganie &gt; Buty do biegania &gt; Szosowe</CATEGORY_PATH>
            <SPORT>bieganie</SPORT>
            <PRODUCT_TYPE>running-shoes</PRODUCT_TYPE>
            <GENDER>unisex</GENDER>
            <AGE_GROUP>adult</AGE_GROUP>
            <SEASON>all-season</SEASON>
            <SIZE>42</SIZE>
            <SIZE_SYSTEM>EU</SIZE_SYSTEM>
            <COLOR>black</COLOR>
            <PRICE_VAT>349.90</PRICE_VAT>
            <CURRENCY>PLN</CURRENCY>
            <BIDDING>
                <MAX_CPC placement="product_detail" currency="PLN">0.25</MAX_CPC>
            </BIDDING>
            <SHIPPING_PRICE>9.90</SHIPPING_PRICE>
            <FREE_SHIPPING_FROM>199.00</FREE_SHIPPING_FROM>
            <AVAILABILITY code="in_stock">W magazynie</AVAILABILITY>
            <STOCK_QUANTITY>8</STOCK_QUANTITY>
            <DELIVERY_DAYS_MIN>1</DELIVERY_DAYS_MIN>
            <DELIVERY_DAYS_MAX>3</DELIVERY_DAYS_MAX>
            <DELIVERY_TEXT>Dostawa w ciągu 1–3 dni roboczych</DELIVERY_TEXT>
            <MAIN_IMAGE>https://placehold.co/1200x1200/png?text=RUN-42</MAIN_IMAGE>
            <IMAGES>
                <IMAGE type="gallery" sort_order="1" alt="Buty RoadFlex z boku">https://placehold.co/1200x900/png?text=RoadFlex</IMAGE>
            </IMAGES>
            <ATTRIBUTES>
                <ATTRIBUTE code="product_type" label="Rodzaj produktu" type="enum" filterable="true">running-shoes</ATTRIBUTE>
                <ATTRIBUTE code="drop" label="Drop" type="decimal" unit="mm" filterable="true">8</ATTRIBUTE>
                <ATTRIBUTE code="surface" label="Nawierzchnia" type="enum" filterable="true">road</ATTRIBUTE>
                <ATTRIBUTE code="cushioning" label="Amortyzacja" type="enum" filterable="true">medium</ATTRIBUTE>
                <ATTRIBUTE code="reflective" label="Elementy odblaskowe" type="boolean" filterable="true">true</ATTRIBUTE>
            </ATTRIBUTES>
        </ITEM>
        <ITEM>
            <ITEM_ID>PL-RUN-43</ITEM_ID>
            <MERCHANT_PRODUCT_REF>PL-RUN-43</MERCHANT_PRODUCT_REF>
            <PARENT_PRODUCT_ID>PL-ROADFLEX</PARENT_PRODUCT_ID>
            <VARIANT_GROUP_ID>PL-VG-ROADFLEX</VARIANT_GROUP_ID>
            <IS_VARIANT>true</IS_VARIANT>
            <PRIMARY_VARIANT_LABEL>43 EU / czarny</PRIMARY_VARIANT_LABEL>
            <NAME>Buty do biegania RoadFlex, rozmiar 43</NAME>
            <SHORT_DESCRIPTION>Ten sam model i kolor obuwia, osobna oferta wariantu w rozmiarze 43.</SHORT_DESCRIPTION>
            <DESCRIPTION>Ten sam model i kolor obuwia, osobna oferta wariantu w rozmiarze 43.</DESCRIPTION>
            <PRODUCT_URL>https://example.com/produkty/run-43</PRODUCT_URL>
            <BRAND>PrzykładowaMarka</BRAND>
            <SKU>PL-RUN-43</SKU>
            <CATEGORY_ID>pl-running-shoes</CATEGORY_ID>
            <CATEGORY_PATH>Bieganie &gt; Buty do biegania &gt; Szosowe</CATEGORY_PATH>
            <SPORT>bieganie</SPORT>
            <PRODUCT_TYPE>running-shoes</PRODUCT_TYPE>
            <GENDER>unisex</GENDER>
            <AGE_GROUP>adult</AGE_GROUP>
            <SEASON>all-season</SEASON>
            <SIZE>43</SIZE>
            <SIZE_SYSTEM>EU</SIZE_SYSTEM>
            <COLOR>black</COLOR>
            <PRICE_VAT>349.90</PRICE_VAT>
            <CURRENCY>PLN</CURRENCY>
            <SHIPPING_PRICE>9.90</SHIPPING_PRICE>
            <FREE_SHIPPING_FROM>199.00</FREE_SHIPPING_FROM>
            <AVAILABILITY code="in_stock">W magazynie</AVAILABILITY>
            <STOCK_QUANTITY>8</STOCK_QUANTITY>
            <DELIVERY_DAYS_MIN>1</DELIVERY_DAYS_MIN>
            <DELIVERY_DAYS_MAX>3</DELIVERY_DAYS_MAX>
            <DELIVERY_TEXT>Dostawa w ciągu 1–3 dni roboczych</DELIVERY_TEXT>
            <MAIN_IMAGE>https://placehold.co/1200x1200/png?text=RUN-43</MAIN_IMAGE>
            <ATTRIBUTES>
                <ATTRIBUTE code="product_type" label="Rodzaj produktu" type="enum" filterable="true">running-shoes</ATTRIBUTE>
                <ATTRIBUTE code="drop" label="Drop" type="decimal" unit="mm" filterable="true">8</ATTRIBUTE>
                <ATTRIBUTE code="surface" label="Nawierzchnia" type="enum" filterable="true">road</ATTRIBUTE>
            </ATTRIBUTES>
        </ITEM>
        <ITEM>
            <ITEM_ID>PL-YOGA-6</ITEM_ID>
            <MERCHANT_PRODUCT_REF>PL-YOGA-6</MERCHANT_PRODUCT_REF>
            <NAME>Mata do jogi BalanceGrip 6 mm</NAME>
            <SHORT_DESCRIPTION>Mata do jogi i pilatesu z powierzchnią antypoślizgową i paskiem do przenoszenia.</SHORT_DESCRIPTION>
            <DESCRIPTION>Mata do jogi i pilatesu z powierzchnią antypoślizgową i paskiem do przenoszenia.</DESCRIPTION>
            <PRODUCT_URL>https://example.com/produkty/yoga-6</PRODUCT_URL>
            <BRAND>PrzykładowaMarka</BRAND>
            <SKU>PL-YOGA-6</SKU>
            <CATEGORY_ID>pl-yoga-mat</CATEGORY_ID>
            <CATEGORY_PATH>Joga i pilates &gt; Maty</CATEGORY_PATH>
            <SPORT>joga</SPORT>
            <PRODUCT_TYPE>yoga-mat</PRODUCT_TYPE>
            <GENDER>unisex</GENDER>
            <AGE_GROUP>adult</AGE_GROUP>
            <SEASON>all-season</SEASON>
            <PRICE_VAT>119.90</PRICE_VAT>
            <CURRENCY>PLN</CURRENCY>
            <SHIPPING_PRICE>9.90</SHIPPING_PRICE>
            <FREE_SHIPPING_FROM>199.00</FREE_SHIPPING_FROM>
            <AVAILABILITY code="in_stock">W magazynie</AVAILABILITY>
            <STOCK_QUANTITY>8</STOCK_QUANTITY>
            <DELIVERY_DAYS_MIN>1</DELIVERY_DAYS_MIN>
            <DELIVERY_DAYS_MAX>3</DELIVERY_DAYS_MAX>
            <DELIVERY_TEXT>Dostawa w ciągu 1–3 dni roboczych</DELIVERY_TEXT>
            <MAIN_IMAGE>https://placehold.co/1200x1200/png?text=YOGA-6</MAIN_IMAGE>
            <ATTRIBUTES>
                <ATTRIBUTE code="product_type" label="Rodzaj produktu" type="enum" filterable="true">yoga-mat</ATTRIBUTE>
                <ATTRIBUTE code="thickness" label="Grubość" type="decimal" unit="mm" filterable="true">6</ATTRIBUTE>
                <ATTRIBUTE code="non_slip" label="Powierzchnia antypoślizgowa" type="boolean" filterable="true">true</ATTRIBUTE>
                <ATTRIBUTE code="latex_free" label="Bez lateksu" type="boolean" filterable="true">true</ATTRIBUTE>
                <ATTRIBUTE code="practice_type" label="Rodzaj ćwiczeń" type="enum" filterable="true">yoga-pilates</ATTRIBUTE>
            </ATTRIBUTES>
        </ITEM>
        <ITEM>
            <ITEM_ID>PL-HELMET-M</ITEM_ID>
            <MERCHANT_PRODUCT_REF>PL-HELMET-M</MERCHANT_PRODUCT_REF>
            <NAME>Kask rowerowy AirSafe M</NAME>
            <SHORT_DESCRIPTION>Przykładowy kask rowerowy z regulacją obwodu i kanałami wentylacyjnymi.</SHORT_DESCRIPTION>
            <DESCRIPTION>Przykładowy kask rowerowy z regulacją obwodu i kanałami wentylacyjnymi.</DESCRIPTION>
            <PRODUCT_URL>https://example.com/produkty/helmet-m</PRODUCT_URL>
            <BRAND>PrzykładowaMarka</BRAND>
            <SKU>PL-HELMET-M</SKU>
            <CATEGORY_ID>pl-cycling-helmet</CATEGORY_ID>
            <CATEGORY_PATH>Kolarstwo &gt; Kaski rowerowe</CATEGORY_PATH>
            <SPORT>kolarstwo</SPORT>
            <PRODUCT_TYPE>cycling-helmet</PRODUCT_TYPE>
            <GENDER>unisex</GENDER>
            <AGE_GROUP>adult</AGE_GROUP>
            <SEASON>all-season</SEASON>
            <SIZE>M</SIZE>
            <PRICE_VAT>219.90</PRICE_VAT>
            <CURRENCY>PLN</CURRENCY>
            <SHIPPING_PRICE>9.90</SHIPPING_PRICE>
            <FREE_SHIPPING_FROM>199.00</FREE_SHIPPING_FROM>
            <AVAILABILITY code="in_stock">W magazynie</AVAILABILITY>
            <STOCK_QUANTITY>8</STOCK_QUANTITY>
            <DELIVERY_DAYS_MIN>1</DELIVERY_DAYS_MIN>
            <DELIVERY_DAYS_MAX>3</DELIVERY_DAYS_MAX>
            <DELIVERY_TEXT>Dostawa w ciągu 1–3 dni roboczych</DELIVERY_TEXT>
            <MAIN_IMAGE>https://placehold.co/1200x1200/png?text=HELMET-M</MAIN_IMAGE>
            <ATTRIBUTES>
                <ATTRIBUTE code="product_type" label="Rodzaj produktu" type="enum" filterable="true">cycling-helmet</ATTRIBUTE>
                <ATTRIBUTE code="helmet_size" label="Rozmiar kasku" type="string" filterable="true">M</ATTRIBUTE>
                <ATTRIBUTE code="head_circumference" label="Obwód głowy" type="decimal" unit="cm" filterable="true">56</ATTRIBUTE>
                <ATTRIBUTE code="ventilation_channels" label="Otwory wentylacyjne" type="integer" filterable="true">18</ATTRIBUTE>
                <ATTRIBUTE code="fit_system" label="System regulacji" type="enum" filterable="true">dial-fit</ATTRIBUTE>
            </ATTRIBUTES>
        </ITEM>
        <ITEM>
            <ITEM_ID>PL-DUMBBELL-12</ITEM_ID>
            <MERCHANT_PRODUCT_REF>PL-DUMBBELL-12</MERCHANT_PRODUCT_REF>
            <NAME>Hantel regulowany do 12 kg</NAME>
            <SHORT_DESCRIPTION>Przykładowy hantel regulowany do treningu siłowego z gumową powłoką.</SHORT_DESCRIPTION>
            <DESCRIPTION>Przykładowy hantel regulowany do treningu siłowego z gumową powłoką.</DESCRIPTION>
            <PRODUCT_URL>https://example.com/produkty/dumbbell-12</PRODUCT_URL>
            <BRAND>PrzykładowaMarka</BRAND>
            <SKU>PL-DUMBBELL-12</SKU>
            <CATEGORY_ID>pl-adjustable-dumbbell</CATEGORY_ID>
            <CATEGORY_PATH>Fitness &gt; Trening siłowy &gt; Hantle</CATEGORY_PATH>
            <SPORT>fitness</SPORT>
            <PRODUCT_TYPE>adjustable-dumbbell</PRODUCT_TYPE>
            <GENDER>unisex</GENDER>
            <AGE_GROUP>adult</AGE_GROUP>
            <SEASON>all-season</SEASON>
            <PRICE_VAT>159.90</PRICE_VAT>
            <CURRENCY>PLN</CURRENCY>
            <SHIPPING_PRICE>9.90</SHIPPING_PRICE>
            <FREE_SHIPPING_FROM>199.00</FREE_SHIPPING_FROM>
            <AVAILABILITY code="in_stock">W magazynie</AVAILABILITY>
            <STOCK_QUANTITY>8</STOCK_QUANTITY>
            <DELIVERY_DAYS_MIN>1</DELIVERY_DAYS_MIN>
            <DELIVERY_DAYS_MAX>3</DELIVERY_DAYS_MAX>
            <DELIVERY_TEXT>Dostawa w ciągu 1–3 dni roboczych</DELIVERY_TEXT>
            <MAIN_IMAGE>https://placehold.co/1200x1200/png?text=DUMBBELL-12</MAIN_IMAGE>
            <ATTRIBUTES>
                <ATTRIBUTE code="product_type" label="Rodzaj produktu" type="enum" filterable="true">adjustable-dumbbell</ATTRIBUTE>
                <ATTRIBUTE code="item_weight" label="Masa produktu" type="decimal" unit="kg" filterable="true">12</ATTRIBUTE>
                <ATTRIBUTE code="training_type" label="Rodzaj treningu" type="enum" filterable="true">strength-training</ATTRIBUTE>
                <ATTRIBUTE code="coating" label="Powłoka" type="enum" filterable="true">rubber</ATTRIBUTE>
                <ATTRIBUTE code="shape" label="Kształt" type="enum" filterable="true">hex</ATTRIBUTE>
            </ATTRIBUTES>
        </ITEM>
        <ITEM>
            <ITEM_ID>PL-PACK-35</ITEM_ID>
            <MERCHANT_PRODUCT_REF>PL-PACK-35</MERCHANT_PRODUCT_REF>
            <NAME>Plecak turystyczny TrailPack 35 l</NAME>
            <SHORT_DESCRIPTION>Plecak z wentylowanym systemem nośnym, pasem biodrowym i pokrowcem przeciwdeszczowym.</SHORT_DESCRIPTION>
            <DESCRIPTION>Plecak z wentylowanym systemem nośnym, pasem biodrowym i pokrowcem przeciwdeszczowym.</DESCRIPTION>
            <PRODUCT_URL>https://example.com/produkty/pack-35</PRODUCT_URL>
            <BRAND>PrzykładowaMarka</BRAND>
            <SKU>PL-PACK-35</SKU>
            <CATEGORY_ID>pl-hiking-backpack</CATEGORY_ID>
            <CATEGORY_PATH>Turystyka &gt; Plecaki</CATEGORY_PATH>
            <SPORT>turystyka</SPORT>
            <PRODUCT_TYPE>hiking-backpack</PRODUCT_TYPE>
            <GENDER>unisex</GENDER>
            <AGE_GROUP>adult</AGE_GROUP>
            <SEASON>all-season</SEASON>
            <PRICE_VAT>299.90</PRICE_VAT>
            <CURRENCY>PLN</CURRENCY>
            <SHIPPING_PRICE>9.90</SHIPPING_PRICE>
            <FREE_SHIPPING_FROM>199.00</FREE_SHIPPING_FROM>
            <AVAILABILITY code="in_stock">W magazynie</AVAILABILITY>
            <STOCK_QUANTITY>8</STOCK_QUANTITY>
            <DELIVERY_DAYS_MIN>1</DELIVERY_DAYS_MIN>
            <DELIVERY_DAYS_MAX>3</DELIVERY_DAYS_MAX>
            <DELIVERY_TEXT>Dostawa w ciągu 1–3 dni roboczych</DELIVERY_TEXT>
            <MAIN_IMAGE>https://placehold.co/1200x1200/png?text=PACK-35</MAIN_IMAGE>
            <ATTRIBUTES>
                <ATTRIBUTE code="product_type" label="Rodzaj produktu" type="enum" filterable="true">hiking-backpack</ATTRIBUTE>
                <ATTRIBUTE code="capacity" label="Pojemność" type="decimal" unit="l" filterable="true">35</ATTRIBUTE>
                <ATTRIBUTE code="back_system" label="System nośny" type="enum" filterable="true">ventilated</ATTRIBUTE>
                <ATTRIBUTE code="rain_cover" label="Pokrowiec przeciwdeszczowy" type="boolean" filterable="true">true</ATTRIBUTE>
                <ATTRIBUTE code="hip_belt" label="Pas biodrowy" type="boolean" filterable="true">true</ATTRIBUTE>
            </ATTRIBUTES>
        </ITEM>
        <ITEM>
            <ITEM_ID>PL-BALL-5</ITEM_ID>
            <MERCHANT_PRODUCT_REF>PL-BALL-5</MERCHANT_PRODUCT_REF>
            <NAME>Piłka nożna MatchPlay, rozmiar 5</NAME>
            <SHORT_DESCRIPTION>Przykładowa piłka treningowa z szyciem maszynowym i dętką butylową.</SHORT_DESCRIPTION>
            <DESCRIPTION>Przykładowa piłka treningowa z szyciem maszynowym i dętką butylową.</DESCRIPTION>
            <PRODUCT_URL>https://example.com/produkty/ball-5</PRODUCT_URL>
            <BRAND>PrzykładowaMarka</BRAND>
            <SKU>PL-BALL-5</SKU>
            <CATEGORY_ID>pl-soccer-ball</CATEGORY_ID>
            <CATEGORY_PATH>Piłka nożna &gt; Piłki</CATEGORY_PATH>
            <SPORT>piłka nożna</SPORT>
            <PRODUCT_TYPE>soccer-ball</PRODUCT_TYPE>
            <GENDER>unisex</GENDER>
            <AGE_GROUP>adult</AGE_GROUP>
            <SEASON>all-season</SEASON>
            <SIZE>5</SIZE>
            <PRICE_VAT>89.90</PRICE_VAT>
            <CURRENCY>PLN</CURRENCY>
            <SHIPPING_PRICE>9.90</SHIPPING_PRICE>
            <FREE_SHIPPING_FROM>199.00</FREE_SHIPPING_FROM>
            <AVAILABILITY code="in_stock">W magazynie</AVAILABILITY>
            <STOCK_QUANTITY>8</STOCK_QUANTITY>
            <DELIVERY_DAYS_MIN>1</DELIVERY_DAYS_MIN>
            <DELIVERY_DAYS_MAX>3</DELIVERY_DAYS_MAX>
            <DELIVERY_TEXT>Dostawa w ciągu 1–3 dni roboczych</DELIVERY_TEXT>
            <MAIN_IMAGE>https://placehold.co/1200x1200/png?text=BALL-5</MAIN_IMAGE>
            <ATTRIBUTES>
                <ATTRIBUTE code="product_type" label="Rodzaj produktu" type="enum" filterable="true">soccer-ball</ATTRIBUTE>
                <ATTRIBUTE code="ball_size" label="Rozmiar piłki" type="string" filterable="true">5</ATTRIBUTE>
                <ATTRIBUTE code="construction" label="Konstrukcja" type="enum" filterable="true">machine-stitched</ATTRIBUTE>
                <ATTRIBUTE code="training_match" label="Przeznaczenie" type="enum" filterable="true">training-match</ATTRIBUTE>
                <ATTRIBUTE code="bladder" label="Dętka" type="enum" filterable="true">butyl</ATTRIBUTE>
            </ATTRIBUTES>
        </ITEM>
        <ITEM>
            <ITEM_ID>PL-GOGGLES-1</ITEM_ID>
            <MERCHANT_PRODUCT_REF>PL-GOGGLES-1</MERCHANT_PRODUCT_REF>
            <NAME>Okulary pływackie AquaClear</NAME>
            <SHORT_DESCRIPTION>Przykładowe okulary do treningu na basenie z regulowanym mostkiem.</SHORT_DESCRIPTION>
            <DESCRIPTION>Przykładowe okulary do treningu na basenie z regulowanym mostkiem.</DESCRIPTION>
            <PRODUCT_URL>https://example.com/produkty/goggles-1</PRODUCT_URL>
            <BRAND>PrzykładowaMarka</BRAND>
            <SKU>PL-GOGGLES-1</SKU>
            <CATEGORY_ID>pl-swim-goggles</CATEGORY_ID>
            <CATEGORY_PATH>Pływanie &gt; Okulary</CATEGORY_PATH>
            <SPORT>pływanie</SPORT>
            <PRODUCT_TYPE>swim-goggles</PRODUCT_TYPE>
            <GENDER>unisex</GENDER>
            <AGE_GROUP>adult</AGE_GROUP>
            <SEASON>all-season</SEASON>
            <PRICE_VAT>69.90</PRICE_VAT>
            <CURRENCY>PLN</CURRENCY>
            <SHIPPING_PRICE>9.90</SHIPPING_PRICE>
            <FREE_SHIPPING_FROM>199.00</FREE_SHIPPING_FROM>
            <AVAILABILITY code="in_stock">W magazynie</AVAILABILITY>
            <STOCK_QUANTITY>8</STOCK_QUANTITY>
            <DELIVERY_DAYS_MIN>1</DELIVERY_DAYS_MIN>
            <DELIVERY_DAYS_MAX>3</DELIVERY_DAYS_MAX>
            <DELIVERY_TEXT>Dostawa w ciągu 1–3 dni roboczych</DELIVERY_TEXT>
            <MAIN_IMAGE>https://placehold.co/1200x1200/png?text=GOGGLES-1</MAIN_IMAGE>
            <ATTRIBUTES>
                <ATTRIBUTE code="product_type" label="Rodzaj produktu" type="enum" filterable="true">swim-goggles</ATTRIBUTE>
                <ATTRIBUTE code="lens_type" label="Rodzaj soczewek" type="enum" filterable="true">clear</ATTRIBUTE>
                <ATTRIBUTE code="anti_fog" label="Ochrona przed parowaniem" type="boolean" filterable="true">true</ATTRIBUTE>
                <ATTRIBUTE code="bridge" label="Mostek nosowy" type="enum" filterable="true">adjustable</ATTRIBUTE>
                <ATTRIBUTE code="swim_use" label="Zastosowanie" type="enum" filterable="true">pool-training</ATTRIBUTE>
            </ATTRIBUTES>
        </ITEM>
        <ITEM>
            <ITEM_ID>PL-JACKET-M</ITEM_ID>
            <MERCHANT_PRODUCT_REF>PL-JACKET-M</MERCHANT_PRODUCT_REF>
            <NAME>Kurtka narciarska SnowLine M</NAME>
            <SHORT_DESCRIPTION>Przykładowa kurtka ocieplana z odpinanym kapturem i kieszenią na karnet.</SHORT_DESCRIPTION>
            <DESCRIPTION>Przykładowa kurtka ocieplana z odpinanym kapturem i kieszenią na karnet.</DESCRIPTION>
            <PRODUCT_URL>https://example.com/produkty/jacket-m</PRODUCT_URL>
            <BRAND>PrzykładowaMarka</BRAND>
            <SKU>PL-JACKET-M</SKU>
            <CATEGORY_ID>pl-ski-jacket</CATEGORY_ID>
            <CATEGORY_PATH>Sporty zimowe &gt; Narciarstwo &gt; Kurtki</CATEGORY_PATH>
            <SPORT>sporty zimowe</SPORT>
            <PRODUCT_TYPE>ski-jacket</PRODUCT_TYPE>
            <GENDER>unisex</GENDER>
            <AGE_GROUP>adult</AGE_GROUP>
            <SEASON>autumn-winter</SEASON>
            <SIZE>M</SIZE>
            <PRICE_VAT>499.90</PRICE_VAT>
            <CURRENCY>PLN</CURRENCY>
            <SHIPPING_PRICE>9.90</SHIPPING_PRICE>
            <FREE_SHIPPING_FROM>199.00</FREE_SHIPPING_FROM>
            <AVAILABILITY code="in_stock">W magazynie</AVAILABILITY>
            <STOCK_QUANTITY>8</STOCK_QUANTITY>
            <DELIVERY_DAYS_MIN>1</DELIVERY_DAYS_MIN>
            <DELIVERY_DAYS_MAX>3</DELIVERY_DAYS_MAX>
            <DELIVERY_TEXT>Dostawa w ciągu 1–3 dni roboczych</DELIVERY_TEXT>
            <MAIN_IMAGE>https://placehold.co/1200x1200/png?text=JACKET-M</MAIN_IMAGE>
            <ATTRIBUTES>
                <ATTRIBUTE code="product_type" label="Rodzaj produktu" type="enum" filterable="true">ski-jacket</ATTRIBUTE>
                <ATTRIBUTE code="water_column" label="Wodoodporność" type="integer" unit="mm" filterable="true">10000</ATTRIBUTE>
                <ATTRIBUTE code="breathability" label="Oddychalność" type="integer" unit="g/m2/24h" filterable="true">10000</ATTRIBUTE>
                <ATTRIBUTE code="hood" label="Kaptur" type="enum" filterable="true">removable</ATTRIBUTE>
                <ATTRIBUTE code="ski_pass_pocket" label="Kieszeń na karnet" type="boolean" filterable="true">true</ATTRIBUTE>
            </ATTRIBUTES>
        </ITEM>
        <ITEM>
            <ITEM_ID>PL-PROTEIN-900</ITEM_ID>
            <MERCHANT_PRODUCT_REF>PL-PROTEIN-900</MERCHANT_PRODUCT_REF>
            <NAME>Odżywka białkowa waniliowa 900 g</NAME>
            <SHORT_DESCRIPTION>Fikcyjny przykład parametrów odżywki: masa opakowania, smak i zawartość białka w porcji.</SHORT_DESCRIPTION>
            <DESCRIPTION>Fikcyjny przykład parametrów odżywki: masa opakowania, smak i zawartość białka w porcji.</DESCRIPTION>
            <PRODUCT_URL>https://example.com/produkty/protein-900</PRODUCT_URL>
            <BRAND>PrzykładowaMarka</BRAND>
            <SKU>PL-PROTEIN-900</SKU>
            <CATEGORY_ID>pl-whey-protein</CATEGORY_ID>
            <CATEGORY_PATH>Odżywki dla sportowców &gt; Białko</CATEGORY_PATH>
            <SPORT>odżywki dla sportowców</SPORT>
            <PRODUCT_TYPE>whey-protein</PRODUCT_TYPE>
            <GENDER>unisex</GENDER>
            <AGE_GROUP>adult</AGE_GROUP>
            <SEASON>all-season</SEASON>
            <PRICE_VAT>109.90</PRICE_VAT>
            <CURRENCY>PLN</CURRENCY>
            <SHIPPING_PRICE>9.90</SHIPPING_PRICE>
            <FREE_SHIPPING_FROM>199.00</FREE_SHIPPING_FROM>
            <AVAILABILITY code="in_stock">W magazynie</AVAILABILITY>
            <STOCK_QUANTITY>8</STOCK_QUANTITY>
            <DELIVERY_DAYS_MIN>1</DELIVERY_DAYS_MIN>
            <DELIVERY_DAYS_MAX>3</DELIVERY_DAYS_MAX>
            <DELIVERY_TEXT>Dostawa w ciągu 1–3 dni roboczych</DELIVERY_TEXT>
            <MAIN_IMAGE>https://placehold.co/1200x1200/png?text=PROTEIN-900</MAIN_IMAGE>
            <ATTRIBUTES>
                <ATTRIBUTE code="product_type" label="Rodzaj produktu" type="enum" filterable="true">whey-protein</ATTRIBUTE>
                <ATTRIBUTE code="flavour" label="Smak" type="enum" filterable="true">vanilla</ATTRIBUTE>
                <ATTRIBUTE code="package_weight" label="Masa opakowania" type="decimal" unit="g" filterable="true">900</ATTRIBUTE>
                <ATTRIBUTE code="protein_per_serving" label="Białko w porcji" type="decimal" unit="g" filterable="true">23</ATTRIBUTE>
                <ATTRIBUTE code="servings" label="Liczba porcji" type="integer" filterable="true">30</ATTRIBUTE>
                <ATTRIBUTE code="protein_source" label="Źródło białka" type="enum" filterable="true">whey</ATTRIBUTE>
            </ATTRIBUTES>
        </ITEM>
    </ITEMS>
</ZONEO_FEED>

Lista kontrolna przed zgłoszeniem feedu Link do sekcji Lista kontrolna przed zgłoszeniem feedu

Kontrola techniczna

  • Plik jest poprawnym XML w UTF-8, z zamkniętymi znacznikami, bez skryptów i niebezpiecznego HTML.
  • Element główny ma version="1.0" i type="full" oraz sekcje FEED_INFO, SHOP i ITEMS.
  • Każdy ITEM ma stałe ID, adres produktu, nazwę, cenę, walutę, dostępność, kategorię, zdjęcie, markę lub producenta i identyfikator produktu.
  • Każdy sprzedawany wariant stanowi osobny ITEM. Powiązane warianty mają wspólne VARIANT_GROUP_ID.
  • Ceny używają kropki, waluta jest zgodna z ISO 4217, a OLD_PRICE_VAT nie jest niższa niż PRICE_VAT.
  • Adresy produktów i zdjęć są publicznie dostępne. Zalecane jest HTTPS.
  • Kategorie są stałe między eksportami i odzwierciedlają rzeczywistą hierarchię sklepu.
  • Parametry sportowe, ATTRIBUTES i opcjonalne FILTERS opisują rzeczywiste cechy produktów.
  • Opcjonalne BIDDING jest bezpośrednio w ITEM. MAX_CPC ma placement="product_detail", zgodną walutę i dodatnią wartość z najwyżej dwoma miejscami po przecinku.
  • W obrębie jednego sklepu nie ma powtórzonych ITEM_ID.

Jakość danych

  • Nie zmieniaj ITEM_ID przy każdym eksporcie.
  • Rozdzielaj wszystkie sprzedawane warianty.
  • Przekazuj czytelne nazwy i pełne, zgodne z produktem opisy.
  • Używaj własnych, dobrej jakości zdjęć bez znaków wodnych.
  • Uzupełniaj EAN, GTIN, MPN i BRAND, aby ułatwić łączenie produktów.
  • Aktualizuj stany magazynowe, ceny i rzeczywiste terminy dostawy.
  • Regularnie sprawdzaj feed przed jego udostępnieniem.

Przygotuj feed i przejdź do kolejnego kroku Link do sekcji Przygotuj feed i przejdź do kolejnego kroku

Dodaj adres własnego feedu w panelu partnera. Rejestracja i poprawny XML nie uruchamiają publikacji ani płatnych kliknięć. Sklep, feed i konfiguracja wymagają weryfikacji przez Zoneo.