Struktura i instrukcje XML
W VARLE Marketplace dostępne są dwie struktury XML, które są wymienione poniżej. Dostawcy chcący używać XML do aktualizacji danych muszą dostarczyć plik zgodny ze strukturą VARLE XML.
W dokumentach XML znajdziesz różne przykłady produktów, które możesz odpowiednio dostosować w swoim imporcie produktu. Podano przykłady:
- Produkt ze wszystkimi wypełnionymi tagami. Z wariantami i wyjaśnieniami. [Obowiązkowe, opcjonalne, zalecane]
- Produkt ze wszystkimi wypełnionymi tagami. Bez wariantów i wyjaśnień. [Obowiązkowe, opcjonalne, zalecane]
- Produkt, którego tagi są częściowo wypełnione. Bez wariantów. [Obowiązkowe, zalecane].
- Produkt, który posiada wyłącznie obowiązkowe tagi. (brak opcji)
Zawsze zalecamy podanie jak największej ilości informacji o produktach, które posiadasz. W ten sposób produkty będą łatwiejsze do zorganizowania w naszym systemie (kategorie, filtry), będą wyglądać atrakcyjniej dla klientów i będą łatwiejsze do znalezienia na stronie varle.lt.
Struktury XML można znaleźć tutaj::
➡️Z drzewem kategorii: Kliknij tutaj.
lub
➡️Bez drzewa kategorii (zalecane):Kliknij tutaj.
Struktura i instrukcje XML
Istnieją trzy typy znaczników XML: obowiązkowe🔴, zalecane⭕, opcjonalne⚫
Tag |
Info |
obowiązkowe przywieszka🔴 |
<id> |
- Identyfikator elementu w Twoim systemie. Każdy UNIKALNY kod, który identyfikuje element w Twoim systemie.
|
<categories> |
- Kategoria(e) produktu.
- Wymagana jest co najmniej jedna <category></category>. Zaleca się wskazanie tylko ostatecznej kategorii produktu.
|
<title> |
- Dokładna i jasna nazwa produktu.
|
<description> |
- Opis produktu w formacie HTML.
|
<price> |
- Ostateczna cena produktu dla klienta (wliczając VAT). Token walutowy nie jest wymagany.
- Jeśli tag <variants> jest wypełniony, cena musi być najniższą ceną wariantu. Poniżej przedstawiono logikę obliczania ceny produktu końcowego ↓
|
<delivery_text> |
- Czas dostawy produktu w dni robocze. Wypełnij np.: 1-2 d.d.
|
<images> |
- Zdjęcia w wysokiej rozdzielczości
|
<quantity> |
- Stan magazynowy produktu.
- Jeżeli znacznik <variants> jest wypełniony, ilość powinna znajdować się tylko obok znaczników <variant>, a nie między znacznikami <product>.
|
<barcode_format> |
|
<barcode> |
- EAN produktu.
- Jeżeli znacznik <variants> jest wypełniony, kody kreskowe należy przypisać tylko do każdego wariantu, a nie wstawiać ich pomiędzy znacznik <product>.
|
If the <variants> tag is filled |
Każdy <wariant> musi mieć (warianty nie są wymagane, jeśli produkt nie ma różnych cech. Sprawdź przykład produktu bez wariantów):
- <title></title> Na przykład: jeśli rozmiar, nazwa brzmi S. Jeśli kolor, nazwa brzmi Czerwony, itd.
- <quantity></quantity>
- <barcode></barcode>
- <price></price> ⚠️To nie jest ostateczna cena opcji dla klienta. Ta cena będzie stanowić część głównej ceny produktu, która jest wymieniona pomiędzy tagiem <product>. Na przykład:
Szafa ma trzy warianty. Cena najmniejszej szafy wynosi 150 €, średniej 200 €, a najwyższej 250 €.
- Cena główna produktu <product> będzie wynosić 150 €.
- Cena najniższej szafki w tym wariancie wyniesie 0 €.
- Środkowa – 50€ (różnica. 150 + 50 = 200€).
- Najwyższa - 100€ (różnica. 150 + 100 = 250€).
|
zalecane przywieszka⭕ |
<model> |
- Model produktu/kod producenta.
|
<weight> |
- Waga w kilogramach.
- Ważne przy: wyliczeniu ceny dostawy produktu, jeżeli cena dostawy jest uzależniona od wagi.
|
<manufacturer> |
👀 Producenci na varle.lt mają osobne strony, takie jak: https://www.varle.lt/gamintojas/Nike/. Możesz zwiększyć zasięg produktów. |
<videos> |
- Filmy na YouTube służą do prezentacji produktów.
⚠️Na stronie prezentowane są nagrania wideo i zdjęcia produktów. |
<attributes> |
- Parametry/atrybuty produktu.
- Są to krótkie i ważne cechy produktu, które zapewniają szybką i przydatną wiedzę o produkcie. Przedstawione jako tabela w opisie produktu.
⚠️Atrybuty/Parametry/Właściwości są również używane do tworzenia i wypełniania filtrów kategorii. Korzystając z filtrowania produktów, klienci mogą znaleźć produkty, których chcą, szybciej i łatwiej. |
<group> |
- Identyfikator grupy produktów (może być dowolny kod) – oznacza grupę powiązanych produktów.
⚠️W przypadku importu kilku identycznych produktów (koszul) w różnych kolorach, dla obu produktów należy wskazać tę samą grupę. |
<variants> |
- Opcje wyboru produktu. Na przykład: Rozmiar, Kolor, Moc, itp.
⚠️Bardzo przydatne, gdy produkty mają rozmiary, kolory lub inne cechy, które zmieniają wygląd produktu. Klient może znaleźć pożądaną opcję znacznie łatwiej, otwierając tylko jeden produkt.
|
opcjonalne przywieszka⚫ |
<url> |
Adres URL produktu na Twojej stronie internetowej. |
<category> |
Opcjonalne, jeśli produkt ma już co najmniej jedną kategorię. |
<price_old> |
- Stara cena, widoczna na stronie internetowej jako przekreślona, obowiązywała przed ceną promocyjną.
- Czytaj więcej: kliknij tutaj
|
<product_with_gift> |
- Ustaw na Prawda, jeśli do przedmiotu zostanie dodany dodatkowy prezent.
|
<warranty> |
- Gwarancja w miesiącach. Jeśli produkt jest objęty gwarancją, proszę podać okres gwarancji.
|
Dodatkowe informacje
Aby import XML przebiegł pomyślnie, zalecamy:
- Sprawdź, czy podany adres URL XML działa;
- Sprawdź, czy plik XML został wygenerowany bez błędów;
- Sprawdź poprawność XML. Możesz to zrobić za pomocą narzędzi online, na przykład kliknij tutaj.
- Sprawdź, czy struktura XML odpowiada strukturze XML pliku varle.lt.