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ć:
- 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)
- Nie zmieniaj lokalizacji pliku. O każdorazowej zmianie ścieżki poinformuj nasz zespół.
- 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.
- 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.
- 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:
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.
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.
- Dodaj zdjęcia jak największej rozdzielczości.
- Zdjęcia muszą przedstawiać sam produkt na białym tle
- Produkt powinien wypełniać całą przestrzeń zdjęcia oraz być w jego centrum
- Zdjęcia nie mogę zawierać znaków wodnych, dopisków handlowych i informacji produktowych
- Nie powiększaj zdjęć i nie przesyłaj miniatur
- Zdjęcia dodatkowe mogą przedstawiać ekspozycję produktu lub przedstawiać go w użyciu
- 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<h2>
: tytuł nagłówka<h3>
: podtytuł<br/>
: nowa linia<ol>
: lista numerowana<ul>
: lista nienumerowana<li>
: element listy<i>
: kursywa<b>
lub<strong>
: pogrubienie<em>
: wyróżniony tekst
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.
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 atrybuty:
- Marka
- 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
- Wyprodukowane przez - podmiot, który wytwarza produkt lub który zleca zaprojektowanie lub wytworzenie produktu i oferuje ten produkt pod własną nazwą lub znakiem towarowym
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:
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.
- Chcemy wprowadzić wskazaną funkcja możliwie w jak największej ilości kategorii.
- Atrybuty, które podasz, zostaną zaprezentowane jako filtr na karcie produktu. Dzięki filtrom wyróżnisz swoją ofertę zupełnie za darmo.
- 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="Marka">
<![CDATA[Trec]]>
</a>
<a name="EAN">
<![CDATA[748927029574]]>
</a>
<a name="Pojemność">
<![CDATA[2275g]]>
</a>
<a name="Smak">
<![CDATA[Czekoladowo-Kokosowy;Truskawka;Czekolada,Wanilia;Ciasteczkowy;]]>
</a>
<a name="Wyprodukowane przez">
<![CDATA[Glanbia Performance Nutrition, Inc.]]>
</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="Marka"> <![CDATA[Trec]]> </a> <a name="EAN"> <![CDATA[748927029574]]> </a> <a name="Pojemność"> <![CDATA[2275g]]> </a> <a name="Smak"> <![CDATA[Czekoladowo-Kokosowy]]> </a> <a name="Wyprodukowane przez"> <![CDATA[Glanbia Performance Nutrition, Inc.]]> </a>
</attrs>
7. Prekursory materiałów wybuchowych
Prekursory materiałów wybuchowych podlegające regulacji – w rozumieniu Rozporządzenia Parlamentu Europejskiego i Rady (UE) 2019/1148 z dnia 20 czerwca 2019 r. w sprawie wprowadzania do obrotu i stosowania prekursorów materiałów wybuchowych, zmieniającego rozporządzenie (WE) nr 1907/2006 i uchylające rozporządzenie (UE) nr 98/2013. Warunek: Mogą być oferowane wyłącznie przez Kontrahentów, którzy wymienili w treści oferty każdy z prekursorów zawierający się w towarze będącym przedmiotem oferty oraz stężenia w odniesieniu do każdego z tych prekursorów.
8. Etykiety energetyczne
Od marca 2021 r. produkty w z kategorii AGD i RTV, tj:-Pralki
-Pralko-suszarki
-Lodówki
-Chłodziarki
-Zmywarki
-Telewizory
-Monitory
-Źródła światła
posiadają nowe etykiety energetyczne. Nie zobaczymy już na nich oznaczeń w skali +, a jedynie siedmiopunktową skalę, od A do G. Zmiana ta podyktowana jest Rozporządzeniem Parlamentu Europejskiego i Rady (UE) 2017/1369[2].
Więcej szczegółowych informacji na temat zmian etykiet i klasyfikacji znajdziesz na stronie https://www.ceneo.pl/poradniki/nowe-etykiety-energetyczne
W związku z tym prosimy, aby w plikach XML, z których pobieramy Państwa oferty, znalazły się informacje o klasie energetycznej, link do pobrania etykiety oraz karty produktu. Pozwoli to nam prezentować Państwa oferty w sposób zgodny z najnowszymi rozporządzeniami.
Nie mogą one zawierać loga sklepu, znaków wodnych i innych dopisków, zmieniających w jakikolwiek sposób kartę i etykietę producencką.
Dane te powinny zostać zapisane w sekcji atrybutów (opisywana szerzej w 5 punkcie tego poradnika). Poniżej zapis, który pozwoli nam na pracę z etykietami w sposób najbardziej efektywny.
<attrs> <a name="Etykieta energetyczna"> <![CDATA[https://eprel.ec.europa.eu/label/Label_337394.png]]> </a> <a name="Karta informacyjna"> <![CDATA[https://eprel.ec.europa.eu/informationsheet/Fiche_337394_PL.pdf]]> </a> <a name="Klasa energetyczna"> <![CDATA[B]]> </a> </attrs>
9. Wyroby medyczne
Od czerwca 2023 roku sprzedający mają obowiązek prawidłowej
klasyfikacji produktu jako wyrobu medycznego. Zmiana ta podyktowana jest przez
następujące akty prawne:
·
ustawa
z dnia 7 kwietnia 2022 r. o wyrobach medycznych
·
rozporządzeniu
PE i Rady (UE) 2017/745 w sprawie wyrobów medycznych
·
rozporządzeniu
PE i Rady (UE) 2017/746 w sprawie wyrobów medycznych do diagnostyki in vitro.
W związku z tym prosimy, aby w plikach XML, z których
pobieramy Państwa oferty, znalazły się informacje o tym, czy produkt jest
wyrobem medycznym. Pozwoli to nam prezentować Państwa oferty w sposób zgodny z obowiązującymi
rozporządzeniami.
Dane te powinny zostać zapisane w sekcji atrybutów
(opisywana szerzej w 5 punkcie tego poradnika). Poniżej zapis, który pozwoli
nam na pracę z wyrobami medycznymi w sposób najbardziej efektywny. Zależnie od
typu produktu medycznego należy przekazać w XML jeden z poniższych atrybutów:
<attrs> <a name="Wyrób medyczny"> <![CDATA[Wyrób medyczny lub wyrób medyczny do diagnostyki in-vitro]]> </a> </attrs>lub
<attrs> <a name="Wyrób medyczny"> <![CDATA[Wyposażenie wyrobu medycznego lub produkt niemający przewidzianego zastosowania medycznego]]> </a> </attrs>
Dane te powinny zostać przekazane w sekcji atrybutów w następujący sposób:
<attrs> <a name="Producent wyrobu medycznego"> <![CDATA[Orkla Care S.A.]]> </a> </attrs>lub
<attrs> <a name="Upoważniony przedstawiciel"> <![CDATA[Reckitt Benckiser (Poland) S.A.]]> </a> </attrs>