Feed produktowy XML dla Ceneo i porównywarek - struktura i typowe błędy

Łukasz Palej

Technical Implementation Expert

25.03.2026

Feed produktowy XML dla Ceneo i porównywarek - struktura i typowe błędy

Wsparcie programistyczne dla e-commerce

Łukasz PalejTechnical Implementation Expert

Programiści

Feed XML dla Ceneo to plik z elementem głównym offers, w którym każda oferta jest elementem o z atrybutami id, url, price i avail oraz elementami podrzędnymi cat, name, imgs, desc i attrs. Plik musi być dostępny pod stałym adresem bez hasła, a ceny i dostępność w nim muszą zgadzać się ze stroną sklepu. Najczęstsze błędy to zmieniające się identyfikatory ofert, ceny zapisane z przecinkiem, ogólne kategorie typu „Promocja”, brak EAN i marki oraz rozbieżności cen między plikiem a sklepem.

W tym wpisie pokazujemy, jak zbudować poprawny plik XML dla Ceneo krok po kroku, które pola są wymagane, jak działa tryb przyrostowy, co zmieniły wymagania GPSR i jak podejść do innych porównywarek cen. Tekst jest dla sprzedawców i programistów, którzy generują plik XML ze sklepu, integratora lub ERP i chcą, żeby oferty pojawiały się na Ceneo bez błędów i w dobrych kategoriach.

[#wazne] W skrócie: feed XML Ceneo to plik produktowy w formacie określonym przez Ceneo, z ofertami w elementach o i obowiązkowymi polami: id, url, price, avail, cat, name, imgs, desc i attrs. Generuje się go modułem sklepu, przez integrator, np. Base, albo własnym skryptem, a Ceneo pobiera go z publicznego adresu. Kluczowe są stałe identyfikatory, cena z kropką, precyzyjna kategoria oraz atrybuty Marka, Kod producenta i EAN. Programiści Vinson budują i naprawiają pliki XML dla Ceneo i innych porównywarek.

Czym jest feed produktowy XML dla Ceneo

Feed produktowy XML dla Ceneo to plik tekstowy, w którym sklep opisuje swoje oferty w strukturze zrozumiałej dla porównywarki. Ceneo regularnie pobiera plik z podanego adresu, łączy oferty z kartami produktów i pokazuje je przy porównaniu cen. Od jakości pliku zależy, czy oferta trafi do właściwej karty produktu, czy wyświetli się z aktualną ceną i czy w ogóle zostanie przyjęta.

Plik XML dla porównywarek cen nie jest uniwersalny. Każdy serwis ma własną specyfikację, własne nazwy pól i własne zasady. Ceneo ma najbardziej rozbudowaną dokumentację na polskim rynku, dlatego dobrze zbudowany plik dla Ceneo jest dobrym punktem wyjścia także dla innych porównywarek - ale przed podłączeniem każdej z nich trzeba sprawdzić jej instrukcję i dostosować generator.

Struktura pliku XML Ceneo - pola wymagane

Według instrukcji Ceneo plik zaczyna się od deklaracji XML z kodowaniem - zalecany jest UTF-8, dopuszczalne są też ISO-8859-2 i Windows-1250 - a elementem głównym jest offers z atrybutem version="1". Wewnątrz każda oferta to osobny element o (stan na marzec 2026 - sprawdź aktualną instrukcję Ceneo). Przykładowy początek oferty wygląda tak: <o id="1234" url="https://twojsklep.pl/p/1234" price="49.90" avail="1" stock="12">.

Elementy oferty dzielą się na atrybuty elementu o i elementy podrzędne:

[#chart:wpr33a]

Pole	Wymagane	Zasady według instrukcji Ceneo
id	Tak	Unikalny, do 100 znaków, nigdy nie używany ponownie
url	Tak	Adres strony produktu, do 1000 znaków
price	Tak	Liczba z kropką jako separatorem dziesiętnym
avail	Tak	Czas wysyłki: 1, 3, 7, 14, 90, 99 lub 110
stock, weight, basket	Nie	Stan w sztukach, waga w kg, dostępność w Kup Teraz (1 lub 0)
cat	Tak	Pełna ścieżka kategorii, do 255 znaków
name	Tak	Nazwa produktu bez dopisków handlowych, do 150 znaków
imgs	Tak	Zdjęcie main i dodatkowe i, łącznie do 20
desc	Tak	Opis w CDATA, do 100 000 znaków, ograniczony zestaw tagów HTML
attrs	Tak	Do 500 elementów a z atrybutem name

Wartości avail oznaczają czas wysyłki: 1 to wysyłka w ciągu 24 godzin, 3 do trzech dni, 7 do tygodnia, 14 do dwóch tygodni, 90 towar na zamówienie, 99 „sprawdź w sklepie”, a 110 przedsprzedaż (stan na marzec 2026 - sprawdź aktualną instrukcję Ceneo). Generator powinien wyliczać tę wartość z realnego stanu i czasu realizacji, a nie wpisywać na sztywno 1 dla wszystkich produktów.

[#tip] Ceneo zaleca opakowanie opisu w CDATA, a w przykładach instrukcji także nazwy, kategorii i wartości atrybutów. Generując plik, stosuj CDATA konsekwentnie albo poprawnie zamieniaj znaki specjalne, takie jak & i <, na encje. Jeden nieprawidłowy znak w opisie potrafi sprawić, że parser odrzuci cały plik, a nie tylko jedną ofertę.

Bezpłatna konsultacja programistyczna

Potrzebujesz programisty do sklepu, integracji lub automatyzacji?

Wycena zadania w 24 h w dni robocze
Integracje, API, feedy i poprawki w sklepie
Rozliczenie godzinowe albo za projekt

Konsultację poprowadzi Łukasz Palej, Technical Implementation Expert

Zobacz szczegóły usługi →

Atrybuty Marka, Kod producenta i EAN - jak je uzupełnić

Element attrs zawiera atrybuty w postaci <a name="EAN"><![CDATA[5901234123457]]></a>. Instrukcja Ceneo wyróżnia atrybuty integracyjne, które pomagają przypisać ofertę do właściwej karty produktu: Marka, Kod producenta (pisany ze spacją), EAN z 8 lub 13 cyframi, ISBN z 13 cyframi dla książek oraz Kod leku dla leków bez recepty i suplementów (stan na marzec 2026 - sprawdź aktualną instrukcję Ceneo).

To od tych atrybutów w dużej mierze zależy, czy oferta trafi do istniejącej karty produktu z porównaniem cen. Oferta bez EAN i kodu producenta jest trudniejsza do dopasowania, więc może trafić do złej karty albo pozostać bez porównania. Dlatego warto uzupełniać te dane w samym sklepie lub ERP, a nie dopisywać je ręcznie w pliku.

Poza atrybutami integracyjnymi istnieją atrybuty kluczowe dla filtrów w danej kategorii, np. rozmiar w modzie. Ich lista jest w osobnym pliku dla deweloperów udostępnianym przez Ceneo. Warianty, które nie zmieniają ceny, można podać w jednym atrybucie z wartościami rozdzielonymi średnikiem, np. smaki suplementu. Jeśli wariant zmienia cenę, trzeba go wysłać jako osobną ofertę.

GPSR w pliku XML Ceneo

Od 13 grudnia 2024 r. obowiązuje unijne rozporządzenie o ogólnym bezpieczeństwie produktów, w skrócie GPSR. Ceneo uwzględnił je w specyfikacji pliku: dla ofert w Kup Teraz plik powinien zawierać grupy responsibleProducers i responsiblePersons z danymi producenta i osoby odpowiedzialnej - nazwą, adresem i kontaktem e-mail - a każda oferta odwołuje się do nich przez atrybuty Producent odpowiedzialny, Podmiot odpowiedzialny i Informacje o bezpieczeństwie (stan na marzec 2026 - sprawdź aktualną instrukcję Ceneo).

Od strony programistycznej oznacza to, że generator musi mieć skąd wziąć dane producentów i osób odpowiedzialnych. W wielu sklepach te informacje nie są przypisane do produktów w uporządkowany sposób. Pierwszym krokiem jest więc ich uzupełnienie w sklepie, integratorze lub ERP. Kwestie prawne związane z GPSR, czyli kto jest podmiotem odpowiedzialnym i jakie informacje o bezpieczeństwie trzeba podać, warto skonsultować ze specjalistą.

Pełny plik czy tryb przyrostowy

Standardowo Ceneo pobiera cały plik z ofertami. Instrukcja opisuje też tryb przyrostowy: element offers dostaje atrybut fileVersion, zmienione oferty oznacza się atrybutem update="1" i przesyła tylko zmienione pola, ofertę ukrywa się przez price="0", a przywraca, wysyłając jej pełną definicję (stan na marzec 2026 - sprawdź aktualną instrukcję Ceneo). Który wariant wybrać?

[#chart:wpr33b]

Tryb przyrostowy wymaga od generatora zapamiętywania, co i kiedy zostało wysłane, więc jest trudniejszy w budowie i testowaniu. Pełny plik jest prostszy i odporniejszy na błędy, bo każde pobranie odtwarza całą ofertę od nowa. Dla większości sklepów pełny plik generowany regularnie w zupełności wystarcza.

Jak często generować feed XML dla Ceneo

Instrukcja Ceneo nie narzuca konkretnej częstotliwości, ale wymaga, żeby ceny i dostępność w pliku zgadzały się z tymi na stronie sklepu. W praktyce częstotliwość generowania pliku trzeba więc dopasować do tempa zmian w ofercie. Sklep z ustalonym cennikiem i rzadkimi dostawami może generować plik raz lub kilka razy dziennie. Sklep, który często zmienia ceny, prowadzi krótkie promocje albo sprzedaje towar z hurtowni o szybko zmieniających się stanach, potrzebuje częstszego odświeżania.

Generowanie dużego pliku obciąża serwer, dlatego warto robić je w tle, a nie przy każdym wejściu na adres pliku. Dobrą praktyką jest zapis pliku do katalogu tymczasowego i podmiana gotowego pliku dopiero po zakończeniu generowania. Dzięki temu porównywarka nigdy nie pobierze pliku uciętego w połowie. Generator powinien też porównać liczbę ofert z poprzednim przebiegiem i wstrzymać publikację, jeśli spadła drastycznie, bo zwykle oznacza to błąd w danych albo zapytaniu do bazy, a nie realną zmianę oferty.

Przy dużych katalogach warto rozważyć tryb przyrostowy albo przynajmniej generowanie w porcjach, z zapisem postępu. Pomaga też buforowanie danych, które zmieniają się rzadko, takich jak opisy i zdjęcia, oraz osobne, szybsze odświeżanie cen i stanów.

Typowe błędy w pliku XML dla Ceneo i porównywarek

Problemy z plikiem XML najczęściej mają kilka powtarzalnych przyczyn. Zanim zaczniesz zmieniać moduł lub integrator, sprawdź, czy nie chodzi o któryś z poniższych przypadków:

[#chart:wpr33c]

Do tego dochodzą błędy organizacyjne, które nie wynikają z samej struktury pliku:

plik wysyłany e-mailem - Ceneo go nie aktualizuje, plik musi być dostępny pod adresem bez hasła,
zmiana adresu pliku bez informacji - przy przenosinach sklepu lub zmianie modułu trzeba zgłosić nowy adres do Ceneo,
ponowne użycie id - identyfikatora usuniętej oferty nie należy przypisywać nowemu produktowi, nawet po długim czasie,
kategorie marketingowe - „Nowości”, „Wyprzedaż” czy „Promocja” zamiast najbardziej szczegółowej kategorii produktu,
informacje o sklepie w opisie - opis ma dotyczyć produktu i jego zastosowania, bez kosztów wysyłki i danych sklepu.

Najpoważniejszy problem to rozbieżność ceny lub dostępności między plikiem a sklepem. Instrukcja Ceneo wymaga, żeby były zgodne, a klient, który kliknie ofertę z niższą ceną i zobaczy wyższą, raczej nie kupi. Plik powinien powstawać z tych samych danych co strona produktu i być generowany na tyle często, by nadążać za zmianami. Jeśli stany zmieniają się w kilku kanałach naraz, najpierw uporządkuj ich źródło - piszemy o tym we wpisie synchronizacja stanów magazynowych między sklepem a marketplace.

[#uwaga] Przy podłączaniu Ceneo przez integrator sprawdź ograniczenia po jego stronie. Na przykład pomoc Base informuje, że na jednym koncie Ceneo można umieścić tylko jeden plik XML. Jeśli sprzedajesz z kilku źródeł, plik trzeba złożyć z nich wcześniej, a nie podłączać kilka plików do jednego konta.

Jak zbudować generator feedu XML dla wielu porównywarek

Jeśli sklep wysyła dane do Ceneo, Google Merchant Center i kilku innych serwisów, nie warto utrzymywać osobnej wtyczki dla każdego z nich. Lepiej zbudować jeden model danych produktowych - z identyfikatorem, EAN, marką, kodem producenta, ceną, stanem, czasem wysyłki, kategoriami i zdjęciami - i z niego generować pliki w formatach poszczególnych platform. Różnice między serwisami sprowadzają się wtedy do warstwy mapowania: inne nazwy pól, inne wartości dostępności, inny sposób zapisu kategorii.

Zbierz dane w jednym miejscu - sklep, integrator lub ERP, z uzupełnionymi EAN, markami i kodami producenta.
Ustal mapowanie dla każdej platformy - pola, wartości dostępności, kategorie i atrybuty wymagane.
Generuj pliki cyklicznie - według harmonogramu i po większych zmianach cen.
Waliduj przed publikacją - poprawność XML, liczba ofert, brak pustych cen i nazw.
Monitoruj odrzucenia - raporty z paneli porównywarek wracają do zespołu jako lista poprawek w źródle danych.

Taki generator łatwo rozszerzyć o kolejne kanały, a poprawka w danych produktowych trafia od razu do wszystkich plików. Jak wygląda to samo podejście po stronie Google, opisujemy we wpisie feed produktowy dla Google Merchant Center - jak go wygenerować i utrzymać.

Jak Vinson pomaga z plikiem XML dla Ceneo

Programiści Vinson analizują obecny plik XML i raporty z Ceneo, porządkują dane źródłowe i konfigurują moduł sklepu albo integrator, np. Base, którego jesteśmy certyfikowanym partnerem. Gdy gotowe rozwiązania nie wystarczają, piszemy własny generator feedu dla Ceneo i innych porównywarek, z poprawnym kodowaniem, mapowaniem kategorii, atrybutami integracyjnymi, danymi GPSR i kontrolą poprawności przed publikacją. Szczegóły znajdziesz na stronie Wsparcie programistyczne dla e-commerce.

Najczęściej zadawane pytania

Jak zrobić plik XML dla Ceneo?

Plik XML dla Ceneo generuje się modułem lub aplikacją sklepu, przez integrator albo własnym skryptem, zgodnie z instrukcją Ceneo. Każda oferta to element o z atrybutami id, url, price i avail oraz elementami cat, name, imgs, desc i attrs. Gotowy plik musi być dostępny pod stałym adresem bez hasła, z którego Ceneo go pobiera.

Jakie pola są wymagane w pliku XML Ceneo?

Wymagane są atrybuty id, url, price i avail oraz elementy cat, name, imgs, desc i attrs. W atrybutach warto podać Marka, Kod producenta i EAN, bo pomagają dopasować ofertę do karty produktu. Dla ofert w Kup Teraz dochodzą dane wymagane przez GPSR.

Dlaczego oferty z pliku XML nie pojawiają się na Ceneo?

Najczęstsze przyczyny to błąd składni XML, który blokuje cały plik, plik niedostępny pod adresem lub chroniony hasłem, brak wymaganych pól albo cena zapisana z przecinkiem. Oferty bez EAN i kodu producenta mogą też nie trafić do właściwej karty produktu. Warto sprawdzić raporty w panelu Ceneo i poprawność pliku walidatorem XML.

Co oznaczają wartości avail w pliku Ceneo?

Wartość avail oznacza czas wysyłki: 1 to wysyłka w 24 godziny, 3 do trzech dni, 7 do tygodnia, 14 do dwóch tygodni, 90 towar na zamówienie, 99 „sprawdź w sklepie”, a 110 przedsprzedaż. Wartość powinna wynikać z realnego stanu i czasu realizacji zamówienia. Listę warto sprawdzać w aktualnej instrukcji Ceneo.

Czy jeden plik XML wystarczy dla wszystkich porównywarek cen?

Zwykle nie, bo każda porównywarka ma własną specyfikację pliku. Najlepiej utrzymywać jeden model danych produktowych i z niego generować pliki w formatach poszczególnych serwisów. Dzięki temu poprawka w danych trafia od razu do wszystkich kanałów.

Poprawny feed produktowy XML dla Ceneo i porównywarek to mniej odrzuceń, lepsze dopasowanie do kart produktów i zgodne ceny. Jeśli chcesz zbudować plik od nowa albo naprawić błędy w obecnym, zobacz wsparcie programistyczne Vinson.