INFORMACJE NA TEMAT STRUKTURY PLIKU XML Marzec 2014 str. 1
1. Wstęp Przygotowanie pliku o określonej strukturze jest kluczem do sprawnej integracji Państwa ofert z serwisem Ceneo. Bardzo istotna jest informacja z jakich branż pochodzą oferowane produkty. To od rodzaju branży zależy bowiem, jakie dodatkowe informacje (atrybuty) powinny znaleźć się w pliku XML. Przygotowany plik należy umieścić na serwerze. Następnie adres URL pliku XML należy przesłać obsłudze Ceneo. Ceneo nie przetwarza oferty na podstawie plików wysyłanych mailem. Lokalizacja pliku XML musi być stała. O każdorazowej zmianie adresu URL pliku XML powinno się poinformować pracownika obsługi klienta serwisu Ceneo. ID ofert (produktów) w pliku XML muszą być stałe oraz niepowtarzalne raz użyte ID nie może być ponownie wykorzystane dla innego produktu. Jeżeli w pliku XML zmianie ulegną ID ofert (produktów) należy niezwłocznie poinformować o tym fakcie pracowników obsługi klienta serwisu Ceneo. Dostęp do pliku XML nie może być ograniczony. Pliki mogą być blokowane dla ogółu użytkowników, natomiast muszą być dostępne dla określonej przez Ceneo puli IP. Aby uzyskać adresy IP, dla których plik musi być udostępniony, należy skontaktować się drogą mailową z obsługą klienta Ceneo. Dane znajdujące się w pliku XML muszą być zgodne z informacjami podanymi na stronie sklepu. Brak aktualizacji pliku, rozbieżność w cenach czy dostępnościach produktów jest podstawą do ukrycia oferty sklepu na Ceneo. Do pliku XML mogą być generowane jedynie produkty, które w danym momencie użytkownik może zamówić w sklepie internetowym. Produkty niedostępne lub/i nieposiadające aktywnego koszyka na stronie oferty nie mogą być generowane do pliku XML, a ich wystąpienie w nim może być podstawią do zawieszenia prezentowania oferty w serwisie Ceneo. Również w przypadku błędów w pliku XML uniemożliwiających prawidłowe przetworzenie oferty, prezentowanie jej na Ceneo jest zawieszane do czasu usunięcia błędów przez sklep. W wyżej wymienionych przypadkach sklepy są informowane o zaistniałej sytuacji drogą mailową. str. 2
2. Struktura pliku 2.1 Ogólna struktura pliku. <?xml version="1.0" encoding="utf-8"?> <offers xmlns:xsi="http://www.w3.org/2001/xmlschema-instance" version="1"> <group name="other"> <o id="151" url="http://www.sklep.tel.pl/id=158" price="980.15" avail="1" set="0" weight="3.5" basket="1" stock="2"> <cat> <![CDATA[Komputery/Monitory/Monitory LCD]]> </cat> <name> <![CDATA[Dell UB13H]]> </name> <imgs> <main url="http://www.sklep.pl/images/151big.jpg"/> <i url="http://www.sklep.pl/images/151small.jpg"/> </imgs> <desc> <![CDATA[Matryca monitora wykonana z niezwykle...]]> </desc> <attrs> <a name=""> <![CDATA[Dell]]> <a name="kod_producenta"> <![CDATA[UB13H]]> <a name=""> <![CDATA[142521534124]]> </attrs> </o> </group> </offers> 2.2 Objaśnienie znaczników. Każda z ofert znajduje się pomiędzy znacznikami <o> i </o> <?xml version="1.0" encoding="utf-8"?> Kodowanie pliku. Dostępne opcje kodowania UTF-8 zalecane, ISO-8859-2 oraz Windows-1250. Wymagane str. 3
<offers xmlns:xsi="http://www.w3.org/2001/xmlschema-instance" version="1"> Część stała pliku. Wymagane <group name="other"> Informacja z jakiej branży pochodzą oferty. Możliwe do wyboru: books, tires, perfumes, music, games, movies, medicines, rims, grocery, clothes oraz other (pozostałe nie wymienione branże). Opcjonalnie <o id="151" url="http://www.sklep.tel.pl/id=158" price="980.15" avail="1" set="0" weight="3.5" basket="1" stock="2"> Podstawowe informacje o ofercie. id - unikalne i niezmienne id produktu. Maksymalna ilość znaków 100. Wymagane url - url produktu. Maksymalna ilość znaków 2048. Wymagane price - cena produktu. Liczba zmiennoprzecinkowa, separator kropka. Wymagane avail - dostępność produktu. Dostępne opcje [1, 3, 7, 14, 99] 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 produkt zostanie wysłany nie wcześniej niż za tydzień, 99 brak informacji o dostępności status sprawdź w sklepie. Podane wartości muszą być zgodnie ze stanem faktycznym, znacznik nie może pozostawać pusty czy też posiadać wartość 0. Opcjonalnie set - zestaw. Czy oferta jest zestawem. Dostępne opcje [1, 0] gdzie; 1 tak, oferta jest zestawem, 0 nie, oferta nie jest zestawem. Opcjonalnie weight - waga. Waga oferty w kilogramach, separator kropka, nie może być podana wartość 0 bądź puste pole. Opcjonalnie (podanie wag produktów z czasem będzie wymagane) basket - dotyczy sklepów aktywnych w usłudze Kup na Ceneo. Czy oferta ma być dostępna w Kup na Ceneo. Dostępne opcje [1, 0] gdzie; 1 tak, oferta dostępna w Kup na Ceneo, 0 nie, oferta niedostępna w Kup na Ceneo. Opcjonalnie stock - stan magazynowy. Liczna całkowita dodatnia. Pole nie może być puste. Opcjonalnie <cat> <![CDATA[Komputery/Monitory/Monitory LCD]]> </cat> Informacja o pełnej ścieżce kategorii. Maksymalna ilość znaków 255. Wymagane (Zalecane jest zmapowanie kategorii sklepowych do kategorii Ceneo. Link do kategorii: http://api.ceneo.pl/kategorie/dane.xml ) UWAGA Księgarnie - Dodatkowo dla Kategorii Książki należy wprowadzić wyraźny podział na Ebooki (Eksiążki), jeśli występują w asortymencie, np.: <cat> <![CDATA[Ebooki/Książki tematyczne, hobby/ekonomia, biznes/pozostałe]]> </cat> str. 4
<name> <![CDATA[Dell UB13H]]> </name> Informacja o dokładnej nazwie produktu. Maksymalna ilość znaków 150. Wymagane <imgs> <main url="http://www.sklep.pl/images/151big.jpg"/> <i url="http://www.sklep.pl/images/152big.jpg"/> <i url="http://www.sklep.pl/images/153big.jpg"/> </imgs> Informacja z linkiem do zdjęć. Maksymalna ilość znaków zdjęcia głównego oraz dodatkowego 255. Opcjonalnie <desc> <![CDATA[Matryca monitora wykonana z niezwykle...]]> </desc> Informacja o opisie produktu. Opcjonalnie <attrs> <a name=""> <![CDATA[Dell]]> <a name="kod_producenta"> <![CDATA[UB13H]]> <a name=""> <![CDATA[142521534124]]> </attrs> Informacja o atrybutach. Dany produkt może posiadać maksymalnie 10 atrybutów. Atrybuty różnią się w zależności od branży z jakiej oferta pochodzi. Grupa atrybutów znajduję się pomiędzy znacznikami <attrs> i </attrs>, a każdy atrybut znajduje się pomiędzy znacznikami <a> i Wymagane opcja z wariantami 2.3 Ogólna struktura pliku * Co to jest? Jeżeli posiadasz warianty oferty np. oferta w kolorze białym i czarnym, należy każdy z nich przedstawić jako oddzielną ofertę (o unikatowym ID ) a atrybut decydujący o wariancie umieścić w nazwie lub oznaczyć dodatkowo symbolem v="1" w sekcji z atrybutami np. <name><![cdata[koszula Zerra biały]]></name> lub str. 5
<attrs> <a name=""> <![CDATA[Zerra]]> <a name="kod_producenta"> <![CDATA[xf-1]]> <a name="kolor" v="1"> <![CDATA[biały]]> </attrs> 3. Atrybuty wg branż Część kategorii ze względu na specyficzny rodzaj integracji, wymaga udostępnienia określonych informacji w postaci atrybutów. Książki (grupa: books) Opony (grupa: tires) Felgi i kołpaki (grupa: rims) Perfumy (grupa: perfumes ) Płyty muzyczne (grupa: music ) Gry PC / Gry na konsole (grupa: games) Filmy (grupa: movies) Leki, suplementy (grupa: medicines ) Delikatesy (grupa: grocery) Odzież, obuwie, dodatki (grupa: clothes) Inne (grupa: other) Książki (grupa: books) Autor ISBN Ilosc_stron Wydawnictwo Rok_wydania Oprawa Format Spis_tresci Imię i nazwisko autora Kod ISBN nadawany książkom Informacja na temat liczby stron Nazwa wydawnictwa Rok publikacji książki Rodzaj oprawy np., miękka, twarda Wymiary książki np. B5, A5, 172x245cm, 15.5x22.5cm Link do spisu treści str. 6
Fragment Link do fragmentu książki E-booki (grupa: books) Autor ISBN Ilosc_stron Wydawnictwo Rok_wydania Oprawa Format Spis_tresci Fragment Imię i nazwisko autora Kod ISBN nadawany książkom Informacja na temat liczby stron Nazwa wydawnictwa Rok publikacji książki Proszę o pozostawienie tej wartości pustej Format ebooka np. PDF, epub, AZW, MOBI Link do spisu treści Link do fragmentu książki Audiobooki (grupa: books) Autor ISBN Ilosc_stron Wydawnictwo Rok_wydania Oprawa Format Spis_tresci Fragment Imię i nazwisko autora Kod ISBN nadawany książkom Informacja na temat liczby stron Nazwa wydawnictwa Rok publikacji książki Proszę o pozostawienie tej wartości pustej Format ebooka np. MP3, WMV, Płyta CD Link do spisu treści Link do fragmentu książki Delikatesy (grupa: grocery) Ilosc produktu Ilość w opakowaniu np.. 12szt., 2kg str. 7
Opony (grupa: tires) SAP Model Szerokosc_opony Profil Srednica_kola Indeks_predkosc Indeks_nosnosc Sezon opony Kod producenta Model opony Szerokość opony w milimetrach Profil opony Średnica osadzenia podana w calach Indeks dopuszczalnej prędkości Maksymalne obciążenie w funtach Sezonowość np. Zimowe, Letnie, Całoroczne Felgi i kołpaki (grupa: rims) felgi Kod_producenta Kod nadawany produktowi przez producenta Rozmiar Szerokość i zewnętrzna średnica w calach np. 6,5x15 Liczba śrub mocujących i średnica okręgu, na której znajdują się otwory np. Rozstaw_srub 5x110 Odległości między płaszczyzną montażową obręczy, a jej środkiem symetrii Odsadzenie (tylko dla felg) (ET) Perfumy (grupa: perfumes) Kod_producenta Linia Rodzaj Pojemnosc perfum Kod nadawany produktowi przez producenta Linia zapachu seria np. Miss Pucci, Orange Celebration of Happiness, Rodzaj produktu np. Woda perfumowana, Woda toaletowa, Woda kolońska, Dezodorant roll on, Dezodorant sztyft Pojemność podana w mililitrach np. 50 ml, 100 ml str. 8
Płyty muzyczne (grupa: music) Wykonawca Nosnik Wytwornia Gatunek Imię i nazwisko wykonawcy lub nazwa zespołu Kod kreskowy Rodzaj nośnika np. DVD, CD Nazwa wytwórni muzycznej Gatunek muzyczny Gry PC / Gry na konsole (grupa: games) Kod_producenta Platforma Gatunek gry Kod nadawany produktowi przez producenta Kod kreskowy Platforma, na jaką jest przeznaczona gra np. PC, PS2, Xbox360 Gatunek gry np. Akcji, Wyścigi Filmy (grupa: movies) Rezyser Nosnik Wytwornia Obsada Tytul_oryginalny Imię i nazwisko reżysera filmu Rodzaj nośnika np. DVD, VCD, Blu-Ray Nazwa wytwórni filmowej Aktorzy grający w danym filmie Oryginalny tytuł filmu str. 9
Leki, suplementy (grupa: medicines ) BLOZ_12 BLOZ_7 Ilosc Nazwa firmy farmaceutycznej Identyfikator leku konieczne jest podanie minimum jednego z kodów dla leków i produktów aptecznych. Zalecane jest podawanie obydwu kodów dla każdego produktu. Dla artykułów, które nie posiadają kodu Bloz12 należy podać kod Bloz7. Liczba tabletek, pojemność butelki np. 12szt., 250ml Odzież, obuwie, dodatki (grupa: clothes) Model Kolor Rozmiar Kod_produktu Sezon Fason ProductSetId produktu Model produktu Kolor dominujący, w przypadku gdy produkt występuje w kilku wariantach kolorystycznych powinna się pojawić oddzielna oferta dla każdego koloru (pole wymagane) Rozmiar, w przypadku gdy produkt jest dostępny w różnych rozmiarach poszczególne wartości powinny zostać oddzielone średnikiem np. S;L;XL (pole wymagane) Kod nadawany przez producenta Sezon np. wiosna/lato Rozumiany, jako fason pojedyncza wartość np. rurki, dzwony, szerokie, szmizjerka Oznaczenie zestawu Inne (grupa: other) Kod_producenta danego produktu Kod nadawany produktowi przez producenta str. 10
str. 11