Import a hromadná aktualizace položek – Smable nápověda

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

Import z CSV / Excel
Import z XML feedu
Typy importovaných dat
Mapování sloupců
Tipy a doporučení

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:

Přejděte na Import

V menu zvolte Import dat → Excel / CSV import

Vyberte typ dat

Zvolte, co chcete importovat: produkty, skladové karty, zákazníky nebo receptury.

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.

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ů.

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:

Zadejte zdroj XML

Vložte URL adresu feedu nebo nahrajte XML soubor.

Vyberte opakující se element

Systém zobrazí strukturu XML. Klikněte na element, který představuje jednotlivé položky (např. <SHOPITEM> nebo <product>).

Namapujte elementy

Přiřaďte XML elementy k polím ve Smable. Můžete mapovat i vnořené elementy a atributy.

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ě.