Šis vadovas skirtas el. parduotuvių programuotojams, norintiems integruoti savo prekių asortimentą į Kainos.lt sistemą. Teisingai suformuotas XML failas užtikrina sklandžią duomenų sinchronizaciją.
XML failas privalo naudoti UTF-8 koduotę, kad būtų teisingai atvaizduojami lietuviški rašmenys.
Rekomenduojame visas tekstines reikšmes talpinti į <![CDATA[ ... ]]> sekcijas saugumui užtikrinti.
Turi būti paduodama tokia prekės kaina, kurią gaus pirkėjas, pirkdamas tik tą vieną prekę. Galima paduoti lojalumo klubo ar kitos nuolaidų grupės kainą, jei ji nieko papildomai nekainuoja ir nereikalauja pirkti papildomų prekių.
Failas turi būti pasiekiamas per tiesioginę, nekintančią nuorodą periodiniam sistemos tikrinimui. Nuorodoje negalima nurodyti nestandartinių tinklo prievadų (pvz., tokių kaip :8080). Failas gali būti apsaugotas naudojant bazinę autentifikaciją (angl. Basic Auth).
Jei ribojate prieigą, įtraukite Kainos.lt IP adresus į leidžiamų sąrašą: Sąrašas JSON formatu.
Sistema naudoja šį parašą duomenims atsisiųsti: KainosLtXmlImporter/2.1 (+https://www.kainos.lt/xml-importer; [email protected])
Produkto ID (id) turi būti unikalus ir nekintantis. Griežtai draudžiama pakartotinai naudoti tą patį ID skirtingoms prekėms, nes tai sutrikdo prekių istoriją ir susiejimą.
| Elementas | Privalomumas | Tipas | Aprašymas |
|---|---|---|---|
<products> |
Privalomas | Struktūra | Pagrindinis (šakninis) XML dokumento elementas, kuriame talpinami visi produktai. |
<product> |
Privalomas | Elementas | Kiekvienas produkto įrašas turi būti šiame elemente. Gali būti neribotas skaičius produktų. |
id atributas arba <id> |
Privalomas | Tekstas / Skaičius | Unikalus prekės identifikatorius jūsų sistemoje. Gali būti perduodamas kaip atributas (pvz., <product id="15">) arba kaip atskiras elementas. |
<title> |
Privalomas | Tekstas |
Prekės pavadinimas. Rekomenduojama nurodyti gamintoją, modelį ir svarbiausias charakteristikas (spalvą, talpą).
Jei prekė nėra nauja, privaloma prekės pavadinime nurodyti jos būklę apibūdinantį raktinį žodį (pvz., naudota, atnaujinta, refurbished, išpakuota, po grąžinimo, demo, pažeista). Sistemoje pagal šiuos žodžius prekei bus automatiškai priskirta atitinkama būklės žymė. |
<item_price> |
Privalomas | Skaičius | Galutinė prekės kaina su PVM (eurais), kurią pirkėjas sumoka užsakymo metu. |
<loyalty_program_item_price> |
Pasirenkamas | Skaičius | Speciali kaina lojalumo programos nariams. Norėdami aktyvuoti, susisiekite su Kainos.lt administracija. |
<manufacturer> |
Privalomas | Tekstas | Gamintojo pavadinimas (pvz., Apple, Samsung, Bosch). |
<image_url> |
Privalomas | Tekstas (URL) | Nuoroda į pagrindinį prekės atvaizdą. Atvaizdas turi būti kokybiškas, rekomenduojama baltame fone. |
<product_url> |
Privalomas | Tekstas (URL) | Tiesioginė nuoroda į prekės puslapį jūsų elektroninėje parduotuvėje. |
<categories> |
Rekomenduojamas | Masyvas | Prekės kategorijų medis. Galima nurodyti kelias kategorijas, naudojant vidinius <category> elementus. |
<stock> |
Rekomenduojamas | Skaičius | Prekės likutis sandėlyje. Jei tikslus kiekis nežinomas, rekomenduojama šio elemento neįtraukti. Jei prekės neturite, rekomenduojame ją tiesiog išimti iš XML failo. |
<ean_code> |
Labai rekomenduojamas | Tekstas | Produkto brūkšninis kodas (EAN-13). Šis laukas yra kritiškai svarbus automatiniam prekių susiejimui. |
<eans> |
Labai rekomenduojamas | Masyvas | Elementas kelių EAN kodų perdavimui. Naudojamas <eans> elementas su vidiniais <ean> elementais-vaikais. |
<model> |
Rekomenduojamas | Tekstas | Konkretus prekės modelio pavadinimas arba numeris (pvz., MFYP4HX/A). |
<additional_images> |
Rekomenduojamas | Masyvas | Papildomos nuorodos į prekės atvaizdus. |
<specs> |
Rekomenduojamas | Masyvas | Techninės specifikacijos. Kiekviena reikšmė pateikiama <spec> elemente su name atributu. |
<delivery_text> |
Pasirenkamas | Tekstas | Trumpas tekstas apie pristatymo sąlygas (pvz., „1-3 d. d.“). Maksimalus ilgis - 21 simbolis. |
<short_message> |
Pasirenkamas | Tekstas | Trumpa rinkodaros žinutė (pvz., „Nemokamas pristatymas“). Maksimalus ilgis - 80 simbolių. |
Žemiau pateikiamas pilnas Apple iPhone 17 Pro Max 256GB Deep Blue produkto XML pavyzdys.
<?xml version="1.0" encoding="utf-8"?>
<products>
<product id="15">
<id>15</id>
<title><![CDATA[Apple iPhone 17 Pro Max 256GB Deep Blue]]></title>
<item_price>1499.00</item_price>
<loyalty_program_item_price>1199.00</loyalty_program_item_price>
<manufacturer><![CDATA[Apple]]></manufacturer>
<image_url><![CDATA[http://example.com/product_123.jpg]]></image_url>
<product_url><![CDATA[http://example.com/product_123]]></product_url>
<categories>
<category><![CDATA[Telefonai/Mobilieji telefonai]]></category>
<category><![CDATA[Telefonai/Išmanieji telefonai]]></category>
</categories>
<stock>9</stock>
<ean_code>4549995649307</ean_code>
<model><![CDATA[MFYP4HX/A]]></model>
<additional_images>
<image><![CDATA[http://example.com/product_123.jpg]]></image>
<image><![CDATA[http://example.com/product_123.jpg]]></image>
</additional_images>
<specs>
<spec name="Vidinė atmintis">
<![CDATA[256 GB]]>
</spec>
<spec name="Ekrano įstrižainė (coliais)">
<![CDATA[6.9"]]>
</spec>
<spec name="Spalva">
<![CDATA[Deep Blue]]>
</spec>
</specs>
<delivery_text><![CDATA[0 - 2 d.d.]]></delivery_text>
<short_message><![CDATA[Nemokamas pristatymas]]></short_message>
</product>
</products>