Příručka HorecaPOS

Tato příručka má tři části: nejprve pro obsluhu (číšníky), pak pro vedoucího a nakonec pro správce. Každá část navazuje na předchozí: vedoucí může vše co obsluha a správce může všechno.

Co smí vaše role dělat, nastavuje správce v Nastavení → Oprávnění. Pokud nějaké tlačítko nevidíte, vaše role k němu (zatím) nemá oprávnění.

Tato příručka je i v pokladně: klepněte na tlačítko © vpravo dole na libovolné obrazovce a zvolte Příručka, nebo otevřete http://<kassa-pc>:3000/handleiding. Viz také představení a dokumentaci API.

Část 1 · Obsluha

Začínáme

Přihlášení. Otevřete pokladnu na pokladně, tabletu nebo telefonu a zadejte svůj PIN (4 až 8 číslic). Pak uvidíte plánek.

Otevření stolu. Klepněte na stůl. Volný stůl dostane novou objednávku; u obsazeného stolu pokračujete ve stávající objednávce. Nahoře přepínáte mezi místnostmi (například Restaurace a Terasa). Pro pult použijte Rychlý prodej, pro objednávky s sebou S sebou.

Objednávání. Zvolte kategorii a klepejte na produkty. Objeví se vlevo na účtence. Případně nejprve zvolte chod (1 = hned, 2 a 3 čekají, dokud je nevyvoláte). Klepněte na Odeslat objednávku: kuchyňské lístky pak odejdou do kuchyně a na bar. Dokud jste neklepli na Odeslat objednávku, můžete řádky jednoduše odebrat.

Placení. Klepněte na Zaplatit, zvolte Karta / Bancontact, Hotově nebo Dárkový poukaz, případně spropitné, a potvrďte. U platby kartou se platba automaticky spustí na platebním terminálu. Účtenka se vytiskne; můžete ji také poslat e-mailem.

Odhlášení. Až skončíte, odhlaste se, aby nikdo jiný nepracoval pod vaším jménem. Po 8 hodinách budete odhlášeni automaticky.

Bez internetu? Pokladna jednoduše funguje dál. Pokud horní lišta ukazuje Bez internetu · karta ručně, zadejte částku přímo na platebním terminálu a na obrazovce placení zvolte Již zaplaceno na terminálu.

Více skupin u jednoho stolu

U jednoho stolu může sedět více skupin, každá s vlastním účtem a vlastní účtenkou.

• Klepněte na stůl: volný = nová objednávka; jedna skupina = rovnou k této skupině; více skupin = nejprve vyberte, nebo + Nová skupina (název může zůstat prázdný).
• Nahoře na obrazovce objednávky je lišta skupin: přepínání mezi skupinami, + Skupina, Název skupiny (např. "Novákovi") a Rozdělit / přesunout.
• Rozdělit / přesunout: u každého řádku zvolte, kolik kusů jde s sebou (např. 1 z 3× ležák) a do které skupiny, nebo vytvořte novou skupinu. Tak přesunete něco, co je na špatném účtu, nebo účet dodatečně rozdělíte, aby "každý platil své". Pokud skupina zůstane prázdná, zmizí.
• Více částí najednou: tlačítkem + Ještě jedna část připravíte jednu část a vyberete další (např. rybu a Dry Martini ke stolu 2, zbytek ke stolu 35). Část může jít také na + Jiný stůl (tam jako nová skupina). Tlačítkem Přesunout se vše přesune najednou. ½ rozdělí položku napůl, i půl lahve (0,667 se změní na 2 × 0,3335).
• Sloučit: vše z jednoho nebo více jiných stolů (nebo skupin u tohoto stolu) na tento účet, najednou.
• Belgie: rozdělení nebo sloučení najednou je v černé skříňce jedna změna stolu, jak to vyžaduje FOD, belgická finanční správa (UC242, UC251, UC252, UC4119bis). Pokud se po objednání něco škrtne nebo se na již objednanou položku dá sleva, odejde to s další zprávou daného stolu (objednávka, předběžný účet, změna stolu), jinak s prodejem: stará položka záporně a nová kladně (UC226, UC4102, UC4104, UC4107, UC4110).
• Na obrazovce stolů ukazuje oranžová tečka, kolik skupin u stolu je; částka je součtem všech skupin.
• Účtenka a kuchyňský lístek ukazují "Stůl 5 - skupina 2" nebo "Stůl 5 - Novákovi".

Rozdělení účtu při placení

Placení funguje jako vždy: Vše najednou. Na obrazovce placení lze účet nyní také rozdělit, pomocí tlačítek pod Zpět a Zaplatit (tak zůstanou vždy na očích, bez posouvání):

• Rozdělit rovným dílem: pomocí − a + zvolte počet osob (výchozí je počet hostů, nebo 2, pokud pokladna počet hostů neeviduje). Obrazovka ukazuje částku na osobu; každý zaplatí svůj díl kartou, hotově nebo dárkovou kartou (případně se spropitným). Po každém dílu se odpočítává ("zbývá 3 osob"); poslední zaplatí přesně zbytek.
• Vlastní částka: někdo zaplatí pevnou částku (např. € 20); zbytek zůstane otevřený.
• Podle produktů…: otevře Rozdělit / přesunout, abyste dali produkty na samostatný účet a zaplatili je zvlášť (viz výše).

Částečná platba pouze zaznamená platbu; účet zůstane otevřený a obrazovka objednávky ukazuje "již zaplaceno … · zbývá …". Účtenka (se všemi platbami) přijde s poslední platbou, jako při běžném placení. Platby kartou přes propojení jsou přesně na částečnou částku. Jakmile je část zaplacena, řádky už nelze přesunout do jiné skupiny a nelze přidat další slevy; odebrat lze jen tehdy, je-li ještě dost otevřeno. Každá částečná platba se zaznamená.

Rychlý prodej a s sebou (bez stolu)

Vpravo nahoře na obrazovce stolů jsou Rychlý prodej a S sebou. Obě tlačítka hned otevřou objednávku bez stolu. Rychlý prodej je prodej u pultu (DPH pro konzumaci na místě); S sebou používá u každého produktu sazbu DPH pro s sebou. Pomocí "Jméno zákazníka" přidáte jméno; objeví se na účtence ("S sebou – Novák") a nahoře na kuchyňském lístku. Otevřené objednávky bez stolu jsou uvedeny pod tlačítky místností ("Bez stolu: S sebou #12 – Novák"), takže je znovu najdete. Pokud se vrátíte, aniž byste něco prodali, prázdná objednávka automaticky zmizí.

Obě tlačítka lze pro každou provozovnu zapnout nebo vypnout v Nastavení → Podnik, přímo pod světlým/tmavým motivem (ve výchozím stavu zapnuto). Vypnuto = tlačítko skryté; již otevřené objednávky bez stolu zůstanou viditelné.

Rozvoz a časové úseky

Objednávky, které přijímáte přímo v pokladně, například telefonicky nebo u pultu, se stejnými pravidly jako v e-shopu: oblasti rozvozu a maximální počet objednávek na časový úsek. Zapíná se v Nastavení → Provozovna → Rozvoz a časové úseky, hned pod tlačítky Rychlý prodej a S sebou (ve výchozím stavu vypnuto).

• Tlačítko Rozvoz na obrazovce stolů (vedle S sebou): zadejte jméno, telefon a adresu (se zapnutým Rychlé zadání adresy: vyhledání podle PSČ a čísla domu). Pokladna najde oblast rozvozu a zobrazí poplatek za rozvoz, minimum a "zdarma od". Pokud adresa leží mimo oblasti, objednávka není možná.
• Oblasti rozvozu: podle PSČ (rozsahy a jednotlivá PSČ, např. 5000-5049, 5051, 5052 AB), v rámci poloměru v km od provozovny (vzdušnou čarou) nebo oblast na mapě, kterou si sami zakreslíte. Poloměr a oblast fungují jen s nizozemskými adresami (poloha přes PDOK). Pro každou oblast: poplatek za rozvoz, minimum, zdarma od a minuty navíc; platí první vyhovující oblast shora, takže druhy lze kombinovat (např. nejdřív několik PSČ, pak oblast, pak poloměr pro zbytek). Žádné nastavené oblasti = rozvoz všude, bez poplatků a bez minima. Oblasti e-shopu se nastavují zvlášť (správa e-shopu).
• Oblast na mapě: u oblasti rozvozu zvolte druh Oblast na mapě a pak Kreslit na mapě. Kliknutím na mapu přidáváte body (alespoň 3); přetažením bod přesunete, kliknutím na bod ho odstraníte a přetažením kolečka uprostřed hrany přidáte bod mezi ně. Mapa ukazuje také oblasti s poloměrem a provozovnu. Mapové dlaždice pocházejí z OpenStreetMap, takže mapa potřebuje internet; samotný rozvoz ne (kromě dohledání adresy). Pokud adresu nelze dohledat, pokladna to oznámí místo "mimo oblasti rozvozu".
• Poplatek za rozvoz je na objednávce jako řádek "Bezorgkosten" a po každé změně se znovu přepočítá (zdarma od, žádné produkty = žádný poplatek), dokud není nic zaplaceno. Pod minimem nelze zaplatit; obrazovka objednávky ukazuje, kolik ještě chybí, s tlačítkem Přesto s sebou (poplatek za rozvoz a minimum odpadají).
• Čas: Co nejdříve (teď + doba rozvozu, plus minuty navíc dané oblasti) nebo časový úsek z dneška. Pokud máte nastavenou otevírací dobu u Thuisbezorgd, platí i zde.
• Maximum na časový úsek (0 = bez maxima; časový úsek 5 až 60 minut): pro S sebou a Rozvoz dohromady; započítávají se i objednávky z e-shopu v pokladně. Je-li nastaveno maximum, ptá se na čas i S sebou a plné časové úseky nelze vybrat. Dvě pokladny současně o poslední místo: dostane ho jen jedna.
• Na kuchyňském lístku je adresa, jméno, telefon a čas; v "Bez stolu" a nahoře na kuchyňském lístku např. "Rozvoz – 18:30 Novák".

Rozšíření (vše ve výchozím stavu vypnuto; bez těchto nastavení vše funguje přesně jako výše):

• Vlastní otevírací doba pro s sebou a rozvoz (pro každý den v týdnu, např. 16:00-21:00 nebo 11:30-14:00, 17:00-22:00; přes půlnoc lze: 17:00-01:00; prázdné = ten den zavřeno). Vypnuto = jako dříve (časy u Thuisbezorgd, pokud existují, jinak celý den).
• Zavřené dny (např. 25-12-2026, 26-12-2026): v těch dnech žádné s sebou ani rozvoz.
• Objednávky předem: 0 (jen dnes, jako dříve) až 14 dní. V okně Rozvoz/S sebou pak nejdřív zvolíte den; pozdější den je na pracovním lístku uveden před časem.
• Vytížení: tolik minut navíc u "co nejdříve" (pokladna i e-shop). Rychle nastavitelné také tlačítkem E-shop v horní liště.
• Belgické adresy (PSČ o 4 číslicích): u poloměru nebo oblasti na mapě vyhledá pokladna polohu přes OpenStreetMap (Nominatim; je potřeba ulice a obec).
• E-shop se řídí pokladnou: rozhoduje pokladna. E-shop pak používá oblasti rozvozu, dobu rozvozu a vyzvednutí, časový úsek, maximum na časový úsek, otevírací dobu (pokud je nastavena zde), zavřené dny a dny předem z pokladny a do časového úseku započítává objednávky přijaté na pokladně. Vypnuto = e-shop má vlastní nastavení (správa e-shopu), jako dříve. Zapnutí či vypnutí s sebou/rozvozu zůstává na e-shopu.

Kód: lib/bezorgen.ts, routes/bezorgen.ts, BezorgDialoog.tsx, BezorgInstellingen.tsx, BezorgKaart.tsx a lib/kaart.ts (mapa, bez dalšího balíčku; stejný kód je v e-shopu jako public/kaart.js).

Telefonie: rozpoznat zákazníka při telefonické objednávce

Nastavení → Telefonie (ve výchozím stavu vypnuto; vypnutím se nic neztratí). Dva samostatné přepínače:

• Vyhledat zákazníka podle telefonního čísla u rozvozu a s sebou: zadáte-li číslo na obrazovce rozvozu, pokladna ukáže zákazníka s adresou a předchozími objednávkami; Převzít údaje vyplní jméno, e-mail a adresu. Funguje i bez telefonní ústředny.
• Identifikace volajícího: když zavolá zákazník, ústředna (nebo telefon, FRITZ!Box, modem či telefon Android) nahlásí číslo. Na obrazovkách se objeví oznámení, kdo volá: jméno, adresa, poslední objednávky (s jídly a částkou, i z e-shopu, Thuisbezorgd a rozvozových platforem), součet a rezervace. Tlačítkem Přijmout objednávku na rozvoz nebo Přijmout objednávku s sebou se otevře obrazovka rozvozu se vším vyplněným (při zapnutém rozvozu a časových oknech); objednávka se přiřadí k hovoru a oznámení zmizí na všech obrazovkách. Tlačítko 📞 v horní liště: hovory za posledních 24 hodin. Lze vypnout pro každou obrazovku (Zobrazovat oznámení na této obrazovce).

Hledá se v zákaznické kartě, objednávkách na rozvoz a s sebou v pokladně, e-shopu, Thuisbezorgd, rozvozových platformách a rezervacích. Čísla se sjednocují (+31 6 1234 5678, 0031612345678 a 06-12345678 jsou totéž; i belgická čísla).

Jak číslo přichází (více najednou je možné; stejný hovor se počítá jednou):

Odpověď obsahuje volajícího, také jako contact (firstname, lastname, phone, email, address) pro šablonu CRM 3CX. Odchozí a interní hovory se nezobrazují; Jen tyto linky omezí na určité linky nebo telefony. Hovory se po době uchovávání mažou (výchozí 30 dní, GDPR). Testovací hovor simuluje volání z čísla.

Kód: apps/pos-server/src/lib/telefonie.ts, routes/telefonie.ts, packages/shared/src/telefonie.ts; obrazovky Telefonie.tsx, BezorgDialoog.tsx; Android android-app/native/java/Beller*.java. Protokol: Telefonie.

Vlastní kurýři: jízdy, odevzdání hotovosti a sledování zásilky

Pro provozovny s vlastními kurýry. Zapněte v Nastavení → Provozovna → Rozvoz → Vlastní kurýři (ve výchozím stavu vypnuto). Aplikace pro kurýra není potřeba: kurýr používá stránku v prohlížeči vlastního telefonu (kdo chce, může použít aplikaci Optimum Bezorger: viz Aplikace pro kurýry níže).

Vytvoření jízdy. V pokladně je tlačítko Jízdy (s počtem rozvozů, které ještě musí odjet, plus jízd, které jsou na cestě).

1. V části Připraveno k doručení zaškrtněte objednávky, které jedou. Jsou to objednávky s rozvozem z pokladny, e-shopu a Thuisbezorgd (jen vlastní rozvoz; ne ty s kurýrem Thuisbezorgd).
2. Vyberte kurýra (zaměstnance) a drobné, které si bere s sebou (ve výchozím stavu částka z nastavení), a klepněte na Vytvořit jízdu.
3. Zobrazí se QR kód. Kurýr ho naskenuje vlastním telefonem a u každé adresy vidí jméno, adresu s tlačítkem Trasa (navigace), Zavolat, poznámku, požadovaný čas a co má vybrat. K dispozici je kalkulačka na vracení (zákazník dává 50 € → vrátit 31,50 €). Přihlášení není potřeba. Sdílejte odkaz jen s kurýrem: kdo ho má, vidí adresy této jízdy. Tlačítkem QR kód pro kurýra vytvoříte nový odkaz; starý pak přestane fungovat.
4. Klepněte na Odjet, když kurýr odjíždí. Drobné jdou ze zásuvky (výdej peněz, s důvodem). Zákazník dostane zprávu, že objednávka je na cestě:
   • u objednávky z pokladny SMS a/nebo e-mailem, pokud jsou zapnuté Zprávy zákazníkovi (viz Rozvoz a časové úseky);
   • u e-shopu podle nastavení e-shopu (e-mail, SMS nebo push oznámení);
   • u Thuisbezorgd přes Thuisbezorgd.

Pokud jízda ještě neodjela, lze ji ještě zrušit.

1. Na cestě kurýr u každé adresy klepne na Doručeno, hotově, Doručeno, kartou (vlastní platební terminál) nebo Doručeno (již zaplaceno). Pokladna to hned vidí. Pokud to kurýr nemůže nahlásit, lze to udělat i v pokladně. Po návratu do provozovny kurýr klepne na Jsem zpět v provozovně.

Odevzdání hotovosti. Po jízdě klepněte na Zaplatit (oprávnění Správa pokladní zásuvky):

• U každé objednávky vyberte hotově, kartou u dveří, již zaplaceno nebo nedoručeno (vráceno). Co kurýr nahlásil, je už vyplněné.
• Pokladna zaúčtuje každou objednávku s otevřenou částkou bez nové účtenky (zákazník už účtenku má; znovu vytisknout lze v Účtenkách). Nedoručená objednávka se z jízdy odebere a zůstane otevřená, aby mohla jet další jízdou.
• Vidíte, co se očekává: drobné plus přijatou hotovost. Zadejte, co kurýr odevzdává, nebo to spočítejte po bankovkách a mincích (Počítat po bankovkách a mincích). Pokladna ukáže, zda to sedí, nebo kolik je navíc či chybí.
• Drobné se vrátí do zásuvky (vklad peněz). Rozdíl je uveden u jízdy a v protokolu a objeví se také jako pokladní rozdíl v Z-zprávě.

Sledování zásilky (zapíná se zvlášť v nastavení). Při stavu na cestě dostane zákazník odkaz na sledovací stránku na portálu. Odkaz je v SMS nebo e-mailu a v e-shopu na stavové stránce (Sleduj svého kurýra). Na sledovací stránce je:

• zda se objednávka připravuje, je na cestě nebo byla doručena;
• očekávaný čas: z polohy kurýra přes adresy, které jsou na řadě dřív, jinak požadovaný čas;
• kolik adres je ještě předtím (bez zobrazení jiných adres);
• s volbou Kurýr živě na mapě také kurýr, provozovna a vlastní adresa na mapě (OpenStreetMap). Kurýr si sdílení polohy zapne sám v telefonu (Sdílet mou polohu). Poloha se přenáší jen, dokud je stránka otevřená; stránka udržuje obrazovku zapnutou.

Stránky se zobrazují v jazyce telefonu (všechny jazyky portálu). V pokladně u jízdy vidíte, kdy byla poloha naposledy předána (s odkazem na mapu).

Ochrana soukromí. Portál uchovává údaje o jízdě (jména, adresy, telefonní čísla, polohu) jen po dobu jízdy. Při vyúčtování se vše smaže, jinak po 24 hodinách. Zákazník vidí jen svou objednávku. Poloha kurýra je viditelná jen během jízdy a přestane být vidět, jakmile se kurýr vrátí.

Plánování jízd (volitelné)

Zapněte je v Nastavení → Provozovna → Rozvoz → Plánování jízd (ve výchozím stavu vypnuto; funguje s vlastními kurýry). V okně Jízdy pak bude tlačítko Navrhnout jízdy. Pokladna spojí objednávky, které ještě čekají na odvoz, do jízd:

• objednávky, které jsou blízko sebe a jejichž požadované časy spadají do časového okna (výchozí 30 minut), jdou dohromady;
• až do maximálního počtu adres na jízdu (výchozí 4), pokud jízda (cesta tam, všechny adresy a návrat do provozovny) netrvá déle než maximum (výchozí 45 minut);
• pro každou jízdu nejlepší pořadí, vzdálenost (km), doba jízdy tam a zpět a u každé adresy očekávaný příjezd při odjezdu hned. Je-li později než požadovaný čas, zobrazí se později než požadováno.

Tlačítkem Použít tuto jízdu zaškrtnete tyto objednávky v tomto pořadí; zvolte kurýra a klepněte na Vytvořit jízdu. U jízdy, která ještě neodjela, seřadí Nejlepší pořadí adresy do nejrychlejšího pořadí (i v telefonu kurýra). U každé jízdy je uvedena vzdálenost a doba jízdy.

Nastavení: adresy na jízdu, maximální délka jízdy, časové okno, rychlost kurýra (kolo ~15, skútr ~25, auto ~35 km/h ve městě) a minuty na adresu (parkování, zvonění, placení; výchozí 2). Tyto hodnoty smí nastavit i vedoucí: v okně Jízdy tlačítkem Nastavit plánování jízd (oprávnění Nastavit plánování jízd, pro vedoucího ve výchozím stavu zapnuté; lze změnit v Nastavení → Oprávnění). Zapnutí a vypnutí plánování jízd a služba pro trasy (adresa, API klíč) zůstávají u správce.

Vzdálenost a doba jízdy, volí správce:

• Odhad (výchozí): vzdušná vzdálenost krát 1,35 (koeficient objížďky) při rychlosti kurýra. Funguje bez internetu a bez účtu.
• OSRM: trasy po silnici přes server OSRM. Zadejte adresu (https://, nebo http:// ve vlastní síti). Veřejný demo server (https://router.project-osrm.org) je jen pro občasné použití; pro každodenní provoz si zřiďte vlastní server OSRM nebo využijte poskytovatele.
• OpenRouteService: trasy po silnici s vlastním klíčem API (zdarma na openrouteservice.org, s denním limitem). Adresa je ve výchozím stavu https://api.openrouteservice.org a může vést na vlastní server. Klíč zůstává v pokladně; obrazovky ukazují jen to, že je vyplněn.

Tlačítkem Otestovat službu vyzkoušíte. Pokud služba nefunguje, plánování se vrátí k odhadu a upozorní na to. Adresa s neznámou polohou (bez platného PSČ a čísla domu) se v návrhu objeví pod bez známé polohy a nenaplánuje se. Export konfigurace obsahuje nastavení, ale ne klíč.

Kód: lib/ritplanning.ts.

Aplikace pro kurýry (volitelné)

Zapněte v Nastavení → Provozovna → Rozvoz → Aplikace pro kurýry (ve výchozím stavu vypnuto; funguje s vlastními kurýry a správcovským portálem). Každý kurýr pak spáruje svůj telefon jen jednou, místo aby u každé jízdy skenoval QR kód:

1. V části Spárované telefony vyberte kurýra (zaměstnance), případně název telefonu, a klepněte na Spárovat telefon.
2. Zobrazí se QR kód. Kurýr ho naskenuje v aplikaci Optimum Bezorger (tlačítko Spárovat) nebo fotoaparátem telefonu: stránka se pak otevře v prohlížeči. Funguje i bez aplikace a dá se přidat na plochu.
3. Spárování platí, dokud ho nezrušíte; telefon pak okamžitě nic neuvidí. Nové spárování pro stejného zaměstnance nahradí to staré (například u nového telefonu).

V aplikaci nebo na stránce jsou všechny vlastní jízdy (každá jízda, kterou pokladna pro tohoto kurýra vytvoří), se stejnými tlačítky jako u jízdy: Trasa, Zavolat, částka k vybrání s kalkulačkou vrácení, Doručeno a Jsem zpět v provozovně. Zvlášť lze zapnout:

• Samostatné braní objednávek: kurýr vidí rozvozy, které ještě čekají na jízdu, zaškrtne, co si bere, a klepne na Vzít s sebou. Pokladna vytvoří jízdu (nebo je přidá, pokud už má tento kurýr jízdu, která ještě nevyrazila); standardní drobné jedou s ním. Co už vzal někdo jiný, už vybrat nejde.
• Samostatný odjezd: Vyrazit v aplikaci dělá totéž co v pokladně (drobné ze zásuvky, zákazníci dostanou zprávu).
• Živá mapa: v části Jízdy je tlačítko Mapa s provozovnou, všemi kurýry, kteří jsou ve službě, a adresami, které je ještě třeba doručit. Kurýr si Ve službě zapíná a vypíná sám. Aplikace předává polohu i při vypnuté obrazovce (Android: oznámení v liště, dokud je sdílení zapnuté); webová stránka jen, dokud je otevřená. Bez tohoto nastavení se poloha sdílí jen během jízdy se sledováním zásilky.

Aplikace pro Android je na Google Play a na stránce ke stažení na portálu (/download/). Verze pro iPhone je hotová, ale vyjde až po založení vývojářského účtu Apple; do té doby iPhony používají webovou stránku. U jízdy, kterou si kurýr vzal sám, je uvedeno převzato kurýrem v aplikaci.

Kód: lib/bezorgersapp.ts, na portálu src/volgen.mjs a aplikace v repozitáři horecapos-bezorger.

V protokolu je uvedeno, kdo jízdu vytvořil, vypravil, nahlásil jako doručenou a vyúčtoval, včetně částek. Vypnutí: žádné tlačítko Jízdy; jízdy a nastavení zůstanou uloženy.

Na portálu: /bezorger/<sleutel> a /volg/<code>. Kód: lib/bezorgers.ts, routes/bezorgers.ts, Bezorgers.tsx a v portálu src/volgen.mjs.

Hlášení při příliš dlouhé době přípravy

Objednávka s sebou nebo rozvoz, která je hotová později, než bylo slíbeno: pokladna to rozpozná, ohlásí a může zákazníkovi hned poslat omluvu, případně s poukazem. Zapnete to v Nastavení → Provozovna → Rozvoz → Hlášení při příliš dlouhé době přípravy (ve výchozím stavu vypnuto).

• Které objednávky: s sebou a rozvoz se slíbeným časem, z pokladny (rozvoz a časová okna), z e-shopu a z Thuisbezorgd.nl / Takeaway.com.
• Zpožděné: tolik minut (výchozí 10) po slíbeném čase stále není hotová ani na cestě. Hotovo nebo na cestě znamená: vše hotovo na kuchyňské obrazovce, stav hotovo nebo na cestě v e-shopu nebo u Thuisbezorgd, zpráva ✉ Hotovo / ✉ Na cestě zákazníkovi, nebo zaplaceno. Pokladna kontroluje každou minutu.
• Hlášení: tlačítko Zpožděné v horní liště s počtem (se zvukem u nové), u každé objednávky slíbený čas a kolik minut je zpožděná. Objednávka zmizí sama, jakmile je hotová nebo na cestě, nebo tlačítkem Vyřízeno; pod tím jsou ty z posledních 24 hodin, s časem, kdy byly hotové. Vše se zapisuje do protokolu.
• E-shop: stavová stránka hosta ukazuje, že to trvá déle, s novým očekávaným časem.
• U Thuisbezorgd to nejde (zákazník patří k Thuisbezorgd): tam pouze hlášení. Lze použít vlastní text; {naam}, {zaak}, {code}, {korting} a {geldig} se vyplní automaticky.
• Poukaz (jen se zapnutými Slevovými kódy): s omluvou osobní slevový kód na příští objednávku (např. SORRY-7K4Q2M), částka nebo procenta, na jedno použití, platný určitý počet dní, na pokladně i v e-shopu. Kódy nejsou v seznamu Slevových kódů. Když se odeslání nepodaří, kód propadne. Tlačítkem v pokladně jen s oprávněním Dát slevu.
• Vypnuto: hlášení a vydané kódy zůstávají uloženy (i v záloze); nastavení je součástí exportu konfigurace.

Kód: lib/telaat.ts, routes/telaat.ts, TeLaat.tsx a packages/shared/src/telaat.ts.

Tlačítko Objednat: co dělá a kdy ho potřebujete

Ťuknout na produkt a ťuknout na Objednat jsou dva různé kroky:

• Ťuknutím na produkt se položka hned přidá na účet (v seznamu vlevo) jako nová. Vidíte ji jen vy: kuchyně ani bar o ní zatím nevědí. Nová položka je jen koncept: můžete ji ještě odebrat nebo změnit množství či volby, bez storna.
• Objednat odešle všechny nové položky najednou: bony jdou na tiskárny v kuchyni a na baru (a na kuchyňskou obrazovku) a položky pak mají stav objednáno. Odebrat je pak lze už jen pomocí Storno (oprávnění storno). Na tlačítku je vidět, kolik nových položek čeká, např. Objednat (3); pokud žádné nové položky nejsou, je tlačítko šedé.

Proč dva kroky? U stolu přijmete celou objednávku (nápoje, předkrm, hlavní jídlo), ještě ji upravíte, když si host něco rozmyslí, a pak ji najednou pošlete do kuchyně, s jedním bonem na každé stanoviště místo bonu na každý produkt. Kuchyně tak může začít dlouho předtím, než se platí.

Co se dále stane při Objednat:

• Chody: chod 1 jde hned do kuchyně; chody 2, 3 a 4 jdou s sebou jako ČEKÁ a kuchyně začne, až když daný chod vyvoláte (viz Chody).
• Kola: každé Objednat je jedno kolo; na tom funguje ↻ Ještě jedno kolo.
• Sklad se odečte a dávkovací výčep se uvolní.
• All-you-can-eat: je-li toho na dané menu příliš, nebo je příliš brzy či pozdě, pokladna se nejdřív zeptá, zda to přesto povolit.
• Belgie (GKS 2.0): položky jdou nejdřív jako pro forma do černé skříňky; pokud se to nepodaří, do kuchyně nejde nic a zůstanou nové.
• Bez připojení: objednávka se uloží a odejde do kuchyně, jakmile se připojení obnoví. Tiskárna vypnutá: objednávka přesto proběhne, bon se zařadí do tiskové fronty (viz Kuchyňská tiskárna vypnutá nebo žádná kuchyňská obrazovka).

Můžete také rovnou zaplatit. Když ťuknete na Zaplatit a na účtu jsou ještě nové položky, pokladna je nejdřív automaticky objedná, aby kuchyně a bar vždy dostaly svůj bon. Na baru nebo u jídla s sebou tedy nemusíte nejdřív ťukat na Objednat: ťukněte na produkty a rovnou Zaplatit. Pokud se automatické objednání nepodaří (bez připojení, pravidlo all-you-can-eat, černá skříňka), platební obrazovka se neotevře a uvidíte proč.

Nechcete, aby bar dostal lístek, když platíte hned? V Nastavení → Provozovna → Objednávání a placení zaškrtněte Přímé placení bez objednávkového lístku. Do kuchyně a na bar pak odejde jen to, co odešlete tlačítkem Objednat; na to, co zaplatíte hned, se objednávkový lístek nevytiskne.

Velké nebo malé tlačítko Zaplatit

Se zaškrtnutím Velké tlačítko "Zaplatit" je na obrazovce objednávky hned pod objednanými produkty velké tlačítko Zaplatit: široké, vysoké a s částkou, aby se dalo rychle stisknout. Je-li účet už zčásti zaplacen, ukazuje tlačítko zbývající částku. Malé tlačítko dole vedle Objednat pak zmizí.

S velkým tlačítkem jsou velká i tlačítka na obrazovce placení: Zaplatit (u Karty, Dárkového poukazu a ostatních způsobů platby) a u platby Hotově jsou Zaplatit přesně a Zaplatit široká a vysoká, snadno se trefíte, i se špinavými prsty (například u řezníka). Způsoby platby jsou o něco větší a tlačítka spropitného o něco menší, aby vše zůstalo na obrazovce.

Při nové instalaci je zaškrtávátko vypnuté: pak malé tlačítko dole vedle Objednat a obrazovka placení s běžnými tlačítky. Raději velké? V Nastavení → Podnik, hned pod světlým/tmavým motivem, zaškrtněte Velké tlačítko "Zaplatit". Pokladna, která už byla v provozu, si ponechá původní nastavení. Volba platí pro všechny pokladny a tablety provozovny.

Označit produkt jako "vyprodáno"

Každý může na obrazovce objednávky dlouze podržet produkt (nebo na něj kliknout pravým tlačítkem) a zvolit Vyprodáno. Produkt pak zešedne a nelze jej objednat na žádné pokladně. Stejným způsobem jej obnovíte volbou Opět k dispozici. Každá změna se zaznamená. Správce to může nadále dělat i v Nastavení → Produkty. Pokladní server také odmítne produkt označený jako "vyprodáno" ("Cola" je vyprodána), tedy i z tabletu, který změnu ještě nedostal, nebo u objednávek uložených offline; tento tablet pak ukáže "Nelze odeslat".

Kuchyňská obrazovka (KDS)

Vedle kuchyňských tiskáren (ne místo nich) může kuchyně nebo bar používat obrazovku. Na tabletu/PC v kuchyni otevřete http://<kassaserver>:3000/keuken, přihlaste se PINem a zvolte stanoviště: jsou to stejné názvy jako u tiskáren (kuchyně, bar, ...), takže obrazovka ukazuje přesně to, co by bylo na tom kuchyňském lístku. "Vše" ukazuje všechna stanoviště.

• Jeden lístek na objednávku, nejstarší první, se stolem/s sebou, číslem a dobou čekání (oranžově po 10, červeně po 20 minutách).
• Chody jsou zobrazeny zvlášť; chod, který ještě nebyl vyvolán, je šedý a označený "ČEKÁ na vyvolání". Storna jsou přeškrtnutá.
• Klepnutím na řádek jej označíte jako hotový, nebo Hotovo pro celý lístek. Obsluha pak v horní liště uvidí "Kuchyně: Stůl 5 je hotový". S volbou Nastavení → Podnik → Kuchyňská obrazovka → Zvuk pro obsluhu (ve výchozím stavu vypnuto) pokladna také zazvoní ("ding-dong", bez zvukového souboru). Prohlížeč povolí zvuk až po prvním klepnutí na obrazovku; zesilte hlasitost tabletu.
• Vrátit zpět ukazuje, co bylo za poslední hodinu označeno jako hotové, takže omylem odklepnuté položky lze vrátit.

Obrazovka se aktualizuje okamžitě. Kuchyňské lístky se tisknou jako obvykle; pokud obrazovku nepoužíváte, nepoznáte žádný rozdíl.

Kuchyňská obrazovka: předávání, pořadí a chod

Nastavení → Tiskárny → Kuchyňská obrazovka. Každou část lze zapnout zvlášť, ve výchozím stavu vypnuto; vypnutí vše zachová.

• Předávání mezi stanovišti, například studená → teplá → výdej. Pro každé stanoviště nastavíte pevné další stanoviště; na bonu je pak tlačítko → teplá (a vždy Předat na… pro výběr jiného stanoviště). Předávají se jen otevřené položky daného stanoviště. Stanoviště nemusí mít tiskárnu: zadejte stanoviště jako výdej do Stanoviště bez tiskárny. Hotovo (a upozornění obsluze) přijde až na posledním stanovišti. V zobrazení "Vše" je u předané položky vidět, kde právě je. Každý krok je uveden u položky a v protokolu.
• Změna pořadí: bony přetahujte (myší) nebo přesouvejte pomocí ◀ ▶ (dotyková obrazovka). Pořadí platí pro stanoviště a pro všechny obrazovky daného stanoviště; nové bony se řadí na konec.
• Další chod z kuchyňské obrazovky: u bonu s čekajícím chodem je Vyžádat chod 2. Obsluha pak dostane "Kuchyně žádá chod 2 pro Stůl 5" (se zvukem) a vyvolá jako obvykle; na kuchyňské obrazovce je "Chod 2 vyžádán · n min", dokud chod není vyvolán. Nebo zvolte Vyvolat: kuchyňská obrazovka pak vyvolá chod sama, s pracovním bonem "VYVOLÁNÍ CHODU 2", stejně jako tlačítko v pokladně.

Kuchyňská tiskárna vypnutá nebo bez kuchyňské obrazovky

Pokladna funguje vždy, i když je kuchyňská nebo barová tiskárna vypnutá (nebo bez papíru, nebo je uvolněný kabel), a i bez kuchyňské obrazovky:

• Objednávka projde vždy. Řádky se okamžitě nastaví jako objednané, účet je správný a placení funguje normálně. Tiskárny se oslovují současně a každá tiskárna dostane nejvýše asi 4 sekund: vypnutá tiskárna tedy nenechá ostatní (ani obsluhu) dlouho čekat.
• Tisková fronta. Kuchyňský lístek, který nešlo vytisknout, jde do tiskové fronty. Pokladní server to zkouší znovu každých 30 sekund po dobu patnácti minut; jakmile tiskárna znovu funguje, lístek vyjede s nápisem VYTIŠTĚNO POZDĚJI nahoře. Pokud se na této tiskárně podaří pozdější lístek, čekající lístky následují hned za ním.
• Po patnácti minutách se automatické opakování zastaví; Vytisknout znovu je pak stále možné.
• Kuchyňská obrazovka. Pokud je objednávka na kuchyňské obrazovce, kuchyně ji tam vidí, i když je tiskárna vypnutá. Pokud kuchyňskou obrazovku nepoužíváte, o nic nepřijdete: pokladna nikdy nečeká na "Hotovo" z kuchyně.
• Fronta se uchovává jen v paměti pokladního serveru (po restartu je prázdná).
• Totéž platí pro účtenku: pokud selže, placení je přesto dokončeno (pokladna hlásí "tisk se nezdařil") a kopii můžete vytisknout později v části Účtenky.

Chody (předkrm, hlavní jídlo ...)

Tlačítka chodů se zobrazují jen tehdy, když jsou potřeba: jakmile je na objednávce menu (složený produkt), nebo když už je něco v chodu 2 až 4. U běžných produktů, jako je cola, je nevidíte a vše jde rovnou do kuchyně. Není potřeba nic nastavovat.

Pod seznamem objednávky je Chod 1 2 3 4. Výchozí je chod 1 a vše funguje jako vždy: "Odeslat objednávku" pošle vše hned do kuchyně, bez nadpisů chodů na kuchyňském lístku. Pokud před klepnutím na produkty zvolíte chod 2 (nebo vyšší), pak:

• při "Odeslat objednávku" jdou do kuchyně, pod "-- Chod 2 · ČEKÁ na vyvolání --", aby se kuchyně mohla připravit;
• seznam objednávky ukazuje "Chod 2 · čeká" s tlačítkem Vyvolat;
• při Vyvolat dostane kuchyně lístek " VYVOLAT CHOD 2 " s tím, co se má udělat teď.

Chod 1 jde vždy hned. Je-li chod 2 už vyvolaný, jde i později doobjednané jídlo v chodu 2 hned.

Alergeny u produktů

Ve výchozím stavu vypnuto: alergeny se pak nikde nezobrazují. Zapněte přes Nastavení → Podnik → Zadávat a zobrazovat alergeny u produktů.

• Nastavení → Produkty: u každého produktu zaškrtněte 14 alergenů EU (lepek, korýši, vejce, ryby, arašídy, sója, mléko, ořechy, celer, hořčice, sezam, siřičitany, vlčí bob, měkkýši). V seznamu produktů se za názvem objeví zkratky.
• Obrazovka objednávky: každé tlačítko produktu ukazuje drobně zkratky (např. Gl Me) a tlačítko ⚠ Alergeny v liště skupin ukazuje úplné alergeny všech produktů ve zvolené kategorii s vysvětlením zkratek.
• Změny alergenů se zaznamenávají (staré → nové). Pokud je nastavení vypnuté, dříve zadané alergeny zůstanou zachovány.

All-you-can-eat

Ve výchozím stavu vypnuto. Zapíná se v Nastavení → Podnik → All-you-can-eat (jen správce). Vytvoříte jeden nebo více balíčků, např. Ryby, Maso a Sushi, každý s:

• názvem (objeví se na účtence: "Ryby dospělý", "Ryby dítě");
• cenou za dospělého a za dítě (včetně DPH) a sazbou DPH (výchozí NL LAAG, BE B);
• zahrnutými pokrmy (€ 0): celé kategorie a/nebo jednotlivé produkty (i z jiných kategorií, např. hranolky u Ryb i Masa);
• časovým limitem v minutách (0 = žádný);
• koly: nejvýše tolik pokrmů na osobu a kolo (0 = neomezeně) a nejméně tolik minut mezi dvěma koly (0 = žádné);
• příplatkem za plýtvání za kus (0 = žádný).

Šipkami ↑ ↓ nastavíte pořadí. To je důležité, když pokrm patří do více balíčků: pak se počítá k nejvyššímu balíčku, který si skupina zvolila. Smazat odebere balíček pro nové stoly; již probíhající stoly si ponechají své cenové řádky (méně osob je tam stále možné, více ne).

U stolu:

• Na obrazovce objednávek je nad účtenkou + All-you-can-eat. U každého balíčku zvolte počet dospělých a dětí; kombinovat lze (např. 2× Ryba a 2× Maso). Cena se přidá jako položky na účet; ty se do kuchyně neposílají. Počet hostů skupiny se nastaví na celkový počet účastníků (pokud pokladna eviduje počet hostů).
• U každého balíčku lišta ukazuje: osoby, zbývající čas (červeně, když čas vypršel), které kolo probíhá s maximem a za jak dlouho začne další kolo. Zahrnuté pokrmy jsou na tlačítkách označeny AYCE a na účtence se objeví se štítkem AYCE za € 0. Vše, co ve zvoleném balíčku není (nápoje, dezerty ...), se účtuje jako obvykle.
• Odeslat objednávku: každé "Odeslat objednávku" s pokrmy zdarma se počítá jako kolo, pro každý balíček zvlášť (jen balíčky, jejichž pokrmy jsou zahrnuty). Položky naťukané offline a odeslané později se neblokují.
• Upravit: upravte počty u každého balíčku. Méně osob se počítá jako storno (oprávnění "storno"). Nastavit balíček na 0 (nebo Ukončit pro vše) lze, dokud na účtu ještě nejsou žádné pokrmy z tohoto balíčku.
• Příplatek (jen pokud má zvolený balíček příplatek za plýtvání): zvolte počet (a balíček, je-li jich více); "Příplatek za plýtvání × počet" jde na účet.
• Placení, rozdělení, slevy a účtenka fungují jako vždy: ceny balíčků, příplatek a nápoje jsou běžné řádky s vlastní DPH.
• Pokud správce vypne all-you-can-eat, zatímco skupiny ještě probíhají, nově naťukané pokrmy stojí opět běžnou cenu; co už je na účtu, zůstane.
• V e-shopu (volitelné, ve výchozím stavu vypnuto): se zapnutým Také při objednávání u stolu přes QR kód (e-shop) vidí host, který objednává u stolu s balíčkem, pokrmy z balíčku jako V ceně za € 0, nahoře se stavem (osoby, kolo, čas). Objednávka je kolo, se stejnými pravidly jako Odeslat objednávku; příliš mnoho, příliš brzy nebo příliš pozdě e-shop hned odmítne. Nápoje a ostatní pokrmy host platí normálně; vše jde na účet stolu. Vypnuto = e-shop účtuje běžné ceny, jako dosud.

Dárkové poukazy

Dva přepínače v Nastavení → Podnik → Dárkové poukazy:

• Dárkový poukaz jako způsob platby při placení: ve výchozím stavu zapnuto, jako vždy. Vypnuto = tlačítko Dárkový poukaz se při placení nezobrazuje (ani u Vrátit přes při vrácení) a pokladní server platby dárkovým poukazem odmítá.
• Prodávat dárkové poukazy se zůstatkem: ve výchozím stavu vypnuto. Zapnuto:
  • Obrazovka objednávky ukazuje tlačítko Dárkový poukaz: zvolte částku (€ 10, 25, 50, 100 nebo jinou částku) a nechte pokladnu vytvořit kód, nebo naskenujte kód předtištěné karty. Dárkový poukaz jde na účet jako řádek (kód DPH BON: žádný obrat, žádná DPH, do kuchyně se neposílá). Tam také můžete zákazníkovi zjistit zůstatek.
  • Po zaplacení je dárkový poukaz aktivní a tiskárna účtenek vytiskne dárkový poukaz s částkou, kódem a QR kódem.
  • Uplatnění: při placení zvolte Dárkový poukaz a naskenujte nebo zadejte kód (tlačítko Zůstatek ukáže zůstatek). Částka se odečte ze zůstatku. Pokud je zůstatek nižší než účet, použije se celý zůstatek jako částečná platba a zbytek zaplatíte kartou nebo hotově. Zůstatek lze čerpat po částech.
  • Nechat kód prázdný = dárkový poukaz bez kódu, jako dříve (např. starý papírový poukaz).
  • Přehled → Dárkové poukazy (oprávnění Spravovat dárkové poukazy, ve výchozím stavu vedoucí a správce): hledání podle kódu, nevyčerpaný zůstatek, historie každého poukazu, zablokovat (ztracený/odcizený) a opravit zůstatek s uvedením důvodu. Zaznamená se to v protokolu.
  • Přehledy: prodané dárkové poukazy se nepočítají do obratu a jsou uvedeny zvlášť (Prodané dárkové poukazy); přijaté peníze se ale objeví u způsobů platby. Co se zaplatí dárkovým poukazem, je běžný obrat (s DPH) u způsobu platby Dárkový poukaz.
  • Účetnictví: prodané dárkové poukazy se účtují jako dal a uplatněné dárkové poukazy jako má dáti na účet Dárkové poukazy (zákaznický kredit).
  • Prodaný dárkový poukaz lze vrátit přes Účtenky → Vrátit, dokud ještě nebyl použit (zůstatek = hodnota). Po vrácení je poukaz zrušen (zůstatek 0, zablokován; viditelné v historii poukazu). Pokud už byl (částečně) použit, nastavte zůstatek na 0 v Přehled → Dárkové poukazy a zbytek vraťte zvlášť. Sleva na dárkový poukaz není možná.

Dobíjecí kredit (volitelné)

Pro kluby, sportovní kantýny, mládežnická centra a akce: dárkový poukaz se zůstatkem se stane dobíjecí kartou. Zapíná se v Nastavení → Provozovna → Dobíjecí kredit, pod dárkovými poukazy (standardně vypnuto; funguje jen tehdy, když je zapnuto Prodávat dárkové poukazy se zůstatkem).

• Karta nebo náramek: prodejte dárkový poukaz s Předtištěná karta a naskenujte kartu (čtečka NFC/RFID, která funguje jako klávesnice, nebo čárový kód). Číslo karty je pak kódem; host s ní platí jako s dárkovým poukazem.
• Dobití: objednávací obrazovka → Dárkový poukaz → Dobít kredit: naskenujte poukaz nebo kartu a zadejte částku. Přijde na účet jako řádek (kód DPH BON: žádná tržba, žádná DPH, stejně jako prodaný dárkový poukaz) a po zaplacení je na zůstatku. V historii poukazu je Dobito.
• Nejvyšší zůstatek na poukaz nebo kartu (standardně € 500, nastavitelné až do 5 000 €).
• Vrátit zbytek (zaškrtávací políčko, standardně vypnuto; oprávnění Spravovat pokladní zásuvku): po Zjistit zůstatek se zobrazí Vrátit zbytek. Zůstatek klesne na € 0 a částka je na X- a Z-zprávě uvedena jako peníze ze zásuvky (Tegoed terugbetaald …).
• Dobití lze vrátit přes Účtenky → Vrácení, dokud je zůstatek ještě alespoň tato částka; poukaz nebo karta zůstává platná.
• Dobití na kiosku (volitelné): viz Samoobslužný kiosek.

Stravenky

Jen pro provozovny v Belgii, standardně vypnuto: Nastavení → Provozovna → Zaplatit → Stravenky. Stravenky jsou zaměstnanecký benefit: zaměstnavatel je nahraje na kartu zaměstnance (Edenred, Monizze nebo Pluxee). Host jí platí na běžném platebním terminálu; propojení s vydavateli není potřeba.

• Zapnuto: při placení je tlačítko Stravenka. Vyberte vydavatele (jen vydavatele, které provozovna přijímá) a nechte hosta přiložit kartu k platebnímu terminálu, stejně jako při platbě kartou. Bez propojení s terminálem: host zaplatí přímo na platebním terminálu a vy klepnete na Zaplatit.
• Žádné spropitné ani vracení drobných se stravenkami. Je-li zůstatek příliš nízký, host doplatí zbytek jinak (účet zůstane otevřený, dokud není vše zaplaceno).
• Jen pro určité skupiny produktů (volitelné, např. jídlo, ale ne alkohol): pak lze stravenkami zaplatit nejvýše částku za tyto produkty na účtu. Obrazovka placení ukáže kolik; zbytek host zaplatí jinak.
• Na účtence: Stravenka Pluxee (s vydavatelem za tím).
• Z-zpráva a X-zpráva: pro každého vydavatele vlastní řádek (Stravenka Edenred, … Monizze, … Pluxee).
• Účetnictví: pro každého vydavatele vlastní účet hlavní knihy (Stravenky Pluxee (pohledávka) atd., standardně 416100, 416200 a 416300), protože peníze přicházejí od vydavatele, a ne od banky platebního terminálu.
• Potřeba: smlouva s každým vydavatelem, jehož stravenky přijímáte, a platební terminál, který tyto karty přijímá (ověřte si to u dodavatele platebního terminálu).

Cizí měna

Placení hotově v jiné měně, např. britští nebo američtí turisté, nebo v příhraničí se švýcarským frankem. Standardně vypnuto: Nastavení → Provozovna → Zaplatit → Cizí měna. Přidejte měny (CHF, CZK, DKK, GBP, HUF, NOK, PLN, SEK, TRY, USD) a ke každé kurz: kolik eur počítáte za 1 jednotku (např. 1 GBP = € 1,15).

• Zadáno ručně: pevný kurz; když se změní, upravte ho sami.
• Živě (ECB): denní kurz Evropské centrální banky (referenční kurzy, každý pracovní den kolem 16:00; zdarma, bez účtu). S přirážkou v procentech (0-20) je kurz o tolik nižší, aby provozovna směnu neplatila sama. Pokladna stáhne kurzy sama, když jsou starší než 6 hodin; Aktualizovat nyní je stáhne hned. Bez internetu zůstane poslední kurz.
• Zapnuto: při placení je tlačítko Cizí měna. Zvolte měnu; pokladna ukáže, kolik to v této měně dělá. Zadejte, kolik host dává: pokladna to přepočítá a vrátí rozdíl v eurech. Pokud host nechce nic vrátit, zaškrtněte Vrácení je spropitné: vrácená částka přijde na účtenku jako spropitné, v Belgii v této měně (GKS 2.0, UC296).
• Dá-li host méně než celou částku, jde o část; zbytek zaplatí jinak.
• Na účtence: měna, částka a kurz a vrácení v eurech.
• X- a Z-zpráva: pro každou měnu vlastní řádek (Cizí měna GBP, v eurech) a u pokladní zásuvky, co je v zásuvce v této měně. Vrácení v eurech se odečte od očekávané hotovosti v zásuvce; samotnou cizí měnu počítáte zvlášť.
• Účetnictví: počítá se jako hotovost (pokladna), v eurech.

Další tlačítka pro objednávání a placení

Tlačítka pro to, co nepotřebuje každá provozovna. Ve výchozím stavu je vše vypnuto; zapíná se po jednotlivých tlačítkách v Nastavení → Provozovna → Objednávání a placení (oprávnění Nastavit podnik, platby a tiskárny). Vypnuto = tlačítko není nikde v pokladně a pokladní server akci odmítne. V Nizozemsku vše funguje bez černé skříňky; v Belgii tlačítko funguje teprve tehdy, když byla tato funkce otestována s černou skříňkou (u tlačítka je to uvedeno, dokud tomu tak není).

Při otevření stolu:

• Evidovat počet hostů: otázka "Kolik osob?" u volného stolu, hosté na plánku a na obrazovce objednávek a hosté v přehledech. Viz Počet hostů.

Při objednávání (objednávací obrazovka, pro to, co potom klepnete):

• Sčítat stejné produkty (bez tlačítka, ve výchozím nastavení zapnuto): když znovu klepnete na stejný produkt (stejné možnosti, ještě neobjednaný), zvýší se množství místo přidání nového řádku: 4 Cola na jednom řádku s cenou krát 4. Tlačítkem − se jeden zase odebere, i když už je objednaný (storno jednoho). S poznámkou, místem nebo s sebou zůstane samostatný řádek; co už je objednané, zůstane samostatný řádek (nové kolo).
• − a + (před cenou na každém řádku): − jeden odebere, + jeden přidá (stejný produkt, možnosti a poznámka; je-li Sčítat stejné produkty vypnuto, nový řádek). Ještě neobjednané a na 0: řádek zmizí. Už objednané: jeden méně je storno, ten řádek zůstane přeškrtnutý (pro kuchyni a přehledy); jeden navíc je nový řádek, který se ještě musí objednat. Klepnutí na samotnou cenu už nic neodebere. U menu jen −.
• S sebou (jen na místě): host si tento produkt vezme s sebou, např. lahev vody nebo dezert. Tato položka dostane DPH pro prodej s sebou (v Belgii označení C), zbytek účtu DPH pro konzumaci na místě. Na účtence je u položky s sebou.
• Místo (u stolu): klepejte dál pro místo 1, 2, 3 ...; položky dostanou toto číslo místa (i na kuchyňském lístku). V Belgii jde každá položka do černé skříňky s nákladovým střediskem místa (CHAIR, UC4123). Ještě jednou po místě 12 = opět bez místa.
• Zpětný odběr: další produkt se přidá s -1, např. prázdná lahev nebo kelímek (záloha). To jde jen u produktů s volbou Vratné (záloha) (Nastavení → Produkty). Je-li celý účet záporný (jen vrácená záloha, bez prodeje), stane se z Zaplatit vrácení peněz: hotově nebo kartou (vráceno přímo na terminálu). V Belgii jako vrácení peněz (REFUND, UC4108 a UC4114).
• Uplatnit SPV: host platí produkt nebo menu poukazem single purpose voucher (poukaz právě na tento produkt, např. "1 menu all-in"). Klepněte na Uplatnit SPV a potom na produkt na účtence: přidá se s -1 (stejná cena a DPH, u menu se složkami), s označením SPV. Nejde do kuchyně; odstranit ho lze normálně. Poukazový produkt prodáváte předem jako běžný produkt; v Nastavení → Produkty u něj zapněte SPV (poukaz). V Belgii jde položka při prodeji do černé skříňky jako VOUCHER (UC271).
• Odečíst předplatbu: viz níže.
• Otevřená cena (bez tlačítka, u produktu): u produktu s volbou Otevřená cena se pokladna zeptá na cenu, např. u denního menu nebo předplatby.

Při placení:

• Přímé placení bez objednávkového lístku (není tlačítko): ve výchozím nastavení Zaplatit nejprve objedná, co ještě objednáno nebylo, aby kuchyně a bar vždy dostaly svůj lístek (viz Tlačítko Objednat). Zapnuto: na to, co zaplatíte hned bez předchozího klepnutí na Objednat, se objednávkový lístek nevytiskne, např. u baru, kde si to vezmete sami. Na tom, co už bylo objednáno, se nic nemění.
• Zaplatit zvlášť (u stolu, v Rozdělení účtu): zvolte, co jeden host teď platí, i část položky (½ pro půl lahve). Z toho vznikne samostatná část, kterou hned zaplatíte; zbytek zůstane na účtu, aniž byste účet nejdřív rozdělili nebo přesunuli do jiné skupiny. Procentní sleva na celou účtenku se započítá poměrně. Zpět bez placení = vše opět na účtu. V Belgii zůstane prodej na místě stolu, bez změny stolu (UC4103bis, UC4104).
• Host odešel bez placení (oprávnění Uzavřít bez platby, ve výchozím stavu jen manažer a správce): účet se uzavře jako prodej bez platby, s důvodem v protokolu. Na X- a Z-zprávě a v denním výkazu je uveden jako Nezaplaceno (host odešel); v účetním zápisu na nedobytné (výchozí 4985 / 643000). V Belgii prodej bez platby (UC4109).

Dodatečně (Účtenky):

• Opravit cenu (oprávnění Opravit cenu účtenky, ve výchozím stavu jen manažer a správce): cena zaplacené účtenky nesouhlasila, např. sleva 50% místo 5%. Pokladna vytvoří novou účtenku bez stolu s vrácenými položkami staré účtenky (záporně, za cenu tehdy zaplacenou) a stejnými produkty znovu za běžnou cenu. Zadejte tam správnou slevu a doúčtujte rozdíl (nebo vraťte peníze, pokud je nová cena nižší). Stará účtenka zůstane, jak byla; jednou na účtenku, a ne pokud už bylo něco vráceno. V Belgii jdou staré položky jako CORRECTION (UC4116).

Kód: apps/pos-server/src/lib/kassaopties.ts, routes/kassaopties.ts; obrazovka KassaOpties.tsx. Protokol: Nastavení změněno, SPV uplatněno, Opravit účtenku, Nezaplaceno.

Odečíst předplatbu

Předplatbu (zálohu, např. na oslavu nebo rezervaci) prodáváte jako běžný produkt se zapnutou volbou Předplatba (Nastavení → Produkty; má vždy otevřenou cenu). Vytvořte jeden pro každou sazbu DPH, pokud má být předplatba podle sazby (např. Předplatba jídlo a Předplatba nápoje), nebo jeden produkt, pokud je částí nabídky. Host zaplatí předplatbu předem a dostane účtenku.

Zapnutí: Nastavení → Provozovna → Objednávání a placení → Odečíst předplatbu (ve výchozím stavu vypnuto). Při konečném placení klepněte na objednávací obrazovce na Odečíst předplatbu a zadejte číslo účtenky předplatby. Pokladna přidá položky předplatby z této účtenky na účet se záporným počtem (stejný produkt, cena a DPH). Co už bylo odečteno, nelze odečíst znovu. Je-li předplatba vyšší než účet, dostane host rozdíl zpět (vrácení peněz). V Belgii jdou odečtené položky do černé skříňky jako vrácení peněz (REFUND) (UC4110, UC4111, UC4113). Protokol: Předplatba odečtena.

Účtenka e-mailem

Ve výchozím stavu vypnuto. Zapněte přes Nastavení → Podnik → Účtenka i e-mailem.

SMTP_HOST=smtp.voorbeeld.nl
SMTP_PORT=587
SMTP_GEBRUIKER=kassa@voorbeeld.nl
SMTP_WACHTWOORD=...
SMTP_AFZENDER=bon@voorbeeld.nl

Po vyplnění pokladnu restartujte. Placení pak ukazuje pole Poslat účtenku i e-mailem (volitelné): nechat prázdné = jen tisk, jako vždy; zadat e-mailovou adresu = stejná účtenka (s rozpisem DPH a fiskálními řádky) se hostovi pošle i e-mailem, s názvem podniku jako odesílatelem.

• E-mailová adresa se neukládá; protokol ukazuje jen "účtenka N odeslána na a***@domena.cz" a zda se to podařilo.
• Pokud odeslání e-mailu selže (např. špatné přihlašovací údaje), účtenka je přesto zaplacena a vytištěna; hlášení řekne, co se pokazilo.
• Ne při částečné platbě (rozdělení účtu): účtenka přichází s poslední platbou, takže adresu zadejte tam.
• Poslat dodatečně: v části Účtenky má každá účtenka tlačítko E-mail (oprávnění Vytisknout kopii účtenky). Pošle účtenku označenou KOPIE, stejně jako vytištěnou kopii (v Belgii evidovanou jako kopie).
• Nejsou potřeba žádné další balíčky: pokladna komunikuje s poštovním serverem sama (STARTTLS na 587, TLS na 465).

Rezervace

Zapněte v Nastavení → Podnik → Rezervace (ve výchozím stavu vypnuto). Tam také nastavíte, kolik minut předem se rezervovaný stůl objeví na plánku (výchozí 60) a výchozí délku rezervace (výchozí 120 minut).

• Tlačítko Rezervace v horní liště: přehled po dnech (◀ ▶) s počtem rezervací, hostů a nedostavení se. + Nová rezervace: jméno, telefon, e-mail, hosté, datum, čas, délka, stůl (lze doplnit později) a poznámka. Rezervace zadává obsluha; online rezervace (zatím) nejsou.
• Pokud má stejný stůl v tomto časovém úseku už rezervaci, pokladna vás upozorní; "Přesto uložit" je možné.
• Potvrzení e-mailem (zaškrtávací políčko, nebo později "E-mail"), pokud je zadána e-mailová adresa a poštovní server (SMTP_HOST, viz Účtenka e-mailem).
• Na plánku je rezervovaný volný stůl fialový s "R 19:30 Jansen (4)". Klepněte na něj: "Jansen dorazil" otevře stůl s 4 hosty a "Jansen" jako názvem skupiny; "Jiní hosté" jej jednoduše otevře.
• V přehledu: Dorazil (otevře stůl; bez stolu nejprve stůl vyberete), Upravit, Nedostavil se, Zrušit a Obnovit. Vše se zaznamenává v protokolu.
• Rezervace z online platforem: viz Rezervační platformy níže.

Propojení pokladny s TheFork: stůl se otevře při příchodu, účet zpět

Díky POS API TheFork pokladna spolupracuje s TheFork Managerem (ve výchozím stavu vypnuto), navíc ke stahování rezervací popsanému výše. Zapíná se v Nastavení → Rezervační platformy → Propojení pokladny s TheFork; běží přes správcovský portál.

• Když v TheFork Manageru nastavíte hosta na Dorazil nebo U stolu, v pokladně se otevře stůl se stejným názvem, s počtem hostů a poznámkou: jméno, alergie a dieta, záloha, nabídka/sleva a věrnostní body (Yums). Pokud je na tom stole už otevřená objednávka, propojí se. Žádný stůl s tímto názvem: upozornění, a stůl vyberete v Platformy.
• Po zaplacení jde účet do TheFork (celkem a řádky s názvem, skupinou produktů, množstvím a částkou); TheFork pak nastaví rezervaci na Odešel. Při rozdělené platbě jeden účet s celkovou částkou. Pokud se to nepodaří, pokladna to zkouší znovu každou čtvrthodinu (dva dny), nebo tlačítkem Odeslat znovu v Platformách.
• Párování: pokladna zobrazí párovací kód; zadejte ho v TheFork Manageru (Integrace → pokladna). ID restaurace TheFork (Customer-id) zadá správce, nebo přijde automaticky s první objednávkou.
• Zaškrtávací políčka: automaticky otevřít stůl, jméno, alergie a záloha jako poznámka, účet do TheFork.
• Podmínka: Pin Voordeel má API klíč TheFork (jen pro partnery) a zaregistroval tam pokladnu jako POS (tlačítko ve správcovském portálu); TheFork propojení spustí po testovací relaci.

Dokumentace TheFork: https://docs.thefork.io/POS-API/introduction

Pořadník pro hosty bez rezervace

Pro hosty bez rezervace, kteří čekají na stůl. Zapněte v Nastavení → Podnik → Pořadník (hosté bez rezervace) (ve výchozím stavu vypnuto). Viditelné jen tehdy, je-li nastaveno SMS přes CM.com; jinak se pořadník v pokladně nikde neobjeví (ani v nastavení). Funguje odděleně od rezervací: i když jsou vypnuté. Tam také nastavíte text zprávy (prázdné = "Hallo {naam}, uw tafel bij {zaak} is klaar. Wilt u zich melden bij de bediening?"; {naam}, {zaak} a {personen} se doplní).

• Tlačítko Pořadník v horní liště, s počtem čekajících (oranžově, když někdo čeká). + Přidat do pořadníku: jméno, telefon (pro SMS), osoby, slíbená čekací doba a přání (terasa, dětská židlička).
• Seznam je v pořadí příchodu a ukazuje, jak dlouho každý host čeká (červeně, když to trvá déle než slíbeno), nahoře s počtem čekajících, osobami a dnešní průměrnou čekací dobou.
• Pokud SMS selže, zobrazí se důvod. Poslat SMS znovu je možné.
• Usadit: zvolte stůl; pokladna ho otevře s počtem hostů (pokud pokladna eviduje počet hostů) a jménem jako názvem skupiny (stejně jako u přicházející rezervace).
• Odešel (odešel nebo zrušil) a Obnovit. Pod seznamem vidíte, kdo byl dnes usazen nebo odešel, a jak dlouho čekal.
• Soukromí: telefonní čísla se po dni vymažou; kdo je na seznamu ještě po 12 hodinách, je automaticky odstraněn. Přidání, vyvolání (jen s posledními 3 číslicemi čísla) a usazení se zaznamenávají v protokolu.
• Proč ne u Rezervací? Rezervace je na později (datum, čas, stůl předem); pořadník je na teď (pořadí, čekací doba, SMS, když je stůl volný). Proto samostatný přepínač a tlačítko, se stejným "otevřením stolu" jako u rezervace.
• Online do pořadníku (volitelné, ve výchozím stavu vypnuto; jen s e-shopem): se zapnutým Hosté se mohou zapsat i sami přes e-shop je v e-shopu Pořadník (a je k němu QR kód ke dveřím, ve správě e-shopu u Stoly a QR). Host vyplní jméno, telefon, počet osob a přání a vidí živě své pořadí. V pokladně je v seznamu s označením online; vyvolání, usazení a odchod fungují jako vždy a host to vidí i v telefonu (tam se může i odhlásit).

Zákaznická karta / body

Zapněte v Nastavení → Podnik → Zákaznická karta / body (ve výchozím stavu vypnuto, pak z toho nikde nic není vidět). Tam také nastavíte: body za euro (0 = jen razítkové karty), po kolika bodech je odměna a kolik eur slevy tato odměna dává.

• V pokladně se nad účtenkou objeví "+ Zákaznická karta": vyhledejte zákazníka podle jména nebo telefonního čísla, nebo vytvořte nového zákazníka (jméno, případně telefon a e-mail). Jméno a stav bodů se pak objeví na účtence.
• Uplatnění: s dostatkem bodů "Uplatnit 100 bodů: € 5 sleva"; s plnou razítkovou kartou "Káva zdarma" (káva musí být na účtence). Z toho se stane řádek se slevou; kdokoli jej může zase odebrat.
• Body a razítka se připisují a odepisují jen při placení: body z částky po slevě (bez prodaných dárkových poukazů), razítka za každý kus produktu s razítkovou kartou (produkt zdarma se nepočítá).
• Na účtence: získáno, uplatněno, stav a postup razítkových karet.
• Přehled → Zákazníci (oprávnění Spravovat zákaznickou kartu): hledání zákazníků, úprava údajů, oprava bodů (s důvodem), historie a smazání (GDPR: jméno, telefon a e-mail odstraněny; historie zůstane anonymní). Dole jsou razítkové karty podle produktu (např. 10 káv = 1 zdarma).
• Vrácení automaticky neodečte získané body; v případě potřeby je opravte v Přehled → Zákazníci.
• Zákaznická karta s číslem (volitelné): v Přehled → Zákazníci → (zákazník) zadejte číslo karty (nebo kartu naskenujte do toho pole). Se čtečkou čárových kódů sken této karty propojí zákazníka s účtenkou, na pokladně i na kiosku. Hledat podle čísla karty můžete také přes + Zákaznická karta.

Profil hosta: VIP, stravovací požadavky a preference (volitelné)

Zapíná se v Nastavení → Provozovna → Profil hosta, pod zákaznickou kartou (ve výchozím stavu vypnuto; funguje jen při zapnuté zákaznické kartě). Potom:

• Na objednávací obrazovce je pod propojeným zákazníkem "+ Profil hosta": zaškrtněte VIP, zvolte stravovací požadavky (vegetariánské, veganské, pescetariánské, halal, košer) a alergie (14 alergenů) a napište preference (např. "stálý stůl u okna", nejvýše 300 znaků). Potom se zobrazí u zákazníka na objednávací obrazovce, alergie červeně. Změnit je lze také v Přehled → Zákazníci → (zákazník) → Profil hosta.
• Když klepnete na produkt s alergenem hosta (viz Alergeny u produktů), pokladna se nejdřív zeptá, zda ho přesto přidat. Platí jen to, co je u produktu vyplněno; v případě pochybností se vždy zeptejte kuchyně.
• VIP dostane ★ na plánku: u otevřeného účtu a u zobrazené rezervace tohoto zákazníka. Když hosté z rezervace přijdou, pokladna propojí zákazníka z rezervace s účtem.
• Stravovací požadavky a alergie (a VIP) se objeví na kuchyňském lístku pro kuchyň a bar: GAST: VIP · Vegetarisch · allergie: Noten.
• Stravovací požadavky a alergie jsou údaje o zdraví: vyplňujte je jen se souhlasem hosta. V protokolu je jen to, že byl profil změněn, ne samotné požadavky. Smazáním zákazníka se odstraní i profil hosta.

Oblíbené / rychlá tlačítka

Ve výchozím stavu vypnuto. Nastavení → Podnik → Oblíbené / rychlá tlačítka:

• Nejprodávanější: na začátku lišty skupin tlačítko ★ Oblíbené s 12 nejprodávanějšími produkty za posledních 14 dní (aktualizuje se automaticky). Obrazovka objednávky se otevře na oblíbených.
• Vybrat sám: na obrazovce objednávky dlouze podržte produkt (nebo klikněte pravým tlačítkem) a zvolte ★ Oblíbené (rychlé tlačítko); znovu = odebrat. Oprávnění Spravovat produkty. Všechny pokladny to vidí okamžitě.
• Zadávání položek, možnosti, menu, happy hour a "vyprodáno" fungují u oblíbených přesně jako v běžných skupinách.

Ještě jedno kolo

Obrazovka objednávky ukazuje tlačítko ↻ Ještě jedno kolo (jakmile je něco na účtu, i když to ještě není objednáno). Jedno klepnutí přidá poslední kolo (vše odeslané najednou přes "Odeslat objednávku", nebo co jste právě naťukali) ještě jednou jako nové řádky; pak už jen klepněte na Odeslat objednávku. Ceny jsou aktuální (včetně happy hour).

• Dlouhé podržení (nebo pravé tlačítko myši): vyberte si sami. Šipkami ◀ ▶ listujete k dřívějším kolům, každý produkt zapněte/vypněte (např. odškrtněte jídlo) a změňte počet pomocí − / +. Možnosti a poznámky se přenesou.
• Vyprodané produkty a menu se nepřenesou (menu zadejte zvlášť). Funguje i bez připojení.
• Řádky se přidají tak, jak jsou na účtu: se zapnutou volbou Sčítat stejné produkty jeden řádek na produkt (2 Cola), s vypnutou každý řádek zvlášť (2× 1 Cola).

Čas u stolu na plánku

Každý obsazený stůl ukazuje ⏱ 45m · 12m: jak dlouho je stůl obsazen a před jak dlouhou dobou bylo naposledy něco zadáno (podržte stůl nebo na něj najeďte myší pro přesné časy). Pokud se nějakou dobu nic neobjednalo, stůl dostane oranžový okraj: čas se zeptat. Počet minut nastavíte v Nastavení → Podnik → Čas u stolu (výchozí 20, 0 = bez oranžového okraje). Pokud ještě nic zadáno nebylo, čas se počítá od otevření stolu.

Pokud u jednoho stolu sedí více skupin (samostatné účty), je tam řádek pro každou skupinu, např. S1 ⏱ 50m · 12m a Jansen ⏱ 10m (název skupiny, jinak číslo skupiny). Skupina, která je příliš dlouho nečinná, dostane oranžový štítek a stůl oranžový okraj.

Přesunout celý stůl

Na obrazovce objednávek je Přesunout stůl. Vyberte prostor (např. Terasa) a stůl: všechny skupiny u stolu se přesunou s ním, každá se svým vlastním účtem. Pokud vyberete obsazený stůl, stoly se sloučí (skupiny se přidají). Chcete-li přesunout jen část, použijte jako dříve Rozdělit / přesunout. Má-li být vše na jednom účtu, použijte Sloučit.

Pracovat dál offline (tablet bez Wi-Fi)

Pokud se spojení mezi tabletem a pokladním serverem přeruší (Wi-Fi na terase, server krátce vypnutý), objeví se žlutá lišta a tablet pracuje dál s naposledy uloženými stoly, produkty a otevřenými objednávkami:

• otevírání stolů, zadávání produktů a Odeslat objednávku se ukládají v tabletu (i když se restartuje) a v seznamu objednávky se objeví s tečkovaným okrajem ("ještě neodesláno");
• jakmile je spojení zpět, vše jde na server v pořadí a teprve pak jde kuchyňský lístek do kuchyně. Každý balíček má klíč, takže nic nedorazí dvakrát. Pokud mezitím stůl otevřel někdo jiný, produkty se přidají k té objednávce;
• placení, slevy, rozdělení a podobně fungují jen s připojením; "Zaplatit" čeká, dokud není vše pro tento stůl odesláno.

Počet hostů

Volitelné a ve výchozím stavu vypnuto: Nastavení → Provozovna → Objednávání a placení → Evidovat počet hostů. Vypnuto = co nejméně klepnutí: volný stůl se otevře jedním klepnutím, hosté se nikde nezobrazují a přehled, nástěnka i denní souhrn neukazují hosty ani útratu na hosta.

Zapnuto: když klepnete na volný stůl, pokladna se zeptá na počet osob (velká tlačítka 1-8 nebo zadání; "Přeskočit" = 1). Na plánku je u obsazeného stolu "3/4 os." (osoby/místa, žlutě, pokud sedí víc lidí, než je míst). Na obrazovce objednávek to změníte tlačítkem "3 os." v liště skupin; u více skupin stůl sčítá všechny skupiny.

Bez počtu hostů vše funguje dál: Rozdělit rovným dílem při placení začíná na 2, all-you-can-eat se sám ptá na počet dospělých a dětí a rezervace i pořadník si drží vlastní počet osob (stůl se pak otevře bez hostů).

Záznamy HACCP

Každý gastronomický podnik musí sledovat a zaznamenávat bezpečnost potravin: v Nizozemsku podle Hygiënecode voor de Horeca (hygienický kodex pro gastronomii, kontrola NVWA), v Belgii podle autokontroly FAVV (příručka G-023). Zapni Záznamy HACCP v Nastavení → Zákony a předpisy (ve výchozím stavu vypnuto).

• Měřicí místa (správce): např. chladicí box, mrazák, udržování v teple, teplota v jádře po tepelné úpravě, zchlazování a příjem zboží, s minimem a/nebo maximem v °C a četností (každý den, dvakrát denně, každý týden nebo při použití). Přidat standardní seznam vytvoří výchozí základ (chlazení do 7 °C, v Belgii do 4 °C; mrazák do -18 °C; udržování v teple od 60 °C; tepelná úprava od 75 °C).
• Úklid a kontrola: úkoly denní, týdenní (případně v pevný den) nebo měsíční, s prostorem a pokyny, např. dezinfekce prkének, tukové filtry, kontrola škůdců, kontrola teploměru.
• Zaznamenávání (každý přihlášený): tlačítko HACCP v horní liště s počtem položek, které dnes ještě zbývají. Zadej teplotu nebo odškrtni úkol (Hotovo nebo Nepodařilo se). Pokud je teplota mimo limit, je nutné nápravné opatření (např. "zavřené dveře, vyhozený produkt"). Záznamy nelze měnit; chybu opravíš novým záznamem.
• Přehled (oprávnění Tržby za období): za období všechny záznamy, počet odchylek a zmeškané záznamy po dnech; jako CSV (Excel) nebo k tisku / uložení jako PDF pro kontrolu.

Výčepní systém a průtokoměry

Každé natočení, které nahlásí výčepní počítač nebo průtokoměr, jde na účet, takže nic "neuteče". Zapněte to v Nastavení → Výčepní systém (výchozí stav vypnuto).

• Zdroje (správce): výčepní počítač nebo systém průtokoměrů. Zvolte značku; pokladna vyplní předvolbu. Z Nizozemska a Belgie: Van Duijnen Horeca (automatizace výčepu, Dashbar), Beconet (Multi-Tap), TapSystems, Horecatechniek Nederland, Heineken SmartDispense, WeissBeerger / AB InBev a BarTrack; dále Gruber, Addimat, WMF / Hogatron (E-Protokoll), Drinkotec (ex-Hartec), , Berg, Easybar, Azbar, Scanabar, PourMyBeer, iPourIt, BeerBoard, US BeerSAVER, Bevchek, Capton/BarVision, Kegtron, Kegbot Kegboard, "chytrý kohout" nebo vlastní systém. Připojit lze pěti způsoby (Kegboard: viz Dávkované točení a Kegboard níže):
  • Pole: kraan (nebo tap, plu), ml (nebo cl, liter, volume s eenheid) nebo porties, id (stejné natočení dvakrát = zaúčtováno jednou), tijdstip, tafel, bediening; jedno natočení, seznam nebo { "taps": [...] }.
  • Síť (TCP): pokladna se připojí k výčepnímu počítači (adresa a port) nebo sama naslouchá na portu.
  • Sériový port: port COM nebo USB sériový, 1200–115200 baud, 8N1, 7E1 nebo 7O1.
  • U sítě a sériového portu nastavíte formát zprávy (jedna zpráva na řádek, nebo STX … ETX s volitelnou kontrolou XOR a ACK/NAK zpět) a vzor zprávy s částmi kraan nebo plu a případně ml, cl, liter, porties, tafel, bediening a id (např. kraan;ml nebo jen PLU za sklenici). Dodavatelé dávají přesný formát jen instalačním technikům; zeptejte se dodavatele výčepního počítače. Testovací natočení pošle natočení tak, jak by to udělal výčepní počítač.
• Kohouty (správce): pro každý kohout nebo PLU produkt a jak se dostane na účet: za sklenici (sklenice v ml; natočení 520 ml se sklenicemi 250 ml = 2 sklenice; od 50% se počítá sklenice) nebo za litr (cena produktu je cena za litr; na účtu např. "Ležák 0,33 l" za správnou částku).
• Na účtu: pokud výčepní počítač nahlásí stůl, natočení jde rovnou na otevřenou objednávku toho stolu. Jinak se objeví v Natočeno: na obrazovce objednávky se zobrazí lišta "… × natočeno bez účtu"; vyberte natočení a klepněte na Na tento účet. Řádky jsou hned ve stavu objednáno (na bar už nejde žádná bonovačka) a odečte se sklad. Tlačítko Natočeno v horní liště ukazuje vše, co ještě nemá účet.
• Odepsat (oprávnění Storno): proplach, rozbití, ochutnávka, personál, zdarma nebo ostatní (s poznámkou); zapíše se do protokolu. Méně než na sklenici (např. proplach) se musí odepsat.
• Přehled (oprávnění Tržby za období): pro každý kohout natočeno, na účtu, odepsáno (podle důvodu), zrušeno a ještě otevřené, v litrech, s procentem prodaného, a jako CSV.
• Nahlášená natočení nelze měnit (jen vyřídit).

Dávkované točení a Kegboard

Při dávkovaném točení se kohout otevře až poté, co byla sklenice namarkována na pokladně, a to jen pro toto množství. Nenatočí se tak nic, co není na účtence. Funguje to jen tehdy, když je výčepní systém zapnutý, a zapíná se pro každý kohout zvlášť (ve výchozím stavu vypnuto).

• Pro každý kohout (správce, Nastavení → Výčepní systém → Kohouty): zaškrtněte Dávkované točení a zvolte, jak dlouho smí být kohout po namarkování otevřený (10–600 sekund, výchozí 120). U Kegboardu zadáte také relé (elektromagnetický ventil). Dávkované točení je možné jen po sklenicích.
• Namarkování: při Objednat (nebo při přímém Zaplatit) vytvoří pokladna pro každý řádek účtenky s tímto produktem uvolnění (počet sklenic × sklenice v ml) a pošle ho výčepnímu počítači. Natočení, které poté přijde, patří k tomuto řádku účtenky. Nepřidá se tedy znovu na účtenku ani do Natočeno. Natočení bez uvolnění jde normálně do Natočeno.
• Storno řádku před natočením: kohout se znovu zavře. Uvolnění, které není včas natočeno, vyprší; kohout se nikdy neotevře dodatečně.
• Uvolnění na obrazovce objednávek (lišta nad účtenkou): co právě probíhá, Ukončit a Znovu uvolnit. Znovu uvolnit lze jen tehdy, pokud ještě nic nebylo natočeno, takže se nikdy neuvolní nic navíc. Testovací uvolnění (správce) uvolní jednu sklenici bez účtenky; zapíše se do protokolu.
• Jak se uvolnění dostane k výčepnímu počítači:
  • Kegboard (Kegbot, open source, ESP32 s průtokoměry a elektromagnetickými ventily; plně veřejný protokol): pokladna vydá grant pro kohouty s tímto produktem, relé a množství. Deska zavře kohout sama, když je dosaženo množství nebo vyprší čas.
  • Síť/sériově: nastavitelný příkaz k uvolnění s {kraan}, {ml}, {porties}, {sec} a {id} (např. V{kraan};{ml}), odeslaný ve formátu zpráv zdroje (řádek nebo STX … ETX s XOR). Volitelně je k dispozici příkaz k zastavení. Přesný příkaz sdělí dodavatel.
• Spárování Kegboardu: v + Zdroj zvolte značku Kegbot Kegboard. Deska se ohlásí u zdroje; klikněte na Povolit (nebo Zamítnout). Deska pak jednou dostane vlastní klíč, který pokladna ukládá pouze jako hash. Jiné zařízení nebo chybný klíč na spárované desce nic nezmění; pokud deska svůj klíč ztratila, použijte nejprve Zrušit spárování. Zdroj zobrazuje firmware, měřiče a relé desky. Kohouty jsou čísla měřičů (0, 1 …). Karta přiložená k desce se odmítne: platí se u pokladny. Je-li výčepní systém vypnutý, deska si zprávy uloží a odešle je později.
• U zdroje nastavíte, po kolika sekundách bez průtoku se kohout zavře (5–300, výchozí 30). U každého kohoutu vyplníte číslo měřiče, relé (elektromagnetický ventil) a jak dlouho smí kohout zůstat otevřený po namarkování.

Ovládání hudby z pokladny

Personál ovládá hudbu z dotykové obrazovky pokladny, takže na baru není potřeba samostatná obrazovka. Zapněte to v Nastavení → Provozovna → Obrazovky a ovládání → Ovládání hudby z pokladny (ve výchozím stavu vypnuto). Pak se v horní liště objeví tlačítko Hudba: pro každý zdroj (např. Bar a Terasa) Přehrát, Pozastavit, Další, Předchozí, Hlasitěji, Tišeji a posuvník hlasitosti, spolu s tím, co právě hraje. Zpět do pokladny panel zavře. Po vypnutí zůstanou zdroje uložené.

• Playlist (Sonos, Bluesound a VLC): fronta s tím, co právě hraje. Klepnutím na skladbu ji přehrajete; tlačítkem Upravit skladby odeberete (✕), posunete výš nebo níž (↑ ↓; Sonos a Bluesound) nebo playlist vyprázdníte. Tlačítkem Vybrat jinou hudbu pustíte oblíbenou položku Sonos (např. stanici nebo kanál Tunify) nebo seznam skladeb Sonos, případně předvolbu BluOS.
• Na vlastní obrazovce: stejné ovládání a velký playlist na http://<kassaserver>:3000/muziek, např. na druhém monitoru vedle pokladny nebo tabletu na baru (na stejném zařízení už přihlášeno, jinak s PINem).
• Na tabletu nebo telefonu: QR kód s adresou této vlastní obrazovky v síti podniku. Zaměstnanec ho naskenuje vlastním tabletem nebo telefonem (v síti Wi-Fi podniku) a přihlásí se vlastním PINem; tlačítkem Odhlásit se zase zavře. Viz Druhá obrazovka na tabletu nebo telefonu.

Správce přidá zdroje tlačítkem + Zdroj hudby, zvolí, jak je každý připojen, a vyzkouší ho tlačítkem Otestovat:

• Soundtrack (soundtrack.io): přes veřejné API, s tokenem API (vyžádáte si ho u Soundtrack) a zvukovou zónou (Načíst zóny). Přehrát, pozastavit, další, hlasitost a co hraje.
• Sonos: IP adresa reproduktoru (u skupiny: reproduktor, který skupinu řídí). Funguje se vším, co na Sonosu hraje, např. Tunify, Spotify nebo rádio.
• Bluesound (BluOS): IP adresa přehrávače; funguje také se vším, co na něm hraje, např. Tunify.
• VLC na hudebním počítači: zapnuté webové rozhraní (Nástroje → Nastavení → Zobrazit nastavení: Vše → Rozhraní → Hlavní rozhraní: Web, s heslem u Lua); IP adresa (případně s :poort, výchozí 8080) a heslo.
• Vlastní hudební počítač (webové adresy): pro hudební počítač nebo box s webovou adresou pro každé tlačítko; GET nebo POST a {volume} (0-100) v adrese pro hlasitost. Bez adresy pro Hlasitěji/Tišeji nastavuje pokladna hlasitost po krocích.
• Webový přehrávač hudební služby: webová adresa webového přehrávače nebo ovládací stránky (např. webový přehrávač Tunify nebo Media Tools) se otevře v pokladně tlačítkem Hudba; pokud službu nelze zobrazit v jiné obrazovce, použijte Otevřít ve vlastním okně.

Pokladna komunikuje s přehrávači ze serveru, proto musí být ve stejné síti jako pokladna (Soundtrack přes internet). Ovládat může každý přihlášený; k nastavení je potřeba oprávnění Nastavit podnik, platby a tiskárny. Token a heslo se už nikdy nezobrazí a neobjeví se v protokolu; v protokolu je jen nastavení (zapnuto/vypnuto, zdroje), ne každé stisknutí tlačítka. Export konfigurace přenáší jen zapnuto/vypnuto (zdroje patří k jedné provozovně).

Druhá obrazovka na tabletu nebo telefonu

Hudbu a kamery lze zobrazit i na vlastním tabletu nebo telefonu zaměstnance, jako druhou obrazovku vedle pokladny. V okně Hudba nebo Kamery je tlačítko Na tabletu nebo telefonu: zobrazí QR kód s adresou, např. http://192.168.1.20:3000/muziek nebo .../camera.

1. Připojte tablet nebo telefon k síti Wi-Fi podniku.
2. Naskenujte QR kód fotoaparátem (nebo zadejte adresu do prohlížeče).
3. Přihlaste se vlastním PINem. Vidíte jen to, co smíte: hudbu všichni, kamery jen s oprávněním Sledovat obraz z kamer.
4. Hotovo: Odhlásit vpravo nahoře. Pokud přihlášení vypršelo (např. tablet ležel přes noc nepoužitý), obrazovka znovu požádá o PIN.

Tip: přidejte stránku na plochu tabletu (v prohlížeči: Přidat na plochu), pak se otevře jako aplikace.

Proto pokladna zjišťuje IP adresu pokladního PC v síti (pokud jich PC má víc, např. Wi-Fi a kabel, zvolíte síť). Na portálu správy (pokladna na dálku) je to adresa portálu. QR kód si pokladna vytváří sama, bez internetu.

Párování tabletů: jedním tlačítkem na tablet (volitelné)

Ještě jednodušší: spárujte tablet jednou a pokladna pošle hudbu nebo kamery na tento tablet jedním tlačítkem. Zapněte to v Nastavení → Provozovna → Obrazovky a ovládání → Tablety jako druhá obrazovka (ve výchozím stavu vypnuto).

1. Na tabletu: otevřete http://<kassaserver>:3000/tablet (u nastavení je Na tabletu nebo telefonu s QR kódem), přihlaste se PINem a pojmenujte tablet, např. Tablet Bar. Spárovat.
2. Na pokladně: v okně Hudba nebo Kamery je nyní tlačítko Na Tablet Bar (se zelenou tečkou, když je tablet zapnutý). Klepněte na něj: tablet tuto obrazovku otevře sám. U hudby se přenese i zvolený zdroj (např. Terasa).
3. Na tabletu: Zavřít se vrátí k čekání; Zrušit spárování tohoto tabletu odstraní spárování.

Nechte stránku na tabletu otevřenou; je-li tablet vypnutý nebo spí, otevře obrazovku, jakmile bude znovu zapnutý. Tablet zůstává přihlášený jako zaměstnanec, který se na něm přihlásil: posílat a sledovat kamery lze jen s oprávněním Sledovat obraz z kamer. Správce u nastavení vidí, které tablety jsou spárované a zda jsou zapnuté, a může je přejmenovat nebo odebrat. Tablet si ukládá vlastní klíč; pokladna z něj ukládá jen hash. Vypnutí: spárované tablety zůstanou uložené. V protokolu je vidět, kdo tablet spároval, přejmenoval nebo odebral.

Vyvolávací obrazovka pro výdej s sebou

Obrazovka pro hosty, vlevo Připravuje se a vpravo Hotovo, s velkými čísly, jako v bistru nebo fast foodu. Zapněte ji v Nastavení → Provozovna → Obrazovky a ovládání → Vyvolávací obrazovka pro výdej s sebou (ve výchozím stavu vypnuto).

Párování není potřeba: na televizi s prohlížečem (chytrá TV, stick nebo mini PC), tabletu nebo druhém monitoru otevřete adresu pokladny s /oproep, např. http://192.168.1.20:3000/oproep. U nastavení a v okně Zavolat jsou tlačítka Na vlastní obrazovce a Na tabletu nebo telefonu (QR kód s adresou). Přihlášení není potřeba: obrazovka ukazuje jen čísla. Jednou klepněte na obrazovku, aby prohlížeč mohl přehrávat zvuk.

Co se zobrazuje:

• objednávky s sebou z pokladny, e-shopu a Thuisbezorgd (a podle potřeby i objednávky u pultu bez stolu, při rychlém prodeji) za posledních 12 hodin;
• jakmile se něco odešle do kuchyně nebo baru (nebo je objednávka z e-shopu ve stavu připravuje se), číslo se objeví u Připravuje se;
• Hotovo se nastaví samo, když kuchyňská obrazovka nahlásí celou objednávku jako hotovou nebo je objednávka z e-shopu ve stavu hotovo. Číslo krátce zabliká a obrazovka zazvoní ding-dong;
• hotové číslo zůstane tolik minut, kolik je nastaveno (výchozí 10), nebo do Vyzvednuto;
• objednávky z kiosku (viz Samoobslužný kiosek) se zobrazí vždy, jakmile jsou zaplacené nebo se zaplatí u pokladny, i u "sníst zde", s číslem k vyzvednutí z jejich účtenky;
• volitelně i objednávky pro kurýry Thuisbezorgd, Uber Eats, Deliveroo a HubRise (zaškrtávátko Také objednávky pro kurýry …): s číslem objednávky platformy a názvem platformy pod ním, aby kurýr viděl, kdy je jeho objednávka připravená. Vyzvednuto pak i platformě oznámí, že ji kurýr má (jako v okně platformy).

Číslo: u e-shopu, Thuisbezorgd a doručovacích platforem číslo objednávky, které už host nebo kurýr má; jinak číslo k vyzvednutí (1 až 999). Je velké na účtence, s vysvětlením, že se číslo objeví na obrazovce, až bude objednávka hotová (v jazyce účtenky).

Volitelně (standardně vypnuto, v nastavení):

• Ohlásit číslo hlasem: u nového hotového čísla obrazovka řekne např. "Nummer 42…" ve zvoleném jazyce (nizozemština, angličtina, němčina, francouzština, španělština, italština, portugalština, polština, turečtina nebo arabština). Hlas pochází z prohlížeče obrazovky a na každém zařízení zní jinak; po otevření jednou klepněte na obrazovku. Po zvonku, je-li zapnutý i zvuk.
• Stav objednávky v telefonu: pod číslem k vyzvednutí na účtence je QR kód. Host ho naskenuje, vidí své číslo a stav (objednáno, připravuje se, hotovo, vyzvednuto) a dostane upozornění, když je objednávka hotová. Funguje přes správcovský portál, pokladna k němu musí být připojená. Ne pro e-shop a Thuisbezorgd (mají vlastní stav) a ne pro kiosek (má vlastní nastavení).

V pokladně je tlačítko Zavolat (s počtem objednávek, které se ještě připravují):

1. Hotovo ručně nastaví číslo jako hotové (bez kuchyňské obrazovky, nebo když je to rychlejší). U objednávky z e-shopu nebo Thuisbezorgd se změní i stav, takže host také dostane zprávu.
2. Zpět ho vrátí do Připravuje se.
3. Vyzvednuto ho odebere z obrazovky (s možností Vrátit zpět).

U nastavení také zvolíte, zda se vedle čísla zobrazí křestní jméno (ve výchozím stavu ne, kvůli soukromí) a zda obrazovka vydává zvuk. Vypnutí: žádné tlačítko Zavolat a žádné číslo k vyzvednutí na účtence; nastavení zůstanou uložena. V protokolu je vidět, kdo co ručně nastavil na hotovo, zpět nebo vyzvednuto.

Příchody a odchody

Docházka je ve výchozím stavu vypnutá: pak není v pokladně nikde vidět (žádné tlačítko v horní liště, nic na přihlašovací obrazovce, žádná karta Pracovní doba). Zapněte ji přes Nastavení → Podnik, v části Příchody/odchody zaměstnanců:

• Vypnuto: nepoužívat. Pokud docházku později vypnete, nebude už nikde vidět, ale již zaznamenané hodiny zůstanou uložené (nic se nemaže); když ji znovu zapnete, budou tam opět.
• Zapnuto: zaměstnanci mohou zaznamenat příchod a odchod. Po přihlášení se pokladna zeptá, zda chcete zaznamenat příchod (Teď ne je povoleno). Horní lišta pak ukazuje Příchod nebo Přítomen od 17:02; klepnutím zaznamenáte odchod.
• Povinné: po přihlášení nejprve zaznamenat příchod, jinak pokladnu nelze používat. Odchod vás hned odhlásí.

Zaměstnanci, kteří pokladnu nepoužívají (např. kuchyně), zaznamenávají docházku na přihlašovací obrazovce: klepněte na Příchod / odchod a zadejte svůj PIN. Tím se přepíná mezi příchodem a odchodem, bez přihlášení.

Když je docházka zapnutá, správce vidí v Nastavení → Pracovní doba:

• kdo je právě přítomen (a může zaznamenat odchod za někoho, kdo zapomněl);
• odpracované hodiny každého zaměstnance za období, se všemi směnami, a stažení CSV (hodiny i jako desetinné číslo pro mzdy);
• upravit nebo přidat směny (klepněte na směnu, nebo + Přidat směnu). Každá změna se zaznamená v protokolu se starými a novými časy.

V Belgii se každý příchod a odchod hlásí také černé skříňce. Pokud není dostupná, záznam neprojde (stejně jako placení). Zda to plně splňuje belgické požadavky na evidenci personálu, je ještě třeba potvrdit.

Vážení a etikety (váha)

Když je váha zapnutá (Nastavení → Váha), mohou mít produkty cenu za kilo. Všechny ostatní produkty zůstávají na kusy.

• Vážení: klepněte na produkt s cenou za kilogram (tlačítko ukazuje např. 12,95/kg). Okno Vážení živě ukazuje hmotnost z váhy (např. Aclas OS6X nebo váhy, na které běží samotná pokladna); zelená = ustálená. Položte produkt na váhu a klepněte na Přidat, jakmile se hmotnost ustálí. Cena je cena za kg × hmotnost (zaokrouhleno na haléře/centy); obal (tára) produktu se odečte automaticky. Má-li produkt volby, následují potom.
• Více vah: je-li vah více, vyberete nahoře v okně, na které vážíte. Každá pokladna/tablet si volbu pamatuje.
• Ručně: žádná váha (nebo je povoleno ruční zadání)? Pak hmotnost zadejte: 0,512 nebo 1,2 jsou kila, 512 nebo 512 g jsou gramy.
• Etiketa TS6X: naskenujte čárový kód etikety čtečkou na obrazovce objednávky (stačí skenovat, nic nemusí být otevřené), nebo klepněte na Etiketa a naskenujte nebo zadejte 13 číslic. Produkt (PLU) a hmotnost se převezmou z etikety. Pokud etiketa uvádí cenu, pokladna účtuje přesně tuto cenu.
• Obrazovka, účtenka a zákaznický displej ukazují hmotnost, např. Gehakt 6,63 a pod tím 0,512 kg x € 12,95/kg; na kuchyňském lístku 0,512 kg Gehakt. Rozdělení, přesun a vrácení probíhají v kilech.
• Vážený produkt funguje jen s připojením k pokladnímu serveru (hmotnost přichází přes pokladní server).

Uber Eats, Deliveroo a HubRise

Kromě Thuisbezorgd.nl / Takeaway.com přicházejí do pokladny i objednávky z Uber Eats (Nizozemsko a Belgie), Deliveroo (jen Belgie; Deliveroo z Nizozemska odešlo koncem roku 2022) a vše, co běží přes HubRise (mj. Uber Eats, Deliveroo, Just Eat/Takeaway.com a menší objednávkové aplikace). Každou platformu lze zapnout zvlášť v Nastavení → Rozvozové platformy (ve výchozím stavu vypnuto, vypnutím se nic neztratí). Karta u každé platformy ukazuje, ve kterých zemích funguje, a upozorní, pokud nefunguje v zemi provozovny.

• Zapněte a pak Přihlásit se k Uber Eats a propojit obchod (provozovna se přihlásí vlastním účtem Uber Eats). Má-li účet více obchodů, zadejte ID obchodu (store id) a přihlaste se znovu. Uber Eats k tomu musí nejprve schválit Pin Voordeel jako partnera.
• Deliveroo: přímo, přes portál. Zadejte site id (location id) a ID značky (brand id). Bez tabletu (výchozí): pokladna přijímá nebo zamítá; s tabletem: provozovna přijímá na tabletu a portál jen hlásí, zda je objednávka v pokladně.
• HubRise: pokladna si objednávky stahuje sama (každých 20 sekund, portál není potřeba).
• U každé platformy: přijímat automaticky, kuchyňský lístek hned do kuchyně/na bar a (Uber Eats, Deliveroo) po změně odeslat menu automaticky a Odeslat menu teď. V menu jsou produkty zaškrtnuté v Produkty v menu Uber Eats a Deliveroo, s možnostmi výběru; stav vyprodáno se odesílá také.

Objednávky. Objednávka se stane běžnou objednávkou (bezorgen nebo afhalen, název skupiny <platform> <nummer>) s cenami platformy: produkty se poznají podle ID (z menu), kódu nebo čísla PLU; neznámý = samostatný řádek s cenou platformy (a upozornění); poplatky za doručení, příplatky a slevy jako vlastní řádky; pokud celková částka přesto nesedí, řádek "Rozdíl". Kuchyňský lístek jde hned do kuchyně/na bar. Tlačítko Platformy v horní liště (s počtem probíhajících objednávek; oranžové, když je co přijmout): přijmout nebo zamítnout (s důvodem), připravuje se, hotovo, na cestě, doručeno nebo vyzvednuto, zrušit a Dokončit (zaplaceno online). Co platforma zná, se jí vrací (Uber Eats: přijetí, zamítnutí, zrušení; Deliveroo: přijetí, zamítnutí, připravuje se, hotovo, vyzvednuto; HubRise: všechny stavy). Pokud provozovna rozváží sama (vlastní rozvoz), je objednávka také v Jízdách a odjezd a doručení jdou automaticky na platformu. Zrušení ze strany platformy nechá objednávku propadnout. Pokud pokladna není déle než 2 minut připojena k portálu, portál novou objednávku z Uber Eats zamítne a sdělí Deliveroo (s tabletem), že se to nepodařilo, aby to provozovna viděla na tabletu.

Kód: apps/pos-server/src/lib/bezorgplatforms.ts, routes/bezorgplatforms.ts; obrazovky Bezorgplatforms.tsx. Strana portálu: horecapos-portaal/src/platforms.mjs. Protokol: Rozvozové platformy (zap./vyp., nastavení, objednávky). Vše je součástí záloh pokladny.

Menší platformy v Nizozemsku a Belgii (Homie, Hebtrek, sneleten.nl, Bistroo ...) nemají veřejné propojení s pokladnou; pokud jsou na HubRise, fungují přes HubRise. Jinak: viz backlog.

Platební automat (uzavřený systém pro hotovost)

Ve výchozím stavu vypnuto: hotovost funguje jako vždy. U uzavřeného systému pro hotovost se personál hotovosti nedotýká: zákazník nebo zaměstnanec vloží peníze do automatu, který je spočítá, zkontroluje padělky a vrátí peníze.

• Automaty, se kterými pokladna komunikuje přímo:
  • CashDro (3, 4+, 5, 7, S Compact; NuKassa, KluisKassa): přes síť (web service). Na CashDro zapněte Web Integration a vytvořte pro pokladnu vlastního uživatele.
  • Cashmatic (SelfPay 460/860/1060; v Belgii Xpos): přes síť (port 50301) s uživatelem Cashmatic.
  • Azkoyen Cashlogy (POS1000, POS1500): přes CashlogyConnector na počítači s Windows u automatu (port 8092).
  • CashKeeper: přes CKMonitor na počítači s Windows (port 16501).
  • Glory CASHINFINITY (CI-5, CI-10, CI-10X; také přes Cikam): přes řídicí jednotku (FCC) automatu. Zatím ve verzi beta: nechte první propojení zkontrolovat společností Glory nebo svým prodejcem.
  • Externí: jiný software ovládá automat a komunikuje s pokladnou (např. Cikam, ImaCash pro 25 značek, software CashGuard/StrongPoint (Merlin), PayComplete (SUZOHAPP), Gunnebo SafePay nebo francouzské značky jako CashMag).
  • Zkušební automat: bez hardwaru, pro nácvik nebo předvádění. Pomocí Otestovat spojení zkontrolujete adresu a přihlášení. Umístěte automat do vlastní sítě (nikdy otevřené do internetu) a používejte pro pokladnu vlastního uživatele, ne správce.
• Zaplatit s Hotově: Zaplatit v platebním automatu spustí platbu částky (zaokrouhlené pro hotovost, je-li to zapnuto, plus spropitné; při rozdělení účtu danou část). Obrazovka ukazuje, co bylo vloženo a co se vrací; pokladna zaplatí teprve tehdy, když automat ohlásí hotovo. Zrušit = automat vrátí peníze. Pokud automat nemohl vrátit všechny peníze (málo mincí), je uvedeno, kolik se musí vydat z pokladní zásuvky. Úspěšná platba, která ještě nebyla zaplacena na pokladně (např. vypadl tablet), se najde u dané objednávky.
• Hotovost jen přes automat (ve výchozím stavu zapnuto): pokladní server pak přijme hotovost jen s úspěšnou platbou v automatu přesně pro danou objednávku a danou částku. Vypnuto = i běžná hotovost do zásuvky.
• Pokladní zásuvka (Přehled → Pokladní zásuvka, oprávnění Spravovat pokladní zásuvku): Zjistit stav (po mincích a bankovkách, u Cashmatic, Cashlogy, Glory a zkušebního automatu), Vyplatit s důvodem (např. drobné do zásuvky), Doplňování a Odvod (drobné zůstanou; u Cashmatic). Očekáváno v pokladní zásuvce nezapočítává peníze v automatu (ty jsou uvedeny zvlášť pod tím: V platebním automatu), ale započítává peníze, které se musely vrátit ze zásuvky.

Tlačítko ©

Vpravo dole na každé obrazovce (PIN, plánek, objednávání a kuchyně) je malé tlačítko ©. Otevře údaje OptimumPOS: logo, adresu, telefon, e-mail a web. Ikona je uložena lokálně v aplikaci, takže funguje i bez internetu. Stejná ikona je ikonou aplikace (karta prohlížeče a domovská obrazovka).

Část 2 · Vedoucí

Začínáme

Ve výchozím stavu může vedoucí vše, co číšník, a navíc mimo jiné dávat slevy, zpracovávat vrácení, uzavírat den, spravovat pokladní zásuvku a prohlížet protokol a zásoby. Většina z toho je pod tlačítkem Přehled:

• Mezisoučet (X): dosavadní obrat, bez uzavření dne.
• Pokladní zásuvka: počáteční hotovost, vklad/výběr a otevření zásuvky.
• Uzavřít den (Z): na konci dne; poté začíná nový den.
• Předchozí Z-zprávy, Obrat za období a Přehledová nástěnka.
• Protokol, Dárkové poukazy a Zákazníci.

Zásoby

Ve výchozím stavu vypnuto. Zapněte přes Nastavení → Podnik → Sledovat zásoby. Vypnuto = v pokladně nikde vidět.

• U každého produktu zvolíte v Nastavení → Produkty → (produkt) → Zásoby:
  • Ne: jako vždy;
  • Po kusech: každý prodej odečte 1 (např. lahve, plechovky), s úrovní upozornění pro "téměř vyprodáno";
  • Přes suroviny: recept, např. hamburger = 1 houska + 150 g masa + 1 plátek sýra. Každý prodej odečte suroviny.
• Nastavení → Zásoby (oprávnění Spravovat zásoby, ve výchozím stavu vedoucí a správce):
  • Produkty a Suroviny: stav zásob s označením vyprodáno / téměř vyprodáno; filtr "jen (téměř) vyprodané" a export do CSV.
  • U každého produktu nebo suroviny zaúčtujete Dodávku (+), Inventuru (=) (napočítané množství se stane novým stavem) nebo Odpis (−) (rozbití, prošlé datum; důvod je povinný).
  • Vytvářejte suroviny s jednotkou (ks, g, kg, ml, cl, l, porce, lahev, sud) a úrovní upozornění.
  • Historie: všechny změny (prodej, storno, dodávka, inventura, odpis) s tím, kdo a kdy. Správní akce se zaznamenávají také v protokolu.
• Zásoby se odečítají při Odeslat objednávku (nebo při placení u položek zaplacených přímo). Storno je vrátí zpět. Rozdělení a přesun se nepočítají dvakrát. U menu se odečítají pokrmy, ne řádek menu. Vrácení (dobropis) se zpět nepřičítá (vrácené zboží obvykle nelze znovu prodat); v případě potřeby jej zaúčtujte jako dodávku.
• Když jsou zásoby vyčerpány (nebo je suroviny málo na další kus), produkt se na všech pokladnách automaticky nastaví jako vyprodaný. Při téměř vyprodání ukazuje tlačítko produktu zbývá N. Po dodávce nebo inventuře jej lze hned znovu objednat. Pokladní server produkt také odmítne ("Pils" je vyprodán (zásoba 0)), tedy i z tabletu, který to ještě nevěděl.
• Zásoby mohou klesnout pod 0 (např. dva tablety současně, nebo objednáno offline); inventura je opět srovná.
• Seznam k objednání: Nastavení → Zásoby → Seznam k objednání. U každého produktu (po kusech) a každé suroviny nastavíte kromě úrovně upozornění také doplnit na a dodavatele. Seznam k objednání ukazuje vše na úrovni upozornění nebo pod ní (bez úrovně upozornění: na 0), podle dodavatele, s návrhem doplnit na − stav. Množství lze upravit a zaškrtnout/odškrtnout. Pak Tisk (tiskárna účtenek), Kopírovat (pro e-mail nebo WhatsApp), Export (CSV) a po dodání Dodáno: zaúčtovat jako dodávku (zaúčtuje vše najednou). Zaškrtávacím políčkem nahoře uvidíte i to, co ještě vyprodané není, abyste objednali navíc.
• Možnosti: skupina možností (Nastavení → Produkty → Možnosti) má tlačítko Zásoby. U každé možnosti zadejte suroviny na kus, např. Extra sýr = 1 plátek sýra, Hranolky = 150 g hranolků. Když je možnost zvolena, tyto suroviny se odečtou za každý kus (i když produkt sám zásoby nesleduje; při stornu se vrátí). Pokud je surovina vyčerpána, možnost se v pokladně zobrazí jako (vyprodáno) a nelze ji zvolit.

Objednávání u dodavatelů

Ve výchozím stavu vypnuto. Zapnutí v Nastavení → Zásoby → Objednávání u dodavatelů (jen se zapnutým Sledovat zásoby). Vypnuto = seznam k objednání funguje jako vždy.

• Dodavatelé (karta Dodavatelé): vyberte jednoho ze seznamu nebo vytvořte vlastního dodavatele. Seznam obsahuje velkoobchody a cash & carry (Sligro, Sligro-ISPC/Sligro-M, HANOS, Makro, De Kweker, Horeca Totaal, Van Zon, zegro, Lekkerland), foodservice (Bidfood a Bidfood Belgium, Solucious, Chefs Culinar, Java, Q-Food, Agora Culinair, VHC Jongens/Kreko/Actifood, Hocras, Van Hoeckel ...), velkoobchody s nápoji (De Klok, Henk Smit, Horesca, De Monnik, Hansen, Dranken Geers ...), pivovary a nealkoholické nápoje (Heineken přes Sligro, AB InBev/BEES, Alken-Maes, Haacht, Duvel Moortgat, Martens, Coca-Cola, Spadel, Grolsch, Bavaria), dodavatele čerstvého zboží (Van Gelder, Driessen, FiliusKaas, Bakkers Brigade, Rungis ...), non-food (Bunzl, Takeaware, Supplierz), online vinotéku Vinify.nl a objednávkové platformy (Apicbase, Exact Horeko, Growzer, inOne, Cuisin.io, OrderXL). Jsou v něm jen dodavatelé ze země podniku. Když jednoho vyberete, způsob objednávání, soubor i sloupce jsou už správně nastaveny; u každého dodavatele je uvedeno, jak se u něj objednává.
• Pro každého dodavatele: zákaznické číslo, objednávat přes:
  • E-mail: objednávka jako e-mail (s tabulkou) na e-mailovou adresu pro objednávky, volitelně kopie, se seznamem k objednání v příloze: CSV, Excel, CSV pro Care4Fresh (mnoho velkoobchodů s čerstvým zbožím), UBL 2.1 Order (Peppol BIS Order), EANCOM ORDERS (D96A v Nizozemsku, D01B/HO2C v Belgii) nebo cXML. Odpovědi přicházejí na e-mailovou adresu podniku.
  • Soubor: pokladna vytvoří soubor, vy ho nahrajete do e-shopu dodavatele (např. Bunzl Snel bestellen: artikel;aantal, Takeaware: SKU,Quantity). Oddělovač, řádek záhlaví a sloupce lze nastavit (artikel, ean, omschrijving, aantal, eenheid, prijs, totaal; pomocí artikel=SKU dáte záhlaví vlastní název).
  • Propojení (cXML): cXML OrderRequest se zákaznickým číslem a sdíleným tajemstvím na objednávkovou adresu dodavatele, tak jak ho nákupní systémy posílají do Sligro, HANOS a Bidfood. Adresu, zákaznické číslo a tajemství získáte od dodavatele (Sligro: koppelingen@sligro.nl). Tajemství se nikdy nevrací na obrazovku.
  • U obou propojení lze použít také uživatelské jméno a heslo (Basic) a další hlavičky (jedna na řádek, např. X-Api-Key: ...).
  • Nahrávání (SFTP/FTPS): pokladna sama uloží soubor (EANCOM, UBL, CSV, Excel ...) do složky na serveru dodavatele, tak jak mnoho velkoobchodů přijímá objednávky EDI. SFTP (SSH), FTPS (explicitní na portu 21 nebo implicitní na portu 990) nebo, jen ve vlastní síti, FTP. Přihlášení heslem nebo klíčem SSH (OpenSSH, PEM nebo PuTTY .ppk; ed25519, ECDSA nebo RSA). Vytvořit klíč vytvoří v pokladně pár klíčů; veřejný klíč pošlete dodavateli. Otestovat spojení se přihlásí a vyhledá složku. Otisk serveru SFTP se zaznamená při prvním připojení a poté se kontroluje (jiný server heslo nedostane); u FTPS s vlastním certifikátem nastavíte otisk certifikátu napevno. Žádný další software není potřeba.
  • Tisk: objednávka na tiskárně účtenek, k předání telefonem.
• Hesla, klíče, tokeny a hlavičky se nikdy nevracejí na obrazovku (nechat prázdné = ponechat, Vymazat = odstranit).
• Požádat o propojení: u dodavatele pokladna sestaví e-mail se žádostí o propojení (cXML, EDI přes SFTP/FTPS, UBL/Peppol nebo vlastní API dodavatele) s údaji provozovny (název, adresa, DIČ, zákaznické číslo, GLN) a tím, co je potřeba; u EDI s veřejným klíčem. Upravte a odešlete; kopie a odpovědi jdou na e-mailovou adresu provozovny. Datum žádosti je uvedeno u dodavatele. U Sligro jde na koppelingen@sligro.nl, jinak vyplníte adresu svého account manažera.
• Vlastní dodavatel (mimo seznam) umí vše kromě toho, co musí nabízet sám dodavatel: e-mail, soubor a tisk fungují vždy; propojení nebo nahrávání jen s údaji tohoto dodavatele.
• Objednací dny a dodání: objednací dny, nejzazší čas, dodací lhůta (požadované datum dodání na objednávce) a minimální hodnota objednávky. Automaticky: v objednací dny od tohoto času pokladna sama objednávku připraví (vy ji zkontrolujete) nebo ji ihned odešle (e-mailem, nahráním nebo přes propojení; pod minimální hodnotou objednávky jen připraví). Jednou denně pro každého dodavatele.
• Podle produktu (Nastavení → Produkty → (produkt) → Zásoby, u Podle produktu) a podle suroviny: Objednávat u (dodavatel), objednací číslo u tohoto dodavatele, EAN, za balení (přepravka 24 = 24), název balení a nákupní cena za balení. Úroveň upozornění je okamžik k objednání; doplnit do udává, kolik má pak být na skladě.
• Nákupní objednávky (karta Nákupní objednávky):
  • Návrh objednávky pro každého dodavatele: vše, co je na úrovni upozornění nebo pod ní. Co je již objednáno a ještě nedorazilo (na cestě), se započítává, abyste nic neobjednali dvakrát. Návrh = doplnit do − stav − na cestě (bez doplnit do: do úrovně upozornění), zaokrouhleno nahoru na celá balení. Upravte množství a Vytvořit objednávku.
  • Objednávka je nejprve připravena: množství, volné řádky (bez produktu, např. ubrousky), poznámku a datum dodání lze ještě změnit. Pak Odeslat (způsobem dodavatele nebo jednorázově jinak). Pokud se to nezdaří (např. dodavatel odmítne), je uveden důvod a můžete to zkusit znovu.
  • Přijato: u každého řádku přijaté množství (předvyplněné objednaným množstvím); zásoby se navýší po baleních (2 přepravky po 24 = 48), s objednávkou uvedenou v historii.
  • Každý soubor (CSV, Excel, UBL, EANCOM, cXML) lze také stáhnout samostatně.
• Odesláno, nezdařilo se, přijato a zrušeno se zapisuje do protokolu. Běžný Seznam k objednání funguje dál; má-li produkt dodavatele ze seznamu, je tam uveden pod jeho názvem.

Správa recenzí

Čtení recenzí z Google a Trustpilot a odpovídání na ně v pokladně. Zapíná se v Nastavení → Body a recenze → Správa recenzí (ve výchozím stavu vypnuto, pak z toho nikde nic není vidět). Číst a odpovídat můžete v Přehled → Recenze (oprávnění Číst recenze a odpovídat na ně, ve výchozím stavu i pro manažera). Když funkci vypnete, propojení i recenze zůstanou uložené.

• Každá provozovna pak jen klepne na Připojit ke Googlu a přihlásí se vlastním účtem Google firemního profilu. Klíč Places lze nastavit i centrálně (náklady pak nese dodavatel). Trustpilot je pro každou provozovnu zvlášť: každá provozovna má vlastní účet Trustpilot Business (API je součástí placeného předplatného), ze kterého pochází klíč, tajný klíč a business user ID. V pokladně je u každého způsobu uvedeno "Kdo to zařídí?".
• Aplikace dodavatele (přes zákaznický portál): pokud jsou v zákaznickém portálu aplikace Google a/nebo Trustpilot od dodavatele (viz README horecapos-portaal, "Reviews: apps van de leverancier"), správce zvolí v části Přihlášení a klíče možnost Aplikace dodavatele (výchozí u nového propojení, pokud portál aplikaci má). Provozovna klepne na Připojit ke Googlu nebo Přihlásit se přes Trustpilot a přihlásí se vlastním účtem; pokladna sama čeká, až je přihlášení hotové (každých 3 sekund, nejvýše 15 minut), a jednou si vyzvedne tokeny z portálu. Obnovování probíhá také přes portál. V pokladně není potřeba client-ID, secret ani API klíč; u Trustpilotu ale doména a pro odpovědi business user ID. Trustpilot veřejně pak čte přes klíč portálu. Vyžaduje PORTAAL_URL a PORTAAL_SLEUTEL. Vlastní aplikace nebo API klíč funguje dál, jak je popsáno níže.
• Komu patří recenze: zůstávají na vlastním Firemním profilu Google a vlastní stránce Trustpilot provozovny a pokladna je ukládá jen ve vlastní databázi pokladny. Odpovědi se zobrazují pod názvem provozovny. Portál jen předá přihlášení (v paměti, nejvýše 15 minut, lze vyzvednout jen jednou) a neukládá žádné recenze ani tokeny; název aplikace dodavatele je jen na obrazovce souhlasu.
• Zaregistrovat se sami: u každé platformy je odkaz, kde si sami vytvoříte Firemní profil Google (business.google.com/create) nebo účet Trustpilot Business (business.trustpilot.com), a u Trustpilotu také odkaz na tarify (business.trustpilot.com/plans). Registrace a platba probíhají přímo u platformy; API pro to neexistuje.
• Pak Připojit ke Googlu a přihlaste se účtem, který Firemní profil spravuje. Jedna pobočka v profilu = vybrána hned; více = výběr v pokladně.
• Google Places (jen pro čtení): s Place ID a API klíčem pro Places API (nebo GOOGLE_PLACES_API_KEY): průměr, počet recenzí a 5 nejrelevantnějších recenzí. Odpovídat takto nelze.
• Trustpilot Business (čtení a odpovědi): API klíč a API tajný klíč aplikace v Trustpilot Business (Integrations → API; nebo TRUSTPILOT_API_KEY a TRUSTPILOT_API_SECRET), doména provozovny (pokladna si business unit vyhledá) a pro odpovědi business user ID osoby, která odpovídá.
• Trustpilot veřejně (jen pro čtení): jen API klíč.
• Pokladna načítá každých 30 minut (a hned po propojení; Načíst nyní). E-mailovou adresu a číslo objednávky hosta (které Trustpilot posílá) pokladna neukládá.
• Přehled → Recenze: průměr, počet podle hvězdiček, bez odpovědi a nepřečtené; filtrování podle platformy, hvězdiček, bez odpovědi a nepřečtených. U každé recenze Odpovědět (nejvýše 4000 znaků; každý si to může přečíst), Upravit odpověď, Odstranit odpověď a Přečteno. Nová nebo změněná recenze je nepřečtená. V protokolu jsou review_beantwoord a review_antwoord_weg.
• Odpojení načtené recenze zachová.

SMS a e-mailový marketing

Zprávy zákazníkům se zákaznickou kartou, kteří k tomu dali souhlas. Bez zákaznické karty nelze zapnout ani jedno.

• Souhlas pro každého zákazníka a kanál: u nového zákazníka na pokladně jsou políčka "Zákazník chce dostávat akce SMS" a "... e-mailem" (ve výchozím stavu nezaškrtnutá). V Přehled → Zákazníci vidíte a měníte souhlas (s datem udělení) a narozeniny (jen den a měsíc). Odhlášení: zrušte zaškrtnutí a uložte.
• Menu ihned aktualizované: když zapnete nebo vypnete marketing či zákaznickou kartu, pokladna během několika sekund znovu pošle menu do e-shopu (jen pokud se něco změnilo), takže zaškrtávací políčko se hned zobrazí, nebo zmizí.
• Souhlas přes e-shop: pokud má provozovna e-shop, je při placení zaškrtávací políčko "Chci dostávat nabídky e-mailem/SMS" (jen kanály, které jsou zapnuté; ve výchozím stavu nezaškrtnuté). Když taková objednávka přijde, pokladna vyhledá zákazníka podle telefonního čísla (jinak podle e-mailové adresy), v případě potřeby ho založí a uloží souhlas s datem. Chybějící číslo nebo adresa u existujícího zákazníka se doplní; v protokolu je klant_toestemming se zdrojem webshop.
• Přehled → Marketing (oprávnění Správa zákaznické karty): nahoře vidíte, kolik zákazníků dalo souhlas pro SMS a kolik pro e-mail.
• Akce (jednorázové): název, SMS nebo e-mail, (předmět,) text s {naam}, {zaak} a {punten}, případně jen zákazníci, kteří nějakou dobu nepřišli nebo mají alespoň tolik bodů. Zobrazit ukáže, kolika zákazníkům akce půjde, zprávu tak, jak ji zákazník dostane, a počet SMS na zákazníka. Poslat test na vlastní číslo nebo adresu. Pak Odeslat: pokladna odesílá na pozadí (nejvýše 1000 najednou) a počítá, co bylo odesláno a co selhalo. Nikdo nedostane stejnou akci dvakrát; pokud se pokladna v polovině zastaví, Pokračovat v odesílání naváže u těch, kdo ještě nic nedostali.
• Odesílání přes Mailchimp nebo Klaviyo (s propojením na zvolený seznam, viz níže): u akce e-mailem zvolíte v Odesílat přes pokladnu (vlastní poštovní server, jako výše), Mailchimp nebo Klaviyo. Pokladna pak nejdřív aktualizuje seznam (odhlášení, body), vytvoří tam kampaň přesně pro zvolené zákazníky, kteří jsou na seznamu (Mailchimp: pevná skupina v audience; Klaviyo: vlastní seznam pro akci), a odešle ji s výchozím odesílatelem audience nebo účtu. {naam} a {punten} vyplní Mailchimp/Klaviyo pro každého zákazníka; odkaz na odhlášení od služby je dole. Žádný limit 1000 najednou a žádný osobní slevový kód ({code}). Když se to nepovede, akce zůstane konceptem s hlášením. Karta Marketing je k dispozici i tehdy, když je aktivní jen propojení (pak jen akce přes Mailchimp/Klaviyo; Poslat test jde přes poštovní server pokladny). Automatické zprávy posílá pokladna vždy sama; v Mailchimp/Klaviyo je vytvoříte jako Customer Journey nebo Flow. Klíč Klaviyo: také práva k zápisu pro Campaigns a Templates (kdo se už přihlásil: přihlaste se znovu).
• Jako push oznámení přes e-shop (pokud jsou ve správě e-shopu zapnutá Push oznámení s nabídkami): u Odesílat přes zvolte Push oznámení (e-shop jako aplikace), s názvem (nejvýše 60 znaků) a krátkým textem (nejvýše 200 znaků; doplní se jen {zaak}, protože e-shop neví, kdo je host). Pokladna odešle akci přes správcovský portál do e-shopu a ten ji pošle hostům, kteří tam zapnou Nabídky jako oznámení; klepnutí otevře menu e-shopu. Po několika sekundách se u akce zobrazí, kolik jich bylo doručeno. Nejvýše 3 denně, spolu s tím, co podnik odešle ve správě e-shopu; jinak akce zůstane konceptem s uvedeným důvodem. Karta Marketing je k dispozici i tehdy, když je zapnuto jen toto (bez zákaznické karty nebo e-mailového marketingu). Žádný slevový kód ani výběr (dny, body); test: na svém telefonu zapněte v e-shopu Nabídky jako oznámení.
• Automaticky: narozeninová zpráva (v den narozenin, jednou za rok) a "Chybíte nám" (po tolika dnech bez návštěvy, jednou pokaždé, když zákazník přestane chodit). Zapnout/vypnout u každé zprávy zvlášť; odcházejí jen přes den (10:00–20:00).
• Osobní slevový kód (volitelné, pro každou zprávu nebo akci; jen když jsou zapnuté Slevové kódy v Nastavení → Provozovna): každý zákazník dostane vlastní kód, např. TERUG-7K4Q2M (narozeniny JARIG-…, akce ACTIE-…), v procentech nebo pevnou částkou, případně s minimální částkou objednávky, použitelný jednou, platný zvolený počet dní po odeslání (výchozí 30) a na pokladně a/nebo v e-shopu. Vložte {code} a {geldig} do textu tam, kde je chcete mít; jinak pokladna pod zprávu vloží "Uw kortingscode: … (10% korting, aan de kassa of in de webshop, geldig t/m …)". Zobrazit a Poslat test ukazují ukázkový kód (TERUG-VOORBEELD, nefunguje). Pokud se odeslání nepodaří, kód se nevytvoří. U akce je vidět, kolik kódů bylo vydáno a použito.
• Odhlášení je pod každou zprávou: u SMS "Odhlásit? Zavolejte ... nebo nám to řekněte při příští návštěvě", u e-mailu odkaz pro odhlášení na e-mailovou adresu provozovny (také tlačítko Odhlásit odběr v Gmail a Outlook). Odpověď na e-mail jde provozovně.
• Soukromí (GDPR): jen zákazníci se souhlasem a s číslem nebo adresou; v protokolu nejsou čísla ani adresy, jen u každé akce počet odeslaných a neúspěšných. Když zákazníka smažete, zmizí i ze seznamu příjemců.
• Náklady: SMS jdou přes váš vlastní účet CM.com (víc než 160 znaků = víc SMS na zákazníka). Gmail a jiné poštovní servery mají denní limit; při velkém počtu zákazníků odesílejte po částech.

Spropitné podle zaměstnanců

V Nastavení → Podnik → Spropitné (jen je-li zapnuto "Zobrazit tlačítka spropitného při placení") zvolíte, jak se spropitné podle zaměstnanců zobrazí na mezisoučtu (X), Z-zprávě (účtenka a e-mail) a v Obratu za období (i v CSV):

Zbylé centy dostane ten, kdo je nejblíže dalšímu centu, takže součet vždy sedí. Jde o přehled: pokladna nic nevyplácí (to můžete udělat přes "Výběr peněz ze zásuvky"). Staré Z-zprávy zůstanou, jak byly.

Z-zpráva e-mailem

V Nastavení → Podnik → Posílat Z-zprávu na jednou zadejte e-mailovou adresu správce (více adres oddělte čárkou, max. 3). Po Uzavřít den se Z-zpráva pak automaticky pošle na tuto adresu, vedle vytištěné účtenky. Prázdné = žádný e-mail, jako vždy.

• Odesílání probíhá na pozadí, takže pomalý poštovní server nezdržuje denní uzávěrku.
• Nepovedlo se nebo potřebujete znovu: Přehled → Předchozí Z-zprávy → (zpráva) → Poslat znovu (označeno KOPIE).

Shrnutí dne (volitelné)

Je-li vyplněna adresa v Posílat Z-zprávu na, je pod ní zaškrtávací políčko S krátkým shrnutím dne na začátku e-mailu (ve výchozím stavu vypnuto). Zapnuto = na začátku e-mailu se Z-zprávou několik řádků srozumitelným jazykem, jen z vlastních dat pokladny (žádná AI, nic neodchází ven):

• tržba, účtenky a hosté a útrata na účtenku, ve srovnání se stejným obdobím o týden dříve (v procentech); pokud tehdy nic nebylo, je to uvedeno;
• 5 nejprodávanějších produktů a co je nápadné: produkty, kterých se prodalo nejméně o 3 více nebo méně než minulý týden;
• počet storen (ve srovnání s minulým týdnem) a nejrušnější hodina (účtenky a tržba).

Samotná Z-zpráva (účtenka a e-mail) zůstává úplně stejná. Náhled za dnešek ukazuje shrnutí od poslední denní uzávěrky do teď. Shrnutí je v nizozemštině, stejně jako e-mail se Z-zprávou.

Přehledová nástěnka

Karta Přehledová nástěnka v Přehledu (oprávnění Obrat za období), jen ke čtení:

• Obrat za hodinu jako graf: zvolený den (modře) vedle stejného dne minulý týden (šedě). Dnešek se porovnává s minulým týdnem do stejného času, takže procento je férové. Šipkami ◀ ▶ nebo datem zvolíte jiný den.
• Dlaždice: obrat (± % oproti minulému týdnu), účtenky a průměr na účtenku, průměrná útrata na hosta (jen konzumace na místě; s sebou/rozvoz se nepočítá) za daný den a za zvolené období.
• Top 10 produktů a nejrušnější hodiny za posledních 7, 28 nebo 90 dní. Nejrušnější hodiny jsou tepelná mapa den v týdnu × hodina (průměrný obrat za otevřený den) se třemi nejrušnějšími hodinami nad ní, praktické pro plánování směn.

Prodané dárkové poukazy se do obratu nepočítají a slevy a záhlaví menu nejsou v top 10 (jako v ostatních přehledech). Den trvá od 00:00 do 24:00.

Další přehledy

Tři další karty v Přehled, každou lze zapnout zvlášť přes Nastavení → Provozovna → Správa a přehledy → Další přehledy (ve výchozím stavu vypnuto: pak karta není). Vyžadují stejné oprávnění jako Tržby za období a slouží jen ke čtení. Období: tento týden, minulý týden, tento měsíc, minulý měsíc, posledních 90 dní, tento rok nebo vlastní výběr (nejvýše něco přes rok).

• Menu engineering: u každého produktu, jak často se prodal (podíl na všech prodaných kusech), ve srovnání s tím, co vynese na kus (marže = prodejní cena bez DPH minus nákladová cena). Každý produkt dostane zařazení: Hvězda (oblíbený a s vysokou marží: nechat tak), Tažný kůň (oblíbený, nízká marže: trochu zvýšit cenu nebo zlevnit výrobu), Hádanka (málo prodávaný, vysoká marže: lépe zviditelnit) a Pes (málo prodávaný, nízká marže: stáhnout z lístku nebo nahradit). Oblíbený = alespoň 70% rovného podílu; vysoká marže = alespoň průměrná marže na prodaný kus. Nákladová cena se bere z Apicbase (Nastavení → Receptury), jinak z nákupní ceny produktu (nákupní cena za balení dělená počtem kusů v balení), jinak z receptu ze surovin s nákupní cenou (Zásoby). Produkty bez nákladové ceny jsou uvedeny zvlášť dole. Volitelně podle skupiny produktů (?groep=).
• Akce a kódy: podle slevového kódu, podle akce z Marketing (osobní kódy dohromady) a podle happy hour: kolikrát použito (účtenky; u happy hour i kusy), kolik slevy, tržby a průměr na účtenku.
• Ztráty: co bylo odepsáno ze zásob (Nastavení → Zásoby, Odepsat (−)), podle důvodu (velká písmena a mezery nehrají roli) a podle produktu nebo suroviny, s hodnotou v nákladové ceně; a co bylo stornováno poté, co už to bylo odesláno do kuchyně nebo na bar, s prodejní a nákladovou hodnotou.

Slevy

Vedoucí nebo správce vidí na obrazovce objednávky vedle součtu tlačítko % Sleva:

• na celou účtenku nebo na jeden řádek;
• jako procento (10, 15, 20, 25, 50, 100% = zdarma, nebo zadejte vlastní) nebo jako pevnou částku;
• vždy s důvodem (Personál, Stálý zákazník, Stížnost, Akce, Vlastní spotřeba nebo zadejte vlastní).

Sleva se objeví jako samostatná položka na účtence ("Sleva 10%", s důvodem pod ní) se stejnou sazbou DPH, takže součet i rozpis DPH sedí. Na celé účtence se sleva rozdělí podle sazeb DPH. Odstranění: klepněte na částku slevové položky. Je-li položka s vlastní slevou stornována, sleva zanikne s ní. Odeberete-li produkt z účtenky s procentní slevou na celou účtenku, pokladna tuto slevu přepočítá z toho, co zbývá (v Belgii UC226); pevná částka zůstane a při placení se znovu rozdělí na položky. Není-li kvůli slevě 100% co platit, uzavřete účet pomocí "Uzavřít (nic k placení)". Slevy jsou v protokolu a v X/Z-zprávě i v přehledu za období jako "z toho sleva". Při vrácení účtenky se slevou se sleva započítá poměrně.

Slevové kódy (volitelné)

Kódy se slevou na celou účtenku, například pro akci (ZOMER10). Zapnutí v Nastavení → Provozovna → Slevové kódy (ve výchozím stavu vypnuto); kódy vytvoříte v Nastavení → Slevové kódy (oprávnění Spravovat produkty):

• sleva v procentech nebo pevná částka, případně s minimální hodnotou objednávky, platností od/do a nejvýše tolikrát (prázdné = neomezeně);
• u každého kódu: na pokladně a/nebo v e-shopu (pokladna posílá kódy spolu s menu; použití se počítá společně pro pokladnu i e-shop).

Na objednávací obrazovce je tlačítko Slevový kód (kód smí zadat kdokoli; kód předem vytvořila provozovna). Sleva se objeví na účtence jako řádek "Slevový kód KÓD", rozdělená podle sazeb DPH; jeden kód na účtenku, a ne poté, co už bylo (částečně) zaplaceno. Když řádek odeberete nebo se objednávka zruší, použití se už nepočítá. Odstranění použitého kódu jej vypne (přehledy zůstanou správné). Vše je v protokolu (Slevový kód). Kód: lib/kortingscodes.ts, routes/kortingscodes.ts, Kortingscodebeheer.tsx, KortingscodeDialoog.tsx.

Nejsou v seznamu v Nastavení → Slevové kódy (počet pro každou akci ano, v Přehled → Marketing) a do e-shopu se přenášejí, dokud jsou platné a nepoužité.

Přehledy a denní uzávěrka

Tlačítko Přehled v horní liště:

• Mezisoučet (X): obrat, DPH, způsoby platby, podle skupin a pokladní zásuvka od předchozí denní uzávěrky. Lze i vytisknout. Nic neuzavírá.
• Uzavřít den (Z) (vedoucí nebo správce): spočítejte pokladní zásuvku (zobrazí se rozdíl oproti počáteční hotovosti + hotovosti), zadejte počáteční hotovost na další den, uzavřete. Z-zpráva dostane pořadové číslo, uloží se a vytiskne na tiskárně účtenek. Není možné, dokud jsou ještě otevřené objednávky. Volitelně: Počítat po mincích a bankovkách (pomůcka k počítání) vyplní napočítanou částku za vás; počet mincí/bankovek se pak objeví i na Z-zprávě. Zadání součtu vlastní rukou funguje jako vždy.
• Pokladní zásuvka (vedoucí nebo správce, volitelné):
  • Výběr peněz ze zásuvky (vklad do banky, výdaj, vyplacené spropitné) nebo vklad peněz do zásuvky (drobné) s částkou a důvodem. Zásuvka se otevře a vytiskne se doklad s řádkem pro podpis, který se uloží k hotovosti (lze vypnout). Počítá se do očekávané hotovosti v zásuvce a je uveden po řádcích na X- a Z-zprávě.
  • Zadat nebo opravit dnešní počáteční hotovost (obvykle ji zadáváte při denní uzávěrce na další den).
  • Otevřít zásuvku bez prodeje, s důvodem.
  • Vše se zaznamenává v protokolu. Pokud to nepoužíváte, denní uzávěrka funguje přesně jako dříve (počáteční hotovost + hotovost = očekávaná hotovost v zásuvce).
• Pod obratem je počet hostů (osoby ze zaplacených objednávek) a průměr na hosta, i na vytištěné X/Z-zprávě.
• Obrat za období (vedoucí nebo správce): dnes, včera, tento/minulý týden, tento/minulý měsíc, tento rok nebo vlastní od-do. Ukazuje obrat, DPH, způsoby platby, spropitné, hosty, skupiny produktů, po dnech a podle zaměstnanců. Export (Excel/CSV) vám dá soubor pro účetního (středníky a desetinné čárky, otevře se rovnou v nizozemském Excelu).
• Předchozí Z-zprávy: seznam s obratem a rozdílem v hotovosti; otevřete je a vytiskněte kopii (označenou "KOPIE").

Export do účetnictví

Přehled → Tržby za období → Export do účetnictví (deník) (oprávnění Tržby za období) vytvoří CSV s jedním účetním zápisem za den, připravené k načtení v e-Boekhouden, Exact, SnelStart, Twinfield apod. (přes jejich import CSV nebo interních dokladů), nebo jeden z formátů níže (UBL, XAF a připravené formáty pro 14 programů).

Jeden doklad za den (KASSA-JJJJMMDD), který vždy sedí (má dáti = dal):

Vrácení a slevy jsou již zahrnuty v příjmech a snižují obrat. Sloupce: Datum; Boekstuk; Dagboek; Rekening; Omschrijving; Debet; Credit; Btw-code; Btw-% (středníky, desetinné čárky). Po stažení pokladna hlásí, zda jsou dny, které nesedí nebo mají větší rozdíl než zaokrouhlení.

Vedle tlačítka zvolíte formát (volba se pamatuje v prohlížeči). Stejný deník, ale upravený tak, aby ho program mohl přímo načíst. Seznam ukazuje jen formáty pro zemi provozovny (Nastavení → Provozovna), nejprve standardy (CSV, UBL, XAF), pak programy abecedně:

Přehled: který účetní program jakým způsobem

Podle segmentu, abecedně. NL/BE = v které zemi program funguje: v Nastavení → Účetnictví → Účetní program vidíte jen programy pro zemi provozovny (nizozemské programy nefungují v Belgii a naopak). Živě = pokladna každý den účtuje sama (volí se v Nastavení → Účetnictví → Účetní program); na vyžádání = API existuje, ale nejprve vyžaduje partnerskou registraci nebo schválení u dodavatele (dejte nám vědět). Soubor = formát v Export do účetnictví. Kde jde obojí, můžete používat obojí. Seznam je v packages/shared/src/boekhoudcatalogus.ts a zobrazuje se také v Nastavení → Účetnictví.

Nechte první import zkontrolovat účetním. Formát je v packages/shared/src/journaalexport.ts (s testy).

Nastavení → Účetnictví (oprávnění Nastavit podnik, platby a tiskárny): kód deníku (výchozí MEM) a účet hlavní knihy pro každou položku. Prázdné = vzorový účet (NL: 8000/8010/8020 obrat, 1500/1510 DPH, 1000 hotovost, 1100 karta; BE: 7000xx obrat, 451000 DPH, 570000 hotovost). Skutečné účty ať vyplní účetní.

Propojení s účetním programem

Živá propojení s Acumulus, AFAS Profit, Microsoft Dynamics 365 Business Central, Exact Online, Horus, Moneybird, Odoo, QuickBooks Online, SAP Business One, Silvasoft, SnelStart, Twinfield, Xero, Yuki a Zoho Books. Po každém dni pokladna zaúčtuje stejný zápis jako export výše (tržba a DPH podle sazby, způsoby platby, spropitné, zaokrouhlení, zásuvka a pokladní rozdíl) jako interní doklad ve zvoleném programu, s deníkem a účty hlavní knihy z Nastavení → Účetnictví. Zapnutý je vždy nejvýše jeden program.

• Seznam je rozdělen podle segmentu (malé firmy a OSVČ, mezinárodní, enterprise a řetězce) a ukazuje jen programy, které fungují v zemi provozovny; server odmítne program z jiné země (400) a neúčtuje s ním (409). Hned pod ním správce dostane přesně pole tohoto programu; připojení a seznam zaúčtovaných dnů jsou pod účty hlavní knihy a pod nimi přehled všech programů pro tuto zemi. Pokud byly při aktualizaci zapnuté dva (ve starší verzi to šlo), zůstane zapnutý Exact Online a druhý program se vypne.

• OAuth (Horus, QuickBooks, Twinfield, Xero, Zoho): jednou zaregistrovat aplikaci u programu.
• U několika programů nelze pole API plně ověřit z veřejné dokumentace (mj. Horus, Zoho Books, znaménko u Business Central a struktura u SAP Business One): první zaúčtování vždy nechte zkontrolovat účetním.
• Exact Online: zaúčtuje zápis jako interní doklad ve zvolené administraci.
  • Volí se v Nastavení → Účetnictví → Účetní program → Exact Online (ve výchozím stavu Vypnuto). Belgie: pokladna automaticky používá start.exactonline.be.
  • Nastavení → Účetnictví → Exact Online: Připojit k Exact Online otevře přihlášení do Exact; potom je vidět, ke které administraci je pokladna připojena. Do pole Deník zadejte kód interního deníku v Exact (např. 90) a zajistěte, aby účty hlavní knihy v Exact existovaly.
  • Kdy: hned po Uzavřít den a dál každou hodinu, za všechny uplynulé dny (do včerejška včetně) od Účtovat od (ve výchozím stavu den připojení; dřívější dny už účetní má). Každý den jednou; dny bez tržby se přeskočí. Zaúčtovat teď jde kdykoli.
  • Chyby (účet v Exact neexistuje, den nesedí, není internet) jsou s důvodem uvedeny u daného dne; pokladna to zkusí později znovu a další dny čekají, dokud se to nepodaří (aby zůstalo správné pořadí). V protokolu: "exact_geboekt".
  • DPH je na účtech DPH v hlavní knize (bez kódu DPH, stejně jako v exportu). Nechte první zápisy zkontrolovat svým účetním.
  • Exact: připojení funguje, dokud ho pokladna používá (každých 10 minut nový token, pokaždé nový refresh token). Pokud je odvoláno nebo se dlouho nepoužívá, pokladna požádá o Znovu připojit. Zrušit spárování smaže tokeny; co je zaúčtováno, zůstane.
• AFAS Profit: číslo prostředí (např. 12345; produkce, test nebo akceptace), token konektoru aplikace s UpdateConnector FiEntries a číslo administrace (výchozí 1). Deník = kód interního deníku v AFAS (např. 90).
• Deník = číslo nebo název interního deníku; pokud je jen jeden, pokladna použije ten. Účty hlavní knihy musí být čísla.
• Twinfield: přihlášení přes OAuth. Bez této aplikace se pokladna nemůže připojit. Pokladna vyhledá cluster a účetní jednotku (prázdné = první); deník = kód interního deníku (např. MEMO). Účtuje definitivně (destiny="final").
• Yuki: API klíč administrace (Yuki → Nastavení → Webové služby); prázdná administrace = první k tomuto klíči. Účtuje interní doklad (GeneralJournal); Yuki nepoužívá kód deníku.
• Kdy: hned po Uzavřít den a každou hodinu, za všechny uplynulé dny od Účtovat od (výchozí je den připojení; u jiného programu znovu od toho dne). Každý den jednou za program; dny bez tržby se přeskočí; při chybě je u daného dne uveden důvod a další dny čekají. Zaúčtovat teď lze vždy. V protokolu: "boekhoudpakket_geboekt".
• Klíče a tokeny se nikdy nezobrazují (při novém připojení nechte prázdné = ponechat). Na kopii pokladny v portálu se neúčtuje.

Auditní soubor pokladny (XAA)

Pro nizozemské provozovny je v Přehled → Tržby za období vedle exportu do účetnictví tlačítko Auditní soubor pokladny (XAA): XML Auditfile Afrekensystemen 3.2 nizozemské daňové správy (Belastingdienst) a XML Platform (SRA) za zvolené období (nejvýše něco přes rok; oprávnění Tržby za období). Je to soubor, který Belastingdienst doporučuje k předání dat pokladny při kontrole nebo účetnímu; pravidla jsou uvedena v Handreiking voor een betrouwbaar afrekensysteem (Příručka pro spolehlivý pokladní systém, docs/xaa).

V souboru (auditfile_kassa_<van>_tm_<tot>.xml, schéma docs/xaa/XmlAuditfileAfrekensystemen3.2.xsd):

• kmenová data: provozovna (název, DIČ, adresa), kódy DPH, všichni zaměstnanci (s rolí a datem vytvoření; navíc SYSTEEM pro to, co dělá pokladna sama, např. e-shop a propojení) a všechny položky s jejich skupinou;
• události: vše z protokolu za období (přihlášení a odhlášení, otevření pokladní zásuvky, uzávěrka dne, změna nastavení a cen, storno, sleva, vratka, kopie účtenky, příchod a odchod ...) a otevření pokladního dne s počáteční hotovostí, každá s kódem Belastingdienst (18001 přihlášení, 18003 zásuvka, 18006 změna instalace, 18008 Z-uzávěrka, jinak 18999);
• pokladní transakce: každá účtenka (prodej, vratka a proforma, s číslem účtenky, zaměstnancem a fiskálním stavem, pokud není v pořádku) se všemi řádky (položka, skupina, množství, cena, DPH; také slevy, dárkové poukazy, záhlaví menu a řádky zrušené před zaplacením, ty s částkou 0), DPH podle sazby, zaokrouhlení, platby podle způsobu platby (hotovost, karta, dárkový poukaz, online; spropitné zvlášť) a vklady/výběry hotovosti z pokladní zásuvky.

Částky jsou kladné s C (prodej, příjem) nebo D (vratka, výplata); časy jsou v nizozemském čase s posunem. Všechny klíče jsou id z databáze bez pomlček, takže je lze v pokladně dohledat.

Podepisování (kapitola 6 specifikace): pokud Optimum POS nastavil certifikát, auditní soubor přichází podepsaný v obálce (XML Signature) a soubor se jmenuje …_ondertekend.xml; jinak jde o samostatný auditní soubor a pokladna to při stahování oznámí.

Platba na fakturu

Firemní zákazníci (firma, která si každý týden vyzvedává obědy, hotel, spolek) nakupují na fakturu a platí později, na základě faktury. Zapněte to v Nastavení → Faktury → Platba na fakturu (jen se zapnutými Fakturami; ve výchozím stavu vypnuto).

• Zákazníci: v Přehled → Na fakturu zadáte firemní zákazníky s údaji pro fakturu (název, adresa, DIČ, IČO/KvK, Peppol-ID, e-mail), případně limit (kolik smí být nejvýše otevřeno) a vlastní splatnost (jinak ta u faktur) a zda se faktura odešle hned.
• Placení: způsob platby Na fakturu, zvolte zákazníka (s tím, co už je otevřeno, a s limitem). Účtenka je běžný prodej: tržba a DPH v daný den, v Belgii normálně přes černou skříňku, na účtence "Na fakturu". Pokladna hned vytvoří fakturu (UBL/Peppol a k tisku) na zbývající částku s datem splatnosti a odešle ji podle nastavení faktur (e-mail, Peppol přes Billit/Storecove/Banqup nebo vlastní adresu). Na fakturu je jedna částka za zbytek účtu (část lze předtím zaplatit jinak), bez spropitného; dárkový poukaz nelze prodat na fakturu. Nad limitem pokladna odmítne.
• Platba: zákazník platí v provozovně hotově, kartou nebo dárkovým poukazem (Přehled → Na fakturu → Platba přijata; i částečně). Nejde o nový prodej ani novou účtenku: hotovost jde jako peníze do zásuvky (zásuvka se otevře), vše je na X a Z pod Přijato na fakturu. Když je vše zaplaceno, faktura má stav "zaplaceno". Online platba sem nepatří.
• Převodem: pokud je v Údaje na faktuře uveden IBAN, je uveden na faktuře (i v UBL) s textem "Zaplatit lze i v provozovně". Pokud zákazník zaplatil převodem, zaznamenejte to přes Platba přijata → Zaplaceno převodem: ne do zásuvky, ale na X a Z v položce Přijato na fakturu. Bez IBAN je uvedeno "K úhradě v provozovně". V Belgii je na faktuře a v UBL uvedena strukturovaná zpráva (+++123/4567/89012+++, z čísla faktury), aby ji banka předala dál.
• Banka: párování převodů bez přepisování, viz níže.
• Kredit (peníze předem): v Přehled → Na fakturu → Vložit kredit vložíte peníze předem na účet zákazníka, hotově (zásuvka se otevře) nebo kartou, např. na sérii obědů. Při příštím prodeji na fakturu se kredit nejprve odečte z faktury; je-li faktura vyšší, zbytek zůstane otevřený. Kredit je uveden u zákazníka (kredit € ...), na X a Z pod Přijato na fakturu (Kredit vložen, Z kreditu zákazníka) a v účetním zápisu jako přijato předem (výchozí 1640 / 460000). V Belgii jde vklad do černé skříňky jako příjem peněz (signMoneyInOut) (UC4100).
• Souhrnná faktura (pro zákazníka, ve výchozím stavu vypnuto): s volbou Jedna faktura za všechny účtenky zákazník při prodeji na účet ještě nedostane fakturu. Účtenka zůstane u zákazníka otevřená (Dosud nefakturované účtenky, započítává se do limitu) a lze ji už zaplatit. Tlačítkem Vytvořit souhrnnou fakturu (např. na konci měsíce) se všechny otevřené účtenky dostanou na jednu fakturu, každá položka s číslem účtenky před sebou; co je už zaplaceno, je na ní uvedeno jako zaplacené. Vratka na účet se na ní objeví jako záporné položky. Vypnuto = jako vždy faktura za každý prodej. V Belgii jedna faktura se všemi účtenkami v černé skříňce (signInvoice, UC4121 a UC4122).
• Belgie: zaplatí-li zákazník později prodej na fakturu (hotově, kartou, dárkovým poukazem nebo převodem), pokladna to nahlásí jako opravu platby na účtence: z kreditu zákazníka na skutečný způsob platby (signPaymentCorrection, UC4118).
• Přehled: neuhrazené faktury s datem splatnosti (po splatnosti červeně), u každého zákazníka faktury a platby. V Nastavení → Faktury sloupec Otevřeno.
• Účetnictví: v deníku jde prodej na fakturu na Pohledávky (výchozí 1300 v Nizozemsku, 400000 v Belgii; lze nastavit v Nastavení → Účetnictví) a platba z pokladny, karty, dárkového poukazu nebo banky (výchozí 1050 / 550000) na pohledávky. XAA: způsob platby "Na fakturu".
• Oprávnění: Platit na fakturu a přijímat platby na fakturu (výchozí obsluha ne, manažer ano). Vše je v protokolu.
• Vypnuto: zákazníci, faktury a platby zůstanou uložené (i v záloze); přepínač je součástí exportu konfigurace, zákazníci ne (patří k jedné provozovně).
• V e-shopu (volitelné, ve výchozím stavu vypnuto): se zapnutým Také v e-shopu objednávají firemní zákazníci online na fakturu (vyzvednutí i rozvoz). V Přehled → Na fakturu vytvoříte pro každého zákazníka zákaznický kód a předáte mu ho; pokladna ukládá jen zašifrovanou verzi, takže ho uvidíte jen jednou. Nový zákaznický kód = starý přestane platit; Odebrat zákaznický kód = tento zákazník už nemůže objednávat online na fakturu. E-shop hlídá limit. V okně E-shop takovou objednávku dokončíte tlačítkem Dokončit (na fakturu): zaplacení na fakturu, rovnou s fakturou.

Banka: párování převodů

V Přehled → Na fakturu → Banka pokladna ke každé příchozí platbě hledá odpovídající fakturu s platbou na fakturu:

• Načíst bankovní výpis: soubor z internetového bankovnictví ve formátu CAMT.053 (XML, všechny banky v Nizozemsku a Belgii), MT940 (.sta/.940) nebo CODA (.cod, Belgie). Jen příchozí platby; dvojí načtení výpisu nevytvoří duplicitní řádky.
• Vyhledání: podle čísla faktury nebo strukturované zprávy v popisu (jisté), jinak podle částky (a jména): pak jde o návrh. Každý řádek můžete spárovat (s návrhem nebo jinou fakturou), ignorovat nebo později přesto spárovat. Spárování = Zaplaceno převodem k datu banky, nikdy víc, než zbývá uhradit; ne do zásuvky.
• Propojení s bankou (PSD2, volitelné): v Nastavení → Faktury → Propojení s bankou pokladna každou hodinu sama stahuje příchozí platby přes Enable Banking (banky v Nizozemsku, Belgii a zbytku Evropy). Vyberte banku a přihlaste se do ní (firemní účet); souhlas platí 180 dní, pak je třeba propojit znovu. Odpojení souhlas odvolá; příchozí platby zůstanou. Bez smlouvy s Enable Banking to funguje jen pro vaše vlastní účty (restricted production).
• Automatické párování (ve výchozím stavu vypnuto): příchozí platbu, která jistě patří k faktuře, pokladna ihned spáruje (i při načítání).
• Oprávnění: párování s Účtovat na fakturu a přijímat platby na fakturu; nastavení propojení s bankou s Nastavit podnik, platby a tiskárny. Načítání, propojení, stahování a párování se zapisují do protokolu.
• Vypnuto: když je platba na fakturu vypnutá, pokladna nic nestahuje; příchozí platby a propojení zůstanou uložené (i v záloze).

Obraz z kamer v pokladně

Všechny obrazy z kamer provozovny na jedné stránce, bez samostatné obrazovky nebo aplikace. Zapněte to v Nastavení → Provozovna → Obrazovky a ovládání → Obraz z kamer v pokladně (ve výchozím stavu vypnuto). Pak se v horní liště objeví tlačítko Kamery pro každého s oprávněním Sledovat obraz z kamer (ve výchozím stavu manažer a správce; v Nastavení → Oprávnění lze zapnout i pro obsluhu). Všechny kamery jsou vedle sebe; klepnutím na kameru zobrazíte velký obraz. Po vypnutí zůstanou kamerové systémy uložené.

Také jako vlastní obrazovka: Na vlastní obrazovce otevře http://<kassaserver>:3000/camera (např. monitor za barem), a Na tabletu nebo telefonu zobrazí QR kód: zaměstnanec ho naskenuje vlastním tabletem nebo telefonem a přihlásí se vlastním PINem (i tam jen s oprávněním Sledovat obraz z kamer). Na úzké obrazovce jsou kamery pod sebou. Viz Druhá obrazovka na tabletu nebo telefonu.

Správce přidá kamerové systémy tlačítkem + Kamerový systém, vyzkouší je tlačítkem Otestovat a u každé kamery zvolí název a zda je na stránce:

• Hikvision, Dahua, Axis a Reolink: kamera nebo rekordér (NVR) v síti: IP adresa (případně s :poort), uživatel (nejlépe jen pro sledování) a kanály, např. 1-8 nebo 1,3,5. Přihlášení přes Basic nebo Digest; https s vlastním certifikátem je povolen.
• Synology Surveillance Station: adresa NAS (výchozí port 5000, s https 5001) a uživatel; Načíst kamery načte kamery i s jejich názvy.
• UniFi Protect: adresa konzole (https) a místní účet; Načíst kamery.
• ONVIF: jakákoli kamera nebo rekordér s ONVIF (např. Hanwha, Bosch, Uniview, Annke); Načíst kamery vyhledá pro každý videozdroj adresu fota.
• Vlastní webová adresa: foto (JPEG), stream MJPEG nebo adresa rtsp://.
• Webová stránka kamerového systému (např. Frigate, Blue Iris nebo go2rtc): otevře se v pokladně tlačítkem Kamery (nebo ve vlastním okně).

Bez ffmpeg: foto.

Soukromí: pokladna načítá obrazy z kamerového systému a jen je předává dál; nic se neukládá (žádné záznamy, žádná mezipaměť). Uživatelé a hesla zůstávají na serveru a nikdy se neobjeví na obrazovce ani v protokolu. V protokolu je vidět, kdo kamery sledoval. Samotné obrazy si stránka vyžádá klíčem (platným 12 hod., dokud je zaměstnanec přihlášen), protože obraz v prohlížeči nemůže poslat token. Export konfigurace obsahuje jen zapnuto/vypnuto.

Záznam citlivých akcí

Přehled → Protokol (vedoucí nebo správce) ukazuje, kdo co a kdy udělal.

• Zvolte období (dnes, včera, tento týden, tento/minulý měsíc nebo vlastní od-do), co chcete vidět (výchozí Citlivé akce, nebo např. jen storna a slevy, nebo Vše) a případně jednoho zaměstnance.
• Nahoře podle zaměstnanců: počet a částka storen (odebráno po objednání), slev a vrácení a kolikrát byla zásuvka otevřena bez prodeje, výběry ze zásuvky, kopie účtenek, proforma účty a ruční platby kartou. Klepnutím na jméno uvidíte jen tohoto zaměstnance. Také počet zadání špatného PINu.
• Pod tím každá akce s časem, kdo, co a srozumitelným popisem (např. "2x Cola odebráno po objednání € 5,60 · stůl 4 · důvod: zákazník si to rozmyslel").
• Stáhnout (CSV) pro Excel.

Co se zaznamenává: storna, slevy (a jejich odebrání), vratky, kopie účtenek, pro forma, ruční platby kartou, otevření zásuvky, vklady/výběry hotovosti ze zásuvky, počáteční hotovost, denní uzávěrka, přesun položek nebo stolů, zavření prázdných objednávek, změna ceny/názvu/DPH produktů, nové nebo smazané produkty, změny personálu a nastavení, úprava pracovní doby, přihlášení a odhlášení, chybné PINy a příchody a odchody. S platbou na účet také: zákazníci, prodeje a platby na účet, načítání bankovních výpisů, napojení na banku a stahování z banky. S hlášením při příliš dlouhé době přípravy: zpožděné objednávky a odeslané omluvy. S Mailchimp nebo Klaviyo: připojení, volba seznamu, odpojení a odhlášení odtamtud. S ovládáním hudby: zapnuto/vypnuto a přidání, úprava a odstranění zdrojů hudby. S obrazem z kamer: kdo kamery sledoval (nejvýš jednou za půl hodiny na zaměstnance), zapnuto/vypnuto a kamerové systémy. S upozorněními: každé upozornění, jeho vyřízení a zapnutí a vypnutí.

Upozornění: podvody a odchylky

Nastavení → Upozornění. Dvě části, každá se zapíná zvlášť a ve výchozím stavu je vypnutá; vypnutím se zachovají všechna upozornění a nastavení. Nastavovat smí ten, kdo má oprávnění Nastavit upozornění (ve výchozím stavu manažer a správce); upozornění vidět a vyřizovat smí ten, kdo smí vidět protokol. Pokladna kontroluje každých 5 minut (a tlačítkem Zkontrolovat nyní); ne na záložní pokladně.

Odhalování podvodů a krádeží (na zaměstnance, na pracovní den od 05:00), každé pravidlo zvlášť zapnuté nebo vypnuté s vlastním limitem:

• storna po pro forma: odebráno poté, co host už viděl účet;
• storna, slevy a vrácení: od určitého počtu, nebo celkem od určité částky (0 = ne podle částky);
• zásuvka otevřena bez prodeje (tlačítko Otevřít zásuvku);
• účet dlouho otevřený: objednáno, ale po určitém počtu minut stále nezaplaceno.

Hlášení odchylek, ve srovnání se stejným dnem v týdnu a stejným časem v posledních týdnech (výchozí 4; dny bez tržby se nepočítají, alespoň dva srovnávací dny):

• tržba zatím o víc než rozpětí nižší (a/nebo vyšší) než obvykle, teprve od nastavené běžné tržby;
• doba v kuchyni (od účtu do kuchyně po hotovo na kuchyňské obrazovce) za poslední hodinu nad rozpětím, nebo nad pevným počtem minut;
• storna dnes nad rozpětím, teprve od minimálního počtu.

Každé upozornění přijde jednou (za pravidlo, zaměstnance a den; doba v kuchyni nejvýš jednou za hodinu) a jde do:

• pokladny: tlačítko Upozornění (n) v horní liště s upozorněními za poslední den, týden nebo 30 dní; Vyřízeno s poznámkou. Ostatní obrazovky dostanou jen signál bez jmen;
• push oznámení přes ntfy (bezplatná aplikace; ntfy.sh nebo vlastní server, topic a případně token), Pushover (API-token aplikace a user key) nebo Telegram (token bota a chat-id);

Každý kanál má tlačítko Testovací zpráva. Tokeny a klíče zůstávají na pokladně (obrazovky vidí jen, zda jsou vyplněné). Upozornění není důkaz: zkontrolujte účet a protokol a proberte to se zaměstnancem.

Účtenky: kopie a vrácení (dobropis)

Tlačítko Účtenky v horní liště:

• Seznam účtenek od poslední denní uzávěrky, nebo za posledních 7 dní; starší účtenku najdete podle čísla.
• Vytisknout kopii: stejná účtenka označená "KOPIE" (v Belgii s blokem FDM původní účtenky). Zaznamená se v protokolu.
• Vrácení / dobropis (vedoucí nebo správce): u každého řádku zvolte, kolik se vrací, důvod a jak se peníze vracejí (hotovost, karta, dárkový poukaz, jiné). Stará účtenka zůstane nedotčena: přibude nový dobropis s vlastním číslem v deníku (typ dokladu retour, záporné částky, v Belgii odeslán do FDM jako NR). Nikdy nemůžete vrátit více, než bylo prodáno. V X- a Z-zprávě se vrácení počítá jako záporný obrat.
• S CCV nebo jiným terminálem: nejprve vraťte peníze na samotném terminálu a pak zaškrtněte "Již vráceno na terminálu".
• Hotovost se zaokrouhlením na 5 centů: i částka k vrácení se zaokrouhlí.
• Zpět na fakturu (prodej na fakturu): byla-li účtenka na fakturu firemního zákazníka, zvolte Na fakturu. Částka se odečte z otevřené faktury a pokladna hned vytvoří dobropis (v UBL CreditNote, typ 381, s odkazem na fakturu; v Belgii podepsaný pomocí signInvoice, UC4122). Víc, než je na faktuře otevřeno, nelze vrátit na fakturu; zbytek vraťte hotově nebo kartou. Dobropis je v Faktury a posíláte ho jako fakturu.

Pokladní zásuvka se senzorem a zásuvka pro každého zaměstnance

Ve výchozím stavu vypnuto. Nastavení v Nastavení → Platby → Pokladní zásuvka.

• Senzor: mnoho zásuvek hlásí přes tiskárnu účtenek, zda jsou otevřené nebo zavřené (ESC/POS DLE EOT 1, pin 3 portu DK). To je možné jen s tiskárnou účtenek připojenou přes síť. Klepněte na Měřit: zásuvka zavřená a Měřit: zásuvka otevřená; je-li v tom rozdíl, převezmete správné nastavení (vysoká = otevřeno nebo nízká = otevřeno). Žádný rozdíl = tato zásuvka (nebo kabel) nemá senzor. Žádná odpověď tiskárny = neznámo, nikdy "zavřeno".
  • Neplatit, dokud je zásuvka otevřená: pokladní server pak odmítne novou platbu s hlášením "Pokladní zásuvka je stále otevřená".
• Vlastní zásuvka pro každého zaměstnance: tiskárna účtenek může otevírat dvě zásuvky (zásuvka 1 a zásuvka 2). Zvolte zásuvku pro každého zaměstnance; pokladna pak při placení hotově, při vkladu/výběru peněz ze zásuvky a při Otevřít zásuvku otevře zásuvku toho, kdo je přihlášen. V Přehled → Pokladní zásuvka je pak Zásuvka podle zaměstnance: počáteční stav pro každého zaměstnance, hotovost (bez platebního automatu), očekáváno, Spočítat a rozdíl pro každou osobu (v protokolu jako ladetelling). Běžná denní uzávěrka zůstává beze změny.
• Test zásuvky 1 a Test zásuvky 2 otevřou zásuvku pro kontrolu.
• Otevřít zásuvku bez prodeje se (s důvodem) vždy zapisuje do protokolu a do auditního souboru pokladny (XAA), jak to požaduje daňová správa (Belastingdienst) (výjimky jako "no sale").

Část 3 · Správce

Začínáme

Instalace. HorecaPOS nainstalujete instalátorem pro váš systém, který najdete na stránce ke stažení OptimumPOS: Android (aplikace), Windows (instalátor), macOS (instalátor pro Macy s Apple Silicon i Intel), Linux (grafický instalátor, nebo balíček .deb či .rpm), Raspberry Pi (grafický instalátor nebo .deb pro Raspberry Pi 3, 4 nebo 5 s 64bitovým Raspberry Pi OS) a Chromebook (aplikace pro Android z Google Play). Zvolte pro všechny uživatele pro pokladní server, ke kterému se připojují tablety a kuchyňská obrazovka, nebo jen pro mě pro samotnou pokladnu na tomto zařízení. Instalátor nastaví vše potřebné, včetně databáze, a každou noc vytvoří zálohu. Pro aktualizaci nainstalujte novou verzi: vaše data zůstanou zachována. Instalátor se spustí v jazyce vašeho počítače (jinak anglicky); ve Windows a Linuxu můžete na první obrazovce zvolit jiný jazyk. Pokladna se pak rovnou spustí v tomto jazyce. Balíčky .deb a .rpm a aplikace pro Android se řídí jazykem systému, jinak nizozemštinou.

Správce nastavuje pokladnu přes Nastavení. Najdete tam karty jako Podnik, Zaměstnanci, Oprávnění, Pracovní doba, Produkty, Happy hour, Zásoby, Plánky, Platby, Tiskárny, Účetnictví, Zálohy, Import/export a Databáze. Které karty vidí i vedoucí, závisí na oprávněních.

Databáze. V Nastavení → Databáze (jen správce) volíte mezi MySQL / MariaDB, vestavěnou databází a PostgreSQL; při přepnutí se přenesou všechna data (viz Databáze). Pokud Optimum POS už při instalaci nastavil pevnou adresu, platí tato adresa a žádná vstupní pole nejsou. Jinak vyplníte Server, Port, Databáze, Uživatel a Heslo sami. Pokladna si je uloží sama, poté je znovu zobrazí vyplněné a kdykoli je můžete změnit pomocí Změnit údaje MySQL/MariaDB nebo Změnit údaje PostgreSQL. Ponechat heslo prázdné znamená: zachovat uložené heslo (u stejného uživatele). Instalátor ani aktualizace nemění nic na DATABASE_URL ani na zvolené databázi.

Účetnictví

Vše pro účetnictví najdete v Nastavení → Účetnictví. Společně se svým účetním vyplňte deník a účty hlavní knihy. Chcete-li, aby pokladna denní tržbu každý den účtovala sama, zvolte nahoře v Účetní program svůj program, i Exact Online: vidíte jen programy, které fungují v zemi vaší provozovny. Hned pod tím vyplníte údaje tohoto programu a připojíte se. U programů, do kterých se přihlašujete (např. Exact Online, Twinfield nebo Xero), nejprve vyplníte aplikaci: ID klienta a tajný klíč klienta. Pokud Optimum POS program nebo některý údaj pevně nastavilo při instalaci, tuto volbu ani toto pole neuvidíte. Je tam také přehled všech programů: které lze propojit živě a které dostanou soubor. Soubor vytvoříte v Přehled → Tržby za období → Export do účetnictví: zvolte formát svého programu, nebo UBL (Peppol), XAF či denní výkaz. První zaúčtování nebo import vždy nechte zkontrolovat svým účetním.

Pro nizozemskou provozovnu je tam také Auditní soubor pokladny (XAA): XML Auditfile Afrekensystemen nizozemské daňové správy (Belastingdienst) se všemi účtenkami, řádky, platbami a událostmi pokladny za zvolené období. Ten předáte svému účetnímu nebo při kontrole Belastingdienst.

Mzdy a plánování

Pokud vaši zaměstnanci používají docházku (příchody a odchody), najdete v Nastavení → Pracovní doba dole Mzdy a plánování ve dvou blocích. V části Mzdová agenda zvolíte svůj mzdový program nebo (v Belgii) svůj sociální sekretariát a u každého zaměstnance vyplníte jeho osobní číslo v tomto programu. Pak pro zvolené období vytvoříte soubor s odpracovanými hodinami a tržbami na zaměstnance a načtete ho do mzdového programu. V části Plánování personálu zvolíte svůj plánovací systém: u Deputy, Dyflexis a Shiftbase jdou tržby každou hodinu automaticky, u ostatních vytvoříte soubor tržeb. Tak ve svém plánování vidíte mzdové náklady vedle tržeb. Pokud pracujete bez docházky, můžete tržby do plánování posílat i tak: to pak najdete dole v Nastavení → Účetnictví, u Tržby do vašeho plánování. Pokud Optimum POS při instalaci něco pevně nastavil, tuto volbu nebo toto pole neuvidíte.

Zálohy

Pokladna vytváří zálohu automaticky každou noc a vždy před aktualizací. V Nastavení → Zálohy vidíte všechny zálohy (kdy, kým nebo automaticky, velikost) a sami můžete vytvořit zálohu tlačítkem Vytvořit zálohu. Je-li poslední záloha starší než dva dny, objeví se červené varování: v takovém případě kontaktujte Optimum POS.

Obnovení se provádí tlačítkem Obnovit vedle zálohy. Vše, co se stalo po této záloze, se pak ztratí. Musíte zaškrtnout políčko a znovu zadat svůj PIN. Pokladna nejprve vytvoří bezpečnostní zálohu aktuálního stavu a pak všechny odhlásí. V Belgii to z pokladny nelze (počítadla černé skříňky běží dál); tam to provádí Optimum POS.

Databáze

V Nastavení → Databáze (jen správce) vidíte, kde pokladna ukládá svá data. Nahoře je současná databáze s programem, verzí, tabulkami, řádky a adresou nebo složkou. Pro personál a tablety funguje pokladna s každou databází stejně. Ve Windows, macOS, Linuxu a na Raspberry Pi volíte ze tří databází:

• MySQL / MariaDB: samostatný databázový program (MySQL 8.0 nebo novější, MariaDB 10.6 nebo novější), například na serveru nebo NAS, který už máte. Všechna data jsou pak v běžných tabulkách v MySQL nebo MariaDB, čitelná pro váš vlastní program pro reporting nebo BI. Pokladna počítá přesně jako s PostgreSQL.
• Vestavěná (PGlite): je přímo v pokladně, nic nemusíte instalovat. Nejlepší volba pro většinu podniků a databáze na Androidu a Chromebooku.
• PostgreSQL: samostatný databázový program na pokladním PC nebo jinde v síti.

Kdy MySQL nebo MariaDB? Když váš podnik už má server MySQL nebo MariaDB, když s ním pracuje váš IT správce, nebo když chcete data číst ve vlastním reportingu, v Excelu nebo v programu BI. Pokud váháte, zvolte vestavěnou: funguje hned.

Co potřebujete pro MySQL nebo MariaDB?

• MySQL 8.0 nebo novější, nebo MariaDB 10.6 nebo novější, dostupné z pokladního serveru.
• Vlastní databázi pro pokladnu (nebo pro pokladny řetězce), se znakovou sadou utf8mb4.
• Databázového uživatele, který smí v této databázi vytvářet, měnit, přejmenovávat a mazat tabulky (CREATE, ALTER, DROP, INDEX, SELECT, INSERT, UPDATE, DELETE), například takto:

CREATE DATABASE horecapos CHARACTER SET utf8mb4 COLLATE utf8mb4_bin;
CREATE USER 'horecapos'@'localhost' IDENTIFIED BY 'wachtwoord';
GRANT ALL PRIVILEGES ON horecapos.* TO 'horecapos'@'localhost';

Běží-li MySQL nebo MariaDB na jiném počítači, uveďte v posledních dvou řádcích místo localhost IP adresu pokladního serveru.

Převod na MySQL / MariaDB:

1. V části Adresa MySQL/MariaDB vyplňte pole: Server (výchozí localhost), Port (výchozí 3306), Databáze (výchozí horecapos), Uživatel a Heslo; pro MariaDB stejně. Je-li adresa už nastavená, pole jsou předvyplněná; necháte-li heslo prázdné, zůstane uložené heslo (u stejného uživatele). Pokladna si adresu uloží sama; pokud Optimum POS už nastavil pevnou adresu, platí tato adresa a žádná pole nejsou. Pokud pokladna už běží na MySQL/MariaDB, údaje později upravíte pomocí Změnit údaje MySQL/MariaDB. Šifrované spojení vám nastaví Optimum POS.
2. Klepněte na Otestovat spojení: uvidíte program a verzi, nebo proč to nejde.
3. Klepněte na Převést na MySQL/MariaDB, zaškrtněte, že rozumíte, a zadejte svůj PIN.

Převod funguje v každém směru mezi třemi databázemi a všechna data jdou s ním:

1. Pokladna chvíli nepřijímá požadavky (obvykle méně než minutu); tablety pak samy pokračují.
2. Nejprve pokladna vytvoří zálohu aktuálního stavu (v Nastavení → Zálohy).
3. Vše jde do nové databáze a pokladna po tabulkách spočítá, zda je tam všechno přesně.
4. Teprve když vše sedí, pokračuje pokladna na nové databázi. Přihlášení zaměstnanci zůstanou přihlášeni.

Když se něco nepovede, nic se nezmění a pokladna pracuje dál na staré databázi. Stará databáze zůstane zachována, takže se můžete vždy vrátit. Pokladní data, která už v nové databázi MySQL/MariaDB nebo PostgreSQL byla, se nahradí. Jde to i v Belgii: počítadla černé skříňky se přenesou přesně.

Zálohy a obnovení fungují se všemi třemi databázemi stejně (Nastavení → Zálohy). Zálohu z jedné databáze můžete obnovit v kterékoli jiné, i zálohu z PostgreSQL v MySQL nebo MariaDB.

Co je v MySQL nebo MariaDB? Každá tabulka pokladny, se stejným názvem a sloupci (časy v UTC). Každá tabulka dostane navíc klíčový sloupec _hp_sleutel a v pomocných tabulkách _horecapos_stand, _horecapos_kolom, _horecapos_reeks a _horecapos_wijziging (záznam změn, uchovává se 14 dní) si pokladna vede stav, typy sloupců, počítadla a změny. Ostatní programy data čtou; zapisují jen pokladny.

Jak to funguje: pokladna počítá v rychlé pracovní kopii na pokladním serveru a každou změnu zapíše ve stejném kroku do MySQL/MariaDB. Když se to nepovede, změna se neprovede a pokladna ohlásí chybu; MySQL/MariaDB proto udržujte dostupné. Při spuštění pokladna načte vše z MySQL/MariaDB.

Více pokladen na jedné databázi. Stejně jako u PostgreSQL může více pokladen používat stejnou databázi MySQL/MariaDB, například každý podnik řetězce s vlastním pokladním serverem. Změny probíhají postupně a každá pokladna nejprve převezme, co udělaly ostatní, takže se při současných změnách nic neztratí. Když pokladna obnoví zálohu nebo pokladna s novější verzí aktualizuje databázi, ostatní pokladny si samy vše znovu načtou; aktualizujte proto všechny pokladny současně. Pokladna, která byla vypnutá déle než 14 dní, si při spuštění vše znovu načte.

Při instalaci volíte i databázi: MySQL / MariaDB, vestavěnou (doporučeno) nebo PostgreSQL s adresou. Není-li dostupná, nainstaluje se pokladna s vestavěnou databází; převést ji můžete pak zde. Při aktualizaci volba zůstává.

Připojení tabletů a obrazovek

• Na každém tabletu/pokladně otevřete adresu pokladního serveru, např. http://192.168.1.20:3000, a přidejte ji jako zástupce na domovskou obrazovku (Chrome: Přidat na plochu).
• Kuchyňská obrazovka: http://192.168.1.20:3000/keuken.
• Zákaznický displej (otočený k zákazníkovi, volitelné): http://192.168.1.20:3000/klantscherm, viz Zákaznický displej.
• Obrazovky najdou pokladní server automaticky (stejná adresa, port 4000).

Zákaznický displej

Obrazovka u pokladny otočená k zákazníkovi. Zákazník vidí zhruba, co bylo objednáno, a velmi zřetelně částku a způsob placení. Nemá žádné ovládání: obrazovka jen sleduje, co dělá pokladna. Ve výchozím stavu vypnuto; zapněte přes Nastavení → Podnik → Zákaznický displej. Na pokladním PC se dvěma obrazovkami jej pokladna poprvé zapne sama; pokud jej poté vypnete, zůstane vypnutý. Bez zákaznického displeje (vypnuto, nebo žádný připojen) vše funguje přesně jako vždy: pokladna posílá obraz na pozadí a obsluha nikdy neuvidí chybu ani chybějící obrazovku.

Co zákazník vidí:

• Klid (nikdo neplatí): název podniku a váš vlastní uvítací text (Nastavení → Podnik; prázdné = "Vítejte").
• Objednávání: produkty s počtem a částkou (stejné řádky sloučené, menu jako jeden řádek s položkami drobně pod ním, sleva jako jeden řádek) a součet velkým písmem. Částky již zaplacené při rozděleném placení jsou uvedeny pod tím. S volbou Nastavení → Podnik → Fotky produktů → na zákaznickém displeji se u každého produktu zobrazí malá fotka.
• Placení: způsob platby (Karta, Hotově, Dárkový poukaz), spropitné a velkým písmem K úhradě. Hotově: co zákazník dává a kolik se vrací, jakmile je to zadáno na pokladně. Karta: "Postupujte podle pokynů na platebním terminálu".
• Děkujeme: po zaplacení se na pár sekund zobrazí "Děkujeme!" se zaplacenou částkou (hotově: kolik zákazník dostal zpět), pak zpět na klidovou obrazovku.

Připojení, dvěma způsoby (obojí se nastavuje na samotném zařízení):

• Druhý monitor u pokladního PC (Windows, Linux/Raspberry Pi, macOS): automaticky. Při přihlášení a po instalaci pokladna zobrazí zákaznický displej na celou obrazovku na nejmenší obrazovce, která není hlavní (při stejné velikosti na té nejvíce vpravo); ve Windows vždy na jiné obrazovce než pokladna (pokladna je na dotykové obrazovce a při spuštění se také otevře sama). Velikost a poloha pocházejí ze systému, takže funguje jakýkoli formát. Bez druhé obrazovky se nic nestane. Ve Windows se zavřený zákaznický displej vrátí sám; v Linuxu a macOS jej zástupce HorecaPOS zákaznický displej v nabídce opět umístí správně. Ve Windows se otevře v režimu kiosku prohlížeče Chrome (nebo Edge): na celou obrazovku, bez záhlaví a bez hlavního panelu (zavření pomocí Alt+F4). Sleduje pokladnu na stejném PC bez párovacího kódu.
  • V každém prohlížeči dlouhé podržení nikde nezobrazí nabídku prohlížeče a neobjeví se ani dotaz na překlad stránky.
  • Pokladna zavřená = zákaznický displej zavřený. Pokud se software pokladny zastaví (Restartovat, aktualizace, pokladna zastavena nebo odebrána), zákaznický displej se po něco málo přes 10 sekund také zavře; jakmile pokladna znovu běží, vrátí se sám. Ve Windows se zavře i tehdy, když zavřete jen okno pokladny. Pod Waylandem (Linux) pokladna nemůže okno zavřít sama.
  • Zákaznický displej omylem zavřený? Ve Windows se po několika sekundách sám vrátí, pokud je pokladna otevřená a druhá obrazovka připojená.
  • Vždy jen jeden zákaznický displej. Ve Windows je zákaznický displej pouze v režimu kiosku na druhé obrazovce. Zákaznický displej v okně pokladny (např. obnovený prohlížečem Edge po výpadku proudu nebo otevřený tlačítkem v pokladně) se během několika sekund sám zavře; jeho místo pak zaujme správný zákaznický displej.
  • Nikdo nepřihlášen = jen uvítání. Je-li pokladna na obrazovce PIN kódu (i po restartu nebo odhlášení), zákaznický displej zobrazuje jen uvítací text, nikdy předchozí účet.
  • Ve Windows lze automatické otevírání vypnout také zaškrtávacím políčkem Otevírat zákaznický displej automaticky ... v instalátoru.
  • V Linuxu pokladna přesouvá okno pomocí wmctrl (je součástí balíčku). Pod Waylandem (mj. Raspberry Pi OS s labwc) to nejde: přesuňte pak zákaznický displej jednou sami na druhou obrazovku (prohlížeč si to zapamatuje), nebo zvolte X11 v raspi-config. V macOS Mac poprvé požádá o povolení v Zpřístupnění.
  • Ručně: Nastavení → Provozovna → Zákaznický displej → Otevřít zákaznický displej (druhý monitor). V Chrome a Edge (i na Chromebooku) tlačítko okno hned umístí na zákaznický displej (poprvé prohlížeč požádá o povolení); jedno kliknutí na zákaznický displej jej přepne na celou obrazovku. V jiných prohlížečích: přetáhněte a stiskněte F11.
• Android pokladna s vestavěným zákaznickým displejem (např. Sunmi D2/T2) nebo monitor přes HDMI/USB-C: rovněž automaticky. Jakmile je aplikace na pokladně, zobrazí se zákaznický displej na druhé obrazovce; připojení a odpojení funguje okamžitě.
• Sunmi T1 mini / T2 mini s malým textovým displejem (2 řádky): aplikace tam automaticky zobrazí částku: Celkem, K úhradě, při platbě hotově Vrátit, po zaplacení Děkujeme! a v klidu název provozovny. Zákaznický displej musí být zapnutý.
• iPad (obslužná obrazovka) s externí obrazovkou přes HDMI/USB-C nebo AirPlay: aplikace automaticky umístí zákaznický displej na tuto obrazovku (připraveno; aplikace pro iOS zatím nebyla vydána).
• Chromebook: jako obslužná obrazovka v Chrome funguje tlačítko Otevřít zákaznický displej (druhý monitor) jako výše. V aplikaci pro Android se zákaznický displej automaticky zobrazí na druhé obrazovce, jakmile ChromeOS tuto obrazovku zpřístupní aplikacím Android; pokud ne, použijte samostatné zařízení s párovacím kódem.
• Samostatné zařízení (tablet nebo vlastní PC vedle pokladny): otevřete http://<kassaserver>:3000/klantscherm. Obrazovka ukazuje vpravo dole párovací kód o 6 znacích. Zadejte jej na pokladně v Nastavení → Podnik → Zákaznický displej → Spárovat. Zrušit spárování vrátí obrazovku zpět na párovací kód. Spárování se ukládá pro každou pokladnu (v prohlížeči té pokladny), takže každá pokladna může mít svůj zákaznický displej.

Zákaznický displej nežádá PIN (není co ovládat) a ukazuje jen obraz pokladny, se kterou je spárován. Obraz se uchovává jen v paměti pokladního serveru; po restartu je obrazovka prázdná až do další změny. Nastavení (zapnuto/vypnuto a uvítací text) je součástí zálohy a Importu/exportu (Ostatní nastavení).

Digitální účtenka přes QR (volitelné)

Ve výchozím stavu vypnuto. Zapněte přes Nastavení → Provozovna → Kuchyně a zákaznický displej → Digitální účtenka (volba se objeví, když je zákaznický displej uložen jako zapnutý). Po zaplacení se u Děkujeme zobrazí QR kód; ten pak zůstane 45 sekund místo několika sekund. Host jej naskenuje vlastním telefonem a uvidí účtenku přesně jako papírovou (stejný text, u belgické pokladny i s blokem FDM). V telefonu může účtenku vytisknout, uložit jako PDF nebo stáhnout jako textový soubor.

• Funguje to přes správní portál: https://kassa.<portaal>/__bon/<kassa>/<sleutel>. Pokladna proto musí být s portálem propojená; jinak se QR kód neobjeví a nic se nezmění.
• Klíč je náhodný a nelze jej uhodnout a platí 30 dní. Poté jej pokladna sama odstraní. Portál nic neukládá.
• Funguje s druhým monitorem i se samostatným zákaznickým displejem. Papírová účtenka a účtenka e-mailem fungují dál jako obvykle.

Zákaznický displej v klidu: prezentace (volitelné)

Ve výchozím stavu vypnuto. Zapněte přes Nastavení → Provozovna → Kuchyně a zákaznický displej → Zákaznický displej v klidu. Když na zákaznickém displeji není žádný účet, střídají se snímky (ve výchozím stavu každých 8 sekund, nastavitelné od 4 do 60):

• Akce: happy hours (pokud je happy hour zapnutá), se slevou, dny a časy a produkty nebo skupinami; ty, které právě probíhají, jsou první, s "Teď!".
• Doporučené produkty (nejvýše 12, například novinky na lístku), s cenou a (pokud jsou fotografie produktů na zákaznickém displeji zapnuté) fotografií. Vyprodaný produkt displej přeskočí.
• Věrnostní karta: body za euro, odměna a razítkové karty (jen pokud je zákaznická karta zapnutá).
• Vlastní texty: nejvýše 5, každý na vlastním snímku (například "Od pátku novinka: náš letní lístek").

Bez snímků ukazuje zákaznický displej jako vždy uvítací obrazovku.

Happy hour

Ve výchozím stavu vypnuto. Zapněte přes Nastavení → Podnik → Používat happy hour; pak se objeví karta Nastavení → Happy hour.

• Pro každou happy hour: název (zobrazí se na účtence), dny, od–do (může přesahovat přes půlnoc, např. 23:00–01:00), sleva v % nebo pevná cena, a pro které skupiny produktů a/nebo jednotlivé produkty.
• V tomto časovém úseku pokladna při zadávání automaticky účtuje cenu happy hour (nikdy dráž než běžně; u pevné ceny se možnosti přičítají jako obvykle). Tlačítko produktu ukazuje starou cenu přeškrtnutou s novou cenou a HH; objednávka a účtenka ukazují název happy hour. Již zadané položky si cenu ponechají.
• Denní akce: zaškrtněte Celý den (00:00–24:00) a zvolte den (dny), např. každé úterý žebírka za pevnou cenu.
• Sezóna: zaškrtněte Jen v sezóně (každý rok) a zvolte od a do (den a měsíc, např. 1. června až 31. srpna; přes přelom roku také lze, např. 1. prosince až 28. února). Mimo sezónu happy hour neplatí.
• Změny se zaznamenávají v protokolu.

Části dne a sezóny

Ve výchozím stavu vypnuto. Zapněte přes Nastavení → Provozovna → Části dne a způsob výdeje → Sortiment podle části dne a sezóny; pak se objeví karta Nastavení → Části dne. Když to vypnete, jsou všechny produkty opět vždy k prodeji a části dne zůstanou uložené.

• U každé části dne: název (např. Snídaně, Oběd, Večeře, Letní menu), dny, od–do (může přes půlnoc; Celý den = 00:00–24:00), případně sezóna (každý rok, den a měsíc) a které skupiny produktů a/nebo jednotlivé produkty k ní patří.
• Produkty a skupiny produktů, které jsou v jedné nebo více částech dne, jsou k prodeji jen tehdy, když některá z těchto částí dne probíhá; co není v žádné části dne, je k prodeji vždy. Objednávací obrazovka ukazuje jen to, co je právě k prodeji, a sama se přepne, když část dne začne nebo skončí; server ostatní odmítne ("teď není k prodeji, jen v části Snídaně").
• E-shop zobrazuje a účtuje stejný sortiment (v okamžiku objednávky).
• Jiná cena v určitý den nebo v sezóně je happy hour (denní akce, viz výše).
• Menu podle provozovny: každá pokladna (pobočka) má vlastní produkty, části dne a ceny.
• Změny se zaznamenávají v protokolu.

Sortiment a ceny podle způsobu výdeje

Ve výchozím stavu vypnuto. Zapněte přes Nastavení → Provozovna → Části dne a způsob výdeje → Sortiment a ceny podle způsobu výdeje. Když to vypnete, platí opět všude běžná cena a vše je všude k prodeji; zadané ceny zůstanou uložené.

• V Nastavení → Produkty u každého produktu: Cena s sebou a Cena při rozvozu (prázdné = běžná cena) a Prodáváno pro (na místě, s sebou, rozvoz; alespoň jedno). U skupiny produktů také Prodáváno pro, pro všechny produkty v této skupině.
• Objednávací obrazovka u objednávky s sebou nebo s rozvozem ukazuje cenu tohoto způsobu výdeje a jen to, co se v něm prodává; server účtuje tuto cenu a ostatní odmítne. Happy hour, menu a možnosti počítají s touto cenou.
• Sazba DPH pro s sebou (u produktu) je na tom nezávislá, jako vždy.
• E-shop u s sebou a rozvozu zobrazuje ceny a produkty této volby (při přepnutí se stránka menu znovu načte) a u stolu ty pro na místě.
• Export a import konfigurace (Nastavení → Import/export) zahrnují ceny podle způsobu výdeje, "prodáváno pro", části dne a sezónu happy hours.

Menu

Ve výchozím stavu vypnuto. Zapněte přes Nastavení → Podnik → Používat menu.

• Menu je běžný produkt (s cenou menu), u kterého nastavíte části v Nastavení → Produkty → (produkt) → Menu:
  • pevná: vždy tento produkt (např. "Nápoj: Domácí víno");
  • volba: vyberte 1 (nebo více) ze skupiny produktů, případně omezeno na určité produkty (např. "Hlavní jídlo: vyberte 1 z Hlavních jídel").
  • U každé části chod (1 = hned, 2/3 = čekat na vyvolání).
• Při zadání menu zvolíte pokrmy pro každou část. U každého pokrmu (i pevného) můžete zvolit možnosti jako u samostatného produktu (propečení, extra sýr; povinné možnosti je nutné zvolit) a poznámku. Příplatky za možnosti se přičtou k ceně menu. Menu se objeví jako jeden řádek s pokrmy (a jejich možnostmi) pod ním.
• Pokrmy jdou do kuchyně/na bar jako samostatné řádky (kuchyňský lístek a kuchyňská obrazovka), ve svém vlastním chodu. Samotný řádek menu ne.
• Pro DPH se cena menu rozdělí mezi části poměrně k jejich běžné ceně, takže jídlo i nápoje dostanou správnou sazbu. Účtenka ukazuje menu s celkovou cenou a pokrmy pod ním.
• Pokud má samotné menu možnosti (např. velikost), zvolíte je nahoře v okně menu. Zobrazí se u řádku menu na účtence a u každého pokrmu menu na kuchyňském lístku a kuchyňské obrazovce jako "(menu)".
• Odebrání/storno se provádí po celém menu (klepněte na řádek menu).
• Rozdělit / přesunout: zvolte řádek menu; pokrmy se přesunou s ním. Při 2× stejném menu můžete přesunout i 1 (záhlaví a pokrmy se rozdělí).
• Bez připojení můžete menu stále zadávat; uloží se v tabletu a odešlou, jakmile je spojení zpět (stejně jako samostatné produkty).
• Happy hour může platit i pro menu.

Receptury a nákladová cena (Apicbase)

Propojení s Apicbase (receptury, nákladová cena, zásoby a nákup) přes Generic POS API od Apicbase (ve výchozím stavu vypnuto, každou část lze zapnout nebo vypnout zvlášť). Nastavení v Nastavení → Receptury (oprávnění Nastavit provozovnu, platby a tiskárny). Pokladna komunikuje s Apicbase sama (jen odchozí provoz, portál není potřeba).

1. Připojit (vše vyplňuje správce), jedním ze tří způsobů:
   • Vložit token: v Apicbase Library Settings → API Settings → New token → Service Account Token (scopes accounts, library, sales); vložit access token a refresh token;
   • Přihlásit se vlastní API-app provozovny (client-id a client secret z API Settings): Přihlásit se do Apicbase a vložit kód, který Apicbase potom zobrazí;
   • Token, který vypršel (po 7 dnech), pokladna automaticky obnoví pomocí refresh tokenu.
2. Outlet: Načíst outlety a vybrat outlet této provozovny. Pokladna tam nastaví POS na Generic POS API s vlastním location-id (lze upravit; výchozí HORECAPOS-…, jedinečné pro každou pokladnu).
3. Zapnuto, se zaškrtávacími políčky:
   • Produkty, skupiny a možnosti do Apicbase: skupiny produktů, produkty (PLU = číslo PLU produktu, jinak kód, jinak id), možnosti jako modifiers, s cenou a DPH. Automaticky po každé změně (po minutě) a každý den. V Apicbase pak propojíte každý produkt z pokladny s receptem;
   • Každou zaplacenou účtenku do Apicbase: nejstarší jako první, nejvýše 100 najednou, do čtvrt hodiny po zaplacení (a každých 5 minut). Sleva se rozpočítá na řádky; volné částky, příplatek za jednorázové obaly a záloha jsou v Apicbase jako samostatný produkt; vážené produkty jako 1 ks s celkovou částkou. Pokud se to nepodaří, pokladna se zastaví (Apicbase chce účtenky popořadě) a zkusí to později znovu: placení to nijak neovlivní. Při zapnutí zvolíte, od kterého dne (výchozí od teď);
   • Stahovat nákladovou cenu za porci (každých 6 hodin): pro každý propojený recept food cost (suroviny a odpad), s náklady na personál, prodejní cena a marže podle Apicbase. Počítáno podle nejlevnějšího dodavatele, poslední objednané ceny nebo průměrné hodnoty zásob;
   • Převzít prodejní cenu z Apicbase (ve výchozím stavu vypnuto): nastavit prodejní cenu propojených produktů v pokladně (zapíše se do protokolu).
4. Dole: Nákladová cena za produkt s nákladovou cenou, nákladovou cenou s personálem, cenou v pokladně, nákladovou cenou % a marží. Tlačítka Odeslat katalog nyní, Odeslat účtenky nyní a Stáhnout nákladové ceny nyní.

Kód: apps/pos-server/src/lib/apicbase.ts, routes/apicbase.ts; obrazovka Apicbase.tsx. Protokol: Apicbase. Podmínka: API modul Apicbase. Pro aplikaci Pin Voordeel pro všechny zákazníky: partnerství a certifikace u Apicbase (viz backlog). Dokumentace: https://developers.apicbase.com/docs/generic-pos-api-guide

Hotelový software: na pokoj

Pro restauraci nebo bar u hotelu: účet na pokoj hosta. Ve výchozím stavu vypnuto: Nastavení → Hotel (oprávnění Nastavit podnik, platby a tiskárny).

• Jeden seznam se vším hotelovým softwarem (Hotelový software hotelu). Vestavěná propojení:
  • Mews (Connector API: client token a access token, služba restaurace a pro každou sazbu DPH kód DPH z Mews), apaleo (vlastní aplikace s client ID a client secret, ID ubytování; pro každou sazbu DPH případně druh DPH) a Cloudbeds (klíč API a ID ubytování), každý s testovacím a ostrým prostředím;
  • Oracle OPERA Cloud (OHIP), protel (protel I/O), RoomRaccoon, Booking Experts, Amadeus (XMLPOS), VIPS, Stayntouch, Clock PMS+, Guestline (Rezlynx), Hotelogix, eviivo, Little Hotelier, Shiji a Infor HMS (Databridge). Po výběru se zobrazí přesně ta pole, která k danému hotelovému softwaru patří (klíče, ID hotelu, případně adresa jejich API a pro každou sazbu DPH jejich kód), s krátkým vysvětlením, co si u dodavatele vyžádat. Tato propojení jsou postavena podle dokumentace dodavatelů; nechte si propojení potvrdit dodavatelem a nejprve to zkuste přes Otestovat spojení a jednu účtenku;
  • demo (čtyři apartmány, pokoje 4 až 7) na vyzkoušení;
  • Sirvoy, jako poloviční propojení a jen se Sirvoy Pro. Sirvoy nemá API, přes které by pokladna mohla něco zapsat k rezervaci, ani pomocí souboru (import CSV vytváří jen nové rezervace). Pokladna tak zná hosty (pokoj, jméno, příjezd, odjezd): vyhledávání u Na pokoj a samoobsluha na kiosku a v e-shopu fungují normálně. Účtenka se do Sirvoy sama nedostane: po zaplacení je v Nastavení → Hotel pod Ještě zadat do Sirvoy, s pokojem, hostem, číslem účtenky a částkou podle sazeb DPH. Hotel ji ručně zadá jako extra k rezervaci a klikne na Je zadáno (zpět pomocí Ještě ne). Potřeba:
    1. nejlépe pokladna připojená ke správcovskému portálu: adresa pak vede přes portál (https://<portaal>/hotel/<kassa-id>/sirvoy?sleutel=...) a v hotelu není třeba otevírat port. Jinak musí být samotná pokladna dostupná z internetu přes https (vlastní doména s certifikátem nebo přesměrování portů; Sirvoy vyžaduje TLS 1.2 nebo vyšší) a tuto adresu zadáte;
    2. Adresa se zobrazí jen jednou; pokladna ukládá pouze hash. Vytvoření nové adresy = stará přestane fungovat;

Sirvoy posílá něco jen při změně rezervace: rezervace z doby před propojením pokladna zná až po změně v Sirvoy. Zprávy mohou přicházet v jiném pořadí; zpráva starší (generatedAt) než to, co už pokladna má, se přeskočí. V hotelu = nezrušeno a neodhlášeno, přihlášeno nebo příjezd dnes či dříve a odjezd dnes či později. Otestovat spojení ukáže, kolik rezervací přišlo.

Veškerý hotelový software je k dostání v Nizozemsku a/nebo Belgii. Otestovat spojení zkontroluje údaje. Kód pro každé propojení: apps/pos-server/src/lib/pms/<naam>.ts.

• Samoobsluha (ve výchozím stavu vypnutá): hotelový host si objednávku sám zapíše na svůj pokoj, na kiosku a/nebo v e-shopu (vyzvednutí a doručení, ne při objednávce u stolu). Zadá číslo pokoje a příjmení; pokladna u hotelového softwaru ověří, zda tento host právě bydlí v tomto pokoji. S maximem na objednávku (výchozí € 150) a po 5 neúspěšných pokusech během čtvrt hodiny musí host nejdřív na recepci. Hláška nikdy neprozradí, kdo v pokoji bydlí.
• Placení: je-li propojení zapnuté, je k dispozici způsob platby Na pokoj. Vyhledejte hosta podle jména nebo čísla pokoje (jen hosté, kteří jsou právě ubytováni v hotelu) a klepněte na Na pokoj .... Pokladna zaúčtuje účtenku podle sazeb DPH na hotelový účet hosta; host zaplatí při odhlášení.
• Belgie: je-li objednávka už u stolu zaznamenána v černé skříňce, přejde nejprve ze stolu na pokoj (signCostCenterChange na ROOM, UC4101); účtenka jde do černé skříňky jako pokojový kredit (ROOM_CREDIT).
• Nepodaří-li se zaúčtování v hotelovém softwaru (bez internetu), prodej přesto existuje a zaúčtování je uvedeno jako Nezdařilo se v Nastavení → Hotel, s tlačítkem Zkusit znovu.
• Přehledy a účetnictví: Na pokoj (hotel) je samostatný způsob platby na X- a Z-zprávě, v denním výkazu a v auditním souboru (XAA).

Kód: apps/pos-server/src/lib/hotel.ts, routes/hotel.ts, propojení v lib/pms/, katalog packages/shared/src/hotelcatalogus.ts; obrazovka Hotel.tsx. Protokol: Hotel. Tajné údaje (tokeny) jsou jen v databázi, nikdy na obrazovce.

Správa vín s Vinify

Nastavení → Správa vín (ve výchozím stavu vypnuto; vypnutím se nic neztratí). Vinify vede vinný sklep, vinný lístek a zásoby a je hlavním zdrojem vín. Podle požadavků Vinify na POS nabízí pokladna API, pomocí kterého Vinify může:

Přihlašovat se, všemi třemi způsoby, které Vinify zná (správce zapne které):

1. API ID a API klíč (X-Api-Id a X-Api-Key, nebo Authorization: Bearer <id>:<sleutel>);
2. API klíč a API secret s podpisem: X-Api-Key, X-Timestamp a X-Signature = hex HMAC-SHA256(secret, <timestamp>\n<METHODE>\n<pad met query>\n<sha256 van de body>), staré nejvýše 5 min.

Klíč a secret vytváří pokladna (zobrazí se jednou); obrazovky ukazují jen, zda jsou vyplněné. Dostupné přes portál na https://<portaal>/vinify/<kassa-id>/... (žádný otevřený port v provozovně; adresa je v Nastavení → Správa vín). Které produkty jsou víno: co vytvoří Vinify, plus skupiny, které zaškrtnete. Pokud Vinify zadá adresu pro odesílání prodejů, pokladna je posílá i sama (push, s tokenem): po každé zaplacené účtence a každých 5 minut to, co se ještě nepodařilo. Vinify zapne propojení s HorecaPOS (hello@vinify.no). Vše v protokolu. Nezaměňovat s Vinify.nl, online vinotékou: ta je mezi dodavateli (Objednávání u dodavatelů).

Rychlé zadání adresy pomocí PSČ a čísla domu

Zapíná se v Nastavení → Provozovna → Rychlé zadání adresy (ve výchozím stavu vypnuto; jen pro provozovnu v Nizozemsku). Zadejte PSČ a číslo domu (i s písmenem nebo dodatkem, např. 12A nebo 12-1) a klepněte na Vyhledat adresu: ulice, číslo domu, PSČ a město se doplní. Pokud je na tom čísle víc adres (12, 12A, 12B), vyberete správnou. Potom můžete vše ještě sami upravit.

• U údajů provozovny (Nastavení → Provozovna, nad adresou).
• U zákazníka se zákaznickou kartou: na pokladně u nového zákazníka a v Přehled → Zákazníci. Zákazníci k tomu dostanou (volitelnou) adresu: ulice a číslo domu, PSČ a město.
• Adresy pocházejí z bezplatného Locatieserver od PDOK (oficiální adresy v Nizozemsku, BAG): není potřeba účet ani klíč, jen internet. Bez internetu nebo u belgické adresy ji jednoduše zadáte sami.

Upozornění na novou verzi

Zapněte v Nastavení → Podnik → Upozornění na novou verzi (ve výchozím stavu vypnuto).

• Pokladna aktualizována: pokud byl pokladní server aktualizován, zatímco tablet má ještě otevřené staré obrazovky, nahoře se zobrazí "Pokladna byla aktualizována (verze …)" s Obnovit. Tablet to kontroluje každých 5 minut, když se obrazovka znovu zobrazí, a po restartu serveru.
• K dispozici je aktualizace: pokud je pokladna propojena se správním portálem (PORTAAL_URL/PORTAAL_SLEUTEL) a je tam vyplněno NIEUWSTE_VERSIE, uživatelé, kteří smí spravovat nastavení, uvidí "K dispozici je aktualizace: verze …" (s vysvětlením z UPDATE_NOTITIE). Později skryje upozornění na tomto tabletu, dokud nebude zase novější verze. Aktualizace probíhá jako vždy pomocí scripts\\windows\\update.cmd (viz Aktualizace).

Rezervační platformy

Rezervace z TheFork, Formitable, Zenchef, Resengo (jen Belgie), OpenTable (jen Nizozemsko), PlanPanther, RestoManager a Aqqo (jen Nizozemsko) se automaticky zobrazí v pokladně a na plánku. Zapíná se v Nastavení → Rezervační platformy (ve výchozím stavu vypnuto). Jen pokud jsou zapnuté Rezervace.

• Země provozovny: můžete vybrat jen platformy, které fungují v zemi provozovny (Resengo jen v Belgii, OpenTable a Aqqo jen v Nizozemsku). Server to také kontroluje.
• Více platforem najednou: můžete propojit více platforem vedle sebe, například TheFork a Formitable. Dvě platformy nikdy nedostanou stejný stůl ve stejném časovém úseku; druhá rezervace pak přijde bez stolu.
• + Propojit platformu: vyberte platformu a vyplňte údaje. Tajné údaje (client secret, klíč zpětného hlášení) se v přehledu nikdy nezobrazují; nechat prázdné = ponechat, Vymazat = odstranit.
• TheFork (veřejné B2B API): Restaurant UUID, Client ID a Client Secret (získáte u TheFork). Když pokladna zruší rezervaci, zruší ji i v TheFork.
• Formitable, Zenchef, Resengo, OpenTable, PlanPanther, RestoManager, Aqqo: jejich API je jen pro partnery nebo není veřejné (PlanPanther, RestoManager a Aqqo: propojení s pokladnou se domlouvá s nimi). Události Formitable (booking.created, .changed, .canceled, .checkin, .checkout) jsou rozpoznány.
• Na plánku: pokud se stůl v pokladně jmenuje stejně jako stůl na platformě a je v daném časovém úseku volný, rezervace se přiřadí k tomuto stolu; jinak bez stolu (vyberte ho při příchodu). Rezervace, která přijde znovu, se aktualizuje, nezdvojí. V přehledu je uvedeno "přes TheFork".
• Stav: když platforma zruší rezervaci nebo nahlásí no-show, pokladna to převezme. Co je v pokladně již označeno jako příchod, zůstane příchodem.
• Zpětné hlášení (no-show zpět): zadejte adresu zpětného hlášení (například vaší integrační služby). Pokladna posílá každou změnu z pokladny (příchod, no-show, zrušeno, zaplaceno s částkou) jako JSON: { platform, id, status, statusEn, bedrag, valuta, tafel, tijdstip, gemeldOp } (částka v centech, jen při zaplacení), s Authorization: Bearer <terugmeld-sleutel>, pokud ho vyplníte. Pokud se to nepodaří, pokladna to zkouší každou minutu znovu a chyba je uvedena u platformy. Co přišlo ze samotné platformy, se zpět neposílá.
• Testovací rezervace: vytvoří rezervaci tak, jak by ji poslala platforma.
• Odebrat: propojení a klíč jsou pryč; rezervace zůstanou.
• Všechny změny jsou v protokolu (bez tajných údajů).

Věrnostní programy a recenze

Dva samostatné přepínače v Nastavení → Body a recenze (oba ve výchozím stavu vypnuté, pak z toho nikde nic není vidět). Když je vypnete, nastavení i vše, co už proběhlo, zůstane uloženo.

Věrnostní program jiné platformy: host sbírá body u Joyn (Belgie) a/nebo Piggy (Leat; Nizozemsko a Belgie). Je to nezávislé na vlastní zákaznické kartě pokladny; ta může klidně běžet souběžně.

• Více najednou: v Belgii mohou být Piggy a Joyn zapnuté současně, každý s vlastními údaji (vyberte platformu, vyplňte, Uložit; Upravit a Smazat pro každou platformu). Host dostane pro každý program vlastní QR kód na účtence, vlastní odkaz v e-mailové účtence a vlastní tlačítko v e-shopu a v každém programu sbírá jednou za objednávku. Co už bylo nastaveno, funguje dál.
• QR kód na účtence: po zaplacení je pod účtenkou QR kód s textem "Naskenujte a sbírejte body u ...". V účtence e-mailem je odkaz a v e-shopu (vyzvednutí a rozvoz) tlačítko na stránce objednávky a odkaz v potvrzovacím e-mailu. Jedna objednávka přinese body jen jednou: účtenka, e-mail i e-shop používají stejný jedinečný kód (číslo objednávky). "QR kód na tištěné účtence" můžete vypnout; e-mail a e-shop odkaz dostanou i tak.
• Piggy, způsob "QR kód a odkaz": zadejte adresu svého zákaznického portálu Piggy, Shop UUID a Account secret (Piggy Business Dashboard). Funguje bez internetu: pokladna vytvoří odkaz sama.
• Piggy, způsob "Připsat ihned": zadejte navíc personal access token (Piggy → Marketplace → Private App). Pokud pokladna posílá účtenku e-mailem a host s touto e-mailovou adresou už je členem, pokladna body připíše ihned; na účtence pak stojí "Body připsány u Piggy". Pokladna nikdy nevytváří nového člena; žádný člen (nebo žádná e-mailová adresa) = QR kód.
• Joyn, způsob "QR kód a odkaz": s partner key, shop reference a shared secret od Joyn (vyžádáte přes api-integration@joyn.be). Funguje bez internetu. QR kód platí 2 hodin.
• Joyn, způsob "Přes API": se shop API key (zapněte propojení v obchodním portálu Joyn). Pokladna si při placení vyžádá od Joyn kód pro body. Uplatnění bodů probíhá jako vždy na Joyn-iPad.
• Vytvořit ukázkový odkaz: ověří, zda jsou údaje správné (odkaz na 10 €; otevřete ho jen pro náhled).
• Vybrat lze jen platformy země provozovny; tajné údaje jsou uloženy jen v databázi a nikdy se nezobrazí na obrazovce (nechat prázdné = ponechat).

Žádat o recenze: po návštěvě jeden e-mail s tlačítkem na Google a/nebo Trustpilot.

• O několik hodin později (nastavitelné, výchozí 3) dostane host e-mail v jazyce účtenky.
• E-shop: při vyzvednutí a rozvozu posílá e-mail sám e-shop, několik hodin po dokončení objednávky v pokladně, v jazyce hosta.
• Google: vložte odkaz na recenze z vašeho Firemního profilu (Google → váš Firemní profil → Požádat o recenze, https://g.page/r/.../review) nebo zadejte Place ID.
• Trustpilot: zadejte doménu vaší provozovny (tlačítko vede na trustpilot.com/evaluate/<domein>). Pokud máte u Trustpilot adresu pro pozvánky (Automatic Feedback Service, ...@invite.trustpilot.com), zadejte ji také: e-mail pak jde ve skryté kopii (BCC) do Trustpilot, s neviditelným jménem, e-mailovou adresou a číslem účtenky, a Trustpilot pošle pozvánku sám (pak bez vlastního tlačítka Trustpilot). Jen Trustpilot s adresou pro pozvánky: pokladna posílá e-mail jen pro Trustpilot.
• Ne příliš často: stejný host (e-mailová adresa) dostane nejvýše jednu žádost za období (výchozí 90 dní; 0 = pokaždé). Pokladna k tomu ukládá jen hash adresy; samotná e-mailová adresa se smaže, jakmile je e-mail odeslán (pokud se to nepovede, po třech pokusech, a jinak po 14 dnech).
• QR kód na účtence (volitelné): také QR kód pro recenzi pod tištěnou účtenkou.
• Ukázka e-mailu a Smazat čekající e-maily (adresy se pak smažou ihned). Protokol zobrazuje review_gevraagd s a***@domena.cz.
• Google a Trustpilot zakazují odměňovat za recenzi a žádat jen spokojené hosty ("review gating"). Pokladna proto žádá všechny stejně a za recenzi nic nedává.
• Čtení recenzí a odpovídání na ně v pokladně: viz Správa recenzí níže.

Propojení s Mailchimp a Klaviyo

Vaši zákazníci se zákaznickou kartou ve vašem vlastním e-mailovém programu: v Nastavení → Provozovna → Mailchimp a Klaviyo (pod SMS a e-mailovým marketingem). Není tu žádný přepínač: bez propojení se zvoleným seznamem se nic neděje.

• Připojit: pomocí klíče API (Mailchimp: Profiel → Extra → API keys; Klaviyo: soukromý klíč pk_… s právy zápisu pro Lists, Profiles, Subscriptions, Events, Campaigns a Templates). Tajný klíč klienta a klíč se už nikdy nezobrazí (nechat prázdné = ponechat). Poté zvolíte seznam (Mailchimp: audience).
• Zákazníci: kdo dal souhlas s e-maily, jde do seznamu (přihlášen), se jménem, příjmením, telefonem, narozeninami a body (Mailchimp: pole PUNTEN, které pokladna vytvoří sama; Klaviyo: vlastnost punten). Souhlas odvolán, e-mailová adresa změněna nebo zákazník smazán: odhlášen. Znovu se posílá jen to, co se změnilo. S propojením pokladna (i políčko "nabídky" v e-shopu) žádá nové zákazníky také o souhlas s e-maily a ten lze změnit v Přehled → Zákazníci, i bez vlastního e-mailového marketingu.
• Odhlášení: kdo se odhlásí v Mailchimp nebo Klaviyo, nemá už ani v pokladně souhlas s e-maily (protokol: "odhlášen v Mailchimp"). Kdo se odhlásil sám, toho pokladna znovu nepřihlásí.
• Objednávky: každá zaplacená účtenka zákazníka ze seznamu se posílá jako událost (Mailchimp: bestelling, s částkou, číslem účtenky a počtem; Klaviyo: Placed Order, s hodnotou v eurech). Díky tomu v e-mailovém programu vytvoříte automatické e-maily, např. po první objednávce nebo když někdo měsíc nepřišel. Účtenky z doby před volbou seznamu se neposílají.
• Akce: v Přehled → Marketing odešlete akci i přes Mailchimp nebo Klaviyo (viz SMS a e-mailový marketing); pokladna tam pak vytvoří kampaň a odešle ji.
• Aktualizace: každých 5 minut, nebo tlačítkem Aktualizovat nyní. Odpojení: z pokladny pryč; v Mailchimp a Klaviyo vše zůstává. Klíče jsou uložené v databázi (v záloze ano, v exportu konfigurace ne).

Kód: lib/mailinglijst.ts, routes/mailinglijst.ts a MailingKoppelingen.tsx.

BI a export dat

Prodejní data do Power BI, Looker Studio, Excelu, Google Sheets, Tableau, Qlik Sense, Metabase, BI služby (například YourBI, BI4Horeca nebo Moore DRV) nebo vlastního datového skladu. Zapíná se v Nastavení → BI a export dat (ve výchozím stavu vypnuto). Pouze čtení: přes propojení nelze v pokladně nic změnit. Žádné údaje o hostech.

• Data: účtenky (i dobropisy), prodané produkty (řádky účtenek), platby, tržby za den, tržby za hodinu, storna, produkty, zaměstnanci (bez PIN) a odpracované hodiny. Částky v eurech s tečkou jako desetinným oddělovačem, časy v místním čase provozovny.
• + Propojení: zvolte program a způsob. Každý program podporuje jeden nebo více způsobů; můžete mít více propojení současně (i pro stejný program).
• Program si data načítá sám (API): pokladna jednorázově vydá klíč pouze pro čtení. Období pomocí ?van=&tot= (RRRR-MM-DD) nebo pevná adresa s ?periode= (dnes, včera, 7d, 30d, 90d, 365d, týden, měsíc, minulý měsíc, rok); nejvýše 366 dní, nejvýše 200 000 řádků. Klíč v Authorization: Bearer, X-Sleutel nebo ?sleutel=.
• Přes portál: je-li pokladna propojena se zákaznickým portálem, funguje stejná adresa i mimo provozovnu, bez otevírání portu: https://<portaal>/bi/<kassa-id>/<gegevens>?periode=90d&formaat=csv&sleutel=.... Služba Power BI ji tak obnovuje podle plánu (bez brány) a Google Sheets ji může načítat pomocí =IMPORTDATA("...") (také zdroj pro Looker Studio). Pokladna zobrazuje adresu u propojení.
• Přehled řetězce přes zákaznický portál (více provozoven): jedna adresa a jeden klíč pro všechny vaše pokladny dohromady. V každé pokladně, která se má zapojit, zapněte Přehled řetězce přes zákaznický portál (pod přepínačem BI) a v zákaznickém portálu v části Moje pokladny → BI pro všechny vaše provozovny vytvořte klíč. Pak: https://<portaal>/bi/keten/<gegevens>?periode=90d&formaat=csv&sleutel=hpk_.... Portál stáhne data z každé pokladny a spojí je, s kassaId a zaak u každého řádku. Pokladny, které jsou offline nebo se nezapojují, jsou uvedeny v ontbrekend (JSON) a v hlavičce X-Ontbrekend. Samotná pokladna k tomu nepotřebuje vlastní klíč; vypnutím v pokladně nebo v zákaznickém portálu se to zastaví.
• S tokenem se odesílá jako Authorization: Bearer a v X-HorecaPOS-Handtekening je podpis (sha256= HMAC obsahu). Pokud to nevyjde, pokladna to zkouší znovu každou minutu; nic se neodešle dvakrát. S od odešle i starší účtenky.
• Pokladna dodává soubory: každý den (v daný čas, předchozí den; zmeškané dny se doženou) nebo každou hodinu (dnes až dosud), jako CSV (čárka, nebo středník pro nizozemský Excel) nebo JSON, do složky na pokladním PC (například složky OneDrive nebo SharePoint pro Power BI nebo Excel), na server FTP(S) nebo SFTP nebo e-mailem. Názvy souborů: horecapos_<gegevens>_<datum>.csv.
• Odeslat test (push) a Exportovat nyní (soubor) u propojení.
• Stáhnout sami: zvolte data, období a formát.
• Šablona Power BI (.pbit): hotový přehled pro Power BI Desktop, tlačítkem Stáhnout šablonu Power BI v BI a export dat. Nejprve vytvořte API připojení (Power BI). V modelu: tabulka pro každou datovou sadu se správnými typy, kalendář (rok, měsíc, týden, den v týdnu), vztahy (datum → kalendář, řádky účtenek → produkty, odpracované hodiny → zaměstnanci) a míry (tržba vč. a bez DPH, DPH, spropitné, účtenky, hosté, průměr na účtenku a na hosta, prodané množství, tržba z produktů, zaplaceno, storna, odpracované hodiny, tržba na odpracovanou hodinu). Tři stránky: Přehled (klíčové ukazatele, tržba podle dne, dne v týdnu a hodiny, způsoby platby), Produkty (podle skupiny a podle produktu) a Personál (hodiny a tržba na zaměstnance). Přes portál ho služba Power BI také obnovuje podle plánu.
• Tajné údaje (token, heslo, klíč) se v přehledu nikdy nezobrazují; nechat prázdné = ponechat, Vymazat = odstranit. Vše se zapisuje do protokolu (bez tajných údajů).

Mzdy a plánování

Se zapnutou docházkou (Nastavení → Provozovna) najdete v Nastavení → Pracovní doba dole Mzdy a plánování (oprávnění Spravovat nastavení) ve dvou samostatných blocích. Je-li docházka vypnutá, nejsou žádné hodiny: pak je jen blok Plánování personálu (tržby, živě nebo jako soubor tržeb) dole v Nastavení → Účetnictví, pod nadpisem Tržby do vašeho plánování:

• Mzdová agenda (payroll): zvolte mzdový program nebo (Belgie) sociální sekretariát, vyplňte jeho pole a u každého zaměstnance jeho osobní číslo v tomto programu. Pak pro zvolené období vytvoříte soubor s odpracovanými hodinami (uzavřené směny, na zaměstnance a den příchodu) a tržbami na zaměstnance (bez DPH, co zaměstnanec sám účtoval): připravený pro Loket.nl (Variabele gegevens, součet na zaměstnance za období, záhlaví aanslnr;persnr;ploeg;<looncomponent>) a SD Worx Belgie (Tijdsregistratie, pevné pozice, na zaměstnance a den), jinak výkaz hodin (CSV: Datum; Osobní číslo; Jméno; Hodiny; Tržby bez DPH). Zaměstnanci bez osobního čísla se do souboru pro Loket nebo SD Worx nedostanou; pokladna ohlásí, o koho jde.
• Plánování personálu (WFM): zvolte plánovací systém. Opakované odeslání data přepíše. Navíc přehled tržeb (CSV po dnech a hodinách, bez DPH i s DPH) a pro Strobbo soubor Excel pro Importeer omzet.
• Jen programy, které fungují v zemi provozovny, po skupinách a abecedně; server odmítne program z jiné země (400).
• Klíče a tokeny se nikdy nezobrazují na obrazovce.
• Týká se účetnictví: mzdové náklady zaúčtuje do účetnictví mzdový program, tržby zaúčtuje pokladna (Nastavení → Účetnictví). AFAS Payroll a Exact Online Loon jsou ve stejném prostředí jako účetnictví AFAS a Exact.
• Na kopii pokladny v portálu to nejde (dělá to pokladna v provozovně).
• U některých programů není API veřejné nebo je jen pro partnery (mj. Loket, Nmbrs, Nostradamus, Employes, Shyfter, Planday, Eitje): ty jsou uvedeny na vyžádání; do té doby soubor. Formát pro SD Worx a Strobbo pochází z jejich dokumentace: první import si nechte zkontrolovat.

Zákonné požadavky v Belgii a Nizozemsku

Co požaduje zákon a co pro to HorecaPOS dělá (nechte si od účetního potvrdit, co platí pro vaši provozovnu):

Zákony a předpisy

Nastavení → Zákony a předpisy (správce; asistent DPH i s oprávněním Správa produktů). Vše je ve výchozím stavu vypnuté; bez těchto nastavení pokladna funguje jako vždy.

• Kontrola věku u alkoholu (18+): v Produktech zaškrtněte Obsahuje alkohol (nebo použijte asistenta DPH). Při vyzvednutí a doručení s alkoholem se na kuchyňském lístku, účtence a na obrazovce objednávek zobrazí "18+". V e-shopu zákazník sám potvrdí, že mu je 18 let nebo více (políčko není předem zaškrtnuté), a vidí, že věk bude zkontrolován při předání.
• Poplatek za jednorázové obaly (Nizozemsko): částka u každého produktu (orientační ceny: kelímek € 0,25, krabička na jídlo € 0,50, malá krabička € 0,05). Při vyzvednutí a doručení pokladna sama přidá na účtenku položku "Poplatek za jednorázové obaly" (s DPH produktu); ta se automaticky přenáší s produkty (databáze ji sleduje, i po stornu, přesunu nebo změně druhu objednávky) a je uvedena zvlášť v tržbách. Na místě bez poplatku. Thuisbezorgd.nl a e-shop účtují vlastní poplatek.
• Záloha (Nizozemsko): u každého produktu (€ 0,15 plechovka/lahev, € 0,25 velká lahev), položka "Záloha" bez DPH, jen při vyzvednutí a doručení.
• Hotovost od € 3.000 (Nizozemsko, od 1-1-2026 zakázáno u zboží): při vyzvednutí a doručení upozornění při placení a u automatu na hotovost; pracovník může potvrdit (např. catering jako služba), zapíše se to do protokolu. Jídlo a pití na místě je služba: bez upozornění.
• Asistent DPH: u každého produktu druh (jídlo, nealkoholický nápoj, alkoholický nápoj, potraviny bez přípravy, ostatní; nejprve odhad podle názvu a skupiny). Pokladna ukáže správnou sazbu na místě i s sebou (Belgie od 1-3-2026: jídla a nealkoholické nápoje 12 %, i s sebou; alkohol 21 %; potraviny bez přípravy 6 %. Nizozemsko: 9 % a 21 %) a použije ji, ihned nebo od zvoleného data.
• Plánování změny DPH: produkt do jiné sazby, nebo (jen Nizozemsko) sazba s novým procentem, od zvoleného data. Pokladna to v ten den provede sama (kontroluje každou čtvrthodinu a při spuštění).

Faktury (v Belgii mezi firmami povinné) jsou popsány v části Faktury pro firemní zákazníky. Zbývá udělat: GKS 2.0, zjistit, jak je to s certifikací (viz docs/backlog-concurrenten.md).

Faktury pro firemní zákazníky

Nastavení → Faktury (správce; ve výchozím stavu vypnuto): zapněte Faktury pro firemní zákazníky (UBL / Peppol). Když je to zapnuté, najdete pod tím Platbu na fakturu, Údaje na faktuře, Služby Peppol, Propojení s bankou (s platbou na fakturu) a seznam všech faktur. V Belgii je elektronická fakturace mezi firmami povinná od 1. 1. 2026.

• Faktury pro firemní zákazníky: Účtenky → vyberte účtenku → Faktura. Zadejte zákazníka (nebo vyberte dřívějšího); pokladna vytvoří fakturu s číslem (např. F2026-0001, průběžně za rok), jako UBL podle Peppol BIS Billing 3.0 a jako fakturu k tisku nebo uložení do PDF. Odeslání e-mailem (obojí jako příloha, případně kopie účetnímu), přes Billit do sítě Peppol (BILLIT_API_KEY, BILLIT_PARTY_ID), přes Storecove (STORECOVE_API_KEY, STORECOVE_LEGAL_ENTITY_ID; příjemce se určí z Peppol ID zákazníka, např. 0208 → BE:EN, 0106 → NL:KVK, jinak e-mailem přes Storecove) nebo přes Banqup od Unifiedpost (BANQUP_CLIENT_ID, BANQUP_CLIENT_SECRET, BANQUP_SPACE_ID; BANQUP_SANDBOX=1 pro testovací prostředí; Banqup UBL zkontroluje a sám doručí), na vlastní adresu (FACTUUR_HTTP_URL, např. účetní program nebo jiná služba Peppol) nebo stažení. Jedna faktura na účtenku; účtenka je už zaplacená, tedy "uhrazeno". Číslo KvK/IČO, IBAN, Peppol ID, předpona a splatnost v Údaje na faktuře. Všechny faktury dole na kartě (oprávnění Tržby za období).
• Klíče, tajné údaje a hlavičky se nikdy nezobrazují (jen "vyplněno"; nechat prázdné = ponechat, Vymazat = odstranit) a nezapisují se do protokolu (jen která pole se změnila). Jsou uložené v databázi (vestiging.peppol_gegevens): v zálohách ano, v exportu konfigurace ne.

Samoobslužný kiosek

Hosté si objednávají sami na stojanu nebo tabletu, jako ve fast foodu, a platí u pokladny nebo kartou na kiosku. Objednávací obrazovky jsou součástí samotné pokladny, takže menu, ceny, možnosti, menu sety, happy hours, denní doby, fotky, alergeny, jazyky i účtenka pocházejí z pokladny a nemusí se nikde jinde nastavovat. Na kiosku běží aplikace PinPortal Kiosk 2 (Android, včetně Sunmi, a Windows, Linux a macOS), která zobrazuje stránku a tiskne účtenku. Ve výchozím stavu vypnuto.

Zapnutí a nastavení (správce): Nastavení → Provozovna → Obrazovky a ovládání → Samoobslužný kiosek.

• Zvolte, co si host může vybrat: Na místě a/nebo S sebou (s sebou počítá s cenou s sebou a sazbou DPH s sebou, pokud jsou nastavené).
• Uvítací text, po kolika sekundách bez dotyku se kiosek vrátí na začátek (košík se pak vyprázdní) a které skupiny produktů jsou na kiosku (nic nezaškrtnuto = všechny).
• Ještě něco k tomu?: zaškrtněte skupiny produktů (např. nápoje, dezerty); u košíku pak kiosek nabídne několik produktů z nich.
• Placení, pro každý kiosek (viz Přidání a propojení kiosku):
  • U pokladny (výchozí, jako u starého kiosku): host objedná, dostane číslo k vyzvednutí a zaplatí u pokladny. Na kiosku není potřeba platební terminál.
  • Kartou na kiosku: host zaplatí na platebním terminálu u kiosku.
  • Host si vybere: u pokladny nebo kartou. Nemá-li kiosek terminál, platí se u pokladny.
• Do kuchyně (při placení u pokladny): hned po objednání na kiosku (výchozí), nebo až po zaplacení u pokladny.
• Účtenka: na tiskárně kiosku (výchozí), na tiskárně účtenek pokladny, nebo bez účtenky (jen číslo na obrazovce). Při placení u pokladny kiosek vytiskne lístek s číslem a zatím nezaplaceno; účtenka přijde při zaúčtování u pokladny.
• Stav objednávky v telefonu (volitelné, standardně vypnuto): na účtence z kiosku a na závěrečné obrazovce je QR kód. Host ho naskenuje, vidí své číslo a stav (objednáno, připravuje se, hotovo) a dostane upozornění, když je objednávka hotová. Funguje přes správcovský portál, pokladna k němu musí být připojená.
• Alkohol a zboží na kila nejsou na kiosku nikdy: bez obsluhy nelze ověřit věk a není tam váha.
• Čtečka čárových kódů (volitelné, ve výchozím stavu vše vypnuto): zaškrtněte, co smí sken na kiosku udělat:
  • produkt do košíku (kód u produktu);
  • slevový kód;
  • zákaznickou kartu (host sbírá body);
  • dárkový poukaz nebo předplacenou kartu jako platbu. Je-li zůstatek dostatečný, je objednávka hned zaplacená. Jinak poukaz zaplatí část a host zaplatí zbytek kartou nebo u pokladny (to je pak povoleno i na kiosku jen s platbou kartou). Po takové částečné platbě už host nemůže zrušit; objednávka je v pokladně jako Kiosek … · číslo.

Samotnou čtečku nastavíte na kiosku: v aplikaci PinPortal Kiosk 2 ve správě → Čtečka čárových kódů (jako klávesnice, vestavěná čtečka nebo port COM), s testem čtečky. Čtečka, která funguje jako klávesnice, funguje i bez aplikace.

• Dobít kredit (volitelné, standardně vypnuto; funguje jen tehdy, když je zapnutý Dobíjecí kredit): na úvodní obrazovce kiosku je pak Dobít kredit. Host naskenuje svou kartu nebo poukaz (nebo napíše kód), uvidí zůstatek a zvolí částku. Částky si nastavíte sami (od 1 do 6, standardně € 10, € 20 a € 50). Placení probíhá podle nastavení kiosku: kartou, nebo u pokladny s číslem k vyzvednutí. Po zaplacení je částka na zůstatku. Takové dobití nejde do kuchyně, není na vyvolávací obrazovce a nedostane QR kód. I zde platí nejvyšší zůstatek z nastavení Dobíjecí kredit.
• Na můj pokoj (propojení s hotelem, ve výchozím stavu vypnuto; Nastavení → Hotel → Samoobsluha): u košíku se pak zobrazí Zapsat na můj pokoj. Hotelový host zadá číslo pokoje a příjmení; odpovídá-li to hostu, který v tom pokoji právě bydlí, jde objednávka do kuchyně a je zaplacena na pokoj (viz Hotelový software: zapsání na pokoj).
• Belgie (černá skříňka): co ještě nebylo otestováno s černou skříňkou, je na kiosku automaticky vypnuté (dárkový poukaz nebo kredit jako platba, dobití, slevový kód, menu, volby s příplatkem, happy hour), stejně jako u pokladny.

Přidání a propojení kiosku

1. U Kiosky zadejte název (např. Kiosek vchod) a zvolte Přidat kiosek. Dostanete propojovací kód o 6 číslicích (platný 30 minut).
2. U kiosku vyberte, jak host platí: standardně u pokladny. Je-li to kiosek s platebním terminálem, zvolte kartou nebo host si vybere a vyberte platební terminál tohoto kiosku (z Nastavení → Platby).
3. Otevřete na kiosku stránku kiosku:
   • v provozovně: v aplikaci ve správě → Vast adres adresu uvedenou u nastavení, např. http://192.168.1.20:3000/kiosk;
   • nebo přes správcovský portál (https, i když kiosek není ve stejné síti): propojte adresu kiosku uvedenou u nastavení s kódem kiosku v aplikaci, stejně jako u starého kiosku.
4. Zadejte na kiosku propojovací kód. Hotovo: kiosek si pamatuje svůj vlastní klíč. Propojit znovu dá nový kód; Odebrat ho odpojí.

U každého kiosku je vidět, zda je online.

Jak host objednává

1. Úvodní obrazovka s uvítacím textem; host si zvolí jazyk (všechny jazyky pokladny) a klepne pro objednání.
2. Na místě nebo s sebou.
3. Nabídka podle skupin produktů, s fotkami, cenou (s happy hour), alergeny a tím, co je vyprodané. Produkty s výběrem nebo menu otevřou okno výběru.
4. Košík: úprava množství a případně Ještě něco k tomu?.
5. Objednat (placení u pokladny): host vidí své číslo k vyzvednutí velké na obrazovce s částkou, dostane lístek a zaplatí u pokladny. V pokladně je objednávka otevřená jako Kiosek Vchod · 42 (číslo, které host řekne); účtuje se jako vždy. Pak se na vyvolávací obrazovce zobrazí jako zaplacená a jde do kuchyně, pokud to mělo být až po zaplacení.
6. Zaplatit kartou: pokladna pošle částku na terminál tohoto kiosku (stejné propojení plateb jako u pokladny). Když se to nepovede, host může zkusit znovu nebo zrušit (nebo, smí-li si vybrat, přece jen zaplatit u pokladny). Teprve po úspěšné platbě jde objednávka do kuchyně a je zaúčtována. Host vidí své číslo k vyzvednutí velké na obrazovce a dostane účtenku.
7. Po několika sekundách se kiosek vrátí na začátek.

Při poruše: hlášení a nouzový režim (v aplikaci kiosku, správa → Bij storing; ve výchozím stavu vypnuto). Když se kiosek nemůže spojit s pokladnou, zobrazí Even gesloten. Dvě funkce navíc:

• Teams, Slack, Discord, ntfy, Home Assistant, Make nebo Zapier) a zprávu hersteld, když vše opět funguje. Tlačítkem Testmelding sturen ověříte adresu.
• Nouzový režim: kiosek si uloží jednoduchou nabídku, kterou mu předá stránka kiosku: produkty bez výběrů a menu, s cenou pro konzumaci na místě (nebo s sebou, pokud je to jediná možnost).
  • Je-li pokladna nějakou dobu nedostupná (ve výchozím stavu 60 sekund), host objednává z této nabídky.
  • Host platí kartou nebo u pultu. Platba kartou je možná jen tehdy, je-li v aplikaci zapnuto Pinbetaling.
  • Vytisknou se dva nouzové lístky: jeden pro hosta (N1, N2 …) a jeden pro pult/kuchyni. Je na nich uvedeno, že nejde o účtenku.
  • Když se pokladna vrátí, stránka kiosku vloží nouzové objednávky do pokladny jako Nood N… <kiosek>. Nejdou do kuchyně (ta už nouzový lístek měla) a nezobrazují se na vyvolávací obrazovce.
  • Zaplaceno kartou a stejná částka jako v pokladně: vyúčtováno jako Ručně zaplaceno kartou. Jinak (placení u pultu nebo jiná částka) zůstane objednávka otevřená pro obsluhu.
  • Vše je zapsáno v protokolu.
• Belgie: u registrovaného pokladního systému (GKS, černá skříňka) musí každý prodej ihned projít pokladnou a FDM. Nouzový režim pak pravděpodobně není dovolen; nejprve si to ověřte. Aplikace kiosku ho v Belgii zapne jen po dodatečném potvrzení a pokladna u kiosku zobrazí varování.

V pokladně je objednávka z kiosku běžná objednávka (s sebou nebo na místě, s názvem Kiosek Vchod) na jméno zaměstnance Kiosk. Pokladna ho vytvoří sama; nikdo se s ním nemůže přihlásit. Nenastavujte ho jako neaktivního, jinak kiosek nemůže objednávat. Objednávky z kiosku jsou v přehledech, v Účtenkách a na vyvolávací obrazovce. Objednávka nedokončená na kiosku (neobjednaná nebo nezaplacená kartou) po 30 minutách sama propadne.

Platba kartou v testovacím režimu (Nastavení → Platby)? Pak kiosek ve skutečnosti neinkasuje; šikovné na vyzkoušení. Bez internetu nelze platit kartou; kiosek pak řekne, že objednat jde u pultu.

Porucha: není-li pokladna dostupná, aplikace kiosku ukáže "Chvíli zavřeno" a sama pokračuje. Běží-li kiosek přes správcovský portál a vypadne internet, může aplikace přejít na pokladnu v místní síti (v aplikaci: správa → Rozšíření → Při poruše přejít na místní síť); adresu předává kiosek sám.

Vypnutí: kiosek ukazuje, že je na chvíli zavřený. Kiosky a nastavení zůstanou uložené. V protokolu je zapnutí/vypnutí, nastavení, přidané a odebrané kiosky, propojení a zrušené objednávky.

Digitální menu tabule

Lístek s cenami na televizi (nebo jiném monitoru s prohlížečem), přímo z pokladny. Ve výchozím stavu vypnuto; zapněte přes Nastavení → Provozovna → Obrazovky a ovládání → Digitální menu tabule. Poté na televizi otevřete http://<kassaserver>:3000/menubord (nebo použijte tlačítko Na vlastní obrazovce / Na tabletu nebo telefonu s QR kódem). Bez přihlášení a bez párování.

• Podle skupiny produktů produkty s cenou, v pořadí jako na pokladně. Sami zvolíte, které skupiny (a v jakém pořadí), 1 až 4 sloupců, tmavé nebo světlé, vlastní nadpis (prázdný = název provozovny), fotografie produktů a alergeny.
• Vždy aktuální: tabule si každých 10 sekund načte lístek (a ihned při změně), takže vyprodaný produkt (přeškrtnutý s Vyprodáno, nebo stažený z tabule), prázdné zásoby, happy hour (akční cena s přeškrtnutou běžnou cenou a nahoře název a čas konce) a části dne (jen to, co je teď v prodeji) se na ní samy zobrazí správně.
• Když se vše nevejde na obrazovku, stránky se střídají (ve výchozím stavu každých 12 sekund, nastavitelné od 5 do 120).

Zaměstnanci a PINy

Nastavení → Zaměstnanci (jen správce): přidávat zaměstnance, měnit jméno, roli a PIN a nastavovat je jako neaktivní.

• Role: číšník (objednávání, placení, X-zpráva), vedoucí (navíc slevy, vrácení, uzavření dne, pokladní zásuvka a protokol) a správce (vše, včetně celého Nastavení). To je výchozí stav; co smí číšníci a vedoucí, lze upravit (viz Oprávnění podle role).
• PIN o 4 až 8 číslicích, jedinečný mezi aktivními zaměstnanci. PINy se v databázi ukládají jen zašifrované (hash) a nelze je zpětně přečíst.
• Trvalé smazání není možné (účtenky a protokol na zaměstnance odkazují); neaktivní = už se nemůže přihlásit.
• Vždy zůstane alespoň jeden aktivní správce.
• Jiná role, nový PIN nebo neaktivní: aktuální relace tohoto zaměstnance se okamžitě ukončí.
• Belgie: volitelně rodné číslo (národní registr) pro evidenci personálu.
• Jazyk: jazyk obrazovky pro tohoto zaměstnance (nebo "Jazyk zařízení"). Po přihlášení je pokladna hned v tomto jazyce; zaměstnanec jej může změnit i sám malou vlajkou vpravo dole (viz Jazyky).
• Tip: před spuštěním pokladny nahraďte ukázkové PINy 1111 a 2222.

Přihlášení kartou (volitelné)

Standardně vypnuto. Zapnutí: Nastavení → Zaměstnanci, zaškrtněte Přihlášení kartou (NFC, RFID nebo iButton). Potřeba: USB čtečka karet, která funguje jako klávesnice (pro NFC nebo RFID karty, přívěsky na klíče, náramky nebo klíče iButton). Taková čtečka "napíše" číslo karty a stiskne Enter; není potřeba žádný ovladač ani propojení.

• Spárování: klepněte na zaměstnance, pak na Spárovat kartu a přiložte kartu ke čtečce. Karta patří jednomu zaměstnanci. Odebrat kartu, když se ztratí.
• Přihlášení: na přihlašovací obrazovce přiložte kartu ke čtečce. PIN také normálně funguje dál.
• Příchod a odchod (je-li zapnuto): na přihlašovací obrazovce Příchod / odchod a přiložit kartu ke čtečce.
• Číslo karty je v databázi uloženo jen zašifrované (hash), stejně jako PIN. Neaktivní zaměstnanci se nepřihlásí ani svou kartou.
• Vypnuto: přihlášení jen PINem, jako vždy. Spárované karty zůstanou uložené.

Oprávnění podle role

Nastavení → Oprávnění (jen správce): u každé role zaškrtněte, co smí číšníci a vedoucí. Ve výchozím stavu je vše přesně jako výše (jak to pokladna vždy dělala); políčko, které se liší, je barevné.

• Správce smí vždy všechno. Změny zaměstnanců a oprávnění zůstávají vždy vyhrazeny správci (jinak by si někdo mohl přidělit více oprávnění).
• Tlačítka a karty, které role nesmí používat, jsou pro tuto roli skryté; pokladní server to také kontroluje. Pokud vedoucí dostane např. Spravovat produkty, uvidí tlačítko Nastavení jen s kartou Produkty.
• Změny platí okamžitě na všech pokladnách a zaznamenávají se v protokolu. Obnovit výchozí vrátí vše do původního stavu.

Údaje o podniku

Nastavení → Podnik (jen správce): název, adresa, PSČ, město, telefon a DIČ provozovny. Ty se objevují nahoře na každé účtence a proforma účtu. Lze zde nastavit i text dole na účtence (více řádků povoleno; prázdné = žádný text; výchozí "Bedankt en tot ziens!") a pod ním jazyk účtenky (výchozí nizozemština; viz Jazyky). Náhled účtenky se aktualizuje živě. Po uložení použije další účtenka nové údaje okamžitě. Zemi a fiskální údaje (GKS) zde záměrně měnit nelze. V Belgii je DIČ povinné. Zaškrtávacím políčkem Zaokrouhlovat platby v hotovosti na 5 centů (ve výchozím stavu vypnuto) se součet při platbě v hotovosti zaokrouhlí (€ 6,62 → € 6,60, € 6,63 → € 6,65); rozdíl se na účtence objeví jako "Zaokrouhlení". Platby kartou zůstávají vždy přesné na cent.

Správa produktů

Přihlaste se jako správce a zvolte Nastavení → Produkty.

• Přidávat, upravovat (název, cena, skupina, sazba DPH pro konzumaci na místě a s sebou, název na účtence, kód, vyprodáno) a mazat skupiny produktů a produkty. Skupiny i produkty mohou mít vlastní barvu; produkt s barvou dostane na obrazovce objednávky barevné tlačítko (text automaticky bílý nebo tmavý kvůli čitelnosti).
• Pořadí změníte přetažením skupiny nebo produktu za ≡. Funguje to myší i prstem na tabletu. Přesně toto pořadí se pak objeví na obrazovce objednávky; otevřené obrazovky pokladen se okamžitě aktualizují.
• Smazáním produkt z pokladny zmizí, ale staré objednávky a fiskální deník produkt dál znají. Skupinu lze smazat, jen když je prázdná.
• Možnosti: otevřete produkt nebo skupinu produktů a v části "Možnosti" přidejte skupiny možností, například "Propečení" (právě jedna, povinná), "Omáčka" (nejvýše jedna) nebo "Extra" (více, s minimem a maximem; prázdné maximum = neomezeně). Každá možnost má název a příplatek (může být záporný, např. -0,50). Skupiny možností skupiny produktů platí pro všechny produkty v této skupině, navíc k vlastním možnostem produktu. Pořadí pomocí ▲▼. Smazání je vždy možné: stávající objednávky a účtenky si zvolené možnosti uchovávají samy. Server kontroluje i povinné možnosti a maximum.
• Fotka u každého produktu: viz Fotky produktů.
• Cena za kilo, číslo PLU a tára (jen když je váha zapnutá): viz Nastavení váhy. Bez zaškrtnutí zůstává produkt na kusy.

Fotky produktů

Každý produkt může mít fotku.

• Nastavení fotky: Nastavení → Produkty → zvolte produkt → Vybrat fotku (na tabletu nebo telefonu můžete použít i přímo fotoaparát). Fotka se v prohlížeči zmenší na nejvýše 512 × 512 pixelů (JPEG, obvykle 20–80 kB) a hned se uloží; Jiná fotka ji nahradí, Smazat fotku ji odstraní. Seznam produktů ukazuje malou fotku před názvem. Jen s oprávněním Spravovat produkty; jpg, png a webp, nejvýše 512 kB.
• Co se zobrazuje, volí správce v Nastavení → Podnik → Fotky produktů, nezávisle na sobě a ve výchozím stavu vypnuto:
  • Fotka produktu na tlačítkách obrazovky objednávky: fotka nahoře na tlačítku produktu, s názvem a cenou pod ní.
  • Fotka produktu u produktů na zákaznickém displeji: malá fotka před každým řádkem na zákaznickém displeji (zákaznický displej musí být také zapnutý). Produkty bez fotky zůstanou, jak jsou; je-li to vypnuté, vše funguje přesně jako dříve.

Čtečka čárových kódů

Se čtečkou čárových kódů na pokladně skenujete produkty, slevové kódy, zákaznické karty a dárkové poukazy. Zapíná se v Nastavení → Čtečka (karta vedle tiskáren a váhy; ve výchozím stavu vypnuto). Zaškrtněte, co sken na objednávací obrazovce udělá:

• Produkt na účtenku: produkt s tímto kódem (Nastavení → Produkty, pole Kód; např. čárový kód EAN z obalu). U výběrů, menu nebo ceny za kilo se nejdřív otevře okno výběru nebo váha, stejně jako při klepnutí. Totéž dělá Skenování na objednávací obrazovce u Tisk etiket; to dál funguje jako dosud.
• Slevový kód na účtenku (pokud jsou slevové kódy zapnuté).
• Zákaznická karta: zákazník s tímto číslem karty se přidá na účtenku (pokud je zákaznická karta zapnutá). Naskenujete-li neznámý kód na účtence se zákazníkem, pokladna se zeptá, zda je to jeho nová karta.
• Dárkový poukaz nebo předplacená karta: pokladna zobrazí zůstatek (pokud jsou dárkové poukazy se zůstatkem zapnuté). Platí se v Zaplatit → Dárkový poukaz; tam můžete poukaz také naskenovat.

Pokladna hledá nejdřív mezi produkty, pak mezi zákaznickými kartami, dárkovými poukazy a slevovými kódy. Skenování funguje na objednávací obrazovce, pokud nejste ve vstupním poli. Ve vstupním poli se kód prostě zapíše do toho pole.

Test čtečky: v Nastavení → Čtečka uvidíte u každého skenu kód a co s ním pokladna udělá, i když je čtečka ještě vypnutá. Pokud to nefunguje:

• Nastavte čtečku na klávesnici (USB-HID), s Enter za kódem. U většiny čteček to tak už je.
• Vestavěnou čtečku (např. pokladny Sunmi) nastavte v nastavení čtečky zařízení na vstup z klávesnice.
• Etikety z váhy TS6X (hmotnost a cena) řeší váha sama, i se zapnutou čtečkou.

Na kiosku se čtečka nastavuje zvlášť (Nastavení → Provozovna → Kiosek); viz Samoobslužný kiosek.

Tisk etiket

Etikety produktů s názvem, cenou a čárovým kódem, na tiskárně etiket (Brother, Dymo, Zebra ...) nainstalované v počítači nebo tabletu. Zapíná se v Nastavení → Provozovna → Tisk etiket (ve výchozím stavu vypnuto). Tam také zvolíte formát etikety (38 × 25, 57 × 32, 62 × 29 nebo 100 × 50 mm) a zda na ní bude cena a čárový kód. Zkušební tisk vytiskne jednu zkušební etiketu.

• Nastavení → Produkty → (produkt) → Etikety: zvolte počet a Tisk.
• Nákup → (přijatá objednávka) → Tisk etiket: u každého produktu tolik etiket, kolik bylo přijato (přijaté objednací jednotky × počet v objednací jednotce; suroviny ne). Nejvýše 500 etiket najednou.
• Pokladna otevře dialog tisku: zvolte v něm tiskárnu etiket a formát papíru role. Každá etiketa je jedna stránka.
• Čárový kód je kód produktu (Nastavení → Produkty): 8 nebo 13 číslic se správnou kontrolní číslicí = EAN (12 číslic: kontrolní číslice se doplní), jinak Code 128 (písmena, číslice a interpunkce, až 30 znaků). Bez kódu žádný čárový kód.
• Skenování na objednávací obrazovce (zaškrtávací políčko, ve výchozím stavu vypnuto): skener čárových kódů, který pracuje jako klávesnice, přidá produkt s tímto kódem, s obvyklými volbami (možnosti, váha, alergie). Ne společně s váhou TS6X, která má vlastní etikety s hmotností a cenou.
• Oprávnění: Spravovat produkty nebo Spravovat zásoby.

Nastavení váhy (A&D, Aclas, Adam Equipment, Avery Berkel, Avery Weigh-Tronix, Balanzas Marques, Baxtran, Bizerba, Brecknell, CAS, Datalogic, Dibal, DIGI, Dini Argeo, Excell Precision, Gram, Ishida, Kern & Sohn, Mettler Toledo, Minebea Intec, Ohaus, Precia Molen, Precisa, Rice Lake, Rongta, Sartorius, Star Micronics, T-Scale, UWE, Wedderburn, Wintec, Zebra)

Samostatná karta Nastavení → Váha (oprávnění Nastavit podnik, platby a tiskárny, ve výchozím stavu jen správce; karta je tam vždy, i když je váha ještě vypnutá). Ve výchozím stavu vypnuto: pokladna pak funguje přesně jako dříve. Kartu nevidíte?

Automatické hledání. Pokud ještě nic nastaveno není, pokladna při otevření této části hledá automaticky (tlačítko Hledat to udělá znovu):

• běží pokladna (server) sama na PC nebo AI váze Aclas (TS6X, TS3X, TS5EX/NX/GX, iS6X, iS2X, iR6X, Ti6X, iL8X; značka/model zařízení: Windows přes WMI, Android přes getprop, Linux přes DMI) a odpovídá Aclas Scale Module? Pak se tato váha nastaví jako Na tomto zařízení, a etiketovací váha také; na Linuxu (bez Scale Module) vestavěná váha na nalezeném interním portu (/dev/ttyS...) jako "TS6X (ingebouwd)", i s modelem;
• je na portu COM/USB OS6X? Každý port se zkouší při 9600, 4800, 2400 a 19200 baudech: nejprve krátké naslouchání (průběžně), pak odeslání W (Toledo) a jinak Dialog 06 (9600, 7 datových bitů, lichá parita: dotaz na stav).

Nalezeno = vyplněno do formuláře s tlačítkem Zapnout a používat: jedno klepnutí a funguje to. (Hledání posílá W na každý volný port COM; port, který je používán, např. platebním terminálem, se přeskočí.)

Všechny váhy Aclas. U každé váhy zvolíte model; pokladna pak ví, jak ji lze připojit. Existují dva druhy:

• Na tomto zařízení (nastavíte jednou): pokladna běží na váze (PC nebo AI váha). S Windows nebo Androidem váží přes Aclas Scale Module, bez portu, rychlosti a protokolu; s Linuxem (bez Scale Module) přes interní port váhy (obvykle /dev/ttyS0 nebo /dev/ttyS1), s portem, rychlostí a protokolem. Na pokladnu je jen jedna; vyhledávání ji najde samo. PC nebo AI váha (TS6X, iS6X ...) je vždy Na tomto zařízení: v seznamu může být jen jednou a ostatní PC/AI modely pak už nelze vybrat. TS6X jinde v provozovně může dál tisknout etikety (zapněte pak jen Skenovat etikety).
• Připojené (více najednou): váha je připojena k serveru pokladny kabelem (RS232/USB), přes Bluetooth nebo síť. Kolik je potřeba (nejvýše 8), každá s vlastním názvem.

Jeden seznam, dvě zaškrtávátka. Všechny váhy jsou v jednom seznamu. U každé váhy zaškrtnete, co dělá: Vážení u pokladny (pokladna si při objednávce vyžádá hmotnost) a/nebo Skenovat etikety (váha vytiskne etiketu s čárovým kódem, kterou pokladna naskenuje, a dostává PLU od pokladny). PC nebo AI váha jako TS6X umí obojí; váha s tiskem etiket LS jen etikety. Etikety mohou pocházet z jedné váhy na provozovnu.

A&D, Adam Equipment, Avery Berkel, Avery Weigh-Tronix, Balanzas Marques, Baxtran, Bizerba, Brecknell, CAS, Datalogic, Dibal, DIGI, Dini Argeo, Excell Precision, Gram, Ishida, Kern & Sohn, Mettler Toledo, Minebea Intec, Ohaus, Precia Molen, Precisa, Rice Lake, Rongta, Sartorius, Star Micronics, T-Scale, UWE, Wedderburn, Wintec a Zebra. Jsou zahrnuty běžné modely těchto značek, u kterých je jasné, jak s nimi pokladna komunikuje (k otestování = protokol není doslova uveden v žádném zdroji; pokladna zvolí to nejpravděpodobnější). Všechny připojené (několik najednou), nebo jako etiketovací váha, jejíž etiketu pokladna naskenuje:

• A&D EK-i a HV-WP: nastavte váhu na stream (EK-i: prt 0; z výroby je nastavena na tlačítko PRINT) a pokladnu na Nepřetržitě s 2400 baudy a 7E1 (tak je A&D nastavena z výroby). Zpráva je ST,+00512.00 g (US = hýbe se, OL = příliš těžké).
• Adam Equipment Swift: nastavte váhu na nepřetržitě do PC (8N1); pokladna je pak na Nepřetržitě.
• Avery Berkel FX110, FX120 a FX131: na váze zvolte protokol Mettler Toledo 82/7 a pokladnu nastavte na Dotaz (Toledo) s 7E1 (9600 baudů). Funguje i Dialog 06. FX125 (s cenovým displejem) Toledo nezná: tam Dialog 06. Pokladna to nastaví sama, když zvolíte model.
• Avery Weigh-Tronix 7820, 7829 a ZP900 a Brecknell 6702U, 6710U a 6720U: NCI, protokol Weigh-Tronix. Pokladna pošle W (stejně jako u Toledo), váha odpoví hmotností ( 1.234KG) a stavovým řádkem; ten říká, zda se hýbe, je příliš těžká nebo příliš lehká. Pokladna je na Dotaz (Toledo) s 7E1 (9600 baudů). USB funguje jako virtuální COM port. U ZP900 nastavte pokladnu na port 2 (NCI). U 67xxU lze na váze nastavit i 8213 (SCP03).
• Balanzas Marques BM1000P TOP: u COM portu zvolte protokol B (METTLER) a 9600 baudů, 7 datových bitů, sudá parita; pokladna je pak na Dotaz (Toledo) s 7E1.
• Baxtran TW, VW, XTA a XTA-P (váhy s výpočtem ceny; VW a XTA-P se sloupkem): v menu RS232 váhy zvolte protokol Toledo, 9600 baudů a 7 datových bitů se sudou paritou (7E1); pokladna je pak na Dotaz (Toledo) s 7E1. Pokladna to nastaví sama, když zvolíte model. Funguje i CONT (váha posílá sama): nastavte pak pokladnu na Nepřetržitě se stejnou rychlostí a datovými bity. Připojení kabelem RS232 (9 pinů) nebo kabelem USB-RS232.
• Bizerba CS 300: Checkout-Dialog 06 (specifikace Bizerba): pokladna pošle cenu za kg, ověřená váha spočítá částku. Pokud váha žádá kontrolní kódy, získáte je od Bizerba nebo dodavatele.
• CAS PD-II, PDN, PDI a PDS-B (PDS-B mj. u LRE): na váze zvolte ECR type 2 (Toledo) a pokladnu nastavte na Dotaz (Toledo) s 7E1 (9600 baudů).
• Datalogic Magellan 9300i, 9400i a 9800i: nastavte Scale Interface Type samostatného portu váhy na Mettler Toledo 8217 a pokladnu na Dotaz (Toledo) s 7E1.
• Dibal KS-400, D-POS 400, G-325 a PI-100: na váze zvolte protokol Checkout_Dialog06 (protokol 24) a 9600 baudů, 7 datových bitů, lichou paritu (typ parametru 5); pokladna je pak na Dialog 06. D-POS 400 se může připojit i přes USB.
• DIGI DS-781: nastavte váhu na Type B / standardní příkaz (data transmission 00011); pokladna pošle ENQ a dostane zpět netto, taru, cenu za kg a částku.
• Dini Argeo DFW, DGT a 3590E: nastavte sériový port na nepřetržité odesílání (9600 8N1); pokladna je pak na Nepřetržitě.
• Excell Precision TPE (a 4. generace AM4, FD4-P, FDP4-P, GE4, GEP4): nastavte výstup RS232 na nepřetržitě (9600 8N1); pokladna je pak na Nepřetržitě.
• Gram XFOC RS, XFOC+ RS a ZFOC RS: protokol Gram (9600 8N1). Pokladna pošle ENQ, váha odpoví ACK, pokladna pošle DC1 a váha pošle hmotnost: SOH STX S/U/F teken gewicht eenheid BCC ETX EOT (S = stabilní, U = v pohybu, F = chyba; BCC = XOR od stavu až po jednotku včetně). Připojení přes RS232 nebo kabelem USB od Gram.
• Kern & Sohn RPB a RFC: na váze nastavte Prot = DLG-06 (připojení k pokladně je volba 965-419); pokladna je pak na Dialog 06. RFE, IFB a EOC: nepřetržité odesílání (8N1), pokladna na Nepřetržitě.
• Mettler Toledo Ariva/Viva: nastavte váhu na protokol Toledo (8217) a pokladnu na Dotaz (Toledo) s Datové bity / parita = 7E1 (Mettler: 9600 baudů, 7 datových bitů, sudá parita; Ariva se může připojit i přes USB jako virtuální COM port). Pokladna to nastaví sama, když zvolíte model.
• Minebea Intec Signum, Combics, Midrics a Puro a Sartorius Entris a Quintix: SBI s automatickým tiskem (9600 8N1); pokladna je pak na Nepřetržitě. Zpráva je N + 0.512 kg; bez jednotky se ještě hýbe.
• Ohaus Aviator 7000: v nastavení váhy (krok 20) zvolte protokol Dialog 06; pokladna je pak na Dialog 06. RS232 nebo USB, podle kabelu.
• Ohaus Valor 7000, Ranger 3000/4000/7000 a Defender 3000 (vážení bez ceny): nastavte váhu na Auto Print Continuous (9600 baudů, 8N1) a pokladnu na Nepřetržitě. Váha posílá 0.512 kg G; ? za hmotností znamená, že se ještě hýbe. Ranger 7000 se může připojit i přes Ethernet (TCP port 9761).
• Precia Molen DP400, DPOS CR a C 210 (obchodní váhy patří od roku 2025 k Dibal): Dialog 06 (9600 7O1), stejně jako Dibal. Pokud to u C 210 nefunguje, zkuste Dotaz (Toledo) s 7E1.
• Precisa XB, XT, LS a LX: nastavte režim tisku na CONTINUOUS a 9600 8N1, bez data, času a ID na řádku; pokladna je pak na Nepřetržitě. Bez jednotky se hmotnost ještě mění.
• Rice Lake BenchPro BP-S (Toledo 8213) a BP-R (NCI): pokladna je na Dotaz (Toledo) s 7E1.
• Star Micronics mG-T a mG-S8200: přes RS232 nebo USB (virtuální COM port, s ovladačem od Star) na Nepřetržitě.
• UWE ASEP: RS232 do PC/pokladny, pokladna na Nepřetržitě (k otestování).
• Wedderburn TSDS983, TSDS781T a TSDS782T jsou váhy DIGI pod vlastním označením: DIGI (Type B), stejně jako DIGI DS-781. Pokud to nefunguje, zkuste Dotaz (Toledo) s 7E1.
• Wintec ScalePOS ACS-S60E: pokladna běží přímo na ScalePOS; vestavěná váha je na COM6 (Windows) nebo COM4 (Android), 9600 8N1. Zvolte Nepřetržitě; pokud nic neposílá, Hledat najde správný protokol.
• Zebra MP7000 a MP72: port RS232-AUX je z výroby nastaven na SASI (9600 7E1, pokladna posílá W): pokladnu nastavte na Dotaz (Toledo) s 7E1.
• Etiketovací váhy těchto značek (Avery Berkel, Balanzas Marques, Bizerba, CAS, Dibal, DIGI, Ishida, Mettler Toledo, Precia Molen, Rongta, T-Scale, Wedderburn) jsou samostatné systémy s vlastním souborem PLU. Zapněte u váhy Skenovat etikety a nastavte stejný čárový kód jako na váze (EAN-13, začátek 20–29, PLU a hmotnost nebo cena). PLU nastavíte přímo na váze nebo v softwaru značky; Odeslat do TS6X a Stáhnout soubor PLU jsou jen pro Aclas.

Stejný seznam je v pokladně v Nastavení → Váha → Všechny váhy (ACLAS_MODELLEN v packages/shared/src/weegschaal.ts, se značkou u každého modelu).

Vyplnit co nejméně: když zvolíte model, pokladna připraví zbytek tak, jak ho značka nastavuje z výroby: připojení COM port / USB na prvním volném portu, 9600 baudů (A&D: 2400) a protokol značky (Toledo: Aclas s 8N1 a s 7E1 Avery Berkel FX, Avery Weigh-Tronix, Balanzas Marques, Baxtran, Brecknell, CAS, Datalogic, Mettler Toledo, Rice Lake a Zebra; Dialog 06: Avery Berkel FX125, Bizerba, Dibal, Kern & Sohn RPB/RFC, Ohaus Aviator a Precia Molen; DIGI Type B: DIGI a Wedderburn; Gram: Gram; Nepřetržitě: A&D, Adam Equipment, Dini Argeo, Excell Precision, ostatní Kern & Sohn, Minebea Intec, ostatní Ohaus, Precisa, Sartorius, Star Micronics, UWE a Wintec) a název (např. OS6X, OS6X 2). PC nebo AI váha bude Na tomto zařízení (např. TS6X (ingebouwd); na Linuxu na interním portu /dev/ttyS0). Pokud něco nesedí, Hledat najde správný port, rychlost a protokol.

Na tomto zařízení (Aclas Scale Module): váha ukazuje ověřenou hmotnost; pokladna posílá cenu za kg a táru (jako předtáru) a přebírá částku, kterou spočítá váha, stejně jako u Dialog 06.

• Android: aplikace Aclas AclasScaleDriver (com.aclas.aclasscaledriver) bývá na váze už nainstalovaná; pokud ne, nainstalujte aclas-android/AclasScaleDriver.apk. Aplikace HorecaPOS komunikuje přímo se službou této aplikace, takže žádná další knihovna není potřeba.
• Linux: Aclas nemá Scale Module pro Linux. Prostě zvolte model (např. TS6X): připojení pak bude Na tomto zařízení (interní port) na /dev/ttyS0, 9600 baudů, Toledo. Vestavěná váha bývá na /dev/ttyS0 nebo /dev/ttyS1; vyhledávání je vyzkouší a doplní správný port, rychlost a protokol. I zde jen jednou.

Software Aclas je součástí pokladny: Scale Module pro Windows (aclas-module), AclasScaleDriver pro Android (aclas-android) a Aclas Sync SDK pro Windows a Linux (aclas-sdk). Aclas nám dovoluje je dodávat. Instalátory pro Windows a Linux je obsahují; nic se nemusí zvlášť stahovat ani instalovat.

Bluetooth (např. OS6X): nejprve váhu spárujte. Windows z ní udělá COM port (Nastavení Bluetooth → Další možnosti Bluetooth → Porty COM), Linux /dev/rfcomm0: zadejte tento port. V aplikaci pro Android zadáte adresu Bluetooth (00:11:22:AA:BB:CC); aplikace jednou požádá o oprávnění Zařízení v okolí a připojí se přes Bluetooth SPP.

AI váhy (rozpoznávání produktů): kamera rozpozná produkt v softwaru Aclas na váze. Vážení probíhá přes Scale Module (na tomto zařízení) nebo port RS232; AI váhy s tiskem etiket po rozpoznání vytisknou etiketu s čárovým kódem, kterou pokladna naskenuje (jako u TS6X).

Aclas AI Recognition Plugin (AI váha s pokladnou na ní, např. iS6X s Windows): plugin od Aclas rozpozná produkt a zadá jeho čárový kód do pokladny, stejně jako skener (s Enter na konci); obrazovka objednávek přidá produkt s hmotností do objednávky. Nastavení:

• Zapněte u váhy Skenovat etikety se stejným čárovým kódem jako v pluginu. Doporučeno: začíná na 27, PLU 5 číslic, hmotnost (typ Aclas 17): pokladna pak sama počítá s cenou za kilogram. S cenou (typ 12, začíná na 22) to jde také.
• U této váhy vypněte Vážení u pokladny: plugin a Scale Module nemohou k váze přistupovat současně. Hmotnost se bere z čárového kódu. Pokud plugin odpoví při Hledat, pokladna takové nastavení navrhne a Scale Module nespustí. Bez aktivačního kódu plugin sice váží a spočítá částku, ale nerozpozná žádné produkty.
• V samotném pluginu: čárový kód v Scale and Barcode Format Settings → Default Barcode Format (typ 17) a v nastavení okna bod, kam plugin klikne a zadá kód. Zvolte k tomu prázdné místo na obrazovce objednávek, ne tlačítko. Nové produkty plugin naučí provozovna sama přímo na váze (AI trénink).
• Přidělte váženým produktům číslo PLU a odešlete PLU do váhy (Odeslat do TS6X nebo soubor PLU); plugin rozpoznává podle čísla PLU.
• Pokladna nechá plugin rozpoznávat jen tehdy, když je obrazovka objednávek otevřená přímo na váze (POST /aiplugin/resume, při zavření /aiplugin/suspend, port 5003 na váze; poprvé také EmployeeMode: zákaznický displej váhy nezobrazuje produkty). Na jiných pokladnách a tabletech a přes správní portál se nic neděje.
• Plugin se vždy spustí v režimu Resume a neumí sdělit svůj stav. Proto obrazovka objednávek každých 30 sekund znovu posílá resume; pokud to přestane (obrazovka zavřená, restart pluginu nebo váhy), pokladna do minuty přepne plugin na Suspend a nechá ho tak.
• Plugin vyžaduje aktivační kód od Aclas pro každou váhu (vázaný na sériové číslo). Funguje nyní ve Windows; verze Aclas pro Android bude následovat (pokladna tam dělá totéž).

Aclas OS6X (POS váha u pokladny, RS232/USB; stejně fungují i ostatní připojené váhy):

• Jedna nebo více vah (nejvýše 8), každá s názvem (např. Pult, Bar) a vlastním připojením: port COM / USB (COM3 ve Windows, /dev/ttyUSB0 v Linuxu/Androidu) s rychlostí, nebo síť přes převodník sériové linky na síť (IP adresa a port TCP, např. 4001).
• Protokol: Dotaz (Toledo) = pokladna pošle W a váha odpoví hmotností (Toledo 8217, tak bývá nastavena OS6X; i stavové zprávy nestabilní/přetížení/pod nulou) nebo Nepřetržitě = váha sama stále posílá hmotnost (ST,GS, 0.512kg, US = nestabilní) nebo Dialog 06 (ověřená), viz níže, nebo DIGI (Type B) = pokladna pošle ENQ a DIGI odpoví stavem, netto, tarou, cenou za kg a částkou (37 znaků: <status> <toestand> CR 0<netto> CR 4<tarra> CR U<kiloprijs> CR T<bedrag> CR LF; stav bit 1 = stabilní, bit 2 = pod nulou, bit 3 = příliš těžké, bit 4 = příliš lehké), nebo Gram = pokladna pošle ENQ, počká na ACK, pošle DC1 a přečte SOH STX <S/U/F> <teken> <gewicht> <eenheid> <BCC> ETX EOT. Na váze nastavte stejný protokol a rychlost. Datové bity / parita: 8N1 (Aclas, Adam Equipment, DIGI, Dini Argeo, Excell Precision, Gram, Kern & Sohn, Minebea Intec, Ohaus, Precisa, Sartorius, Star Micronics, UWE, Wedderburn, Wintec) nebo 7E1 (A&D, Avery Berkel, Avery Weigh-Tronix, Balanzas Marques, Baxtran, Brecknell, CAS, Datalogic, Mettler Toledo 8217, Rice Lake, Zebra); Dialog 06 je vždy 7O1. Dotaz čte i NCI (Avery Weigh-Tronix, Brecknell, Rice Lake BP-R): na W váha odpoví LF 1.234KG CR LF S00 CR ETX; stavový řádek (S + 2 nebo 3 bajty) říká, zda se hýbe (bajt 1 bit 0), je příliš lehká (bajt 2 bit 0) nebo příliš těžká (bajt 2 bit 1); ^^^^^ = příliš těžké, _____ = příliš lehké.
• Dialog 06 (Checkout-Dialog 06, evropský protokol pro cejchovanou váhu u pokladny): pokladna pošle váze cenu za kilo (a táru produktu); váha zváží, sama spočítá částku a ukáže cenu za kilo, hmotnost a částku na svém vlastním (cejchovaném) displeji. Pokladna převezme hmotnost a částku; okno vážení ukazuje "spočítáno váhou". Vždy 9600 baudů, 7 datových bitů, lichá parita, 1 stop bit (rychlost v nastavení se pak ignoruje). Průběh: EOT STX 01 ESC <kiloprijs 6> ESC ETX (s tárou: záznam 03 s 4 číslicemi gramů) → ACK; ENQ → STX 02 ESC 3 ESC <gram 5> ESC <kiloprijs 6> ESC <bedrag 6> ETX; NAK → EOT STX 08 ETX → STX 09 ESC <code> ETX (22 = ještě nepřipraveno, pak znovu po 100 ms; 20 = v pohybu; 21 = nejprve zvednout; 30/31 = příliš lehké; 32 = příliš těžké; 11 = neplatná cena). Kontrolní kódy: mnoho vah Dialog 06 občas (např. každých 30 vážení) požaduje kontrolní kódy pokladního softwaru (záznam 11 → záznam 10). Výrobce vah tyto kódy a způsob jejich výpočtu dává jen dodavateli pokladny. Zadejte je v Kontrolní kódy (dvojice 4 hexadecimálních znaků, např. 74AE 1B2C); pokladna je pošle, když o ně váha požádá. Pokud váha počítá s proměnným číslem (Z), takže pevné kódy nesedí, pokladna to ohlásí; v takovém případě požádejte dodavatele, aby váhu nastavil bez této kontroly, nebo použijte Toledo.
• Váhy jsou připojeny k PC nebo zařízení, kde běží pokladní server; všechny pokladny a tablety váží přes pokladní server a v okně vážení volí, kterou váhu použijí. Test zváží jednou.
• Síť funguje všude.
• Zadávat hmotnost i ručně: zapnuto = hmotnost lze zadat ručně i tehdy, když je váha k dispozici; bez OS6X je to možné vždy.

Skenovat etikety (zaškrtávátko u váhy: Aclas TS6X, jiná PC nebo AI váha, řada LS nebo LH15X; váha + tiskárna etiket, jedna na provozovnu):

• IP adresa: potřeba jen pro Naar TS6X sturen. Vážení a skenování etiket fungují i bez ní. Běží-li pokladna přímo na TS6X, nechte ji prázdnou: pokladna pak posílá sama sobě (127.0.0.1). Váží-li stejná váha i u pokladny, jsou obě zaškrtávátka u téže váhy (hledání to tak nastaví).
• Skenovat etikety: skenování etiket na obrazovce objednávek. Nastavte, jak čárový kód vypadá, stejně jako na TS6X: začíná na (20–29, výchozí 28), počet číslic PLU (4, 5 nebo 6) a pak hmotnost v gramech nebo cena v centech, plus kontrolní číslice (EAN-13). Pod nastavením je příklad.
• Čísla PLU: v Nastavení → Produkty dostane vážitelný produkt cenu za kilo, případně táru a číslo PLU (jedinečné). Číslo PLU vyberete ze seznamu (Bez PLU, další volné, Jiné číslo…); když zaškrtnete Cena za kilo, další volné číslo je už vyplněno. Potřebné jen pro etikety a PLU u TS6X: bez TS6X může zůstat Bez PLU.
• Přímé odesílání funguje ve Windows a Linuxu; v Androidu a macOS použijte soubor PLU. Při první instalaci zkontrolujte názvy polí souboru PLU a kódy v aclas-plu.ps1 podle příručky SDK dodané váhy (jedno místo k úpravě: ACLAS_PLU_KOLOMMEN v packages/shared/src/weegschaal.ts).

Správcovský portál: hlášení do portálu má funkci Váha (A&D, Aclas, Adam Equipment, Avery Berkel, Avery Weigh-Tronix, Balanzas Marques, Baxtran, Bizerba, Brecknell, CAS, Datalogic, Dibal, DIGI, Dini Argeo, Excell Precision, Gram, Ishida, Kern & Sohn, Mettler Toledo, Minebea Intec, Ohaus, Precia Molen, Precisa, Rice Lake, Rongta, Sartorius, Star Micronics, T-Scale, UWE, Wedderburn, Wintec, Zebra) se zapnuto/vypnuto a váhami podle modelu (např. TS6X (op dit apparaat), 2x OS6X, PS1CX, Ariva-S, DS-781, LS6RX, 5 producten per kilo); žádné IP adresy, COM porty ani adresy Bluetooth.

Metrologické předpisy: váha, se kterou prodáváte, musí být cejchovaná (třída III, jako OS6X). U Toledo/průběžně počítá pokladna s hmotností, kterou dodá váha; u Dialog 06 počítá cenu sama cejchovaná váha.

Kód: packages/shared/src/weegschaal.ts (protokoly, etikety, soubor PLU), apps/pos-server/src/lib/weegschaal.ts a routes/weegschaal.ts; obrazovky WeegschaalInstellingen.tsx a WeegDialoog.tsx.

Thuisbezorgd.nl / Takeaway.com

Objednávky z Thuisbezorgd.nl přicházejí přímo do pokladny, bez prostředníka (žádný Deliverect, HubRise ani podobně): Just Eat Takeaway JET Connect komunikuje se správním portálem Pin Voordeel a pokladna si odtud vyzvedává své zprávy.

V Belgii se platforma jmenuje Takeaway.com: stejná firma (Just Eat Takeaway) a stejné propojení. U belgické provozovny se na obrazovkách, v oznámeních, na kuchyňském bonu a ve správcovském portálu všude zobrazuje Takeaway.com místo Thuisbezorgd.nl. Níže znamená Thuisbezorgd obojí.

Proč přes portál? Pokladna potřebuje jen PORTAAL_URL a PORTAAL_SLEUTEL (viz Správní portál) a dělá jen odchozí požadavky.

Nastavení (Nastavení → Rozvozové platformy → Thuisbezorgd.nl / Takeaway.com, oprávnění Nastavit provozovnu, platby a tiskárny; dříve to bylo v Nastavení → Provozovna):

1. Zapněte Používat Thuisbezorgd (platí okamžitě, nezávisle na Uložit).
2. Přihlásit u Thuisbezorgd. Podnik pak u Thuisbezorgd zvolí OptimumPOS / Pin Voordeel jako svou pokladnu (Partner Hub nebo account manažer). JET pak zahájí onboarding; portál najde přihlášenou pokladnu (podle PSČ a názvu, jinak Pin Voordeel propojí relaci ručně v portálu), pošle konfiguraci a vyžádá si od pokladny menu. Propojení se pak spustí.
3. Zaškrtněte produkty, které lze objednat přes Thuisbezorgd (po skupinách nebo jednotlivě), případně s popisem pro Thuisbezorgd. Menu (cena, možnosti jako modifikátory, alergeny, DPH) se přenese automaticky; PLU = id produktu/možnosti. Po změně v katalogu pokladna aktualizuje menu do 30 sekund; jen "vyprodáno"/"opět k dispozici" jde přes API dostupnosti.
4. Otevírací doba Thuisbezorgd: zvlášť pro rozvoz a s sebou (např. 16:00-22:00, více bloků oddělených čárkou). Ukládá se tlačítkem Uložit otevírací dobu pod nimi a odesílá se do Thuisbezorgd jako service times, jakmile bude propojení hotové.
5. Dočasně zavřeno / Opět otevřeno (v NL/BE nejpozději v 07:00 následujícího rána opět otevřeno).

Objednávky. Objednávka se stane běžnou objednávkou bez stolu (bezorgen nebo afhalen, název skupiny TB <ordernummer>) s cenami, které zákazník zaplatil, plus poplatky za rozvoz/služby jako samostatný řádek a slevy Thuisbezorgd jako řádek se slevou; pokud součet stále nesedí, přidá se řádek "Verschil Thuisbezorgd". Kuchyňský lístek jde hned do kuchyně/na bar (lze vypnout). Pokladna do několika sekund potvrdí portálu, který to ohlásí JET; pokud se to do 3 minut nepodaří nebo je pokladna offline, JET dostane "failed" a podnik přejde na Orderpad.

Tlačítko Thuisbezorgd v horní liště (s počtem aktivních objednávek): seznam, zákazník a adresa, čas připravenosti/doručení a časová osa (track & trace): přijato, kurýr na cestě do restaurace, kurýr v restauraci, na cestě k zákazníkovi, doručeno (z JET), plus vlastní kroky (v přípravě, hotovo, na cestě/doručeno při vlastním rozvozu, vyzvednuto). JET Connect nenabízí pokladně živou mapu kurýra; zákazník ji vidí v aplikaci Thuisbezorgd. Nová objednávka, zrušení a "kurýr v restauraci" spustí oranžovou lištu a zvuk. Dokončit (zaplaceno online) zaplatí se způsobem platby online; pokud zákazník platí u dveří, zaplaťte jednoduše jako obvykle. Zrušení z Thuisbezorgd stornuje objednávku a vytiskne kuchyňský lístek "GEANNULEERD" (zrušeno).

Kód: apps/pos-server/src/lib/thuisbezorgd.ts, routes/thuisbezorgd.ts; obrazovky ThuisbezorgdInstellingen.tsx a Thuisbezorgd.tsx. Strana portálu: horecapos-portaal/src/thuisbezorgd.mjs (viz README portálu).

Počet ve správním portálu. Počet objednávek Thuisbezorgd za den je součástí hlášení správnímu portálu (verkoopTelling v lib/portaal.ts): přijaté a nezrušené, v den přijetí. Objednávka Thuisbezorgd zaplacená v pokladně (včetně Dokončit (zaplaceno online)) se tam znovu nepočítá pod s sebou/rozvoz. Data Thuisbezorgd jsou uložena v databázi pokladny, a jsou tedy jednoduše součástí záloh pokladny.

E-shop a online objednávky

Každá provozovna může mít vlastní e-shop: objednávkový web (a aplikaci) ve vlastním firemním stylu pro s sebou, rozvoz, objednávání u stolu přes QR kód a rezervace, s online platbou (MultiSafepay nebo Buckaroo) nebo platbou při vyzvednutí/doručení. E-shop je samostatný projekt, horecapos-webshop (Node.js, viz tamní README), a běží na stejném serveru jako správní portál.

Zapnutí a nastavení probíhá ve správě e-shopu: tlačítko Spravovat e-shop v zákaznickém portálu (majitel) nebo u instalace ve správním portálu (Pin Voordeel). Najdete tam zapnutí/vypnutí, webovou adresu (<zaak>.<webshopdomein> nebo vlastní doménu), firemní styl (barvy, logo, úvodní fotka, písmo), otevírací dobu a časové úseky pro s sebou a rozvoz, oblast rozvozu (PSČ, poloměr nebo oblast na mapě, s poplatkem a minimem), platby, slevové kódy, texty, jazyky, QR kódy pro stoly, rezervace a aplikaci (instalovatelnou jako PWA; aplikace pro Android přes Trusted Web Activity) a push oznámení (volitelně, ve výchozím stavu vypnutá): host si na stránce své objednávky zapne oznámení a dostane push oznámení, když je objednávka hotová nebo na cestě; kdo chce, dostane občas i nabídku, kterou podnik posílá ze správy e-shopu (karta Push oznámení). Funguje na Androidu a počítačích (Chrome, Edge, Firefox, Samsung Internet), v aplikaci pro Android a na iPhonu a iPadu (iOS 16.4 nebo novější), pokud si host přidá e-shop na plochu. Neodchází žádná SMS ani e-mail a neukládá se žádné jméno ani číslo. Podrobnosti v README e-shopu.

Menu. Pokladna posílá menu sama: všechny aktivní produkty (ne na kila), podle skupin produktů, s cenou, volbami, alergeny, stavem vyprodáno a fotkou produktu, plus stoly a údaje o provozovně a informaci, které marketingové kanály jsou zapnuté (pro zaškrtávací políčko "dostávat nabídky" při placení, viz SMS a e-mailový marketing). Děje se to při spuštění, jakmile se e-shop zapne, do 30 sekund po změně v katalogu a během několika sekund po změně v Nastavení → Provozovna, například u marketingu nebo zákaznické karty (nebo pomocí Odeslat menu teď). Produkt lze z e-shopu vyřadit ve správě e-shopu (skrýt), nebo v databázi pomocí artikel.webshop = false.

Objednávky. S sebou a rozvoz se stanou běžnou objednávkou bez stolu (název skupiny WEB <bestelnummer>) s cenami, které host viděl, plus poplatek za rozvoz a transakční poplatky jako samostatné řádky a slevový kód jako slevový řádek; pokud celková částka přesto nesedí, přidá se řádek "Verschil webshop". Spropitné hosta se nepočítá do tržby: připíše se k platbě jako spropitné při Dokončit (zaplaceno online). Objednávka u stolu (QR kód) jde na otevřený účet daného stolu (zaplaceno online: jako samostatná skupina u toho stolu). Kuchyňský lístek jde hned do kuchyně/na bar (lze vypnout v okně E-shop). Pokladna během několika sekund potvrdí číslem účtenky; host pak dostane "přijato" a e-mail. Pokud je pokladna offline, e-shop nepřijímá objednávky (host to hned vidí) a pošle provozovně e-mail, když objednávka zůstane příliš dlouho nevyřízená. Rezervace z e-shopu přicházejí do Rezervace (jen pokud jsou rezervace v pokladně zapnuté). Je-li nastaveno maximum na časový úsek (Rozvoz a časové úseky), započítávají se do něj i objednávky z e-shopu s časem v daném úseku.

Belgie (černá skříňka). Objednávka z e-shopu jde hned jako objednávka (signOrder) do černé skříňky, ještě před pracovním lístkem, stejně jako Objednat u pokladny. Pokud se to nepodaří, nedostane se do pokladny a e-shop ji později pošle znovu. Co ještě nebylo otestováno s černou skříňkou, je v menu pro e-shop vypnuté (dárkové poukazy, slevové kódy, na fakturu, na pokoj, menu, volby s příplatkem, happy hour a spropitné) a je odmítnuto, pokud to starý e-shop přesto pošle. Dokončit kontroluje spropitné, platbu na fakturu a na pokoj stejně jako pokladna.

Na pokoj (propojení s hotelem, Nastavení → Hotel → Samoobsluha → V e-shopu): menu dostane kamer: { maxBedrag }; e-shop posílá betaling.wijze = "kamer" s kamer a achternaam. Pokladna ověří hosta u hotelového softwaru (ne u stolu, ne s dárkovým poukazem) a uloží ho k objednávce; Dokončit (na pokoj) vyúčtuje na pokoj a zaúčtuje účtenku na hotelový účet. Souhrnná faktura u platby na fakturu: účtenka pak zůstane jako otevřená položka.

Tlačítko E-shop v horní liště (s počtem probíhajících objednávek): seznam, zákazník a adresa, požadovaný čas nebo "co nejdříve", způsob platby a časová osa. Kroky Připravuje se, Hotovo a Na cestě vidí host živě v e-shopu (a e-mailem, pokud to provozovna chce). Vyúčtováno v pokladně = Dokončeno; Zrušit stornuje jen řádky dané objednávky z e-shopu, vytiskne kuchyňský lístek "ZRUŠENO" a online zaplacenou objednávku e-shop vrátí. Dorazil, nedostavil se nebo zrušeno u rezervace se také posílá zpět do e-shopu. Nová objednávka nebo rezervace zobrazí oranžový pruh a zazní zvuk.

Kód: apps/pos-server/src/lib/webshop.ts, routes/webshop.ts; obrazovka Webshop.tsx. Strana portálu: horecapos-portaal/src/webshop.mjs.

Pokladna a e-shop stejně (každou část lze zapnout zvlášť, ve výchozím stavu vypnuto; starší e-shop nová pole ignoruje). Co je zapnuté na pokladně, funguje i v e-shopu:

• Happy hour: e-shop účtuje stejnou cenu jako pokladna v daném okamžiku (přeškrtnutá běžná cena a název happy hour), i se sezónou.
• Části dne a způsob výdeje (pokud jsou zapnuté): e-shop zobrazuje jen to, co je právě k prodeji, a u s sebou a rozvozu cenu a produkty této volby (u stolu: na místě). Menu dostává u každého produktu prijzen (afhalen, bezorgen) a nietBij a seznam dagdelen.
• Menu: host vybere jídla (pevná i volitelná, s jejich možnostmi); na pokladně se objeví jako řádek menu s jídly pod ním a rozdělenou cenou menu (DPH za jídlo sedí). Jídla, která patří jen do menu, se posílají jako menuArtikelen. Starý e-shop bez výběru: menu se na účtence objeví jako běžný produkt, jako dříve.
• Došlé zásoby = vyprodáno, také možnosti výběru se surovinou, která došla.
• Alergeny: vypnuté na pokladně = nejsou v e-shopu.
• Zákaznická karta: host může při placení sbírat body (na telefonní číslo nebo e-mail); pokladna přiřadí zákazníka k objednávce, body se připíší při zaplacení (uplatnění probíhá v provozovně). E-shop zobrazuje zůstatek.
• Dárkové poukazy (Nastavení → Provozovna → Dárkové poukazy → Prodávat dárkové poukazy v e-shopu, jen se zůstatkem): host koupí poukaz a zaplatí online; pokladna vytvoří poukaz, který je hned aktivní, a kód jde přes portál zpět do e-shopu (stav a e-mail). Je-li zapnutý také Dárkový poukaz jako způsob platby, může host při vyzvednutí s sebou zvolit "dárkovým poukazem v provozovně".
• Slevové kódy (Nastavení → Slevové kódy, s přepínačem v Provozovna): u každého kódu na pokladně a/nebo v e-shopu; použití se počítá společně pro obojí.
• Pauza a vytížení: tlačítko E-shop v horní liště: Pozastavit e-shop (s textem pro hosta) a Vytížení (minuty navíc). Do e-shopu se dostane během několika sekund.
• Online rezervace podle pravidel pokladny (Nastavení → Provozovna → Rezervace): nejvýše osob, dní předem, časový slot, minimálně předem a časy pro každý den v týdnu.
• Rozvoz a časové úseky: viz E-shop se řídí pokladnou v části Rozvoz a časové úseky.
• All-you-can-eat u stolu (Nastavení → Podnik → All-you-can-eat → Také při objednávání u stolu přes QR kód): běží-li u stolu balíček, vidí host pokrmy z balíčku jako V ceně za € 0, s koly, maximem na osobu, čekací dobou a časovým limitem. Zbytek platí normálně; vše jde na účet stolu. Pokud se stav u stolu právě změnil, pokladna objednávku odmítne a host objedná znovu.
• Na fakturu (Nastavení → Faktury → Platba na fakturu → Také v e-shopu): viz V e-shopu v části Platba na fakturu.
• Online do pořadníku (Nastavení → Podnik → Pořadník): viz Online do pořadníku v části Pořadník pro hosty bez rezervace.
• Doprodej: "Ještě něco k tomu?" (volitelné, standardně vypnuto; Nastavení → Provozovna → Zaplatit → Doprodej v e-shopu): vyberte skupiny produktů (např. nápoje, omáčky, dezerty) a kolik návrhů. V e-shopu se pak u košíku a při placení zobrazí produkty z těchto skupin, které ještě nejsou v košíku (jen to, co je právě v prodeji, nevyprodané a bez povinných voleb); host je přidá jedním klepnutím. Žádné skupiny nevybrány = vypnuto, jako dříve. Kiosek má vlastní doprodej (viz Samoobslužný kiosek).

Menu pro e-shop má k tomu versie: 2 s poli menuArtikelen, allergenenAan, happyhours, menus, klantenkaart, cadeaubon, kortingscodes, pauze, drukteMin, volgt, bezetting, reserveren.online, ayce, opRekening, wachtlijst a upsell. Potvrzení portálu obsahuje navíc cadeaubonnen (kódy), klant (body) a plek (pořadník).

Počty ve správním portálu. S sebou a rozvoz přes e-shop se počítají zvlášť (webshop, webshopGeannuleerd v verkoopTelling), v den přijetí, a nepočítají se znovu pod s sebou/rozvoz. Objednávky u stolu se počítají normálně pod stůl.

Platby kartou a terminály

Nastavení → Platby (jen správce):

• Terminály: pro každý terminál název, ID terminálu a jeho vlastní klíč API z PinPortalu (Zákazník → Upravit zákazníka → Ostatní → API Keys). Po uložení zůstane viditelný jen konec klíče; do prohlížeče se nikdy neposílá zpět. Tlačítkem Otestovat spojení zkontrolujete klíč a terminál.
• Testovací režim: simuluje terminál (uspěje asi po 7 s; částka končící na 13 centů je zamítnuta). Praktické pro testování bez platebního terminálu.

Pokud existuje alespoň jeden terminál s klíčem API (nebo je zapnutý testovací režim), Zaplatit → Karta / Bancontact automaticky spustí platbu na terminálu, na částku spočítanou serverem.

Dokud je propojení zapnuté, server přijme "kartu" jen s úspěšnou platbou na terminálu přesně pro tuto objednávku a tuto částku. Požadavky se posílají jako běžný formulář, stejně jako v oficiálním PHP SDK, se záložním API (api-backup.pinvandaag.com), pokud hlavní API neodpovídá. Každá odpověď API se v okně serveru zobrazí s [pin], což se hodí při řešení problémů. Úspěšná platba, která ještě nebyla zpracována (např. spadl tablet), se znovu najde při dalším placení této objednávky.

Spropitné (karta, hotovost a dárkový poukaz)

Obrazovka placení ukazuje u každého způsobu platby řadu tlačítek spropitného: Žádné, 5%, 10%, 15% (zaokrouhleno nahoru na 10 centů), Zaokrouhlit (na další celé euro) a Jiná částka. Kartou zaplatí zákazník částku + spropitné najednou na terminálu; v hotovosti je spropitné zahrnuto ve vrácených penězích a v pokladní zásuvce. Účtenka ukazuje částku kartou s "z toho spropitné" pod ní; CELKEM a DPH zůstávají stejné, protože spropitné není obrat. V přehledu X/Z je spropitné uvedeno podle způsobu platby a jako "Spropitné celkem".

Tlačítka spropitného nastavuje správce v Nastavení → Podnik → Spropitné: zapnuto/vypnuto, která procenta (nejvýše 4, např. "5, 10, 15"), zda je zahrnuto tlačítko "Zaokrouhlit" a pro které způsoby platby (karta, hotovost, dárkový poukaz) je spropitné možné. "Žádné" a "Jiná částka" jsou vždy k dispozici.

"Udělejte z toho …" je vždy k dispozici, u každého způsobu platby, i když jsou tlačítka spropitného vypnutá (žádné nastavení): zákazník sám zaokrouhlí účet nahoru a rozdíl je spropitné. Jsou tu tlačítka s dalším celým eurem a dalšími kulatými částkami (např. € 28,00 → 29, 30, 40; € 44,00 → 45, 50, 60) a Jiný součet pro zadání součtu vlastní rukou. Opětovné klepnutí na zvolené tlačítko = bez zaokrouhlení. Nejvýše € 500 spropitného (stejný limit jako pokladní server).

Bez internetu

Pokladna funguje v místní síti a internet nepotřebuje; ten potřebují jen platby kartou přes propojení. Pokud podnik nemá internet, horní lišta ukazuje Bez internetu · karta ručně (kontroluje se každou minutu). Obrazovka placení pak ukazuje, i po neúspěšném spuštění na terminálu, tlačítko Již zaplaceno na terminálu: přijměte platbu kartou na samotném terminálu a zaznamenejte ji tímto způsobem.

Plánky a stoly

Nastavení → Plánky (jen správce):

• Přidávejte plánky (např. Restaurace, Terasa, Zimní zahrada), přejmenovávejte, mažte a měňte jejich pořadí pomocí ◀ ▶.
• Stoly přidáte tlačítky nad mřížkou (kulatý, čtvercový, dlouhý, barový stůl) a přetáhnete je na místo myší nebo prstem. Modrým rohem vybraného stolu jej zvětšíte nebo zmenšíte.
• U každého stolu nastavte název/číslo, počet míst (počítají se židle kolem stolu) a tvar; duplikovat nebo smazat.
• Klávesnicí: šipky posouvají (Shift = větší krok), Delete maže.
• Změny platí až po Uložit; "Zpět" vrátí vše do původního stavu.
• Stůl nebo plánek s otevřenou objednávkou nelze odstranit. Smazané stoly zůstávají zachovány ve starých objednávkách.

Kopírování konfigurace do druhé provozovny

Nastavení → Import/export (jen správce). Jakmile máte jeden podnik zcela nastavený, exportujte konfiguraci do souboru .json a importujte ji do pokladny druhého podniku. U každé části můžete zvolit:

• Produkty: skupiny, produkty, ceny (i podle způsobu výdeje), DPH, možnosti, menu, happy hours (se sezónou), části dne, alergeny, suroviny/recepty, razítkové karty, balíčky all-you-can-eat a fotky produktů.
• Plánky: prostory a stoly.
• Ostatní nastavení: všechny možnosti podniku, tiskárny (bez IP adresy), oprávnění podle role a účetnictví.

Nikdy se nepřenáší: název, adresa, PSČ, město, telefon, e-mail, DIČ a patička účtenky podniku, e-mailová adresa pro Z-zprávu, platební terminály a jejich klíče, zaměstnanci a PINy a veškerý obrat, účtenky, zákazníci a stavy zásob.

Import je silně chráněn: velké červené varování, zaškrtávací políčko "Rozumím...", znovu vlastní PIN správce, žádné otevřené objednávky, stejná země (sazby DPH) a předem automatická záloha. Import proběhne v jediné transakci: pokud se něco pokazí, nic se nezmění. Stávající produkty, skupiny, suroviny a stoly se nevymažou, ale odeberou z pokladny (jako u Smazat), takže staré účtenky a přehledy zůstanou správné.

Import z jiné pokladny

Přechod bez přepisování všeho. Vždy k dispozici (bez přepínače): v Nastavení → Import/export (jen správce) je část Import z jiné pokladny.

• Co: produkty (název, cena vč. DPH, DPH, skupina, kód/PLU, zásoby) nebo zákazníci zákaznické karty (jméno, telefon, e-mail, body, adresa, PSČ, město; jméno a příjmení se spojí).
• Soubor: export z vaší předchozí pokladny (Dobizzz/DoPos, Lightspeed, MplusKASSA, unTill, Tebi ...) nebo vlastní seznam: CSV (; , tabulátor nebo |; UTF-8 nebo nizozemský Excel) nebo Excel (.xlsx), první list, s názvy sloupců na prvním řádku. Starý soubor .xls nejdřív uložte jako .xlsx nebo CSV.
• Náhled: pokladna pozná sloupce podle názvu (Omschrijving, Verkoopprijs incl. BTW, BTW %, Omzetgroep, Artikelnummer, GSM, Spaarpunten ...) a ukáže prvních 10 řádků. Pokud sloupec nesedí, vyberte ho sami. Nic se nezmění až do Importovat.
• Produkty: ceny jako 3,50, € 3,50 nebo 1.234,50; DPH jako 21, 9%, 0,09, vysoká nebo nízká (neznámá nebo prázdná: sazba, kterou zvolíte, ve výchozím stavu nejvyšší). Skupiny produktů, které ještě neexistují, se vytvoří (bez skupiny: "Importováno").
• Zásoby (sloupec Voorraad, Stock, Aantal ...): je-li zapnuto Sledovat zásoby (Nastavení → Podnik), produkt sleduje zásoby a zásoba se nastaví na tento počet (inventura v historii zásob, důvod "Importováno"). Prázdné: zásoba zůstane, jak je.
• Vzorový soubor (CSV): seznam k vlastnímu vyplnění (Naam;Productgroep;Prijs;Btw;Voorraad;Code), například v Excelu.
• Zákazníci: body se přičtou jako oprava "Importováno z jiné pokladny" (vidět v historii). Souhlas pro SMS nebo e-mail se nepřenáší (GDPR): o ten požádejte znovu. Nejdřív zapněte zákaznickou kartu.
• Stávající produkty (stejný kód, nebo bez kódu stejný název) a zákazníci (stejný telefon nebo e-mail) se přeskočí, nebo aktualizují, pokud to zaškrtnete (u produktů název, cena, DPH, skupina a zásoby). Duplicitní řádky v souboru se vezmou jen jednou.
• Na konci: kolik je nových, aktualizovaných a přeskočených, u každého řádku s tím, co nesedělo (např. chybí cena). Nejvýše 5000 řádků najednou. V protokolu je to jako "Konfigurace importována".

Jazyky (42, mimo jiné turečtina, arabština, darija, berberština, polština, bulharština, maďarština, ruština, srbština, albánština, perština, tigriňa, amharština, somálština, papiamento, sranan tongo, hindština, urdština, indonéština, vietnamština, syrská aramejština, čínština a ukrajinština)

Vedle tlačítka © vpravo dole má každá obrazovka tlačítko jazyka (např. NL a vlajka). Klepnutím otevřete nabídku: jazyky jsou v abecedním pořadí, s názvem v daném jazyce před vlajkou: Bahasa Indonesia (indonéština), Čeština, Darija (marocká arabština v latince), Deutsch (němčina), English (angličtina), Español (španělština), Français (francouzština), Hrvatski (chorvatština), Italiano (italština), Kurdî (Kurmancî) (kurdština kurmándží), Latviešu (lotyština), Lietuvių (litevština), Magyar (maďarština), Nederlands (nizozemština), Papiamentu (papiamento), Polski (polština), Português (portugalština), Română (rumunština), Shqip (albánština), Slovenčina (slovenština), Soomaali (somálština), Sranantongo (sranan tongo), Srpski (srbština, v latince), Tarifit (rífská berberština), Tiếng Việt (vietnamština), Türkçe (turečtina), pak v cyrilici Български (bulharština), Русский (ruština) a Українська (ukrajinština), pak jazyky v arabském písmu: اردو (urdština), الدارجة (darija), العربية (arabština), دری (darí), فارسی (perština, fársí), پښتو (paštština) a کوردی (سۆرانی) (kurdština sorání), pak v syrském písmu ܣܘܪܝܝܐ (syrská aramejština, Suryoyo), v písmu dévanágarí हिन्दी (hindština), v písmu ge'ez ትግርኛ (tigriňa) a አማርኛ (amharština), v písmu tifinagh ⵜⴰⵎⴰⵣⵉⵖⵜ (tamazight, berberština), a nakonec 中文（简体）(čínština, zjednodušené písmo). Všechny obrazovky, tlačítka, hlášení a chybová hlášení pokladního serveru jsou přeložené.

• Podle zaměstnance: zvolený jazyk se ukládá u přihlášeného zaměstnance (gebruiker.taal). Když se přihlásí někdo s jiným jazykem, pokladna se okamžitě přepne. Samotné zařízení si pamatuje naposledy použitý jazyk, takže obrazovka PIN je už v tomto jazyce. Pokud zvolíte jazyk (na obrazovce PIN nebo po přihlášení) a do 10 minut se (znovu) přihlásíte, má tato volba přednost a stane se jazykem tohoto zaměstnance. Přepnutí znovu načte obrazovku; zůstanete přihlášeni a otevřený účet zůstane otevřený.
• Poprvé na zařízení: pokud tablet nebo PC ještě nemá nastavený jazyk, pokladna se spustí v jazyce zvoleném při instalaci. Pokud žádný jazyk zvolen nebyl, použije jazyk samotného zařízení (prohlížeče nebo operačního systému, i v aplikaci pro Android), a pokud mezi nimi není, nizozemštinu. Poté si každé zařízení pamatuje svou vlastní volbu.
• Východní Evropa: polština, čeština, slovenština, maďarština, rumunština, bulharština, chorvatština (i pro bosenštinu), litevština, lotyština, ukrajinština a ruština: jazyky většiny pracovních migrantů ze střední a východní Evropy v Nizozemsku a Belgii.
• Balkán: srbština (v latince, jak ji píše většina Srbů v Nizozemsku a Belgii; také pro černohorštinu) a albánština (Albánie, Kosovo a Severní Makedonie).
• Africký roh: tigriňa (Eritrea) a amharština (Etiopie), obě v písmu ge'ez, a somálština (v latince).
• Írán: perština (fársí). Zařízení nastavené na perštinu Afghánistánu (fa-AF) dostane darí, ostatní fársí.
• Karibské Nizozemsko a Surinam: papiamento (Papiamentu, pravopis Curaçaa a Bonairu; i pro Arubu) a sranan tongo.
• Asie: hindština (dévanágarí; i pro sarnámí hindustání), urdština (zprava doleva), indonéština a vietnamština (latinka, i na účtence).
• Marocké jazyky: darija (marocká arabština, hovorový jazyk) v arabském písmu i v latince (tak, jak ji mnoho Nizozemců marockého původu píše ve zprávách), vedle spisovné arabštiny. Berberština: tarifit (rífština, v latince; většina Nizozemců marockého původu pochází z Rífu) a standardní marocký tamazight v písmu tifinagh.
• Zprava doleva: arabština (spisovná arabština), urdština, darija v arabském písmu, darí a paštština (Afghánistán), perština (fársí, Írán), kurdština sorání (Irák/Írán) a syrská aramejština (Suryoyo, v syrském písmu). Částky, kódy a číselná tlačítka zůstávají zleva doprava. Kurdština kurmándží (Turecko/Sýrie) je v latince.
• Kuchyňský lístek (kuchyně/bar): ve výchozím nastavení v jazyce zaměstnance, který objednávku zadává. Pro každou tiskárnu lze v Nastavení → Tiskárny → Jazyk kuchyňského lístku nastavit i pevný jazyk (např. jazyk kuchaře), v latince: Nederlands, Čeština, Darija, Deutsch, English, Español, Français, Hrvatski, Italiano, Kurdî, Latviešu, Lietuvių, Magyar, Papiamentu, Polski, Português, Română, Shqip, Slovenčina, Soomaali, Sranantongo, Srpski, Tarifit, Tiếng Việt, Bahasa Indonesia nebo Türkçe. Bulharština, ruština a ukrajinština se na kuchyňský lístek tisknou v latinkovém přepisu (tiskárna účtenek nezná cyrilici). Arabské, syrské písmo, písmo dévanágarí, písmo ge'ez a písmo tifinagh a čínštinu nelze tisknout na tiskárně účtenek: darija se pak vytiskne latinkou, tamazight jako tarifit a ostatní v nizozemštině. Pevné texty (STŮL, Chod, ČEKÁ na vyvolání, VYVOLAT CHOD, VYTIŠTĚNO POZDĚJI, S sebou, Pult) jsou přeložené; názvy produktů a poznámky zůstávají tak, jak byly zadány. Tiskárny, které měly nastavenou nizozemštinu, se řídí zaměstnancem.
• Účtenka (pro všechny zákazníky): ve výchozím nastavení v nizozemštině, nezávisle na jazyku obrazovek. Jiný jazyk zvolíte v Nastavení → Podnik → Jazyk účtenky (hned pod textem dole na účtence), jen jazyky v latince. Platí to i pro proforma účet, vratku, kopii, dárkový poukaz a účtenku e-mailem. Částky, kódy DPH, DIČ podniku a fiskální řádky (Belgie) zůstávají stejné; vlastní text dole na účtence zůstane tak, jak ho podnik napíše.
• Produkty, skupiny a možnosti se jmenují tak, jak je podnik zadá; nepřekládají se.
• Jazyk můžete pro každého zaměstnance nastavit také v Nastavení → Zaměstnanci.
• Představení a příručka jsou rovněž k dispozici ve všech těchto jazycích. Tlačítko © je otevře v jazyce pokladny; nahoře můžete vlajkami zvolit jiný jazyk (v pokladně to nic nemění).

Pro vývojáře: každý viditelný text je v kódu jako vt('Nederlandse tekst') (apps/pos-web/lib/i18n.ts); nizozemský text je klíčem. Překlady jsou v apps/pos-web/lib/vertalingen/<taal>.ts. Pokud překlad chybí, pokladna ukáže nizozemštinu; test i18n (pos-web) kontroluje, že je každý text přeložen do každého jazyka a že zástupné symboly {0} souhlasí. Hlášení pokladního serveru zůstávají v nizozemštině a překládají se v prohlížeči (také s {0}, např. název produktu ve zprávě).

Nastavení tiskáren

Nová pokladna nemá žádné tiskárny. Přihlaste se jako správce (demo: 1111) a v horní liště zvolte Nastavení.

• Tiskárny: přidejte tolik tiskáren, kolik jich podnik má (např. pokladna, kuchyně, bar, pizza), každou s připojením (obvykle síť: IP adresa a port 9100) a šířkou papíru. Tlačítkem Zkušební tisk ověříte, že funguje. Nahoře zvolíte, která tiskárna tiskne účtenku a proforma účet (a otevírá pokladní zásuvku). U každé tiskárny zvolíte také jazyk kuchyňského lístku (viz Jazyky); účtenka zůstává v nizozemštině.
• Připojení pro každou tiskárnu:
  • Síť (IP adresa): IP adresa a port (obvykle 9100). Tak to fungovalo vždy a tak to fungovat bude i dál: stávající tiskárny jsou automaticky nastaveny na síť.
  • USB: v Linuxu zařízení, například /dev/usb/lp0. Na Androidu USB tiskárna připojená k zařízení (kabel OTG; prázdné = první USB tiskárna). Ve Windows a macOS zvolte Systémová tiskárna.
  • Sériová (COM / ttyUSB): COM port (Windows), /dev/ttyUSB0 nebo /dev/ttyS0 (Linux, Android) nebo /dev/cu.… (macOS), s rychlostí (obvykle 9600, 19200 nebo 38400 baudů). Také pro tiskárnu Bluetooth, kterou Windows nebo Linux připojí jako COM port nebo /dev/rfcomm0.
  • Bluetooth: v aplikaci HorecaPOS na Androidu, s adresou Bluetooth spárované tiskárny (např. mobilní tiskárny účtenek). Nejprve tiskárnu spárujte v nastavení Bluetooth v Androidu.
  • Systémová tiskárna (Windows / CUPS): tiskárna tak, jak ji zná Windows nebo CUPS (Linux, macOS), s jejím vlastním ovladačem nebo jako Generic / Text Only. Účtenka jde do tiskárny bez úprav (RAW), ovladač ji neformátuje.
  • Vestavěná (Sunmi, iMin ...): tiskárna přímo v pokladně s Androidem.
  • Hledat zobrazí tiskárny a porty, které pokladna vidí. Vyberte jednu a adresa se vyplní.
• Protokol: ESC/POS (téměř všechny tiskárny účtenek, i tiskárny Star v režimu ESC/POS) nebo Star (Star Line Mode). U Star pokladna účtenku převede sama; účtenka vypadá stejně.
• Displej obsluhy s vlastní tiskárnou: displej obsluhy s Androidem a aplikací HorecaPOS (např. ruční terminál s mobilní Bluetooth tiskárnou nebo Sunmi jako displej obsluhy) může tisknout sám. Přihlaste ho přímo na daném zařízení (Nastavení → Tiskárny → Displeje obsluhy s vlastní tiskárnou) a u tiskárny zvolte Připojeno k. Displej obsluhy si své lístky stahuje z pokladny; nechte na něm aplikaci otevřenou. Pokud to nejde (aplikace zavřená, mimo dosah Wi-Fi), kuchyňský lístek se zařadí do fronty tisku, stejně jako u vypnuté síťové tiskárny. Odhlásit zařízení vrátí tiskárny zpět na samotnou pokladnu.
• Tiskárna podle kategorie / produktu: u každé skupiny produktů zvolte, na kterou tiskárnu jde kuchyňský lístek. U produktu to můžete přepsat vlastní tiskárnou nebo "bez kuchyňského lístku".

Stejné produkty se při tisku slučují: dvakrát 1x Cola se stane 2x Cola, na kuchyňském lístku i na účtence. Slučují se jen produkty se stejnými možnostmi a poznámkou.

Instalátor pro Linux přidá uživatele pokladny do skupin lp a dialout, aby pokladna mohla používat USB a sériové tiskárny.

Potřebujete pomoc?

Optimum POS · 085 560 00 60 · support@optimumpos.nl · Po–Pá 9:00–20:00, So–Ne 14:00–20:00