Dokumentacja techniczna integracji sklepów internetowych z serwisem Bielizna.interia.pl W celu przesłania produktów do katalogu w serwisie Bielizna.interia.pl należy wystawić plik XML z danymi pod adresem dostępnym z zewnątrz np: http://www.sklepzbielizna.pl/bieliznainteriapl/dane_rrrrmmdd.xml Nazwa pliku powinna zawierać datę - jezeli plik zostanie wygenerowany po 2 w nocy danego dnia to data w nazwie powinna dotyczyć dnia następnego. Import jest przeprowadzany o 2 w nocy - kiedy ruch jest stosunkowo nieduzy. Mechanizm sprawdza datą w nazwie pliku. Jezeli XML jest generowany np. 23.09.2009 o godzinie 11:00 plik powinien mieć nazwę http://www.sklepzbielizna.pl/bieliznainteriapl/dane_20090924.xml xml zostanie pobrany o 2:00 24.09.2009. Baza produktów może zostac zmodyfikowana na dwa sposoby (określane w XML parametrem upload_type ): 1 dotychczasowa baza produktów zostaje usunięta, produkty z usuniętego pliku zostają zastąpione przez produkty z nowego pliku 2 dotychczasowa baza nie zostaje usunięta, produkt znajdujące się nowym pliku zostaną dodane do bazy (w przypadku jeżeli id produktów z nowego pliku będą się pokrywać z id produktów znajdujących się już w bazie, informacje o wcześniej wyeksportowanych produktach zostaną nadpisane). Dodatkową funkcją jest parametr prod_active. Produkt o statusie N jest nieaktywny tzn. znajduje się w bazie ale nie jest widoczny. Może być stosowany np. gdy produkt jest czasowo wycofany ze sprzedaży. Eksport poroduktu ze statusem T spowoduje ponowne włączenie produktu. Jeżeli daty generacji plików będą identyczne nie nastąpi modyfikacja bazy. Poniżej przedstawiam strukturę XML wraz z komentarzami oraz przykładowy plik. 1. Struktura XML z komentarzami <?xml version="1.0" encoding="iso-8859-2"?> <xs:schema xmlns:xs="http://www.w3.org/2001/xmlschema"> <xs:element name="productset">
<xs:complextype> <xs:sequence> unikalne z punktu widzenia Interii id sklepu, będzie przypisane i podane każdemu z dostawców: 1 - sklep1.pl 2 - sklep2.pl 3 - sklep3.pl 4 - sklep4.pl 5 - sklep5.pl 6 - sklep6.pl <xs:element name="shop_id" type="xs:integer"/> sposób dodania danych do bazy: 1 - usunięcie (ustawienie aktywnosci na N) wszystkich danych produktów sklepu, oraz dodanie nowych z pliku 2 - dodanie nowych, ew. nadpisanie danych isteniejących produktów <xs:element name="upload_type"> <xs:simpletype> <xs:restriction base="xs:integer"> <xs:enumeration value="1"/> <xs:enumeration value="2"/> </xs:restriction> </xs:simpletype> data tworzenia pliku xml <xs:element name="creatation_date" type="xs:date"/> czas utworzenia pliku xml <xs:element name="creatation_time" type="xs:time"/> lista produktów <xs:element name="product" maxoccurs="unbounded"> <xs:complextype> <xs:sequence> id produktu, unikalne z puntu widzenia sklepu <xs:element name="prod_id" type="xs:integer"/> nazwa produktu <xs:element name="prod_name" type="xs:string"/> aktywnosc produktu, kasowanie poszczegolnych produktow realizuje sie poprzez
ustawienie im parametru 'aktywnosc' na N <xs:element name="prod_active"> <xs:simpletype> <xs:restriction base="xs:string"> <xs:enumeration value="t"/> <xs:enumeration value="n"/> </xs:restriction> </xs:simpletype> kategoria produktu, jedna z następujących: 3 - Damskie piekne nogi 4 - Damskie biustonosze 5 - Damskie stringi 6 - Damskie figi 7 - Damskie gorsety/body 8 - Damska bielizna nocna 9 - Damskie koszulki 18 - Damskie komplety 20 - Damskie stroje kąpielowe 10 - Męskie kąpielówki 11 - Męskie Piżamy 12 - Męskie slipy 37 - Męskie stringi 93 - Męskie bokserki 96 - Męskie koszulki <xs:element name="prod_category"> <xs:simpletype> <xs:restriction base="xs:integer"> <xs:enumeration value="3"/> <xs:enumeration value="4"/> <xs:enumeration value="5"/> <xs:enumeration value="6"/> <xs:enumeration value="7"/> <xs:enumeration value="8"/> <xs:enumeration value="9"/> <xs:enumeration value="10"/> <xs:enumeration value="11"/> <xs:enumeration value="12"/> <xs:enumeration value="18"/> <xs:enumeration value="20"/> <xs:enumeration value="37"/> <xs:enumeration value="93"/> <xs:enumeration value="96"/> </xs:restriction> </xs:simpletype>
regularna cena produktu <xs:element name="prod_price" type="xs:decimal"/> promocyjna cena produktu, ustawic 0 w przypadku gdy brak ceny promocyjnej <xs:element name="prod_promo_price" type="xs:decimal"/> opis produktu <xs:element name="prod_description" type="xs:string"/> producent produktu <xs:element name="prod_manufacturer" type="xs:string"/> url do produktu na stronie w sklepie <xs:element name="prod_url" type="xs:string"/> url do zdjecia produktu produktu (optymalny rozmiar: 200x300 px, nie mniejszy!) pliki o tej samej nazwie (i sciezce) traktowane sa jako juz isteniejace i nie beda pobierane ponownie, aby podmienic zdjecia isteniejacych produktow nalezy przeslac je pod innymi nazwami (np, umiescic w innym katalogu) <xs:element name="prod_photo_url" type="xs:string"/> cecha binarna, najlepiej opisująca produkt (dotyczy tylko biustonoszy, kategoria 4, w pozostalych prosze wstawiac null): 1 - ciąża/karmienie 2 - odpinane ramiączka 3 - bez fiszbinów 4 - miękkie 5 - usztywniane 6 - balconette 7 - na duży biust 8 - push-up null - nie dotyczy <xs:element name="prod_binary_attribute" type="xs:string"/> cecha1 produktu, w przypadku bielizny: romiar <xs:element name="prod_attribute1" type="xs:string"/> </xs:sequence> </xs:complextype> </xs:sequence> </xs:complextype> </xs:schema>
2. Przykładowy XML <?xml version="1.0" encoding="iso-8859-2"?> <productset xmlns:xsi="http://www.w3.org/2001/xmlschema-instance" xsi:nonamespaceschemalocation="schemat-pliku-listy-produktow.xsd"> <shop_id>6</shop_id> <upload_type>2</upload_type> <creation_date>2006-08-14</creation_date> <creation_time>13:06:33</creation_time> <prod_id>1150</prod_id> <prod_name><![cdata[biustonosz Szeherezada]]></prod_name> <prod_active>t</prod_active> <prod_category>4</prod_category> <prod_price>89,99</prod_price> <prod_promo_price>0</prod_promo_price> <prod_description><![cdata[frywolna i zwiewna koszulka zmysłowo otula ciało delikatną tkaniną. Dekolt eksponują i podkreślają eleganckie gipiurowe hafty. U dołu koszulka uwieńczona została niewielką falbanką. Ramiączka regulowane.]]></prod_description> <prod_manufacturer>dalia</prod_manufacturer> e=1150]]></prod_url> <prod_photo_url><![cdata[http://www.sklepzbielizna.pl/images/produkty/1150/hp6rmjnztbxf7ah 3th0s.jpg]]></prod_photo_url> <prod_binary_attribute>2</prod_binary_attribute> <prod_attribute1><![cdata[75c-95e]]></prod_attribute1> <prod_id>1084</prod_id> <prod_name><![cdata[biustonosz Testowy Tulipan]]></prod_name> <prod_active>t</prod_active> <prod_category>4</prod_category> <prod_price>89,99</prod_price> <prod_promo_price>0</prod_promo_price> <prod_description><![cdata[niezwykły biustonosz push-up z wyjmowanymi poduszeczkami doskonale podkreśla piękny kształt biustu i eksponuje dekolt. Miseczki otula delikatny kwiatowy haft; ramiączka odpinane. Do kompletu można dokupić pasujący model stringów elegancko wykończony haftem]]></prod_description>
<prod_manufacturer>dalia</prod_manufacturer> e=1084]]></prod_url> <prod_photo_url><![cdata[http://www.sklepzbielizna.pl/images/produkty/1084/sy8j3yh3hhz0n7 u73nqr.jpg]]></prod_photo_url> <prod_binary_attribute>2</prod_binary_attribute> <prod_attribute1><![cdata[75c-95e]]></prod_attribute1> <prod_id>664</prod_id> <prod_name><![cdata[biustonosz testowy3 Elida]]></prod_name> <prod_active>t</prod_active> <prod_category>4</prod_category> <prod_price>89,99</prod_price> <prod_promo_price>69,99</prod_promo_price> <prod_description><![cdata[bardzo zmysłowy i delikatny model biustonosza w kolorze upojnej czerni. Otulone tiulem miseczki o doskonałej konstrukcji z wyjmowanymi wkładkami push-up ponętnie podkreślają kształt piersi, zapewniając jednocześnie nadzwyczajny komfort noszenia. Biustonosz rewelacyjnie prezentuje się w duecie z filigranowymi stringami Elodi.]]></prod_description> <prod_manufacturer>dalia</prod_manufacturer> e=644]]></prod_url> <prod_photo_url><![cdata[http://www.sklepzbielizna.pl/images/produkty/644/7m38rwmv74y6ja cce0rk.jpg]]></prod_photo_url> <prod_binary_attribute>2</prod_binary_attribute> <prod_attribute1><![cdata[75c-95e]]></prod_attribute1> <prod_id>418</prod_id> <prod_name><![cdata[komplet Paradise]]></prod_name> <prod_active>n</prod_active> <prod_category>18</prod_category> <prod_price>91,99</prod_price> <prod_promo_price>79,99</prod_promo_price> <prod_description><![cdata[wyjątkowy komplet w kolorze błękitnego nieba zaskakuje zmysłowym i seksownym krojem, a także delikatnością półprzezroczystej siateczki "devore". Rozcięcie z przodu koszulki i ozdoby w postaci kokardek dodają całości romantyzmu. W komplecie występują pasujące szorty. Tył koszulki wykonano z gładkiej błękitnej siateczki (inaczej niz na zdjęciu).]]></prod_description> <prod_manufacturer>jordee</prod_manufacturer> e=814]]></prod_url>
<prod_photo_url><![cdata[http://www.sklepzbielizna.pl/images/produkty/6124/7sdf20rk.jpg]]>< /prod_photo_url> <prod_binary_attribute>null</prod_binary_attribute> <prod_attribute1><![cdata[s, M, L]]></prod_attribute1> </productset>