Samoobslužný kiosk - Popis

Cílová skupina: majitel / provozovatel obchodu (nasazení a konfigurace kiosku), vedoucí provozu (běžný dohled), obsluha (výjimky). Rozsah: všechny způsoby, jak se kiosk dá použít, a všechny funkce, které se dají zapnout/vypnout. Kiosk = samoobslužné zařízení, kde si zákazník objednává a platí bez obsluhy.

1. Co je kiosk a kdy ho použít

Kiosk je samostatné dotykové zařízení (obvykle 10–15") postavené na stejném backendu jako běžná pokladna. Zákazník na něm:

vybere, co chce (režim práce kiosku — viz kapitola 3),
vybere produkty (kategorie → položky, případně skenerem čárového kódu),
zvolí způsob platby (viz kapitola 5),
dostane potvrzení a hotovou objednávku v systému pokladny.

Kiosk tedy nenasazuje všechny obchody stejně – je to univerzální terminál, jehož chování se nastavuje. Typické důvody, proč obchod kiosku používá:

Důvod	Co to řeší
Rychlé odbavení v hodinu špičky	Zákazník si objedná a zaplatí sám, obsluha jen vydává.
Obsluha nepotřebuje umět s kasou	Obchod, kde je obsluha často student nebo brigádník.
Objednávky z jazykové ciziny	Kiosk umí přepínat jazyk vlajkou.
Vlastní „vstupní obrazovka“ do provozovny	Kiosk může sloužit jako recepce, vstupenky, parkování, výdej objednávek.
Zákazník si chce objednat z mobilu	Kiosk umí vyhledat a vyzvednout objednávku z e-shopu podle čísla.

Kde se kiosk zapne

Kiosk je součástí aplikace KASA FIK Pokladna. V hlavní obrazovce je tlačítko „Samoobslužný Kiosk“ (v záhlaví obrazovky). Obsluha ho spustí kliknutím – aplikace přejde na kiosk obrazovku a čeká na zákazníka. Po dokončení (nebo přes PIN) se kiosk vrátí zpět na hlavní obrazovku pokladny.

Režim běhu zařízení se řídí nastavením Výchozí režim zobrazení (Nastavení → Rozšířená nastavení → Výchozí režim zobrazení):

Hodnota	Význam
`kiosk`	Kiosk v režimu samoobslužné objednávky (produkty z katalogu, doplňky, platba).
`self_service`	Kiosk u stolu – navíc se automaticky přidávají položky s příznakem „S“ (doplňky ke stolu).
`unattended_pay`	Bezobslužní platba (automat) – jde o jinou obrazovku než kiosk, zde jen pro rozlišení.
`original` / `plus_extra` / `customer_display`	Běžné režimy pokladny – kiosk se nespouští.

Tip pro provoz: Tlačítko kiosku lze na hlavní obrazovce skrýt (kiosk_hide), pokud chcete, aby kiosk spouštěl jen obsluha přes PIN.

2. Průběh práce s kioskem (obecně)

Úvodní obrazovka – logo, video nebo obrázek obchodu + volba režimu práce (tlačítka) a přepínač jazyka.
Režim práce – podle zvoleného režimu se zobrazí obrazovka pro danou činnost (objednávka, ubytování, parkování, vstupenky…).
Výběr zákazníka (volitelně) – přiložením karty (čipová / NFC), naskenováním karty zákazníka, nebo ručním vyplněním formuláře.
Výběr produktů – carousel kategorií + mřížka položek, případně skener čárového kódu / PLU.
Souhrn objednávky – přehled položek, spropitné, doplňkové nabídky, volba platby.
Platba – karta, hotovost, zákaznický účet apod.
Potvrzení – hláška „Odesláno – děkujeme za nákup“ s automatickým návratem na úvodní obrazovku.

Doplňkové obslužné prvky na obrazovce

Prvek	Funkce	Kdy se zobrazí
Tlačítko jazyka (vlajka)	Přepnutí jazyka rozhraní i textů tlačítek.	Vždy, pokud je v konfiguraci více než jeden jazyk.
Stav zák. konta	Zákazník přiloží kartu a uvidí historii svého účtu (úhrady po měsících).	Když je zapnutá funkce `ACCOUNT_BALANCE_CHECK`.
Zavolat obsluhu	Na obrazovku se zobrazí „Požadavek odeslán“, obsluha se dostaví.	Když je zapnutá funkce `CALLBACK_SERVICE`.
Zrušit	Zrušení rozpracované objednávky (s potvrzovacím dialogem).	Při rozpracované objednávce.
Označení jazyka změněno	Krátká hláška potvrzující změnu jazyka.	Po přepnutí jazyka.

Automatické ukončení relace

Po nulové aktivitě (default 120 s, konfigurovatelné) se zobrazí dialog „Stále jste tu?“ s tlačítkem Pokračovat.
Pokud zákazník nereaguje, objednávka se zruší a kiosk se vrátí na úvodní obrazovku.
Kiosk tak nikdy „nevisí“ a nezablokuje se.
Každý dotyk (i průjezd myší, sken, přidání položky) časovač resetuje.

Návrat obsluhy / skrytý PIN

Pokud potřebujete z kiosku odejít (např. chcete obsluze vysvětlit objednávku), lze:

6× rychle klepnout na logo na úvodní obrazovce, nebo
naskenovat čárový kód 88950284, nebo
použít master PIN (802298 / 80229800, případně vlastní nastavený v back office).

Kiosk pak otevře PIN obrazovku a po úspěšném zadání se vrátí na hlavní obrazovku pokladny.

3. Režimy práce kiosku – „k čemu mi kiosk chce být“

Režim se v konfiguraci udává jako delivery options (seznam). Na úvodní obrazovce se z něj vykreslí tlačítka (max. 4); každý režim otevře jinou obrazovku. Jednotlivé režimy lze kombinovat i vypnout – např. v restauraci může být jen „Tady“ a „S sebou“, v hotelu jen „Ubytovat se“ a „Vstupenky“.

3.1 Objednávky zboží a jídla

Režim	Kdy se použije	Co zákazník vidí
Tady (DINE_IN)	Restaurace, jídelna – zákazník zůstává u stolu.	Katalog kategorií → položky, objednávka se tvoří pro stůl.
S sebou (TAKE_OUT)	Restaurace s odnosem, fast food, bistro.	Stejné jako „Tady“, objednávka se bere s sebou.
Nákup v obchodě (GROCERIES)	maloobchod – zákazník si sám nakupuje z regálu.	Katalog zboží podle kategorií, prázdná hotovost na konci (pokladna). Režim je v této verzi rozpracovaný.
Vstupenky (TICKETS)	Divadelní / koncertní / sportovní vstupenky.	Počet dospělých a dětí (+/−), všechno jako jedna položka „Ticket“.
Vyzvednout (COLLECT)	Režim, kdy zákazník jen vyzvedává už připravenou objednávku.	Otevře obrazovku výdeje objednávek podle čísla.

3.2 Ubytování a registrace hostů

Režim	Kdy se použije	Co zákazník vidí
Ubytovat se (CHECK_IN)	Hotel, kemp, ubytovna.	Dva kroky: 1) Ubytování – počet nocí a výpočet ceny + obecní poplatky, 2) Údaje zákazníka – jméno, příjmení, datum narození, adresa, telefon. Před otevřením formuláře musí zákazník odsouhlasit zpracování osobních údajů (GDPR).

Počet nocí násobí cenu ubytování i obecní poplatky.
Obecní poplatek se počítá z počtu ubytovaných osob.
Uložení hosta vytvoří/aktualizuje zákazníka a objednávku s tagem kiosk-guest.
Personalizace textů (titulky, popis GDPR, nadpisy sekcí) jde přeložit přes konfiguraci.

3.3 Parkování a návštěva

Režim	Kdy se použije	Co zákazník vidí
Parkování (PARKING)	Obchod s parkováním, garáž.	Automaticky se přidá parkovací položka (produkt s tagem `parking`) a otevře se souhrn k platbě.
Návštěva (LOBBY_VISIT)	Hotel, kanceláře, areál – evidence návštěv.	Vyhledávání návštěvy podle jména / příjmení / telefonu (min. 3 znaky), výsledky v seznamu. Vedle vyhledávání se otevře i souhrn objednávky s předvolenou položkou (např. poplatek za návštěvu).

3.4 Věrnostní program a registrace

Režim	Kdy se použije	Co zákazník vidí
Registrace do věrnostního programu (LOYALTY_REGISTRATION)	Chcete získat nového zákazníka s kartou.	Formulář (jméno, příjmení, telefon, případně IČO), souhlas GDPR, uložení do back office, vytvoření QR kódové karty zákazníka a tisk věrnostní karty na tiskárně.

Věrnostní karta se vytiskne na tiskárně nastavené jako „účtenky“ – karta obsahuje QR kód, který zákazník použije při další návštěvě.

3.5 Výdej objednávek, reklamace a vratky

Režim	Kdy se použije	Co zákazník vidí
Vyzvednout objednávku (ORDER_PICKUP)	E-shop / objednávkový systém s výdejem na místě.	Klávesnice na číslo objednávky → vyhledání v Heliosu nebo v API e-shopu → zobrazení částky k úhradě → volba platby.
Reklamace – zadání (ORDER_WARRANTY)	Reklamace zboží.	Vyhledání reklamace podle identifikačního čísla, vytisk lístku do fronty.
Reklamace – vyzvednutí (ORDER_WARRANTY_COLLECT)	Výdej vyřešené reklamace.	Stejné vyhledání, jiný titulek a popisky.
Vrácení zboží (ORDER_RETURN)	Vratky z e-shopu.	Vyhledání objednávky a vytisk lístku do fronty.

Objednávka, která už byla vyzvednuta, se zobrazí jako „Objednávka byla již vyzvednuta“.
Neznámé číslo → hláška „Objednávka nenalezena“.
Po uhrazení se objednávka označí jako zaplacená a odešle do fronty (queue) s textem „Vyčkejte“.
Neuhrazená / už placená objednávka se dá vyzvednout i bez zásahu obsluhy.

3.6 Prohlížeč a validace vstupenek

Režim	Kdy se použije	Co zákazník vidí
Prohlížeč (BROWSER)	Ceník, menu na webu, rezervační systém partnera.	Webová stránka přímo v kiosku (případně video).
Validátor (VALIDATOR)	Sportovní / festivalové akce – ověření vstupenky.	Sken vstupenky → potvrzení (použito / neplatná / již použitá).

4. Jak zákazník nakupuje (katalog, sken, doplňky)

4.1 Kategorie a položky

Kiosk ukazuje carousel kategorií nahoře a mřížku položek dole.
Do kiosku se dostanou jen kategorie označené v back office jako „Zobrazit v samoobslužném kiosku“ (příznak e-commerce), a to pouze ty, které nejsou skryté na pokladně.
Počet sloupců mřížky jde nastavit (columns).
Když má obchod jen jednu kategorii, carousel se skryje a zobrazí se rovnou položky.
Kategorie může být v kiosku zobrazena jen obrázkem (bez názvu) – zákazník ji pozná podle fotky.

4.2 Skenování

Čárový kód / PLU – naskenovaný kód rovnou přidá položku do objednávky a otevře souhrn. Funguje to i u prázdného košíku.
Karta zákazníka (kasafik://… nebo store247://…) – karta se načte, zákazník se přiřadí k objednávce, zobrazí se body/účet.
Čtečka čipových karet (ACR122) a NFC – přiložení karty funguje v souhrnu objednávky i v dialogu „Stav zák. konta“.
Dotyková váha (USB) – kiosk umí průběžně vážit: při přidání/vyjmutí zboží na váze se položka sama přidá nebo ubere. Váha je připojená přes USB a katalog produktů se k váze mapuje přes čárové kódy.

4.3 Doplňky a příplatky

Produkty, které mají v back office nastavené doplňky / příplatky (obrázek, velikost, extras), otevřou po vybrání dodatečnou obrazovku, kde zákazník vybere z doplňkových položek a uvidí přepočítanou cenu.
Produkty, které mají varianty (skupiny možností), otevřou dialog s volbou.
Některé položky se dají přidat i automaticky (např. obal burgeru) – to je definice v katalogu, ne v kiosku.
Ke stolu (režim self_service) se přidávají položky s příznakem „S“ (doplňky ke stolu), v kioskovém režimu kiosk položky s příznakem „K“.

5. Platby

Kiosk umí kombinovat způsoby platby – každý se zobrazí jako tlačítko v souhrnu objednávky, podle konfigurace.

Způsob platby	Kdy se použije	Podmínky
Objednávka (bez platby)	Objednávka se jen pošle do výroby, platí se na pokladně.	Nejčastější v restauracích.
Hotově při převzetí	Zákazník zaplatí až u výdejního místa.
Hotovostní přijímač (bankovní terminál na mince)	Kiosk přijímá hotovost sám.	Nutno mít připojený a nakonfigurovaný přijímač.
Platební karta	Nejčastější způsob.	Musí běžet platební terminál (Sonet ECR2, GP TOM, ZVT, Viva, GPE).
Zákaznický účet (chip karta)	Zákazník má uctěnou kartu; platí se z jeho kreditu.	Kiosk přiloží kartu na čtečku.
Zákaznický účet (post-paid)	Objednávka se zaúčtuje na později.
Qerko	Platba přes mobilní aplikaci Qerko (QR).
QR online platba	Karta místo terminálu – zákazník platí v aplikaci přes QR (např. Viva).	Závisí na konfiguraci platebního kanálu v back office.

Důležité věci k platbám

Spropitné – v souhrnu objednávky se zákazníkovi zobrazí dotaz „Přejete si přidat spropitné?“ s předvolenými hodnotami (pevné částky i procenta). Výši spropitného i sadu tlačítek jde nastavit v konfiguraci.
Doplňková nabídka („Nezapomněli jste něco?“) – u souhrnu se zobrazí nabídka doplňkových položek (produkty s tagem upsell). Zákazník ji může jedním klepnutím přidat do objednávky.
Upozornění na alkohol – pokud objednávka obsahuje alkohol, zobrazí se hláška, že personál ověří věk při převzetí.
Měsíční limit zákazníka – pokud má zákazník na kartě nastavený měsíční limit úhrad, kiosk ho při platbě z účtu kontroluje. Při vyčerpání limitu se zákazníkovi zobrazí hláška s částkami a objednávku musí zaplatit jinak.
Odpojený terminál – pokud terminál není dostupný, objednávka se neztratí; je potřeba ji zopakovat nebo zvolit jinou platbu.
Výpadek sítě – objednávky se ukládají lokálně a po obnovení spojení se do synchronizují.

6. Tisk, fronta a propojení s provozem

Funkce	Popis
Tisk účtenky / objednávky	Po zaplacení se tiskne na tiskárnu nastavenou jako „účtenky“. Podle konfigurace je tisk povinný, nebo volitelný (tlačítko Odeslat objednávku / Odeslat bez tisku).
Tisk na kuchyň	Objednávka se tiskne i na tiskárnu(k) kuchyně, aby se připravila jídla.
Fronta (queue)	Po odeslání objednávky se do fronty zákazníků pošle požadavek s pořadovým číslem a místem vyzvednutí („Vyčkejte“, „V přípravě“). Obsluha pak vidí objednávku ve frontě.
Lístek s pořadovým číslem	U reklamací a vratek se vytiskne lístek s pořadovým číslem a zároveň se pošle do fronty.
Předtištěné / samostatné doklady	U některých terminálů se tiskne i samostatný doklad s textem z platebního terminálu.

7. Jazyky

Kiosk podporuje více jazyků a přepíná se vlajkou v záhlaví obrazovky.
Dostupné jazyky: cs, en, de, fr, ru, uk, vi, sk, pl, ja, zh.
Které vlajky se zobrazí, určuje konfigurace (languages).
Přepnutí jazyka překládá nejen rozhraní, ale i vlastní texty tlačítek a hlášek (přes klíče v konfiguraci).
Jazyk se dá zvolit i v úvodní obrazovce před začátkem objednávky.

8. Konfigurace kiosku (všechno je řiditelné)

Kiosk si při startu načte konfiguraci ze cloudu – konkrétně ze souboru

https://fikpreferences.s3.eu-west-1.amazonaws.com/kiosks/<ID zákazníka>/<ID pokladny>.json

Konfigurace je na pokladnu, ne na zařízení – stejný soubor může být na více kioscích.
Změna se projeví po restartu kiosku (zavření a nové otevření obrazovky kiosku).
Když soubor není dostupný, kiosk běží na výchozích hodnotách a hlásí chybu.
Aktuální konfigurace se ukládá i na zařízení do souboru kiosk_config_<ID pokladny>.json – slouží jako záloha a archiv.

8.1 Přehled konfiguračních klíčů

Základní nastavení

Klíč	Význam	Výchozí
`languages`	Seznam dostupných jazyků (kódy `cs`, `en`, …)	prázdné
`columns`	Počet sloupců mřížky produktů (`-1` = nastavení pokladny)	`-1`
`auto_logout_sec`	Sekundy nečinnosti před dotazem „Stále jste tu?“	`120`
`text`	Překlady vlastních textů: `{ "cs": { "KLÍČ": "text" } }`	prázdné
`updated_at`	Čas poslední změny konfigurace	–

Vzhled

Klíč	Význam
`image_front_open_url`	Obrázek nebo video na úvodní obrazovce (`.mp4`, `.mov`, `.avi` se přehrává, `asset:` = offline soubor v aplikaci).
`image_front_closed_url`	Obrázek v „zavřeném“ stavu kiosku. Klíč je připraven pro budoucí použití.
`image_bg_url`	Barva pozadí (`#RRGGBB`) nebo URL obrázku.
`banner_urls`	URL obrázků v horním banneru (rotovány).
`banner_delay_sec`	Doba mezi bannerovým přehráním.
`category_text_list_color`	Barva textu v seznamu kategorií.
`category_text_color` / `category_bg_color` / `category_alpha`	Barvy a průhlednost panelu kategorií.
`sale_bg_color`	Barva pozadí obrazovky prodeje.
`item_title_size_sp` / `item_subtitle_size_sp`	Velikost názvu a popisu položky.
`button_bottom_size_sp`	Velikost písma spodních tlačítek.
`price_in_image`	Zda je cena vypnutá z obrázku položky (a kreslí se textem).
`gdpr_images_url`	Obrázek k textu GDPR (per jazyk).

Funkce (features_options)

Klíč	Efekt
`PANEL_CAROUSEL_CATEGORIES`	Zobrazí horní carousel kategorií.
`PANEL_SIDE_SUMMARY_STICKY`	Zobrazí trvalý panel souhrnu objednávky na straně obrazovky (užitečné na širokých displejích).
`ACCOUNT_BALANCE_CHECK`	Zobrazí tlačítko „Stav zák. konta“.
`CALLBACK_SERVICE`	Zobrazí tlačítko „Zavolat obsluhu“.
`GDPR`	Rezerva pro zpracování osobních údajů.

Režimy práce (delivery_options)

DINE_IN, TAKE_OUT, GROCERIES, TICKETS, CHECK_IN, PARKING, LOBBY_VISIT, LOYALTY_REGISTRATION, ORDER_PICKUP, ORDER_RETURN, ORDER_WARRANTY, ORDER_WARRANTY_COLLECT, COLLECT, BROWSER, VALIDATOR.

Pořadí v seznamu = pořadí tlačítek na úvodní obrazovce (max. 4 zobrazených).
Názvy tlačítek jde přeložit přes text (klíč = název režimu, např. DINE_IN).

Platby (payment_options)

ORDER (bez platby), CASH (hotově při převzetí), CASH_ITC (přijímač hotovosti), PAYMENT_CARD (karta), CUSTOMER_CREDIT (chip karta – z účtu), CUSTOMER_POST_PAID, QERKO.

Klíč	Význam
`payment_tips`	Sada spropitných: pevné částky (`10` = 10 Kč) i procenta (`1.15` = 15 %). Prázdné pole = spropitné se nenabízí.
`receipt_auto_pay`	Účtenka se rovnou označí jako zaplacená a vznikne transakce (bez dotazu obsluhy).
`order_print_require`	Tisk objednávky povinný / volitelný. Klíč je připraven; v této verzi se tisk řídí nastavením tiskáren a obsluhou.
`payment_customer_phone_number`	Zda se vyžaduje telefonní číslo zákazníka: `REQUIRED` / `OPTIONAL` / `DISABLED`. Klíč je připraven pro budoucí použití.
`sync_freq_sec`	Frekvence synchronizace katalogu (záporná hodnota = vypnuto). Klíč je připraven; synchronizaci dnes řídí plánovač v aplikaci.
`language_selector_type`	Umístění přepínače jazyka: `FIXED_BANNER` (vlajka v záhlaví) / `PRE_SALE` (v úvodní obrazovce).

Překlady vlastních textů (`text`)

Klíč	Kde se zobrazí
`CANCEL_BUTTON`	Text tlačítka „Zrušit“.
`PAY_BUTTON`	Text tlačítka platby.
`BACK_BUTTON`	Text tlačítka „Zpět“.
`BOTTOM_LOGO_SUBTITLE`	Popisek pod logem.
`gdpr_notice_checkbox`	Text souhlasu GDPR.
`ORDER_PICKUP_ORDER_TITLE` / `ORDER_PICKUP_LOOKUP_BUTTON` / `ORDER_PICKUP_PAYMENT_OPTIONS_TITLE` / `ORDER_PICKUP_NOT_FOUND` / `ORDER_PICKUP_COLLECTED`	Obrazovka výdeje objednávek.
`ORDER_PICKUP_WARRANTY_TITLE` / `ORDER_PICKUP_WARRANTY_BUTTON`	Obrazovka reklamací.
`PAYMENT_TYPE_CASH` / `PAYMENT_TYPE_CARD`	Názvy způsobů platby.
`VISITOR_NAME_LABEL` / `VISITOR_QUERY_HINT` / `VISITOR_NOT_FOUND`	Obrazovka návštěv.

Texty v konfiguraci se načítají pro jazyk podle vlajky; když překlad pro daný jazyk chybí, použije se angličtina, a když chybí i ta, použije se výchozí text aplikace.

9. Hardware a periferie

Zařízení	Využití v kiosku
Terminál na karty (Sonet ECR2, GP TOM, ZVT, Viva, GPE)	Platba kartou. Při výpadku se hlásí chyba „Platební terminál je odpojen“.
Přijímač hotovosti (ITC)	Přijímání hotovosti přímo v kiosku.
Čtečka čipových karet (ACR122)	Zákaznická karta, platba z účtu.
NFC	Přiložení karty k telefonu/čtečce.
Terminál pro platbu QR	Vlastní platební terminál nebo QR přes mobil.
Tiskárna (USB i síťová)	Účtenky, objednávky, lístky do fronty, věrnostní karty. Kiosk automaticky kontroluje, jestli je tiskárna připojená, a při výpadku ukáže hlášku.
Skener čárových kódů (USB klávesnicový)	Sken produktů a čárových kódů objednávek.
Dotyková váha (USB)	Vážení zboží, automatické přidání/odebrání položky.
Bluetooth displej pro zákazníka	Zobrazení objednávky a částky vedle kiosku.
Reproduktor	Zvuková zpětná vazba – chyba, úspěch, klepnutí.
Vzdálená správa / MQTT / WebSocket	Notifikace a stav propojení s centrálou.

Kiosk běží v režimu celé obrazovky – systémová lišta, navigační panel a stavový řádek se ukrývají, aby zákazník nemohl „utéct“ z kiosku.

10. Obsluha kiosku v praxi – checklist

Před otevřením obchodu

Kiosk je připojený k síti a napájení, tiskárny jsou zapnuté.
Na úvodní obrazovce se zobrazuje správné logo / video obchodu.
V kiosku jsou vidět jen kategorie, které chcete prodávat samoobslužně (příznak v back office).
Ceny v kiosku odpovídají cenám na pokladně.
Platební terminál je připojený a prošel kontrolou.
Spropitné a doplňková nabídka odpovídají vašim zvyklostem.

Během provozu

Občas ověřte, že kiosk nehlásí chybu tiskárny / terminálu / sítě.
Když zákazník „zapomene“, dialog „Stále jste tu?“ sám vyřeší situaci – objednávka se zruší a obrazovka se vrátí na úvod.

Na konci dne

Zkontrolujte logy kiosku v adresáři LOGS na zařízení (chybové hlášky tiskárny, terminálu, sítě) a uloženou kopii konfigurace kiosk_config_<ID pokladny>.json.
Ověřte, že se všechny objednávky propisovaly do pokladny (report za den).

11. Řešení problémů (rychlá tabulka)

Co vidíte	Pravděpodobná příčina	Řešení
„Cloud kiosk config doesn't exist“ (konfigurace kiosku neexistuje)	Chybí nebo je nepřístupný konfigurační soubor pro pokladnu.	Zkontrolujte ID zákazníka a pokladny v URL konfigurace.
„Tiskárna na adrese X je odpojena“	Tiskárna není zapnutá / není připojená k počítači.	Zapněte tiskárnu, ověřte USB kabel, případně v nastavení tiskáren přepočítat test.
„Platební terminál X je odpojen“	Terminál neodpovídá.	Ověřte napájení a síť terminálu, případně proveďte vyrovnání terminálu.
„Chyba synchronizace – chyba připojení k internetu“	Kiosk je offline.	Objednávky se ukládají lokálně, po obnovení sítě se do synchronizují. Zkontrolujte kabel / Wi-Fi.
Obrazovka zůstává na úvodní stránce	Seznam režimů práce je prázdný nebo je vše „zavřeno“.	Zkontrolujte `delivery_options` v konfiguraci a restartujte kiosk.
Zákazník nezobrazí správnou položku	Kód není v katalogu nebo není viditelný v kiosku.	Ověřte přiřazení kódů (čárový kód / PLU) a viditelnost kategorie.
Kiosk „nevidí“ zákaznickou kartu	Není připojená čtečka ACR122 nebo NFC.	Zkontrolujte USB čtečku a oprávnění k USB zařízení při startu.
„Zařízení nemá platnou licenci“	Kiosk nemá platnou licenci KASA FIK.	Kontaktujte podporu / obnovte licenci.

12. Shrnutí pro provozovatele

Kiosk není „další pokladna“ – je to konfigurovatelný terminál pro obsluhu zákazníka:

Režimy práce (delivery_options) určují, co na kiosku zákazník dělá: objednává jídla, kupuje zboží, ubytovává se, parkuje, kupuje vstupenky, registruje se do věrnostního programu, vyzvedává e-shopovou objednávku nebo reklamaci, nebo u něj jen vyplácí parkovací poplatek.
Funkce (features_options) zapínají konkrétní ovládací prvky – stav zákaznického konta, volání obsluhy, trvalý souhrn objednávky, carousel kategorií.
Platby (payment_options) říkají, jak zákazník může zaplatit – od „zaplatí na pokladně“ přes kartu, hotovostní přijímač až po zákaznický účet.
Vzhled a texty se řídí z kloudu, takže obchod si může připravit vlastní úvodní obrazovku, banner, barvy a vlastní formulace tlačítek bez zásahu do aplikace.
Předpoklady pro spolehlivý provoz: správně nastavené kategorie a ceny, funkční tiskárna a platební terminál, připojená čtečka kódů a případně váhy, a pravidelná kontrola logů.