INFORMACJE NA TEMAT STRUKTURY PLIKÓW XML

Informacje na temat struktury plików XML
INFORMACJE NA TEMAT STRUKTURY
PLIKÓW XML
(OSTATNIA MODYFIKACJA 2010.08.17)
Informacje na temat struktury plików XML
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
Ceneo S.A. ul. Ostrowskiego 13d/3 53-238 Wrocław,
NIP 899-25-45-102 Sąd Rejonowy dla Wrocławia-Fabrycznej, VI Wydział Gospodarczy, KRS 0000240979 Kapitał zakładowy: 500 000 zł
(opłacony w całości)
Strona 2
Informacje na temat struktury plików XML
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.
Ceneo S.A. ul. Ostrowskiego 13d/3 53-238 Wrocław,
NIP 899-25-45-102 Sąd Rejonowy dla Wrocławia-Fabrycznej, VI Wydział Gospodarczy, KRS 0000240979 Kapitał zakładowy: 500 000 zł
(opłacony w całości)
Strona 3
Informacje na temat struktury plików XML
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
Producent
Producent
Model
Model/kod producenta/numer
katalogowy
EAN
Kod EAN
Ceneo S.A. ul. Ostrowskiego 13d/3 53-238 Wrocław,
NIP 899-25-45-102 Sąd Rejonowy dla Wrocławia-Fabrycznej, VI Wydział Gospodarczy, KRS 0000240979 Kapitał zakładowy: 500 000 zł
(opłacony w całości)
Strona 4
Informacje na temat struktury plików XML
Rodzaj dla sklepu komputerowego
Kod_producenta
Unikatowy kod, umieszczany przez
producenta przy produkcie
Producent
Producent 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
Producent
Producent
Model
Model
Rodzaj
Rodzaj
Pojemnosc
Pojemnośd
Ceneo S.A. ul. Ostrowskiego 13d/3 53-238 Wrocław,
NIP 899-25-45-102 Sąd Rejonowy dla Wrocławia-Fabrycznej, VI Wydział Gospodarczy, KRS 0000240979 Kapitał zakładowy: 500 000 zł
(opłacony w całości)
Strona 5
Informacje na temat struktury plików XML
Rodzaj dla sklepu z filmami
Rezyser
Reżyser
Obsada
Obsada
Nosnik
Nośnik
Tytul_oryginalny
Tytuł oryginalny
EAN
Kod EAN
Rodzaj dla sklepu z felgami
Producent
Producent
Rozmiar
Rozmiar
Rozstaw_srub
Rozstaw śrub
Odsadzenie
Odsadzenie
Rodzaj dla sklepu z Lekami
Producent
Producent
Kod Bloz 12
Unikatowy kod nadawany każdemu
produktowi
Opakowanie
Opakowanie/pojemnośd
Ceneo S.A. ul. Ostrowskiego 13d/3 53-238 Wrocław,
NIP 899-25-45-102 Sąd Rejonowy dla Wrocławia-Fabrycznej, VI Wydział Gospodarczy, KRS 0000240979 Kapitał zakładowy: 500 000 zł
(opłacony w całości)
Strona 6
Informacje na temat struktury plików XML
Rodzaj dla sklepu z oponami
SAP
Kod SAP
EAN
Kod EAN
Producent
Producent
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
EAN
Kod EAN
Platforma
Rodzaj platformy
Gatunek
Rodzaj gatunku
Ceneo S.A. ul. Ostrowskiego 13d/3 53-238 Wrocław,
NIP 899-25-45-102 Sąd Rejonowy dla Wrocławia-Fabrycznej, VI Wydział Gospodarczy, KRS 0000240979 Kapitał zakładowy: 500 000 zł
(opłacony w całości)
Strona 7
Informacje na temat struktury plików XML
Rodzaj dla sklepu z muzyką
EAN
Kod EAN
Kod_Wytworni
Kod wytwórni
Wykonawca
Wykonawca
Tytul_plyty
Tytuł płyty
Wytwornia
Nazwa wytwórni
Gatunek
Nazwa gatunku
Rodzaj dla sklepu z delikatesami
Producent
EAN
Producent
Kod EAN
Opakowanie
Opakowanie/pojemnośd
Ceneo S.A. ul. Ostrowskiego 13d/3 53-238 Wrocław,
NIP 899-25-45-102 Sąd Rejonowy dla Wrocławia-Fabrycznej, VI Wydział Gospodarczy, KRS 0000240979 Kapitał zakładowy: 500 000 zł
(opłacony w całości)
Strona 8
Informacje na temat struktury plików XML
3. Parametry pliku
PARAMETR WYMAGANY OPIS
id
tak
name
tak
price
tak
url
tak
categoryId
tak
description
nie
image
tak
EAN
nie
availability
nie
Identyfikator produktu.
Każdy produkt w sklepie musi posiadad unikatowy, niezmienny
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.
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
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.
Adres http, pod którym znajduje się produkt.
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
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.
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.
Kod EAN
Przypisany do produktu kod EAN. Nieobowiązkowy, lecz ułatwiający
integrację produktu.
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
Ceneo S.A. ul. Ostrowskiego 13d/3 53-238 Wrocław,
NIP 899-25-45-102 Sąd Rejonowy dla Wrocławia-Fabrycznej, VI Wydział Gospodarczy, KRS 0000240979 Kapitał zakładowy: 500 000 zł
(opłacony w całości)
Strona 9
Informacje na temat struktury plików XML
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
Ceneo S.A. ul. Ostrowskiego 13d/3 53-238 Wrocław,
NIP 899-25-45-102 Sąd Rejonowy dla Wrocławia-Fabrycznej, VI Wydział Gospodarczy, KRS 0000240979 Kapitał zakładowy: 500 000 zł
(opłacony w całości)
Strona 10
Informacje na temat struktury plików XML
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
Ceneo S.A. ul. Ostrowskiego 13d/3 53-238 Wrocław,
NIP 899-25-45-102 Sąd Rejonowy dla Wrocławia-Fabrycznej, VI Wydział Gospodarczy, KRS 0000240979 Kapitał zakładowy: 500 000 zł
(opłacony w całości)
Strona 11