Jak działa API Ceneo dla sklepu: feed XML, kliknięcia i integracja z AI

Ceneo udostępnia sklepom trzy osobne interfejsy: plik XML z ofertą produktową, Ceneo Partner API w standardzie REST do pobierania statystyk kliknięć i kosztów oraz API programu Kup Teraz do obsługi zamówień. Żeby z nich korzystać, potrzebujecie aktywnego konta partnera i osobnych kluczy do każdego z nich. AI może łączyć wszystkie trzy jednocześnie i robić zestawienia, które normalnie zajęłyby kilka godzin pracy w arkuszu kalkulacyjnym.

Jak fizycznie działa podłączenie sklepu do Ceneo: feed XML i panel partnera

Zanim w ogóle pojawi się jakiekolwiek API, sklep musi udostępnić Ceneo plik XML z ofertą. To nie jest opcja, to warunek wejścia. Plik XML, nazywany feedem lub eksportem produktowym, generuje silnik sklepu automatycznie pod stały adres URL. Ceneo pobiera go co kilka godzin i na jego podstawie wyświetla Wasze oferty w wynikach porównania cen.

Konto partnera zakładacie na Ceneo dla Sprzedawców. Po weryfikacji dostajecie dostęp do panelu statystyk. Stamtąd można wygenerować klucz do Ceneo Partner API. Uwaga: nie każde konto ma go włączonego od razu, zdarza się, że trzeba napisać do opiekuna handlowego Ceneo z prośbą o aktywację dostępu. Program Kup Teraz to osobna umowa i osobny klucz API, niezależny od kluczy statystycznych.

Czego Ceneo nie udostępnia zewnętrznie: pełnych danych o cenach konkurencji (te widać w panelu wizualnie, ale przez API wychodzą tylko w ograniczonym zakresie zależnym od pakietu), historycznych raportów kliknięć starszych niż zakres dostępny przez API, pełnych danych demograficznych kupujących. Pozycję cenową wobec konkurencji w danej kategorii dostajecie w panelu w kolumnie "Twoja pozycja", ale zestawienie wszystkich ofert konkurencji per SKU nie jest dostępne przez API.

Co jest w feedzie XML i jak błędy w nim kosztują sklep

Feed XML Ceneo ma konkretną strukturę. Obowiązkowe pola to:

• id: unikalny identyfikator oferty po stronie sklepu
• name: nazwa produktu, którą Ceneo wyświetla w wynikach wyszukiwania
• price: cena brutto w złotówkach
• stock: dostępność (wartości: dostępny, niedostępny, sprawdź)
• url: link do karty produktu w sklepie
• category_id: identyfikator kategorii zgodny z drzewem kategorii Ceneo

Pola, które nie są obowiązkowe, ale mocno wpływają na pozycję i liczbę kliknięć:

• EAN: bez kodu kreskowego Ceneo nie przypisze produktu do karty producenta i nie pokaże go w bezpośrednim porównaniu z innymi sklepami
• images: URL-e zdjęć, Ceneo sprawdza ich rozdzielczość i proporcje
• shipping_cost i delivery_time: koszt i czas dostawy, bo kupujący filtrują po cenie z dostawą
• description: opis widoczny na karcie produktu
• attrs: atrybuty produktu, takie jak kolor, rozmiar, pojemność, które Ceneo wykorzystuje do filtrowania w kategoriach

Typowy problem, jaki widzimy u nowych klientów: sklep generuje feed prawidłowo technicznie, ale category_id jest ustawiony na ogólną kategorię nadrzędną zamiast na właściwy liść drzewa kategorii. Efekt: Ceneo pokazuje produkt w złym miejscu albo nie przypisuje go do porównania cenowego. Dla produktów RTV i AGD brak EAN praktycznie wyłącza je z porównywania z konkurencją, bo Ceneo nie ma jak powiązać Waszej oferty z kartą producenta.

U jednego z klientów mających kilka tysięcy SKU w feedzie ponad dwieście produktów miało nieprawidłowe category_id. Nikt tego nie wiedział, bo feed był "aktywny" i Ceneo go pobierało. AI przejrzało plik, porównało category_id z oficjalnym drzewem kategorii Ceneo i wylistowało wszystkie rozbieżności z propozycją poprawki. Bez tego audytu te produkty stały poza porównaniem cenowym miesiącami.

Ceneo Partner API: jakie dane dostaje sklep i jak do nich dojść

Ceneo Partner API to interfejs REST z autoryzacją przez klucz API przekazywany w nagłówku HTTP. Dostęp wymaga aktywnego konta partnera i włączonego dostępu API po stronie Ceneo.

Co możecie przez to API wyciągnąć:

• /clicks: lista kliknięć z podziałem na produkty, datę i koszt pojedynczego kliknięcia (CPC)
• /budget: aktualny stan budżetu kampanii, wydatki w wybranym okresie
• /categories: statystyki per kategoria, w tym współczynnik konwersji raportowany przez Ceneo dla danej kategorii produktowej
• /offers: lista Waszych ofert z ich aktualnym statusem w serwisie
• /positions: pozycja cenowa oferty w wynikach (zakres zależy od pakietu)

Czego nie ma w API: pełnych danych o cenach konkurencji w czasie rzeczywistym, historii zmian pozycji dłuższej niż dostępny zakres, szczegółowych danych o zachowaniu kupujących na karcie produktu. Statystyki konwersji per kategoria to dane zagregowane: Ceneo podaje, jaki procent kliknięć w danej kategorii kończy się zamówieniem, ale to ich wewnętrzna miara dla całej kategorii, nie Wasza indywidualna. Mimo to to użyteczna informacja: widzicie, w których kategoriach ruch z Ceneo naturalnie kończy się sprzedażą, a w których nie.

Program Kup Teraz: zamówienia bezpośrednio przez Ceneo od strony technicznej

Kup Teraz to program, w którym kupujący składa zamówienie bez wychodzenia z Ceneo. Płatność przechodzi przez Ceneo, a sklep dostaje gotowe zamówienie do realizacji. Wymaga osobnej umowy z Ceneo i osobnego klucza API, niezależnego od kluczy do statystyk kliknięć z Partner API.

API Kup Teraz (REST) obsługuje:

• pobieranie listy nowych zamówień z endpointu /orders
• potwierdzanie przyjęcia zamówienia do realizacji
• aktualizację statusu: w realizacji, wysłane, numer przesyłki
• obsługę anulowań i zwrotów inicjowanych przez kupującego

Integracja Kup Teraz z systemem zamówień sklepu (IdoSell, WooCommerce, PrestaShop czy innym) to jeden z częstszych tematów, z którymi trafiają do nas sklepy. Zamówienia z Kup Teraz trzeba obsługiwać z taką samą szybkością jak zamówienia z własnego sklepu, bo kupujący oczekuje tych samych czasów realizacji i nie widzi różnicy. Typowo wygląda to tak, że przez pierwsze tygodnie zamówienia z Kup Teraz ktoś sprawdza ręcznie w panelu Ceneo, a dopiero po czasie sklep integruje je z głównym systemem. AI może monitorować kolejkę i alarmować, gdy zamówienie czeka za długo na potwierdzenie.

Zaufane Opinie, opinie o produktach i pytania kupujących

Ceneo rozdziela dwa typy opinii. Pierwsze: opinie o sklepie, zbierane przez program Zaufane Opinie po realizacji zamówienia przez zaproszenie mailowe. Drugie: opinie o produktach, wystawiane bezpośrednio przy karcie produktu przez kupujących z całego Ceneo, nie tylko Waszych. Do obu typów jest dostęp przez API, choć w różnych zakresach.

Przez API Zaufanych Opinii sklep może:

• pobierać nowe opinie o sklepie z ocenami punktowymi i treścią komentarza
• wysyłać zaproszenia do oceny po zamówieniu przez endpoint /invitations
• pobierać opinie o konkretnych produktach ze swojej oferty
• wysyłać odpowiedzi na opinie przez API, po akceptacji przez pracownika

Poza opiniami Ceneo ma sekcję pytań i odpowiedzi przy kartach produktów. Kupujący zadają pytania o produkt: "czy pasuje do modelu X", "jaki jest kabel w zestawie", "czy jest polska instrukcja". Sklep może odpowiadać przez panel lub API. Nieodebrane pytania to stracone sprzedaże. Typowo wygląda to tak, że sklep ma kilkadziesiąt pytań bez odpowiedzi, bo nikt nie ma czasu sprawdzać panelu Ceneo oddzielnie od Allegro, skrzynki mailowej i innych kanałów. AI pobiera je automatycznie i przygotowuje gotowe odpowiedzi na bazie specyfikacji produktu.

Co AI robi z tymi danymi i gdzie firma to naprawdę czuje

Połączenie feedu XML, API kliknięć i API opinii daje taki obraz, jakiego nie ma w żadnym z tych miejsc osobno. W panelu Ceneo widzicie statystyki kliknięć, ale nie wiecie, które z nich przełożyły się na sprzedaż. W systemie zamówień macie sprzedaż, ale nie wiecie, ile kosztowało pozyskanie każdego zamówienia z Ceneo. AI łączy te źródła.

Konkretne zadania, które AI przejmuje:

• Audyt feedu XML: AI porównuje plik z wymaganiami Ceneo i drzewem kategorii, wypisuje produkty z błędnym category_id, brakującym EAN, zbyt krótką nazwą (Ceneo zaleca minimum 60 znaków) albo brakiem zdjęcia o odpowiedniej rozdzielczości. Wynik to lista do poprawki, nie ściana tekstu.
• Produkty przepalające budżet: AI zestawia kliknięcia z API (/clicks z kosztami per produkt) z zamówieniami z Kup Teraz lub własnego systemu. Produkty z wysokim kosztem kliknięć i zerową albo minimalną sprzedażą trafiają na listę do weryfikacji. Właściciel dostaje gotową tabelkę, nie surowiec z Excela.
• Odpowiedzi na opinie o sklepie: AI pobiera nowe opinie, sprawdza ich treść i przygotowuje projekt odpowiedzi dostosowany do kontekstu: inaczej na negatywną z konkretnym zarzutem o dostawę, inaczej na pochlebną po szybkiej realizacji. Pracownik zatwierdza albo edytuje i wysyła przez panel lub API.
• Odpowiedzi na pytania o produkt: AI pobiera otwarte pytania z kart produktów, szuka odpowiedzi w specyfikacji z feedu lub w bazie produktowej sklepu i przygotowuje gotową odpowiedź. Bez tego pytania zbierają się tygodniami.
• Tygodniowy raport kosztów: AI łączy dane z /budget, /clicks i zamówień, generuje raport z kosztem pozyskania zamówienia z Ceneo per kategoria, produktami z rosnącym CPC i zmianami pozycji cenowej. Właściciel dostaje go mailem bez otwierania panelu Ceneo.
• Podpowiedzi cenowe: na podstawie danych o pozycji z API i widełek cenowych w danej kategorii AI sygnalizuje, o ile cena odbiega od najniższej oferty w wynikach i czy zmiana ma sens przy zachowaniu marży. Bez wyroków, z kontekstem.

Od czego zaczyna się taka integracja w praktyce

Zanim cokolwiek podłączycie, sprawdźcie trzy rzeczy. Czy Wasze konto partnera Ceneo ma aktywny dostęp do Partner API, czy trzeba o to napisać do opiekuna. Czy uczestniczycie w programie Kup Teraz, bo jeśli nie, to zamówień przez API nie będzie i część analizy kosztów odpada. I jaki system sklepu generuje feed XML: czy można ustawić jego automatyczne odświeżanie co godzinę, bo feed pobierany raz na dobę traci aktualność przy szybko zmieniającym się stanie magazynowym.

Sam feed XML już jest: każdy sklep zintegrowany z Ceneo go ma. Pytanie, kiedy ostatni raz ktoś sprawdził, czy nie ma w nim błędów. Zazwyczaj feed powstał przy wdrożeniu sklepu i nikt do niego nie zaglądał od miesięcy. To pierwsze i najszybsze do zrobienia.

Spinka danych z feedu, API kliknięć i opinii to projekt na kilka dni roboczych: pobranie danych z każdego źródła, ujednolicenie struktury i podpięcie pod AI, które z tymi danymi pracuje na bieżąco. Nie trzeba przepisywać systemu sklepu ani zmieniać umowy z Ceneo.

Jeśli chcecie zobaczyć, jak taka integracja wygląda przy konkretnych danych: realne wdrożenia pokazują, jak spinamy dane z różnych źródeł w jedno miejsce. Możemy też porozmawiać o Waszym konkretnym sklepie i feedzie: 15 minut rozmowy wystarczy, żeby ocenić, co ma sens w pierwszej kolejności.