XML import
      Back to home
      1. VARLE Marketplace
      2. Import
      3. XML import

      XML structure and instructions

      There are two XML structures available in the VARLE Marketplace, which are listed below. Vendors wishing to use XML for data updates must provide a file that conforms to the VARLE XML structure.

      In the XML documents, you will find different product examples that you can adapt accordingly in your product import. Examples given:

      1. A product with all tags filled. With variants and explanations. [Mandatory, optional, recommended]
      2. A product with all tags filled. Without variants and explanations. [Mandatory, optional, recommended]
      3. A product whose tags are partially filled. Without variants. [Mandatory, recommended].
      4. A product that only has mandatory tags. (no options)

      We always recommend providing as much information as possible about the products you have. In this way, products will be easier to organize in our system (categories, filters), will look more attractive to customers and will be easier to find on the varle.lt page.

      XML structures can be found here:
      ➡️With category tree: click here.
      or
      ➡️Without the category tree (recommended): click here.

      XML structure and instructions

      There are three types of XML tags: mandatory🔴, recommended⭕, optional⚫

      Tag Info
      Mandatory tags🔴
      <id>
      • Item ID in your system. Any UNIQUE code that identifies the item in your system.
      <categories>
      • Product category(ies).
      • At least one <category></category> is required. It is recommended to indicate only the final product category.
      <title>
      •  Accurate and clear product name.
      <description>
      • Product description in HTML format.
      <price>
      • The final price of the product for the customer (including VAT). A currency token is not required.
      • If the <variants> tag is filled, the price must be the lowest price of the variant. The logic of how the final product price is calculated is below ↓ 
      <delivery_text>
      • Product delivery time on working days. Fill in, for example: 1-2 d.d.
      <images>
      •  High resolution photo(s).
      <quantity>
      • Product stock.
      • If the <variants> tag is filled, the quantity should only be next to the <variant> tags, not inserted between the <product> tag.
      <barcode_format>
      • EAN or UPC is set.
      <barcode>
      • Product EAN.
      • If the <variants> tag is filled in, the barcodes must be only assigned to every variant, not inserted between the <product> tag.
      If the <variants> tag is filled

      Each <variant> must have (Variants are not required if the product does not have different characteristics. Check product example without variants):

      • <title></title> For example.: If the size, the name is S. If the color, the name is Red, etc.
      • <quantity></quantity>
      • <barcode></barcode>
      • <price></price> ⚠️This is not the final option price for the customer. This price will contribute to the main product price, which is listed between the <product> tag. For example:

      The wardrobe has three variants. The price of the smallest wardrobe is €150, the middle one is €200, and the highest one is €250.

      • The main price of the product between <product> will be €150.
      • The price of the lowest height cabinet in the variant will be €0.
      • Middle one – 50€ (difference. 150 + 50 = 200€)
      • The highest - 100€ (difference. 150 + 100 = 250€)
      Recommended tags ⭕
      <model>
      • Product model/manufacturer code.
       <weight>
      • Weight in kilograms. 
      • Important for: calculating the delivery price of the product, if the delivery price is based on the weight ratio.
       <manufacturer>
      • Manufacturer.
      👀 Manufacturers on varle.lt have separate pages, such as: https://www.varle.lt/gamintojas/Nike/. You can increase the reach of products.
       <videos>
      • Youtube videos are for product presentation.
      ⚠️On the page, video recordings are presented along with product photos.
       <attributes>
      • Product parameters/attributes.
      • These are short and important product features that provide quick and useful knowledge about the product. Presented as a table in the product description.
      ⚠️Attributes/Parameters/Properties are also used to create and populate category filters. Using product filtering, customers can find the products they want faster and easier.
       <group>
      • Product group identifier (can be any code) - Indicates a group of related products.
      ⚠️If several identical products (shirts) in different colors are imported, the same group should be indicated for both products.
       <variants>
      • Product selection options. For example: Size, Color, Power, etc.

      ⚠️Very useful when products have sizes, colors or other features that change the appearance of the product. The customer can find the desired option much easier by opening only one product.
      Optional tags ⚫
      <url>  The URL of the product on your website. 
      <category>  Optional when the product already has at least one category.
      <price_old>
      • The old price, visible on the website as a crossed out price, which was before the promotional price.
      • Click to read more here.
       <product_with_gift> 
      •  Set to True if an additional gift is added to the item.
       <warranty>
      • Warranty in months. If the product is covered by a warranty, please specify the warranty period.

      Additional information


      For a successful XML import, we recommend:

      • Verify that the provided XML url works;
      • Verify that the XML is generated without errors;
      • Validate XML. You can do this using online tools, such as clicking here.
      • Check whether the XML structure corresponds to the XML structure of varle.lt.