Zapoznaj się ze specyfikacją pliku preferowaną przez LekkiKoszyk.pl

Data: 17-02-2014
Wersja 1.01
Specyfikacja pliku XML Lekkikoszyk
Przykładowa składnia pliku LK v1.01:
<?xml encoding="utf-8" version="1.0" ?>
<items
start_time=”2014-02-17 11:42:00”
modified_time=”2014-02-17 11:42:00”>
<item>
<id>14372</id>
<name><![CDATA[Przykładowy produkt]]></name>
<price>24.47</price>
<url><![CDATA[http://skynet.eu/p12372/]]></url>
<category><![CDATA[Odziez/Nakrycia głowy]]></category>
<description><![CDATA[<b> opis...</b>]]></description>
<image><![CDATA[http://skynet.eu/photos/12372.png]]></image>
<quantity>15</quantity>
<weight>2.54</weight>
<avail>7</avail>
<attrs>
<attr name="EAN">5908252687624</attr>
<attr name="Internal">Z590</attr>
<attr name="Manufacturer">Producent</attr>
<attr name="Model">Model produktu</attr>
<attr id="1" name="Color"><![CDATA[Czerwony]]></attr>
...
<attr id="15" name="Size"><![CDATA[XXL]]></attr>
<attr name="img1"><![CDATA[http://s.eu/photos/12_2.png]]></attr>
<attr name="img2"><![CDATA[http://s.eu/photos/12_2.png]]></attr>
...
<attr name="img10"><![CDATA[http://s.eu/photos/12_2.png]]></attr>
<attr name="Series_id"><![CDATA[2]]></attr>
<attr name="Series_name"><![CDATA[opis serii]></attr>
<attr name="unit_id"><![CDATA[5]]></attr>
<attr name="unit_name"><![CDATA[]]></attr>
</attrs>
</item>
..
1/5
<item> .. </item>
<attr_desc_table>
<!-- cechy –->
<desc_attr id=”1”><![CDATA[Kolor]]></desc_attr>
<desc_attr id=”15”><![CDATA[Rozmiar]]></desc_attr>
...
<!-- np. kolory –->
<desc_attr id=”101”><![CDATA[Czarny]]></desc_attr>
<desc_attr id=”102”><![CDATA[Zielony]]></desc_attr>
...
<!-- rozmiary obuwia–->
<desc_attr id=”201”><![CDATA[39]]></desc_attr>
<desc_attr id=”202”><![CDATA[40]]></desc_attr>
...
<desc_attr id=”215”><![CDATA[48]]></desc_attr>
</attr_desc_table>
</items>
Zalecany typ kodowania znaków to UTF-8.
Właściwość encoding w nagłówku XML powinna zawierać typ kodowania
znaków zgodny z typem kodowania znaków wykorzystanym w pliku XML.
Akceptowane typy kodowania
znaków to Windows-1250, ISO-8859-2 lub UTF-8.
Istnieje możliwość podania atrybutów dla produktu, takich jak
wewnętrzny identyfikator
produktu(np. Numer katalogowy), kod EAN, producent czy model
produktu, oraz inne dane dotyczące danego produktu.
Dane te nie są obowiązkowe, jednak w przyszłości
mogą pomóc w sprawniejszym zarządzaniu ofertą.
Informacja o generowaniu pliku
modified_time – data wygenerowania pliku
start_time – data rozpoczęcia generowania pliku
<items
last_modified=”2014-02-17 11:42:00”
start_time=”2014-02-17 11:42:00”>
2/5
Atrybuty(warianty) produktów
Elementy <attr> zawarte w elemencie <attrs> zawierają atrybuty.
Atrybuty o nazwach EAN, Internal, Manufacturer oraz Model są
zarezerwowane.
Pozostałe atrybuty(cechy, warianty) powinny występować w postaci:
<attr id="id-atrybutu" name="Nazwa cechy"><![CDATA[Wartość
cechy]]></attr>
Atrybut id elementu <attr id> nie jest wymagany, jednak jego
podanie jest zalecane.
Jeśli cena lub ilość produktu jest zależna
od wybranego wariantu produktu,
powinien on występować w pliku xml jako osobny produkt.
Identyfikator produktu
W tym przypadku istnieje problem z nadaniem identyfikatora nowemu
produktowi w pliku.
Dla produktu z <id>14372</id>, dla którego występuje wariant o
innej cenie lub stanie magazynowym należy nadać unikalny
identyfikator, nie kolidujący z innymi identyfikatorami już
istniejących produktów.
Przykład: <id>14372-2</id>
- łańcuch znaków zamiast liczby całkowitej dodatniej jako
identyfikator jest możliwe.
3/5
Opis znaczenia poszczególnych pól:
( wszystkie pola są wymagane i zalecane jest ich wypełnienie)
Produkt
<item>
1. id Unikalne id produktu w bazie danych sklepu
2. name STRING(64) Nazwa produktu
3. price FLOAT Cena produktu
4. url STRING(255) Adres url do produktu w sklepie
5. category STRING(255) Kategoria w sklepie.
6. image STRING(255) Adres url do zdjęcia produktu
7. quantity INTEGER Stan magazynowy/ilość sztuk produktu
8. weight FLOAT Waga produktu (w kg).
Jeżeli podana waga wynosi 0, pole jest ignorowane.
9. avail – dostępność podawana w dniach ( jak szybko realizowana
będzie wysyłka ) atrybut jeżeli jest dostęny dla produktu
99 – produkt niedostępny, lub na zamówienie
10.
•
•
•
•
•
•
<attr
<attr
<attr
<attr
<attr
<attr
<attr
<attr
<attr
<attr
<attr
attrs – zawiera atrybuty dla produktu
img1,img2, - aktywne obrazki występujące przy produkcie
EAN – kod ean produktu
Internal – wewnętrzny identyfikator produktu, kod
producenta np. A9J40A#B1H
Manufacturer – producenta HP
Model – model produktu np. ENVY 4500 e-All-in-One Printer
można dodać dowolne atrybuty które mają unikalną nazwę,
name=img1, name=img2, i grupować po nazwie
name="EAN">5908252687624</attr>
name="Internal">Z590</attr>
name="Manufacturer">Producent</attr>
name="Model">Model produktu</attr>
id="1" name="Color"><![CDATA[Czerwony]]></attr>
id="15" name="Size"><![CDATA[XXL]]></attr>
name="img1"><![CDATA[http://s.eu/photos/12_2.png]]></attr>
name="Series_id"><![CDATA[5]]></attr>
name="Series_name"><![CDATA[opis serii]></attr>
name="unit_id"><![CDATA[2]]></attr>
name="unit_name"><![CDATA[]]></attr>
4/5
Zestawienie cech wszystkich produktów
<attr_desc_table>
aby klient mógł zmieniać cechy z automatu dla wielu produktów,
potrzebujemy tabelkę atrybutów występujących przy opisie produktu,
<attr_desc_table>
<!-- cechy –->
<desc_attr id=”1”><![CDATA[Kolor]]></desc_attr>
<desc_attr id=”15”><![CDATA[Rozmiar]]></desc_attr>
...
<!-- np. kolory –->
<desc_attr id=”101”><![CDATA[Czarny]]></desc_attr>
<desc_attr id=”102”><![CDATA[Zielony]]></desc_attr>
...
<!-- rozmiary obuwia–->
<desc_attr id=”201”><![CDATA[39]]></desc_attr>
<desc_attr id=”202”><![CDATA[40]]></desc_attr>
...
<desc_attr id=”215”><![CDATA[48]]></desc_attr>
</attr_desc_table>
5/5