Používame cookies. Viac informácií tu.
Zavri

Aké XML formáty podporujete?

Podporujeme dva XML formáty:

  • Heuréka XML formát
  • Modrý koník XML formát (= Heuréka rozšírená o kategórie Modrého koníka)

1. Heuréka XML formát

Štandardným formátom XML feedu na Slovensku je Heuréka. Pokiaľ máš v nastaveniach svojho e-shopu možnosť zapnúť XML feed, pravdepodobne bude práve v tomto formáte. Feed vo formáte Heuréky môžeš priamo použiť pre import inzerátov do bazáru Modrého koníka.

Pri prvom importe Heuréka XML feedu sa pre každý inzerát nahrá:

  • Názov
  • Popis
  • Fotky
  • Cena
  • Skladom (áno/nie)
  • URL na konkrétny inzerát v tvojom e-shope

Následne budeš môcť inzerátom ručne priradiť koníkovské kategórie a vlastnosti cez hromadný "kategorizovač" v Môj bazár.

Nie všetky kategórie tovaru, ktoré sú v Heureka XML feede, sú totožné s našimi kategóriami. Preto je pri tomto formáte potrebné inzeráty dotriediť ručne. Prečítaj si, ako na to.

Pri všetkých ďalších importoch sa aktualizujú rovnaké parametre, ako pri prvom importe.

2. Modrý koník XML formát (= Heureka rozšírená o kategórie Modrého koníka)

Pokiaľ inzeráty nechceš kategorizovať ručne alebo chceš mať lepšiu kontrolu nad tým, čo sa importuje, môžeš vytvoriť feed špeciálne pre bazár Modrého koníka. Na to už budeš potrebovať programátora, ktorý vytvorí XML feed podľa našej schémy:
https://www.modrykonik.sk/xml/market/1.0/modrykonik.xsd

Ide o rovnakú štruktúru ako v prípade Heuréka formátu, ktorý je rozšírený o náš vlastný element <mk:category>. Definícia elementov z namespace-u mk je v importovanej schéme (modrykonik.xsd - riadok 4):
https://www.modrykonik.sk/xml/market/1.0/modrykonik-extension.xsd

Príklad 1 - Šport pre deti:

<mk:category name ="Šport pre deti | Cyklistika">
    <mk:color>Žltá</mk:color>
    <mk:type>Cykloodrážadlá</mk:type>
    <mk:sex>Pre dievčatá</mk:sex>
</mk:category>

Príklad 2 - Obuv detská:

<mk:category name="Obuv detská">
    <mk:type>Tenisky</mk:type>
    <mk:size>32</mk:size>
    <mk:sex>Unisex</mk:sex>
    <mk:brand>Deichmann</mk:brand>
    <mk:color>Tmavozelená</mk:color>
</mk:category>

Pri prvom importe Modrý koník XML feedu sa pre každý inzerát nahrá:

  • Názov
  • Popis
  • Fotky
  • Cena
  • Skladom (áno/nie)
  • URL na konkrétny inzerát v tvojom e-shope
  • Kategória a vlastnosti v <mk:...>, ktoré ste zadefinovali vo svojom XML feede.

Pri všetkých ďalších importoch sa aktualizuje len:

  • Názov
  • Popis
  • Fotky
  • Cena
  • Skladom (áno/nie)
  • URL na konkrétny inzerát v tvojom e-shope

Kategória a vlastnosti v sa už nikdy cez XML feed neaktualizujú (sú ignorované). Je to tak preto, že inzerát mohol byť dodatočne ručne presunutý do vhodnejšej kategórie, a tú je potrebné zachovať. Presun môže urobiť sám klient alebo aj Modrý koník (v bazári pravidelne inzeráty kontrolujeme a triedime do správnych kategórií, alebo vznikne nová kategória a pod.).

Môžem si u seba nejako zvalidovat náš XML feed?

Áno, ešte pred tým, než feed nahráš na Modrykonik.sk, môžeš si spustiť tento validátor:

pip install xmlschema lxml

#!/usr/bin/env python
import os.path
import xmlschema
from lxml import etree
tree = etree.parse(os.path.join(os.path.dirname(file), './feed.xml'))
# Validate with schema
xml_schema = xmlschema.XMLSchema11('https://www.modrykonik.sk/xml/market/1.0/modrykonik.xsd')
xml_schema.validate(tree)

Všetky témy > XML import inzerátov