Integracja Partnerów ze Sklepem

Transkrypt

Integracja Partnerów ze Sklepem
Sklep mojeauto.pl
Integracja Partnerów ze Sklepem
Przewodnik
Jeśli chcesz:
dotrzeć do szerokiego grona
Internautów,
SKL EP MOJEA UT O.P L
Jako część Platformy
aby Twój sklep odwiedzali
użytkownicy zdecydowani na
dokonanie zakupu akcesoriów
motoryzacyjnych,
motoryzacyjnej mojeauto.pl,
która jest intensywnie
promowana w wielu częściach
całego serwisu, gwarantuje stale
rosnącą liczbę unikalnych wizyt
zaprezentować swoją ofertę w
eleganckiej i profesjonalnej
szacie graficznej,
użytkowników, którzy nastawieni
są na zakup akcesoriów
motoryzacyjnych.
skorzystać z potęgi największej
platformy motoryzacyjnej w
Polsce
…dołącz do nas!
INTEGRA CJA
Jest to sposób na dokonywanie
synchronizacji w stałych
odstępach czasu, co pozwoli na
przedstawianie stale aktualnej
Niniejszy
dokument
oferty Twojego sklepu na
instrukcje,
naszych stronach.
doprowadzić do pełnej integracji Twojego sklepu ze
pracowników działu informatycznego Twojej firmy.
Sklepem mojeauto.pl.
Jeśli nie posiadasz działu informatycznego, bądź
które
od
zawiera
podstaw
szczegółowe
tłumaczą
jak
UWAGA! Ten dokument zawiera sformułowania
techniczne
–
jest
zatem
dedykowany
dla
nie chcesz się tym zajmować, skontaktuj się z
Warto poświęcić chwilę czasu na przeanalizowanie
nami – zrobimy to za Ciebie!
zawartych tutaj wskazówek i porad – dokładne
zastosowanie się do nich może zaoszczędzić wiele
pracy Tobie i nam.
© 2009 mojeauto.pl | Opracowanie: [email protected]
Spis treści
1. Wstęp
3
2. Proces synchronizacji
4
3. Kategorie produktów w Sklepie
5
4. Specyfikacja plików XML
7
5. Budowa plików XML
8
6. Opisywanie produktów w kategoriach
10
7. Formatowanie opisów produktów
11
znajdziesz na stronie o podanym
8. Przykład poprawnego pliku XML
13
numerze. W zaciemnionym
9. FAQ
14
pasku bocznym (tym, na który
10. Kontakt
15
BUDOW A TEGO
DOKU ME NT U
Na tej stronie poznasz spis treści
tego dokumentu. Główną
informację w każdym rozdziale
teraz patrzysz), znajdziesz
dodatkowe informacje, które
ułatwią Ci zrozumienie tekstu i
wyjaśnią trudniejsze pojęcia.
Strona 2
Integracja Partnerów ze Sklepem mojeauto.pl – Przewodnik
Wstęp
Ten dokument jest przewodnikiem dla przyszłych Partnerów, który opisuje krok po
kroku sposób integracji Ich sklepu ze Sklepem mojeauto.pl.
Jeśli czytasz ten dokument, najpewniej jesteś zainteresowany zaprezentowaniem swojej
oferty w naszym sklepie. Nic prostszego!
XML
Extensible Markup Language (z
ang. Rozszerzalny Język
Znaczników) to uniwersalny
język przeznaczony do
Jeśli jeszcze tego nie zrobiłeś, powinieneś zacząć od wypełnienia formularza
kontaktowego
dla
Partnerów,
który
dostępny
jest
pod
adresem:
http://sklep.mojeauto.pl/integracja/formularz.html.
Skontaktuje się z Tobą nasz Przedstawiciel, który wyjaśni Ci, co robić dalej. Jeśli
wymogi formalne zostaną dopełnione, zostaniesz poproszony o dokonanie integracji
z naszym Sklepem.
reprezentowania różnych danych
w strukturalizowany sposób.
XML jest niezależny od
platformy, co umożliwia łatwą
wymianę dokumentów pomiędzy
różnymi systemami i znacząco
przyczyniło się do popularności
Integracja danych polega na udostępnieniu informacji o oferowanych produktach przez
Partnerów, co pozwala na wprowadzenie i aktualizację tych danych w Sklepie
mojeauto.pl. Integracja jest procesem w pełni zautomatyzowanym i odbywa się w
określonych odstępach czasowych. Formaty udostępnionych danych są ściśle
wyspecyfikowane (opisane również w tym dokumencie).
Do wymiany danych używamy formatu XML (Extensible Markup Language).
Pliki XML przygotowywane są z użyciem kodowania UTF-8.
tego języka w dobie Internetu.
Strona 3
Integracja Partnerów ze Sklepem mojeauto.pl – Przewodnik
Proces synchronizacji
Schemat procesu synchronizacji przedstawia się następująco:
Partner tworzy plik XML
produkty – ich nazwę, opis,
To pierwszy i zarazem najważniejszy etap synchronizacji. Według dostarczonej
specyfikacji DTD należy utworzyć plik XML, który będzie zawierał w sobie dane
o wszystkich produktach, które chcesz wyeksportować do Sklepu mojeauto.pl.
Każdy produkt powinien zawierać dodatkowo opis jego właściwości. Wartości,
które wstawisz w poszczególnych polach opisu produktu są dowolne, musisz
jednak pamiętać, że odpowiedni format wartości zapewni Twoim produktom
możliwość ich wyszukania w Sklepie mojeauto.pl. Więcej na temat przyjaznych
formatów wartości pól opisujących produkty, znajdziesz w rozdziale
„Formatowanie opisów produktów”.
gabaryty, itp.
Partner udostępnia plik XML
BUDOW A PLIK U XML
Plik XML składa się z informacji
o sklepie, z którego pochodzi
oraz zawiera, najczęściej bardzo
wiele, wpisów, opisujących
P R Z YJ A Z N E O P I S Y
PRODUKTU
Dobrze opisany produkt powinien
zawierać jak najbardziej czytelne
dla użytkownika informacje.
Następnym etapem jest umożliwienie uzyskania dostępu (do odczytu)
wygenerowanego pliku XML – najczęściej przez umieszczenie na publicznym
serwerze WWW. Oczywiście plik ten może być generowany na bieżąco, w
momencie otrzymania żądania przez Twoje serwery – to bez znaczenia. Należy
tylko uważać na to, aby czas wykonywania generacji pliku na żądanie nie
przekroczył maksymalnego czasu wykonania skryptu na serwerze. Ściąganie
plików XML od Partnerów odbywa się w godzinach nocnych (między godziną 2 a
4 w nocy).
Główny nacisk należy położyć na
Plik XML zostaje wprowadzony do bazy mojeauto.pl
odpowiedni format danych
Jeśli plik XML ściągnięty z serwerów Partnera jest poprawny, następuje jego
przetworzenie i dane o produktach zostają wprowadzone do bazy produktów
Sklepu mojeauto.pl. Należy mieć na uwadze, że każdy kolejny import nadpisuje
informacje o poprzednich produktach Partnera.
liczbowych, jak np. średnica czy
długość. Więcej o przyjaznych
formatach opisu produktu w
rozdziale „Formatowanie
opisów produktów”.
Produkty Partnera są prezentowane w Sklepie mojeauto.pl
Poprawnie wykonany import danych o produktach gwarantuje zaprezentowanie
pełnej oferty, wystawionej przez Partnera w pliku XML, na stronach Sklepu
mojeauto.pl. Od tego momentu Twoja oferta dostępna jest dla setek tysięcy
odwiedzających nasze strony, a statystyki tych odwiedzin są skrupulatnie
zliczane przez nasze systemy.
Strona 4
Integracja Partnerów ze Sklepem mojeauto.pl – Przewodnik
Kategorie produktów w Sklepie
KATEGOR IA
PRO DU KT ÓW
Przed przystąpieniem do utworzenia pliku XML z danymi produktów w Twojej ofercie,
należy rozpatrzyć kwestię odpowiedniego przyporządkowania ich do kategorii w Sklepie
mojeauto.pl. Jest to bowiem kwestia kluczowa, która umożliwi uniknięcie zbędnych
nieporozumień oraz umożliwi znalezienie szukanych produktów tym użytkownikom
Sklepu, którzy wolą przeglądać produkty w widokach kategorii zamiast używać
mechanizmów wyszukiwania.
To zbiór, skupiający produkty o
podobnych właściwościach,
zastosowaniach– np. opony,
felgi, foteliki.
P R Z Y P I S YW A N I E
KAT EGOR II W PLIK U
XML
Jest bardziej niż
prawdopodobne, że w swoim
sklepie posiadasz inaczej
Każdy produkt może mieć przypisaną wyłącznie jedną kategorię, wybraną z dowolnego
miejsca w drzewie. O tym, jakie kategorie produktów powiążesz z kategoriami w
Sklepie mojeauto.pl decydujesz sam – jeśli jednak potrzebujesz pomocy, pracownicy
mojeauto.pl chętnie Ci pomogą!
Ponieważ w wystawianym pliku XML, Partnerzy nie używają nazw kategorii, tylko ich
numerów identyfikacyjnych, w drzewie kategorii Sklepu mojeauto.pl zostały zawarte
również numery identyfikacyjne kategorii.
Uaktualniana na bieżąco lista kategorii znajduje się również pod tym adresem:
http://sklep.mojeauto.pl/integracja/kategorie.html.
Drzewo kategorii prezentuje się następująco:
usystematyzowane drzewo
kategorii produktów. Podczas
tworzenia pliku XML powinieneś
zatem w jak najbardziej
przejrzysty sposób przypisać
produkty ze swojego sklepu do
kategorii Sklepu mojeauto.pl. W
razie wątpliwości pomogą Ci
obserwacje aktualnie
przypisanych produktów do
kategorii na stronie naszego
Sklepu. Radą służy też
przedstawiciel Sklepu
mojeauto.pl.
Opony
Letnie
Osobowe
Ciężarowe
Dostawcze
Terenowe
Motocyklowe
Zimowe
Osobowe
Ciężarowe
Dostawcze
Terenowe
Motocyklowe
Wielosezonowe
Osobowe
Ciężarowe
Dostawcze
Terenowe
Motocyklowe
Akcesoria
Felgi
Aluminiowe
Stalowe
Akcesoria
Bagażniki
Boksy
Dachowe
1
7
13
14
15
16
17
8
18
19
20
21
22
9
23
24
25
26
27
76
2
10
11
12
3
28
29
Strona 5
Integracja Partnerów ze Sklepem mojeauto.pl – Przewodnik
30
31
32
33
4
34
42
43
44
45
46
47
48
35
36
37
49
50
38
51
52
53
54
55
39
40
41
56
57
58
5
59
60
61
62
6
63
64
65
66
67
68
69
70
71
72
73
74
75
Rowerowe
Na narty
Specjalne
Akcesoria
GPS
Nawigacje GPS
Samochodowa
Motocyklowa
Turystyczna
Wodna
Rolna
Lotnicza
Treningowa
Akcesoria GPS
Palmtopy GPS
Lokalizacja i monitoring
Osobista
Pojazdy
Mapy GPS
Garmin
Pocket PC
TomTom
Do telefonów
Do notebooków
Smartphone GPS
Stacje meteo
Odbiorniki GPS
Bluetooth
Kabel
Rejestratory trasy
Foteliki
0-13 kg
9-18 kg
18-36 kg
do 36 kg
Car Audio/Video
Radia
Wzmacniacze
Głośniki
DVD
Multimedia
Zmieniarki CD
Kamery cofania
Głośniki niskotonowe
Marine
CB-Radia
Radiotelefony
Anteny, akcesoria
Ultra-Mobile PC’s
Strona 6
Integracja Partnerów ze Sklepem mojeauto.pl – Przewodnik
Specyfikacja plików XML
Pliki XML tworzone są na podstawie specyfikacji DTD przygotowanej przez mojeauto.pl.
Aktualna DTD jest również dostępna pod adresem
http://sklep.mojeauto.pl/integracja/sklep.mojeauto.dtd.
DTD
Definicja typu dokumentu –
rodzaj dokumentu definiujący
formalną strukturę dokumentów
XML, określający składnię
konkretnej aplikacji XML.
Definicje DTD przeważnie są
zapisane w osobnym pliku
tekstowym, co pozwala na
zastosowanie tego samego DTD
dla wielu dokumentów.
Specyfikacja ta prezentuje się następująco:
<?xml version="1.0" encoding="UTF-8"?>
<!ELEMENT mojeauto (shop, product+)>
<!ELEMENT shop (shopid, shopname, www, date)>
<!ELEMENT shopid (#PCDATA)>
<!ELEMENT shopname (#PCDATA)>
<!ELEMENT www (#PCDATA)>
<!ELEMENT date (#PCDATA)>
<!ELEMENT product (id, name, description, price, url, imagesm, imagelg,
category, properties, producer, index)+>
<!ELEMENT id (#PCDATA)>
<!ELEMENT name (#PCDATA)>
<!ELEMENT description (#PCDATA)>
<!ELEMENT price (#PCDATA)>
<!ELEMENT url (#PCDATA)>
<!ELEMENT imagesm (#PCDATA)>
<!ELEMENT imagelg (#PCDATA)>
<!ELEMENT category (#PCDATA)>
<!ELEMENT properties EMPTY>
<!ATTLIST properties
height CDATA #IMPLIED
width CDATA #IMPLIED
depth CDATA #IMPLIED
capacity CDATA #IMPLIED
diameter CDATA #IMPLIED
bolts CDATA #IMPLIED
size CDATA #IMPLIED
sindex CDATA #IMPLIED
lindex CDATA #IMPLIED
offset CDATA #IMPLIED
ratio CDATA #IMPLIED
type CDATA #IMPLIED
promotion (0 | 1 | 2 | 3) #IMPLIED>
<!ELEMENT producer (#PCDATA)>
<!ELEMENT index (#PCDATA)>
Strona 7
Integracja Partnerów ze Sklepem mojeauto.pl – Przewodnik
Budowa plików XML
FO R MAT OW ANIE
W ARTOŚCI PÓ L OP IS U
Większość z używanych pól
opisu produktu z oferty w pliku
Podczas tworzenia pliku XML z danymi produktów, na podstawie załączonej definicji
DTD, należy mieć na uwadze, że specyfikacja została zbudowana tak, aby mogła
dotyczyć jak największego zakresu kategorii produktów – stąd żaden z produktów,
opisanych w Twoim dokumencie XML, nie będzie zawierał wszystkich pól opisu produktu.
Niektóre pola są wręcz właściwe wyłącznie dla produktów w określonych
kategoriach. Szczegółowe wyjaśnienie pól odpowiednich do opisania produktów z danej
kategorii znajdziesz w dalszej części tego dokumentu (rozdział „Opisywanie produktów
w kategoriach”).
XML posiada swój określony
format, którego używanie
znacząco zwiększa przejrzystość
Znaczenia poszczególnych pól pliku XML z opisami produktów, zostały przedstawione
poniżej.
•
Sklepu mojeauto.pl. O tym,
jakich formatów używać, dowiesz
się z rozdziału „Formatowanie
opisów produktów”.
•
shop – dane sklepu:
o shopid – identyfikator sklepu, przyznawany przez mojeauto.pl w momencie
rozpoczęcia współpracy,
o shopname – nazwa sklepu, prezentowana na listach produktów,
o www – adres internetowy strony głównej sklepu (zawierający „http://” oraz „/” na
końcu, np. „http://www.przykladowy-partner.com.pl/”),
o date – data wygenerowania pliku.
product – znacznik zawierający dane pojedynczego produktu, w każdym pliku powinien
występować przynajmniej jeden taki znacznik, przechowuje następujące dane:
o id – wewnętrzny identyfikator produktu w sklepie (nie powinien przekraczać 30
znaków),
o name – nazwa produktu (nie przekraczająca 255 znaków),
o description – opis produktu, nie dłuższy niż 65535 znaków,
o price – cena produktu, wyrażona w postaci liczby, posiadającej maksymalnie 8
znaków przed i dwa znaki po przecinku (dopuszczalne znaki to cyfry od 0 do 9
oraz przecinek lub kropka),
o url –pośredni adres URL do strony produktu, pozbawiony części domenowej
(czyli tej, zawartej w znaczniku shop > www) (np. „produkt_numer_jeden.html”
lub „index.php?kat=13&prod=312443”).
o imagesm – adres URL miniatury produktu (jeśli istnieje), nie przekraczającej
szerokości 100 pikseli, skonstruowany podobnie do adresu URL sklepu,
o imagelg – adres URL dużego obrazka produktu (jeśli istnieje), o wymiarach
mieszczących się w oknie przeglądarki dla typowych rozdzielczości ekranu,
o category – identyfikator liczbowy kategorii, do której powinien zostać
przyporządkowany dany produkt (szczegółowy opis identyfikatorów znajduje się
w dalszej części dokumentu),
o producer – nazwa producenta produktu, ograniczona do 50 znaków,
o index – indeks katalogowy produktu, ograniczony do 30 znaków,
o properties – właściwości szczegółowe produktu, pole może zawierać zero lub
więcej atrybutów z listy:
§
height – wysokość,
§
width – szerokość,
§
depth – głębokość,
§
capacity – pojemność,
§
diameter – średnica,
§
bolts – liczba/rozstaw śrub,
§
size – rozmiar,
§
sindex – indeks prędkości,
§
lindex – indeks nośności, ładowność,
Strona 8
Integracja Partnerów ze Sklepem mojeauto.pl – Przewodnik
§
§
§
offset – offset,
ratio – profil,
promotion – wskaźnik, czy produkt objęty jest ofertą promocyjną –
oznaczenia przyjęte następująco:
0 – jeśli produkt nie jest objęty żadną promocją,
1 – oznaczenie „promocja”,
2 – oznaczenie „nowość rynkowa”,
3 – oznaczenie „wyprzedaż”.
Opis jak formatować poszczególne pola znajdziesz w rozdziale „Formatowanie opisów
produktów”.
Strona 9
Integracja Partnerów ze Sklepem mojeauto.pl – Przewodnik
Opisywanie produktów w kategoriach
OPIS PRO DUKTU
Opis produktu jest, obok
odpowiedniego przypisania
produktu do kategorii,
najważniejszym czynnikiem, od
którego uzależniona jest
Ze względu na różnorodność kategorii w Sklepie mojeauto.pl, specyfikacja DTD
pozwala na stosowanie bardzo swobodnych opisów produktów w ofercie Partnera. Nie
należy jednak z tej dowolności korzystać bez ograniczeń, gdyż doprowadzi ona do
skomplikowania prezentacji produktów w Sklepie i w efekcie ograniczeniu możliwości
wyszukiwania produktów.
Aby ułatwić i ujednolicić sposób opisywania produktów w plikach XML, sporządzono
wykaz najważniejszych atrybutów pola properties, których wypełnienie jest
obowiązkowe w danej kategorii (nie jest jednak obowiązkowe z punktu widzenia
specyfikacji). Tag properties zawiera w sobie szereg atrybutów, które opisują
szczególne właściwości produktu.
możliwość szybkiego wyszukania
produktów, którymi są
zainteresowani użytkownicy
Sklepu mojeauto.pl. Podczas
Produkty w kategoriach głównych i im podległych, widocznych w poniższej tabeli,
powinny zostać opisane przynajmniej wyszczególnionymi obok atrybutami – dopuszcza
się umieszczanie większej ilości informacji (atrybutów innych niż wymienione), jednak
mogą one zostać zignorowane podczas wyświetlania oferty sklepu Partnera.
tworzenia opisów produktów
należy trzymać się zasad
Kategoria główna
Atrybuty pola properties, specyficzne dla kategorii
opisanych w rozdziałach
Opony
diameter,
ratio,
„Opisywanie produktów w
width,
kategoriach” oraz
lindex,
„Formatowanie opisów
produktów”.
sindex
Felgi
size,
bolts,
offset
Bagażniki
capacity
GPS
-
Foteliki
-
Car Audio/Video
-
CB Radia
-
Ultra-Mobile PC’s
-
Strona 10
Integracja Partnerów ze Sklepem mojeauto.pl – Przewodnik
Formatowanie opisów produktów
CIĄG ZN AKOW Y
Dowolnej długości szereg,
złożony z liter alfabetu polskiego,
cyfr oraz znaków
Ujednolicenie formatów opisu danych produktów w plikach XML wystawianych przez
Partnerów jest konieczne, ponieważ stosowanie wielu różnych formatów doprowadziłoby
do znacznego obniżenia możliwości wyszukiwania i przeglądania produktów w Sklepie
mojeauto.pl.
W miarę możliwości należy trzymać się przedstawionego poniżej formatu opisu
poszczególnych znaczników i atrybutów. Dla znaczników nieujętych w tabeli poniżej,
stosowany format jest oczywisty lub mało znaczący.
interpunkcyjnych i specjalnych.
Znacznik
W ART OŚĆ LIC ZBOW A
Atrybut
name
Znaczenie
Format
nazwa produktu
ciąg znakowy, który nie powinien
zawierać w sobie wartości tagu
Dowolnej długości liczba (ciąg
cyfr od 0 do 9), opcjonalnie
producer
cena brutto
price
zawierającą część dziesiętną,
przecinka, np.
oddzieloną przecinkiem lub
kropką (zwykle jest to
wartość liczbowa, część dziesiętna
oddzielona za pomocą kropki lub
1234.99
url
wyszczególnione w opisie).
adres strony produktu w
ciąg znakowy, który nie powinien
sklepie Partnera
zawierać w sobie wartości tagu
shop > www
T YP O W A J E D N O S T K A
imagesm
MI AR Y
Typowa dla danej kategorii
miniaturka obrazka
ciąg znakowy, który nie powinien
produktu
zawierać w sobie wartości tagu
shop > www
duży obrazek produktu
imagelg
ciąg znakowy, który nie powinien
produktu jednostka, w której
zawierać w sobie wartości tagu
podawany jest dany wymiar. Np.
shop > www
pojemność bagażnika – litry,
properties
height
wysokość
wartość liczbowa, wyrażona w
typowej dla kategorii produktu
średnica ekranu nawigacji GPS –
jednostce miary, np.
cale, itd. W razie wątpliwości,
odpowiedzi należy szukać na
1234
width
szerokość
wartość liczbowa, wyrażona w
typowej dla kategorii produktu
stronach Sklepu mojeauto.pl.
jednostce miary, np.
1234
depth
głębokość (długość)
wartość liczbowa, wyrażona w
typowej dla kategorii produktu
jednostce miary, np.
1234
Strona 11
Integracja Partnerów ze Sklepem mojeauto.pl – Przewodnik
capacity
pojemność
wartość liczbowa, wyrażony litrach,
np.
400
diameter
średnica
dla produktów w kategorii
Opony:
znak ‘R’ oraz wartość liczbowa –
wymiar wyrażony calach, np.
R17
dla produktów w pozostałych
kategoriach:
wartość liczbowa, wyrażona calach,
np.
12
bolts
ilość i rozstaw śrub
wartość liczbowa, wyrażająca ilość
śrub, znak ‘x’ oraz wartość
liczbowa, wyrażająca rozstaw, np.
12x1234
size
rozmiar
wartość liczbowa, wyrażona w
typowej dla kategorii produktu
jednostce miary (dla felg – w
calach),
1234
sindex
indeks szybkości
ciąg znakowy, np.
lindex
indeks nośności
wartość liczbowa, wyrażona w
(ładowność)
kg/oponę, np.
T
90
offset
offset
wartość liczbowa, opcjonalnie
zawierająca kropkę, oddzielającą
część dziesiętną, np.
10 lub
13.5
ratio
profil (opony)
wartość liczbowa, wyrażona w
typowej dla kategorii produktu
jednostce miary, np.
1234
W szczególnych przypadkach (podyktowanych np. istnieniem ogólnoświatowego,
powszechnie przyjętego formatu wyrażania określonych danych) możliwe są niewielkie
odstępstwa od opisanych tutaj formatów na rzecz innego – w szczególności niosącego
więcej informacji. Każdorazowo jednak najlepiej negocjować takie kwestie indywidualnie
Strona 12
Integracja Partnerów ze Sklepem mojeauto.pl – Przewodnik
Przykład poprawnego pliku XML
Poniżej zamieszczony został przykładowy poprawny plik XML. Może on być punktem
odniesienia w przypadku niejasności lub nieścisłości znalezionych w tym dokumencie.
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mojeauto SYSTEM
"http://sklep.mojeauto.pl/integracja/sklep.mojeauto.dtd">
<mojeauto>
<shop>
<shopid>999</shopid>
<shopname><![CDATA[Przykładowy sklep]]></shopname>
<www><![CDATA[http://www.przykladowy-sklep.pl/]]></www>
<date>11-09-2008</date>
</shop>
<product>
<id>101</id>
<name><![CDATA[Pierwszy produkt sklepu]]></name>
<description><![CDATA[Kilka słów opisu.]]></description>
<price>361.34</price>
<url><![CDATA[index.php?group=21&id=45&section=57]]></url>
<imagesm><![CDATA[photos/da0sijeqwe_small.jpg]]></imagesm>
<imagelg><![CDATA[photos/da0sijeqwe.jpg]]></imagelg>
<category>23</category>
<properties width="39" height="38" diameter="8" capacity="50" />
<producer><![CDATA[Pewna firma]]></producer>
<index>Mj8mdR</index>
</product>
<product>
<id>102</id>
<name><![CDATA[Drugi produkt sklepu]]></name>
<description><![CDATA[Krótki opis produktu, jego właściwości i
zastosowań.]]></description>
<price>7381.72</price>
<url><![CDATA[[index.php?group=11&id=98&section=9]]></url>
<imagesm><![CDATA[photos/dfgshgfdhgf_small.jpg]]></imagesm>
<imagelg><![CDATA[photos/dfgshgfdhgf.jpg]]></imagelg>
<category>3</category>
<properties diameter="18" bolts="2x140" ratio="80" type="czarna" />
<producer><![CDATA[Inna firma]]></producer>
<index>o16o46</index>
</product>
<product>
<id>103</id>
<name><![CDATA[Trzeci produkt sklepu]]></name>
<description><![CDATA[Opis trzeciego produktu tego
sklepu...]]></description>
<price>1.23</price>
<url><![CDATA[[index.php?group=8&id=5&section=5]]></url>
<imagesm><![CDATA[photos/sdfghrtyertyw_small.jpg]]></imagesm>
<imagelg><![CDATA[photos/sdfghrtyertyw.jpg]]></imagelg>
<category>57</category>
<properties size="36x129" promotion="2" />
<producer><![CDATA[Kolejna firma]]></producer>
<index>89CGS4</index>
</product>
</mojeauto>
Strona 13
Integracja Partnerów ze Sklepem mojeauto.pl – Przewodnik
FAQ
1. Czy istnieją wymogi dotyczące umieszczania moich plików XML na
serwerze?
Nie, poza tym, że plik XML musi być dostępny do odczytu dla każdego, kto wyśle
takie żądanie z Internetu.
2. Czy pole product > id (wewnętrzny identyfikator produktu) powinno być
unikalne w całym pliku XML?
Nie, ponieważ nie jest ono przez nas używane do identyfikacji produktu (jest jedynie
wskaźnikiem wewnętrznym, właściwym danemu partnerowi).
3. W jakim kodowaniu należy eksportować plik XML?
Pliki XML należy tworzyć i eksportować z użyciem kodowania UTF-8.
4. Czy integracji mogę dokonać z użyciem więcej niż jednego pliku XML?
Nie, jeden sklep (z jednym adresem WWW) może używać tylko jednego pliku XML
do synchronizacji danych o produktach.
5. Jak często dokonywane są aktualizacje mojej oferty w Sklepie?
Aktualizacje w chwili obecnej są dokonywane raz na dobę, między godziną 2 a 4 w
nocy.
6. Co zrobić, jeśli w drzewie kategorii Sklepu mojeauto.pl nie znajduję
kategorii, która powinna, moim zdaniem, się dam znajdować?
Możesz zawsze zaproponować nam wprowadzenie nowej kategorii – jeśli uznamy
to za zasadne, kategoria zostanie wprowadzona. W tym celu skontaktuj się z
Przedstawicielem Sklepu mojeauto.pl
Strona 14
Integracja Partnerów ze Sklepem mojeauto.pl – Przewodnik
Kontakt
Jeśli masz pytania lub wątpliwości w każdej chwili możesz skontaktować się z wybranym
Przedstawicielem mojeauto.pl.
W sprawach nawiązania i warunków współpracy:
Szymon Siwek
[email protected]
tel. 071 34 67 108
W sprawach technicznych:
Tomasz Zielonka
[email protected]
tel. 071 34 67 121
Strona 15
Integracja Partnerów ze Sklepem mojeauto.pl – Przewodnik