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:

  1. Produkt ze wszystkimi wypełnionymi tagami. Z wariantami i wyjaśnieniami. [Obowiązkowe, opcjonalne, zalecane]
  2. Produkt ze wszystkimi wypełnionymi tagami. Bez wariantów i wyjaśnień. [Obowiązkowe, opcjonalne, zalecane]
  3. Produkt, którego tagi są częściowo wypełnione. Bez wariantów. [Obowiązkowe, zalecane].
  4. 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>
  • Ustawiono EAN lub UPC.
<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>
  • Producent.
👀 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.