Integracja sklepu z Ceneo: WooCommerce, PrestaShop i plik XML krok po kroku

Integracja sklepu z Ceneo działa przez plik XML: sklep publikuje pod stałym adresem listę ofert, a Ceneo regularnie ją pobiera i aktualizuje ceny, dostępność i nowe produkty. Z instrukcji tworzenia pliku XML (stan na październik 2026) wynikają cztery podstawowe zasady:

1. Plik musi być dostępny bez ograniczeń, na przykład bez hasła. Ceneo nie aktualizuje plików przesłanych mailem.
2. Adres pliku nie powinien się zmieniać, a każdą zmianę ścieżki trzeba zgłosić Ceneo.
3. Każda oferta ma unikalne ID, którego nie wolno użyć ponownie, nawet po długim czasie.
4. Cena i dostępność w pliku muszą odpowiadać danym na stronie sklepu. Rozbieżności mogą skończyć się ukryciem oferty.

Na Ceneo oferta może działać w dwóch trybach. W pierwszym kupujący klika ofertę i przechodzi do Twojego sklepu, a Ty płacisz za kliknięcie (CPC). W drugim, Marketplace Kup Teraz, klient składa zamówienie i płaci na Ceneo, a sklep tylko je realizuje i płaci prowizję od sprzedaży. Oba tryby korzystają z tego samego pliku XML; o udziale oferty w Kup Teraz decyduje atrybut `basket`.

Trzecim elementem są Zaufane Opinie, czyli prośba o ocenę sklepu wysyłana klientowi po zakupie. Włączysz je w oficjalnej wtyczce po wpisaniu kodu GUID z panelu Ceneo.

Plik XML dla Ceneo musi zawierać dla każdej oferty co najmniej ID, adres URL, cenę, czas wysyłki, kategorię, nazwę, zdjęcia, opis i atrybuty. Poniższe zestawienie pochodzi ze specyfikacji Ceneo sprawdzonej 10 października 2026.

W atrybutach Ceneo wymaga tzw. atrybutów integracyjnych: Marka, Kod producenta, EAN (lub ISBN dla książek) oraz Wyprodukowane przez. To po nich porównywarka łączy Twoją ofertę z kartą produktu. Plik z listą atrybutów dla kategorii oznacza też atrybuty kluczowe, na przykład rozmiar w modzie, których uzupełnienie jest wymagane.

Specyfikacja przewiduje też tryb przyrostowy: plik zawiera tylko zmienione oferty z atrybutem `update="1"`, a ofertę ukrywa się, wysyłając cenę 0.

WooCommerce integruje się z Ceneo najprościej przez oficjalną wtyczkę Ceneo (paczka `woocommerce-ceneo-official.zip`), opisaną w instrukcji dla WooCommerce na stronie Ceneo. Wtyczka nie jest instalowana z katalogu WordPress, tylko pobierana ze strony Ceneo i wgrywana ręcznie. Kroki według instrukcji sprawdzonej w październiku 2026:

1. Pobierz wtyczkę ze strony Ceneo i wgraj ją w panelu WordPress przez Wtyczki, opcja wysłania wtyczki na serwer.
2. W menu Ceneo otwórz mapowanie kategorii, odśwież listę kategorii Ceneo i użyj sugestii mapowania. Kategorie o innych nazwach przypisz ręcznie.
3. Zmapuj atrybuty sklepu na atrybuty Ceneo dla każdej kategorii.
4. Wybierz sposób generowania XML: plik statyczny tworzony według harmonogramu (lub zewnętrznego crona) albo plik dynamiczny generowany przy każdym pobraniu.
5. Skopiuj adres pliku i wklej go w panelu sklepu Ceneo, w ustawieniach przetwarzania ofert.
6. Ustaw domyślne czasy wysyłki, uzupełnij dane GPSR i sprawdź mapowanie pól EAN, SKU i producenta w dodatkowych atrybutach.
7. Opcjonalnie włącz Zaufane Opinie (kod GUID z panelu Ceneo) oraz Kup Teraz (klucz API z panelu Ceneo i adres IP serwera dodany do listy dozwolonych).

Po włączeniu Kup Teraz wtyczka pobiera zamówienia z Ceneo co 15 minut do zwykłej listy zamówień WooCommerce, a numery przesyłek rozpoznaje automatycznie dla wymienionych w instrukcji wtyczek, m.in. InPost, Furgonetka i Apaczka. Ceneo zastrzega, że wtyczka opiera się na standardowych rozwiązaniach WooCommerce, a zgodność z niestandardowymi motywami i dodatkami nie jest gwarantowana. Przy niestandardowym sklepie najpierw sprawdź podgląd pliku XML na kilku produktach. Więcej o tym, jak WooCommerce trzyma stany, piszemy w artykule o magazynie WooCommerce.

PrestaShop podłącza się do Ceneo przez oficjalne moduły Ceneo opisane w podręczniku integracji PrestaShop. W przeciwieństwie do WooCommerce są to trzy osobne moduły: eksport XML, Kup Teraz oraz Zaufane Opinie. Według instrukcji z października 2026 obsługują PrestaShop 1.7.7.x i 8.x, także w trybie Multistore.

1. Pobierz moduł eksportu XML ze strony Ceneo i wgraj go w Moduły, Menedżer modułów, opcja załadowania modułu.
2. Po instalacji przejdź do konfiguracji modułu i zmapuj kategorie sklepu na kategorie Ceneo (automatyczna sugestia plus ręczne poprawki).
3. Przy każdej kategorii przypisz atrybuty integracyjne wymagane przez Ceneo.
4. W zakładce eksportu ofert skopiuj link do pliku XML i wklej go w panelu Ceneo.
5. Zdecyduj, czy pomijać produkty nieaktywne i bez stanu, czy łączyć warianty w jedną ofertę (tylko przy tej samej cenie) i czy oferty mają być widoczne w Kup Teraz.
6. Uzupełnij dane GPSR: cechy produktu oraz adresy producenta i podmiotu odpowiedzialnego dla każdej marki.

Starsze wersje PrestaShop nie są objęte tą instrukcją, więc przy wersji 1.6 trzeba szukać innego modułu albo generować plik samodzielnie. Jeśli dopiero wybierasz platformę, porównanie WooCommerce i PrestaShop pomoże ocenić koszty utrzymania.

Większość popularnych platform ma gotową integrację z Ceneo: na stronie integracji platform e-commerce Ceneo podaje, że obsługuje 38 platform i ma osobne podręczniki m.in. dla Shopera, IdoSell, Magento i Comarch. Jeśli Twojej platformy nie ma na liście, plik trzeba przygotować według ogólnej specyfikacji XML.

Drugą drogą jest integrator zamówień. Pomoc Base (dawniej BaseLinker) opisuje kilka wariantów integracji z Ceneo: wystawianie ofert z magazynu Base, przeniesienie ofert sklepu do Base albo samo pobieranie zamówień. Ważne ograniczenie z tej dokumentacji: na koncie Ceneo może działać tylko jeden plik XML, więc przejście na plik z Base oznacza zastąpienie pliku ze sklepu, a nie dodanie drugiego. Zobacz też wdrożenie Base.

Fraza ifirma integracja ceneo dotyczy programu do faktur. W liście zmian ifirma z września 2023 widnieje pozycja Integracja z Kup na Ceneo, ale bez opisu zakresu. Dotyczy ona dokumentów sprzedaży, nie pliku z ofertami, a jej zakres warto potwierdzić w pomocy ifirma.

Ceneo nie pobiera abonamentu: w modelu CPC płacisz za każde przejście z Ceneo do sklepu, a w Kup Teraz prowizję od zamówienia. Rozliczenie CPC działa przedpłatowo, a strona cennika Ceneo dla sklepów podaje, że niewykorzystane środki są zwracane po rezygnacji.

Na tej samej stronie Ceneo podaje, że kliknięcie kosztuje od 39 gr do 1,03 zł zależnie od kategorii. Szczegółowy cennik CPC w panelu Ceneo, sprawdzony 10 października 2026, pokazuje stawki dla kategorii i podkategorii, częściowo sezonowe. Przykłady kategorii głównych:

Prowizje pochodzą z cennika obowiązującego od 21 sierpnia 2025. Sklep korzystający z CPC płaci w Kup Teraz niższe stawki niż sklep w modelu tylko prowizyjnym. Stawki podkategorii mogą się różnić (audiobooki: 0,59 zł poza sezonem), a Outlet wykracza poza widełki z ogólnej strony, więc wiążący jest aktualny cennik w panelu.

Ceneo daje bonus do pierwszej wpłaty po rejestracji w modelu CPC: 15% przy wpłacie 375-1000 zł, 20% przy 1001-1500 zł i 30% powyżej 1500 zł, maksymalnie 1000 zł. Bonus nie dotyczy sklepów działających wyłącznie w Kup Teraz. Aby ocenić opłacalność, podziel stawkę CPC przez współczynnik konwersji: przy 0,93 zł za kliknięcie i 2% konwersji pozyskanie jednego zamówienia kosztuje około 46,50 zł. To obliczenie przykładowe, nie średnia rynkowa.

Kup Teraz opłaca się wtedy, gdy wolisz płacić za faktyczną sprzedaż niż za ruch, a przekierowanie do sklepu, gdy zależy Ci na kliencie we własnym sklepie i masz dobrą konwersję. Oba tryby można łączyć na jednym koncie, o czym decyduje atrybut `basket` w pliku i ustawienia wtyczki.

Według strony Marketplace Kup Teraz sprzedawca nie płaci za aktywację, publikacja ofert jest bezpłatna, a rozliczenie następuje tylko od złożonych zamówień. Ceneo udostępnia darmowe metody API do obsługi zamówień, zwrotów i numerów przesyłek.

Przy wyborze weź pod uwagę dwie rzeczy:

• Marża w kategorii. Przy prowizji kilkunastu procent tani produkt z niską marżą może przynosić stratę, nawet jeśli nie płacisz za kliknięcia.
• Obsługa zamówień. Zamówienie z Kup Teraz musi trafić do magazynu i systemu faktur tak samo jak zamówienie ze sklepu. Bez integracji ktoś przepisuje je ręcznie.

Rozsądny start to włączenie Kup Teraz dla części asortymentu i porównanie po kilku tygodniach kosztu zamówienia w obu modelach na danych z panelu Ceneo i sklepu.

Najczęściej oferty blokuje rozbieżność danych: cena lub dostępność w pliku inna niż na stronie, a zaraz po niej źle dobrane kategorie i brak atrybutów integracyjnych. Poniższa lista wynika z wymagań specyfikacji Ceneo i instrukcji wtyczek, nie z naszych statystyk.

W WooCommerce zdarza się też problem techniczny opisany w FAQ wtyczki: jeśli paczka zostanie pobrana pod zmienioną nazwą, np. z dopiskiem (2), wtyczka instaluje się, ale nie pojawia się w menu. Katalog wtyczki musi nazywać się dokładnie `woocommerce-ceneo-official`. Przy wariantach pamiętaj, że łączenie w jedną ofertę działa tylko wtedy, gdy wszystkie warianty mają tę samą cenę.

Gotowa wtyczka Ceneo nie wystarczy, gdy źródłem prawdy o cenach i stanach nie jest sklep, tylko program magazynowy lub ERP. Wtyczka czyta dane z WooCommerce lub PrestaShop, więc jeśli stany w sklepie aktualizują się raz dziennie z Subiekta albo z kilku hurtowni, plik dla Ceneo powiela to opóźnienie.

Typowe sytuacje, w których plik XML lub obsługę zamówień trzeba dopasować do procesu:

• stany i ceny pochodzą z Subiekta, Comarch Optima lub innego ERP i synchronizują się rzadko albo z błędami,
• towar pochodzi z kilku hurtowni z własnymi plikami stanów i różnym czasem dostawy, który powinien trafiać do pola `avail`,
• katalog jest tak duży, że pełny plik generuje się zbyt długo i potrzebny jest tryb przyrostowy,
• zamówienia Kup Teraz mają trafiać od razu do ERP i systemu faktur, z numerem przesyłki odsyłanym do Ceneo.

O typowych przyczynach rozjazdów piszemy przy synchronizacji Subiekt nexo ze sklepem oraz w przeglądzie integracji WooCommerce z ERP. Koszty takiego projektu opisuje cennik integracji sklepu z ERP.

Integrację z Ceneo warto zrobić samodzielnie, jeśli masz standardowy sklep WooCommerce lub PrestaShop, uzupełnione EAN i marki, a stany prowadzisz w samym sklepie. Wtedy zwykle wystarczy oficjalna wtyczka i test pliku.

Specjalista ma sens, gdy plik XML musi łączyć dane z ERP lub hurtowni, gdy zamówienia z Kup Teraz mają trafiać prosto do programu magazynowego albo gdy wtyczka koliduje z niestandardowym sklepem. W KC Mobile budujemy sklepy internetowe i integracje z systemami magazynowymi; integracja sklepu z ERP zaczyna się od 7 900 zł netto, a dokładny zakres zależy od systemów i liczby źródeł danych. Opłaty dla Ceneo (CPC i prowizje) są zawsze osobnym kosztem.

Jeśli nie wiesz, czy wystarczy wtyczka, napisz do nas z nazwą platformy, systemu magazynowego i liczbą produktów. Odpowiemy, czy da się to zrobić gotowym narzędziem, czy potrzebna jest integracja.