Prekių XML formatas

Tas pats formatas, kurį naudoja kainos.lt ir kaina24.lt. Jei jūsų parduotuvė jau eksportuoja tokį failą, jo keisti nereikia — atsiųskite nuorodą čia ir iškart pamatysite patikrinimo rezultatą.

Šakninis elementas

Priimame abu variantus: <products> su <product> vaikais arba <product_feed><products> apvalkalą (verskis.lt / eshoprent moduliai). Koduotė — UTF-8. Tekstinius laukus vyniokite į <![CDATA[ ... ]]>.

Laukai

Laukas	Būtinumas	Tipas	Paaiškinimas
`id`	privalomas	`string`	Unikalus, nekintantis prekės identifikatorius. Gali būti `` atributas arba `` elementas.
`title`	privalomas	`string`	Prekės pavadinimas su gamintoju, modeliu ir svarbiausiomis savybėmis. Nenaujos prekės pavadinime privalo būti būklės žodis (žr. žemiau).
`item_price`	privalomas	`number`	Galutinė kaina eurais su PVM, už vieną vienetą. Dešimtainis skirtukas – taškas.
`manufacturer`	privalomas	`string`	Gamintojas / prekės ženklas.
`image_url`	privalomas	`url`	Pagrindinė prekės nuotrauka (absoliutus URL, geriausia baltame fone).
`product_url`	privalomas	`url`	Tiesioginė nuoroda į prekės puslapį jūsų parduotuvėje (absoliutus URL).
`ean_code`	rekomenduojamas	`string`	EAN-13 brūkšninis kodas. Svarbiausias laukas – pagal jį sulyginame tą pačią prekę skirtingose parduotuvėse.
`eans/ean`	rekomenduojamas	`string[]`	Keli EAN kodai, jei prekė jų turi daugiau nei vieną.
`model`	rekomenduojamas	`string`	Gamintojo modelio kodas.
`specs/spec[@name]`	rekomenduojamas	`map`	Techninės specifikacijos: `5 l`. Iš jų sudarome palyginimo lenteles.
`categories/category`	rekomenduojamas	`string[]`	Jūsų kategorijos kelias, pvz. `Buitinė technika/Virtuvės technika/Gruzdintuvės`. Pagal jį priskiriame prekę mūsų kategorijai.
`additional_images/image`	nebūtinas	`url[]`	Papildomos nuotraukos.
`manufacturer_code`	nebūtinas	`string`	Jūsų vidinis SKU.
`stock`	nebūtinas	`number`	Likutis. 0 arba mažiau – prekės nerodome kaip turimos. Nesant lauko laikome, kad prekė yra.
`loyalty_program_item_price`	nebūtinas	`number`	Lojalumo programos kaina (mažesnė nei `item_price`). Rodome tik jei jos gavimui nereikia papildomo pirkimo.
`delivery_text`	nebūtinas	`string` · iki 21	Trumpas pristatymo tekstas, iki 21 simbolio.
`short_message`	nebūtinas	`string` · iki 80	Trumpa žinutė prie prekės, iki 80 simbolių.
`category_id`	nebūtinas	`string`	Jūsų kategorijos ID.

Nenaujos prekės

Jei prekė nėra nauja, jos title lauke privalo būti būklės žodis: naudot, atnaujint, refurbish, restaur, išpakuot, ispakuot, po grąžinimo, po grazinimo. Pagal jį prekei priskiriame būklės ženklą ir nerodome jos šalia naujų kaip lygiavertės.

Failo pasiekiamumas

Nuoroda turi būti pastovi ir nekintanti.
Standartiniai prievadai (80 / 443). :8080 ir panašių nepasieksime.
HTTP Basic autentifikacija leidžiama — duomenis perduokite kartu su nuoroda arba įrašykite į ją: https://vartotojas:slaptazodis@jusu-parduotuve.lt/feed.xml
Importuotojo User-Agent: ParinkXmlImporter/1.0 (+https://parink.lt/parduotuvems/xml)
Failą skaitome kas 6 val.; didžiausias dydis — 15 MB.

Pavyzdys

<?xml version="1.0" encoding="UTF-8"?>
<products>
  <product id="12345">
    <title><![CDATA[Karšto oro gruzdintuvė Ninja Foodi AF400EU, 7,6 l]]></title>
    <item_price>179.99</item_price>
    <loyalty_program_item_price>169.99</loyalty_program_item_price>
    <manufacturer><![CDATA[Ninja]]></manufacturer>
    <model><![CDATA[AF400EU]]></model>
    <manufacturer_code><![CDATA[SKU-99213]]></manufacturer_code>
    <ean_code>0622356561105</ean_code>
    <eans>
      <ean>0622356561105</ean>
    </eans>
    <image_url><![CDATA[https://pavyzdys.lt/img/af400eu.jpg]]></image_url>
    <additional_images>
      <image><![CDATA[https://pavyzdys.lt/img/af400eu-2.jpg]]></image>
    </additional_images>
    <product_url><![CDATA[https://pavyzdys.lt/p/ninja-af400eu]]></product_url>
    <categories>
      <category><![CDATA[Buitinė technika/Virtuvės technika/Gruzdintuvės]]></category>
    </categories>
    <stock>7</stock>
    <specs>
      <spec name="talpa" label="Talpa"><![CDATA[7,6 l]]></spec>
      <spec name="galia" label="Galia"><![CDATA[2400 W]]></spec>
      <spec name="krepseliai" label="Krepšelių skaičius"><![CDATA[2]]></spec>
    </specs>
    <delivery_text><![CDATA[Pristatymas 1-2 d.]]></delivery_text>
    <short_message><![CDATA[Dviejų zonų kepimas]]></short_message>
  </product>
</products>

Mašininis aprašas

Formalus laukų aprašas su pavyzdžiu: /parduotuvems/xml.json. Instrukcija AI agentams: /parduotuvems/agent.md.