XML dokumentacija produktų importui

Šis vadovas skirtas el. parduotuvių programuotojams, norintiems integruoti savo prekių asortimentą į Kainos.lt sistemą. Teisingai suformuotas XML failas užtikrina sklandžią duomenų sinchronizaciją.

Techninė informacija ir bendrieji reikalavimai

Svarbu

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ą.

Laukų specifikacija

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ų.

XML pavyzdys

Ž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>