INFORMACJE NA TEMAT STRUKTURY PLIKÓW XML (OSTATNIA MODYFIKACJA 2010.08.17)
Spis treści 1. Ogólne założenia do pliku... 3 2. Rodzaje plików XML... 4 3. Parametry pliku... 9 4. Tabela zamienników... 10 5. Podsumowanie... 11 Strona 2
1. Ogólne założenia do pliku W pierwszej fazie przygotowania pliku xml, należy zastanowid się, jakiej branży jest asortyment sklepu. Dobrze przygotowany plik przełoży się na szybsze zintegrowanie produktów w Ceneo.pl. Istnieje kilka specyfikacji plików różniących się jedynie ilością dodatkowych informacji (atrybutów). Rodzaje plików znajdują się w punkcie drugim. Plik należy przygotowad w jednym z trzech dostępnych typów kodowania: Central European ISO 8859 2 Central European Windows 1250 Unicode UTF 8 Przygotowany plik należy umieścid pod adresem http, po czym podad nam do pliku link. Oferta aktualizowana jest automatycznie z wcześniej podanego linku (czyli plik na serwerze musi byd nadpisywany, aby link nie zmieniał swojej nazwy). Nie aktualizujemy oferty na podstawie plików wysyłanych na maila. Plik nie musi mied rozszerzenia xml może byd php, txt, aspx, html. Strona 3
2. Rodzaje plików XML Aby można było poprawnie zintegrowad produkt, w pliku musza byd zawarte podstawowe dane na jego temat. Jeżeli produkt jest firmowy, w pliku musi byd zawarta informacja o producencie oraz modelu/kodzie producenta. Poniżej przedstawiono listę atrybutów wymaganych dla specyficznych branż. W celu zapoznania się z przykładowym xml em dla danej branży proszę kliknąd na żądaną specyfikację. 1. Ogólny 2. Komputery 3. Książki 4. Opony 5. Perfumy ( drogerie ) 6. Filmy 7. Felgi aluminiowe 8. Muzyka 9. Gry 10. Delikatesy 11. Leki Wzór ogólny dotyczy wszystkich branż oprócz tych, które zostały wymienione w podpunktach od 2 do 9 (np. AGD, RTV, fotografia, telefony, zabawki, armatura sanitarna itd. dotyczą wzoru ogólnego). Przykłady różnią się jedynie atrybutami występującymi w pliku. Poza tym struktura znaczników w każdym z przypadków jest taka sama. W tabelach poniżej przedstawiono opis atrybutów występujących w plikach xml dla odpowiednich branż. Ważne jest, aby była zachowana kolejnośd atrybutów. Rodzaj ogólny Model Model/kod producenta/numer katalogowy Strona 4
Rodzaj dla sklepu komputerowego Kod_producenta Unikatowy kod, umieszczany przez producenta przy produkcie produktu Rodzaj dla księgarni Autor Autor książki ISBN Unikatowy numer książki Ilosc_stron Ilośd stron w książce Wydawnictwo Wydawnictwo Rodzaj dla drogerii Model Model Rodzaj Rodzaj Pojemnosc Pojemnośd Strona 5
Rodzaj dla sklepu z filmami Rezyser Reżyser Obsada Obsada Nosnik Nośnik Tytul_oryginalny Tytuł oryginalny Rodzaj dla sklepu z felgami Rozmiar Rozmiar Rozstaw_srub Rozstaw śrub Odsadzenie Odsadzenie Rodzaj dla sklepu z Lekami Kod Bloz 12 Opakowanie Unikatowy kod nadawany każdemu produktowi Opakowanie/pojemnośd Strona 6
Rodzaj dla sklepu z oponami SAP Kod SAP Model Model Szerokosc Szerokośd Profil Profil Srednica Średnica Predkosc Prędkośd Nosnosc Nośnośd Sezon Sezon (letni/zimowy) Typ_pojazdu Typ pojazdu Rodzaj dla sklepu z grami Platforma Gatunek Rodzaj platformy Rodzaj gatunku Strona 7
Rodzaj dla sklepu z muzyką Kod_Wytworni Kod wytwórni Wykonawca Wykonawca Tytul_plyty Tytuł płyty Wytwornia Nazwa wytwórni Gatunek Nazwa gatunku Rodzaj dla sklepu z delikatesami Opakowanie Opakowanie/pojemnośd Strona 8
3. Parametry pliku PARAMETR WYMAGANY OPIS Identyfikator produktu. Każdy produkt w sklepie musi posiadad unikatowy, niezmienny id tak identyfikator (w postaci liczby lub ciągu znaków) zwany id. Najczęściej występuje on również w adresie http. Id nie można nadpisywad. name tak Nazwa produktu. W nazwie nie mogą znajdowad się tagi html. Jeśli występują nawiasy ostre, czyli < >, należy zapisad je w postaci niejawnej (zamienniki znajduje się w tabelce poniżej). Można stosowad sekcje CDATA price tak Cena produktu. Musi byd wartością liczbową. Złotówki od groszy oddzielamy przecinkiem lub kropką. Np. 120.99 lub 120,99 Cena musi byd z VAT. Należy uwzględnid ceny promocyjne. url tak Adres http, pod którym znajduje się produkt. categoryid tak Kategoria, w której znajduje się produkt. Powinna byd dokładnie sprecyzowana. Dla monitorów LCD powinno byd np. Komputery/Monitory/Monitory LCD. Błędem jest podanie samego słowa Monitory. Można stosowad sekcje CDATA. Uwaga! Sugerujemy przygotowanie kategorii o nazwach identycznych jak na Ceneo. Struktura kategorii znajduje się pod adresem: http://api.ceneo.pl/kategorie/dane.xml description nie Opis produktu. Nie może zawierad tagów html. Dopuszczalne są jedynie <br> <li> <p> <ul> oraz <tr> przy czym nawiasy ostre koniecznie muszą byd zapisane w postaci zamienników (patrz tabelka poniżej). Można stosowad sekcje CDATA. image tak Adres http dużego zdjęcia produktu. Brak zdjęcia w pliku dla produktu, który zostanie zakwalifikowany jako nowy w Ceneo (nie mający porównao z innymi sklepami), spowoduje wyświetlenie jego oferty bez zdjęcia. Minimalny rozmiar zdjęcia to 100x100 pikseli. nie Przypisany do produktu kod. Nieobowiązkowy, lecz ułatwiający integrację produktu. availability nie Dostępnośd produktu w sklepie. Możliwe statusy: 1 dostępny, sklep posiada produkt 3 - sklep będzie posiadał produkt do 3 dni 7 sklep będzie posiadał produkt w ciągu tygodnia 14- produkt dostępny nie wcześniej niż za tydzieo Brak statusu/sekcji link prowadzący do informacji w sklepie Strona 9
4. Tabela zamienników Oprócz wymienionych znaczników plik musi zawierad odpowiedni nagłówek i stopkę: Rys.1 Tagi zaczynające plik Rys.2 Tagi kooczące plik Strona 10
5. Podsumowanie Link do pliku xml z ogólną strukturą https://panel.ceneo.pl/xmltemp/ceneo_xml.xml Link do kategorii (plik generowany dynamicznie) http://api.ceneo.pl/kategorie/dane.xml Strona 11