• Docs
• Nastavenia
• Hgimport Bluegastro
• Ellipse - Bluegastro import položiek a receptúr

Ellipse - Bluegastro import položiek a receptúr

Hgimport Bluegastro

Táto obrazovka slúži na import skladových položek, surovín, receptúr a jedál z externého systému Blue Gastro vo formáte XML. Použiješ ju vtedy, keď potrebuješ preniesť dáta z Blue Gastro do Ellipse Cloud — napríklad pri prvotnom nastavení systému alebo pri aktualizácii skladových kariet a receptúr z externého účtovného softvéru.

Kde to nájdeš

V ľavom menu klikni na Nastavenia → Hgimport Bluegastro. Adresa v prehliadači bude /manager/settings/hgimport_bluegastro/. Obrazovka nemá vnútorné záložky — celý import prebieha na jednej stránke v troch krokoch: nahratie XML súboru, náhľad dát a potvrdenie importu.

Čo tu môžeš robiť

• Nahrať XML súbor z počítača: Klikneš na „vybrať súbor", zvolíš XML export z Blue Gastro a systém ti zobrazí náhľad dát pred importom.
• Zadať cestu k XML súboru na serveri: Ak máš XML uložené priamo na serveri, zadáš cestu do poľa „Alebo cesta na serveri" a klikneš „Načítať XML". Systém načíta súbor bez nahrávania.
• Priradiť kategórie k skladom: V náhľade dát pri každej skladovej kategórii zvolíš, do ktorého skladu sa majú položky importovať (napr. Sklad 1, Bar, Kuchyňa).
• Skontrolovať náhľad skladových položiek: Systém ti zobrazí tabuľku všetkých surovín a položiek, ktoré sa importujú — vidíš názov, kategóriu, jednotku, DPH a počet EAN kódov.
• Skontrolovať náhľad jedál a receptúr: V druhej tabuľke vidíš zoznam jedál/receptúr s počtom porcií, kategóriou a DPH. Každá receptúra obsahuje zoznam surovín s množstvami.
• Potvrdiť a spustiť import: Po kontrole klikneš „Potvrdiť a importovať" a systém vytvorí skladové karty, položky a receptúry v Ellipse Cloud.

Postup krok za krokom

1. Otvor záložku Nastavenia → Hgimport Bluegastro v ľavom menu.
2. Klikni na tlačidlo „vybrať súbor" a vyber XML export z Blue Gastro (obvykle súbor s názvom ExportTovarJedlo.xml). Ak máš súbor na serveri, zadaj cestu do poľa „Alebo cesta na serveri" (napr. /var/www/.../ExportTovarJedlo.xml) a klikni „Načítať XML".
3. Skontroluj tabuľku „Priradenie kategórií k skladom" — pri každej kategórii (napr. „Mäso", „Zelenina") vyber zo zoznamu, do ktorého skladu sa majú položky importovať. Ak máš len jeden sklad, nechaj predvolené nastavenie.
4. Prezri si tabuľku „Skladové položky" — vidíš zoznam všetkých surovín, ktoré sa importujú (názov, kategória, jednotka, DPH). Skontroluj, či sa dáta načítali správne.
5. Prezri si tabuľku „Jedlá / Receptúry" — vidíš zoznam jedál s počtom porcií a kategóriou. Rozklikni si niektorú receptúru a skontroluj, či obsahuje správne suroviny a množstvá.
6. Klikni na tlačidlo „Potvrdiť a importovať" v spodnej časti stránky. Systém vytvorí skladové karty, položky, EAN kódy a receptúry. Po dokončení sa zobrazí hlášku „Import bol vykonaný." a štatistiku (koľko položiek sa pridalo, aktualizovalo atď.).

Polia, stĺpce a nastavenia

• XML súbor (tlačidlo „vybrať súbor"): Slúži na nahratie XML exportu z Blue Gastro z tvojho počítača. Systém akceptuje len súbory vo formáte XML — ak nahráš iný typ súboru, zobrazí sa chyba „Vyberte XML súbor pre import. Nahraný súbor nie je XML."
• Alebo cesta na serveri (textové pole): Ak máš XML súbor uložený priamo na serveri (napr. v priečinku /var/www/), zadaj sem celú cestu k súboru. Po kliknutí na „Načítať XML" systém načíta súbor bez nahrávania. Toto pole použiješ vtedy, keď máš veľký XML súbor alebo keď ti ho niekto nahrá priamo na server cez FTP.
• Priradenie kategórií k skladom (rozbaľovací zoznam pri každej kategórii): V tabuľke vidíš všetky skladové kategórie z XML (napr. „Mäso", „Zelenina", „Nápoje") a počet položiek v každej kategórii. Pri každej kategórii vyber zo zoznamu, do ktorého skladu sa majú položky importovať (napr. Sklad 1, Bar, Kuchyňa). Toto nastavenie určuje, v ktorom sklade sa budú položky zobrazovať a evidovať.
• Číslo (stĺpec v tabuľke kategórií): Externé číslo kategórie z Blue Gastro (napr. 1, 2, 3). Toto číslo slúži len na identifikáciu kategórie pri importe — v Ellipse Cloud sa neukladá.
• Názov kategórie (stĺpec v tabuľke kategórií): Názov skladovej kategórie z Blue Gastro (napr. „Mäso a údeniny", „Zelenina čerstvá"). Systém vytvorí v Ellipse Cloud skladové kategórie s týmito názvami. Ak kategória s rovnakým názvom už existuje, systém ju použije a nevytvorí duplicitu.
• Položiek (stĺpec v tabuľke kategórií): Počet skladových položiek (surovín), ktoré patria do danej kategórie. Napríklad ak vidíš „Mäso (15)", znamená to, že sa importuje 15 rôznych druhov mäsa.
• Sklad (rozbaľovací zoznam v tabuľke kategórií): Tu vyberáš, do ktorého skladu sa majú položky z danej kategórie importovať. Zoznam obsahuje všetky sklady, ktoré máš nastavené v systéme (napr. Sklad 1, Bar, Kuchyňa). Ak máš len jeden sklad, nechaj predvolené nastavenie.
• ID (stĺpec v tabuľke skladových položiek): Externé ID položky z Blue Gastro. Toto číslo slúži len na identifikáciu pri importe — v Ellipse Cloud sa neukladá.
• Názov (stĺpec v tabuľke skladových položiek): Názov suroviny alebo skladovej položky (napr. „Bravčové mäso", „Mrkva čerstvá", „Pivo Zlatý Bažant 0,5l"). Systém vytvorí skladovú kartu a položku s týmto názvom. Ak položka s rovnakým názvom už existuje na danom sklade, systém ju aktualizuje namiesto vytvorenia duplicity.
• Kategória (stĺpec v tabuľke skladových položiek): Názov skladovej kategórie, do ktorej položka patří (napr. „Mäso", „Zelenina"). Toto je kategória z Blue Gastro — systém ju priradí k položke podľa mapovania, ktoré si nastavil v tabuľke „Priradenie kategórií k skladom".
• JM (stĺpec v tabuľke skladových položiek): Jednotka merania položky (napr. KG, LT, KS). Systém automaticky rozpozná typ jednotky: KG = hmotnosť, LT/L = objem, KS/FL/PO/BA = kusy. Táto jednotka sa použije pri evidencii príjmov a výdajov na sklade.
• DPH (stĺpec v tabuľke skladových položiek): Sadzba DPH v percentách (napr. 20, 10, 0). Systém priradí položke správnu DPH sadzbu podľa tvojho nastavenia v Ellipse Cloud. Ak sadzba neexistuje, položka sa vytvorí bez DPH a musíš ju doplniť manuálne.
• DPT (stĺpec v tabuľke skladových položiek): Názov predajnej kategórie z Blue Gastro (napr. „Potraviny", „Nápoje"). Toto pole sa používa pri importe receptúr — systém vytvorí predajné kategórie pre jedlá podľa týchto názvov.
• ID (stĺpec v tabuľke jedál/receptúr): Externé ID receptúry z Blue Gastro. Slúži len na identifikáciu pri importe.
• Názov (stĺpec v tabuľke jedál/receptúr): Názov jedla alebo receptúry (napr. „Guláš hovädzi", „Šalát grécky", „Pizza Margherita"). Systém vytvorí kalkuláciu (receptúru) s týmto názvom. Ak kalkulácia s rovnakým názvom už existuje, systém ju aktualizuje.
• Kategória (stĺpec v tabuľke jedál/receptúr): Názov predajnej kategórie, do ktorej jedlo patrí (napr. „Hlavné jedlá", „Dezerty", „Šaláty"). Systém vytvorí predajnú kategóriu s týmto názvom, ak ešte neexistuje. Táto kategória sa použije v pokladni pri predaji jedla.
• JM (stĺpec v tabuľke jedál/receptúr): Jednotka merania receptúry (napr. PO = porcia, KS = kus). Táto jednotka určuje, v čom sa receptúra predáva.
• DPH (stĺpec v tabuľke jedál/receptúr): Sadzba DPH pre jedlo v percentách (napr. 20, 10). Systém priradí receptúre správnu DPH sadzbu.
• Porcií (stĺpec v tabuľke jedál/receptúr): Počet porcií, na ktoré je receptúra kalkulovaná (napr. 1, 10, 50). Tento koeficient určuje, koľko porcií sa vyrobí z množstiev surovín uvedených v receptúre. Napríklad ak je receptúra na 10 porcií a obsahuje 2 kg mäsa, jedna porcia obsahuje 0,2 kg mäsa.
• Tlačidlo „Načítať XML": Po zadaní cesty k XML súboru na serveri klikni na toto tlačidlo — systém načíta súbor a zobrazí náhľad dát. Ak cesta nie je správna alebo súbor neexistuje, zobrazí sa chybové hlášenie.
• Tlačidlo „Potvrdiť a importovať": Po kontrole náhľadu dát klikni na toto tlačidlo v spodnej časti stránky. Systém spustí import — vytvorí skladové kategórie, karty, položky, EAN kódy a receptúry. Import môže trvať niekoľko sekúnd až minút v závislosti od veľkosti XML súboru. Po dokončení sa zobrazí štatistika (koľko položiek sa pridalo, aktualizovalo, koľko chýb sa vyskytlo).

Tipy a časté chyby

• Chyba „Nepodarilo sa nahrať súbor importu. Skontrolujte práva na zápis do priečinka temp.": Táto chyba znamená, že systém nemôže zapísať nahraný XML súbor do dočasného priečinka na serveri. Kontaktuj administrátora servera a požiadaj ho o nastavenie práv na zápis do priečinka temp. Alternatívne môžeš použiť pole „Alebo cesta na serveri" a zadať priamu cestu k XML súboru.
• Pred importom si vždy skontroluj priradenie kategórií k skladom: Ak máš viac skladov (napr. Sklad 1, Bar, Kuchyňa), dôkladne si prezri tabuľku „Priradenie kategórií k skladom" a pri každej kategórii vyber správny sklad. Napríklad kategóriu „Nápoje" priradíš k Baru, kategóriu „Mäso" k Sklad 1. Ak toto nastavenie preskočíš, všetky položky sa importujú do predvoleného skladu a potom ich musíš manuálne presúvať.
• Systém nevytvára duplicitné položky: Ak skladová položka s rovnakým názvom už existuje na danom sklade, systém ju aktualizuje namiesto vytvorenia novej. To znamená, že môžeš import spustiť viackrát bez obáv z duplicít. Pozor však — ak zmeníš priradenie kategórie k skladu, systém vytvorí novú položku na inom sklade (lebo kontroluje názov + sklad).
• EAN kódy sa importujú automaticky: Ak XML súbor obsahuje EAN kódy (čiarové kódy) pre skladové položky, systém ich automaticky vytvorí a priradí k skladovým kartám. Ak EAN kód už existuje v systéme, systém ho aktualizuje a priradí k novej karte. Toto je užitočné pri práci so skenerom čiarových kódov na sklade.
• Receptúry sa importujú ako kalkulácie: Jedlá a receptúry z Blue Gastro sa v Ellipse Cloud vytvárajú ako kalkulácie (register_sets). Každá kalkulácia obsahuje zoznam surovín s množstvami a koeficient (počet porcií). Po importe môžeš kalkulácie upraviť v záložke Sklad → Kalkulácie — napríklad zmeniť suroviny, množstvá alebo predajnú cenu.
• Predajné kategórie sa vytvárajú automaticky: Systém automaticky vytvorí predajné kategórie (napr. „Hlavné jedlá", „Dezerty") podľa dát z XML súboru. Tieto kategórie sa zobrazia v pokladni pri predaji jedál. Ak kategória s rovnakým názvom už existuje, systém ju použije a nevytvorí duplicitu. Po importe si môžeš kategórie upraviť v záložke Nastavenia → Kategórie.
• Skontroluj DPH sadzby pred importom: Systém priradí položkám a receptúram DPH sadzby podľa tvojho nastavenia v Ellipse Cloud (Nastavenia → DPH). Ak v XML súbore je DPH sadzba, ktorú nemáš nastavenú (napr. 15 %), systém vytvorí položku bez DPH a musíš ju doplniť manuálne. Preto si pred importom skontroluj, či máš všetky potrebné DPH sadzby nastavené.
• Import môže trvať niekoľko minút: Ak importuješ veľký XML súbor (napríklad 1000+ položiek a 500+ receptúr), import môže trvať niekoľko minút. Počas importu sa nezobrazuje progress bar — systém len pracuje na pozadí. Nevypínaj prehliadač a neopúšťaj stránku, kým sa nezobrazí hlásenie „Import bol vykonaný." a štatistika.