XML Jak zintegrować sklep

XML
Jak zintegrować sklep
Import XML
Informacje o produktach ze Sklepów Partnerskich pobierane są poprzez import plików XML
wystawianych przez sklep. Plik powinien być wystawiany pod stałym adresem w sposób ciągły.
Aktualizacje
Informacje o produktach są pobierane cyklicznie, w godzinach, w których obciążenie serwerów jest
jak najmniejsze, mogą się jednak pojawiać sytuacje wymagające importu poza cyklem.
Wymagania techniczne
Im bardziej szczegółowe informacje o produktach wystawia Sklep Partnerski, tym większa
możliwość opisania ich przez nasz serwis, czyli częstsze wyszukanie tych produktów przez naszych
użytkowników.






plik powinien mieć poprawny składniowo format XML;
obowiązującym kodowaniem jest UTF – 8;
w pliku powinny się znajdować tylko te produkty, które aktualnie są dostępne w sklepie;
plik powinien być aktualizowany co najmniej raz dziennie, dzięki temu użytkownicy będą
mieli możliwość zobaczenia zawsze aktualnych ofert;
każdy produkt powinien być przypisany tylko do jednej kategorii;
zdjęcia powinny być wystawiane w formatach JPG lub GIF, optymalny rozmiar zdjęcia
powinien być wyższy niż 1000x600px, minimalny rozmiar to 300x300px.
Informacje obowiązkowe
Część informacji o produktach jest obowiązkowa, ich brak może uniemożliwić prawidłowy import.
category
Kategoria produktu w sklepie; każdy produkt powinien mieć jedną
kategorię; w polu może się znaleźć również ścieżka kategorii np.
odzież/sukienki/koktajlowe
Brand
Marka
Price
Cena produktu, bez symbolu waluty, przedzielona kropką
Url
Link do produktu
name
Nazwa produktu
image
Link do zdjęcia produktu
Allani sp. z o.o.
Nowogrodzka 31, 00-511
Warszawa, 4
Sąd Rejonowy dla m.st. Warszawy KRS: 0000420666
XII Wydział Gospodarczy KRS
REGON: 146125010
NIP: 7010341999,
Kapitał zakładowy: 46.000 PLN
Informacje dodatkowe
Pozostałe informacje są nieobowiązkowe, jednak poprawiają widoczność produktu na serwisie oraz
podnoszą konwersje na sprzedaż.
Description
previous_price
gender
colors
material
tags
Pattern
size
currency
Producer
availability
shipping_cost
delivery_time
product_id
Sku
Ean
Opis produktu
Poprzednia cena produktu; informacja pozwala nam na indeksowanie
promocji i przecen, znacząco zwiększa możliwość eksponowania
produktu oraz konwersje; bez symbolu waluty, przedzielona kropką
Parametr określający czy produkt jest męski czy damski, jeżeli pole w
XMLu będzie puste bądź będzie go brak zakładamy, że produkt jest
damski; informacja o płci powinna być podawana wg. klucza „male”,
„female”; jeżeli w XML znajdują się obydwa oznaczenia to dzielimy je
przecinkiem
Kolory produkty; nazwa koloru powinna być podawana w języku
angielskim np. red, black
Główny materiał z którego wykonany jest produkt
Dodatkowy znacznik w którym można zawrzeć informacje o produkcie
takie jak fason, krój, trend
Dominujący wzór produktu np. kratka, paski
Rozmiar; informacja o rozmiarach produktów; jeżeli produkt posiada
więcej niż jeden rozmiar dzielimy je przecinkiem
Waluta w jakiej podawana jest cena produktu w pliku, stosujemy
oznaczenia walut według standardu PLN, EUR, DOL jeśli brakuje tej
informacji zakładamy, że cena jest podawana w złotych
Nazwa producenta
Dostępność produktu określana w formacie “yes” lub “no”; jeżeli brak
znacznika lub jest pusty to zakładamy, że produkt jest dostępny
Koszt dostawy
Czas dostawy
Identyfikator produktu w sklepie
SKU
EAN
Język
Prosimy o określenie w jakim języku podawane są informacje w XML, zwłaszcza opis i kategoria.
To dla nas ważna informacja określająca czy np. opisy powinny zostać przetłumaczone. Wyjątkiem
są kolor oraz płeć, które zawsze powinny być podawane w języku angielskim.
Informacja o języku powinna być przekazywana w znaczniku products lang np. <products
lang=”en”>. Jeżeli XML nie będzie zawierał tego znacznika to zakładamy, że jest informacje
podawane są w języku polskim. Znaczniki języka powinny być stosowane według standardu
ISO 639-1 Code http://www.loc.gov/standards/iso639-2/php/code_list.php.
Allani sp. z o.o.
Nowogrodzka 31, 00-511
Warszawa, 4
Sąd Rejonowy dla m.st. Warszawy KRS: 0000420666
XII Wydział Gospodarczy KRS
REGON: 146125010
NIP: 7010341999,
Kapitał zakładowy: 46.000 PLN
Wzór struktury XML:
<?xml version="1.0" encoding="UTF-8"?>
<products lang="pl">
<product>
<category>nazwa</category>
<brand>nazwa</brand>
<price>12.01</price>
<image>url</image>
<url>url</url>
<name>...</name>
<currency>PLN</currency>
<previous_price>15.00</previous_price>
<description>Opis...</description>
<gender>male,female</gender>
<sku>nr</sku>
<ean>nr</ean>
<product_id>id</product_id>
<delivery_time></delivery_time>
<shipping_cost></shipping_cost>
<colors>red,blue,yellow,...</colors>
<material>skóra, ...</material>
<pattern>krata,...</pattern>
<tags>krata,...</tags>
<size>S,M,39</size>
</product>
...
</products>
Jeżeli nie jesteś w stanie wystawić XML w takiej formie lub w ogóle nie generujesz plików XML,
skontaktuj się z nami: [email protected]
Dołożymy wszelkich starań, by pomóc Ci i dodać Twoje produkty do naszej bazy!
Pozdrawiamy
Zespół Allani.pl
Allani sp. z o.o.
Nowogrodzka 31, 00-511
Warszawa, 4
Sąd Rejonowy dla m.st. Warszawy KRS: 0000420666
XII Wydział Gospodarczy KRS
REGON: 146125010
NIP: 7010341999,
Kapitał zakładowy: 46.000 PLN