Import a hromadná aktualizace položek
Produkt: Smable Backoffice · Aktualizováno: 2026-08-11
Smable umožňuje hromadný import dat z CSV/Excel souborů nebo XML feedů. Tato příručka vás provede celým procesem importu krok za krokem.
Obsah
CSV Import z CSV / Excel
CSV import je ideální pro hromadné nahrání produktů, skladových karet, zákazníků nebo receptur z tabulkového procesoru (Excel, Google Sheets, LibreOffice Calc).
Jak na to:
1
Přejděte na Import
V menu zvolte **Import dat** → **Excel / CSV import**
2
Vyberte typ dat
Zvolte, co chcete importovat: produkty, skladové karty, zákazníky nebo receptury.
3
Nahrajte soubor
Přetáhněte CSV nebo Excel soubor do vyznačené oblasti, nebo klikněte pro výběr souboru.
**Tip:** Soubor musí být ve formátu CSV (s oddělovačem čárka nebo středník) nebo XLSX/XLS.
4
Namapujte sloupce
Přiřaďte sloupce z vašeho souboru k polím ve Smable. Systém se pokusí automaticky rozpoznat sloupce podle názvů.
5
Zkontrolujte a potvrďte
Prohlédněte si náhled dat a klikněte na **Importovat**. Po dokončení uvidíte souhrn importovaných položek.
Formát CSV souboru
Doporučený formát pro CSV soubor:
- Kódování: UTF-8 (pro správné zobrazení diakritiky)
- Oddělovač: Čárka (,) nebo středník (;)
- První řádek: Názvy sloupců (hlavička)
Příklad CSV souboru pro produkty:
`
nazev;kod;cena;dph;popis
Espresso;ESP001;45;21;Silná káva
Cappuccino;CAP001;55;21;Káva s mlékem
Cheesecake;CHE001;75;15;Tvarohový dort `
XML Import z XML feedu
XML import je vhodný pro napojení na e-shopové feedy, velkoobchodní katalogy nebo jiné systémy, které poskytují data ve formátu XML.
Dva způsoby importu:
Z URL adresy
Zadejte URL adresu XML feedu. Smable stáhne data automaticky. Ideální pro pravidelně aktualizované feedy.
Ze souboru
Nahrajte XML soubor z vašeho počítače. Vhodné pro jednorázový import nebo offline data.
Postup XML importu:
1
Zadejte zdroj XML
Vložte URL adresu feedu nebo nahrajte XML soubor.
2
Vyberte opakující se element
Systém zobrazí strukturu XML. Klikněte na element, který představuje jednotlivé položky (např. `<SHOPITEM>` nebo `<product>`).
3
Namapujte elementy
Přiřaďte XML elementy k polím ve Smable. Můžete mapovat i vnořené elementy a atributy.
4
Zkontrolujte a importujte
Prohlédněte si náhled a potvrďte import.
Typy importovaných dat
Produkty
Položky v pokladně - jídla, nápoje, zboží k prodeji.
**Povinná pole:** Název, Cena
**Volitelná pole:** Kód produktu, DPH, Popis, Kategorie, Obrázek
Skladové karty
Suroviny a materiál pro sledování skladových zásob.
**Povinná pole:** Název, Kód
**Volitelná pole:** Jednotka, Množství, Nákupní cena, Kategorie, Dodavatel
Zákazníci
Databáze zákazníků pro věrnostní program a faktury.
**Povinná pole:** Jméno nebo Firma
**Volitelná pole:** E-mail, Telefon, Adresa, IČO, DIČ, Sleva
Receptury
Propojení produktů se skladovými kartami pro automatický odpis.
**Povinná pole:** Kód produktu, Kód skladové karty, Množství
**Formát:** Každý řádek = jedna ingredience receptury
Mapování sloupců
Při importu je potřeba propojit sloupce z vašeho souboru s poli v systému Smable:
Automatické rozpoznání Systém automaticky rozpozná sloupce podle běžných názvů. Pokud váš soubor obsahuje sloupce jako "nazev", "name", "cena", "price" apod., budou automaticky přiřazeny.
Běžné názvy sloupců pro produkty:
Pole ve Smable Rozpoznané názvy sloupců
Název nazev, name, název, product_name, PRODUCTNAME
Kód produktu kod, code, sku, item_id, EAN, čárový_kód
Cena cena, price, cena_s_dph, PRICE_VAT
DPH dph, vat, tax, sazba_dph
Popis popis, description, DESCRIPTION
Tipy a doporučení
Před importem zálohujte
Před hromadným importem doporučujeme provést export stávajících dat pro případ, že byste potřebovali obnovit původní stav.
Aktualizace existujících položek
Pokud importujete položky se stejným kódem, systém je aktualizuje místo vytváření duplicit. Pro čistý import nových položek použijte unikátní kódy.
Formát čísel
Ceny a množství zadávejte jako čísla bez měny (správně: `45.50`, špatně: `45,50 Kč`). Jako desetinný oddělovač použijte tečku.
Testovací import
U velkých souborů doporučujeme nejprve vyzkoušet import s několika řádky, abyste ověřili správnost mapování.
Maximální velikost
Maximální velikost nahrávaného souboru je 10 MB. Pro větší soubory doporučujeme rozdělit data do více menších souborů.
Časté problémy a jejich řešení
Špatně zobrazená diakritika (háčky, čárky)
Ujistěte se, že váš soubor je uložen v kódování **UTF-8**. V Excelu při ukládání jako CSV vyberte "CSV UTF-8 (oddělený čárkami)".
Data jsou v jednom sloupci místo více sloupců
Zkontrolujte oddělovač v CSV souboru. Systém automaticky detekuje čárku nebo středník. Pokud používáte jiný oddělovač, upravte soubor.
Import se nezdařil - chyba při zpracování
Zkontrolujte, zda soubor neobsahuje neplatné znaky nebo prázdné řádky. Ujistěte se, že povinná pole (název, cena) nejsou prázdná.
XML feed nelze načíst z URL
Ověřte, že URL je veřejně přístupná (není chráněná heslem). Zkuste URL otevřít v prohlížeči. Pokud stránka vyžaduje přihlášení, stáhněte XML soubor a nahrajte ho ručně.