Import produktů do Shoptetu bez chyb

Shoptet importuje produkty z CSV (v kódování UTF-8 nebo Windows-1250) a z XLSX. Soubor musí mít úplně vlevo sloupce code, pairCode a name, varianty jednoho produktu musí jít za sebou a prázdný řádek import ukončí. Nástroj níže zkontroluje celý soubor podle pravidel Shoptetu a opraví, co se dá opravit bezpečně.

Pravidla ověřena

Opravuje se ve vašem prohlížeči – soubor nikdy neopustí vaše zařízení.

Soubory nad 50 řádků: 1 kredit za soubor ($0.75–$1 podle balíčku), bez předplatného · Ceník

Více souborů? Vyberte nebo přetáhněte je najednou a opravte všechny najednou.

Nemáte soubor po ruce? Vyzkoušejte rozbitý vzorek

Vzorové soubory s typickými chybami importu, načtou se ve vašem prohlížeči. Oprava i stažení jsou zdarma.

Proč to vzniká

Shoptet importuje po dávkách po 100 produktech. Když narazí na chybu, dávky před ní zůstanou uložené a zbytek se nenaimportuje. Výsledkem je napůl aktualizovaný katalog, ve kterém se chyba špatně hledá.

Shoptet nezveřejňuje přesné znění chybových hlášek, pouze pravidla. Tato stránka proto vychází z jeho dokumentace importu a exportu produktů: co musí soubor obsahovat a co import zastaví.

Jak to opravit ručně

Před importem

  1. Jako šablonu použijte export z vlastního e-shopu (Produkty → Export, vlastní typ „Kompletní“ ve formátu XLSX). Vzorový soubor Shoptet nezveřejňuje.
  2. Sloupce code, pairCode a name nechte na začátku, před ostatními sloupci.
  3. U nových produktů vyplňte price.
  4. Smažte prázdné řádky a vzorce v XLSX nahraďte hodnotami.

Opravte to automaticky

  • Rozpozná kódování (UTF-8, Windows-1250) a oddělovač.
  • Přesune code, pairCode a name na začátek.
  • Zkontroluje code: jedinečnost, nejvýše 64 znaků, povolené znaky a předponu $ z exportu.
  • Seřadí varianty se stejným pairCode za sebe a doplní chybějící pairCode.
  • Odstraní prázdné řádky, které by import ukončily.
  • Zkontroluje délky textů, hodnoty 0/1, data, EAN, obrázky a textProperty.
  • Uloží CSV ve Windows-1250 nebo UTF-8, případně XLSX.

Kontrola a náhled jsou zdarma. Stažení je zdarma do 50 řádků, větší soubor stojí 1 kredit.

Vybrat soubor

Soubor se načte a opraví přímo ve vašem prohlížeči. Nic se nenahrává: k nám jde jen počet řádků a platforma, takže nákupní ceny i údaje zákazníků zůstanou soukromé.

Časté problémy a jejich řešení

Povinné sloupce code, pairCode a name

Každý importní soubor musí obsahovat sloupce code, pairCode a name a ty musí být úplně vlevo, před ostatními sloupci. Pokud jsou jinde, nástroj je přesune na začátek beze změny obsahu.

code je katalogové číslo produktu: jedinečné, nejvýše 64 znaků, povolená jsou písmena A-Z, číslice, znaky _ \ / - a mezera. Export ze Shoptetu někdy přidá před kód znak $, ten před importem odstraňte. Pokud posíláte produkty i na Heureku, držte kód do 36 znaků.

Zkontrolovat můj soubor

pairCode a varianty

pairCode spojuje varianty jednoho produktu: řádky se stejným pairCode jsou jeden produkt. Smí obsahovat jen písmena A-Z a číslice. Řádek se sloupci variant:… bez pairCode Shoptet neumí přiřadit k produktu.

Řádky se stejným pairCode musí jít hned za sebou. Varianta, která je v souboru jinde, se naimportuje jako samostatný, duplicitní produkt. Nástroj varianty seřadí k sobě a chybějící pairCode doplní.

Zkontrolovat můj soubor

Rozsypaná diakritika a kódování

Shoptet přijme CSV v kódování UTF-8 nebo Windows-1250. Rozsypaná diakritika (ÄŤ, š místo č, š) znamená, že soubor byl uložen v jednom kódování a přečten v jiném, někdy i několikrát po sobě.

Nástroj rozpozná, v jakém kódování soubor je, opraví rozsypané znaky a uloží ho v kódování, které si vyberete. Soubory XLSX tento problém nemají.

Zkontrolovat můj soubor

Import se zastavil nebo nenaimportoval všechno

Prázdný řádek Shoptet považuje za konec souboru: vše pod ním ignoruje. Nástroj prázdné řádky uprostřed souboru najde a odstraní.

Nová verze importu se zastaví, když text překročí maximální délku (například name 250 znaků, appendix 150, seoTitle 255), a přeskočí produkty s duplicitním code nebo EAN. Vzorce v XLSX Shoptet nepodporuje, nástroj je nahradí hodnotami.

Pozor: v nové verzi importu prázdná buňka znamená „neměnit“. Hodnotu v e-shopu tedy prázdnou buňkou nesmažete.

Zkontrolovat můj soubor

XML feed neprošel validací

Shoptet importuje i XML, ve vlastním formátu nebo ve formátu Heureky, a ověřuje ho podle svých schémat RELAX NG. Feed smí mít nejvýše 20 000 položek. Nejčastější chyby: znak & nezapsaný jako &, HTML entita jako  , element, který schéma nezná, chybějící CODE nebo EAN, cena s čárkou nebo měnou a kódování, které nesedí s hlavičkou souboru.

Nástroj zkontroluje XML podle stejných schémat, která Shoptet zveřejňuje, a ukáže každou chybu s číslem řádku. Feed pak převede na CSV pro import produktů: varianty dostanou společný pairCode, ceny s DPH nastaví includingVat a na převedený soubor se použijí všechny kontroly a opravy z této stránky. Opravené XML nástroj nevytváří.

Zkontrolovat můj soubor

Časté dotazy

Jaké kódování má mít CSV pro Shoptet?

UTF-8 nebo Windows-1250. Excel na českých Windows ukládá „CSV“ ve Windows-1250 se středníkem, a to Shoptet přijme. Problém vzniká, když se soubor mezitím otevře a uloží v jiném kódování. U XLSX kódování řešit nemusíte.

Je u nového produktu povinná cena?

Ano. price je u nových produktů povinná, jako nezáporné číslo bez symbolu měny.

Umí nástroj zkontrolovat XML feed?

Ano, ve formátu Shoptetu i Heureky. Zkontroluje ho podle schémat Shoptetu a limitu 20 000 položek a převede ho na CSV pro import produktů. Prvky, pro které CSV nemá sloupec (například FLAGS nebo PRICELISTS), vypíše, aby nic nezmizelo potichu.

Nahraje se můj soubor někam?

Ne. Soubor se načte, zkontroluje a opraví ve vašem prohlížeči. Při placeném stažení se odešle jen počet řádků, platforma a otisk souboru (SHA-256), abyste za stejný soubor neplatili dvakrát.

Kolik to stojí?

Kontrola souboru a náhled oprav jsou zdarma. Stažení opraveného souboru je zdarma do 50 řádků. Větší soubor stojí 1 kredit a 24 hodin si ho můžete znovu stáhnout v jiném formátu nebo kódování bez dalšího poplatku. Předplatné nepotřebujete; agentury, které opravují soubory každý měsíc, si mohou zvolit Pro: 300 souborů měsíčně za $19.