Instrukcja tworzenia pliku XML

1. Struktura pliku XML

Poradnik ten pomoże Ci w przygotowaniu pliku XML za pomocą którego będziemy mogli umieścić ofertę Twojego sklepu na Ceneo.pl.

Zastosowanie się do wszystkich punktów sprawi, że Twoja oferta będzie atrakcyjna dla użytkownika co z pewnością przełoży się na ilość realizowanych zamówień.

Zanim rozpoczniesz tworzenie pliku (jak tego dokonać dowiesz się w dalszej części poradnika), zapoznaj się z kilkoma podstawowymi zasadami o których musisz pamiętać:

  1. Przygotowany plik musi zostać umieszczony w miejscu z którego bez żadnych ograniczeń będziemy mogli go pobierać. Niestety, ale nie aktualizujemy plików przesłanych mailowo. Pamiętaj, że dostęp do pliku nie może być w żaden sposób ograniczony (np. hasłem)
  2. Nie zmieniaj lokalizacji pliku. O każdorazowej zmianie ścieżki poinformuj nasz zespół.
  3. Każda oferta musi posiadać swój unikatowy numer (w dalszej części tekstu oznaczone jako ID). Raz użyty numer nie może zostać ponownie wykorzystany, nawet po upływie dużego odstępu czasu. Jeżeli z różnych przyczyn taka zmiana nastąpi niezwłocznie nas o tym poinformuj.
  4. Dane znajdujące się w pliku XML muszą mieć swoje odzwierciedlenie w danych umieszczonych na Twojej stronie, np. cena i dostępność. Rozbieżności między plikiem a stroną mogą skutkować ukryciem Twoje oferty.
  5. Nie generuj do pliku XML ofert, których użytkownik nie może zamówić. Oferta niedostępna lub nieposiadająca aktywnego koszyka na Twojej stronie, nie może być prezentowana na Ceneo.pl.

Aby Twoje produkty pojawiły się na Ceneo.pl konieczne będzie przygotowanie pliku XML, w którym umieścisz swoją ofertę.

Plik XML może zostać przygotowany na 3 sposoby:

Poniżej zamieszczone zostały dwie przykładowe oferty, w strukturze odpowiedniej dla naszego systemu:
<?xml version="1.0" encoding="utf-8"?>
<offers xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="1">

  <!-- PIERWSZY PRZYKŁAD OFERTY -->
  <o id="1" url="http://www.przykładowylink.pl/id-1" price="999.99" avail="1" weight="4" stock="2" basket="1">
    <cat>
      <![CDATA[Komputery/Monitory]]>
    </cat>
    <name>
      <![CDATA[LG 27" 27UK650-W (27UK650W)]]>
    </name>
    <imgs>
      <main url="http://www.przykładowylink.pl/id-1.jpg"/>
      <i url="http://www.przykładowylink.pl/id-1/1.jpg"/>
      <i url="http://www.przykładowylink.pl/id-1/2.jpg"/>
      <i url="http://www.przykładowylink.pl/id-1/3.jpg"/>
    </imgs>
    <desc>
      <![CDATA[<strong>Nastała era UHD 4K HDR</strong><br><br>Oglądaj nieskazitelny obraz o niespotykanym bogactwie kolorów na monitorze LG UHD 4K HDR.
    Twórcy pracujący z treścią HDR ucieszą się z możliwości odtwarzania jasności i kontrastu do podglądu i edycji.
    <br><br><strong>HDR Effect do treści SDR</strong><br><br>Monitor LG UHD 4K HDR może przekonwertować standardową treść na format HDR wprost na ekranie.
    Specjalny algorytm poprawia mapowanie tonalne i luminancję treści SDR, zapewniając jakość zbliżoną do HDR.
    <br><br><strong>Prawdziwe kolory i szeroki kąt patrzenia</strong><br><br>Monitor LG IPS odznacza się wyjątkową dokładnością odwzorowania kolorów – pokrywa
    99% gamy sRGB. Ponadto ma szeroki kąt patrzenia, dzięki czemu łatwiej jest cieszyć się doskonałą jakością kolorów.<br><br><strong>Czystszy i płynniejszy
    obraz</strong><br><br>Technologia AMD FreeSync™ zapewnia płynną i niczym niezakłóconą rozrywkę w wysokiej rozdzielczości nawet w dynamicznych grach.
    Całkowicie eliminuje rozrywanie i zacinanie obrazu.<br><br><strong>Indywidualne ustawienia dla każdej gry </strong><br><br><strong>Wrogowie nie mają
    gdzie się ukryć</strong><br><br>Funkcja Black Stabilizer zapewnia wyraźny obraz nawet w mrocznych grach. Synchronizuje i rozjaśnia najciemniejsze zakątki, 
    dzięki czemu znajdziesz wrogów czających się w ciemności i zaatakujesz przed nimi.<br>]]>
    </desc>
    <attrs>
      <a name="Producent">
        <![CDATA[LG]]>
      </a>
      <a name="EAN">
        <![CDATA[8806098110254]]>
      </a>
      <a name="Kod producenta">
        <![CDATA[27UK650W]]>
      </a>
      <a name="Powłoka matrycy">
        <![CDATA[Matowa]]>
      </a>
      <a name="Technologia">
        <![CDATA[4K UHD]]>
      </a>
      <a name="Przekatna ekranu">
        <![CDATA[20 cali]]>
      </a>
      <a name="Rozdzielczośc">
        <![CDATA[3840x2160]]>
      </a>
      <a name="Czas reakcji">
        <![CDATA[5ms]]>
      </a>
      <a name="Jasność">
        <![CDATA[350cd/m2]]>
      </a>
      <a name="Funkcja pivot">
        <![CDATA[Tak]]>
      </a>
      <a name="Powłoka matrycy">
        <![CDATA[Matowa]]>
      </a>
      <a name="Proporcje ekranu">
        <![CDATA[16:9]]>
      </a>
    </attrs>
  </o>

  <!-- DRUGI PRZYKŁAD OFERTY -->
  <o id="2" url="http://www.przykładowylink.pl/id-2" price="1499.99" avail="1" weight="13" stock="1" basket="1">
    <cat>
      <![CDATA[Sport i rekreacja/Rowery/Górskie]]>
    </cat>
    <name>
      <![CDATA[Kross Hexagon 3.0 Czarny/Czerowny/Bordowy 20018]]>
    </name>
    <imgs>
      <main url="http://www.przykładowylink.pl/id-2.jpg"/>
      <i url="http://www.przykładowylink.pl/id-2/1.jpg"/>
      <i url="http://www.przykładowylink.pl/id-2/2.jpg"/>
      <i url="http://www.przykładowylink.pl/id-2/3.jpg"/>
    </imgs>
    <desc>
      <![CDATA[Model ten jest idealnym wyborem dla osoby szukającej roweru, który nada się na przejażdżki po szosie jak i w trudniejszym
    terenie. Lekka aluminiowa konstrukcja w połączeniu z 21 biegową przekładnią i wygodną, wyprofilowaną kierownicą sprawiają, że poruszanie się tym
    pojazdem potrafi być naprawdę przyjemne i co najważniejsze wygodne.Rower ten posiada przerzutki renomowanej firmy Shimano. Shimano Altus RD-M310 zapewnia 21 przełożeń.
    Dzięki takiej ilości biegów bez problemów będziesz pokonywał strome podjazdy,a jazda po lesie czy też w trudnym terenie nie będzie wymagała dużego wysiłku,a co za tym idzie 
    stanie się dla Ciebie ogromną przyjemnością.Siodło firmy Selle Royal zapewni Ci wygodę , co jest szczególnie istotnym aspektem podczas dłuższych wycieczek. 
    Zostało wykonane z solidnych materiałów, dzięki czemu nie zużyje się prędko.Hamulce tarczowe zapewnią Ci niezwykłą skuteczność i bezpieczeństwo podczas hamowania. 
    Dzięki wykonaniu z trwałych materiałów posłużą Ci przez długi okres czasu bez konieczności wymiany na nowe. 
    Amortyzator w terenie staje się niezbędnym elementem zapewniającym stały kontakt opony z podłożem, co przekłada się na bezpieczeństwo oraz komfort.
    Ergonomicznie wyprofilowana kierownica i gumowe rączki zapewniają pewny chwyt, co przekłada się na dobrą kierowalność, zwłaszcza w trudnych warunkach.
    W połączeniu z regulowanym mostkiem kierownicy, dzięki któremu będziesz mógł dostosować pozycję do własnych potrzeb sprawia, że podróżowanie staje się na prawdę wygodne.]]>
    </desc>
    <attrs>
      <a name="Producent">
        <![CDATA[Kross]]>
      </a>
      <a name="EAN">
        <![CDATA[5904993361092]]>
      </a>
      <a name="Rodzaj">
        <![CDATA[Górskie]]>
      </a>
      <a name="Przeznaczenie">
        <![CDATA[Męskie]]>
      </a>
      <a name="Amortyzacja">
        <![CDATA[Przód]]>
      </a>
      <a name="Liczba biegów">
        <![CDATA[21]]>
      </a>
      <a name="Rozmiar kół">
        <![CDATA[26]]>
      </a>
      <a name="Kolor">
        <![CDATA[Czarny]]>
      </a>
      <a name="Rodzaj hamulców">
        <![CDATA[Tarczowe-mechaniczne]]>
      </a>
      <a name="Manetki">
        <![CDATA[Shimano Tourney St-Ef41]]>
      </a>
      <a name="Przerzutka przednia">
        <![CDATA[Shimano Tourney Fd-Tz30]]>
      </a>
      <a name="Piasta przednia">
        <![CDATA[MD-JA159F]]>
      </a>
    </attrs>
  </o>

</offers>

Każdy z zamieszczonych w przykładzie znaczników i atrybutów został opisany dokładniej w tabeli. Znajdziesz tu wymagania i zakres danych, który możesz użyć w danym miejscu:

Znacznik Opis

<?xml version="1.0" encoding="utf-8"?>

Pole wymagane
Kodowanie pliku

Dostępne opcje kodowania:

  • - Utf-8 (zalecane)
  • - ISO-8859-2
  • - Windows-1250

<offers xmlns:xsi=" version="1">

Pole wymagane
Stała część pliku

<o> ... </o>

Pole wymagane
Rozpoczęcie i zamknięcie sekcji z ofertą.

Każda z ofert musi znaleźć się pomiędzy tymi znacznikami

<cat> ... </cat>

Pole wymagane
Dokładna kategoria Twojej oferty

Maksymalna liczba znaków: 255

<name> ... </name>

Pole wymagane
Dokładna nazwa Twojej oferty

Maksymalna liczba znaków: 150

<imgs> ... </imgs>

Pole wymagane
Link do zdjęcia produktu

  • main : zdjęcie główne
  • i : zdjęcie dodatkowe

<desc> ... </desc>

Pole wymagane
Opis Twojego produktu

Maksymalna ilość znaków: 30 tys.

<attrs> ... </attrs>

Pole wymagane
Atrybuty (cechy) opisujące Twój produkt

Maksymalna liczba atrybutów: 500


Atrybut Opis

id

Pole wymagane
Unikatowy identyfikator Twojego produktu

  • - Maksymalna ilość znaków to 1000,
  • - Każda oferta musi posiadać swój unikatowy numer,
  • - Raz użyty numer nie może zostać ponownie wykorzystany, nawet po upływie dużego odstępu czasu.

url

Pole wymagane
Link do Twojego produktu

Maksymalna ilość znaków to 1000.

price

Pole wymagane
Cena

Konieczne jest podanie liczby zmiennoprzecinkowej, której separatorem jest kropka.

avail

Pole wymagane
Dostępność produktu

Format
Dostępne opcje to [1, 3, 7, 14, 90, 99, 110], gdzie:

  •   1 : dostępny, sklep wyśle produkt w ciągu 24 godzin
  •   3 : sklep wyśle produkt do 3 dni
  •   7 : sklep wyśle produkt w ciągu tygodnia
  •  14 : sklep wyśle produkt do 14 dni
  •  90 : towar na zamówienie
  •  99 : brak informacji o dostępności – status „sprawdź w sklepie”
  • 110 : przedsprzedaż

weight

Pole opcjonalne
Waga produktu

Wyrażona w kilogramach, której separatorem jest kropka

basket

Pole opcjonalne
Pole dla produktów aktywnych w usłudze „Kup teraz”

Format
Dostępne opcje to [0, 1], gdzie:

  • 1 : tak, oferta dostępna w "Kup teraz"
  • 0 : nie, oferta niedostępna w "Kup teraz"

stock

Pole opcjonalne
Stan magazynowy

Liczba całkowita dodatnia.

Masz możliwość przekazywania nam również plików przyrostowych, czyli takich, które zawierają jedynie dane ulegające zmianie względem poprzedniej wersji pliku. Plik taki spowoduje szybszą aktualizację w naszym systemie, ale również w mniejszym stopniu obciąży serwer na którym umieścisz swój plik.

W przeciwieństwie do standardowego procesu z pełną definicją, oferty które nie znajdują się w pliku wsadowym nie zostaną ukryte/usunięte w bazie Ceneo, w tym celu wymagane jest wysłanie aktualizacji oferty z ceną równą 0.

Struktura pliku bazuje na standardowej definicji dla pełnego przetwarzania. Poniżej przedstawiono zmiany dla trybu przyrostowego:


Definicja nagłówka wersji

Podstawowy znacznik w trybie przyrostowym to atrybut fileVersion (typu tekstowego max 255 znaków) na poziomie głównego węzła definicji offers, który określa „stan” w systemie źródłowym na podstawie którego został wygenerowany różnicowy plik zasilenia danymi ofert.

<offers xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="1" fileVersion="version1">
   ...
</offers>

Definicja oferty z pełną definicją

Dla pełnej definicji oferty definicja XML pozostaje bez zmian.


Definicja aktualizacji oferty

Aby zdefiniować ofertę w trybie aktualizacji przyrostowej, należy podać w węźle oferty atrybut update o wartości 1. W trybie aktualizacji, poza atrybutem update, jedyny dodatkowy wymagany atrybut to identyfikator (id) oferty.

<o update="1" id="1">
    ...
</o>

Następnie należy podać tylko te atrybuty i węzły które mają zostać zaktualizowane na ofercie, pominięcie któregoś z nich zostanie również pominięte w procesie aktualizacji, np.:

<o update="1" id="11743-23018325-28229403" price="0" /o>
    <o update="1" id="11743-23018325-28229401" price="18.00" stock="1" /o>
    <o update="1" id="11743-23018326-28229610" price="0" /o>
    <o update="1" id="11743-23018326-28229607" price="18.00" stock="4" /o>
    <o update="1" id="11743-23018326-28229606" price="18.00" stock="5" /o>
    

Usuwanie/ukrycie oferty w Ceneo

Aby ukryć/usunąć ofertę z Ceneo, należy przekazać aktualizacje oferty z ceną równą 0.

<o update="1" id="1" price="0">
    ...
</o>


Ponowne przywrócenie wcześniej usuniętej oferty

Aby ponownie przywrócić ofertę w Ceneo i mieć pewność poprawności danych, należy przesłać jej pełną definicję.

Oferta która została wcześniej ukryta/usunięta nie jest aktualizowana w systemie Ceneo aż do momentu ponownego jej odkrycia. Dlatego też wysłanie samej ceny z niekompletnymi danymi może spowodować odkrycie oferty z nieaktualnymi danymi na stan z momentu ukrycia oferty.

Jeżeli nie możesz przygotować pliku XML na opisanych w pkt. 1.2 i 1.3 zasadach, prześlij na adres wsparciesklepu@ceneo.pl dowolny plik jakim dysponujesz. Sprawdzimy go pod kątem poprawności wszystkich danych.

2. Kategorie

Każdy z Twoich produktów musi znaleźć się na Ceneo.pl w odpowiednim miejscu/kategorii. Dlatego też, postaraj się aby w wysyłanym do nas pliku XML były one odpowiednio opisane.

Pełna lista kategorii

Poniżej, dla przykładu zostały przedstawione kategorie, których nazewnictwo jest zbyt ogólne co utrudni, a w skrajnych przypadkach uniemożliwi pokazanie Twojej oferty na Ceneo.pl

  • Wyprzedaż
  • Promocja
  • Tymczasowa
  • Księgarnia
  • Zabawki
  • Książki i ebooki
  • Leki i suplementy

3. Zdjęcia

Zdjęcia to pierwsza rzecz, na którą zwracamy uwagę oglądając dany przedmiot. Jego brak lub niska jakość może skutecznie zniechęcić do zakupu. Dostosowując się do poniższych zasad, zadbasz o to, aby Twoje zdjęcia były jak najwyższej jakości.

  1. Dodaj zdjęcia jak największej rozdzielczości.
  2. Zdjęcia muszą przedstawiać sam produkt na białym tle
  3. Produkt powinien wypełniać całą przestrzeń zdjęcia oraz być w jego centrum
  4. Zdjęcia nie mogę zawierać znaków wodnych, dopisków handlowych i informacji produktowych
  5. Nie powiększaj zdjęć i nie przesyłaj miniatur
  6. Zdjęcia dodatkowe mogą przedstawiać ekspozycję produktu lub przedstawiać go w użyciu
  7. W zdjęciach dodatkowych możesz użyć ilustracji lub rzutów technicznych

4. Opisy

Kolejnym, bardzo ważnym elementem wpływającym na sprzedaż jest opis. To w nim użytkownik powinien znaleźć wszystkie najważniejsze informacje dotyczące danego produktu.

Pamiętaj, że brak opisu, lub jego niedostateczna wartość merytoryczna spowoduje, że użytkownik każdorazowo będzie szukał dokładniejszych informacji na Twojej stronie - może to mieć wpływ na znaczne obniżenie konwersji.

Opis powinien zawierać informacje wyłącznie o danym produkcie i jego użytkowaniu. Nie należy umieszczać w nim dopisków handlowych (tania wysyłka, szybka realizacja itp.), odnośników do innych stron, danych sklepowych i pozostałych informacji, które nie wiążą się ściśle z cechami produktu.

Użyte przez Ciebie kodowanie opisu powinno być tożsame z kodowaniem użytym w pliku XML (zalecane utf-8) a opis zamknięty w sekcji <![CDATA[ ... ]]>.

Przy tworzeniu opisu możesz użyć znaczników HTML takich jak:

  • <p> : akapit
  • <h1> : tytuł
  • <h2> : podtytuł
  • <br/> : nowa linia
  • <ol> : lista numerowana
  • <ul> : lista nienumerowana
  • <li> : element listy
  • <i> : kursywa
  • <b> lub <strong> : pogrubienie
  • <em> : wyróżniony tekst
W Odlotowym Wyścigu możecie wcielić się w jedną z historycznych postaci, zbudować własną maszynę krocząco-latającą i stanąć w szranki z innymi steampunkowymi wynalazcami! Połączcie prąd, parę, garść trybików i zaworów w jedną niestabilną konstrukcję i ruszajcie w wyścig wokół Alp!

Na czym to polega?

W Odlotowym Wyścigu wcielamy się w jednego z szesnastu dostępnych odkrywców, od Marie Curie przez Adę Lovelace po Thomasa Edisona. Dostajemy kartę kokpitu naszego wynalazku wraz z dołączoną do niej kartą silnika.

Ustawiamy się na linii startu, pierwszym z sześciu losowych kafelków podzielonych na pola i zaczynamy wyścig!

Dlaczego pokochasz tę grę?

Odlotowy Wyścig to zachwycająca graficznie strategia w innowacyjny sposób mieszająca mechanizmy karcianego draftu, rzucania kostkami i jednoczesnego wykonywania akcji.

Zachwyci nie tylko fanów steampunku, ale też wszystkich graczy doceniających pozycję, w którą zagrać może do ośmiu osób bez znaczącego wpływu na długość rozgrywki. Zasady gry bardzo łatwo tłumaczy się nowym osobom.
Wyprawa HMS Beagle to niezwykła kampania do gry Robinson Crusoe. Wysyłamy od ręki! Więcej informacji uzyskasz pod nr telefonu:

5. Atrybuty

Wyróżniamy dwa rodzaje atrybutów. Pierwszy rodzaj, to tzw. atrybuty integracyjne, które w łatwy sposób pozwolą na połączenie Twoich ofert z naszymi.

Drugi rodzaj atrybutów, to taki, dzięki którym użytkownik będzie w stanie znaleźć interesujący go produkty i pozna ich dokładne parametry (filtry i specyfikacje techniczne)

5.1. Atrybuty integracyjne

Tworząc plik XML, musisz pamiętać, żeby dla każdego z Twoich produktów uzupełnić atrybuty integracyjne, bez których przeprowadzenie integracji z Ceneo.pl nie będzie możliwe.

Uzupełnij:

  • Producenta
  • Kod producenta - często model produktu, lub inny unikatowy numer nadany przez producenta
  • Kod EAN - 8 lub 13 cyfrowy kod znajdujący się na opakowaniu (tzw. kod kreskowy)
  • Kod ISBN (jeżeli sprzedajesz książki) - 13 cyfrowy numer identyfikujący każdą książkę i e-booka
  • Kod leku (jeżeli sprzedajesz leki i suplementy OTC) - 7 cyfrowy identyfikator każdego dostępnego leku OTC i suplementu w Polsce

5.2. Filtry i specyfikacje

Zadbaj o to, aby użytkownik był w stanie odnaleźć Twoje produkty oraz mógł dowiedzieć się o nich jak najwięcej. W tym celu konieczne będzie uzupełnienie dalszej części atrybutów z cechami produktów.

W poniższym pliku znajdziesz wszystkie atrybuty dostępne na Ceneo.pl z podziałem na kategorie. Część z nich została oznaczona jako:<iskeyattribute>True</iskeyattribute> - są to atrybuty kluczowe, niezbędne do podjęcia decyzji zakupowej. Uzupełnienie tych atrybutów jest wymagane.

Plik z atrybutami

Przykładem atrybutu kluczowego jest - Rozmiar. Sprzedaż produktów w branży Moda, bez rozmiaru, skutkować będzie brakiem zainteresowania ze strony kupującego, jak również tym, że produkty nie zostaną wyszukane przy pomocy filtrów.

Użytkownik po wybraniu odpowiednich cech produktów, otrzyma listę produktów, które spełniają jego wymagania

Po wybraniu konkretnego produktu będzie mógł sprawdzić jego najważniejsze parametry

6. Warianty produktów - filtry na stronie produktu

Uzupełnienie atrybutów posłuży również do wyeksponowania Twojej oferty na karcie produktu. Jeżeli twoja oferta posiada atrybut np. smak, rozmiar lub inny, koniecznie dodaj je do pliku XML. Wyświetlimy je jako filtr na karcie produktu.

  1. Chcemy wprowadzić wskazaną funkcja możliwie w jak największej ilości kategorii.
  2. Atrybuty, które podasz, zostaną zaprezentowane jako filtr na karcie produktu. Dzięki filtrom wyróżnisz swoją ofertę zupełnie za darmo.
  3. Poinformujemy Twojego klienta ile wariantów produktu oferujesz. Informacja ta przyciągnie uwagę kupujących.

Przykład 1: Oferta z wariantem smakowym (cena stałą dla wszystkich atrybutów)

Atrybutem wariantowym w przykładzie jest smak, jego wartości należy wymienić rozdzielając średnikiem.

<attrs>
    <a name="Producent">
        <![CDATA[Trec]]>
    </a>
    <a name="EAN">
        <![CDATA[5053190019791]]>
    </a>
    <a name="Pojemność">
        <![CDATA[2275g]]>
    </a>
    <a name="Smak">
        <![CDATA[Czekoladowo-Kokosowy;Truskawka;Czekolada,Wanilia;Ciasteczkowy;]]>
    </a>
</attrs>

Przykład 2. Wariant ma wpływ na cenę

W takim przypadku należy przekazać każdy jako osobna ofertę w pliku XML. W atrybutach podać parametry, które dotyczą tylko tego wariantu.

<attrs>
    <a name="Producent">
        <![CDATA[Trec]]>
    </a>
    <a name="EAN">
        <![CDATA[5053190019791]]>
    </a>
    <a name="Pojemność">
        <![CDATA[2275g]]>
    </a>
    <a name="Smak">
        <![CDATA[Czekoladowo-Kokosowy]]>
    </a>
</attrs>
<pre class="prettyprint linenums">
  Many
  lines
  of
  code
</pre>