Import XML
      Wróć na stronę główną
      1. VARLE Marketplace
      2. Importy
      3. Import XML

      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.
      all_terminals_allowed
      • Parametr, który wyłącza wszystkie maszyny paczkowe.
      • ⚠️ Akceptowane wartości:
        • Puste - wszystkie maszyny paczkowe są dostępne.
        • 'true' - wszystkie maszyny paczkowe są dostępne.
        • 'false' - wszystkie maszyny paczkowe są wyłączone.
      venipak_terminal_allowed
      • Parametr, który wyłącza Venipak maszyny paczkowe.
      • ⚠️ Akceptowane wartości:
        • Puste - Venipak maszyny paczkowe są dostępne.
        • 'true' - Venipak maszyny paczkowe są dostępne.
        • 'false' - Venipak maszyny paczkowe są wyłączone.
      itella_terminal_allowed
      • Parametr, który wyłącza Itella maszyny paczkowe.
      • ⚠️ Akceptowane wartości:
        • Puste - Itella maszyny paczkowe są dostępne.
        • 'true' - Itella maszyny paczkowe są dostępne.
        • 'false' - Itella maszyny paczkowe są wyłączone.
      omniva_terminal_allowed
      • Parametr, który wyłącza Omniva maszyny paczkowe.
      • ⚠️ Akceptowane wartości:
        • Puste - Omniva maszyny paczkowe są dostępne.
        • 'true' - Omniva maszyny paczkowe są dostępne.
        • 'false' - Omniva maszyny paczkowe są wyłączone.
      lpe_terminal_allowed
      • Parametr, który wyłącza LPexpress maszyny paczkowe.
      • ⚠️ Akceptowane wartości:
        • Puste - LPexpress maszyny paczkowe są dostępne.
        • 'true' - LPexpress maszyny paczkowe są dostępne.
        • 'false' - LPexpress maszyny paczkowe są wyłączone.
      dpd_terminal_allowed
      • Parametr, który wyłącza DPD maszyny paczkowe.
      • ⚠️ Akceptowane wartości:
        • Puste - DPD maszyny paczkowe są dostępne.  
        • 'true' - DPD maszyny paczkowe są dostępne.
        • 'false' - DPD maszyny paczkowe są wyłączone. 

      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.