Používáme cookies. Více informací zde.
Zavři

Jaké XML formáty podporujete?

Podporujeme dva XML formáty:

  • Heureka XML formát
  • Modrý koník XML formát (= Heureka rozšířená o kategorie Modrého koníka)

1. Heureka XML formát

Standardním formátem XML feedu v Česku je Heureka. Pokud máš v nastaveních svého e-shopu možnost zapnout XML feed, pravděpodobně bude právě v tomto formátu. Feed ve formátu Heureky můžeš přímo použít pro import inzerátů do bazaru Modrého koníka.

Při prvním importu Heureka XML feedu se pro každý inzerát nahraje:

  • Název
  • Popis
  • Fotky
  • Cena
  • Skladem (ano/ne)
  • URL na konkrétní inzerát ve tvém e-shopu

Následně budeš moci inzerátům ručně přiřadit koníkovské kategorie a vlastnosti přes hromadný "kategorizovač" v Můj bazar.

Ne všechny kategorie zboží, které jsou v Heureka XML feedu, jsou totožné s našimi kategoriemi. Proto je při tomto formátu potřeba inzeráty dotřídit ručně. Přečti si, jak na to.

Při všech dalších importech se aktualizují stejné parametry, jako při prvním importu.

2. Modrý koník XML formát (= Heureka rozšířená o kategorie Modrého koníka)

Pokud inzeráty nechceš kategorizovat ručně nebo chceš mít lepší kontrolu nad tím, co se importuje, můžeš vytvořit feed speciálně pro bazar Modrého koníka. Na to už budeš potřebovat programátora, který vytvoří XML feed podle našeho schématu:
https://www.modrykonik.cz/xml/market/1.0/modrykonik.xsd
Jde o stejnou strukturu jako v případě Heuréka formátu, který je rozšířený o náš vlastní element <mk:category>. Definice elementů z namespace-u mk je v importovaném schématu (modrykonik.xsd - řádek 4):
https://www.modrykonik.cz/xml/market/1.0/modrykonik-extension.xsd

Příklad 1 - Sport pro děti:

<mk:category name ="Sport pro děti Cyklistika">
       <mk:color>Žlutá</mk:color>
       <mk:type>Cykloodrážedla</mk:type>
       <mk:sex>Pro holky</mk:sex>
 </mk:category>

Příklad 2 - Obuv detská:

<mk:category name="Obuv dětská">
         <mk:type>Tenisky</mk:type>
         <mk:size>32</mk:size>
         <mk:sex>Unisex</mk:sex>
         <mk:brand>Deichmann</mk:brand>
         <mk:color>Tmavě zelená</mk:color>
</mk:category>

Při prvním importu Modrý koník XML feedu se pro každý inzerát nahraje:

  • Název
  • Popis
  • Fotky
  • Cena
  • Skladem (ano/ne)
  • URL na konkrétní inzerát ve tvém e-shopu
  • Kategória a vlastnosti v <mk:...>, které jste zadefinovali ve svém XML feedu.

Při všech dalších importech se aktualizuje pouze:

  • Název
  • Popis
  • Fotky
  • Cena
  • Skladem (ano/ne)
  • URL na konkrétní inzerát ve tvém e-shopu

Kategorie a vlastnosti v <mk:...> se už nikdy přes XML feed neaktualizují (jsou ignorované). Je to tak proto, že inzerát mohl být dodatečně ručně přesunutý do vhodnější kategorie, a tu je třeba zachovat. Přesun může udělat sám klient nebo i Modrý koník (v bazaru pravidelně inzeráty kontrolujeme a třídíme do správných kategorií, nebo vznikne nová kategorie apod.).

Můžu si u sebe nějak zvalidovat náš XML feed?

Ano, ještě před tím, než feed nahraješ na Modrykonik.cz, můžeš si u sebe spustit 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šechna témata > XML import inzerátů