Przewodnik techniczny do zamieszczania ogłoszeń produktów za

Skontaktuj się z nami
[email protected]
Przewodnik techniczny do zamieszczania ogłoszeń produktów
za pomocą XML na portalu SoloStocks
Uwaga: plik XML powinien być stale dostępny za pomocą adresu URL w celu jego
automatycznego ściągania.
Struktura XML powinna być zgodna z instrukcjami zawartymi w dalszej części niniejszego
dokumentu. W przeciwnym wypadku, import ogłoszeń na naszą stronę nie będzie możliwy.
Po zakończeniu wypełniania XML, możesz pobrać ten plik XSD celem sprawdzenia jego
poprawności
Informacje wstępne XML
- Nagłówek: Plik XML posiada nagłówek, w którym znajduje się informacja o wersji xml oraz
encoding lub systemie kodowania. Należy wybrać typ kodowania UTF-8, nie jest możliwy
wybór innego systemu.
<?xml version=”1.0” encoding=”UTF-8”?>
- Sincro_details: Podstawowym elementem pliku xml są tagi, które decydują o pozostałych
elementach.
<SINCRO_DETAILS>
- Country: Jest to niepowtarzalny kod numeryczny identyfikujący kraj pochodzenia każdej
firmy. W dalszej części zostały wymienione kody używane najczęściej. Jeżeli siedziba firmy
mieści się w innym kraju, wyślij zapytanie dotyczące kodu za pośrednictwem poczty e-mail.
<COUNTRY:>67</COUNTRY>
3
Niemcy
12
Argentyna
31
Brazylia
41
Chile
46
Kolumbia
67
Hiszpania
75
Francja
106
Włochy
132
Maroko
138
Meksyk
164
Polska
165
Portugalia
Skontaktuj się z nami
[email protected]
Informacje o produktach
-
Products: Jest to etykieta, która zawiera informacje dotyczące wszystkich produktów firmy.
Wewnątrz products, zostanie utworzona subetykieta product dla każdego z produktów firmy.
<PRODUCTS>
-
Product: Tag zawierający wszelkie etykiety odnoszące się do produktu firmy wymienionej
poniżej.
<PRODUCT>
-
Product_id: Numer referencyjny: unikalny numer produktu. Każdy odrębne ogłoszenie,
nowe lub utworzone na podstawie istniejącego juz ogłoszenie, powinno posiadać unikalny
numer referencyjny.
<PRODUCT_ID>0123</PRODUCT_ID>
-
Title: Nazwa produktu lub tytuł ogłoszenia: Nazwa powinna być wprowadzona małymi
literami i posiadać maksymalnie 80 znaków. W identyczny sposób jak w przypadku numeru
referencyjnego, jeśli nastąpi zmiana tytułu, system automatycznie wykryje t akie ogłoszenie
jako ogłoszenie sprzedaży nowego produktu. Ogłoszenia o tym samym tytule nie mogą być
zamieszczane wielokrotnie.
W celu uniknięcia pojawienia się niepożądanych, nieczytelnych znaków, nazwa powinna
zostać wpisana w sekcję CDATA.
<TITLE><![CDATA[Nazwa produktu]]></TITLE>
-
Description: Szczegółowy opis produktu. Opisy nie mogą być identyczne dla różnych
produktów i zawierać informacje zachęcające do kupna: kolory, dane techniczne, rozmiary,
możliwość personalizacji produktu...
W celu uniknięcia pojawienia się niepożądanych, nieczytelnych znaków, informacja ta
powinna zostać wpisana w sekcję CDATA. Tekst nie może zawierać znaczników html,
jedyna dozwolona etykieta to <br />, łamanie linii.
<DESCRIPTION><![CDATA[Szczegółowy
tekst.<br/>Zawiera informację o kolorach,
materiałach.]]></DESCRIPTION>
-
opis bez znaczników html, zwykły
wymiarach, dostępnych rozmiarach,
Sector: Odpowiada kategorii SoloStocks, w której zostanie zamieszczone ogłoszenie.
Powinna ona jak najlepiej odpowiadać rodzajowi produktu. Odpowiada jest odpowiedni kod
numeryczny.
Aby ściągnąć plik z kategoriami SoloStocks i odpowiadającymi im numerami, kli knij tutaj
Po wyborze odpowiedniej kategorii, w tagu sector
odpowiadający.
wskaż 6-cyfrowy kod numeryczny jej
Przykład tagu Sector kategorii: Modne dodatki > Szaliki i szale > Apaszki
01 > 0108 > 010804
<SECTOR>010203</SECTOR>
Skontaktuj się z nami
[email protected]
- Price: Cena jednostkowa produktu (bez VAT). Podaj wartość numeryczną i oddziel ułamki do
maksymalnie dwóch miejsc dziesiętnych kropką (nie używaj separatora tysięcznego). Usuń
dodatkowe symbole takie jak: €, $ itp.
Jeśli Twój produkt ma jedną cenę, użyj etykiety: <PRICE>. Jeśli pozostawisz te pole puste,
przyjmie wartość „Do uzgodnienia”. Pamiętaj, że jeśli brak jest ceny sprzedaży, możliwość
sprzedaży online produktu nie zostanie włączona.
<PRICE>1234.56</PRICE>
Jeśli cena produktu zależy od zakupionej ilości, zamiast etykiety <PRICE> użyj etykiety
<PRICE RANGES>, w sposób opisany poniżej:
- Ustal przedziały cenowe w zależności od ilości produktu.
- Przedziały powinny być sekwencyjne, tak jak pokazano na przykładzie poniżej.
- Lość produktu w zakresie „From” – „To” nie może być podana w częściach dziesiętnych.
Jednostka miary dla określonej ilości produktu (jednostki, kg, litry itp.) jest określona w
minimalnym zamówieniu.
- W ostatnim przediale, wartość maksymalna wskazana jako „To” zostanie pominięta i
wyświetli się na stronie jako: „od” ilości wskazanej jako początkowa dla tego przedziału.
Jeśli przedział cenowy zawiera błędy, zostanie przypisana cena przypisana do ety kiety
<PRICE>, jeśli taka istnieje. Jeśli jej brak, wyświetli się cena „Do uzgodnienia”, ale
możliwość sprzedaży online produktu nie zostanie włączona.
<price_ranges>
<price_range>
<pr_from>1</pr_from>
= minimalna ilość
<pr_to>19</pr_to>
= maksymalna ilość
<pr_price>800</pr_price>
= cena/jednostka
</price_range>
<price_range>
<pr_from>20</pr_from>
= minimalna ilość
<pr_to>49</pr_to>
= maksymalna ilość
<pr_price>770</pr_price>
= cena/jednostka
</price_range>
<price_range>
<pr_from>50</pr_from>
= minimalna ilość
<pr_to>100</pr_to>
= maksymalna ilość
<pr_price>740</pr_price>
= cena/jednostka
</price_range>
</price_ranges>
Shipping: Czas dostawy produktu. Podaj wartość liczbową, w pełnych godzinach.
Na przykład: jeśli termin dostawy wynosi2 dni, wpisz 48 (2x24=48).
<SHIPPING:>48</SHIPPING>
-
Minimum: Minimalna liczba jednostek niezbędna do złożenia zamówienia. Podaj wartość
liczbową.
Jeśli nie wypełnisz tej etykiety, wartość minimalnego zamówienia zostanie ustawiona
domyślnie na 1.
<MINIMUM:>5</MINIMUM>
Skontaktuj się z nami
[email protected]
-
Unit_type: Jednostka miary dotyczącą sprzedawanego produktu. Wybierz z tabelki
zamieszczonej poniżej, liczbę, która odpowiada jednostce miary produktu.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
metr
m²
m³
kilometr
gram
kilogram
tona
litr
jedna sztuka
część
para
tuzin
pakiet
beczka
<UNIT_TYPE>9</UNIT_TYP E>
Jeśli nie wypełnisz tej etykiety, jednostka miary zostanie ustawiona domyślnie na (9).
- Photos: Jest to główna etykieta, która obejmuje wszystkie zdjęcia produktu,
odpowiadające poszczególnym etykietom photo każdego zdjęcia.
- Photo: Każde ze zdjęć produktu powinno posiadać swoją własną etykietę. Wszystkie
etykiety łączą się wewnątrz etykiety Photos. Należy wskazać w niej adres URL zdjęcia w
formacie jpg, png o gif.
<PHOTOS>
<PHOTO>http://www.site.com/photo1.jpg</PHOTO>
<PHOTO>http://www.site.com/photo2.jpg</PHOTO>
</PHOTOS>
W ogłoszeniach wyświetlą się następujące liczby zdjęć:
- Użytkownicy korzystający z darmowego pakietu i klienci z Pakietem Brąz — 2
- Klienci z Pakietem Srebro — 3
- Klienci z Pakietem Złoto — 5
Uwaga: Jeżeli za pomocą pliku chcesz wprowadzić zmiany w zdjęciach produktu(-ów),
prosimy o przesłanie stosownej informacji na adres publicació[email protected], tak aby
nasi technicy mogli dokonać aktualizacji na portalu SoloStocks.
Keywords: Jest to nieobowiązkowa etykieta, która odpowiada słowom kluczom opisującym
produkt i wspomagającym proces wyszukiwania ogłoszenia przez kupującego. Można dodać
od jednego do pięciu słów kluczy na produkt. Każdy keyword może zawierać maksymalnie
trzy słowa i 90 znaków. Należy otagować sekcję jako tekst z CDATA.
<KEYWORDS>
<KEYWORD><![CDATA[słowo klucz 1]]></KEYWORD>
<KEYWORD><![CDATA[słowo klucz 3]]></KEYWORD>
[ ... ]
</KEYWORDS>
Aby uzupełnić tą informację możesz zobaczyć przyładowy XML z produktami.