XML struktūra ir paaiškinimai

Varlė Marketplace galimos dvi XML struktūros, kurios nurodytos apačioje. Pardavėjai norintys naudoti XML duomenų atnaujinimui, turi pateikti Varlės XML struktūrą atitinkantį failą.

XML dokumentuose rasite 4 pavyzdžius:

  1. Produktas, kurio visos žymos yra užpildytos. Su variantais ir paaiškinimais. [Privalomos, neprivalomos, rekomenduojamos]
  2. Produktas, kurio visos žymos yra užpildytos. Be variantų ir paaiškinimų. [Privalomos, neprivalomos, rekomenduojamos]
  3. Produktas, kurio žymos dalinai užpildytos. Be variantų. [Privalomos, rekomenduojamos]
  4. Produktas, kuris turi tik privalomas žymas. (be variantų)

Visada rekomenduojame pateikti kiek įmanoma daugiau informacijos apie Jūsų turimus produktus. Tokiu būdu produktai bus lengviau sutvarkomi mūsų sistemoje (kategorijos, filtrai), atrodys patrauklesni klientams bei bus lengviau randami varle.lt puslapyje.

XML struktūros gali būti randamos čia:
➡️Su kategorijų medžiu: spauskite čia.
or
➡️Be kategorijų medžio (rekomenduojamas):spauskite čia.

XML structure and instructions

XML žymas skirstome į tris tipus: privalomas🔴, rekomenduojamas⭕, neprivalomas⚫

Žyma Informacija
Privalomos žymos🔴
<id>
  • Prekės ID jūsų sistemoje. Bet koks UNIKALUS kodas, pagal kurį prekė identifikuojama jūsų sistemoje. 
<categories>
  • Prekių kategorija(-jos).
  • Privaloma bent viena <category></category>. Rekomenduojama nurodyti tik galutinę produkto kategoriją. 
<title>
  • Tikslus ir aiškus prekės pavadinimas. 
<description>
  •  Prekes aprašymas HTML formatu. 
<price>
  • Galutinė prekės kaina klientui (su PVM), rodoma tinklapyje. Valiutos ženkliukas nereikalingas.
  • Jeigu pildoma <variants> žyma, kaina turi būti mažiausia varianto kaina. Logika kaip skaičiuojama galutinė prekės kaina kiek žemiau ↓ 
<delivery_text>
 

 

  • Prekės pristatymo terminas darbo dienomis. 
<images>
  •  Didelės raiškos nuotrauka(-os). 
<quantity>
  • Prekės likutis.
  • Jeigu pildoma <variants> žyma, kiekis turi būti tik prie <variant> žymų, o ne įterpta tarp <product> žymos. 
<barcode_format>
  • Nustatoma EAN arba UPC. 
<barcode>
  • Prekės barkodas.
  • Jeigu pildoma <variants> žyma, barkodai turi būti tik prie <variant> žymų, o ne įterpta tarp <product> žymos. 
Jeigu pildoma <variants> žyma

Kiekvienas <variant> turi turėti (Variantai nėra būtini pateikti, jeigu produktas neturi skirtingų savybių. Žiūrėti produkto pvz be variantų):

  • <title></title> Pvz.: Jei dydis, pavadinimas – S. Jeigu spalva, pavadinimas – Raudona ir t.t.
  • <quantity></quantity>
  • <barcode></barcode>
  • <price></price> !Pastaba. Tai nėra galutinė varianto kaina klientui. Ši kaina prisidės prie pagrindinės prekės kainos, kuri nurodyta tarp <product> žymos. Pvz.:

Spinta turi tris aukščius. Mažiausio aukščio spintos kaina – 150€, vidurinio – 200€, aukščiausio – 250€.

  • Pagrindinė prekės kaina tarp <product> bus – 150€.
  • Mažiausio aukščio spintos kaina variante bus – 0€
  • Vidurinio – 50€ (skirtumas. 150 + 50 = 200€)
  • Aukščiausio – 100€ (skirtumas. 150 + 100 = 250€) 
Rekomenduojamos žymos ⭕
<model>
  • Nesugalvotas prekės modelis/gamintojo kodas. 
 <weight>
  • Svoris kilogramais
  • Naudinga: Skaičiuojant produkto pristatymo kainą, jeigu pristatymo kaina yra pagal svorių rėžius. 
 <manufacturer>
  • Gamintojas.
👀  Gamintojai varle.lt turi atskirus puslapius, kaip pvz.: https://www.varle.lt/gamintojas/Nike/ . Galite padidinti produktų pasiekiamumą. 
 <videos>
  • Youtube video įrašai skirti prekės pristatymui.
⚠️Puslapyje video įrašai pateikiami prie produkto nuotraukų. 
 <attributes>
  • Prekės parametrai/atributai.
  • Tai trumpos ir svarbios prekės savybės, kurios apie produktą suteikia greitų ir naudingų žinių. Pateikiama kaip lentelė produkte aprašyme.
⚠️Atributai/Parametrai/Savybės taip pat naudojamos kuriant bei pildant kategorijų filtrus. Naudojant produktų filtraciją, klientai gali surasti norimus produktus greičiau ir paprasčiau. 
 <group>
  • Prekių grupės identifikatorius (gali būti bet koks kodas) - Nurodo tarpusavyje susijusių prekių grupę.
⚠️Jeigu paduodamos kelios vienodos prekės (Marškiniai) skirtingų spalvų, tai prie abiejų prekių reiktų nurodyti tą pačią grupę. 
 <variants>
  • Prekės pasirinkimo variantai. Pvz.: Dydis, Spalva, Galia ir t.t.

⚠️Labai naudinga, kai produktai turi dydžius, spalvas ar kitas produkto išvaizdą keičiančias savybes. Klientas gali žymiai paprasčiau rasti norimą variantą, atsidaręs tik vieną produktą. 

Neprivalomos žymos ⚫
<url>  Prekės URL adresas jūsų svetainėje. 
<category>  Neprivaloma, kai prekė jau turi bent vieną kategoriją. 
<price_old>
  • Sena kaina, matoma tinklapyje kaip perbraukta kaina, kuri buvo prieš akcijinę kainą.
  • Skaitykite daugiau čia.
 <product_with_gift> 
  • Nustatoma True, jeigu prie prekės pridėta papildoma dovana. 
 <warranty>
  • Garantija mėnesiais. Jeigu prekei taikoma garantija, nurodykite garantijos laikotarpį. 

Papildoma informacija

Kad XML importas būtų sėkmingas rekomenduojame:

  • Patikrinkti, ar suteikiama XML nuoroda veikia;
  • Patikrinti, ar atsidarius nuorodą, XML yra suformuojamas be klaidų;
  • Patikrinti XML validumą;
  • Patikrinti, ar XML struktūra atitinka varle.lt XML struktūrą.