--- title: "XML validace" articleId: "xmlValidation" lastEdited: "2025-03-26 13:16 UTC" canonical: https://podpora.shoptet.cz/xml-validace/ breadcrumb: "Shoptet Podpora / Produkty / Správa produktů" language: cs sections: - { title: "Co je XML feed?", level: 2, url: "https://podpora.shoptet.cz/xml-validace/#co-je-xml-feed" } - { title: "K čemu slouží XML validace?", level: 2, url: "https://podpora.shoptet.cz/xml-validace/#k-cemu-slouzi-xml-validace" } - { title: "Jak XML feed ověřit?", level: 2, url: "https://podpora.shoptet.cz/xml-validace/#jak-xml-feed-overit" } - { title: "Co dělat v případě, že feed v pořádku prošel validací?", level: 2, url: "https://podpora.shoptet.cz/xml-validace/#co-delat-v-pripade-ze-feed-v-poradku-prosel-validaci" } - { title: "Co dělat v případě, že feed validací neprošel?", level: 2, url: "https://podpora.shoptet.cz/xml-validace/#co-delat-v-pripade-ze-feed-validaci-neprosel" } - { title: "Seznam validací RELAX NG", level: 2, url: "https://podpora.shoptet.cz/xml-validace/#seznam-validaci-relax-ng" } - { title: "Produkty – specifikace", level: 3, url: "https://podpora.shoptet.cz/xml-validace/#produkty--specifikace" } - { title: "Heureka – specifikace", level: 3, url: "https://podpora.shoptet.cz/xml-validace/#heureka--specifikace" } - { title: "Vzorový soubor", level: 2, url: "https://podpora.shoptet.cz/xml-validace/#vzorovy-soubor" } - { title: "Specifika stahování dodavatelských importů do Shoptet e-shopu", level: 2, url: "https://podpora.shoptet.cz/xml-validace/#specifika-stahovani-dodavatelskych-importu-do-shoptet-e-shopu" } --- # XML validace ## Co je XML feed? Pokud budete chtít napojit váš e-shop například na dodavatelskou firmu, která bude do vašeho e-shopu posílat produkty, potřebujete si od dodavatele vyžádat tzv. XML feed. Jedná se o soubor ve formátu XML, který obsahuje potřebné informace o produktech vašeho dodavatele (cenu, název, obrázky atd.). > **Tip** > > S exportem produktů od dodavatelů vám pomůže doplněk [NapojSe](https://doplnky.shoptet.cz/napojeni-na-dodavatele). XML feed od NapojSe je vždy validní. Exporty od dodavatelů vám sloučí do jednoho souboru a zvládne ještě mnohem víc. Nemusí se jednat jen o soubor od dodavatele. Pokud například provozujete e-shop u jiného poskytovatele a chcete přejít k nám, můžete si produkty z původního e-shopu vyexportovat ve formátu XML (pokud to váš původní poskytovatel nabízí) a jednoduše nahrát do našeho systému. ## K čemu slouží XML validace? Na naše e-shopové řešení napojujeme pouze feedy, které mají níže popsanou strukturu. [Na této stránce](https://www.shoptet.cz/xml-validace/) si můžete zkontrolovat, jestli je váš feed vyhovující a bude možné ho na e-shop napojit. Do e-shopu je také možné nahrát XML feed ve formátu, který podporuje Heureka. Specifikace pro feed od Heureky jsou popsány v článku [Specifikace XML souboru](http://sluzby.heureka.cz/napoveda/xml-feed/). Heureka feed je možné použít pouze pro jednorázový import produktů. Validátor funguje i pro ověření formátu pro Heureku. ## Jak XML feed ověřit? Ve formuláři níže můžete nahrát buď XML soubor, který máte uložený na disku nebo vložit URL adresu feedu do prvního pole. V roletce **Typ XML feedu** nezapomeňte zadat, jestli se jedná o feed dle **specifikace Heureky** nebo o feed dle **specifikace Relax NG** popsané níže. Formulář s validací najdete na stránce [XML Validace](https://www.shoptet.cz/xml-validace/). ## Co dělat v případě, že feed v pořádku prošel validací? Pokud se jedná o jednorázový import, můžete soubor nahrát přímo ve vaší administraci. Stačí zvolit cestu **Produkty → Import** a na této stránce soubor nahrát (obrázek 01). Pokud přecházíte od jiného poskytovatele, můžete také nastavit automatické přesměrování původních URL adres produktů na nové URL adresy, a to přes volbu **Aktivovat přesměrování u změněných URL adres na nové**. Neztratíte tak už získané pozice ve vyhledávačích jako je Google, Seznam atd. V případě, že se jedná dodavatelský feed a produkty na e-shopu podle něj chcete pravidelně aktualizovat, pokračujte dále podle návodu ve článku [Automatické importy produktů](https://podpora.shoptet.cz/automaticke-importy-produktu/). ![Obrázek 01](https://res.cloudinary.com/shoptet/image/upload/podpora/contents/cz/8054022957970-01-import-produktu.png) ## Co dělat v případě, že feed validací neprošel? Jestliže váš XML feed neprošel ověřením, nepůjde do e-shopu nahrát. V takovém případě bude třeba nechat feed externě upravit. Můžete se obrátit na vašeho vlastního programátora. Pokud žádného nemáte, můžete se obrátit na některého z našich [externích partnerů](https://partneri.shoptet.cz/profesionalove/programovani/). Spolupracujeme s profesionály, kteří jsou s naším systémem obeznámeni a podobné úpravy nabízejí. ## Seznam validací RELAX NG Níže jsou uvedené specifikace pro vašeho programátora, tedy jak by měla struktura obou typů feedů vypadat. ### Produkty – specifikace 1. [RELAX NG datové typy](https://www.shoptet.cz/export/schema/products-datatype-v10.rng). 2. [RELAX NG specifikace dodavatelský](https://www.shoptet.cz/export/schema/products-supplier-v10.rng). 3. [RELAX NG specifikace kompletní](https://www.shoptet.cz/export/schema/products-complete-v10.rng). * Obrázky k variantám se zadávají dovnitř elementu `` jako `url obrázku`. ### Heureka – specifikace 1. [RELAX NG datové typy](https://www.shoptet.cz/export/schema/heureka-datatype-v10.rng). 2. [RELAX NG specifikace](https://www.shoptet.cz/export/schema/heureka-complete-v10.rng). ## Vzorový soubor * [XML vzorový dodavatelský import](https://www.shoptet.cz/user/documents/VariantItem.xml). ## Specifika stahování dodavatelských importů do Shoptet e-shopu > **Tip** > > Pokud jste rozhodnuti pro implementaci XML feedu od dodavatele, doporučujeme pročíst si níže uvedené body: * Každý obrázek musí mít unikátní název. V URL adrese nelze použít jako znak *mezeru*. Je třeba ji zapsat jako znak *%20*. * Zvažte délku kódu produktu. Na e-shopu podporujeme délku kódu 64 znaků, nicméně pokud budete používat inzerci na Heurece, ta podporuje pro kód produktu pouze 36 znaků. V ideálním případě tedy zadávejte kódy kratší než 36 znaků. * Povolené znaky pro kód produktu na e-shopu jsou následující: *A–Z*, *0–9,* *\_ / -. mezera*. * Položky je možné párovat s existujícími položkami na e-shopu podle kódu a v případě funkce [Automatický import](https://doplnky.shoptet.cz/automaticky-import-produktu) i podle EAN kódu. * Je třeba, aby produkty měly unikátní název. Pokud je v importu více produktů s variantami se shodným názvem, nahrají se varianty pod jeden produkt. I když se produkty párují hlavně podle kódu, název je částečně součástí párovacího mechanismu. * Na e-shop jsou nahrávány všechny produkty, které jsou obsažené ve feedu. Pokud z feedu některá položka zmizí, můžete si v případě funkce [Automatický import](https://doplnky.shoptet.cz/automaticky-import-produktu) zvolit, jestli: + se má na e-shopu skrýt, + má být zcela smazána, + s ní nechcete nic dělat. * Pokud chcete na e-shopu u produktů nahraných z feedu některé informace upravovat ručně přes administraci, následné stažení dodavatelského importu vám je přepíše informacemi z feedu. V případě funkce [Automatický import](https://doplnky.shoptet.cz/automaticky-import-produktu) je možné však některé položky z aktualizace vyloučit. + Pokud tedy například budete chtít upravovat ceny u produktů, po prvotním nahrání feedu vynechte ceny z aktualizace. Můžete si je ručně upravit a import vám je nepřepíše, aktualizuje pouze ostatní informace o produktu. * Feed nesmí obsahovat více než 20 000 položek. Jako 1 položka je počítán 1 produkt. Jinak může dojít k potížím s jeho nahráváním a v takových případech bude feed deaktivován.