Podręcznik integracji - specyfikacja formatu eksportu ofert do serwisu OnetZakupy

Transkrypt

1 Podręcznik integracji - specyfikacja formatu eksportu ofert do serwisu OnetZakupy (wersja )

2 Spis treści Spis treści Metody dostarczania danych i mapowanie kategorii Pierwsza metoda dostarczania danych metoda pasywna Druga metoda dostarczania danych metoda aktywna Trzecia metoda dostarczania danych Mapowanie kategorii Wymagania Kodowanie Znaki specjalne Kolejność elementów Przestrzeń nazw (namespace) Rodzaje wrzutów Usuwanie ofert Opis struktury wrzutu Wstęp elementy wrzutu <oferty> (wymagany) aktualizacja (atrybut wymagany) przestrzeń nazw (atrybut wymagany) <oferta> (opcjonalny) <identyfikator> (wymagany) <usun> (wymagany w przypadku usuwania oferty) <nazwa> (wymagany w przypadku dodawania lub aktualizowania oferty) <url> (wymagany) <cena> (wymagany) <sciezka_kategorii> (wymagany) Identyfikator kategorii (wymagany) <marka_producent> (wymagany) Elementy opcjonalne <produkt> <opis> <SOP_id skad="bdk"> <kody_kreskowe> <kod> (podrzędny, wymagany co najmniej jeden) <zdjecie> <autorzy> <wykonawcy> <rezyserzy>

3 <aktorzy> <nosniki> <gatunek> <rok_wydania> <wydawnictwo> <ISBN> <rozmiar> <plec> <kolory> <darmowa_dostawa> <oferta_specjalna> <promocyjna_cena> (podrzędny dla <oferta_specjalna>) <znizka> (podrzędny dla <oferta_specjalna>) <kategoria_wiekowa> <przedzial_wiekowy> <prezenty_na> <prezent_dla> <dodatkowe> Przypisywanie (mapowanie) kategorii Mapowanie za pośrednictwem pliku xml z mapą kategorii Ręczne mapowanie karegorii Schemat Inne informacje Oprogramowanie do sprawdzania poprawności plików xml Przykładowy plik XML Dokument xmlschema definiujący postać pliku xml

4 Słownik: 1. Wzorzec Strukturalny Opis Produktu (SOP) - oferta wzorcowa zawierająca zdjęcie lub zdjęcia produktu, nazwę produktu, szczegółowe parametry w postaci atrybutów, opis i opinie o produkcie, do której poszczególne sklepy internetowe przypisują swoje oferty 2. Mapowanie kategorii to przypisywanie kategorii dostawcy (sklepu) do kategorii serwisu OnetZakupy zobacz pkt 1.4 Mapowanie kategorii i pkt i pkt 4. Przypisywanie (mapowanie) kategorii 3. Liść kategoria, która nie posiada żadnych podkategorii 4. <id_kategorii_pm> - identyfikator kategorii liścia serwisu OnetZakupy (w xml zastępczo nazwany identyfikatorem kategorii Platformy Marketplace) 4

5 1. Metody dostarczania danych i mapowanie kategorii Partner ma do dyspozycji 3 metody dostarczenia danych. 1.1 Pierwsza metoda dostarczania danych - metoda pasywna polega na wystawieniu na stronie www sklepu lub na serwer ftp sklepu pliku xml (w określonym przez Onet.pl formacie w dalszej części dokumentu) z danymi do importu. Następnie Partner definiuje w panelu sklepu w pasażu adres do zaciągania pliku przez nasz system i ma możliwości zdefiniowania cyklu w jakim Onet.pl będzie pobierał plik. Plik może być zzipowany, pod warunkiem zawierania tylko jednego pliku z wrzutem w archiwum. Archiwum nie może zawierać katalogów. Ma być to sam zzipowany plik. 1.2 Druga metoda dostarczania danych - metoda aktywna polega na wrzuceniu pliku xml (w określonym przez Onet.pl formacie w dalszej części dokumentu) (zzipowanego lub nie, ograniczenie jak wyżej.) poprzez panel administratora. Uwaga: w tej metodzie maksymalny rozmiar przesyłanego pliku to 25MB, dlatego sugerujemy zzipowanie pliku xml. 1.3 Trzecia metoda dostarczania danych - polega na dodawaniu pojedynczych ofert poprzez interfejs panelu administracyjnego sklepu. W tym przypadku nie jest wymagane mapowanie kategorii kategorie wybiera się z listy 1.4 Mapowanie kategorii Metody 1 i 2 wymagają od sklepu stworzenia mapy kategorii sklepu na kategorieserwisu OnetZakupy. Co to oznacza? Przykładowo sklep posiada oferty w kategorii (sklepowej) RTV,AGD > Telewizory > LCD > 29"; o identyfikatorze kategorii w sklepie=5, RTV,AGD > Telewizory > LCD > 32"; o identyfikatorze kategorii w sklepie=10 RTV,AGD > Telewizory > LCD > 42"; o identyfikatorze kategorii w sklepie=13 a w Serwisie Zakupowym jest kategoria-liść (kategoria, która nie ma żadnej podkategorii): ->Katalog->RTV->Telewizory->LCD; o identyfikatorze kategorii 2170 Aby było możliwe zaimportowanie ofert sklepu z jego kategorii należy wskazać do jakiej kategorii Serwisu Zakupowego powinny trafić oferty sklepu. W panelu administracyjnym sklepu wskazujemy że kategorie sklepowe o identyfikatorze 5, 10 i 13 są odpowiednikiem kategorii Serwisu Zakupowego o identyfikatorze Można również przesłać do nas plik xml zawierający mapowanie kategorii. Więcej patrz 4. Przypisywanie (mapowanie) kategorii Plik może być zzipowany, pod warunkiem zawierania tylko jednego pliku z wrzutem w archiwum. Archiwum nie może zawierać katalogów. Ma to być sam zzipowany plik. 5

6 2. Wymagania 2.1 Kodowanie Obowiązującym kodowaniem znaków we wrzutach jest utf-8. <?xml version="1.0" encoding="utf-8"?> 2.2 Znaki specjalne Niektóre znaki w formacie XML mają specjalne znaczenie, aby z nich skorzystać należy zapisać je za pomocą zamienników ujętych w tabelce poniżej. Znak < < Zamiennik > > & & " " ' &apos; Przykłady: <marka_producent>johnson & Johnson</marka_producent> - źle <marka_producent>johnson & Johnson</marka_producent> - dobrze 2.3 Kolejność elementów Kolejność elementów podana w szablonie xsd musi być zachowana (patrz 5. Schemat). Dodatkowo, dla ofert usuwanych nie należy podawać żadnych elementów opisu (patrz 3.1. Usuwanie ofert) 2.4 Przestrzeń nazw (namespace) Obowiązującą przestrzenią nazw dla wrzutów ofert jest: Należy ją zdefiniować jako atrybut elementu oferty w następujący sposób: <oferty aktualizacja="t" xmlns=" UWAGA: Przestrzeni nazw nie wolno pominąć. Wrzut nie posiadający zdefiniowanej przestrzeni nazw lub nieprawidłową przestrzeń nazw będzie w całości odrzucany jako błędny. 3. Rodzaje wrzutów Rozróżniamy dwa rodzaje wrzutów: Całościowy - oferta sklepu zostaje w całości skasowana i zastąpiona ofertami znajdującymi się we wrzucie. Jeśli we wrzucie całościowym nie zostanie podana żadna oferta oznacza to usuniecie wszystkich ofert sklepu z naszej bazy. Rozwiązanie to pozwala np. na wygodną wymianę całości oferty. Różnicowy (aktualizacyjny) - oferta sklepu zostaje zaktualizowana ofertami znajdującymi się we wrzucie: nowe oferty są dodawane, istniejące aktualizowane, oferty przeznaczone do usunięcia usuwane. Ten rodzaj wrzutu pozwala na ograniczenie ilości danych wysyłanych przez sklep wyłącznie do nowych rekordów (dodawanie nowych ofert), aktualizacji istniejących oraz usuwania nieaktualnych poprzez użycie elementu <usun>. 6

7 O rodzaju wrzutu decyduje atrybut "aktualizacja" elementu <oferty>. Jeśli wartość tego atrybutu będzie ustawiona na "N" uzyskamy wrzut całościowy, jeśli na "T" uzyskamy wrzut różnicowy Usuwanie ofert Ofertę usuwamy poprzez podanie w ofercie jej identyfikatora w sklepie oraz tagu <usun />: <oferta> <identyfikator> aaa ##@@</identyfikator> <usun /> </oferta> Wskazówka: Przy całościowym rodzaju wrzutu nie ma potrzeby używania elementu <usun>, gdyż wszelkie oferty nie znajdujące się we wrzucie zostaną usunięte automatycznie. Uwaga: Po podaniu elementu <usun>, nie wolno już podawać żadnych innych elementów takich jak nazwa, url, cena, białe znaki itd. Zalecamy używanie formy zapisu z przykładu (pusty tag). Wewnątrz elementu usuń nie może znaleźć się żadna zawartość (np. znak końca linii). Przykład nieprawidłowego użycia: <oferta id="938498"> <usun> </usun> </oferta> 3.2. Opis struktury wrzutu Wstęp Elementy wrzutu można podzielić na wymagane i opcjonalne. Elementy wymagane niezbędne dane, bez uzupełnienia których wrzut będzie odrzucony. UWAGA: Każdy element obowiązkowy (z wyjątkiem elementu <marka_producent>) musi zawierać jakąś wartość. Brak wartości w elemencie obowiązkowym będzie skutkował odrzuceniem rekordu jako błędnego. Elementy opcjonalne dane wymagane, które są jednak niezwykle ważne, ponieważ pozwolą Państwu na pełną prezentację oferty. Co zyskują Państwo wpisując możliwie najwięcej danych opcjonalnych? lepsze przypisanie Państwa ofert do SOPów (wzorców produktowych), co wiąże się dodatkowo z możliwością porównywania cen i parametrów technicznych produktów, szybsze dotarcie klienta do Państwa oferty, większą szansę wykorzystania ofert w miejscach redakcyjnych Galerii Handlowej, wykorzystanie w przyszłości w dodatkowych funkcjonalnościach Galerii Handlowej OnetZakupy, takich jak: strony eventowe, serwis prezentowy, newsletter oraz innych. Niewypełnienie informacji w elementach opcjonalnych spowoduje brak wyświetlenia oferty sklepu w serwisie prezentowym, na stronach eventowych czy też w newsletterach. Jeśli Dostawca nie posiada informacji którą opisuje element opcjonalny, wtedy nie należy umieszczać tego elementu w opisie pojedynczej oferty. Niektóre elementy posiadają elementy podrzędne. Nie należy umieszczać elementów podrzędnych samodzielnie, a jedynie wewnątrz elementu nadrzędnego. Hierarchię elementów można zobaczyć w punkcie 5. Schemat. 7

8 3.2.2 elementy wrzutu <oferty> (wymagany) Każdy wrzut musi zawierać element <oferty>. Element ten jest elementem zbiorczym, zawiera w sobie wszystkie oferty w danym wrzucie. Posiada również dwa atrybuty - rodzaj aktualizacji oraz definicję przestrzeni nazw: <oferty aktualizacja="t" xmlns=" aktualizacja (atrybut wymagany) Atrybut ten wskazuje na rodzaj wrzutu (patrz pkt. 3. Rodzaje wrzutów). Jeśli wartość tego atrybutu będzie ustawiona na "N" uzyskamy wrzut całościowy, jeśli na "T" uzyskamy wrzut różnicowy. Wskazówka: Aktualizacja całościowa pozwala na wygodną wymianę całości oferty. Istniejąca baza ofert dostawcy zostaje skasowana i zastąpiona ofertami znajdującymi się we wrzucie. Natomiast aktualizacja różnicowa pozwala na zmniejszenie ilości danych wysyłanych przez sklep wyłącznie do nowych rekordów (dodawanie nowych ofert), aktualizacji istniejących oraz usuwania nieaktualnych poprzez użycie elementu <usun>. Wartości dopuszczalne: tak, nie, TAK, NIE, T, N, Y, Tak, Nie, t, n przestrzeń nazw (atrybut wymagany) Przestrzeń nazw jest ustalona jak w pkt. 2.4 Przestrzeń nazw (namespace). Wrzuty bez przestrzeni nazw lub ze zmienioną przestrzenią nazw będą traktowane jako nieprawidłowe <oferta> (opcjonalny) Jest to element zawierający opis pojedynczej oferty, lub dyspozycję jej usunięcia. Jeśli wybierzemy usunięcie oferty, nie podajemy żadnych elementów poza identyfikatorem (patrz 3.1. Usuwanie ofert). UWAGA: Jeśli nie podamy żadnego elementu <oferta> przy całościowym rodzaju wrzutu, będzie to oznaczało skasowanie całej bazy ofert <identyfikator> (wymagany) Oferta musi zawierać unikatowy identyfikator jednoznacznie identyfikujący daną ofertę w bazie sklepu. Identyfikatorem będzie trzeba się posłużyć chcąc później zaktualizować lub usunąć ofertę. Identyfikator ten jest nadawany przez sklep. <oferta> <identyfikator>1abf345c2456aaaff9abc24a-444</identyfikator> <!-- tutaj dalsze elementy opisu oferty --> </oferta> <usun> (wymagany w przypadku usuwania oferty) Jeśli zamierzamy usunąć ofertę, należy podać w tym miejscu element <usun> (patrz 3.1. Usuwanie ofert). Po elemencie <usun> może wystąpić jedynie zamknięcie opisu oferty. <oferta> <identyfikator> aaa ##@@</identyfikator> <usun /> </oferta> UWAGA: Element ten występuje zamiennie z elementem <nazwa>. 8

9 <nazwa> (wymagany w przypadku dodawania lub aktualizowania oferty) Element ten zawiera nazwę oferty w Państwa sklepie. Minimalna długość nazwy to 1 znak. <nazwa>coolpix L15</nazwa> <url> (wymagany) Element <url> zawiera bezwzględny (pełna ścieżka łącznie z adres oferty w Państwa sklepie. Po kliknięciu w ofertę Klient zostanie przekierowany na ten adres. <url> <cena> (wymagany) Cena produktu w zł. Obowiązującym separatorem dziesiętnym jest kropka, dopuszczalne jest podanie jednego lub dwóch miejsc po przecinku. Proszę nie stosować separatorów tysięcy. UWAGA: Cena musi być większa od zera. Podanie ceny zerowej jest traktowane jako błąd. Przykłady: <!-- Dobrze: --> <cena>123.00</cena> <cena>123</cena> <cena>123.5</cena> <!-- Źle: --> <cena>1 023</cena> <cena>1,023.00</cena> <cena>123,5</cena> <cena>1 023</cena> <sciezka_kategorii> (wymagany) Element ten zawiera ścieżkę kategorii, w której znajduje się produkt w Państwa sklepie, np. RTV > Telewizory > Plazma > 42". Wpisanie pełnej ścieżki Państwa kategorii w tym polu umożliwia przypisywanie do kategorii serwisu OnetZakupy. Podanie wartości w tym elemencie powoduje że Państwa kategoria będzie się przedstawiać tą wartością podaną w interfejsie mapowania/przypisania kategorii, co znacznie uprości proces mapowania/przypisania. <sciezka_kategorii>rtv > Telewizory > Plazma > 42"</sciezka_kategorii> Identyfikator kategorii (wymagany) W tym miejscu podajemy kategorię w której znajduje się produkt. Sklep ma dwie możliwości: podać identyfikator kategorii w której oferta znajduje się w sklepie <id_kategorii_sklepu>. Będzie to wymagało przypisania temu identyfikatorowi odpowiadającej mu kategorii serwisu OnetZakupy w interfejsie administratora sklepu (patrz pkt 4. Przypisywanie (mapowanie) kategorii). Podać id kategorii-liść serwisu OnetZakupy, w której ma znaleźć się oferta - <id_kategorii_pm>. To rozwiązanie nie wymaga przypisania (mapowania). Wskazówka: Zachęcamy Państwa do przedstawiania się identyfikatorami kategorii naszego serwisu. Przyspieszy to proces wrzutu ofert poprzez uniknięcie procedury mapowania/przypisywania kategorii. Drzewo kategorii z identyfikatorami kategorii i liści, znajduje się w panelu administracyjnym sklepu. Uwaga: Elementów <id_kategorii_pm> i <id_kategorii_sklepu> nie należy stosować razem w opisie pojedynczej oferty, gdyż spowoduje to odrzucenie rekordu jako błędnego podczas walidacji. 9

10 <id_kategorii_sklepu> Tutaj podajemy identyfikator kategorii sklepu w której znajduje się oferta <id_kategorii_sklepu>2345aaa-333</id_kategorii_sklepu> lub: <id_kategorii_pm> Tutaj podajemy kategorię-liść serwisu OnetZakupy. <id_kategorii_pm>4962</id_kategorii_pm> UWAGA: Można przypisywać oferty wyłącznie do kategorii liści serwisu OnetZakupy. Identyfikator kategorii pm jest liczbą całkowitą większą od <marka_producent> (wymagany) Marka produktu. W przypadku braku możliwości podania marki, proszę podać producenta. Jeśli żadna z tych informacji nie może być uzupełniona należy wstawić ten element jako pusty. Oprócz elementu usuń jest to jedyny element który dopuszcza wstawienie pustej wartości. Przykłady: <marka_producent>vizir</marka_producent> lub: <marka_producent>henkel</marka_producent> lub, w przypadku braku wymaganych informacji: <marka_producent /> Elementy opcjonalne Elementy opcjonalne dane nieobowiązkowe, które są jednak niezwykle ważne, ponieważ pozwolą Państwu na pełną prezentację oferty. Co zyskują Państwo wpisując możliwie najwięcej danych opcjonalnych? lepsze przypisanie Państwa ofert do SOPów (wzorców produktowych), co wiąże się dodatkowo z możliwością porównywania cen i parametrów technicznych produktów, szybsze dotarcie klienta do Państwa oferty, większą szansę wykorzystania ofert w miejscach redakcyjnych Galerii Handlowej, wykorzystanie w przyszłości w dodatkowych funkcjonalnościach Galerii Handlowej OnetZakupy, takich jak: strony eventowe, serwis prezentowy, newsletter oraz innych. Niewypełnienie informacji w elementach opcjonalnych spowoduje brak wyświetlenia oferty sklepu w serwisie prezentowym, na stronach eventowych czy też w newsletterach. UWAGA: Jeśli element opcjonalny zawiera elementy podrzędne (dzieci), podanie elementu podrzędnego jest obowiązkowe w wypadku użycia elementu nadrzędnego (rodzica). Wskazówka: Jeśli Dostawca nie posiada informacji którą opisuje element opcjonalny, wtedy nie należy umieszczać tego elementu w opisie pojedynczej oferty. 10

11 <produkt> Rodzaj produktu (N - nowy, U - używany) <produkt>n</produkt> <opis> Opis produktu. Minimalna długość - 5 znaków. Opis należy umieścić w znacznikach CDATA: <opis><![cdata[ tu opis produktu w cdata który nie będzie parsowany jako xml ]]></opis> <SOP_id skad="bdk"> Identyfikator strukturalnego opisu produktu (SOPu wzorca produktowego). Podanie tego elementu oznacza, że oferta ma zostać przypisana do SOPu o podanym identyfikatorze. W atrybucie skąd należy obowiązkowo podać od jakiego dostawcy SOP pochodzi ten identyfikator. W tej chwili możliwe jest podanie identyfikatora f-my BDK. <SOP_id skad="bdk"> /55</sop_id> Identyfikatory BDK można znaleźć na stronie Będzie możliwośc podawania innych id <kody_kreskowe> Element zawierający wszystkie posiadane przez Państwa kody EAN opisujące daną ofertę. Występuje w parze z elementem podrzędnym <kod> <kod> (podrzędny, wymagany co najmniej jeden) Element podrzędny dla <kody_kreskowe>. Jeśli został użyty opcjonalny element <kody_kreskowe>, należy podać co najmniej jeden kod EAN za pomocą elementu <kod> <kody_kreskowe> <kod> </kod> <kod> </kod> </kody_kreskowe> <zdjecie> Element <zdjecie> zawiera bezwzględny (pełna ścieżka łącznie z adres URL do zdjęcia produktu. Akceptowane są wyłącznie formaty: gif, jpg. Należy umieszczać adresy do zdjęć produktów w maksymalnej dostępnej na stronie rozdzielczości (tzn. np. zdjęć które pokazują się klientowi Państwa sklepu po kliknięciu przycisku powiększ zdjęcie ) nie większej jednak niż 1280x1024 px.. Zapewni to prawidłową prezentację zdjęć produktu przez nasz system skalujący i umożliwi większą elastyczność w prezentacji produktu. Zdjęcia nie powinny mieć wagi większej niż 1MB. Prosimy nie dodawać miniaturek zdjęć. Zdjęcie zostanie automatycznie pobrane przez nasz system. Jeżeli nie uda się pobrać zdjęcia po 3 próbach (poprzedzonych 15-sekundowym odstępem czasowym), oferta zostaje uznana za niekompletną i odrzucona. UWAGA: Proszę nie podawać adresów do miniaturek! Podanie miniaturki może spowodować zniekształcenie zdjęcia w przypadku konieczności prezentacji powiększonego zdjęcia produktu. 11

12 <zdjecie> <autorzy> Element pozwalający podać autora lub autorów danej książki. Należy podać co najmniej jednego autora poprzez użycie elementu podrzędnego <autor>. <autorzy> <autor>adam Mickiewicz</autor> <autor>juliusz Słowacki</autor> </autorzy> lub: <autorzy> <autor>juliusz Słowacki</autor> </autorzy> <wykonawcy> Wykonawcy danego utworu/albumu (dla muzyki). Należy podać co najmniej jednego wykonawcę poprzez użycie elementu podrzędnego <wykonawca> <wykonawcy> <wykonawca>feel</wykonawca> </wykonawcy> <rezyserzy> Reżyser lub reżyserzy filmu. Należy podać maksymalnie dwóch reżyserów poprzez użycie elementu podrzędnego <rezyser>. <rezyserzy> <rezyser>steven Spielberg</rezyser> </rezyserzy> <aktorzy> Aktorzy grający w filmie. Należy podać co najmniej jednego aktora poprzez użycie elementu podrzędnego <aktor> <aktorzy> <aktor>cezary Pazura</aktor> <aktor>marek Kondrat</aktor> </aktorzy> <nosniki> Nośniki na których zapisany jest produkt. Należy podać maksymalnie dwa za pomocą elementu podrzędnego <nosnik>. Dopuszczalne wartości: DVD, CD, MD, MMC, VHS, VCD, UMD, inne. <nosniki> <nosnik>dvd</nosnik> </nosniki> 12

13 <gatunek> Gatunek literacki książki, gatunek muzyki itp. <gatunek>ambient</gatunek> lub: <gatunek>thriller</gatunek> <rok_wydania> Rok wydania książki <rok_wydania>98</rok_wydania> Dopuszczalny jest zarówno zapis: 98 jak i <wydawnictwo> Wydawnictwo nazwa instytucji wydającej książki, czasopisma i gazety <wydawnictwo>helion</wydawnictwo> <ISBN> ISBN - niepowtarzalny 13-cyfrowy identyfikator książki <ISBN> </ISBN> <rozmiar> Rozmiar odzieży i obuwia. Maksymalna długość wartości: 15 znaków. <rozmiar>xl</rozmiar> <rozmiar>38</rozmiar> <rozmiar>52</rozmiar> <rozmiar>80c</rozmiar> <rozmiar>42/176</rozmiar> <rozmiar>27,5</rozmiar> <rozmiar>116</rozmiar> <plec> Dopuszczalne wartości: K - kobieta, M - mężczyzna, U unisex. <plec>m</plec> <kolory> Należy podać co najmniej jeden kolor używając elementu podrzędnego <kolor> <kolory> <kolor>bahama yellow palony</kolor> <kolor>czerwony</kolor> </kolory> 13

14 <darmowa_dostawa> Darmowa dostawa oznacza, że klient zamawiający ten produkt otrzyma go nie ponosząc kosztów transportu. Możliwe wartości: tak, nie, TAK, NIE, T, N, Y, Tak, Nie, t, n <darmowa_dostawa>n</darmowa_dostawa> <oferta_specjalna> Określa czy produkt jest objęty promocją (atrybut "typ": P - promocja, W - wyprzedaż). W przypadku umieszczenia tego elementu musimy podać cenę promocyjną lub zniżkę w procentach. Jest elementem nadrzędnym dla elementów <promocyjna_cena> oraz <zniżka>. typ= P" lub W (atrybut wymagany) Określa typ oferty specjalnej (promocja lub wyprzedaż). W zależności od podanej wartości atrybutu typ podajemy cenę promocyjną lub zniżkę w procentach <promocyjna_cena> (podrzędny dla <oferta_specjalna>) Promocyjna cena. Obowiązują takie same zasady jak w przypadku elementu <cena> (wymagany) <znizka> (podrzędny dla <oferta_specjalna>) Zniżka w procentach. Nie należy podawać znaku %. Obowiązują takie same zasady jak w przypadku elementu <cena> (wymagany). <oferta_specjalna typ="p"> <promocyjna_cena>15.45</promocyjna_cena> </oferta_specjalna> lub: <oferta_specjalna typ="w"> <znizka>23.5</znizka> </oferta_specjalna> <kategoria_wiekowa> Kategoria wiekowa, do której jest skierowany produkt: dla dziecka, dla młodzieży, dla dorosłych. Dopuszczalne wartości: dzieci, mlodziez, dorosli. <kategoria_wiekowa>dzieci</kategoria_wiekowa> <przedzial_wiekowy> Przedział wiekowy, do którego skierowany jest produkt. Możliwość umieszczenia do dwóch wartości z listy za pomocą elementu podrzędnego <wiek>. Lista wartości: 0-3, 4-7, 8-10, 11-15, 16-20, 21-30, 31-50, powyzej 50, 18+ <przedzial_wiekowy> <wiek>0-3</wiek> <wiek>4-7</wiek> <przedzial_wiekowy> <prezenty_na> Produkt może być prezentem na jedną z poniższych okazji. Możliwość umieszczenia do trzech wartości z listy (poniżej) za pomocą elementu podrzędnego <prezent_na>. 14

15 urodziny imieniny chrzest narodziny dziecka komunia slub walentynki gwiazdka mikolaj nowe mieszkanie wieczor panienski wieczor kawalerski zgoda podziekowanie zarty osiemnastka <prezenty_na> <prezent_na>zarty</prezent_na> <prezent_na>osiemnastka</prezent_na> <prezent_na>wieczor kawalerski</prezent_na> </prezenty_na> Uwaga: wartości <prezenty_na> muszą być zapisane dokładnie tak samo jak na przykładzie powyżej <prezent_dla> Produkt może być prezentem dla (patrz lista osób poniżej). Możliwość umieszczenia do trzech wartości z listy (poniżej) za pomocą elementu podrzędnego <prezent_dla>. Lista wartości: niej niego pary dziecka nastolatka mamy taty babci dziadka pani(a) domu dzialkowicza majsterkowicza kolekcjonera gadzeciarza aktywnych domatorow <prezenty_dla> <prezent_dla>niej</prezent_dla> <prezent_dla>nastolatka</prezent_dla> </prezenty_dla> <dodatkowe> tutaj będą umieszczane nowe elementy o znaczeniu specjalnym, jak np. eksport oferty do toolboxa Tradedoublera. Element musi zawierać poprawnie sformatowany XML. O możliwości zamieszczania nowych znaczników będziemy informowali w miarę włączania nowych funkcjonalności. 15

16 4. Przypisywanie (mapowanie) kategorii Przypisywanie (mapowanie) kategorii. Mapowanie kategorii to przypisywanie kategorii sklepu do kategorii serwisu. Jeśli w pliku xml zawierającym wrzut ofert przedstawiacie się Państwo kategoriami sklepu (<id_kategorii_sklepu>), wówczas przeprowadzenie mapowania jest konieczne, aby oferty mogły wyświetlić się w serwisie OnetZakupy. Mapowania można dokonać na dwa sposoby. 4.1 Mapowanie za pośrednictwem pliku xml z mapą kategorii. Aby przygotować plik xml z mapą kategorii sklepu należy pobrać plik xml z kategoriami OnetZakupy (plik zawiera identyfikatory wszystkich kategorii-liści) oraz przykładowy plik xml pokazujący jak wykonać mapowanie. Na podstawie wzoru należy sporządzić odpowiedni plik xml, obejmujący wszystkie kategorie, w których Sklep zamierza umieszczać oferty. <kategoria> <!-- ścieżka kategorii w sklepie --> <sciezka_kategorii>agd > Do zabudowy > Ekspresy do kawy</sciezka_kategorii> <!-- Identyfikator kategorii sklepu --> <id_kategorii_sklepu>1</id_kategorii_sklepu> <!-- Identyfikator kategorii Platformy Marketplace --> <id_kategorii_pm>2786</id_kategorii_pm> </kategoria> Tak przygotowany plik należy załadować w panelu administracyjnym sklepu (zakładka Mapa kategorii). Po każdorazowym eksporcie ofert nastąpi ich automatyczne przypisanie do odpowiednich kategorii serwisu OnetZakupy, zgodnie z uprzednio wgraną mapą. 4.2 Ręczne mapowanie karegorii. Aby móc ręcznie zmapować (przypisać) kategorie, należy dokonać wrzutu ofert, w którym przedstawiacie się Państwo kategoriami sklepu. Wszystkie oferty z tego wrzutu zostaną odrzucone, natomiast wszystkie kategorie sklepu zawarte w tym wrzucie, zostaną zaciągnięte i pojawią się w zakładce Do zmapowania/ przypisania w panelu sklepu. Dzięki temu będzie możliwe ich ręczne przypisanie do kategorii serwisu OnetZakupy. Po dokonaniu przypisania należy ponownie dokonać eksportu ofert (czyli powtórnie wrzucić ten sam plik xml z ofertami). Oferty te zostaną automatycznie przypisane, zgodnie z dokonanym mapowaniem i pojawią się w serwisie OnetZakupy. Dokonane mapowanie będzie działało także przy kolejnych wrzutach. Uwaga: W przypadku pojawienia się nowych kategorii (dotąd nie zmapowanych) oferty w nich zamieszczone będą odrzucane. Każda nowa kategoria sklepu wymaga przypisania, a odrzucone oferty należy ponownie eksportować. 16

17 5. Schemat 17

18 6. Inne informacje 6.1. Oprogramowanie do sprawdzania poprawności plików xml Poprawność wygenerowanego z Państwa systemu pliku xml można zweryfikować samodzielnie za pomocą dowolnego narzędzia do edycji plików xml umożliwiającego sprawdzenie poprawności przy użyciu pliku schematu (xmlschema). Jednym z darmowych programów umożliwiających walidację jest Liquid XML Studio 2008, które można pobrać ze strony firmy Liquid Technologies Przykładowy plik XML <?xml version="1.0" encoding="utf-8"?> <!-- Created with Liquid XML Studio ( --> <oferty aktualizacja="t" xmlns=" <oferta> <!-- Unikalny identyfikator produktu w sklepie --> <identyfikator>1abf345c2456aaaff9abc24a-444</identyfikator> <!-- nazwa produktu --> <nazwa>produkt 123</nazwa> <!-- Adres produktu w sklepie --> <url> <!-- Cena produktu --> <cena>123.00</cena> <!-- ścieżka kategorii w sklepie --> <sciezka_kategorii>rtv > Telewizory > Plazma > 42"</sciezka_kategorii> <!-- Identyfikator kategorii sklepu w której znajduje się produkt --> <id_kategorii_sklepu>2345aaa-333</id_kategorii_sklepu> <!-- Marka produktu lub producent--> <marka_producent>venom Inc.</marka_producent> <!-- Nowy (N)/Używany (U) --> <produkt>n</produkt> <!-- opis produktu --> <opis><![cdata[ tu opis produktu w cdata który nie będzie parsowany jako xml ]]></opis> <!-- identyfikator SOPu - pozwala przypisać produkt do SOPu --> <SOP_id skad="bdk"> /55</sop_id> <!-- kody kreskowe (EAN) produktu --> <kody_kreskowe> <kod> </kod> <kod> </kod> </kody_kreskowe> <zdjecie> <!-- autorzy lub autor --> <autorzy> <autor>adam Mickiewicz</autor> <autor>juliusz Słowacki</autor> </autorzy> <!-- wykonawcy lub wykonawca --> <wykonawcy> <wykonawca>britney Spears</wykonawca> </wykonawcy> <!-- reżyserzy lub reżyser --> <rezyserzy> <rezyser>steven Spielberg</rezyser> </rezyserzy> 18

19 <!-- aktorzy lub aktor --> <aktorzy> <aktor>john Wayne</aktor> <aktor>marek Kondrat</aktor> </aktorzy> <!-- nośniki lub nośnik --> <nosniki> <nosnik>dvd</nosnik> </nosniki> <!-- gatunek --> <gatunek> </gatunek> <!-- rok wydania --> <rok_wydania>98</rok_wydania> <!-- wydawnictwo --> <wydawnictwo>bullseye Lib.</wydawnictwo> <!-- ISBN --> <ISBN> </ISBN> <!-- rozmiar (do 15 znaków) --> <rozmiar>xl</rozmiar> <plec>m</plec> <!-- dostępne kolory lub kolor produktu --> <kolory> <kolor>bahama yellow palony</kolor> <kolor>czerwony</kolor> </kolory> <darmowa_dostawa>n</darmowa_dostawa> <oferta_specjalna typ="p"> <promocyjna_cena>1</promocyjna_cena> </oferta_specjalna> <przedzial_wiekowy> <wiek>0-3</wiek> <wiek>4-7</wiek> </przedzial_wiekowy> <prezenty_na> <prezent_na>zarty</prezent_na> <prezent_na>osiemnastka</prezent_na> <prezent_na>wieczor kawalerski</prezent_na> </prezenty_na> <prezenty_dla> <prezent_dla>niej</prezent_dla> </prezenty_dla> </oferta> <oferta> <usun /> </oferta> </oferty> 6.3. Dokument xmlschema definiujący postać pliku xml <?xml version="1.0" encoding="utf-8"?> <!-- Created with Liquid XML Studio ( --> <xs:schema xmlns:tns=" attributeformdefault="unqualified" blockdefault="" finaldefault="" elementformdefault="qualified" targetnamespace=" version=" " xmlns:xs=" <xs:element name="oferty"> 19

20 <xs:documentation>element zawierający zero lub więcej ofert, posiada rodzaj aktualizacji jako atrybut</xs:documentation> <xs:complextype> <xs:sequence> <xs:documentation>0 lub więcej ofert</xs:documentation> <xs:element minoccurs="0" maxoccurs="unbounded" name="oferta"> <xs:documentation>[element opcjonalny] Opisuje pojedynczą ofertę</xs:documentation> <xs:complextype> <xs:sequence> <xs:element name="identyfikator"> <xs:documentation>[element wymagany] Unikalny identyfikator produktu w Państwa sklepie.</xs:documentation> <xs:minlength value="1" /> <xs:choice> <xs:documentation>należy wybrać czy usuwamy ofertę (poprzez dodanie elementu usuń) czy też dodajemy / aktualizujemy ofertę (zachowanie domyślne kiedy brak elementu usuń).</xs:documentation> <xs:element block="" name="usun"> <xs:documentation>podanie tego elementu oznacza usunięcie oferty o podanym identyfikatorze. Jeśli element został podany, w tej ofercie nie można już podać żadnych innych elementów.</xs:documentation> <xs:restriction base="xs:token"> <xs:enumeration value="" /> <xs:sequence> <xs:documentation>elementy opisujące ofertę. Należy zachować kolejność elementów.</xs:documentation> <xs:element name="nazwa"> <xs:documentation>[element wymagany]: Nazwa produktu w sklepie. Minimalna długość nazwy - 1 znak</xs:documentation> <xs:minlength value="1" /> <xs:element name="url"> 20

21 <xs:documentation>[element wymagany] Adres produktu w sklepie. Po kliknięciu produktu Klient zostanie przekierowany na ten adres.</xs:documentation> <xs:restriction base="xs:anyuri"> <xs:pattern value="(http https ftp)://(.*(:.*)?@)?\s+\.\s+.*/.*" /> <xs:minlength value="10" /> <xs:element name="cena"> <xs:documentation>[element wymagany] Cena produktu. Obowiązującym separatorem dziesiętnym jest kropka. Proszę nie stosować separatorów tysięcy.</xs:documentation> <xs:restriction base="xs:float"> <xs:minexclusive value="0" /> <xs:pattern value="\d*(\.\d\d?)?" /> <xs:element name="sciezka_kategorii"> <xs:documentation>[element wymagany] Ścieżka kategorii w której znajduje się produkt w Państwa sklepie, np. RTV &gt; Telewizory &gt; Plazma &gt; 42". Dodanie wartości w tym polu powoduje że Państwa kategoria będzie się przedstawiać wartością podaną tutaj w interfejsie mapowania kategorii.</xs:documentation> <xs:minlength value="1" /> <xs:choice minoccurs="1"> <xs:documentation>[element wymagany] Należy wybrać jeden z elementów: kategoria_pm lub kategoria_sklepu</xs:documentation> <xs:element name="id_kategorii_pm"> <xs:documentation>identyfikator kategorii Platformy Marketplace w której ma znaleźć się produkt. Produkty można umieszczać tylko w kategoriach-liściach, tzn. takich które nie mają już żadnych podkategorii.</xs:documentation> <xs:restriction base="xs:integer"> <xs:minexclusive value="1" /> <xs:element name="id_kategorii_sklepu"> <xs:documentation>identyfikator kategorii w której znajduje się produkt w Państwa sklepie.</xs:documentation> 21

22 <xs:minlength value="1" /> </xs:choice> <xs:element name="marka_producent" type="xs:string"> <xs:documentation>[element wymagany] Marka produktu. W przypadku braku możliwości podania marki, proszę podać producenta. Jeśli żadna z tych informacji nie może być uzupełniona należy wstawić ten element jako pusty.</xs:documentation> <xs:element minoccurs="0" name="produkt"> <xs:documentation>[element opcjonalny] Rodzaj produktu (N - nowy, U - używany)</xs:documentation> <xs:enumeration value="n" /> <xs:enumeration value="u" /> <xs:element minoccurs="0" name="opis"> <xs:documentation>[element opcjonalny] Opis produktu. Minimalna długość - 5 znaków.</xs:documentation> <xs:minlength value="5" /> <xs:element minoccurs="0" name="sop_id"> <xs:documentation>[element opcjonalny] Zewnętrzny identyfikator SOPu, wymagane podanie atrybutu skad, identyfikującego dostawcę. </xs:documentation> <xs:complextype> <xs:simplecontent> <xs:extension base="xs:string"> <xs:attribute name="skad" use="required"> <xs:documentation>[atrybut wymagany] dostawca od którego pochodzi identyfikator. Możliwe wartości: BDK - identyfikator z bazy firmy BDK (cokupic.pl).</xs:documentation> <xs:restriction base="xs:nmtoken"> <xs:enumeration value="bdk" /> <xs:enumeration value="bdk" /> </xs:attribute> </xs:extension> </xs:simplecontent> </xs:complextype> <xs:element minoccurs="0" name="kody_kreskowe"> 22

23 <xs:documentation>[element opcjonalny] Kody EAN produktu. Podanie EAN zapewnia bezbłędne przypisanie produktu do SOPu (pod warunkiem że SOP opisujący Państwa produkt znajduje się w naszej bazie). Proszę podać wszystkie posiadane kody kreskowe dotyczące tego produktu. </xs:documentation> <xs:complextype> <xs:sequence> <xs:documentation>zawiera 1..n kodów kreskowych opisujących produkt.</xs:documentation> <xs:element maxoccurs="unbounded" name="kod"> <xs:documentation>kod kreskowy produktu (EAN)</xs:documentation> <xs:minlength value="1" /> </xs:sequence> </xs:complextype> <xs:element minoccurs="0" name="zdjecie"> <xs:documentation>[element opcjonalny] Adres URL do zdjęcia produktu. Akceptowane formaty: gif, jpg.</xs:documentation> <xs:restriction base="xs:anyuri"> <xs:pattern value="(http https ftp)://(.*(:.*)?@)?\s+\.\s+.*/.*" /> <xs:minlength value="10" /> <xs:element minoccurs="0" name="autorzy"> <xs:documentation>[element opcjonalny] Autorzy (dla książek). Należy podać co najmniej jednego autora.</xs:documentation> <xs:complextype> <xs:sequence> <xs:element maxoccurs="unbounded" name="autor"> <xs:documentation>[element opcjonalny] Autor (dla książek)</xs:documentation> <xs:minlength value="1" /> </xs:sequence> </xs:complextype> <xs:element minoccurs="0" name="wykonawcy"> 23

24 <xs:documentation>[element opcjonalny] Wykonawcy danego utworu (dla muzyki). Należy podać co najmniej jednego wykonawcę.</xs:documentation> <xs:complextype> <xs:sequence> <xs:element maxoccurs="unbounded" name="wykonawca"> <xs:documentation>[element opcjonalny] Wykonawca (dla muzyki)</xs:documentation> <xs:minlength value="1" /> </xs:sequence> </xs:complextype> <xs:element minoccurs="0" name="rezyserzy"> <xs:documentation>[element opcjonalny] Reżyser (dla filmów). Należy podać maksymalnie dwóch reżyserów.</xs:documentation> <xs:complextype> <xs:sequence> <xs:element minoccurs="1" maxoccurs="2" name="rezyser"> <xs:documentation>[element opcjonalny] Reżyser (dla filmów)</xs:documentation> <xs:minlength value="1" /> </xs:sequence> </xs:complextype> <xs:element minoccurs="0" name="aktorzy"> <xs:documentation>[element opcjonalny] aktorzy grający w filmie. Należy podać co najmniej jednego aktora.</xs:documentation> <xs:complextype> <xs:sequence> <xs:element maxoccurs="unbounded" name="aktor"> <xs:documentation>[element opcjonalny] aktor (dla filmów)</xs:documentation> <xs:minlength value="1" /> </xs:sequence> </xs:complextype> 24

25 <xs:element minoccurs="0" name="nosniki"> <xs:documentation>[element opcjonalny] Rodzaj nośnika (można podać maksymalnie dwa).</xs:documentation> <xs:complextype> <xs:sequence> <xs:element minoccurs="1" maxoccurs="2" name="nosnik"> <xs:documentation>[element opcjonalny] Rodzaj nośnika. Możliwe wartości: DVD, CD, MD, MMC, VHS, VCD, UMD, inne</xs:documentation> <xs:restriction base="xs:nmtoken"> <xs:enumeration value="dvd" /> <xs:enumeration value="cd" /> <xs:enumeration value="md" /> <xs:enumeration value="mmc" /> <xs:enumeration value="vhs" /> <xs:enumeration value="vcd" /> <xs:enumeration value="umd" /> <xs:enumeration value="inne" /> </xs:sequence> </xs:complextype> <xs:element minoccurs="0" name="gatunek"> <xs:documentation>[element opcjonalny] Gatunek</xs:documentation> <xs:minlength value="1" /> <xs:element minoccurs="0" name="rok_wydania"> <xs:documentation>[element opcjonalny] Rok wydania</xs:documentation> <xs:pattern value="\d\d(\d\d)?" /> <xs:element minoccurs="0" name="wydawnictwo"> <xs:documentation>[element opcjonalny] Wydawnictwo</xs:documentation> <xs:minlength value="1" /> <xs:element minoccurs="0" name="isbn"> 25

26 <xs:documentation>[element opcjonalny] ISBN</xs:documentation> <xs:minlength value="1" /> <xs:element minoccurs="0" name="rozmiar"> <xs:documentation>[element opcjonalny] Rozmiar. Maksymalna długość wartości: 15 znaków.</xs:documentation> <xs:maxlength value="15" /> <xs:minlength value="1" /> <xs:element minoccurs="0" name="plec"> <xs:documentation>[element opcjonalny] (K, M, U - unisex)</xs:documentation> <xs:restriction base="xs:nmtoken"> <xs:enumeration value="k" /> <xs:enumeration value="m" /> <xs:enumeration value="u" /> <xs:element minoccurs="0" name="kolory"> <xs:documentation>[element opcjonalny] Kolory produktu. Należy podać co najmniej jeden kolor.</xs:documentation> <xs:complextype> <xs:sequence> <xs:element maxoccurs="unbounded" name="kolor"> <xs:documentation>[element opcjonalny] Kolor produktu</xs:documentation> <xs:minlength value="1" /> </xs:sequence> </xs:complextype> <xs:element minoccurs="0" name="darmowa_dostawa"> <xs:documentation>[element opcjonalny] Możliwe wartości:tak, nie, TAK, NIE, T, N, Y, Tak, Nie, t, n</xs:documentation> <xs:restriction base="xs:token"> 26

27 <xs:enumeration value="tak" /> <xs:enumeration value="nie" /> <xs:enumeration value="tak" /> <xs:enumeration value="nie" /> <xs:enumeration value="t" /> <xs:enumeration value="n" /> <xs:enumeration value="y" /> <xs:enumeration value="tak" /> <xs:enumeration value="nie" /> <xs:enumeration value="t" /> <xs:enumeration value="n" /> <xs:element minoccurs="0" name="oferta_specjalna"> <xs:documentation>[element opcjonalny] Określa czy produkt jest objęty promocją (atrybut "typ": P - promocja, W - wyprzedaż). W przypadku umieszczenia tego elementu musimy podać cenę promocyjną lub zniżkę w procentach</xs:documentation> <xs:complextype> <xs:choice> <xs:documentation>w przypadku oferty specjalnej mamy możliwość wyboru ceny promocyjnej lub zniżki.</xs:documentation> <xs:element name="promocyjna_cena"> <xs:documentation>promocyjna cena (powinna być niższa od normalnej ceny produktu podanej powyżej).</xs:documentation> <xs:restriction base="xs:float"> <xs:minexclusive value="0" /> <xs:pattern value="\d*(\.\d\d?)?" /> <xs:element name="znizka"> <xs:documentation>zniżka w %</xs:documentation> <xs:restriction base="xs:float"> <xs:pattern value="\d*(\.\d\d?)?" /> <xs:minexclusive value="0" /> </xs:choice> <xs:attribute name="typ" use="required"> <xs:documentation>[atrybut wymagany] Rodzaj oferty specjalnej: P-promocja, W-wyprzedaż</xs:documentation> <xs:restriction base="xs:nmtoken"> <xs:enumeration value="p" /> <xs:enumeration value="w" /> </xs:attribute> 27

28 </xs:complextype> <xs:element minoccurs="0" name="kategoria_wiekowa"> <xs:documentation>[element opcjonalny] kategoria wiekowa (dla dziecka, dla młodzieży, dla dorosłych)</xs:documentation> <xs:restriction base="xs:nmtoken"> <xs:enumeration value="dzieci" /> <xs:enumeration value="mlodziez" /> <xs:enumeration value="dorosli" /> <xs:element minoccurs="0" name="przedzial_wiekowy"> <xs:documentation>[element opcjonalny] Przedział wiekowy do którego skierowany jest produkt. Możliwość umieszczenia do dwóch wartości z listy.</xs:documentation> <xs:complextype> <xs:choice> <xs:documentation>[element opcjonalny] Przedział wiekowy, możliwość wyboru dwóch elementów.</xs:documentation> <xs:element minoccurs="1" maxoccurs="2" name="wiek"> <xs:documentation>[element wymagany] Przedział wiekowy do którego skierowany jest produkt. Lista wartości: 0-3, 4-7, 8-10, 11-15, 16-20, 21-30, 31-50, powyżej 50, 18+</xs:documentation> <xs:restriction base="xs:token"> <xs:enumeration value="0-3" /> <xs:enumeration value="4-7" /> <xs:enumeration value="8-10" /> <xs:enumeration value="11-15" /> <xs:enumeration value="16-20" /> <xs:enumeration value="21-30" /> <xs:enumeration value="31-50" /> <xs:enumeration value="powyzej 50" /> <xs:enumeration value="18+" /> </xs:choice> </xs:complextype> <xs:element minoccurs="0" name="prezenty_na"> <xs:documentation>[element opcjonalny] Produkt może być prezentem na... Możliwość umieszczenia do trzech wartości z listy.</xs:documentation> <xs:complextype> <xs:choice> <xs:documentation>[element opcjonalny] Prezent z okazji... Możliwość wyboru 3 elementów.</xs:documentation> <xs:element minoccurs="1" maxoccurs="3" name="prezent_na"> 28

29 <xs:documentation>[element wymagany] Prezent na okazję z listy:urodziny imieniny, chrzest narodziny dziecka, komunia, slub, walentynki, gwiazdka mikolaj, nowe mieszkanie, wieczor panienski, wieczor kawalerski, zgoda, podziekowanie, zarty, osiemnastka</xs:documentation> <xs:restriction base="xs:token"> <xs:enumeration value="urodziny imieniny " /> <xs:enumeration value="chrzest narodziny dziecka " /> <xs:enumeration value="komunia " /> <xs:enumeration value="slub " /> <xs:enumeration value="walentynki " /> <xs:enumeration value="gwiazdka mikolaj " /> <xs:enumeration value="nowe mieszkanie " /> <xs:enumeration value="wieczor panienski " /> <xs:enumeration value="wieczor kawalerski " /> <xs:enumeration value="zgoda " /> <xs:enumeration value="podziekowanie " /> <xs:enumeration value="zarty " /> <xs:enumeration value="osiemnastka" /> </xs:choice> </xs:complextype> <xs:element minoccurs="0" name="prezenty_dla"> <xs:documentation>[element opcjonalny] Prezent dla... Możliwość umieszczenia do trzech wartości z listy.</xs:documentation> <xs:complextype> <xs:choice> <xs:documentation>[element opcjonalny] Prezent dla... Możliwość wyboru trzech elementów.</xs:documentation> <xs:element minoccurs="1" maxoccurs="3" name="prezent_dla"> <xs:documentation>[element wymagany] Prezent (z listy) dla: niej, niego, pary, dziecka, nastolatka, mamy, taty, babci, dziadka, pani(a) domu, dzialkowicza, majsterkowicza, kolekcjonera, gadzeciarza, aktywnych, domatorow</xs:documentation> <xs:restriction base="xs:token"> <xs:enumeration value="niej" /> <xs:enumeration value="niego" /> <xs:enumeration value="pary" /> <xs:enumeration value="dziecka" /> <xs:enumeration value="nastolatka" /> <xs:enumeration value="mamy" /> <xs:enumeration value="taty" /> <xs:enumeration value="babci" /> <xs:enumeration value="dziadka" /> <xs:enumeration value="pani(a) domu" /> <xs:enumeration value="dzialkowicza" /> <xs:enumeration value="majsterkowicza" /> <xs:enumeration value="kolekcjonera" /> <xs:enumeration value="gadzeciarza" /> 29

30 <xs:enumeration value="aktywnych" /> <xs:enumeration value="domatorow" /> </xs:choice> </xs:complextype> <xs:element minoccurs="0" name="dodatkowe"> <xs:documentation>[element opcjonalny] Inne informacje.</xs:documentation> <xs:complextype> <xs:sequence> <xs:any processcontents="skip" /> </xs:sequence> </xs:complextype> </xs:sequence> </xs:choice> </xs:sequence> </xs:complextype> </xs:sequence> <xs:attribute name="aktualizacja" use="required"> <xs:documentation>[atrybut wymagany] Atrybut ten wskazuje czy plik zawiera tylko oferty do zaktualizowania (wartość "tak"), czy też całą ofertę sklepu (wartość "nie").</xs:documentation> <xs:restriction base="xs:token"> <xs:enumeration value="tak" /> <xs:enumeration value="nie" /> <xs:enumeration value="tak" /> <xs:enumeration value="nie" /> <xs:enumeration value="t" /> <xs:enumeration value="n" /> <xs:enumeration value="y" /> <xs:enumeration value="tak" /> <xs:enumeration value="nie" /> <xs:enumeration value="t" /> <xs:enumeration value="n" /> </xs:attribute> </xs:complextype> </xs:schema> 30