HorecaPOS kézikönyv

Ez a kézikönyv három részből áll: először a személyzetnek (kiszolgálás), aztán a menedzsernek, végül az adminisztrátornak. Minden rész az előzőre épül: a menedzser mindent megtehet, amit a kiszolgálók, az adminisztrátor pedig mindent.

Hogy pontosan mit tehet a szerepköröd, azt az adminisztrátor állítja be itt: Beállítások → Jogosultságok. Ha nem látsz egy gombot, a szerepkörödnek ott (még) nincs rá jogosultsága.

Ez a kézikönyv a kasszában is megtalálható: koppints a ©-gombra bármelyik képernyő jobb alsó sarkában, és válaszd a Kézikönyv lehetőséget, vagy nyisd meg ezt: http://<kassa-pc>:3000/handleiding. Lásd még a bevezetést és az API-dokumentációt.

1. rész · Személyzet

Első lépések

Bejelentkezés. Nyisd meg a kasszát a kasszagépen, tableten vagy telefonon, és írd be a PIN-kódodat (4–8 számjegy). Ezután megjelenik az asztaltérkép.

Asztal megnyitása. Koppints egy asztalra. Egy szabad asztal új rendelést kap; egy foglalt asztalnál a már meglévő rendeléssel folytatod. Felül válthatsz a termek között (például Terem és Terasz). A pulthoz a Gyors eladás, elviteles rendelésekhez az Elvitel funkciót használd.

Rendelés. Válassz egy termékcsoportot, és koppints a termékekre. Ezek bal oldalt a blokkra kerülnek. Ha kell, előbb válaszd ki a fogást (1 = azonnal, a 2 és a 3 várnak, amíg le nem hívod őket). Koppints a Rendelés gombra: ekkor a konyhai bonok a konyhára és a pultra mennek. Amíg nem koppintottál a Rendelés gombra, a tételeket egyszerűen törölheted.

Fizetés. Koppints a Fizetés gombra, válaszd a Kártya / Bancontact, a Készpénz vagy az Ajándékutalvány lehetőséget, adj meg borravalót, ha van, és erősítsd meg. Kártyás fizetésnél a fizetés magától elindul a kártyaterminálon. A blokk kinyomtatódik; e-mailben is elküldheted.

Kijelentkezés. Jelentkezz ki, ha végeztél, hogy senki más ne dolgozhasson a nevedben. 8 óra után automatikusan kijelentkeztet a rendszer.

Nincs internet? A kassza ugyanúgy tovább működik. Ha felül ez látszik: Nincs internet · kézi kártyás fizetés, akkor üsd be az összeget magán a kártyaterminálon, és a fizetési képernyőn válaszd a Már kifizetve a terminálon lehetőséget.

Több csoport egy asztalnál

Egy asztalnál több csoport is ülhet, mindegyik saját számlával és saját blokkal.

• Koppints egy asztalra: szabad = új rendelés; egy csoport = rögtön az a csoport; több csoport = előbb válassz, vagy + Új csoport (a név üresen hagyható).
• A rendelési képernyő tetején van a csoportsáv: váltás a csoportok között, + Csoport, Csoport neve (pl. "Kovács") és Felosztás / áthelyezés.
• Felosztás / áthelyezés: tételenként válaszd ki, hány darab menjen át (pl. 3× Pils esetén 1) és melyik csoportba, vagy hozz létre új csoportot. Így áthelyezheted, ami rossz számlára került, vagy utólag feloszthatod, hogy "mindenki a saját részét fizesse". Ha egy csoport kiürül, megszűnik.
• Több rész egyszerre: a + Még egy rész gombbal előkészítesz egy részt, és kiválasztod a következőt (pl. a hal és egy Dry Martini a(z) 2. asztalhoz, a többi a(z) 35. asztalhoz). Egy rész a + Másik asztal gombbal is mehet (ott új csoportként). Az Áthelyezés gombbal minden egyszerre megy. A ½ kettéosztja a tételt, egy fél üveget is (0,667 helyett 2 × 0,3335).
• Összevonás: egy vagy több másik asztal (vagy ennél az asztalnál lévő csoport) összes tétele erre a számlára, egyszerre.
• Belgium: az egyszerre végzett felosztás vagy összevonás a fekete dobozban egyetlen asztalváltás, ahogy a FÁSZ Pénzügy előírja (UC242, UC251, UC252, UC4119bis). Ha rendelés után törölnek valamit, vagy egy már megrendelt tételre kedvezmény kerül, az az asztal következő üzenetével megy (rendelés, előzetes számla, asztalváltás), különben az eladással: a régi tétel negatívan, az új pozitívan (UC226, UC4102, UC4104, UC4107, UC4110).
• Az asztaltérképen egy narancssárga pötty mutatja, hány csoport van; az összeg az összes csoport végösszege.
• A blokkon és a konyhai bonon ez áll: "Asztal 5 - csoport 2" vagy "Asztal 5 - Kovács".

Számla megosztása fizetéskor

A fizetés a szokásos módon működik: Egyszerre minden. A fizetési képernyőn a számla most már fel is osztható, a Vissza és a Fizetés alatti gombokkal (így ezek mindig láthatók maradnak, görgetés nélkül):

• Egyenlő elosztás: a − és + gombbal válassza ki, hány főre (alapértelmezés a vendégek száma, vagy 2, ha a kassza nem tartja nyilván a vendégeket). A képernyő a fejenkénti összeget mutatja; mindenki kártyával, készpénzzel vagy ajándékutalvánnyal fizeti a részét (igény szerint borravalóval). Minden rész után visszaszámol ("még 3 fő"); az utolsó pontosan a maradékot fizeti.
• Egyéni összeg: valaki egy fix összeget fizet (pl. € 20); a többi nyitva marad.
• Termékenként…: megnyitja a Felosztás / áthelyezés ablakot, hogy termékeket külön számlára tegyél, és azt külön fizettesd ki (mint fent).

A részfizetés csak a fizetést rögzíti; a számla nyitva marad, és a rendelési képernyőn ez látszik: "már kifizetve … · még nyitott …". A blokk (rajta az összes fizetéssel) az utolsó fizetéskor készül, mint a sima fizetésnél. Az integráción keresztüli kártyás fizetés pontosan a részösszegre szól. Ha már történt részfizetés, tételeket már nem lehet másik csoportba tenni és kedvezményt sem lehet adni; törölni csak akkor lehet, ha elég nyitott összeg van. Minden részfizetés bekerül a naplóba.

Gyors eladás és elvitel (asztal nélkül)

Az asztaltérkép jobb felső sarkában van a Gyors eladás és az Elvitel. Mindkettő azonnal megnyit egy asztal nélküli rendelést. A Gyors eladás pultnál történő eladás (helyben fogyasztás áfája); az Elvitel minden terméknél az elviteli áfakulcsot használja. A "Vendég neve" mezővel nevet adhatsz hozzá; ez megjelenik a blokkon ("Elvitel – Kovács") és a konyhai bon tetején. A nyitott, asztal nélküli rendelések a teremgombok alatt láthatók ("Asztal nélkül: Elvitel #12 – Kovács"), így megtalálod őket. Ha eladás nélkül lépsz vissza, az üres rendelés magától eltűnik.

Mindkét gomb üzletenként be- vagy kikapcsolható a Beállítások → Üzlet alatt, közvetlenül a világos/sötét téma alatt (alapból be). Ki = a gomb rejtett; a már nyitott, asztal nélküli rendelések láthatók maradnak.

Kiszállítás és idősávok

Azok a rendelések, amelyeket közvetlenül a kasszánál veszel fel, például telefonon vagy a pultnál, ugyanazokkal a szabályokkal, mint a webshopban: kiszállítási területek és idősávonként maximális rendelésszám. Bekapcsolás: Beállítások → Üzlet → Kiszállítás és idősávok, közvetlenül a Gyors eladás és az Elvitel gombok alatt (alapból ki).

• Kiszállítás gomb az asztaltérképen (az Elvitel mellett): add meg a nevet, a telefonszámot és a címet (bekapcsolt Gyors címbevitel esetén: keresés irányítószám és házszám alapján). A kassza megkeresi a kiszállítási területet, és mutatja a kiszállítási díjat, a minimumot és az "ingyenes ettől" határt. Ha a cím a területeken kívül esik, a rendelés nem lehetséges.
• Kiszállítási területek: irányítószám alapján (tartományok és egyedi irányítószámok, pl. 5000-5049, 5051, 5052 AB), az üzlettől számított, km-ben megadott sugáron belül (légvonalban) vagy egy saját magad által berajzolt terület a térképen. A sugár és a terület csak holland címekkel működik (hely a PDOK-on keresztül). Területenként: kiszállítási díj, minimum, ingyenes ettől és extra percek; fentről az első illeszkedő terület érvényes, így a típusok kombinálhatók (pl. először néhány irányítószám, aztán egy terület, majd egy sugár a többire). Nincs beállított terület = kiszállítás mindenhová, díj és minimum nélkül. A webshop területeit külön állítod be (webshopkezelő).
• Terület a térképen: egy kiszállítási területnél válaszd a Terület a térképen típust, majd a Rajzolás a térképen lehetőséget. Kattints a térképre pontok elhelyezéséhez (legalább 3); húzz egy pontot az áthelyezéséhez, kattints egy pontra a törléséhez, és húzd az él közepén lévő pöttyöt egy köztes ponthoz. A térkép a sugár alapú területeket és az üzletet is mutatja. A térképcsempék az OpenStreetMapről származnak, ezért a térképhez internet kell; magához a kiszállításhoz nem (kivéve a cím megkeresését). Ha a címet nem sikerül megkeresni, a kassza ezt jelzi a "kiszállítási területeken kívül" helyett.
• A kiszállítási díj "Bezorgkosten" tételként szerepel a rendelésen, és minden módosítás után újraszámolódik (ingyenes ettől, nincs termék = nincs díj), amíg még semmi nincs kifizetve. A minimum alatt nem lehet fizetni; a rendelési képernyő mutatja, mennyi hiányzik még, a Mégis elvitel gombbal (a kiszállítási díj és a minimum megszűnik).
• Idő: Amint lehet (most + kiszállítási idő, plusz a terület extra percei) vagy egy mai idősáv. Ha a Thuisbezorgd-nál nyitvatartás van beállítva, az itt is érvényes.
• Maximum idősávonként (0 = nincs maximum; idősáv 5–60 perc): az Elvitelre és a Kiszállításra együtt; a kasszában lévő webshopos rendelések is beleszámítanak. Ha van maximum, az Elvitel is időpontot kér, és a betelt idősávok nem választhatók. Ha két kassza egyszerre kéri az utolsó helyet: csak az egyik kapja meg.
• A konyhai bonon szerepel a cím, a név, a telefonszám és az idő; az "Asztal nélkül" listában és a konyhai bon tetején pl. "Kiszállítás – 18:30 Kovács".

Bővítések (alapból mind ki; e beállítások nélkül minden pontosan úgy működik, mint fent):

• Külön nyitvatartás elvitelhez és kiszállításhoz (a hét minden napjára, pl. 16:00-21:00 vagy 11:30-14:00, 17:00-22:00; éjfél után is lehet: 17:00-01:00; üres = aznap zárva). Ki = mint korábban (a Thuisbezorgd időpontjai, ha vannak, különben egész nap).
• Zárva tartó napok (pl. 25-12-2026, 26-12-2026): ilyenkor nincs elvitel és kiszállítás.
• Előrendelés: 0 (csak ma, mint korábban) és 14 nap között. A Kiszállítás/Elvitel ablakban ilyenkor először a napot választod ki; egy későbbi nap az időpont előtt szerepel a munkajegyen.
• Nagy forgalom: ennyi extra perc az "amint lehet" opciónál (kasszában és webshopban is). Gyorsan beállítható a felső sáv Webshop gombjával is.
• Belga címek (4 jegyű irányítószám): sugár vagy térképen rajzolt terület esetén a kassza az OpenStreetMap segítségével keresi meg a helyet (Nominatim; utca és település szükséges).
• A webshop a kasszát követi: a kassza az irányadó. A webshop ilyenkor a kassza kiszállítási területeit, kiszállítási és elviteli idejét, idősávját, idősávonkénti maximumát, nyitvatartását (ha itt be van állítva), zárva tartó napjait és előrendelési napjait használja, és a kasszán felvett rendeléseket is beszámítja az idősávba. Ki = a webshopnak saját beállításai vannak (webshopkezelő), mint korábban. Az elvitel/kiszállítás be- vagy kikapcsolása továbbra is a webshopnál marad.

Kód: lib/bezorgen.ts, routes/bezorgen.ts, BezorgDialoog.tsx, BezorgInstellingen.tsx, BezorgKaart.tsx és lib/kaart.ts (a térkép, extra csomag nélkül; ugyanez a kód public/kaart.js néven megtalálható a webshopban).

Telefónia: a vendég felismerése telefonos rendelésnél

Beállítások → Telefónia (alapból ki; kikapcsoláskor minden megmarad). Két külön kapcsoló:

• Vendég keresése telefonszám alapján kiszállításnál és elvitelnél: ha beüti a számot a kiszállítási képernyőn, a kassza megmutatja a vendéget a címmel és a korábbi rendelésekkel; az Adatok átvétele kitölti a nevet, az e-mailt és a címet. Telefonközpont nélkül is működik.
• Hívóazonosítás: ha egy vendég telefonál, a központ (vagy az asztali telefon, a FRITZ!Box, a modem vagy az Android-telefon) jelenti a számot. A képernyőkön értesítés jelenik meg arról, ki hív: név, cím, a legutóbbi rendelések (az ételekkel és az összeggel, a webshopból, a Thuisbezorgdtól és a kiszállítási platformokról is), a végösszeg és egy foglalás. A Kiszállításos rendelés felvétele vagy az Elviteles rendelés felvétele megnyitja a kiszállítási képernyőt mindennel kitöltve (bekapcsolt kiszállítással és idősávokkal); a rendelés a híváshoz kerül, és az értesítés minden képernyőről eltűnik. A felső sávban a 📞 gomb: az utolsó 24 óra hívásai. Képernyőnként kikapcsolható (Értesítések megjelenítése ezen a képernyőn).

A keresés kiterjed a törzsvásárlói kártyára, a kassza kiszállításos és elviteles rendeléseire, a webshopra, a Thuisbezorgdra, a kiszállítási platformokra és a foglalásokra. A számokat egységesíti (+31 6 1234 5678, 0031612345678 és 06-12345678 ugyanaz; belga számok is).

Hogyan érkezik a szám (több egyszerre is lehet; ugyanaz a hívás egyszer számít):

A válasz tartalmazza a hívót, contact formában is (firstname, lastname, phone, email, address) a 3CX CRM-sablonjához. A kimenő és belső hívások nem jelennek meg; a Csak ezek a vonalak bizonyos vonalakra vagy telefonokra korlátoz. A hívások a megőrzési idő után törlődnek (alapértelmezetten 30 nap, GDPR). A Teszthívás egy szám hívását szimulálja.

Kód: apps/pos-server/src/lib/telefonie.ts, routes/telefonie.ts, packages/shared/src/telefonie.ts; képernyők Telefonie.tsx, BezorgDialoog.tsx; Android android-app/native/java/Beller*.java. Napló: Telefónia.

Saját futárok: körök, pénzleadás és nyomkövetés (track & trace)

Saját futárokkal dolgozó üzleteknek. Kapcsold be itt: Beállítások → Üzlet → Kiszállítás → Saját futárok (alapból ki). A futárnak nem kell app: a futár a saját telefonja böngészőjében egy oldalt használ (aki szeretné, használhatja az Optimum Bezorger appot: lásd lent a Futáralkalmazás részt).

Kör létrehozása. A kasszában ott a Körök gomb (a még elküldendő kiszállítások számával, plusz az úton lévő körökkel).

1. A Kiszállításra kész résznél jelöld be a rendeléseket, amelyek mennek. Ezek a kassza, a webshop és a Thuisbezorgd kiszállítandó rendelései (csak saját kiszállítás; a Thuisbezorgd futárjával szállítottak nem).
2. Válaszd ki a futárt (egy munkatárs) és a vitt váltópénzt (alapból a beállításban megadott összeg), majd koppints a Kör létrehozása gombra.
3. Megjelenik egy QR-kód. A futár beolvassa a saját telefonjával, és címenként látja a nevet, a címet egy Útvonal (navigáció) gombbal, a Hívás gombot, a megjegyzést, a kért időpontot és a beszedendő összeget. Van váltópénz-kalkulátor is (az ügyfél ad € 50 → vissza € 31,50). Bejelentkezés nem kell. A linket csak a futárral oszd meg: akinél megvan, látja a kör címeit. A QR-kód a futárnak gombbal új linket készítesz; a régi ezután nem működik.
4. Koppints az Indulás gombra, amikor a futár elmegy. A váltópénz kikerül a fiókból (pénzkivét, okkal). Az ügyfél értesítést kap, hogy a rendelése úton van:
   • kasszás rendelésnél SMS-ben és/vagy e-mailben, ha az Üzenetek az ügyfélnek be van kapcsolva (lásd Kiszállítás és idősávok);
   • webshopos rendelésnél a webshop beállítása szerint (e-mail, SMS vagy push értesítés);
   • Thuisbezorgd-rendelésnél a Thuisbezorgd útján.

Ha a kör még nem indult el, még törölhető.

1. Útközben a futár címenként a Kiszállítva, készpénz, a Kiszállítva, kártya (saját kártyaterminál) vagy a Kiszállítva (már kifizetve) gombra koppint. A kassza ezt azonnal látja. Ha a futár nem tudja jelezni, a kasszában is megtehető. Az üzletbe visszaérve a futár a Visszaértem az üzletbe gombra koppint.

Pénzleadás. A kör után koppints az Elszámolás gombra (jogosultság: Kasszafiók kezelése):

• Rendelésenként válaszd: készpénz, kártya az ajtóban, már kifizetve vagy nem kiszállítva (vissza). Amit a futár jelzett, az már ki van töltve.
• A kassza minden nyitott összegű rendelést új nyugta nélkül számol el (az ügyfélnél már ott a nyugta; újranyomtatás a Nyugták menüben). A ki nem szállított rendelés lekerül a körről és nyitva marad, így egy következő körre kerülhet.
• Látod, mi a várt összeg: a váltópénz plusz a készpénzben kapott összeg. Add meg, mit ad le a futár, vagy számold meg címletenként (Számolás címletenként). A kassza mutatja, hogy stimmel-e, vagy mennyi a többlet, illetve a hiány.
• A váltópénz visszakerül a fiókba (pénzbetét). A különbözet a körnél és a naplóban szerepel, és kasszakülönbözetként a Z-jelentésben is megjelenik.

Nyomkövetés (track & trace) (a beállításnál külön bekapcsolható). Az ügyfél úton állapotnál linket kap a portálon lévő követőoldalra. A link az SMS-ben vagy e-mailben, a webshopban pedig az állapotoldalon (Kövesd a futárodat) található. A követőoldalon látható:

• hogy a rendelés készül, úton van vagy kiszállították;
• a várható időpont: a futár helyzetétől az előbb következő címeken át, egyébként a kért időpont;
• hány cím van még előtte (más címek megjelenítése nélkül);
• A futár élőben a térképen beállítással a futár, az üzlet és a saját cím is egy térképen (OpenStreetMap). A futár maga kapcsolja be a helyzetmegosztást a telefonján (Helyzetem megosztása). A helyzet csak addig megy, amíg az oldal nyitva van; az oldal bekapcsolva tartja a képernyőt.

Az oldalak a telefon nyelvén jelennek meg (a portál összes nyelve). A kasszában a körnél látod, mikor küldte el a futár utoljára a helyzetét (link a térképre).

Adatvédelem. A portál a kör adatait (nevek, címek, telefonszámok, helyzet) csak a kör idejére őrzi meg. Elszámoláskor minden törlődik, különben 24 óra után. Az ügyfél csak a saját rendelését látja. A futár helyzete csak a kör alatt látható, és már nem, amint a futár visszaért.

Körtervezés (opcionális)

Kapcsold be itt: Beállítások → Üzlet → Kiszállítás → Körtervezés (alapból ki; saját futárokkal működik). A Körök ablakban ekkor megjelenik a Körök javaslása gomb. A kassza a még elküldendő rendeléseket körökbe vonja össze:

• az egymáshoz közeli rendelések, amelyek kért időpontjai az időablakon belül esnek (alapból 30 perc), együtt mennek;
• legfeljebb a körönkénti címek maximális számáig (alapból 4), amíg a kör (odaút, az összes cím és vissza az üzletbe) nem tart tovább a maximumnál (alapból 45 perc);
• körönként a legjobb sorrend, a távolság (km), az oda-vissza menetidő, és címenként a várható érkezés azonnali indulás esetén. Ha ez későbbi a kért időpontnál, mellette ez áll: később a kértnél.

Az Ennek a körnek a használata gombbal ezeket a rendeléseket jelölöd be, ebben a sorrendben; válaszd ki a futárt, és koppints a Kör létrehozása gombra. Egy még el nem indult körnél a Legjobb sorrend a címeket a leggyorsabb sorrendbe teszi (a futár telefonján is). Minden körnél látszik a távolság és a menetidő.

Beállítások: címek körönként, meddig tarthat egy kör, az időablak, a futár sebessége (kerékpár ~15, robogó ~25, autó ~35 km/h városban) és a percek címenként (parkolás, csengetés, fizetés; alapértelmezés 2). Ezeket a számokat a menedzser is beállíthatja: a Körök ablakban a Körtervezés beállítása gombbal (Körtervezés beállítása jogosultság, a menedzsernél alapból bekapcsolva; módosítható: Beállítások → Jogosultságok). A körtervezés be- és kikapcsolása, valamint az útvonalszolgáltatás (cím, API-kulcs) az adminisztrátornál marad.

Távolság és menetidő, a rendszergazda választja:

• Becslés (alapértelmezett): légvonal szorozva 1,35-mal (kerülőtényező) a futár sebességével. Internet és fiók nélkül működik.
• OSRM: közúti útvonalak egy OSRM-szerveren keresztül. Add meg a címet (https://, vagy http:// a saját hálózatban). A nyilvános demószerver (https://router.project-osrm.org) csak alkalmi használatra való; napi használathoz állíts be saját OSRM-szervert, vagy válassz szolgáltatót.
• OpenRouteService: közúti útvonalak saját API-kulccsal (ingyen létrehozható az openrouteservice.org oldalon, napi korláttal). A cím alapból https://api.openrouteservice.org, és átállítható saját szerverre. A kulcs a kasszán marad; a képernyők csak azt mutatják, hogy ki van töltve.

A Tesztelés gombbal kipróbálod a szolgáltatást. Ha a szolgáltatás nem működik, a tervezés visszaáll a becslésre, és ezt jelzi is. Az a cím, amelynek helyzete nem ismert (nincs érvényes irányítószám és házszám), a javaslatban az ismert helyzet nélkül részbe kerül, és nem kerül beütemezésre. A konfigurációs export a beállításokat tartalmazza, a kulcsot nem.

Kód: lib/ritplanning.ts.

Futáralkalmazás (opcionális)

Kapcsold be itt: Beállítások → Üzlet → Kiszállítás → Futáralkalmazás (alapból ki; saját futárokkal és a kezelőportállal működik). Ekkor minden futár egyszer párosítja a saját telefonját, ahelyett hogy körönként QR-kódot olvasna be:

1. A Párosított telefonok résznél válaszd ki a futárt (egy munkatársat), adott esetben a telefon nevét, és koppints a Telefon párosítása gombra.
2. Megjelenik egy QR-kód. A futár beolvassa az Optimum Bezorger appban (Párosítás gomb), vagy a telefon kamerájával: ekkor az oldal a böngészőben nyílik meg. App nélkül is működik, és a kezdőképernyőre is kitehető.
3. A párosítás addig érvényes, amíg vissza nem vonod; a telefon ezután azonnal semmit sem lát. Ugyanannak a munkatársnak egy új párosítás felváltja a régit (például új telefonnál).

Az appban vagy az oldalon az összes saját kör látszik (minden kör, amelyet a kassza ennek a futárnak létrehoz), ugyanazokkal a gombokkal, mint egy körnél: Útvonal, Hívás, beszedendő összeg váltópénz-kalkulátorral, Kiszállítva és Visszaértem az üzletbe. Külön bekapcsolható:

• Rendelések felvétele saját maga: a futár látja azokat a kiszállításokat, amelyek még nincsenek körben, bejelöli, amit visz, és a Viszem gombra koppint. A kassza létrehozza a kört (vagy hozzáadja őket, ha a futárnak már van még el nem indult köre); a szokásos váltópénz is megy vele. Amit már más felvett, azt nem lehet.
• Indulás saját maga: az appban az Indulás ugyanazt teszi, mint a kasszán (váltópénz a fiókból, a vendégek értesítést kapnak).
• Élő térkép: a Körök résznél van a Térkép gomb az üzlettel, az összes munkában lévő futárral és a még kiszállítandó címekkel. A futár maga kapcsolja be és ki a Munkában kapcsolót. Az app kikapcsolt képernyőnél is továbbítja a helyzetet (Android: értesítés a sávban, amíg a megosztás be van kapcsolva); a weboldal csak amíg nyitva van. E beállítás nélkül a helyzet csak csomagkövetéses (track & trace) kör közben kerül megosztásra.

Az androidos app a Google Playen és a portál letöltési oldalán (/download/) érhető el. Az iPhone-verzió elkészült, de csak akkor jelenik meg, ha lesz Apple fejlesztői fiók; addig az iPhone-ok a weboldalt használják. Annál a körnél, amelyet a futár maga vett fel, ez áll: saját maga vette fel az appban.

Kód: lib/bezorgersapp.ts, a portálban src/volgen.mjs, az app pedig a horecapos-bezorger repóban.

A naplóban látható, ki hozott létre, indított el, jelzett kiszállítottnak és számolt el egy kört, az összegekkel együtt. Kikapcsolás: nincs Körök gomb; a körök és a beállítások megmaradnak.

A portálon: /bezorger/<sleutel> és /volg/<code>. Kód: lib/bezorgers.ts, routes/bezorgers.ts, Bezorgers.tsx és a portálban src/volgen.mjs.

Értesítés túl hosszú átfutási időnél

Elviteles vagy kiszállításos rendelés, amely az ígértnél később készül el: a kassza észreveszi és jelzi, és azonnal bocsánatkérést küldhet az ügyfélnek, akár jóváírási utalvánnyal. Bekapcsolás: Beállítások → Üzlet → Kiszállítás → Értesítés túl hosszú átfutási időnél (alapból ki).

• Mely rendelések: ígért idővel rendelkező elvitel és kiszállítás a kasszából (kiszállítás és idősávok), a webshopból és a Thuisbezorgd.nl / Takeaway.com oldalról.
• Késés: ennyi perccel (alapból 10) az ígért idő után még nincs kész vagy úton. Kész vagy úton van: minden kész a konyhai kijelzőn, az állapot kész vagy úton a webshopban vagy a Thuisbezorgd-nál, a ✉ Kész / ✉ Úton üzenet elment az ügyfélnek, vagy ki van fizetve. A kassza percenként ellenőriz.
• Értesítés: a Késés gomb a felső sávban a darabszámmal (új esetén hangjelzéssel), rendelésenként az ígért idővel és a késés perceivel. Egy rendelés magától eltűnik, ha kész vagy úton van, vagy a Lezárva gombbal; alatta az elmúlt 24 óra rendelései, azzal, hogy mikor készültek el. Minden a naplóba kerül.
• Webshop: a vendég állapotoldala mutatja, hogy tovább tart, az új várható idővel.
• Thuisbezorgd-rendelésnél ez nem lehetséges (az ügyfél a Thuisbezorgd-é): ott csak értesítés van. Saját szöveg is megadható; a {naam}, {zaak}, {code}, {korting} és {geldig} helyére a megfelelő adat kerül.
• Jóváírási utalvány (csak bekapcsolt Kedvezménykódok mellett): a bocsánatkéréshez személyes kedvezménykód a következő rendelésre (pl. SORRY-7K4Q2M), összeg vagy százalék, egyszer használható, adott számú napig érvényes, a kasszánál és a webshopban. A kódok nem jelennek meg a Kedvezménykódok listájában. Ha a küldés nem sikerül, a kód érvényét veszti. A kasszában a gombbal csak a Kedvezmény adása joggal.
• Ki: az értesítések és a kiadott kódok megmaradnak (a biztonsági mentésben is); a beállítás bekerül a konfigurációs exportba.

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

A Rendelés gomb: mit csinál, és mikor van rá szükséged

Egy termék megérintése és a Rendelés megérintése két különböző lépés:

• Az érintés azonnal felteszi a terméket a számlára (bal oldalt a listában) új tételként. Csak te látod: a konyha és a bár még semmit sem tud róla. Az új sor csak piszkozat: nyugodtan eltávolíthatod, módosíthatod a mennyiséget vagy az opciókat, sztornó nélkül.
• A Rendelés egyszerre küldi tovább az összes új sort: a munkalapok a konyhai és a bárnyomtatókra (és a konyhai kijelzőre) mennek, a sorok ezután rendelt állapotúak. Eltávolítani ekkor már csak Sztornó segítségével lehet (sztornó jogosultság). A gombon látszik, hány új sor vár, pl. Rendelés (3); ha nincs új sor, a gomb szürke.

Miért két lépés? Az asztalnál felveszed a teljes rendelést (italok, előétel, főétel), még módosítasz, ha a vendég meggondolja magát, majd egyszerre küldöd a konyhára, állomásonként egy munkalappal termékenkénti lap helyett. Így a konyha már jóval a fizetés előtt elkezdheti.

Mi történik még a Rendelés során:

• Fogások: a(z) 1. fogás azonnal a konyhára megy; a(z) 2., 3. és 4. fogás VÁR állapotban megy, és a konyha csak akkor kezd hozzá, amikor lehívod azt a fogást (lásd Fogások).
• Körök: minden Rendelés egy kör; erre épül a ↻ Még egy kör.
• A készlet csökken, és az adagolt csap felszabadul.
• All-you-can-eat: ha túl sok, túl korai vagy túl késői a csomaghoz képest, a kassza előbb megkérdezi, hogy mégis mehet-e.
• Belgium (GKS 2.0): a sorok először pro formaként a fekete dobozba kerülnek; ha ez nem sikerül, semmi sem megy a konyhára, és a sorok újak maradnak.
• Nincs kapcsolat: a rendelés mentésre kerül, és a kapcsolat helyreálltakor a konyhára megy. Nyomtató kikapcsolva: a rendelés ettől még megtörténik, a munkalap a nyomtatási sorba kerül (lásd Konyhai nyomtató kikapcsolva vagy nincs konyhai kijelző).

Azonnal fizetni is lehet. Ha a Fizetés gombot érinted, miközben még új sorok vannak a számlán, a kassza először automatikusan megrendeli őket, így a konyha és a bár mindig megkapja a munkalapját. A bárban vagy elvitelnél tehát nem kell előbb a Rendelés gombot megérinteni: felütöd a termékeket, és rögtön Fizetés. Ha az automatikus rendelés nem sikerül (nincs kapcsolat, all-you-can-eat sor, fekete doboz), a fizetési képernyő zárva marad, és látod az okát.

Nem szeretnél jegyet a bárnak, ha azonnal fizettetsz? Kapcsold be a Közvetlen fizetés munkajegy nélkül jelölőnégyzetet itt: Beállítások → Üzlet → Rendelés és fizetés. Ekkor csak az megy a konyhára és a bárba, amit a Rendelés gombbal küldesz el; amit azonnal kifizettetsz, arról nem készül munkajegy.

Nagy vagy kis Fizetés gomb

A Nagy "Fizetés" gomb jelölőnégyzettel a rendelési képernyőn, közvetlenül a megrendelt termékek alatt egy nagy Fizetés gomb van: széles, magas és rajta az összeg, így gyorsan eltalálható. Ha a számla egy része már ki van fizetve, a gomb a még nyitott összeget mutatja. A lenti kis gomb a Rendelés mellett ekkor eltűnik.

A nagy gombbal a fizetési képernyő gombjai is nagyok: a Fizetés (Kártyánál, Ajándékutalványnál és a többi fizetési módnál), Készpénznél pedig a Pontos összeggel fizet és a Fizetés széles és magas, könnyen eltalálható, piszkos ujjal is (például egy hentesnél). A fizetési módok kicsit nagyobbak, a borravaló-gombok kicsit kisebbek, így minden a képernyőn marad.

Új telepítésnél a jelölőnégyzet ki van kapcsolva: ilyenkor a kis gomb lent a Rendelés mellett, és egy fizetési képernyő normál gombokkal. Inkább nagyot szeretnél? A Beállítások → Üzlet alatt, közvetlenül a világos/sötét téma alatt kapcsold be a Nagy "Fizetés" gomb jelölőnégyzetet. Egy már használatban lévő kassza megtartja a korábbi beállítását. A választás az üzlet összes kasszájára és tabletjére érvényes.

Termék "elfogyott" állapotba állítása

A rendelési képernyőn bárki hosszan nyomva tarthat egy terméket (vagy jobb egérgombbal rákattinthat), és választhatja az Elfogyott lehetőséget. A termék ekkor szürke lesz, és egyik kasszán sem rendelhető. Ugyanígy állíthatod vissza a Újra elérhető lehetőséggel. Minden módosítás bekerül a naplóba. Az adminisztrátor továbbra is megteheti ezt a Beállítások → Termékek alatt. A kasszaszerver is elutasítja az "elfogyott" állapotú terméket ("Cola" elfogyott), tehát olyan tabletről is, amely még nem kapta meg a módosítást, vagy offline mentett rendeléseknél; az a tablet ekkor ezt mutatja: "Nem sikerült elküldeni".

Konyhai kijelző (KDS)

A konyhai bon nyomtatók mellett (nem helyettük) a konyha vagy a pult képernyőt is használhat. Nyisd meg a konyhai tableten/PC-n ezt: http://<kassaserver>:3000/keuken, jelentkezz be PIN-kóddal, és válaszd ki az állomást: ezek ugyanazok a nevek, mint a nyomtatóké (konyha, pult, ...), így a képernyőn pontosan az áll, ami arra a konyhai bonra kerülne. Az "Összes" minden állomást mutat.

• Rendelésenként egy bon, a legrégebbi elöl, asztallal/elvitellel, számmal és azzal, hogy mióta vár (10 után narancssárga, 20 perc után piros).
• A fogások külön látszanak; a még le nem hívott fogás szürke, és ez áll rajta: "LEHÍVÁSRA VÁR". A sztornózott tételek áthúzva látszanak.
• Koppints egy tételre, hogy késznek jelöld, vagy a Kész gombra az egész bonhoz. A felszolgálók ekkor a felső sávban ezt látják: "Konyha: Asztal 5 kész". A Beállítások → Üzlet → Konyhai kijelző → Hang a felszolgálóknak (alapból ki) beállítással a kassza sípol is ("ding-dong", hangfájl nélkül). A böngésző csak a képernyő első megérintése után enged hangot; hangosítsd fel a tabletet.
• A Visszahozás megmutatja, mit jelöltek késznek az elmúlt órában, így a véletlenül eltüntetett tétel visszahozható.

A képernyő azonnal frissül. A konyhai bonok ugyanúgy nyomtatódnak; aki nem használja a képernyőt, semmit sem vesz észre.

Konyhai kijelző: továbbítás, sorrend és fogás

Beállítások → Nyomtatók → Konyhai kijelző. Minden rész külön kapcsolható be, alapértelmezetten ki; kikapcsoláskor minden megmarad.

• Továbbítás állomások között, például hideg → meleg → kiadó. Állomásonként beállít egy fix következő állomást; a rendelésen ekkor megjelenik egy → meleg gomb (és mindig a Továbbítás ide…, másik állomás választásához). Csak az adott állomás nyitott tételei mennek tovább. Egy állomásnak nem kell nyomtató: írja be az olyan állomásokat, mint a kiadó, a Nyomtató nélküli állomások mezőbe. A Kész (és a felszolgálás értesítése) csak az utolsó állomáson jelenik meg. A "Mind" nézetben a továbbított tételnél látszik, hol van most. Minden lépés látható a tételnél és a naplóban.
• Átrendezés: húzza a rendeléseket (egérrel), vagy mozgassa őket a ◀ ▶ gombokkal (érintőképernyő). A sorrend állomásonként és az állomás összes kijelzőjére érvényes; az új rendelések a végére kerülnek.
• Következő fogás a konyhai kijelzőről: egy várakozó fogással rendelkező rendelésen megjelenik a 2. fogás kérése. A felszolgálás ekkor ezt kapja: "A konyha kéri a(z) 2. fogást ehhez: Asztal 5" (hanggal), és a szokásos módon indít; a konyhai kijelzőn "2. fogás kérve · n perc" látszik, amíg a fogást el nem indítják. Vagy válassza az Indítás lehetőséget: ekkor a konyhai kijelző maga indítja a fogást, "2. FOGÁS INDÍTÁSA" munkabizonylattal, ugyanúgy, mint a kassza gombja.

Konyhai nyomtató kikapcsolva vagy nincs konyhai kijelző

A kassza mindig tovább működik, akkor is, ha a konyhai vagy pultos nyomtató ki van kapcsolva (vagy kifogyott a papír, vagy kilazult a kábel), és konyhai kijelző nélkül is:

• A rendelés mindig átmegy. A tételek azonnal megrendelt állapotba kerülnek, a számla stimmel, és a fizetés a szokásos módon működik. A kassza egyszerre szól a nyomtatóknak, és mindegyik legfeljebb kb. 4 másodpercet kap: egy kikapcsolt nyomtató nem várakoztatja sokáig a többit (és a felszolgálókat).
• Nyomtatási sor. A ki nem nyomtatható konyhai bon a nyomtatási sorba kerül. A kasszaszerver negyedórán át 30 másodpercenként újrapróbálja; amint a nyomtató újra működik, kijön, a tetején ezzel: KÉSŐBB NYOMTATVA. Ha egy következő bon azon a nyomtatón újra sikerül, a várakozó bonok rögtön utána jönnek.
• Negyedóra után az automatikus újrapróbálás leáll; a Nyomtatás most újra ekkor is lehetséges.
• Konyhai kijelző. Ha a rendelés a konyhai kijelzőn van, a konyha ott akkor is látja, ha a nyomtató ki van kapcsolva. Aki nem használ konyhai kijelzőt, nem marad le semmiről: a kassza sehol sem vár a konyha "Kész" jelzésére.
• A sor csak a kasszaszerver memóriájában van (újraindítás után üres).
• A blokkra is ez érvényes: ha nem sikerül, a fizetés akkor is megtörtént (a kassza jelzi: "a nyomtatás nem sikerült"), és később a Blokkok alatt kinyomtathatsz egy másolatot.

Fogások (előétel, főétel ...)

A fogásgombok csak akkor jelennek meg, ha szükség van rájuk: amint egy menü (összetett termék) kerül a rendelésre, vagy ha már van valami a(z) 2–4. fogásban. Hagyományos termékeknél, például egy kólánál, nem látod őket, és minden azonnal a konyhára megy. Nincs mit beállítani.

A rendelési lista alatt ez áll: Fogás 1 2 3 4. Alapból a(z) 1. fogás van kiválasztva, és minden a szokásos módon működik: a "Rendelés" mindent azonnal a konyhára küld, fogásfejlécek nélkül a konyhai bonon. Ha a termékek beütése előtt a(z) 2. (vagy magasabb) fogást választod, akkor:

• ezek a "Rendelés"-kor már a konyhára mennek, ez alatt: "-- Fogás 2 · LEHÍVÁSRA VÁR --", hogy a konyha előkészíthessen;
• a rendelési listán ez áll: "Fogás 2 · vár", egy Lehívás gombbal;
• lehíváskor a konyha egy bont kap: " FOGÁS LEHÍVÁSA 2 ", azzal, amit most kell elkészíteni.

A(z) 1. fogás mindig azonnal megy. Ha a(z) 2. fogást már lehívták, a(z) 2. fogásba később rendelt étel is azonnal megy.

Allergének termékenként

Alapból ki van kapcsolva: ekkor az allergének sehol sem látszanak. Bekapcsolás: Beállítások → Üzlet → Allergének megadása és megjelenítése termékenként.

• Beállítások → Termékek: minden terméknél jelöld be a(z) 14 uniós allergént (glutén, rákfélék, tojás, hal, földimogyoró, szója, tej, diófélék, zeller, mustár, szezámmag, szulfit, csillagfürt, puhatestűek). A terméklistában a rövidítések a név után állnak.
• Rendelési képernyő: minden termékgombon kicsiben ott vannak a rövidítések (pl. Gl Me), és a csoportsávban lévő ⚠ Allergének gomb a kiválasztott csoport minden termékéhez teljes szöveggel mutatja az allergéneket, a rövidítések magyarázatával.
• Az allergének módosításai bekerülnek a naplóba (régi → új). Ha a beállítás ki van kapcsolva, a korábban megadott allergének megmaradnak.

All-you-can-eat

Alapból ki van kapcsolva. Bekapcsolás: Beállítások → Üzlet → All-you-can-eat (csak adminisztrátor). Létrehozol egy vagy több csomagot, pl. Hal, Hús és Sushi, mindegyikhez:

• egy név (a blokkra kerül: "Hal felnőtt", "Hal gyerek");
• egy felnőttenkénti és gyerekenkénti ár (áfával együtt) és az áfakulcs (alapértelmezés: NL LAAG, BE B);
• a hozzá tartozó fogások (€ 0): teljes termékcsoportok és/vagy egyedi termékek (más csoportokból is, pl. sült krumpli a Halhoz és a Húshoz is);
• egy időkorlát percben (0 = nincs);
• körök: legfeljebb ennyi fogás személyenként körönként (0 = korlátlan), és legalább ennyi perc két kör között (0 = nincs);
• egy darabonkénti pazarlási felár (0 = nincs).

A ↑ ↓ gombokkal állítod a sorrendet. Ez akkor számít, ha egy fogás több csomaghoz is tartozik: ekkor ahhoz a legfelsőhöz számít, amelyet a csoport választott. A Törlés az új asztalok számára eltávolítja a csomagot; a folyamatban lévő asztalok megtartják az ártételeiket (ott a létszám még csökkenthető, de nem növelhető).

Az asztalnál:

• A rendelési képernyőn a blokk felett található a + All-you-can-eat. Csomagonként válassza ki a felnőttek és gyerekek számát; keverhető (pl. 2× Hal és 2× Hús). Az ár tételként kerül a számlára; ezek nem mennek a konyhára. A csoport létszáma a résztvevők teljes száma lesz (ha a kassza nyilvántartja a vendégeket).
• A sáv csomagonként mutatja: létszám, hátralévő idő (piros, ha lejárt az idő), hányadik kör van a maximummal, és mennyi idő van még a következő körig. A hozzá tartozó fogásokon a gombokon AYCE jelzés van, a blokkon pedig AYCE címkével szerepelnek € 0 áron. Minden, ami egyik választott csomaghoz sem tartozik (italok, desszertek ...), a szokásos módon fizetendő.
• Rendelés: minden "Rendelés" ingyenes fogásokkal egy kör, csomagonként (csak azoknál a csomagoknál, amelyek fogásai benne vannak). Az offline beütött és később elküldött tételeket a rendszer nem tartja vissza.
• Módosítás: a csomagonkénti számok módosítása. A létszám csökkentése sztornónak számít ("sztornó" jogosultság). Egy csomagot 0-ra állítani (vagy a Leállítás mindenre) addig lehet, amíg az adott csomag fogásai közül még egy sincs a számlán.
• Felár (csak ha egy választott csomagnak van pazarlási felára): add meg a mennyiséget (és a csomagot, ha több van); a számlára ez kerül: "Pazarlási felár × mennyiség".
• A fizetés, a felosztás, a kedvezmények és a blokk a szokásos módon működik: a csomagárak, a felár és az italok sima tételek a saját áfájukkal.
• Ha az adminisztrátor kikapcsolja az all-you-can-eat funkciót, miközben csoportok vannak folyamatban, az újonnan beütött fogások újra normál árba kerülnek; ami már a számlán van, az marad.
• A webshopban (opcionális, alapból ki): a Asztali rendelésnél is QR-kóddal (webshop) beállítással a csomaggal rendelő asztalnál ülő vendég a csomaghoz tartozó fogásokat Benne van jelöléssel, € 0 áron látja, felül az állással (létszám, kör, idő). Egy rendelés egy kör, ugyanazokkal a szabályokkal, mint a Rendelés; ha túl sok, túl korán vagy túl későn rendel, a webshop azonnal elutasítja. Az italokat és más fogásokat a vendég a szokásos módon fizeti; minden az asztal számlájára kerül. Ki = a webshop a normál árakat számolja, mint eddig.

Ajándékutalványok

Két kapcsoló a Beállítások → Üzlet → Ajándékutalványok alatt:

• Ajándékutalvány mint fizetési mód fizetéskor: alapból be van kapcsolva, ahogy mindig is volt. Ki = az Ajándékutalvány gomb nem jelenik meg fizetéskor (és visszavételezéskor a visszatérítés módja alatt sem), és a kasszaszerver elutasítja az ajándékutalvánnyal való fizetést.
• Ajándékutalványok eladása egyenleggel: alapból ki van kapcsolva. Bekapcsolva:
  • A rendelési képernyőn ott van az Ajándékutalvány gomb: válaszd ki az összeget (€ 10, 25, 50, 100 vagy más összeg), és hagyd, hogy a kassza kódot generáljon, vagy olvasd be egy előre nyomtatott kártya kódját. Az utalvány tételként kerül a számlára (áfakód: BON: nem forgalom, nincs áfa, nem megy a konyhára). Itt egy vendég egyenlegét is lekérdezheted.
  • Fizetés után az utalvány aktív, és a blokknyomtató kinyomtat egy ajándékutalványt az összeggel, a kóddal és egy QR-kóddal.
  • Beváltás: fizetéskor válaszd az Ajándékutalvány lehetőséget, és olvasd be vagy írd be a kódot (az Egyenleg gomb mutatja az egyenleget). Az összeg levonódik az egyenlegből. Ha az egyenleg kevesebb a számlánál, a teljes egyenleg részfizetésként levonódik, a maradékot pedig kártyával vagy készpénzzel fizeted. Az egyenleg részletekben is felhasználható.
  • Ha a kódot üresen hagyod = kód nélküli ajándékutalvány, mint korábban (pl. régi papír utalvány).
  • Jelentés → Ajándékutalványok (Ajándékutalványok kezelése jogosultság, alapból menedzser és adminisztrátor): keresés kód szerint, nyitott egyenleg, előzmények utalványonként, letiltás (elveszett/ellopták) és egyenleg javítása indoklással. Ez bekerül a naplóba.
  • Jelentések: az eladott ajándékutalványok nem számítanak forgalomnak, és külön szerepelnek (Eladott ajándékutalványok); a befolyt pénz viszont megjelenik a fizetési módoknál. Ami ajándékutalvánnyal van fizetve, az normál forgalom (áfával) az Ajándékutalvány fizetési módnál.
  • Könyvelés: az eladott utalványok követel, a beváltott utalványok tartozik oldalra kerülnek az Ajándékutalványok számlán (vendégek követelése).
  • Egy eladott ajándékutalvány a Blokkok → Visszavételezés alatt visszavehető, amíg még nincs felhasználva (egyenleg = érték). A visszavételezés után az utalvány érvénytelen (egyenleg 0, letiltva; ez az utalvány előzményeiben látszik). Ha már (részben) felhasználták, állítsd az egyenleget 0-ra a Jelentés → Ajándékutalványok alatt, és a maradékot külön térítsd vissza. Ajándékutalványra kedvezmény nem adható.

Feltölthető egyenleg (opcionális)

Kluboknak, sportbüféknek, ifjúsági házaknak és rendezvényeknek: az egyenleges ajándékutalványból feltölthető kártya lesz. Bekapcsolás: Beállítások → Üzlet → Feltölthető egyenleg, az ajándékutalványok alatt (alapból ki; csak akkor működik, ha az Egyenleges ajándékutalványok eladása be van kapcsolva).

• Kártya vagy karszalag: adj el egy ajándékutalványt az Előre nyomtatott kártya opcióval, és olvasd be a kártyát (billentyűzetként működő NFC/RFID-olvasóval vagy vonalkóddal). A kártya száma lesz a kód; ezzel a vendég úgy fizet, mint ajándékutalvánnyal.
• Feltöltés: rendelési képernyő → Ajándékutalvány → Egyenleg feltöltése: olvasd be az utalványt vagy kártyát, és írd be az összeget. Tételként kerül a számlára (BON áfakód: nem forgalom, nincs áfa, mint egy eladott ajándékutalványnál), és fizetés után az egyenlegen van. Az utalvány előzményeiben ez áll: Feltöltve.
• Legmagasabb egyenleg utalványonként vagy kártyánként (alapból € 500, legfeljebb € 5.000 állítható be).
• Maradék egyenleg kifizetése (jelölőnégyzet, alapból ki; Kasszafiók kezelése jogosultság): az Egyenleg lekérdezése után megjelenik a Maradék egyenleg kifizetése. Az egyenleg € 0 lesz, az összeg pedig pénz ki a fiókból tételként szerepel az X- és Z-jelentésen (Tegoed terugbetaald …).
• Egy feltöltés a Nyugták → Visszáru útján visszavonható, amíg az egyenleg még legalább annyi; az utalvány vagy kártya érvényes marad.
• Feltöltés a kioszkon (opcionális): lásd: Önkiszolgáló kioszk.

Étkezési utalványok

Csak belgiumi üzleteknek, alapból ki van kapcsolva: Beállítások → Üzlet → Fizetés → Étkezési utalványok. Az étkezési utalvány bérjellegű juttatás: a munkáltató a munkavállaló kártyájára tölti (Edenred, Monizze vagy Pluxee). A vendég a szokásos kártyaterminálon fizet vele; nincs szükség kapcsolatra a kibocsátókkal.

• Be: fizetéskor megjelenik az Étkezési utalvány gomb. Válaszd ki a kibocsátót (csak azokat a kibocsátókat, amelyeket az üzlet elfogad), és a vendég tartsa a kártyát a kártyaterminálhoz, ugyanúgy, mint kártyás fizetésnél. Terminálkapcsolat nélkül: a vendég magán a kártyaterminálon fizet, te pedig a Fizetés gombra koppintasz.
• Nincs borravaló és nincs visszajáró étkezési utalvánnyal. Ha az egyenleg túl alacsony, a vendég a maradékot másképp fizeti (a számla nyitva marad, amíg minden ki nincs fizetve).
• Csak bizonyos termékcsoportokra (opcionális, pl. ételre, de alkoholra nem): ekkor étkezési utalvánnyal legfeljebb ezeknek a termékeknek az összege fizethető a számlán. A fizetési képernyő mutatja, mennyi; a maradékot a vendég másképp fizeti.
• A blokkon: Étkezési utalvány Pluxee (utána a kibocsátó).
• Z-jelentés és X-jelentés: kibocsátónként külön sor (Étkezési utalvány Edenred, … Monizze, … Pluxee).
• Könyvelés: kibocsátónként külön főkönyvi számla (Étkezési utalványok Pluxee (követelés) stb., alapértelmezés 416100, 416200 és 416300), mert a pénz a kibocsátótól érkezik, nem a kártyaterminál bankjától.
• Szükséges: szerződés minden kibocsátóval, amelynek az utalványait elfogadod, és egy kártyaterminál, amely elfogadja ezeket a kártyákat (ezt kérdezd meg a kártyaterminál szállítójától).

Valuta

Készpénzes fizetés más pénznemben, pl. brit vagy amerikai turistáknál, vagy a határ menti térségben svájci frankkal. Alapból ki: Beállítások → Üzlet → Fizetés → Valuta. Add hozzá a pénznemeket (CHF, CZK, DKK, GBP, HUF, NOK, PLN, SEK, TRY, USD), mindegyikhez egy árfolyammal: hány eurót számolsz 1 egységért (pl. 1 GBP = € 1,15).

• Kézzel megadott: fix árfolyam; ha változik, módosítsd magad.
• Élő (EKB): az Európai Központi Bank napi árfolyama (referencia-árfolyamok, minden munkanapon 16:00 körül; ingyenes, fiók nélkül). Százalékos felárral (0-20) az árfolyam ennyivel alacsonyabb lesz, így az üzlet nem maga fizeti a váltást. A kassza magától letölti az árfolyamokat, ha 6 óránál régebbiek; a Frissítés most azonnal letölti őket. Internet nélkül az utolsó árfolyam marad.
• Be: fizetéskor megjelenik a Valuta gomb. Válaszd ki a pénznemet; a kassza mutatja, mennyi az abban a pénznemben. Írd be, mennyit ad a vendég: a kassza átszámolja, és a visszajárót euróban adja. Ha a vendég nem kér vissza semmit, pipáld be a Visszajáró borravaló lehetőséget: a visszajáró borravalóként kerül a nyugtára, Belgiumban abban a pénznemben (GKS 2.0, UC296).
• Ha a vendég kevesebbet ad a teljes összegnél, az részfizetés; a maradékot másképp fizeti.
• A blokkon: a pénznem, az összeg és az árfolyam, valamint a visszajáró euróban.
• X- és Z-jelentés: pénznemenként külön sor (Valuta GBP, euróban), a kasszafióknál pedig az, hogy mennyi van abban a pénznemben a fiókban. Az euróban adott visszajáró levonódik a fiókban várható pénzből; magukat a valutákat külön számolod meg.
• Könyvelés: készpénznek (pénztár) számít, euróban.

Extra gombok a rendeléshez és fizetéshez

Gombok olyan funkciókhoz, amelyekre nem minden üzletnek van szüksége. Alapból minden ki van kapcsolva; gombonként a Beállítások → Üzlet → Rendelés és fizetés menüben kapcsolhatod be (jogosultság: Üzlet, fizetés és nyomtatók beállítása). Ki = a gomb sehol sincs a kasszában, és a kasszaszerver elutasítja a műveletet. Hollandiában minden fekete doboz nélkül működik; Belgiumban egy gomb csak akkor működik, ha az adott funkciót tesztelték a fekete dobozzal (a gomb mellett jelzi, amíg ez nem így van).

Asztal nyitásakor:

• Vendégszám nyilvántartása: a "Hány fő?" kérdés szabad asztalnál, a létszám az asztaltérképen és a rendelési képernyőn, valamint a vendégek a kimutatásokban. Lásd: Vendégszám.

Rendeléskor (rendelési képernyő, arra, amit utána megkoppintasz):

• Azonos termékek összevonása (nincs gomb, alapértelmezetten bekapcsolva): ha ugyanazt a terméket újra megérinted (ugyanazok az opciók, még nincs megrendelve), új sor helyett a mennyiség nő: 4 Cola egy sorban, 4-szeres árral. A − gombbal újra levonhatsz egyet, akkor is, ha már meg van rendelve (egy darab sztornója). Megjegyzéssel, hellyel vagy elvitelre külön sor marad; ami már meg van rendelve, külön sor marad (új kör).
• − és + (minden sorban az ár előtt): a − levon egyet, a + hozzáad egyet (azonos termék, opciók és megjegyzés; ha az Azonos termékek összevonása ki van kapcsolva, akkor új sor). Még nincs megrendelve és 0-n áll: a sor eltűnik. Már megrendelve: eggyel kevesebb sztornó, a sor áthúzva marad (a konyhának és a kimutatásoknak); eggyel több új sor lesz, amit még meg kell rendelni. Magára az árra koppintva már semmi nem törlődik. Menünél csak −.
• Elvitelre (csak helyben): a vendég elviszi ezt a terméket, pl. egy üveg vizet vagy egy desszertet. Ez a tétel az elviteles áfát kapja (Belgiumban C címke), a számla többi része a helyben fogyasztás áfáját. A nyugtán a tétel mellett elvitel szerepel.
• Ülőhely (asztalnál): koppints tovább a(z) 1., 2., 3. ... ülőhelyhez; a tételek megkapják ezt az ülőhelyszámot (a konyhai bonon is). Belgiumban minden tétel az ülőhely költséghelyével (CHAIR, UC4123) kerül a fekete dobozba. Még egyszer a(z) 12. ülőhely után = ismét ülőhely nélkül.
• Visszavétel: a következő termék -1 mennyiséggel kerül fel, pl. egy üres üveg vagy pohár (betétdíj). Ez csak a Visszavehető (betétdíj) beállítású termékeknél lehetséges (Beállítások → Termékek). Ha az egész számla negatív (csak betétdíj-visszatérítés, eladás nélkül), a Fizetés visszatérítéssé válik: készpénzben vagy kártyára (magán a terminálon visszautalva). Belgiumban visszatérítésként (REFUND, UC4108 és UC4114).
• SPV beváltása: a vendég egy terméket vagy menüt single purpose voucherrel fizet (pontosan arra a termékre szóló utalvány, pl. "1 menu all-in"). Koppints az SPV beváltása gombra, majd a termékre a nyugtán: -1 mennyiséggel kerül fel (azonos ár és áfa, menünél az összetevőkkel), SPV jelöléssel. Nem megy a konyhára; normálisan törölhető. Egy utalványterméket előre adsz el normál termékként; a Beállítások → Termékek menüben kapcsold be rajta az SPV (utalvány) lehetőséget. Belgiumban a tétel az eladáskor VOUCHER-ként kerül a fekete dobozba (UC271).
• Előleg elszámolása: lásd lent.
• Nyitott ár (nincs gomb, termékenként): a Nyitott ár beállítású terméknél a kassza megkérdezi az árat, pl. a napi ételnél vagy egy előlegnél.

Fizetéskor:

• Közvetlen fizetés munkajegy nélkül (nem gomb): alapértelmezés szerint a Fizetés először megrendeli azt, ami még nincs megrendelve, így a konyha és a bár mindig megkapja a saját jegyét (lásd: A Rendelés gomb: mit csinál, és mikor van rá szükséged). Bekapcsolva: amit azonnal kifizettetsz anélkül, hogy előbb a Rendelés gombra koppintanál, arról nem készül munkajegy, pl. a bárpultnál, ahol magad veszed elő. A már megrendelt tételek nem változnak.
• Külön fizetés (asztalnál, a Számla megosztása alatt): válaszd ki, mit fizet most egy vendég, akár egy tétel egy részét is (½ fél üveghez). Ebből egy külön rész lesz, amelyet azonnal kifizettetsz; a többi a számlán marad, anélkül hogy előbb fel kellene osztani a számlát vagy át kellene tenni egy másik csoportba. Az egész nyugtára adott százalékos kedvezmény arányosan érvényesül. Vissza fizetés nélkül = minden újra a számlán. Belgiumban az eladás az asztal helyén marad, asztalváltás nélkül (UC4103bis, UC4104).
• Vendég fizetés nélkül távozott (jogosultság: Lezárás fizetés nélkül, alapból csak menedzser és adminisztrátor): a számla fizetés nélküli eladásként zárul, egy okkal a naplóban. A X- és Z-jelentésen és a napi kimutatásban Nem fizetett (a vendég távozott) néven szerepel; a könyvelési tételben a behajthatatlan számlára kerül (alapból 4985 / 643000). Belgiumban fizetés nélküli eladás (UC4109).

Utólag (Nyugták):

• Ár javítása (jogosultság: Nyugta árának javítása, alapból csak menedzser és adminisztrátor): egy kifizetett nyugta ára nem volt helyes, pl. 50% kedvezmény 5% helyett. A kassza új, asztal nélküli nyugtát készít a régi nyugta tételeinek visszavételével (negatívan, az akkor kifizetett áron) és ugyanazokkal a termékekkel újra, normál áron. Ott add meg a helyes kedvezményt, és fizettesd ki a különbözetet (vagy térítsd vissza, ha az új ár alacsonyabb). A régi nyugta úgy marad, ahogy volt; nyugtánként egyszer, és nem, ha már volt visszáru. Belgiumban a régi tételek CORRECTION-ként mennek (UC4116).

Kód: apps/pos-server/src/lib/kassaopties.ts, routes/kassaopties.ts; képernyő KassaOpties.tsx. Napló: Beállítás módosítva, SPV beváltva, Nyugta javítása, Nem fizetett.

Előleg elszámolása

Egy előleget (pl. egy rendezvényre vagy foglalásra) normál termékként adsz el bekapcsolt Előleg beállítással (Beállítások → Termékek; mindig nyitott áras). Hozz létre áfakulcsonként egyet, ha az előlegnek kulcsonként kell lennie (pl. Előleg étel és Előleg ital), vagy egy terméket, ha az árajánlat része. A vendég előre kifizeti az előleget, és nyugtát kap.

Bekapcsolás: Beállítások → Üzlet → Rendelés és fizetés → Előleg elszámolása (alapból ki). A végső fizetésnél koppints a rendelési képernyőn az Előleg elszámolása gombra, és add meg az előleg nyugtaszámát. A kassza az adott nyugta előlegtételeit negatív mennyiséggel teszi a számlára (azonos termék, ár és áfa). Ami már el van számolva, nem számolható el még egyszer. Ha az előleg több, mint a számla, a vendég visszakapja a különbözetet (visszatérítés). Belgiumban az elszámolt tételek visszatérítésként (REFUND) kerülnek a fekete dobozba (UC4110, UC4111, UC4113). Napló: Előleg elszámolva.

Nyugta e-mailben

Alapból ki van kapcsolva. Bekapcsolás: Beállítások → Üzlet → Blokk e-mailben is.

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

A kitöltés után indítsd újra a kasszát. Ezután a Fizetés képernyőn megjelenik a Blokk küldése e-mailben is (nem kötelező) mező: üresen hagyva = csak nyomtatás, mint mindig; e-mail-cím megadásával = ugyanaz a blokk (áfa-részletezéssel és adóügyi sorokkal) e-mailben is elmegy a vendégnek, feladóként az üzlet nevével.

• Az e-mail-cím nem kerül mentésre; a naplóban csak ez áll: "N. blokk elküldve ide: a***@domein.nl", és hogy sikerült-e.
• Ha az e-mail-küldés nem sikerül (pl. hibás bejelentkezési adatok), a blokk ettől még ki van fizetve és ki van nyomtatva; az üzenet megmondja, mi volt a hiba.
• Részfizetésnél (számla felosztása) nem: a blokk az utolsó fizetéskor készül, ezért ott add meg a címet.
• Utólagos küldés e-mailben: a Blokkok alatt minden blokknál ott van az E-mail gomb (Blokk másolatának nyomtatása jogosultság). Ez MÁSOLAT jelzéssel küldi el a blokkot, akárcsak egy nyomtatott másolatot (Belgiumban másolatként regisztrálva).
• Nincs szükség további csomagokra: a kassza maga kommunikál a levelezőszerverrel (STARTTLS a(z) 587 porton, TLS a(z) 465 porton).

Foglalások

Bekapcsolás: Beállítások → Üzlet → Foglalások (alapból ki). Itt azt is beállíthatod, hogy hány perccel előtte jelenjen meg a foglalt asztal az asztaltérképen (alapból 60), valamint a foglalás alapértelmezett időtartamát (alapból 120 perc).

• Foglalások gomb a felső sávban: napi áttekintés (◀ ▶) a foglalások, a vendégek és a meg nem jelentek számával. + Új foglalás: név, telefon, e-mail, létszám, dátum, időpont, időtartam, asztal (később is megadható) és megjegyzés. A foglalást a személyzet rögzíti; online foglalás (még) nincs.
• Ha ugyanarra az asztalra abban az idősávban már van foglalás, a kassza jelzi; a "Mentés mégis" lehetséges.
• Visszaigazolás e-mailben (pipa, vagy később "E-mail"), ha van e-mail-cím és levelezőszerver (SMTP_HOST, lásd: Blokk e-mailben).
• Az asztaltérképen a foglalt szabad asztal lila, ezzel: "R 19:30 Jansen (4)". Ha rákoppintasz: a "Jansen megérkezett" megnyitja az asztalt 4 fővel és "Jansen" csoportnévvel; a "Más vendégek" egyszerűen megnyitja.
• Az áttekintésben: Megérkezett (megnyitja az asztalt; asztal nélkül előbb választasz egyet), Módosítás, Nem jelent meg, Lemondás és Visszaállítás. Minden bekerül a naplóba.
• Online platformok foglalásai: lásd lent a Foglalási platformok részt.

TheFork kasszakapcsolat: asztal nyitása érkezéskor, számla vissza

A TheFork POS-API segítségével a kassza együttműködik a TheFork Managerrel (alapból ki), a fenti foglalások letöltése mellett. Bekapcsolás: Beállítások → Foglalási platformok → TheFork kasszakapcsolat; a kezelőportálon keresztül működik.

• Ha a TheFork Managerben egy vendéget Megérkezett vagy Asztalnál állapotra tesznek, a kasszában megnyílik az azonos nevű asztal a vendégek számával és egy megjegyzéssel: név, allergiák és diéta, előleg, ajánlat/kedvezmény és hűségpontok (Yums). Ha azon az asztalon már van nyitott rendelés, azt kapcsolja hozzá. Ha nincs ilyen nevű asztal: értesítés jelenik meg, és a Platformok alatt kiválasztható az asztal.
• Fizetés után a számla a TheForkhoz kerül (végösszeg és tételsorok névvel, termékcsoporttal, mennyiséggel és összeggel); a TheFork ekkor a foglalást Távozott állapotra teszi. Megosztott fizetésnél egy számla a végösszeggel. Ha nem sikerül, a kassza negyedóránként újrapróbálja (két napig), vagy a Platformok alatti Újraküldés gombbal.
• Párosítás: a kassza megjelenít egy párosítási kódot; ezt kell megadni a TheFork Managerben (Integrációk → kassza). A TheFork étterem-azonosítóját (Customer-id) az adminisztrátor adja meg, vagy automatikusan megérkezik az első rendeléssel.
• Jelölőnégyzetek: asztal automatikus megnyitása, név, allergiák és előleg megjegyzésként, számla a TheForknak.
• Feltétel: a Pin Voordeel rendelkezik a TheFork API-kulcsával (csak partnereknek), és ott POS-ként regisztrálta a kasszát (gomb a kezelőportálon); a TheFork egy tesztmenet után élesíti a kapcsolatot.

A TheFork dokumentációja: https://docs.thefork.io/POS-API/introduction

Várólista az előzetes foglalás nélküli vendégeknek

Foglalás nélküli vendégeknek, akik asztalra várnak. Bekapcsolás: Beállítások → Üzlet → Várólista (walk-in) (alapból ki). Csak akkor látható, ha az SMS-küldés a CM.com-on keresztül be van állítva; különben a várólista sehol sem jelenik meg a kasszában (a beállításoknál sem). A foglalásoktól függetlenül működik: akkor is, ha azok ki vannak kapcsolva. Itt adhatod meg az SMS szövegét is (üres = "Hallo {naam}, uw tafel bij {zaak} is klaar. Wilt u zich melden bij de bediening?"; a {naam}, a {zaak} és a {personen} automatikusan kitöltődik).

• Várólista gomb a felső sávban a várakozók számával (narancssárga, ha valaki vár). + Várólistára: név, telefon (az SMS-hez), létszám, a közölt várakozási idő és egy kérés (terasz, etetőszék).
• A lista érkezési sorrendben van, és mutatja, ki mióta vár (piros, ha tovább tart a közöltnél); a tetején a várakozók és a vendégek száma, valamint a mai átlagos várakozási idő.
• Ha az SMS nem megy el, mellette látszik az ok. Az SMS újra lehetséges.
• Leültetés: válassza ki az asztalt; a kassza a létszámmal (ha a kassza nyilvántartja a vendégeket) és a névvel mint csoportnévvel nyitja meg (ugyanúgy, mint egy érkező foglalásnál).
• Távozott (elment vagy lemondta) és Visszaállítás. A lista alatt látszik, kit ültettek le vagy ki távozott ma, és mennyit vártak.
• Adatvédelem: a telefonszámok egy nap után törlődnek; aki 12 óra után még a listán van, automatikusan lekerül róla. A felvétel, a behívás (a számnak csak az utolsó 3 számjegyével) és a leültetés bekerül a naplóba.
• Miért nem a Foglalásoknál? A foglalás későbbre szól (dátum, időpont, előre megadott asztal); a várólista a mostra (sorrend, várakozási idő, SMS, ha szabad az asztal). Ezért saját kapcsolója és gombja van, ugyanazzal az "asztal megnyitása" funkcióval, mint a foglalásnál.
• Online a várólistára (opcionális, alapból ki; csak webshoppal): a A vendégek a webshopon keresztül maguk is feliratkozhatnak beállítással a webshopban megjelenik a Várólista (és tartozik hozzá egy QR-kód az ajtóhoz, a webshopkezelőben az Asztalok és QR résznél). A vendég megadja a nevét, telefonszámát, a létszámot és egy kérést, és élőben látja a helyét. A kasszában online jelöléssel szerepel a listában; a behívás, a leültetés és a távozott a szokásos módon működik, és a vendég ezt a telefonján is látja (ott le is iratkozhat).

Törzsvásárlói kártya / hűségpontok

Bekapcsolás: Beállítások → Üzlet → Hűségkártya / pontgyűjtés (alapból ki, ilyenkor sehol semmi nem látszik belőle). Itt azt is beállítod: pont eurónként (0 = csak pecsétgyűjtő kártyák), hány pont után jár jutalom, és hány euró kedvezményt ér a jutalom.

• A kasszán a blokk felett ott a "+ Hűségkártya": keresd meg a vendéget név vagy telefonszám alapján, vagy hozz létre új vendéget (név, opcionálisan telefon és e-mail). Ezután a név a pontegyenleggel együtt látszik a blokkon.
• Beváltás: elég pont esetén "100 pont beváltása: € 5 kedvezmény"; tele pecsétgyűjtő kártyánál "Ingyen kávé" (a kávénak a blokkon kell lennie). Ebből kedvezménytétel lesz; bárki újra törölheti.
• A pontok és pecsétek csak fizetéskor íródnak jóvá és vonódnak le: pontok a kedvezmény utáni összegre (az eladott ajándékutalványok nélkül), pecsétek darabonként a pecsétgyűjtő kártyás termékekre (az ingyenes termék nem számít).
• A blokkon: gyűjtött, beváltott, egyenleg és a pecsétgyűjtő kártyák állása.
• Jelentés → Vendégek (Hűségkártya kezelése jogosultság): vendégek keresése, adatok módosítása, pontok javítása (indoklással), előzmények és törlés (GDPR: a név, a telefon és az e-mail törlődik; az előzmények névtelenül megmaradnak). Alul a termékenkénti pecsétgyűjtő kártyák (pl. 10 kávé = 1 ingyen).
• A visszavételezés nem vonja vissza automatikusan a gyűjtött pontokat; szükség esetén javítsd őket a Jelentés → Vendégek alatt.
• Törzsvásárlói kártya számmal (opcionális): a Jelentés → Vendégek → (vendég) résznél add meg a kártyaszámot (vagy olvasd be a kártyát abba a mezőbe). Vonalkódolvasóval a kártya beolvasása hozzárendeli a vendéget a nyugtához, a kasszánál és a kioszkon is. A kártyaszámra a + Törzsvásárlói kártya gombnál is kereshetsz.

Vendégprofil: VIP, étkezési igények és preferenciák (opcionális)

Bekapcsolás: Beállítások → Üzlet → Vendégprofil, a törzsvásárlói kártya alatt (alapértelmezés: ki; csak akkor működik, ha a törzsvásárlói kártya be van kapcsolva). Ezután:

• A rendelési képernyőn a hozzárendelt vendég alatt megjelenik a "+ Vendégprofil": jelöld be a VIP-et, válaszd ki az étkezési igényeket (vegetáriánus, vegán, peszketáriánus, halal, kóser) és az allergiákat (a(z) 14 allergén), és írd be a preferenciákat (pl. "állandó asztal az ablaknál", legfeljebb 300 karakter). Ezután a vendégnél láthatók a rendelési képernyőn, az allergiák pirossal. Módosíthatók itt is: Jelentés → Vendégek → (vendég) → Vendégprofil.
• Ha olyan termékre koppintasz, amely a vendég valamelyik allergénjét tartalmazza (lásd Allergének termékenként), a kassza előbb megkérdezi, hogy mégis hozzáadja-e. Csak az számít, ami a terméknél meg van adva; kétség esetén mindig kérdezd meg a konyhát.
• A VIP ★-ot kap az alaprajzon: nyitott számlánál és az adott vendég megjelenített foglalásánál. Amikor egy foglalás vendégei megérkeznek, a kassza a foglalás vendégét a számlához rendeli.
• Az étkezési igények és az allergiák (és a VIP) a konyhai bonra kerülnek a konyhának és a bárnak: GAST: VIP · Vegetarisch · allergie: Noten.
• Az étkezési igények és az allergiák egészségügyi adatok: csak a vendég hozzájárulásával töltsd ki. A naplóban csak az szerepel, hogy a profil megváltozott, maguk az igények nem. A vendég törlése a vendégprofilt is törli.

Kedvencek / gyorsgombok

Alapból ki van kapcsolva. Beállítások → Üzlet → Kedvencek / gyorsgombok:

• Legtöbbet eladott: a csoportsáv elején a ★ Kedvencek gomb az elmúlt 14 nap 12 legtöbbet eladott termékével (automatikusan frissül). A rendelési képernyő a kedvencekkel nyílik meg.
• Saját választás: a rendelési képernyőn tarts hosszan nyomva egy terméket (vagy kattints rá jobb gombbal), és válaszd a ★ Kedvenc (gyorsgomb) lehetőséget; újra = eltávolítás. Termékek kezelése jogosultság. Minden kassza azonnal látja.
• A beütés, az opciók, a menük, a happy hour és az "elfogyott" a kedvenceknél pontosan úgy működik, mint a normál csoportokban.

Még egy kört

A rendelési képernyőn ott a ↻ Még egy kört gomb (amint valami a számlán van, akkor is, ha még nincs megrendelve). Egy koppintás újra hozzáadja az utolsó kört (mindent, ami egyszerre ment el a "Rendelés" gombbal, vagy amit épp most ütöttél be) új tételként; utána csak koppints a Rendelés gombra. Az árak a mostaniak (happy hour is).

• Hosszú nyomás (vagy jobb klikk): válassz magad. A ◀ ▶ gombokkal lapozhatsz a korábbi körökre, termékenként be/ki (pl. vedd ki a pipát az ételekről), a mennyiséget pedig a − / + gombokkal módosítod. Az opciók és a megjegyzések is átkerülnek.
• Az elfogyott termékek és a menük nem kerülnek át (a menüket külön üsd be). Kapcsolat nélkül is működik.
• A tételek úgy kerülnek hozzá, ahogy a számlán szerepelnek: bekapcsolt Azonos termékek összevonása mellett termékenként egy sor (2 Cola), kikapcsolva minden sor külön (2× 1 Cola).

Asztalidő az asztaltérképen

Minden foglalt asztalon ez látszik: ⏱ 45m · 12m: mióta foglalt az asztal, és mennyi ideje ütöttek be rá utoljára valamit (a pontos időkért koppints és tartsd nyomva az asztalt, vagy vidd fölé az egeret). Ha egy ideje nem rendeltek semmit, az asztal narancssárga keretet kap: érdemes odamenni. Hogy hány perc után, azt a Beállítások → Üzlet → Asztalidő alatt állítod be (alapból 20, 0 = nincs narancssárga keret). Ha még semmit sem ütöttek be, az idő az asztal megnyitásától számít.

Ha egy asztalnál több csoport ül (külön számlákkal), csoportonként egy sor látszik, pl. G1 ⏱ 50m · 12m és Jansen ⏱ 10m (a csoport neve, különben a csoport száma). Az a csoport, amelyiknél túl régóta nem történt semmi, narancssárga címkét kap, az asztal pedig narancssárga keretet.

Teljes asztal áthelyezése

A rendelési képernyőn van az Asztal áthelyezése. Válaszd ki a helyiséget (pl. Terasz) és egy asztalt: az asztal összes csoportja átkerül, mindegyik a saját számlájával. Ha foglalt asztalt választasz, az asztalok összevonódnak (a csoportok hozzáadódnak). Ha csak egy részt akarsz áthelyezni, használd a korábbiak szerint a Felosztás / áthelyezés gombot. Ha mindennek egy számlán kell lennie, használd az Összevonás gombot.

Offline munka (tablet Wi-Fi nélkül)

Ha megszakad a kapcsolat egy tablet és a kasszaszerver között (wifi a teraszon, a szerver rövid ideig ki van kapcsolva), megjelenik egy sárga sáv, és a tablet az utoljára mentett asztalokkal, termékekkel és nyitott rendelésekkel dolgozik tovább:

• az asztalok megnyitása, a termékek beütése és a Rendelés a tableten mentődik (újraindítás után is megmarad), és szaggatott kerettel látszik a rendelési listán ("még nincs elküldve");
• amint visszajön a kapcsolat, minden sorrendben a szerverre megy, és csak ezután megy a konyhai bon a konyhára. Minden csomagnak van kulcsa, így semmi sem érkezik kétszer. Ha közben valaki más megnyitotta az asztalt, a termékek ahhoz a rendeléshez kerülnek;
• a fizetés, a kedvezmény, a felosztás és hasonlók csak kapcsolattal lehetségesek; a "Fizetés" megvárja, amíg az asztal minden tétele el nem ment.

Személyek száma

Opcionális, alapértelmezésben ki van kapcsolva: Beállítások → Üzlet → Rendelés és fizetés → Vendégszám nyilvántartása. Ki = a lehető legkevesebb érintés: a szabad asztal egy érintéssel nyílik, sehol nem jelenik meg létszám, a kimutatás, az irányítópult és a napi összesítő pedig nem mutat vendégeket és egy vendégre jutó költést.

Be: ha megérint egy szabad asztalt, a kassza megkérdezi, hány fő (nagy gombok 1-8, vagy beírás; "Kihagyás" = 1). Az asztaltérképen a foglalt asztalnál "3/4 fő" látható (fő/hely, sárga, ha többen ülnek, mint ahány hely van). A rendelési képernyőn a csoportsávban a "3 fő" gombbal módosítható; több csoportnál az asztal összeadja az összes csoportot.

Létszám nélkül is minden működik: fizetéskor az Egyenlő elosztás 2 főről indul, az all-you-can-eat maga kérdezi meg a felnőttek és gyerekek számát, a foglalások és a várólista pedig megtartják saját létszámukat (az asztal ilyenkor létszám nélkül nyílik).

HACCP-nyilvántartás

Minden vendéglátóhelynek felügyelnie és dokumentálnia kell az élelmiszer-biztonságot: Hollandiában a Hygiënecode voor de Horeca (vendéglátóipari higiéniai kódex, ellenőrzés: NVWA), Belgiumban az FAVV önellenőrzési rendszere szerint (G-023 útmutató). Kapcsold be a HACCP-nyilvántartás funkciót a Beállítások → Jogszabályok menüben (alapértelmezés szerint ki van kapcsolva).

• Mérési pontok (adminisztrátor): pl. hűtőkamra, fagyasztó, melegen tartás, maghőmérséklet hőkezelés után, visszahűtés és áruátvétel, °C-ban megadott minimummal és/vagy maximummal és gyakorisággal (minden nap, naponta kétszer, minden héten vagy használatkor). Az Alaplista hozzáadása kiinduló beállítást hoz létre (hűtés 7 °C-ig, Belgiumban 4 °C-ig; fagyasztó -18 °C-ig; melegen tartás 60 °C-tól; hőkezelés 75 °C-tól).
• Takarítás és ellenőrzés: napi, heti (akár rögzített napon) vagy havi feladatok, helyiséggel és utasítással, pl. vágódeszkák fertőtlenítése, zsírszűrők, kártevő-ellenőrzés, hőmérő ellenőrzése.
• Rögzítés (bárki, aki be van jelentkezve): HACCP gomb a felső sávban, a ma még nyitott tételek számával. Írd be a hőmérsékletet, vagy pipálj ki egy feladatot (Kész vagy Nem sikerült). Ha egy hőmérséklet a határértéken kívül esik, helyesbítő intézkedést kell megadni (pl. "ajtó becsukva, termék kidobva"). A bejegyzések nem módosíthatók; a hibát új bejegyzéssel javítod.
• Összesítő (Forgalom időszakonként jogosultság): időszakonként az összes bejegyzés, az eltérések száma és a napi elmaradt bejegyzések; CSV (Excel) formátumban, vagy nyomtatva / PDF-ként mentve egy ellenőrzéshez.

Csapolórendszer és átfolyásmérők

Minden csapolás, amelyet egy csapolószámítógép vagy átfolyásmérő jelent, a számlára kerül, így semmi sem "folyik el". Kapcsolja be itt: Beállítások → Csapolórendszer (alapértelmezés szerint ki).

• Források (adminisztrátor): a csapolószámítógép vagy az átfolyásmérő-rendszer. Válassza ki a márkát; a kassza kitölt egy előbeállítást. Hollandiából és Belgiumból: Van Duijnen Horeca (csapolásautomatizálás, Dashbar), Beconet (Multi-Tap), TapSystems, Horecatechniek Nederland, Heineken SmartDispense, WeissBeerger / AB InBev és BarTrack; továbbá Gruber, Addimat, WMF / Hogatron (E-Protokoll), Drinkotec (ex-Hartec), , Berg, Easybar, Azbar, Scanabar, PourMyBeer, iPourIt, BeerBoard, US BeerSAVER, Bevchek, Capton/BarVision, Kegtron, Kegbot Kegboard, egy "okoscsap" vagy saját rendszer. A csatlakozás ötféleképpen lehetséges (Kegboard: lásd lent: Adagolt csapolás és Kegboard):
  • Mezők: kraan (vagy tap, plu), ml (vagy cl, liter, volume ezzel: eenheid) vagy porties, id (ugyanaz a csapolás kétszer = egyszer könyvelve), tijdstip, tafel, bediening; egy csapolás, egy lista vagy { "taps": [...] }.
  • Hálózat (TCP): a kassza csatlakozik a csapolószámítógéphez (cím és port), vagy maga figyel egy porton.
  • Soros port: COM port vagy USB-soros, 1200–115200 baud, 8N1, 7E1 vagy 7O1.
  • Hálózatnál és soros portnál beállítja az üzenetformátumot (soronként egy üzenet, vagy STX … ETX, esetleg XOR-ellenőrzéssel és ACK/NAK visszaküldéssel) és az üzenet mintáját a kraan vagy plu részekkel, valamint szükség szerint ml, cl, liter, porties, tafel, bediening és id (pl. kraan;ml vagy csak egy PLU poharanként). A szállítók a pontos formátumot csak a telepítőknek adják meg; kérje el a csapolószámítógép szállítójától. A Tesztcsapolás úgy küld egy csapolást, ahogy a csapolószámítógép tenné.
• Csapok (rendszergazda): csaponként vagy PLU-nként a termék, és hogy hogyan kerül a számlára: poharanként (pohár ml-ben; egy 520 ml-es csapolás 250 ml-es poharakkal = 2 pohár; 50%-tól számít egy pohár) vagy literenként (a termék ára a literár; a számlán pl. "Pils 0,33 l" a helyes összeggel).
• Számlán: ha a csapolószámítógép asztalt jelent, a csapolás azonnal annak az asztalnak a nyitott rendelésére kerül. Különben a Csapolva alatt jelenik meg: a rendelési képernyőn megjelenik a "… csapolás számla nélkül" sáv; válassza ki a csapolásokat, és koppintson az Erre a számlára gombra. A tételek azonnal rendelt állapotúak (a bárba már nem megy munkajegy), és a készlet csökken. A felső sáv Csapolva gombja mindent mutat, aminek még nincs számlája.
• Leírás (Sztornó jogosultság): öblítés, törés, kóstolás, személyzet, ingyenes vagy egyéb (megjegyzéssel); ez bekerül a naplóba. Az egy pohárnál kevesebbet (pl. öblítés) le kell írni.
• Áttekintés (Forgalom időszakonként jogosultság): csaponként csapolva, számlán, leírva (okonként), törölve és még nyitott, literben, az eladott százalékkal, és CSV formátumban.
• A jelentett csapolások nem módosíthatók (csak feldolgozhatók).

Adagolt csapolás és Kegboard

Adagolt csapolással a csap csak azután nyílik, hogy a poharat beütötték a kasszán, és csak arra a mennyiségre. Így semmit sem csapolnak, ami nincs a nyugtán. Csak akkor működik, ha a csapolórendszer be van kapcsolva, és csaponként kell bekapcsolni (alapértelmezés szerint ki).

• Csaponként (adminisztrátor, Beállítások → Csapolórendszer → Csapok): jelölje be az Adagolt csapolás opciót, és válassza ki, mennyi ideig lehet nyitva a csap a beütés után (10–600 másodperc, alapértelmezés 120). Kegboard esetén adja meg a relét (mágnesszelep) is. Adagolt csapolás csak poharanként lehetséges.
• Beütés: Rendelés (vagy közvetlen Fizetés) esetén a kassza minden, az adott terméket tartalmazó nyugtasorhoz létrehoz egy engedélyezést (poharak száma × pohár ml-ben), és elküldi a csapolószámítógépnek. Az ezután beérkező csapolás ahhoz a nyugtasorhoz tartozik. Így nem kerül még egyszer a nyugtára, és a Csapolva közé sem. Az engedélyezés nélküli csapolás egyszerűen a Csapolva közé kerül.
• A sor sztornója csapolás előtt: a csap újra bezárul. Az időben el nem csapolt engedélyezés lejár; a csap később soha nem nyílik ki utólag.
• Engedélyezések a rendelési képernyőn (sáv a nyugta felett): látható, mi van folyamatban, Leállítás és Újraengedélyezés. Újraengedélyezés csak akkor lehetséges, ha még semmit sem csapoltak, így soha nem engedélyeznek többletet. A Tesztengedélyezés (adminisztrátor) nyugta nélkül engedélyez egy poharat; ez a naplóba kerül.
• Hogyan jut el az engedélyezés a csapolószámítógéphez:
  • Kegboard (Kegbot, nyílt forráskódú, ESP32 átfolyásmérőkkel és mágnesszelepekkel; teljesen nyilvános protokoll): a kassza grant üzenetet küld az adott termékhez tartozó csapokra, a relékre és a mennyiségre. A vezérlő maga zárja el a csapot, ha a mennyiség elérte a határt vagy lejárt az idő.
  • Hálózat/soros: beállítható engedélyező parancs a következőkkel: {kraan}, {ml}, {porties}, {sec} és {id} (pl. V{kraan};{ml}), a forrás üzenetformátumában küldve (sor vagy STX … ETX XOR-ral). Opcionálisan van leállító parancs is. A pontos parancsot a szállító adja meg.
• Kegboard párosítása: a + Forrás alatt válassza a Kegbot Kegboard márkát. A panel jelentkezik a forrásnál; kattintson az Engedélyezés (vagy Elutasítás) gombra. A panel ekkor egyszer saját kulcsot kap, amelyet a kassza csak hashként tárol. Egy másik eszköz vagy hibás kulcs semmit sem változtat a párosított panelen; ha a panel elvesztette a kulcsát, először használja a Párosítás megszüntetése funkciót. A forrás mutatja a panel firmware-ét, mérőit és reléit. A csapok a mérőszámok (0, 1 …). A panelhez érintett kártyát elutasítja: a fizetés a kasszánál történik. Ha a csapolórendszer ki van kapcsolva, a panel megőrzi az üzeneteit, és később küldi el őket.
• A forrásnál állítja be, hány másodperc átfolyás nélkül záródjon el a csap (5–300, alapértelmezés 30). Csaponként adja meg a mérőszámot, a relét (mágnesszelep) és azt, hogy a beütés után meddig lehet nyitva a csap.

Zene vezérlése a kasszáról

A személyzet a kassza érintőképernyőjéről vezérli a zenét, így nincs szükség külön képernyőre a pultnál. Bekapcsolás: Beállítások → Üzlet → Képernyők és kezelés → Zene vezérlése a kasszáról (alapból ki). Ekkor a felső sávban megjelenik a Zene gomb: forrásonként (pl. Bár és Terasz) Lejátszás, Szünet, Következő, Előző, Hangosabb, Halkabb és egy hangerőcsúszka, valamint hogy mi szól most. A Vissza a kasszához bezárja a panelt. Kikapcsoláskor a források megmaradnak.

• Lejátszási sor (Sonos, Bluesound és VLC): a sor azzal, ami most szól. Koppints egy számra a lejátszáshoz; a Szerkesztés gombbal számokat távolíthatsz el (✕), feljebb vagy lejjebb teheted őket (↑ ↓; Sonos és Bluesound), vagy kiürítheted a lejátszási sort. A Másik zene választása gombbal Sonos-kedvencet (pl. rádióadót vagy Tunify-csatornát) vagy -lejátszási listát, illetve BluOS-előbeállítást játszhatsz le.
• Saját képernyőn: ugyanaz a vezérlés és a lejátszási sor nagyban itt: http://<kassaserver>:3000/muziek, pl. egy második monitoron a kassza mellett vagy egy tableten a pultnál (ha ugyanazon az eszközön már be vagy jelentkezve, egyébként PIN-kóddal).
• Tableten vagy telefonon: QR-kód az adott saját képernyő címével az üzlet hálózatában. Egy munkatárs beolvassa a saját tabletjével vagy telefonjával (az üzlet wifihálózatán), és a saját PIN-kódjával jelentkezik be; a Kijelentkezés gombbal újra bezárul. Lásd: Második képernyő tableten vagy telefonon.

A rendszergazda a + Zeneforrás gombbal adja hozzá a forrásokat, kiválasztja a kapcsolat módját, és a Tesztelés gombbal kipróbálja:

• Soundtrack (soundtrack.io): a nyilvános API-n keresztül, API-tokennel (a Soundtracktől kérhető) és egy hangzónával (Zónák betöltése). Lejátszás, szünet, következő, hangerő és hogy mi szól.
• Sonos: a hangszóró IP-címe (csoport esetén: a csoportot vezérlő hangszóróé). Mindennel működik, ami a Sonoson szól, pl. Tunify, Spotify vagy rádió.
• Bluesound (BluOS): a lejátszó IP-címe; szintén mindennel működik, ami rajta szól, pl. Tunify.
• VLC a zenei számítógépen: a webes felület bekapcsolva (Eszközök → Beállítások → Összes megjelenítése → Felület → Fő felületek: Web, a Lua alatt jelszóval); az IP-cím (szükség esetén :poort porttal, alapértelmezés 8080) és a jelszó.
• Saját zenei számítógép (webcímek): zenei számítógéphez vagy -dobozhoz, amelynek gombonként van webcíme; GET vagy POST, a hangerőhöz pedig {volume} (0-100) a címben. Hangosabb/Halkabb cím nélkül a kassza lépésenként állítja a hangerőt.
• A zenei szolgáltatás webes lejátszója: a webes lejátszó vagy vezérlőoldal webcíme (pl. a Tunify vagy a Media Tools webes lejátszója) a kasszában a Zene gombbal nyílik meg; ha a szolgáltatás nem jeleníthető meg más oldalon, akkor a Megnyitás külön ablakban gombbal.

A kassza a szerverről kommunikál a lejátszókkal, ezért azoknak a kasszával azonos hálózaton kell lenniük (a Soundtrack interneten keresztül). Vezérelni bárki tudja, aki be van jelentkezve; beállítani a Üzlet, fizetés és nyomtatók beállítása jogosultsággal lehet. A token és a jelszó soha nem jelenik meg újra a képernyőn, és a naplóba sem kerül; a naplóban csak a beállítás szerepel (be/ki, források), nem minden gombnyomás. A konfigurációexport csak a be/ki állapotot viszi át (a források egy üzlethez tartoznak).

Második képernyő tableten vagy telefonon

A zene és a kamerák egy munkatárs saját tabletjén vagy telefonján is megjeleníthetők, második képernyőként a kassza mellett. A Zene vagy a Kamerák ablakban található a Tableten vagy telefonon gomb: ez egy QR-kódot mutat a címmel, pl. http://192.168.1.20:3000/muziek vagy .../camera.

1. Csatlakoztasd a tabletet vagy a telefont az üzlet wifihálózatához.
2. Olvasd be a QR-kódot a kamerával (vagy írd be a címet a böngészőbe).
3. Jelentkezz be a saját PIN-kódoddal. Csak azt látod, amihez jogod van: a zenét mindenki, a kamerákat csak a Kameraképek megtekintése joggal.
4. Kész: Kijelentkezés jobb felül. Ha a bejelentkezés lejárt (pl. a tablet egy éjszakán át nem volt használva), a képernyő újra kéri a PIN-kódot.

Tipp: tedd ki az oldalt a tablet kezdőképernyőjére (a böngészőben: Hozzáadás a kezdőképernyőhöz), így alkalmazásként nyílik meg.

Ezért a kassza lekérdezi a kassza-PC IP-címét a hálózatban (ha a PC-nek több is van, pl. wifi és kábel, akkor kiválasztod a hálózatot). A kezelőportálon (távoli kassza) ez a portál címe. A QR-kódot maga a kassza készíti, internet nélkül.

Tabletek párosítása: egy gombnyomással a tabletre (opcionális)

Még egyszerűbb: párosíts egyszer egy tabletet, és a kassza egy gombnyomással arra a tabletre küldi a zenét vagy a kamerákat. Kapcsold be itt: Beállítások → Üzlet → Képernyők és kezelés → Tabletek második képernyőként (alapból ki).

1. A tableten: nyisd meg a http://<kassaserver>:3000/tablet címet (a beállításnál ott van a Tableten vagy telefonon a QR-kóddal), jelentkezz be PIN-kóddal, és adj nevet a tabletnek, pl. Bár tablet. Párosítás.
2. A kasszán: a Zene vagy a Kamerák ablakban most megjelenik az Ide: Bár tablet gomb (zöld ponttal, ha a tablet be van kapcsolva). Koppints rá: a tablet magától megnyitja azt a képernyőt. Zenénél a kiválasztott forrás is átkerül (pl. Terasz).
3. A tableten: a Bezárás visszavisz a várakozáshoz; a Tablet párosításának megszüntetése eltávolítja a párosítást.

Hagyd nyitva az oldalt a tableten; ha a tablet ki van kapcsolva vagy alszik, amint újra bekapcsol, megnyitja a képernyőt. A tablet annak a munkatársnak a nevében marad bejelentkezve, aki bejelentkezett rajta: kamerákat küldeni és nézni csak a Kameraképek megtekintése jogosultsággal lehet. A rendszergazda a beállításnál látja, mely tabletek vannak párosítva és be vannak-e kapcsolva, és átnevezheti vagy eltávolíthatja őket. A tablet saját kulcsot tárol; a kassza ebből csak egy hash-t tárol. Kikapcsoláskor a párosított tabletek megmaradnak. A naplóban látható, ki párosított, nevezett át vagy távolított el egy tabletet.

Behívókijelző elvitelhez

Kijelző a vendégeknek: bal oldalon Készül, jobb oldalon Kész, nagy számokkal, mint egy büfében vagy gyorsétteremben. Bekapcsolás: Beállítások → Üzlet → Képernyők és kezelés → Behívókijelző elvitelhez (alapból ki).

Párosítás nem kell: nyisd meg egy böngészős tévén (smart tévé, stick vagy mini PC), tableten vagy második monitoron a kassza címét /oproep végződéssel, pl. http://192.168.1.20:3000/oproep. A beállításnál és a Behívás ablakban találod a Saját képernyőn és a Tableten vagy telefonon gombot (QR-kód a címmel). Bejelentkezni nem kell: a kijelző csak számokat mutat. Koppints egyszer a képernyőre, és a böngésző hangot adhat ki.

Mi jelenik meg rajta:

• elviteles rendelések a kasszából, a webshopból és a Thuisbezorgdból (és igény szerint a pultnál, asztal nélkül leadott rendelések is, gyors eladásnál), az elmúlt 12 órából;
• amint valamit elküldtek a konyhára vagy a bárba (vagy a webshopban készül az állapot): ekkor a szám a Készül oszlopban áll;
• a Kész magától beáll, ha a konyhai kijelző a rendelés minden tételét késznek jelzi, vagy a webshopos rendelés kész állapotú. A szám röviden villog, és a kijelző ding-dong hangot ad;
• egy kész szám annyi percig marad kint, amennyi be van állítva (alapból 10), vagy amíg Elvitték;
• a kioszk rendelései (lásd Önkiszolgáló kioszk) mindig megjelennek, amint ki vannak fizetve vagy a kasszánál fizetik ki őket, "helyben eszem" esetén is, a blokkjukon lévő átvételi számmal;
• igény szerint a Thuisbezorgd, Uber Eats, Deliveroo és HubRise futárainak rendelései is (A futárok rendelései is … jelölőnégyzet): a platform rendelésszámával és alatta a platform nevével, hogy a futár lássa, mikor kész a rendelése. Az Átvéve ekkor a platformnak is jelzi, hogy a futárnál van (mint a platform ablakában).

A szám: a webshopnál, a Thuisbezorgdnál és a kiszállítási platformoknál az a rendelésszám, amely a vendégnél vagy futárnál már megvan; egyébként az átvételi szám (1–999). Nagyban szerepel a blokkon, azzal a magyarázattal, hogy a szám megjelenik a képernyőn, amikor a rendelés kész (a blokk nyelvén).

Opcionális (alapból kikapcsolva, a beállításnál):

• A szám bemondása hanggal: új kész számnál a képernyő a választott nyelven mondja be, pl. "Nummer 42…" (holland, angol, német, francia, spanyol, olasz, portugál, lengyel, török vagy arab). A hang a képernyő böngészőjéből jön, és eszközönként másképp szól; megnyitás után egyszer koppints a képernyőre. A csengő után, ha a hang is be van kapcsolva.
• Rendelés állapota a telefonon: a blokkon az átvételi szám alatt QR-kód jelenik meg. A vendég beolvassa, látja a számát és az állapotot (megrendelve, készül, kész, átvéve), és értesítést kap, ha kész a rendelés. Ez a kezelőportálon keresztül működik, ezért a kasszának csatlakoznia kell hozzá. Nem a webshopnál és a Thuisbezorgdnál (saját állapotuk van), és nem a kioszknál (saját beállítása van).

A kasszában ott a Behívás gomb (a még készülő rendelések számával):

1. a Kész kézzel késznek jelöl egy számot (konyhai kijelző nélkül, vagy ha így gyorsabb). Webshopos vagy Thuisbezorgd-rendelésnél az állapot is frissül, így a vendég is értesítést kap.
2. a Vissza visszateszi a Készül oszlopba.
3. az Elvitték leveszi a kijelzőről (Visszavonás lehetőséggel).

A beállításnál azt is kiválasztod, hogy a keresztnév megjelenjen-e a szám mellett (alapból nem, az adatvédelem miatt), és hogy a kijelző adjon-e hangot. Kikapcsolva: nincs Behívás gomb és nincs átvételi szám a nyugtán; a beállítások megmaradnak. A naplóban látszik, ki mit jelölt kézzel késznek, tett vissza vagy jelölt elvittnek.

Be- és kiblokkolás

A munkaidő-rögzítés alapból ki van kapcsolva: ekkor sehol sem látszik a kasszában (nincs gomb a felső sávban, nincs a bejelentkezési képernyőn, nincs Munkaidők fül). Bekapcsolás: Beállítások → Üzlet, a Személyzet be- és kijelentkezése (munkaidő) alatt:

• Ki: nincs használatban. Ha később kikapcsolod a blokkolást, sehol sem látszik többé, de a már rögzített órák megmaradnak (semmi sem törlődik); ha újra bekapcsolod, ismét ott vannak.
• Be: a munkatársak be- és kiléptethetik magukat. Bejelentkezés után a kassza megkérdezi, hogy szeretnél-e munkaidőt indítani (a Most nem is választható). A felső sávban ekkor ez látszik: Munka kezdése vagy Munkában 17:02 óta; koppints rá a munka befejezéséhez.
• Kötelező: bejelentkezés után előbb indítsd a munkaidőt, különben nem használhatod a kasszát. A munka befejezése azonnal ki is jelentkeztet.

Aki nem használja a kasszát (pl. a konyha), a bejelentkezési képernyőn rögzíti a munkaidőt: koppints a Munka kezdése / befejezése gombra, és add meg a PIN-kódodat. Ez váltogat a kezdés és a befejezés között, bejelentkezés nélkül.

Ha a munkaidő-rögzítés be van kapcsolva, az adminisztrátor a Beállítások → Munkaidők alatt látja:

• ki van most munkában (és lezárhatja annak a munkaidejét, aki elfelejtette);
• a ledolgozott órákat munkatársanként és időszakonként, az összes műszakkal, valamint CSV-letöltést (az órák tizedes számként is, a bérszámfejtéshez);
• műszakok módosítása vagy hozzáadása (koppints egy műszakra, vagy + Műszak hozzáadása). Minden módosítás a régi és az új időpontokkal együtt bekerül a naplóba.

Belgiumban minden munkakezdést és -befejezést a fekete doboznak is jelent a rendszer. Ha az nem érhető el, a rögzítés nem történik meg (akárcsak a fizetés). Hogy ez pontosan megfelel-e a belga munkaidő-nyilvántartási előírásoknak, azt még meg kell erősíteni.

Mérés és címkék (mérleg)

Ha a mérleg be van kapcsolva (Beállítások → Mérleg), a termékeknek lehet kilónkénti ára. Minden más termék továbbra is darabonkénti.

• Mérés: koppints egy kilónkénti árú termékre (a gombon pl. ez áll: 12,95/kg). A Mérés ablak élőben mutatja a mérleg által mért súlyt (pl. egy Aclas OS6X, vagy az a mérleg, amelyen maga a kassza fut); zöld = stabil. Tedd a terméket a mérlegre, és koppints a Hozzáadás gombra, amint a súly stabil. Az ár: kilónkénti ár × súly (centre kerekítve); a termék edényének súlya (tára) automatikusan levonódik. Ha a terméknek vannak opciói, azok ezután jönnek.
• Több mérleg: ha több mérleg van, az ablak tetején választod ki, melyiken mérsz. Minden kassza/tablet megjegyzi a választását.
• Kézzel: nincs mérleg (vagy szabad kézzel)? Akkor írd be a súlyt: a 0,512 vagy a 1,2 kilogramm, a 512 vagy az 512 g gramm.
• A TS6X címkéje: olvasd be a címke vonalkódját a vonalkódolvasóval a rendelési képernyőn (csak olvasd be, semminek nem kell nyitva lennie), vagy koppints a Címke gombra, és olvasd be vagy írd be a(z) 13 számjegyet. A termék (PLU) és a súly a címkéről jön. Ha a címkén ár is van, a kassza pontosan azt az árat számolja.
• A képernyőn, a blokkon és az ügyfélkijelzőn a súly is látszik, pl. Gehakt 6,63, alatta 0,512 kg x € 12,95/kg; a konyhai bonon 0,512 kg Gehakt. A felosztás, az áthelyezés és a visszavételezés kilóban történik.
• Mérendő termék csak a kasszaszerverrel való kapcsolat esetén lehetséges (a súly a kasszaszerveren keresztül érkezik).

Uber Eats, Deliveroo és HubRise

A Thuisbezorgd.nl / Takeaway.com mellett a kasszába érkeznek az Uber Eats (Hollandia és Belgium), a Deliveroo (csak Belgium; a Deliveroo 2022 végén kivonult Hollandiából) rendelései és minden, ami a HubRise-on van (pl. Uber Eats, Deliveroo, Just Eat/Takeaway.com és kisebb rendelési appok). Minden platform külön kapcsolható be: Beállítások → Kiszállítási platformok (alapból ki, kikapcsoláskor minden megmarad). A lap platformonként mutatja, mely országokban működik, és figyelmeztet, ha az üzlet országában nem működik.

• Bekapcsolás, majd Bejelentkezés az Uber Eatsbe és üzlet összekapcsolása (az üzlet a saját Uber Eats-fiókjával jelentkezik be). Ha a fióknak több üzlete van, adja meg az üzlet-azonosítót (store id), és jelentkezzen be újra. Ehhez az Uber Eatsnek előbb jóvá kell hagynia a Pin Voordeelt partnerként.
• Deliveroo: közvetlenül, a portálon keresztül. Adja meg a site-id-t (location id) és a márka-azonosítót (brand id). Tablet nélkül (alapértelmezés): a kassza fogad el vagy utasít el; tablettel: az üzlet a tableten fogad el, és a portál csak jelzi, hogy a rendelés bekerült-e a kasszába.
• HubRise: a kassza maga tölti le a rendeléseket (20 másodpercenként, portál nem kell).
• Platformonként: automatikus elfogadás, konyhai bon azonnal a konyhára/bárba és (Uber Eats, Deliveroo) menü automatikus küldése módosítás után, valamint Menü küldése most. A menüben a Termékek az Uber Eats és a Deliveroo menüjében alatt bejelölt termékek szerepelnek, választási lehetőségekkel; az elfogyott állapot is átmegy.

Rendelések. A rendelésből normál rendelés lesz (bezorgen vagy afhalen, csoportnév <platform> <nummer>) a platform áraival: a termékeket az azonosító (a menüből), a kód vagy a PLU-szám alapján ismeri fel, ismeretlen = külön sor a platform árával (és értesítés); kiszállítási díj, felárak és kedvezmény saját sorként; ha a végösszeg mégsem egyezik, egy "Eltérés" sor. A konyhai bon azonnal a konyhára/bárba megy. Platformok gomb a felső sávban (a folyamatban lévő rendelések számával; narancssárga, ha van mit elfogadni): elfogadás vagy elutasítás (indokkal), készül, kész, úton, kiszállítva vagy elvitték, lemondás és Lezárás (online fizetve). Amit a platform ismer, az visszamegy (Uber Eats: elfogadás, elutasítás, lemondás; Deliveroo: elfogadás, elutasítás, készül, kész, elvitték; HubRise: minden állapot). Ha az üzlet maga szállít ki (saját kiszállítás), a rendelés a Körök között is megjelenik, és az indulás és a kiszállítás automatikusan a platformhoz kerül. A platform általi lemondás érvényteleníti a rendelést. Ha a kassza több mint 2 percig nem kapcsolódik a portálhoz, a portál elutasítja az új Uber Eats-rendelést, és jelzi a Deliveroónak (tablettel), hogy nem sikerült, így az üzlet látja a tableten.

Kód: apps/pos-server/src/lib/bezorgplatforms.ts, routes/bezorgplatforms.ts; képernyők Bezorgplatforms.tsx. Portáloldal: horecapos-portaal/src/platforms.mjs. Napló: Kiszállítási platformok (be/ki, beállítások, rendelések). Minden bekerül a kassza biztonsági mentéseibe.

A kisebb hollandiai és belgiumi platformoknak (Homie, Hebtrek, sneleten.nl, Bistroo ...) nincs nyilvános kasszakapcsolata; ha a HubRise-on vannak, a HubRise-on keresztül működnek. További részletek: lásd a backlogot.

Készpénzautomata (zárt készpénzkezelő rendszer)

Alapból ki: a készpénz a megszokott módon működik. Zárt készpénzkezelő rendszernél a személyzet nem nyúl a készpénzhez: a vendég vagy a munkatárs beteszi a pénzt az automatába, amely megszámolja, ellenőrzi, hogy nem hamis-e, és visszaadja a visszajárót.

• Automaták, amelyekkel a kassza közvetlenül kommunikál:
  • CashDro (3, 4+, 5, 7, S Compact; NuKassa, KluisKassa): hálózaton keresztül (web service). A CashDro-n kapcsold be a Web Integration funkciót, és hozz létre saját felhasználót a kasszának.
  • Cashmatic (SelfPay 460/860/1060; Belgiumban Xpos): hálózaton keresztül (50301-es port), a Cashmatic egy felhasználójával.
  • Azkoyen Cashlogy (POS1000, POS1500): az automata melletti Windows-PC-n futó CashlogyConnectoron keresztül (8092-es port).
  • CashKeeper: Windows-PC-n futó CKMonitoron keresztül (16501-es port).
  • Glory CASHINFINITY (CI-5, CI-10, CI-10X; a Cikamon keresztül is): az automata vezérlésén (FCC) keresztül. Még beta: az első kapcsolatot ellenőriztesd a Gloryval vagy a forgalmazóddal.
  • Külső: más szoftver vezérli az automatát, és az kommunikál a kasszával (például a Cikam, az ImaCash 25 márkához, a CashGuard/StrongPoint (Merlin) szoftvere, a PayComplete (SUZOHAPP), a Gunnebo SafePay vagy francia márkák, mint a CashMag).
  • Próbaautomata: hardver nélkül, gyakorláshoz vagy bemutatáshoz. A Kapcsolat tesztelése gombbal ellenőrzöd a címet és a bejelentkezést. Tedd az automatát a saját hálózatba (soha ne legyen elérhető az internetről), és használj saját felhasználót a kasszának, ne rendszergazdát.
• Fizetés Készpénz móddal: a Fizetés a készpénzautomatánál elindítja a fizetést az összegre (kerekített készpénzösszeg, ha ez be van kapcsolva, plusz borravaló; számlamegosztásnál a rész). A képernyő mutatja, mennyit dobtak be és mennyi jön vissza; a kassza csak akkor zárja le a fizetést, ha az automata kész jelzést ad. Mégse = az automata visszaadja a pénzt. Ha az automata nem tudta kiadni a teljes visszajárót (kevés az érme), ott áll, mennyit kell a kasszafiókból kiadni. Egy sikeres, de még le nem zárt fizetés (pl. kiesett a tablet) az adott rendelésnél újra megtalálható.
• Készpénz csak az automatán keresztül (alapból be): ekkor a kasszaszerver csak akkor fogad el készpénzt, ha pontosan arra a rendelésre és arra az összegre sikeres fizetés történt az automatánál. Ki = a normál készpénz a fiókba is lehetséges.
• Kasszafiók (Jelentés → Kasszafiók, Kasszafiók kezelése jogosultság): Állapot lekérdezése (érménként és bankjegyenként, Cashmatic, Cashlogy, Glory és a próbaautomata esetén), Kifizetés indoklással (pl. váltópénz a fiókba), Feltöltés és Lefölözés (a váltópénz marad; Cashmatic esetén). A Várható összeg a kasszafiókban nem számolja bele az automatában lévő pénzt (az külön, alatta szerepel: A készpénzautomatában), de beleszámolja azt a visszajárót, amelyet a fiókból kellett kiadni.

A ©-gomb

Minden képernyő jobb alsó sarkában (PIN-kód, asztaltérkép, rendelés és konyha) van egy kis © gomb. Ez megnyitja az OptimumPOS adatait: logó, cím, telefon, e-mail és weboldal. Az ikon helyben, az alkalmazásban van tárolva, így internet nélkül is működik. Ugyanez az ikon az alkalmazás ikonja is (böngészőfül és kezdőképernyő).

2. rész · Menedzser

Első lépések

A menedzser alapból mindent megtehet, amit a felszolgálók, és emellett többek között kedvezményt adhat, visszavételezhet, lezárhatja a napot, kezelheti a kasszafiókot, és megtekintheti a naplót és a készletet. Ennek nagy része a Jelentés gomb alatt van:

• Köztes kimutatás (X): az eddigi forgalom, a nap lezárása nélkül.
• Kasszafiók: váltópénz, pénz be/ki és a fiók kinyitása.
• Nap lezárása (Z): a nap végén; utána új nap kezdődik.
• Korábbi Z-jelentések, Időszaki forgalom és Irányítópult.
• Napló, Ajándékutalványok és Vendégek.

Készlet

Alapértelmezetten ki van kapcsolva. Bekapcsolás: Beállítások → Üzlet → Készlet nyilvántartása. Ki = a kasszában sehol nem látszik.

• Termékenként itt választhatsz: Beállítások → Termékek → (termék) → Készlet:
  • Nincs: ahogy eddig;
  • Termékenként: minden eladás 1 darabot von le (pl. üvegek, dobozok), egy jelzési szinttel a "mindjárt elfogy" állapothoz;
  • Alapanyagokon keresztül: egy recept, pl. hamburger = 1 zsemle + 150 g hús + 1 szelet sajt. Minden eladás levonja az alapanyagokat.
• Beállítások → Készlet (Készlet kezelése jogosultság, alapból menedzser és adminisztrátor):
  • Termékek és Alapanyagok: a készletállás, elfogyott / mindjárt elfogy jelzéssel; "csak (majdnem) elfogyott" szűrő és export CSV-be.
  • Termékenként vagy alapanyagonként könyvelhetsz Bevételezést (+) (szállítás), Leltárt (=) (a megszámolt mennyiség lesz az új készlet) vagy Leírást (−) (törés, lejárt; az ok megadása kötelező).
  • Alapanyagok létrehozása mértékegységgel (db, g, kg, ml, cl, l, adag, üveg, hordó) és jelzési szinttel.
  • Előzmények: minden mozgás (eladás, sztornó, bevételezés, leltár, leírás), hogy ki és mikor. A kezelési műveletek a naplóba is bekerülnek.
• A levonás Rendeléskor történik (vagy fizetéskor, ha azonnal fizettek). A sztornó visszaírja a készletet. A megosztás és az áthelyezés nem von le kétszer. Menüknél az ételek vonódnak le, nem a menüsor. A visszáru (jóváíró bon) nem írja vissza a készletet (a visszahozott áru általában már nem eladható); ezt szükség esetén bevételezésként könyveld.
• Ha a készlet elfogyott (vagy egy alapanyag már egy adagra sem elég), a termék minden kasszán automatikusan elfogyott állapotba kerül. Ha mindjárt elfogy, a termékgombon még N látszik. Bevételezés vagy leltár után azonnal újra rendelhető. A kassza szervere is elutasítja ilyenkor a terméket ("Pils" elfogyott (készlet 0)), tehát egy olyan tabletről is, amely erről még nem tudott.
• A készlet 0 alá is mehet (pl. két tablet egyszerre, vagy offline rendelés); a leltár ezt helyrehozza.
• Rendelési lista: Beállítások → Készlet → Rendelési lista. Termékenként és alapanyagonként a jelzési szint mellett a feltöltés eddig értéket és a beszállítót is beállíthatod. A rendelési listán minden szerepel, ami a jelzési szinten vagy alatta van (jelzési szint nélkül: 0 darabnál), beszállítónként, javaslatként a feltöltés eddig − készlet értékkel. A mennyiségek módosíthatók, és ki-be pipálhatók. Utána Nyomtatás (bonnyomtató), Másolás (e-mailhez vagy WhatsApphoz), Export (CSV), és a szállítás után Leszállítva: bevételezés könyvelése (mindent egyszerre lekönyvel). A felső pipával azt is látod, ami még nem fogyott el, hogy pluszban rendelhess.
• Választható opciók: egy választási csoportnál (Beállítások → Termékek → Választható opciók) található a Készlet gomb. Add meg választásonként az alapanyagokat darabonként, pl. Extra sajt = 1 szelet sajt, Sült krumpli = 150 g sült krumpli. Ha a választást kiválasztják, ezek az alapanyagok darabonként levonódnak (akkor is, ha maga a termék nem vezet készletet; sztornónál visszakerülnek). Ha egy alapanyag elfogyott, a választás a kasszán (elfogyott) jelzést kap, és nem választható.

Rendelés a beszállítóktól

Alapból ki. Bekapcsolás: Beállítások → Készlet → Rendelés a beszállítóktól (csak bekapcsolt Készlet nyilvántartása mellett). Ki = a rendelési lista a megszokott módon működik.

• Beszállítók (Beszállítók lap): válassz egyet a listából, vagy hozz létre saját beszállítót. A listában szerepelnek nagykereskedések és cash & carry áruházak (Sligro, Sligro-ISPC/Sligro-M, HANOS, Makro, De Kweker, Horeca Totaal, Van Zon, zegro, Lekkerland), foodservice (Bidfood és Bidfood Belgium, Solucious, Chefs Culinar, Java, Q-Food, Agora Culinair, VHC Jongens/Kreko/Actifood, Hocras, Van Hoeckel ...), ital-nagykereskedések (De Klok, Henk Smit, Horesca, De Monnik, Hansen, Dranken Geers ...), sörfőzdék és üdítőital-gyártók (Heineken a Sligrón keresztül, AB InBev/BEES, Alken-Maes, Haacht, Duvel Moortgat, Martens, Coca-Cola, Spadel, Grolsch, Bavaria), friss áru beszállítói (Van Gelder, Driessen, FiliusKaas, Bakkers Brigade, Rungis ...), nem élelmiszer (Bunzl, Takeaware, Supplierz), a Vinify.nl online borbolt és rendelési platformok (Apicbase, Exact Horeko, Growzer, inOne, Cuisin.io, OrderXL). Csak az üzlet országából származó beszállítók szerepelnek benne. Ha kiválasztasz egyet, a rendelés módja, a fájl és az oszlopok már helyesen be vannak állítva; minden beszállítónál ott áll, hogyan lehet nála rendelni.
• Beszállítónként: ügyfélszám, rendelés módja:
  • E-mail: a rendelés e-mailként (táblázattal) a rendelési e-mail-címre, opcionálisan másolattal, a rendelési listával mellékletként: CSV, Excel, CSV a Care4Fresh számára (sok friss áru nagykereskedés), UBL 2.1 Order (Peppol BIS Order), EANCOM ORDERS (Hollandiában D96A, Belgiumban D01B/HO2C) vagy cXML. A válaszok az üzlet e-mail-címére érkeznek.
  • Fájl: a kassza elkészíti a fájlt, te feltöltöd a beszállító webshopjába (pl. Bunzl Snel bestellen: artikel;aantal, Takeaware: SKU,Quantity). Az elválasztó karakter, a fejléc és az oszlopok beállíthatók (artikel, ean, omschrijving, aantal, eenheid, prijs, totaal; a artikel=SKU formával saját nevet adsz a fejlécnek).
  • Kapcsolat (cXML): cXML OrderRequest ügyfélszámmal és közös titokkal a beszállító rendelési címére, ahogy a beszerzési rendszerek küldik a Sligrónak, a HANOS-nak és a Bidfoodnak. A címet, az ügyfélszámot és a titkot a beszállítótól kapod (Sligro: koppelingen@sligro.nl). A titok soha nem kerül vissza a képernyőre.
  • Mindkét kapcsolatnál megadható felhasználónév és jelszó (Basic) és további fejlécek is (soronként egy, pl. X-Api-Key: ...).
  • Feltöltés (SFTP/FTPS): a kassza maga teszi a fájlt (EANCOM, UBL, CSV, Excel ...) a beszállító szerverén lévő mappába, ahogyan sok nagykereskedő fogadja az EDI-rendeléseket. SFTP (SSH), FTPS (explicit a(z) 21 porton vagy implicit a(z) 990 porton) vagy, csak a saját hálózatban, FTP. Bejelentkezés jelszóval vagy SSH-kulccsal (OpenSSH, PEM vagy PuTTY .ppk; ed25519, ECDSA vagy RSA). A Kulcs készítése kulcspárt hoz létre a kasszában; a nyilvános kulcsot elküldöd a beszállítónak. A Kapcsolat tesztelése bejelentkezik és megkeresi a mappát. Az SFTP-szerver ujjlenyomata az első kapcsolódáskor rögzül, utána ellenőrzésre kerül (más szerver nem kapja meg a jelszót); saját tanúsítványú FTPS esetén a tanúsítvány ujjlenyomatát rögzíted. Ehhez nincs szükség további szoftverre.
  • Nyomtatás: a rendelés a blokknyomtatón, telefonos leadáshoz.
• A jelszavak, kulcsok, tokenek és fejlécek soha nem kerülnek vissza a képernyőre (üresen hagyva = megtartás, Törlés = eltávolítás).
• Kapcsolat kérése: egy beszállítónál a kassza e-mailt állít össze egy kapcsolat kéréséhez (cXML, EDI SFTP/FTPS-en keresztül, UBL/Peppol vagy a beszállító saját API-ja) az üzlet adataival (név, cím, adószám, ügyfélszám, GLN) és azzal, amire szükség van; EDI esetén a nyilvános kulccsal. Módosítás és küldés; egy másolat és a válaszok az üzlet e-mail-címére mennek. A kérelem dátuma a beszállítónál látható. A Sligro esetén a koppelingen@sligro.nl címre megy, egyébként az account managered címét adod meg.
• Egy saját beszállító (nem a listából) mindenre képes, kivéve amit magának a beszállítónak kell kínálnia: az e-mail, a fájl és a nyomtatás mindig működik; kapcsolat vagy feltöltés csak az adott beszállító adataival.
• Rendelési napok és szállítás: rendelési napok, legkésőbbi időpont, szállítási idő (a kívánt szállítási dátum a rendelésen) és minimális rendelési összeg. Automatikus: a rendelési napokon ettől az időponttól a kassza maga előkészít egy rendelést vázlatként (te ellenőrzöd) vagy azonnal elküldi (e-mailben, feltöltéssel vagy kapcsolaton keresztül; a minimális rendelési összeg alatt csak vázlatként készíti elő). Naponta egyszer beszállítónként.
• Termékenként (Beállítások → Termékek → (termék) → Készlet, a Termékenként résznél) és összetevőnként: Rendelés innen (a beszállító), rendelési szám az adott beszállítónál, EAN, csomagonként (24-es rekesz = 24), a csomagolás neve és a csomagonkénti beszerzési ár. A riasztási szint a rendelés időpontja; a feltöltés eddig azt adja meg, mennyinek kell akkor lennie.
• Beszerzési rendelések (Beszerzési rendelések lap):
  • Rendelési javaslat beszállítónként: minden, ami a riasztási szinten vagy alatta van. Ami már meg van rendelve, de még nem érkezett meg (úton), beszámít, így semmit sem rendelsz kétszer. Javaslat = feltöltés eddig − állás − úton (feltöltés eddig nélkül: a riasztási szintig), egész csomagokra felfelé kerekítve. Módosítsd a mennyiségeket, és Rendelés készítése.
  • Egy rendelés először előkészítve van: a mennyiségek, a külön tételek (termék nélkül, pl. szalvéták), a megjegyzés és a szállítási dátum még módosítható. Ezután Küldés (a beszállító módján, vagy egyszer másképp). Ha nem sikerül (pl. a beszállító elutasítja), ott áll az ok, és újra megpróbálhatod.
  • Beérkezett: soronként a beérkezett mennyiség (már a megrendelt mennyiségre van állítva); a készlet csomagonként nő (2 rekesz 24 darabos = 48), a rendeléssel együtt az előzményekben.
  • Minden fájl (CSV, Excel, UBL, EANCOM, cXML) külön is letölthető.
• Az elküldés, a sikertelenség, a beérkezés és a törlés bekerül a naplóba. A normál Rendelési lista továbbra is működik; ha egy terméknél a listából származó beszállító van megadva, akkor ott annak a nevével szerepel.

Értékeléskezelés

Google- és Trustpilot-értékelések olvasása és megválaszolása a kasszában. Bekapcsolás: Beállítások → Pontgyűjtés és értékelések → Értékeléskezelés (alapból ki, ilyenkor sehol semmi nem látszik belőle). Olvasás és válaszolás: Jelentés → Értékelések (Értékelések olvasása és megválaszolása jogosultság, alapból a menedzsernek is). Ha kikapcsolja, a kapcsolatok és az értékelések megmaradnak.

• Ezután minden egység csak a Csatlakozás a Google-hoz gombra koppint, és bejelentkezik a cégprofil saját Google-fiókjával. A Places-kulcs központilag is beállítható (a költségek ekkor a szolgáltatót terhelik). A Trustpilot egységenként működik: minden egységnek saját Trustpilot Business-fiókja van (az API fizetős előfizetéshez tartozik), ebből származik a kulcs, a titkos kulcs és a business user ID. A kasszában minden módnál látható: "Ki intézi ezt?".
• A szállító alkalmazása (az ügyfélportálon keresztül): ha a szállító Google- és/vagy Trustpilot-alkalmazása megvan az ügyfélportálon (lásd a horecapos-portaal README-jét, "Reviews: apps van de leverancier"), a rendszergazda a Bejelentkezés és kulcsok résznél az A szállító alkalmazása lehetőséget választja (új kapcsolatnál ez az alapértelmezés, ha a portálon megvan az alkalmazás). Az üzlet a Csatlakozás a Google-hoz vagy a Bejelentkezés Trustpilottal gombra koppint, és a saját fiókjával jelentkezik be; a kassza maga várja meg, amíg a bejelentkezés kész (minden 3 másodpercben, legfeljebb 15 percig), és egyszer lekéri a tokeneket a portáltól. A megújítás is a portálon keresztül történik. A kasszában nem kell client-ID, secret vagy API-kulcs; a Trustpilotnál viszont kell a domain és a válaszokhoz a business user ID. A nyilvános Trustpilot ekkor a portál kulcsával olvas. Szükséges: PORTAAL_URL és PORTAAL_SLEUTEL. A Saját alkalmazás vagy API-kulcs továbbra is az alább leírtak szerint működik.
• Kié az értékelés: az értékelések az üzlet saját Google Cégprofilján és saját Trustpilot-oldalán maradnak, a kassza pedig csak a saját kasszaadatbázisában tárolja őket. A válaszok az üzlet nevével jelennek meg. A portál csak továbbítja a bejelentkezést (a memóriában, legfeljebb 15 percig, egyszer lekérhető), és nem tárol értékeléseket vagy tokeneket; a szállító alkalmazásának neve csak a hozzájárulási képernyőn látszik.
• Saját regisztráció: minden platformnál van egy link, amellyel saját maga hozhat létre Google Cégprofilt (business.google.com/create) vagy Trustpilot Business-fiókot (business.trustpilot.com), a Trustpilotnál pedig a csomagokhoz is (business.trustpilot.com/plans). A regisztráció és a fizetés magánál a platformnál történik; erre nincs API.
• Ezután Csatlakozás a Google-hoz, és jelentkezzen be azzal a fiókkal, amely a cégprofilt kezeli. Egy üzlet a profilban = azonnal kiválasztva; több = választás a kasszában.
• Google Places (csak olvasás): a Place ID-val és egy Places API-kulccsal (vagy GOOGLE_PLACES_API_KEY): az átlag, az értékelések száma és a 5 legrelevánsabb értékelés. Így válaszolni nem lehet.
• Trustpilot Business (olvasás és válaszolás): egy Trustpilot Business-alkalmazás API-kulcsa és API-titka (Integrations → API; vagy TRUSTPILOT_API_KEY és TRUSTPILOT_API_SECRET), az üzlet domainje (a kassza megkeresi a business unitot), valamint a válaszokhoz a válaszoló business user ID-ja.
• Trustpilot nyilvános (csak olvasás): csak az API-kulcs.
• A kassza 30 percenként kér le (és közvetlenül a csatlakozás után; Lekérés most). A vendég e-mail-címét és rendelésszámát (amelyet a Trustpilot átad) a kassza nem tárolja.
• Jelentés → Értékelések: átlag, darabszám csillagonként, válasz nélküli és olvasatlan; szűrés platformra, csillagokra, válasz nélküliekre és olvasatlanokra. Értékelésenként Válasz (legfeljebb 4000 karakter; mindenki láthatja), Válasz módosítása, Válasz törlése és Olvasott. Az új vagy módosított értékelés olvasatlan. A naplóban review_beantwoord és review_antwoord_weg szerepel.
• A leválasztás után a lekért értékelések megmaradnak.

SMS- és e-mail-marketing

Üzenetek azoknak a törzsvásárlói kártyás vendégeknek, akik ehhez hozzájárultak. Törzsvásárlói kártya nélkül egyik sem kapcsolható be.

• Hozzájárulás vendégenként és csatornánként: új vendégnél a kasszánál ott vannak a "A vendég SMS-ben kér akciókat" és "... e-mailben kér akciókat" pipák (alapból kikapcsolva). A Jelentés → Vendégek alatt látod és módosítod a hozzájárulást (a megadás dátumával) és a születésnapot (csak nap és hónap). Leiratkozás: vedd ki a pipákat és mentsd.
• Azonnal frissülő menü: ha be- vagy kikapcsolod a marketinget vagy a törzsvásárlói kártyát, a kassza néhány másodpercen belül újra elküldi a menüt a webshopnak (csak ha valami változott), így a jelölőnégyzet azonnal megjelenik vagy eltűnik.
• Hozzájárulás a webshopon keresztül: ha az üzletnek van webshopja, fizetéskor megjelenik az "Szeretnék ajánlatokat kapni e-mailben/SMS-ben" jelölőnégyzet (csak a bekapcsolt csatornákkal; alapértelmezetten nincs bejelölve). Ha ilyen rendelés érkezik, a kassza telefonszám (különben e-mail-cím) alapján megkeresi a vendéget, szükség esetén létrehozza, és dátummal rögzíti a hozzájárulást. Meglévő vendégnél a hiányzó szám vagy cím kiegészül; a naplóban klant_toestemming szerepel webshop forrással.
• Jelentés → Marketing (Törzsvásárlói kártya kezelése jogosultság): felül látod, hány vendég járult hozzá az SMS-hez és hány az e-mailhez.
• Akciók (egyszeri): név, SMS vagy e-mail, (tárgy,) szöveg {naam}, {zaak} és {punten} mezőkkel, és ha kell, csak azok a vendégek, akik egy ideje nem jártak itt, vagy legalább ennyi pontjuk van. A Megtekintés megmutatja, hány vendégnek megy, az üzenetet úgy, ahogy a vendég megkapja, és az SMS-ek számát vendégenként. Teszt küldése a saját számodra vagy címedre. Utána Küldés: a kassza a háttérben küld (egyszerre legfeljebb 1000) és számolja, mi ment el és mi nem sikerült. Senki sem kapja meg kétszer ugyanazt az akciót; ha a kassza félúton leáll, a Küldés folytatása ott folytatja, akik még nem kaptak semmit.
• Küldés a Mailchimpen vagy a Klaviyón keresztül (egy kiválasztott listával létesített kapcsolattal, lásd lent): e-mailes akciónál a Küldés módja mezőben a kasszát (a saját levelezőszervert, ahogy fent), vagy a Mailchimpet, illetve a Klaviyót választod. Ekkor a kassza előbb frissíti a listát (leiratkozások, pontok), majd ott létrehoz egy kampányt pontosan azoknak a kiválasztott vendégeknek, akik a listán szerepelnek (Mailchimp: egy állandó csoport az audience-en; Klaviyo: egy saját lista az akcióhoz), és elküldi az audience vagy a fiók alapértelmezett feladójával. A {naam} és {punten} mezőt a Mailchimp/Klaviyo tölti ki vendégenként; alatta a szolgáltatás leiratkozási linkje áll. Nincs alkalmanként 1000 fős korlát, és nincs személyes kedvezménykód ({code}). Ha nem sikerül, az akció piszkozat marad, mellette az üzenettel. A Marketing fül akkor is megjelenik, ha csak a kapcsolat aktív (ilyenkor csak Mailchimpen/Klaviyón keresztüli akciók; a Teszt küldése a kassza levelezőszerverével megy). Az automatikus üzeneteket a kassza mindig maga küldi; a Mailchimpben/Klaviyóban ezeket Customer Journeyként vagy Flowként hozod létre. Klaviyo-kulcs: írási jog a Campaigns és Templates területekhez is (aki már bejelentkezett: jelentkezzen be újra).
• Push-értesítésként a webshopon keresztül (ha a webshop kezelésében be vannak kapcsolva az ajánlatokat is küldő Push-értesítések): a Küldés módja mezőben válaszd a Push-értesítés (webshop alkalmazásként) lehetőséget, egy címmel (legfeljebb 60 karakter) és egy rövid szöveggel (legfeljebb 200 karakter; csak a {zaak} töltődik ki, mert a webshop nem tudja, ki a vendég). A kassza a kezelőportálon keresztül küldi az akciót a webshopnak, az pedig azoknak a vendégeknek küldi tovább, akik ott bekapcsolják az Ajánlatok értesítésként lehetőséget; koppintásra megnyílik a webshop menüje. Néhány másodperc múlva az akciónál látszik, hány értesítés érkezett meg. Legfeljebb napi 3, azzal együtt, amit a vendéglátóhely a webshop kezelésében küld; különben az akció piszkozat marad, az okkal együtt. A Marketing fül akkor is megjelenik, ha csak ez van bekapcsolva (törzsvásárlói kártya vagy e-mail-marketing nélkül). Nincs kedvezménykód vagy szűrés (napok, pontok); teszteléshez a saját telefonodon a webshopban kapcsold be az Ajánlatok értesítésként lehetőséget.
• Automatikusan: születésnapi üzenet (a születésnapon, évente egyszer) és "Hiányzol nekünk" (ennyi nap látogatás nélkül után, egyszer minden alkalommal, amikor a vendég elmarad). Üzenetenként be/ki; csak napközben (10:00–20:00) mennek ki.
• Személyes kedvezménykód (opcionális, üzenetenként vagy akciónként; csak ha a Kedvezménykódok be vannak kapcsolva a Beállítások → Üzlet alatt): minden vendég saját kódot kap, pl. TERUG-7K4Q2M (születésnap JARIG-…, akció ACTIE-…), százalékban vagy fix összegben, igény szerint minimális rendelési összeggel, egyszer használható, a küldés után a beállított számú napig érvényes (alapértelmezés 30), a kasszánál és/vagy a webshopban. Tedd a {code} és {geldig} részt a szövegbe oda, ahol szeretnéd; különben a kassza az üzenet alá ezt teszi: "Uw kortingscode: … (10% korting, aan de kassa of in de webshop, geldig t/m …)". A Megtekintés és a Teszt küldése mintakódot mutat (TERUG-VOORBEELD, nem működik). Ha a küldés nem sikerül, a kód nem jön létre. Az akciónál látszik, hány kódot adtak ki és használtak fel.
• A leiratkozás minden üzenet alján ott van: SMS-nél "Leiratkozás? Hívjon ... vagy szóljon a következő látogatásakor", e-mailnél leiratkozási link az üzlet e-mail-címére (a Gmail és az Outlook Leiratkozás gombja is). Az e-mailre adott válasz az üzlethez megy.
• Adatvédelem (GDPR): csak hozzájáruló vendégek, akiknek van számuk vagy címük; a naplóban nincsenek számok vagy címek, csak akciónként az elküldött és sikertelen üzenetek száma. Ha törölsz egy vendéget, a címzettlistáról is eltűnik.
• Költségek: az SMS-ek a saját CM.com-fiókodon keresztül mennek (160 karakter felett = több SMS vendégenként). A Gmailnek és más levelezőszervereknek napi korlátja van; sok vendégnél részletekben küldd.

Borravaló munkatársanként

A Beállítások → Üzlet → Borravaló menüben (csak ha a "Borravaló-gombok mutatása fizetéskor" be van kapcsolva) választhatod ki, hogyan jelenjen meg a munkatársankénti borravaló a részösszesítőn (X), a Z-jelentésen (bon és e-mail) és az Időszakos forgalomban (a CSV-ben is):

A maradék centek ahhoz kerülnek, aki a legközelebb van a következő centhez, így a végösszeg mindig stimmel. Ez csak áttekintés: a kassza nem fizet ki semmit (erre a "Pénz ki a fiókból" szolgál). A régi Z-jelentések változatlanok maradnak.

Z-jelentés e-mailben

A Beállítások → Üzlet → Z-jelentés küldése ide mezőben egyszer add meg az adminisztrátor e-mail-címét (több cím: vesszővel elválasztva, max. 3). A Napzárás után a Z-jelentés automatikusan erre a címre megy, a kinyomtatott bon mellett. Üres = nincs e-mail, ahogy eddig.

• A küldés a háttérben történik, így egy lassú levelezőszerver nem tartja fel a napzárást.
• Ha nem sikerült, vagy újra kell: Jelentés → Korábbi Z-jelentések → (jelentés) → Újraküldés (MÁSOLAT jelzéssel).

Napi összefoglaló (opcionális)

Ha a Z-jelentés küldése e-mailben ide mezőben van cím, alatta található a Rövid napi összefoglalóval a levél elején jelölőnégyzet (alapértelmezés: ki). Be = a Z-jelentés levelének elején néhány sor közérthető nyelven, kizárólag a kassza saját adataiból (nincs MI, semmi nem megy ki):

• forgalom, nyugták és vendégek, valamint az egy nyugtára jutó költés, az egy héttel korábbi azonos időszakhoz képest (százalékban); ha akkor nem volt semmi, azt is jelzi;
• a 5 legkelendőbb termék, és ami feltűnő: azok a termékek, amelyekből legalább 3 darabbal több vagy kevesebb fogyott, mint az előző héten;
• a sztornók száma (az előző héthez képest) és a legforgalmasabb óra (nyugták és forgalom).

Maga a Z-jelentés (blokk és levél) pontosan ugyanaz marad. A Mai előnézet az összefoglalót mutatja az utolsó napzárástól mostanáig. Az összefoglaló holland nyelvű, akárcsak a Z-jelentés levele.

Irányítópult

Irányítópult fül a Jelentésben (Időszakos forgalom jogosultság), csak olvasható:

• Óránkénti forgalom grafikonon: a kiválasztott nap (kék) az előző hét ugyanazon napja (szürke) mellett. A mai nap az előző héttel ugyanaddig az időpontig van összevetve, így a százalék korrekt. A ◀ ▶ gombokkal vagy a dátummal másik napot választhatsz.
• Csempék: forgalom (± % az előző héthez képest), bonok és átlag bononként, átlagos költés vendégenként (csak helyben fogyasztás; az elvitel/házhozszállítás nem számít bele) az adott napra és a kiválasztott időszakra.
• Top 10 termék és legforgalmasabb órák az elmúlt 7, 28 vagy 90 napra. A legforgalmasabb órák egy hőtérkép hét napja × óra szerint (átlagos forgalom nyitvatartási naponként), felette a három legforgalmasabb órával, hasznos a beosztáshoz.

Az eladott ajándékutalványok nem számítanak forgalomnak, a kedvezmények és menüfejlécek pedig nem kerülnek be a top 10-ba (ahogy a többi jelentésben sem). Egy nap 00:00-tól 24:00-ig tart.

Extra jelentések

Három extra fül a Jelentés menüben, mindegyik külön bekapcsolható: Beállítások → Üzlet → Kezelés és jelentések → Extra jelentések (alapból ki: ekkor nincs fül). Ugyanazt a jogosultságot igénylik, mint a Forgalom időszakonként, és csak olvashatók. Időszak: ez a hét, előző hét, ez a hónap, előző hónap, az utolsó 90 nap, ez az év vagy egyéni (legfeljebb valamivel több mint egy év).

• Menu engineering: termékenként, hogy milyen gyakran adták el (részesedés az összes eladott darabból), szemben azzal, hogy darabonként mennyit hoz (árrés = áfa nélküli eladási ár mínusz önköltség). Minden termék besorolást kap: Sztár (népszerű és nagy árrés: hagyd így), Igásló (népszerű, kis árrés: emeld kicsit az árat vagy csökkentsd a költséget), Rejtvény (kevés eladás, nagy árrés: tedd jobban láthatóvá) és Kutya (kevés eladás, kis árrés: vedd le a kínálatról vagy cseréld le). Népszerű = legalább egy egyenlő rész 70%-a; nagy árrés = legalább az eladott darabonkénti átlagos árrés. Az önköltség az Apicbase-ből jön (Beállítások → Receptúrák), különben a termék beszerzési árából (csomagonkénti beszerzési ár osztva a csomagonkénti darabszámmal), különben a beszerzési árral rendelkező hozzávalók receptjéből (Készlet). Az önköltség nélküli termékek külön, alul szerepelnek. Opcionálisan termékcsoportonként (?groep=).
• Akciók és kódok: kedvezménykódonként, Marketing-akciónként (a személyes kódok együtt) és happy hourönként: hányszor használták (blokkok; happy hournál a darabok is), mennyi kedvezmény, a forgalom és a blokkonkénti átlag.
• Veszteség: mi lett leírva a készletből (Beállítások → Készlet, Leírás (−)), okonként (a kis- és nagybetűk és a szóközök nem számítanak) és termékenként vagy hozzávalónként, önköltségen számított értékkel; valamint mi lett sztornózva, miután már elküldték a konyhára vagy a bárba, eladási és önköltségi értékkel.

Kedvezmények

A menedzser vagy adminisztrátor a rendelési képernyőn a végösszeg mellett látja a % Kedvezmény gombot:

• a teljes bonra vagy egy tételre;
• százalékként (10, 15, 20, 25, 50, 100% = ingyenes, vagy egyéni érték) vagy fix összegként;
• mindig indoklással (Személyzet, Törzsvendég, Panasz, Akció, Saját fogyasztás vagy saját szöveg).

A kedvezmény külön tételként jelenik meg a nyugtán ("Kedvezmény 10%", alatta az okkal) ugyanazzal az áfakulccsal, így a végösszeg és az áfabontás is stimmel. Az egész nyugtára a kedvezmény áfakulcsonként oszlik meg. Törlés: koppints a kedvezménytétel összegére. Ha egy saját kedvezményes tételt sztornóznak, a kedvezmény is vele együtt megszűnik. Ha egy terméket törölsz egy egész nyugtára adott százalékos kedvezményű nyugtáról, a kassza újraszámolja a kedvezményt a megmaradt részre (Belgiumban UC226); a fix összeg megmarad, és fizetéskor újra elosztódik a tételek között. Ha a(z) 100% kedvezmény miatt nincs mit fizetni, zárd le a "Lezárás (nincs mit fizetni)" gombbal. A kedvezmények a naplóban, valamint az X/Z-jelentésben és az időszaki áttekintésben "ebből kedvezmény" néven szerepelnek. Kedvezményes nyugta visszavételekor a kedvezmény arányosan érvényesül.

Kedvezménykódok (opcionális)

Kódok, amelyek az egész nyugtára adnak kedvezményt, például egy akcióhoz (ZOMER10). Bekapcsolás: Beállítások → Üzlet → Kedvezménykódok (alapból ki); a kódokat a Beállítások → Kedvezménykódok menüben hozod létre (Termékek kezelése jogosultság):

• kedvezmény százalékban vagy fix összegben, igény szerint minimális rendelési összeggel, érvényesség kezdetével/végével és legfeljebb ennyi használattal (üres = korlátlan);
• kódonként: a kasszán és/vagy a webshopban (a kassza a kódokat a menüvel együtt küldi; a használat a kasszában és a webshopban együtt számít).

A rendelési képernyőn található a Kedvezménykód gomb (bárki beírhat kódot; a kódot előre az üzlet hozza létre). A kedvezmény "Kedvezménykód CODE" sorként jelenik meg a nyugtán, az áfakulcsok között elosztva; nyugtánként egy kód, és már nem, ha (részben) fizettek. Ha törlöd a sort, vagy a rendelést sztornózzák, a használat már nem számít. Egy már használt kód törlése kikapcsolja azt (a riportok helyesek maradnak). Minden a naplóban szerepel (Kedvezménykód). Kód: lib/kortingscodes.ts, routes/kortingscodes.ts, Kortingscodebeheer.tsx, KortingscodeDialoog.tsx.

Nem szerepelnek a Beállítások → Kedvezménykódok listájában (az akciónkénti darabszám viszont igen, a Jelentés → Marketing alatt), és amíg érvényesek és felhasználatlanok, átkerülnek a webshopba.

Jelentések és napzárás

Jelentés gomb a felső sávban:

• Részösszesítő (X): forgalom, áfa, fizetési módok, csoportonként és a kasszafiók az előző napzárás óta. Nyomtatható is. Nem zár le semmit.
• Napzárás (Z) (menedzser vagy adminisztrátor): a kasszafiók megszámolása (megjelenik az eltérés a váltópénz + készpénz összegéhez képest), a következő napi váltópénz megadása, lezárás. A Z-jelentés folyamatos sorszámot kap, el lesz mentve, és kinyomtatódik a bonnyomtatón. Amíg nyitott rendelések vannak, nem lehetséges. Opcionális: a Számolás címletenként (számolási segéd) kitölti helyetted a megszámolt összeget; a címletenkénti számolás ekkor a Z-jelentésre is rákerül. A végösszeg kézi beírása ugyanúgy működik, mint eddig.
• Kasszafiók (menedzser vagy adminisztrátor, opcionális):
  • Pénz ki a fiókból (befizetés a bankba, kiadás, kifizetett borravaló) vagy pénz be a fiókba (váltópénz) összeggel és indoklással. A fiók kinyílik, és egy aláírósoros bon jön ki, amelyet a pénz mellett lehet tartani (kikapcsolható). Beleszámít a fiókban várható összegbe, és tételesen szerepel az X- és Z-jelentésen.
  • A mai váltópénz megadása vagy javítása (általában a napzáráskor adod meg a következő napra).
  • Fiók nyitása eladás nélkül, indoklással.
  • Minden a naplóba kerül. Ha ezt nem használod, a napzárás pontosan úgy működik, mint eddig (váltópénz + készpénz = fiókban várható).
• A forgalom alatt látható a vendégek száma (a kifizetett rendelések személyszáma) és az átlag vendégenként, a kinyomtatott X/Z-jelentésen is.
• Időszakos forgalom (menedzser vagy adminisztrátor): ma, tegnap, ez/előző hét, ez/előző hónap, ez az év vagy egyéni időszak. Mutatja a forgalmat, az áfát, a fizetési módokat, a borravalót, a vendégeket, a termékcsoportokat, naponként és munkatársanként. Az Exportálás (Excel/CSV) gombbal fájlt kapsz a könyvelőnek (pontosvesszők és tizedesvessző, a holland Excelben közvetlenül megnyílik).
• Korábbi Z-jelentések: lista forgalommal és pénztári eltéréssel; megnyitás és másolat nyomtatása ("MÁSOLAT" jelzéssel).

Export a könyveléshez

A Jelentés → Forgalom időszakonként → Könyvelési export (napló) (Forgalom időszakonként jogosultság) egy CSV-t készít naponta egy naplótétellel, amely beolvasható az e-Boekhouden, Exact, SnelStart, Twinfield stb. programokba (azok CSV- vagy vegyes tétel importján keresztül), vagy az alábbi formátumok egyikét (UBL, XAF és készre formázott fájlok 14 programhoz).

Naponként egy bizonylat (KASSA-JJJJMMDD), amely mindig egyezik (tartozik = követel):

A visszáruk és kedvezmények már benne vannak a bonokban, és csökkentik a forgalmat. Oszlopok: Datum; Boekstuk; Dagboek; Rekening; Omschrijving; Debet; Credit; Btw-code; Btw-% (pontosvesszők, tizedesvessző). A letöltés után a kassza jelzi, ha vannak olyan napok, amelyek nem egyeznek, vagy a kerekítésnél nagyobb eltérésük van.

A gomb mellett választod ki a formátumot (a választást a böngésző megjegyzi). Ugyanaz a napló, de úgy formázva, hogy a program közvetlenül be tudja olvasni. A lista csak az üzlet országához tartozó formátumokat mutatja (Beállítások → Üzlet), előbb a szabványokat (CSV, UBL, XAF), majd a programokat ábécérendben:

Áttekintés: melyik könyvelőprogram milyen módon

Szegmensenként, ábécérendben. NL/BE = melyik országban működik a program: a Beállítások → Könyvelés → Könyvelőprogram alatt csak az üzlet országához tartozó programokat látod (a holland programok nem működnek Belgiumban, és fordítva). Élő = a kassza minden nap maga könyvel (kiválasztás: Beállítások → Könyvelés → Könyvelőprogram); kérésre = van API, de ehhez előbb partnerregisztráció vagy a szállító jóváhagyása szükséges (szólj nekünk). Fájl = a formátum a Könyvelési export alatt. Ahol mindkettő lehetséges, mindkettőt használhatod. A lista a packages/shared/src/boekhoudcatalogus.ts fájlban található, és a Beállítások → Könyvelés alatt is megjelenik.

Az első importot nézesd át a könyvelővel. A formázás a packages/shared/src/journaalexport.ts fájlban van (tesztekkel).

Beállítások → Könyvelés (Üzlet, fizetés és nyomtatók beállítása jogosultság): naplókód (alapértelmezett MEM) és a főkönyvi számla részegységenként. Üres = példaszámla (NL: 8000/8010/8020 forgalom, 1500/1510 áfa, 1000 pénztár, 1100 kártya; BE: 7000xx forgalom, 451000 áfa, 570000 pénztár). A valódi számlákat a könyvelő töltse ki.

Kapcsolat könyvelőprogrammal

Élő kapcsolatok: Acumulus, AFAS Profit, Microsoft Dynamics 365 Business Central, Exact Online, Horus, Moneybird, Odoo, QuickBooks Online, SAP Business One, Silvasoft, SnelStart, Twinfield, Xero, Yuki és Zoho Books. Minden nap után a kassza ugyanazt a tételt, mint a fenti export (forgalom és áfa kulcsonként, fizetési módok, borravaló, kerekítés, fiók és kasszakülönbözet) vegyes könyvelési tételként könyveli a kiválasztott programba, a Beállítások → Könyvelés naplójával és főkönyvi számláival. Egyszerre legfeljebb egy program lehet bekapcsolva.

• A lista szegmensenként van csoportosítva (kisvállalkozások és egyéni vállalkozók, nemzetközi, enterprise és láncok), és csak azokat a programokat mutatja, amelyek az üzlet országában működnek; a szerver elutasítja a más országhoz tartozó programot (400), és nem könyvel vele (409). Közvetlenül alatta az adminisztrátor pontosan az adott program mezőit kapja; a csatlakozás és a lekönyvelt napok listája a főkönyvi számlák alatt található, alatta pedig az ország összes programjának áttekintése. Ha a frissítéskor kettő volt bekapcsolva (egy régebbi verzióban ez lehetséges volt), az Exact Online bekapcsolva marad, a másik program pedig kikapcsol.

• OAuth (Horus, QuickBooks, Twinfield, Xero, Zoho): egyszer kell regisztrálni egy alkalmazást a programnál.
• Néhány programnál az API mezői nem erősíthetők meg teljesen a nyilvános dokumentáció alapján (többek között Horus, Zoho Books, az előjel a Business Centralnál és a felépítés az SAP Business One-nál): az első könyvelést mindig ellenőriztesd a könyvelővel.
• Exact Online: a tételt vegyes könyvelési tételként könyveli a kiválasztott cégbe.
  • Kiválasztás: Beállítások → Könyvelés → Könyvelőprogram → Exact Online (alapból Ki). Belgium: a kassza automatikusan a start.exactonline.be címet használja.
  • Beállítások → Könyvelés → Exact Online: a Csatlakozás az Exact Online-hoz megnyitja az Exact bejelentkezést; utána látszik, melyik céghez csatlakozik a kassza. A Napló mezőbe egy vegyes napló kódját írd az Exactból (pl. 90), és gondoskodj róla, hogy a főkönyvi számlák létezzenek az Exactban.
  • Mikor: rögtön a Napzárás után, majd óránként, minden elmúlt napra (tegnapig bezárólag) a Könyvelés ettől dátumtól (alapból a csatlakozás napjától; a korábbi napok már megvannak a könyvelőnél). Minden nap egyszer; a forgalom nélküli napokat kihagyja. A Könyvelés most bármikor működik.
  • A hibák (egy számla nem létezik az Exactban, a nap nem egyezik, nincs internet) okkal együtt az adott napnál láthatók; a kassza később újra próbálja, a következő napok pedig megvárják, amíg sikerül (így marad jó a sorrend). A naplóban: "exact_geboekt".
  • Az áfa az áfa-főkönyvi számlákra kerül (áfakód nélkül, mint az exportban). Az első könyveléseket nézesd át a könyvelőddel.
  • Exact: a kapcsolat addig működik, amíg a kassza használja (10 percenként új token, minden alkalommal új refresh token). Ha visszavonták vagy túl sokáig nem használták, a kassza Újracsatlakozást kér. A Párosítás bontása törli a tokeneket; ami le van könyvelve, megmarad.
• AFAS Profit: környezetszám (pl. 12345; éles, teszt vagy átvételi), egy app-connector tokenje az UpdateConnector FiEntries használatával, és a cég száma (alapértelmezés: 1). Napló = egy vegyes napló kódja az AFAS-ban (pl. 90).
• Napló = egy vegyes napló száma vagy neve; ha csak egy vegyes napló van, a kassza azt használja. A főkönyvi számláknak számoknak kell lenniük.
• Twinfield: bejelentkezés OAuth-tal. Ezen alkalmazás nélkül a kassza nem tud csatlakozni. A kassza megkeresi a clustert és az adminisztrációt (üres = az első); napló = egy vegyes napló kódja (pl. MEMO). Véglegesen könyvel (destiny="final").
• Yuki: a cég API-kulcsa (Yuki → Beállítások → Webszolgáltatások); üres cég = a kulcshoz tartozó első. Vegyes könyvelési tételt könyvel (GeneralJournal); a Yuki nem használ naplókódot.
• Mikor: közvetlenül a Napzárás után és óránként, az összes elmúlt napra a Könyvelés ettől dátumtól kezdve (alapértelmezés a csatlakozás napja; másik programnál újra ettől a naptól). Minden nap programonként egyszer; a forgalom nélküli napok kimaradnak; hiba esetén az ok az adott napnál látható, és a következő napok várnak. A Könyvelés most bármikor használható. A naplóban: "boekhoudpakket_geboekt".
• A kulcsok és tokenek soha nem jelennek meg a képernyőn (újracsatlakozáskor üresen hagyva = megtartás). A kassza portálon lévő másolatán nem történik könyvelés.

Kassza-auditfájl (XAA)

Holland üzleteknél a Jelentés → Forgalom időszakonként menüben a könyvelési export mellett ott a Kassza-auditfájl (XAA) gomb: a Belastingdienst (holland adóhatóság) és az XML Platform (SRA) XML Auditfile Afrekensystemen 3.2 formátuma a kiválasztott időszakra (legfeljebb valamivel több mint egy évre; jogosultság: Forgalom időszakonként). Ezt a fájlt ajánlja a Belastingdienst egy kassza adatainak átadására ellenőrzéskor vagy a könyvelőnek; a szabályok a Handreiking voor een betrouwbaar afrekensysteem (útmutató a megbízható pénztárrendszerhez) című dokumentumban vannak (docs/xaa).

A fájlban (auditfile_kassa_<van>_tm_<tot>.xml, séma: docs/xaa/XmlAuditfileAfrekensystemen3.2.xsd):

• törzsadatok: az üzlet (név, adószám, cím), az áfakódok, az összes munkatárs (szerepkörrel és a létrehozás dátumával; plusz SYSTEEM arra, amit a kassza maga végez, például a webshop és a kapcsolatok) és az összes termék a csoportjával;
• események: minden, ami az időszakban a naplóba került (be- és kijelentkezés, kasszafiók nyitása, napzárás, beállítások és árak módosítása, sztornó, kedvezmény, visszáru, nyugtamásolat, be- és kiblokkolás ...), valamint a kasszanap megnyitása a nyitó váltópénzzel, mindegyik a Belastingdienst kódjával (18001 bejelentkezés, 18003 fiók, 18006 telepítés módosítása, 18008 Z-jelentés, egyébként 18999);
• pénztári tranzakciók: minden nyugta (eladás, visszáru és proforma, a nyugtaszámmal, a munkatárssal és a fiskális állapottal, ha az nincs rendben) az összes tétellel (termék, csoport, mennyiség, ár, áfa; a kedvezmények, ajándékutalványok, menüfejlécek és a fizetés előtt törölt tételek is, utóbbiak 0 összeggel), az áfa kulcsonként, a kerekítés, a fizetések fizetési módonként (készpénz, kártya, ajándékutalvány, online; a borravaló külön), valamint a kasszafiókba be- és onnan kivett pénz.

Az összegek pozitívak, C (eladás, bevétel) vagy D (visszáru, kifizetés) jelöléssel; az időpontok holland idő szerint, eltolással. Minden kulcs az adatbázisbeli azonosító kötőjelek nélkül, így visszakereshető a kasszában.

Aláírás (a specifikáció 6. fejezete): ha az Optimum POS beállított egy tanúsítványt, az auditfájl aláírva, borítékban (XML Signature) készül, és a fájl neve …_ondertekend.xml; egyébként egyszerű auditfájl, és ezt a kassza a letöltéskor jelzi.

Számlára vásárlás

A céges ügyfelek (egy cég, amely hetente ebédet rendel elvitelre, egy szálloda, egy egyesület) számlára vásárolnak, és később fizetnek, számla alapján. Kapcsold be itt: Beállítások → Számlák → Számlára vásárlás (csak bekapcsolt Számlák mellett; alapból ki).

• Ügyfelek: a Jelentés → Számlára menüben rögzíted a céges ügyfeleket a számlához szükséges adatokkal (név, cím, adószám, cégjegyzékszám/KvK, Peppol-ID, e-mail), igény szerint egy hitelkerettel (legfeljebb mennyi lehet nyitott) és saját fizetési határidővel (különben a számláké), valamint hogy a számla azonnal elmenjen-e.
• Fizetés: fizetési mód Számlára, válaszd ki az ügyfelet (a már nyitott összeggel és a hitelkerettel). A nyugta normál eladás: bevétel és ÁFA az adott napon, Belgiumban rendesen a fekete dobozon át, a nyugtán "Számlára". A kassza azonnal elkészíti a számlát (UBL/Peppol és nyomtatható) a még nyitott összegről az esedékességgel, és elküldi a számláknál beállítottak szerint (e-mail, Peppol a Billit/Storecove/Banqup útján vagy saját cím). A számlára egy összeg a számla maradéka (előtte egy rész másképp is fizethető), borravaló nélkül; ajándékutalványt nem lehet számlára eladni. A hitelkeret felett a kassza elutasítja.
• Kiegyenlítés: az ügyfél az üzletben fizet készpénzzel, kártyával vagy ajándékutalvánnyal (Jelentés → Számlára → Fizetés beérkezett; részben is). Ez nem új eladás és nem új nyugta: a készpénz a fiókba kerül (a fiók kinyílik), minden a X és Z jelentésen a Számlára befizetve alatt szerepel. Ha minden ki van fizetve, a számla állapota "fizetve". Az online fizetés nem tartozik ide.
• Átutalva: ha az Adatok a számlán részben meg van adva IBAN, az megjelenik a számlán (és az UBL-ben) a "Fizetni az üzletben is lehet" szöveggel. Ha az ügyfél átutalta, ezt a Fizetés beérkezett → Átutalva (bank) gombbal rögzíted: nem kerül a fiókba, de az X és Z jelentésen a Számlára befizetve alatt szerepel. IBAN nélkül ez áll rajta: "Fizetendő az üzletben". Belgiumban strukturált közlemény (+++123/4567/89012+++, a számlaszámból) szerepel a számlán és az UBL-ben, így a bank is továbbítja.
• Bank: átutalások lekönyvelése begépelés nélkül, lásd lent.
• Egyenleg (előre befizetett pénz): a Jelentés → Számlára → Egyenleg befizetése menüben előre pénzt teszel egy ügyfél számlájára, készpénzben (a fiók kinyílik) vagy kártyával, pl. egy sorozat ebédhez. A következő számlás eladásnál az egyenleg először a számlából vonódik le; ha a számla nagyobb, a többi nyitva marad. Az egyenleg az ügyfélnél látható (egyenleg € ...), a X és Z jelentésen a Számlára befizetve alatt (Egyenleg befizetve, Az ügyfél egyenlegéből), a könyvelési tételben pedig előre kapottként (alapból 1640 / 460000). Belgiumban a befizetés pénzbevételként (signMoneyInOut) kerül a fekete dobozba (UC4100).
• Gyűjtőszámla (ügyfelenként, alapból ki): az Egy számla minden blokkra beállítással az ügyfél számlás eladáskor még nem kap számlát. A blokk nyitva marad az ügyfélnél (Még nem számlázott blokkok, beleszámít a hitelkeretbe), és már ki is fizethető. A Gyűjtőszámla készítése gombbal (pl. a hónap végén) minden nyitott blokk egy számlára kerül, minden tétel előtt a blokkszámmal; ami már ki van fizetve, az fizetettként szerepel. A számlára történő visszáru negatív tételekként kerül rá. Ki = mint mindig, eladásonként egy számla. Belgiumban egy számla az összes blokkal a fekete dobozban (signInvoice, UC4121 és UC4122).
• Belgium: ha az ügyfél később kifizet egy számlás eladást (készpénz, kártya, ajándékutalvány vagy átutalás), a kassza ezt fizetéskorrekcióként jelenti a nyugtán: az ügyfélhitelről a tényleges fizetési módra (signPaymentCorrection, UC4118).
• Áttekintés: nyitott számlák az esedékességgel (a lejártak pirossal), ügyfelenként a számlák és fizetések. A Beállítások → Számlák alatt egy Nyitott oszlop.
• Könyvelés: a naplóban a számlára történő eladás a Vevőkövetelések számlára kerül (alapból 1300 Hollandiában, 400000 Belgiumban; beállítható: Beállítások → Könyvelés), a készpénzes, kártyás, ajándékutalványos vagy banki fizetés pedig (alapból 1050 / 550000) a vevőkövetelésekre. XAA: fizetési mód "Számlára".
• Jogosultság: Fizetés számlára és számlára szóló fizetések fogadása (alapból felszolgálás nem, menedzser igen). Minden a naplóban van.
• Kikapcsolva: az ügyfelek, számlák és fizetések megmaradnak (a biztonsági mentésben is); a kapcsoló benne van a konfigurációs exportban, az ügyfelek nem (azok egy üzlethez tartoznak).
• A webshopban (opcionális, alapból ki): az A webshopban is beállítással a céges ügyfelek online, számlára rendelnek (elvitel és kiszállítás). A Jelentés → Számlára menüben ügyfelenként létrehozol egy ügyfélkódot, és átadod az ügyfélnek; a kassza csak titkosított változatot tárol, ezért csak egyszer látod. Új ügyfélkód = a régi többé nem működik; Ügyfélkód törlése = az ügyfél többé nem rendelhet online számlára. A webshop betartja a hitelkeretet. A Webshop ablakban az ilyen rendelést a Lezárás (számlára) gombbal zárod le: fizetés számlára, azonnal a számlával.

Bank: átutalások lekönyvelése

A Jelentés → Számlára → Bank menüben a kassza minden jóváíráshoz megkeresi a hozzá tartozó, számlára kiállított számlát:

• Bankszámlakivonat beolvasása: az internetbankból letöltött fájl, CAMT.053 (XML, minden holland és belga bank), MT940 (.sta/.940) vagy CODA (.cod, Belgium) formátumban. Csak jóváírások; ha egy kivonatot kétszer olvasol be, nem lesznek dupla sorok.
• Keresés: a leírásban szereplő számlaszám vagy strukturált közlemény alapján (biztos), egyébként az összeg (és a név) alapján: ekkor javaslat. Minden sort lekönyvelhetsz (a javasolt vagy egy másik számlához), figyelmen kívül hagyhatsz, vagy később mégis lekönyvelhetsz. Lekönyvelés = Átutalva (bank) a banki dátummal, soha nem több, mint a nyitott összeg; nem kerül a fiókba.
• Bankkapcsolat (PSD2, opcionális): a Beállítások → Számlák → Bankkapcsolat menüben a kassza óránként magától lekéri a jóváírásokat az Enable Banking segítségével (holland, belga és más európai bankok). Válaszd ki a bankot és jelentkezz be a bankba (céges számla); a hozzájárulás 180 napig érvényes, utána újra össze kell kapcsolni. A leválasztás visszavonja a hozzájárulást; a jóváírások megmaradnak. Enable Banking-szerződés nélkül ez csak a saját számláidnál működik (restricted production).
• Automatikus lekönyvelés (alapból ki): a biztosan egy számlához tartozó jóváírást a kassza azonnal lekönyveli (beolvasáskor is).
• Jogosultság: lekönyvelés a Fizetés számlára és számlára szóló fizetések fogadása jogosultsággal; a bankkapcsolat beállítása az Üzlet, fizetés és nyomtatók beállítása jogosultsággal. A beolvasás, összekapcsolás, lekérés és lekönyvelés a naplóba kerül.
• Ki: ha a számlára vásárlás ki van kapcsolva, a kassza semmit nem kér le; a jóváírások és a kapcsolat megmaradnak (a biztonsági mentésben is).

Kameraképek a kasszában

Az üzlet összes kameraképe egy oldalon, külön képernyő vagy alkalmazás nélkül. Bekapcsolás: Beállítások → Üzlet → Képernyők és kezelés → Kameraképek a kasszában (alapból ki). Ekkor a felső sávban megjelenik a Kamerák gomb annak, aki rendelkezik a Kameraképek megtekintése jogosultsággal (alapból menedzser és adminisztrátor; a Beállítások → Jogosultságok menüpontban a felszolgálásnak is bekapcsolható). Az összes kamera egymás mellett látható; koppints egy kamerára a nagy képhez. Kikapcsoláskor a kamerarendszerek megmaradnak.

Saját képernyőként is: a Saját képernyőn megnyitja a http://<kassaserver>:3000/camera címet (pl. egy monitoron a pult mögött), a Tableten vagy telefonon pedig QR-kódot mutat: egy munkatárs beolvassa a saját tabletjével vagy telefonjával, és a saját PIN-kódjával jelentkezik be (ott is csak a Kameraképek megtekintése joggal). Keskeny képernyőn a kamerák egymás alatt jelennek meg. Lásd: Második képernyő tableten vagy telefonon.

Az adminisztrátor a + Kamerarendszer gombbal adja hozzá a kamerarendszereket, a Tesztelés gombbal teszteli őket, és kameránként kiválasztja a nevet, valamint hogy megjelenik-e az oldalon:

• Hikvision, Dahua, Axis és Reolink: egy kamera vagy rögzítő (NVR) a hálózatban: az IP-cím (szükség esetén :poort porttal), egy felhasználó (lehetőleg csak megtekintési joggal) és a csatornák, pl. 1-8 vagy 1,3,5. Bejelentkezés Basic vagy Digest módszerrel; saját tanúsítványú https is lehet.
• Synology Surveillance Station: a NAS címe (alapértelmezett port 5000, https esetén 5001) és egy felhasználó; a Kamerák lekérése a nevükkel együtt lekéri a kamerákat.
• UniFi Protect: a konzol címe (https) és egy helyi fiók; Kamerák lekérése.
• ONVIF: bármely ONVIF-os kamera vagy rögzítő (pl. Hanwha, Bosch, Uniview, Annke); a Kamerák lekérése videóforrásonként megkeresi a fényképcímet.
• Saját webcím: egy fénykép (JPEG), egy MJPEG-adatfolyam vagy egy rtsp://-cím.
• A kamerarendszer weboldala (pl. Frigate, Blue Iris vagy go2rtc): a kasszában a Kamerák gombbal nyílik meg (vagy külön ablakban).

ffmpeg nélkül: a fénykép.

Adatvédelem: a kassza a kamerarendszertől kéri le a képeket, és csak továbbítja őket; semmi sem kerül tárolásra (nincs felvétel, nincs gyorsítótár). A felhasználók és jelszavak a szerveren maradnak, és soha nem jelennek meg a képernyőn vagy a naplóban. A naplóban látszik, ki nézte a kamerákat. Magukat a képeket az oldal egy kulccsal kéri le (12 óráig érvényes, amíg a munkatárs be van jelentkezve), mert a böngészőben egy kép nem tud tokent küldeni. A konfiguráció exportálása csak a be/ki állapotot viszi át.

Az érzékeny műveletek naplója

A Jelentés → Napló (menedzser vagy adminisztrátor) megmutatja, ki mit csinált és mikor.

• Válassz időszakot (ma, tegnap, ez a hét, ez/előző hónap vagy egyéni), hogy mit szeretnél látni (alapból Érzékeny műveletek, vagy pl. csak sztornó és kedvezmény, vagy Minden), és ha kell, egy munkatársat.
• Felül munkatársanként: a sztornók (rendelés után törölt tételek), kedvezmények és visszáruk száma és összege, valamint hogy hányszor nyílt ki a fiók eladás nélkül, pénz ki a fiókból, nyugtamásolatok, pro formák és kézi kártyás fizetések. Koppints egy névre, hogy csak azt a munkatársat lásd. A hibásan megadott PIN-kódok száma is látható.
• Alatta minden művelet időponttal, hogy ki, mit, és olvasható leírással (pl. "2x Cola törölve rendelés után € 5,60 · 4. asztal · ok: a vendég nem kérte").
• Letöltés (CSV) Excelhez.

Ami naplózásra kerül: sztornók, kedvezmények (és törlésük), visszáruk, bonmásolatok, pro forma bizonylatok, kézi kártyás fizetés, fiók nyitása, pénz be/ki a fiókba, váltópénz, napzárás, tételek vagy asztalok áthelyezése, üres rendelések lezárása, termékek árának/nevének/áfájának módosítása, új vagy törölt termékek, személyzet és beállítások módosítása, munkaidő módosítása, be- és kijelentkezés, hibás PIN-kódok, valamint be- és kiblokkolás. Számlára történő fizetéssel még: ügyfelek, számlára történő eladások és befizetések, bankszámlakivonatok beolvasása, a bankkapcsolat és a bankból való lekérés. A túl hosszú átfutási idő értesítésével: a késő rendelések és az elküldött bocsánatkérések. Mailchimp vagy Klaviyo esetén: csatlakozás, lista kiválasztása, leválasztás és az ott történt leiratkozások. Zene vezérlése esetén: be/ki, valamint zeneforrások hozzáadása, módosítása és eltávolítása. Kameraképek esetén: ki nézte a kamerákat (munkatársanként legfeljebb félóránként egyszer), be/ki, valamint a kamerarendszerek. Riasztásokkal: minden riasztás, annak lezárása, valamint a be- és kikapcsolás.

Riasztások: csalás és eltérések

Beállítások → Riasztások. Két rész, mindkettő külön kapcsolható be és alapból ki van kapcsolva; kikapcsoláskor minden riasztás és beállítás megmarad. Beállítani az tudja, akinek Riasztások beállítása joga van (alapból a menedzser és az adminisztrátor); a riasztásokat az láthatja és zárhatja le, aki láthatja a naplót. A kassza 5 percenként ellenőriz (és az Ellenőrzés most gombbal); a tartalék kasszán nem.

Csalás- és lopásfigyelés (munkatársanként, munkanaponként 05:00-tól), minden szabály külön be- vagy kikapcsolható, saját határral:

• sztornók a pro forma után: törölve, miután a vendég már látta a számlát;
• sztornók, kedvezmények és visszáruk: bizonyos számú alkalomtól, vagy összesen egy összegtől (0 = nem összeg szerint);
• fióknyitás eladás nélkül (Fiók nyitása gomb);
• sokáig nyitott számla: rendelve, de bizonyos számú perc után még nincs kifizetve.

Értesítések eltéréskor, összehasonlítva az elmúlt hetek azonos napjával és időpontjával (alapból 4; a forgalom nélküli napok nem számítanak, legalább két összehasonlító nap):

• forgalom eddig a megengedett eltérésnél jobban a szokásos alatt (és/vagy fölött), csak egy beállított szokásos forgalomtól;
• konyhai idő (a rendelés konyhára küldésétől a konyhai kijelzőn kész állapotig) az utolsó órában az eltérés fölött, vagy egy fix percszám fölött;
• sztornók ma az eltérés fölött, csak egy minimális számtól.

Minden riasztás egyszer jön (szabályonként, munkatársanként és naponként; a konyhai idő legfeljebb óránként egyszer), és ide megy:

• a kassza: Riasztások (n) gomb a felső sávban az elmúlt nap, hét vagy 30 nap riasztásaival; Lezárva megjegyzéssel. A többi képernyő csak egy jelzést kap nevek nélkül;
• push-értesítés ntfy-jal (ingyenes alkalmazás; ntfy.sh vagy saját szerver, topic és esetleg token), Pushover (az alkalmazás API-tokenje és a user key) vagy Telegram (a bot tokenje és a chat-id);

Minden csatornához van Tesztüzenet gomb. A tokenek és kulcsok a kasszán maradnak (a képernyők csak azt látják, hogy ki vannak-e töltve). A riasztás nem bizonyíték: nézd meg a számlát és a naplót, és beszéld meg a munkatárssal.

Nyugták: másolat és visszáru (jóváíró bon)

Bonok gomb a felső sávban:

• Az utolsó napzárás óta kiállított bonok listája, vagy az utolsó 7 napé; egy régebbi bont a száma alapján kereshetsz meg.
• Másolat nyomtatása: ugyanaz a bon "MÁSOLAT" jelzéssel (Belgiumban az eredeti bon FDM-blokkjával). A naplóba bekerül.
• Visszáru / jóváíró bon (menedzser vagy adminisztrátor): válaszd ki tételenként, mennyi jön vissza, az okot, és hogyan megy vissza a pénz (készpénz, kártya, ajándékutalvány, egyéb). A régi bon érintetlen marad: egy új jóváíró bon készül saját sorszámmal a naplóban (bontípus retour, negatív összegek, Belgiumban NR-ként az FDM felé). Soha nem lehet többet visszavenni, mint amennyit eladtak. Az X- és Z-jelentésben a visszáru mínusz forgalomnak számít.
• CCV vagy más terminál esetén: először magán a terminálon térítsd vissza az összeget, majd pipáld be a "Már visszatérítve a terminálon" lehetőséget.
• Készpénz 5 centre kerekítéssel: a visszaadandó összeg is kerekítve lesz.
• Vissza a számlára (számlás eladás): ha a nyugta egy céges ügyfél számlájára szólt, válaszd a Számlára lehetőséget. Az összeg levonódik a nyitott számlából, és a kassza azonnal jóváíró számlát készít (UBL-ben CreditNote, 381 típus, a számlára való hivatkozással; Belgiumban signInvoice-szal aláírva, UC4122). Többet, mint ami a számlán nyitott, nem lehet visszavinni a számlára; a többit készpénzben vagy kártyára térítsd vissza. A jóváíró számla a Számlák között látható, és ugyanúgy küldöd el, mint egy számlát.

Kasszafiók érzékelővel és fiók munkatársanként

Alapból ki. Beállítás: Beállítások → Fizetés → Kasszafiók.

• Érzékelő: sok fiók a blokknyomtatón keresztül jelzi, hogy nyitva vagy zárva van-e (ESC/POS DLE EOT 1, DK-port 3. tű). Ez csak hálózati blokknyomtatóval lehetséges. Koppints a Mérés: fiók zárva és a Mérés: fiók nyitva gombra; ha van különbség, átveszed a helyes beállítást (magas = nyitva vagy alacsony = nyitva). Nincs különbség = ennek a fióknak (vagy kábelnek) nincs érzékelője. Nincs válasz a nyomtatótól = ismeretlen, soha nem "zárva".
  • Nincs fizetés, amíg a fiók nyitva van: ekkor a kasszaszerver elutasítja az új fizetést ezzel: "A kasszafiók még nyitva van".
• Saját fiók munkatársanként: egy blokknyomtató két fiókot tud nyitni (1. fiók és 2. fiók). Válaszd ki munkatársanként a fiókját; a kassza ekkor készpénzes fizetésnél, pénz be- vagy kivételénél és a Fiók nyitása funkciónál a bejelentkezett munkatárs fiókját nyitja ki. A Jelentés → Kasszafiók alatt ekkor megjelenik a Fiók munkatársanként: nyitó váltópénz munkatársanként, készpénz (a készpénzautomata nélkül), várható összeg, Számolás és a különbözet személyenként (a naplóban ladetelling néven). A normál napzárás változatlan marad.
• A 1. fiók tesztelése és a 2. fiók tesztelése ellenőrzésképpen kinyitja a fiókot.
• A Fiók nyitása eladás nélkül (indoklással) mindig bekerül a naplóba és a kassza-auditfájlba (XAA), ahogy a holland adóhatóság (Belastingdienst) előírja (kivételek, mint a "no sale").

3. rész · Adminisztrátor

Első lépések

Telepítés. A HorecaPOS-t a rendszerednek megfelelő telepítőprogrammal telepítheted, amely az OptimumPOS letöltési oldalán található: Android (alkalmazás), Windows (telepítőprogram), macOS (telepítő Apple Silicon és Intel processzoros Macekhez), Linux (grafikus telepítő, vagy .deb, illetve .rpm csomag), Raspberry Pi (grafikus telepítő vagy .deb Raspberry Pi 3, 4 vagy 5 eszközhöz 64 bites Raspberry Pi OS-sel) és Chromebook (az Android-alkalmazás a Google Playből). Válaszd a minden felhasználónak lehetőséget egy kasszaszerverhez, amelyhez a tabletek és a konyhai kijelző csatlakoznak, vagy a csak nekem lehetőséget, ha csak egy kassza lesz azon az eszközön. A telepítő mindent feltelepít, ami szükséges, az adatbázist is, és minden éjjel biztonsági mentést készít. Frissíteni az új verzió telepítésével lehet: az adataid megmaradnak. A telepítőprogram a számítógéped nyelvén indul (különben angolul); Windowson és Linuxon az első képernyőn más nyelvet is választhatsz. A kassza ezután azonnal ezen a nyelven indul. A .deb és .rpm csomagok és az Android-alkalmazás a rendszer nyelvét követik, különben hollandul jelennek meg.

Az adminisztrátor a Beállítások menüben állítja be a kasszát. Itt olyan fülek találhatók, mint Üzlet, Személyzet, Jogosultságok, Munkaidők, Termékek, Happy hour, Készlet, Asztaltérképek, Fizetés, Nyomtatók, Könyvelés, Biztonsági mentések, Import/export és Adatbázis. Hogy egy menedzser mely füleket látja, az a jogosultságoktól függ.

Adatbázis. A Beállítások → Adatbázis alatt (csak a rendszergazda) választasz a MySQL / MariaDB, a beépített adatbázis és a PostgreSQL között; átállításkor minden adat átkerül (lásd Adatbázis). Ha az Optimum POS a telepítéskor már beállított egy rögzített címet, az a cím érvényes, és nincsenek beviteli mezők. Ellenkező esetben magad töltöd ki a Szerver, Port, Adatbázis, Felhasználó és Jelszó mezőt. A kassza ezeket maga menti, utána újra kitöltve mutatja, és bármikor módosíthatod őket a MySQL/MariaDB-adatok módosítása vagy a PostgreSQL-adatok módosítása gombbal. A jelszó üresen hagyása azt jelenti: a mentett jelszó megmarad (ugyanannál a felhasználónál). A telepítő és a frissítés semmit sem változtat a DATABASE_URL értékén vagy a választott adatbázison.

Könyvelés

A könyveléshez minden a Beállítások → Könyvelés alatt található. A könyvelőddel együtt add meg a naplót és a főkönyvi számlákat. Ha azt szeretnéd, hogy a kassza minden nap maga könyvelje a napi forgalmat, válaszd ki a programodat fent, a Könyvelőprogram alatt, az Exact Online-t is: csak azokat a programokat látod, amelyek az üzleted országában működnek. Közvetlenül alatta megadod a program adatait, és csatlakozol. Azoknál a programoknál, amelyekbe bejelentkezel (például Exact Online, Twinfield vagy Xero), előbb az alkalmazást töltöd ki: ügyfél-azonosító és ügyféltitok. Ha az Optimum POS a telepítéskor rögzítette a programot vagy egy adatot, akkor azt a választást vagy mezőt nem látod. Ott található az összes program áttekintése is: melyik kapcsolható élőben, és melyik kap fájlt. Fájlt a Jelentés → Forgalom időszakonként → Könyvelési export alatt készítesz: válaszd ki a programod formátumát, vagy az UBL (Peppol), XAF vagy napi kimutatás lehetőséget. Az első könyvelést vagy importot mindig ellenőriztesd a könyvelőddel.

Holland üzletnél itt található a Kassza-auditfájl (XAA) is: a Belastingdienst XML Auditfile Afrekensystemen formátuma a kassza összes nyugtájával, tételével, fizetésével és eseményével a kiválasztott időszakra. Ezt a könyvelődnek adod át, vagy ellenőrzéskor a Belastingdienstnek.

Bér és beosztás

Ha a személyzeted be- és kiblokkolással dolgozik, a Beállítások → Munkaidők alján található a Bér és beosztás, két blokkban. A Bérszámfejtés blokkban kiválasztod a bérszámfejtő programodat vagy (Belgiumban) a szociális titkárságodat, és munkatársanként megadod a törzsszámát abban a programban. Ezután egy időszakra elkészíted a fájlt a ledolgozott órákkal és a munkatársankénti forgalommal, és beolvasod a bérszámfejtő programodba. A Munkaerő-beosztás blokkban kiválasztod a beosztáskezelő rendszeredet: a Deputy, Dyflexis és Shiftbase esetén a forgalom óránként automatikusan megy, a többinél forgalmi fájlt készítesz. Így a beosztásodban a bérköltséget a forgalom mellett látod. Ha be- és kiblokkolás nélkül dolgozol, a forgalmat akkor is elküldheted a beosztásodba: ez ilyenkor a Beállítások → Könyvelés alján, a Forgalom a beosztásodba résznél található. Ha az Optimum POS a telepítéskor valamit rögzítetten beállított, azt a választást vagy mezőt nem látod.

Biztonsági mentések

A kassza minden éjjel automatikusan biztonsági mentést készít, és frissítés előtt is mindig. A Beállítások → Biztonsági mentések alatt látod az összes mentést (mikor, ki készítette vagy automatikus, méret), és a Biztonsági mentés készítése gombbal magad is készíthetsz egyet. Ha a legutóbbi mentés két napnál régebbi, piros figyelmeztetés jelenik meg: ilyenkor vedd fel a kapcsolatot az Optimum POS-szal.

A visszaállítás a mentés melletti Visszaállítás gombbal történik. Minden, ami a mentés után történt, elvész. Ezt be kell jelölnöd, és újra meg kell adnod a saját PIN-kódodat. A kassza előbb még biztonsági mentést készít a jelenlegi állapotról, majd mindenkit kijelentkeztet. Belgiumban ez nem végezhető el a kasszáról (a fekete doboz számlálói tovább futnak); ott az Optimum POS végzi el.

Adatbázis

A Beállítások → Adatbázis alatt (csak a rendszergazda) látod, hol tárolja a kassza az adatait. Felül a jelenlegi adatbázis áll, a programmal, verzióval, táblákkal, sorokkal és a címmel vagy mappával. A személyzet és a tabletek számára a kassza minden adatbázissal ugyanúgy működik. Windows, macOS, Linux és Raspberry Pi alatt három adatbázis közül választhatsz:

• MySQL / MariaDB: külön adatbázisprogram (MySQL 8.0 vagy újabb, MariaDB 10.6 vagy újabb), például egy már meglévő szerveren vagy NAS-on. Ekkor minden adat közönséges táblákban van a MySQL-ben vagy MariaDB-ben, a saját riport- vagy BI-programod számára olvashatóan. A kassza pontosan úgy számol, mint PostgreSQL-lel.
• Beépített (PGlite): maga a kassza tartalmazza, semmit sem kell telepíteni. A legtöbb vendéglátóhelynek a legjobb választás, és ez az adatbázis Androidon és Chromebookon.
• PostgreSQL: külön adatbázisprogram a kassza gépén vagy valahol a hálózatban.

Mikor MySQL vagy MariaDB? Ha a vendéglátóhelyednek már van MySQL- vagy MariaDB-szervere, ha az informatikusod azzal dolgozik, vagy ha az adatokat a saját riportjaidban, Excelben vagy BI-programban szeretnéd olvasni. Ha bizonytalan vagy, válaszd a beépítettet: azonnal működik.

Mi kell a MySQL-hez vagy MariaDB-hez?

• MySQL 8.0 vagy újabb, illetve MariaDB 10.6 vagy újabb, amely elérhető a kassza szerveréről.
• Saját adatbázis a kasszának (vagy egy lánc kasszáinak), utf8mb4 karakterkészlettel.
• Egy adatbázis-felhasználó, aki abban az adatbázisban táblákat hozhat létre, módosíthat, nevezhet át és törölhet (CREATE, ALTER, DROP, INDEX, SELECT, INSERT, UPDATE, DELETE), például így:

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

Ha a MySQL vagy MariaDB másik számítógépen fut, az utolsó két sorban a localhost helyére a kassza szerverének IP-címét írd.

Átállítás MySQL / MariaDB-re:

1. A MySQL/MariaDB címe résznél töltsd ki a mezőket: Szerver (alapértelmezés localhost), Port (alapértelmezés 3306), Adatbázis (alapértelmezés horecapos), Felhasználó és Jelszó; MariaDB-nél ugyanígy. Ha a cím már be van állítva, a mezők már ki vannak töltve; ha a jelszót üresen hagyod, a mentett jelszó marad (ugyanannál a felhasználónál). A kassza maga menti a címet; ha az Optimum POS már beállított egy rögzített címet, az a cím érvényes, és nincsenek mezők. Ha a kassza már MySQL/MariaDB-vel fut, az adatokat később a MySQL/MariaDB-adatok módosítása gombbal módosítod. Titkosított kapcsolatot az Optimum POS állít be neked.
2. Koppints a Kapcsolat tesztelése gombra: látod a programot és a verziót, vagy hogy miért nem sikerül.
3. Koppints az Átállítás erre: MySQL/MariaDB gombra, jelöld be, hogy érted, és add meg a saját PIN-kódodat.

Az átállítás minden irányban működik a három adatbázis között, és minden adat átkerül:

1. A kassza rövid ideig nem fogad kéréseket (általában egy percnél rövidebb ideig); a tabletek utána maguktól folytatják.
2. Először a kassza biztonsági mentést készít a jelenlegi állapotról (a Beállítások → Biztonsági mentések alatt).
3. Minden átkerül az új adatbázisba, és a kassza táblánként megszámolja, hogy pontosan minden ott van-e.
4. Csak ha minden stimmel, akkor dolgozik tovább a kassza az új adatbázissal. A bejelentkezett munkatársak bejelentkezve maradnak.

Ha valami nem sikerül, semmi sem változik, és a kassza a régi adatbázissal dolgozik tovább. A régi adatbázis megmarad, így mindig vissza lehet térni. Az új MySQL/MariaDB- vagy PostgreSQL-adatbázisban már meglévő kasszaadatok felülíródnak. Belgiumban is működik: a fekete doboz számlálói pontosan átkerülnek.

A biztonsági mentés és a visszaállítás mindhárom adatbázissal ugyanúgy működik (Beállítások → Biztonsági mentések). Az egyik adatbázis mentése bármelyik másikba visszaállítható, a PostgreSQL-mentés is MySQL-be vagy MariaDB-be.

Mi van a MySQL-ben vagy MariaDB-ben? A kassza minden táblája, ugyanazzal a névvel és oszlopokkal (az időpontok UTC-ben). Minden tábla kap egy plusz kulcsoszlopot (_hp_sleutel), a _horecapos_stand, _horecapos_kolom, _horecapos_reeks és _horecapos_wijziging segédtáblákban (az utóbbi a változások naplója, 14 napig megőrizve) pedig a kassza az állapotot, az oszloptípusokat, a számlálókat és a változásokat vezeti. Más programok olvassák az adatokat; írni csak a kasszák írnak.

Így működik: a kassza egy gyors munkapéldányban számol a kassza szerverén, és minden változást ugyanabban a lépésben beír a MySQL/MariaDB-be. Ha ez nem sikerül, a változás nem megy végbe, és a kassza hibát jelez; ezért tartsd elérhetően a MySQL/MariaDB-t. Induláskor a kassza mindent a MySQL/MariaDB-ből olvas be.

Több kassza egy adatbázison. Ahogy PostgreSQL-lel, több kassza is használhatja ugyanazt a MySQL/MariaDB-adatbázist, például egy lánc minden egysége a saját kasszaszerverével. A változások egymás után történnek, és minden kassza először átveszi, amit a többi csinált, így egyidejű módosításnál sem vész el semmi. Ha egy kassza visszaállít egy mentést, vagy egy újabb verziójú kassza frissíti az adatbázist, a többi kassza magától mindent újra beolvas; ezért minden kasszát egyszerre frissíts. Az a kassza, amely 14 napnál tovább ki volt kapcsolva, induláskor mindent újra beolvas.

Telepítéskor az adatbázist is kiválasztod: MySQL / MariaDB, beépített (ajánlott) vagy PostgreSQL a címmel. Ha nem érhető el, a kassza a beépített adatbázissal települ; átállítani később itt tudsz. Frissítéskor a választás megmarad.

Tabletek és kijelzők csatlakoztatása

• Minden tableten/kasszán nyisd meg a kasszaszerver címét, pl. http://192.168.1.20:3000, és tedd ki parancsikonként a kezdőképernyőre (Chrome: Hozzáadás a kezdőképernyőhöz).
• Konyhai kijelző: http://192.168.1.20:3000/keuken.
• Ügyfélkijelző (a vendég felé, nem kötelező): http://192.168.1.20:3000/klantscherm, lásd: Ügyfélkijelző.
• A kijelzők maguktól megtalálják a kasszaszervert (ugyanaz a cím, 4000-s port).

Vevőkijelző

Egy kijelző a kasszán, amely a vendég felé néz. A vendég nagyjából látja, mit rendeltek, és nagyon jól láthatóan az összeget és a fizetés módját. Nincs rajta kezelés: a kijelző csak követi, amit a kassza csinál. Alapértelmezés szerint ki van kapcsolva; bekapcsolás: Beállítások → Üzlet → Ügyfélkijelző. Két képernyős kasszagépen a kassza az első alkalommal magától bekapcsolja; ha ezután kikapcsolják, kikapcsolva marad. Ügyfélkijelző nélkül (kikapcsolva, vagy nincs csatlakoztatva) minden pontosan úgy működik, mint mindig: a kassza a háttérben küldi a képet, és a személyzet soha nem vesz észre hibát vagy hiányzó kijelzőt.

Amit a vendég lát:

• Nyugalmi állapot (senki nem fizet): az üzlet neve és egy saját üdvözlőszöveg (Beállítások → Üzlet; üres = "Welkom").
• Rendelés: a termékek mennyiséggel és összeggel (az azonos tételek összevonva, a menü egy sorban, alatta kisebben az összetevőkkel, a kedvezmény egy sorban), és nagy betűkkel a végösszeg. Megosztott fizetésnél alatta látszik, mennyit fizettek már. A Beállítások → Üzlet → Termékfotók → az ügyfélkijelzőn beállítással minden termék mellett egy kis fotó is megjelenik.
• Fizetés: a fizetési mód (Kártya, Készpénz, Ajándékutalvány), a borravaló és nagy betűkkel a Fizetendő összeg. Készpénz: mennyit ad a vendég és mennyi a visszajáró, amint ezt a kasszán beírták. Kártya: "Kövesd a kártyaterminál utasításait".
• Köszönjük: fizetés után néhány másodpercig "Köszönjük!" a kifizetett összeggel (készpénz: a visszajáró), majd újra a nyugalmi képernyő.

Csatlakoztatás, kétféleképpen (mindkettő magán az eszközön állítható be):

• Második monitor a kasszagépen (Windows, Linux/Raspberry Pi, macOS): automatikusan. Bejelentkezéskor és a telepítés után a kassza teljes képernyőn megnyitja a vevőkijelzőt a legkisebb olyan kijelzőn, amely nem a fő kijelző (azonos méretnél a jobb szélsőn); Windows alatt mindig más kijelzőn, mint a kassza (a kassza az érintőképernyőn van, és indításkor magától is megnyílik). A méretet és a helyzetet a rendszer adja, így bármilyen formátum működik. Második képernyő nélkül nem történik semmi. Windows alatt a bezárt vevőkijelző magától visszatér; Linux és macOS alatt a menüben lévő HorecaPOS vevőkijelző parancsikon visszaállítja. Windows alatt a Chrome (vagy az Edge) kioszk módjában nyílik meg: teljes képernyőn, címsor és tálca nélkül (bezárás: Alt+F4). Ugyanazon a gépen párosítókód nélkül követi a kasszát.
  • Minden böngészőben a hosszú nyomás sehol sem nyitja meg a böngésző menüjét, és nem jelenik meg kérdés az oldal lefordításáról.
  • Kassza bezárva = vevőkijelző bezárva. Ha a kasszaszoftver leáll (Újraindítás, egy frissítés, a kassza leállítva vagy eltávolítva), a vevőkijelző is bezárul valamivel több mint 10 másodperc után; amikor a kassza újra fut, magától visszajön. Windows alatt akkor is bezárul, ha csak a kassza ablakát zárod be. Wayland (Linux) alatt a kassza nem tudja maga bezárni az ablakot.
  • Véletlenül bezártad a vevőkijelzőt? Windows alatt néhány másodperc után magától visszajön, amíg a kassza nyitva van és a második képernyő csatlakoztatva van.
  • Mindig csak egy vevőkijelző. Windows alatt a vevőkijelző csak kioszk módban, a második képernyőn jelenik meg. A kassza ablakában megnyílt vevőkijelző (pl. ha az Edge áramszünet után visszaállította, vagy a kassza gombjával nyitották meg) néhány másodpercen belül magától bezárul; a helyére ekkor a megfelelő vevőkijelző kerül.
  • Senki sincs bejelentkezve = csak az üdvözlés. Ha a kassza a PIN-kód képernyőn áll (újraindítás vagy kijelentkezés után is), a vevőkijelző csak az üdvözlő szöveget mutatja, soha az előző számlát.
  • Windows alatt az automatikus megnyitás a telepítőben a Vevőkijelző automatikusan ... jelölőnégyzettel ki is kapcsolható.
  • Linuxon a kassza a wmctrl segítségével mozgatja az ablakot (a csomag része). Wayland alatt (pl. Raspberry Pi OS labwc-vel) ez nem lehetséges: ilyenkor egyszer tegye át kézzel a vevőkijelzőt a második képernyőre (a böngésző megjegyzi), vagy válassza az X11 lehetőséget a raspi-config programban. macOS-en a Mac első alkalommal engedélyt kér a Kisegítő lehetőségek részben.
  • Kézzel: Beállítások → Üzlet → Vevőkijelző → Vevőkijelző megnyitása (második monitor). Chrome-ban és Edge-ben (Chromebookon is) a gomb azonnal a vevőkijelzőre teszi az ablakot (első alkalommal a böngésző engedélyt kér); egy kattintás a vevőkijelzőn teljes képernyőre váltja. Más böngészőkben: húzza át az ablakot, és nyomja meg az F11 billentyűt.
• Android kassza beépített vevőkijelzővel (pl. Sunmi D2/T2) vagy HDMI/USB-C monitor: szintén automatikusan. Amint az alkalmazás a kasszán van, a vevőkijelző megjelenik a második képernyőn; a csatlakoztatás és a kihúzás azonnal működik.
• Sunmi T1 mini / T2 mini a kis szöveges kijelzővel (2 sor): az alkalmazás automatikusan kiírja rá az összeget: Összesen, Fizetendő, készpénznél Visszajáró, fizetés után Köszönjük!, nyugalmi állapotban pedig az üzlet nevét. A vevőkijelzőnek bekapcsolva kell lennie.
• iPad (kezelőképernyő) külső kijelzővel HDMI/USB-C-n vagy AirPlay-en keresztül: az alkalmazás automatikusan arra a kijelzőre teszi a vevőkijelzőt (előkészítve; az iOS-alkalmazás még nem jelent meg).
• Chromebook: kezelőképernyőként Chrome-ban a Vevőkijelző megnyitása (második monitor) gomb a fent leírtak szerint működik. Az Android-alkalmazásban a vevőkijelző automatikusan megjelenik a második képernyőn, amint a ChromeOS átadja azt a képernyőt az Android-alkalmazásoknak; ha ez nem történik meg, használjon külön eszközt párosítókóddal.
• Külön eszköz (tablet vagy saját PC a kassza mellett): nyisd meg a http://<kassaserver>:3000/klantscherm címet. A kijelző jobb alul egy 6 karakteres párosítókódot mutat. Ezt írd be a kasszán: Beállítások → Üzlet → Ügyfélkijelző → Párosítás. A Párosítás bontása visszaállítja a kijelzőt a párosítókódra. A párosítás kasszánként tárolódik (az adott kassza böngészőjében), így minden kasszának saját ügyfélkijelzője lehet.

Az ügyfélkijelző nem kér PIN-kódot (nincs mit kezelni), és csak annak a kasszának a képét mutatja, amelyhez párosítva van. A kép csak a kasszaszerver memóriájában van; újraindítás után a kijelző üres a következő változásig. A beállítás (be/ki és üdvözlőszöveg) bekerül a biztonsági mentésbe és az Import/exportba (Egyéb beállítások).

Digitális blokk QR-kóddal (opcionális)

Alapból ki van kapcsolva. Bekapcsolás: Beállítások → Üzlet → Konyha és vevőkijelző → Digitális blokk (a lehetőség akkor jelenik meg, ha a vevőkijelző mentve és bekapcsolva van). Fizetés után a Köszönjük! képernyőn egy QR-kód jelenik meg; ilyenkor 45 másodpercig marad látható néhány másodperc helyett. A vendég a saját telefonjával beolvassa, és pontosan úgy látja a blokkot, mint a papírblokkot (ugyanaz a szöveg, belga kasszánál az FDM-blokkal együtt). A telefonon kinyomtathatja, PDF-ként elmentheti vagy szövegfájlként letöltheti.

• Ez a kezelőportálon keresztül működik: https://kassa.<portaal>/__bon/<kassa>/<sleutel>. A kasszának tehát csatlakoznia kell a portálhoz; ha nem, nem jelenik meg QR-kód, és semmi sem változik.
• A kulcs véletlenszerű és kitalálhatatlan, és 30 napig érvényes. Utána a kassza magától törli. A portál semmit sem tárol.
• Második monitorral és külön vevőkijelzővel is működik. A papírblokk és az e-mailes blokk továbbra is ugyanúgy működik.

Vevőkijelző nyugalmi állapotban: diavetítés (opcionális)

Alapból ki van kapcsolva. Bekapcsolás: Beállítások → Üzlet → Konyha és vevőkijelző → Vevőkijelző nyugalmi állapotban. Ha nincs számla a vevőkijelzőn, a diák váltakoznak (alapból 8 másodpercenként, 4 és 60 között állítható):

• Akciók: a happy hourök (ha a happy hour be van kapcsolva) a kedvezménnyel, a napokkal és időpontokkal, valamint a termékekkel vagy csoportokkal; az éppen aktívak állnak elöl, "Most!" felirattal.
• Kiemelt termékek (legfeljebb 12, például újdonság a kínálatban), árral és (ha a termékfotók a vevőkijelzőn be vannak kapcsolva) fotóval. Az elfogyott terméket a kijelző kihagyja.
• A pontgyűjtő kártya: pontok euróként, a jutalom és a pecsétgyűjtő kártyák (csak ha a törzsvásárlói kártya be van kapcsolva).
• Saját szövegek: legfeljebb 5, mindegyik külön diával (például "Péntektől új: a nyári kínálatunk").

Diák nélkül a vevőkijelző az üdvözlőképernyőt mutatja, mint mindig.

Happy hour

Alapértelmezés szerint ki van kapcsolva. Bekapcsolás: Beállítások → Üzlet → Happy hour használata; ezután megjelenik a Beállítások → Happy hour fül.

• Happy hourönként: név (a blokkra kerül), napok, ettől–eddig (átnyúlhat éjfélen, pl. 23:00–01:00), kedvezmény %-ban vagy fix ár, és mely termékcsoportokra és/vagy egyes termékekre vonatkozik.
• Ebben az idősávban a kassza beütéskor automatikusan a happy hour árat számolja (sosem drágább a normálnál; fix árnál az opciók a szokásos módon hozzáadódnak). A termékgombon a régi ár áthúzva látszik az új árral és a HH jelöléssel; a rendelésben és a blokkon a happy hour neve áll. Ami már be van ütve, megtartja az árát.
• Napi ajánlat: jelöld be az Egész nap lehetőséget (00:00–24:00), és válaszd ki a napo(ka)t, pl. minden kedden oldalas fix áron.
• Szezon: jelöld be a Csak szezonban (minden évben) lehetőséget, és add meg a kezdetet és a véget (nap és hónap, pl. június 1. – augusztus 31.; évfordulón át is lehet, pl. december 1. – február 28.). A szezonon kívül a happy hour nem érvényes.
• A módosítások bekerülnek a naplóba.

Napszakok és szezonok

Alapértelmezés szerint ki van kapcsolva. Bekapcsolás: Beállítások → Üzlet → Napszakok és kiszolgálási mód → Kínálat napszak és szezon szerint; ezután megjelenik a Beállítások → Napszakok fül. Ha kikapcsolod, minden termék újra mindig kapható, a napszakok pedig megmaradnak.

• Napszakonként: név (pl. Reggeli, Ebéd, Vacsora, Nyári étlap), napok, ettől–eddig (átnyúlhat éjfélen; Egész nap = 00:00–24:00), adott esetben egy szezon (minden évben, nap és hónap), valamint mely termékcsoportok és/vagy egyedi termékek tartoznak hozzá.
• Az egy vagy több napszakban szereplő termékek és termékcsoportok csak akkor kaphatók, ha valamelyik napszakuk éppen tart; ami egyik napszakban sem szerepel, az mindig kapható. A rendelési képernyő csak azt mutatja, ami most kapható, és magától vált, amikor egy napszak kezdődik vagy véget ér; a szerver a többit elutasítja ("most nem kapható, csak Reggeli idején").
• A webshop ugyanazt a kínálatot mutatja és számolja (a rendelés pillanatában).
• Más ár egy adott napon vagy szezonban: ez happy hour (napi ajánlat, lásd fent).
• Étlap helyszínenként: minden kasszának (üzletnek) saját termékei, napszakai és árai vannak.
• A módosítások bekerülnek a naplóba.

Kínálat és árak kiszolgálási mód szerint

Alapértelmezés szerint ki van kapcsolva. Bekapcsolás: Beállítások → Üzlet → Napszakok és kiszolgálási mód → Kínálat és árak kiszolgálási mód szerint. Ha kikapcsolod, ismét mindenhol a normál ár érvényes, és minden mindenhol kapható; a megadott árak megmaradnak.

• A Beállítások → Termékek alatt termékenként: Ár elvitelnél és Ár kiszállításnál (üres = a normál ár), valamint Értékesítve (helyben, elvitel, kiszállítás; legalább egy). Termékcsoportnál is van Értékesítve, a csoport összes termékére.
• Elviteles vagy kiszállításos rendelésnél a rendelési képernyő az adott kiszolgálási mód árát mutatja, és csak azt, ami ott kapható; a szerver ezt az árat számolja, a többit elutasítja. A happy hour, a menük és az opciók ezzel az árral számolnak.
• Az elvitel áfakulcsa (a terméknél) ettől független, mint mindig.
• A webshop elvitelnél és kiszállításnál az adott választás árait és termékeit mutatja (váltáskor a menüoldal újratöltődik), asztalnál pedig a helyben fogyasztásét.
• A konfiguráció exportja és importja (Beállítások → Import/export) tartalmazza a kiszolgálási mód szerinti árakat, az "értékesítve" beállítást, a napszakokat és a happy hourök szezonját.

Menük

Alapértelmezés szerint ki van kapcsolva. Bekapcsolás: Beállítások → Üzlet → Menük használata.

• A menü egy normál termék (a menüárral), amelynek a Beállítások → Termékek → (termék) → Menü alatt összetevőket állítasz be:
  • fix: mindig ez a termék (pl. "Ital: Házibor");
  • választható: válassz 1 (vagy több) terméket egy termékcsoportból, akár bizonyos termékekre korlátozva (pl. "Főétel: válassz 1 terméket a Főételek közül").
  • Összetevőnként a fogás (1 = azonnal, 2/3 = vár a lehívásra).
• Ha beütöd a menüt, összetevőnként kiválasztod az ételeket. Minden ételnél (a fixeknél is) kiválaszthatod az opciókat, mint egy önálló terméknél (sütési mód, extra sajt; a kötelező opciókat ki kell választani), és megjegyzést is írhatsz. Az opciók felára hozzáadódik a menüárhoz. A menü egy sorként jelenik meg, alatta az ételekkel (és azok opcióival).
• Az ételek külön tételekként mennek a konyhára/bárba (konyhai bon és konyhai kijelző), a saját fogásukban. Maga a menüsor nem.
• Az ÁFA miatt a menüár a normál áraik arányában oszlik el az összetevők között, így az étel és az ital is a helyes kulcsot kapja. A blokkon a menü a teljes árral szerepel, alatta az ételekkel.
• Ha magának a menünek is vannak opciói (pl. méret), ezeket a menüablak tetején választod ki. A blokkon a menüsornál jelennek meg, a konyhai bonon és a konyhai kijelzőn pedig a menü minden ételénél "(menü)" jelöléssel.
• Törlés/sztornózás csak a teljes menüre lehetséges (koppints a menüsorra).
• Felosztás / áthelyezés: válaszd ki a menüsort; az ételek vele mennek. 2× ugyanazon menü esetén 1 darabot is áthelyezhetsz (a fejléc és az ételek szétválnak).
• Kapcsolat nélkül is beütheted a menüket; a tableten tárolódnak, és elküldődnek, amint a kapcsolat helyreáll (mint az önálló termékek).
• A happy hour menüre is vonatkozhat.

Receptúrák és önköltség (Apicbase)

Kapcsolat az Apicbase-zel (receptúrák, önköltség, készlet és beszerzés) az Apicbase Generic POS API-ján keresztül (alapból ki, minden rész külön be- vagy kikapcsolható). Beállítás: Beállítások → Receptúrák (Üzlet, fizetés és nyomtatók beállítása jogosultság). A kassza maga kommunikál az Apicbase-zel (csak kimenő forgalom, portál nem kell).

1. Csatlakozás (mindent a rendszergazda tölt ki), három mód egyikével:
   • Token beillesztése: az Apicbase-ben Library Settings → API Settings → New token → Service Account Token (scope-ok: accounts, library, sales); az access token és a refresh token beillesztése;
   • Bejelentkezés az üzlet saját API-appjával (client-id és client secret az API Settingsből): Bejelentkezés az Apicbase-be, majd az Apicbase által ezután mutatott kód beillesztése;
   • A lejárt tokent (7 nap után) a kassza a refresh tokennel automatikusan megújítja.
2. Outlet: Outletek lekérése, majd az üzlet outletjének kiválasztása. A kassza ott a POS-t Generic POS API-ra állítja saját location-id-val (módosítható; alapból HORECAPOS-…, kasszánként egyedi).
3. Be, jelölőnégyzetekkel:
   • Termékek, csoportok és választási lehetőségek az Apicbase-be: termékcsoportok, termékek (PLU = a termék PLU-száma, különben a kód, különben az id), választási lehetőségek modifierként, árral és áfával. Minden változás után automatikusan (egy perc múlva) és naponta. Az Apicbase-ben ezután minden kasszaterméket egy recepthez kapcsolsz;
   • Minden kifizetett nyugta az Apicbase-be: a legrégebbi először, egyszerre legfeljebb 100, a fizetés utáni negyedórán belül (és 5 percenként). A kedvezmény a tételek között oszlik meg; a szabad összegek, az eldobható csomagolás felára és a betétdíj külön termékként szerepel az Apicbase-ben; a mért termékek 1 darabként a teljes összeggel. Ha nem sikerül, a kassza leáll (az Apicbase sorrendben kéri a nyugtákat), és később újra próbálja: a fizetésből ebből semmi sem érződik. Bekapcsoláskor kiválasztod, melyik naptól (alapból mostantól);
   • Adagonkénti önköltség lekérése (6 óránként): minden kapcsolt receptnél a food cost (alapanyagok és veszteség), személyzeti költséggel, az eladási ár és az árrés az Apicbase szerint. Számítás a legolcsóbb beszállító, az utolsó rendelési ár vagy az átlagos készletérték alapján;
   • Eladási ár átvétele az Apicbase-ből (alapból ki): a kapcsolt termékek eladási árának beállítása a kasszában (a naplóban szerepel).
4. Lent: Önköltség termékenként önköltséggel, személyzettel számolt önköltséggel, kasszaárral, önköltség %-kal és árréssel. Gombok: Katalógus küldése most, Nyugták küldése most és Önköltségek lekérése most.

Kód: apps/pos-server/src/lib/apicbase.ts, routes/apicbase.ts; képernyő Apicbase.tsx. Napló: Apicbase. Feltétel: az Apicbase API-modulja. A Pin Voordeel appjához minden ügyfél számára: partnerség és tanúsítás az Apicbase-nél (lásd a backlogot). Dokumentáció: https://developers.apicbase.com/docs/generic-pos-api-guide

Szállodai szoftver: szobára terhelés

Szállodai étteremhez vagy bárhoz: a számla egy vendég szobájára terhelése. Alapból ki van kapcsolva: Beállítások → Szálloda (jogosultság: Üzlet, fizetés és nyomtatók beállítása).

• Egy lista az összes szállodai szoftverrel (A szálloda szállodaszoftvere). Beépített kapcsolatok:
  • Mews (Connector API: client token és access token, az étterem szolgáltatása és ÁFA-kulcsonként a Mews ÁFA-kódja), apaleo (saját alkalmazás client ID-val és client secrettel, a property ID; ÁFA-kulcsonként szükség esetén az ÁFA-típus) és Cloudbeds (API-kulcs és property ID), mindegyik teszt- és éles környezettel;
  • Oracle OPERA Cloud (OHIP), protel (protel I/O), RoomRaccoon, Booking Experts, Amadeus (XMLPOS), VIPS, Stayntouch, Clock PMS+, Guestline (Rezlynx), Hotelogix, eviivo, Little Hotelier, Shiji és Infor HMS (Databridge). A kiválasztás után pontosan azok a mezők jelennek meg, amelyek az adott szállodai szoftverhez tartoznak (kulcsok, szálloda-ID, szükség esetén az API-juk címe és ÁFA-kulcsonként a kódjuk), rövid magyarázattal arról, mit kell kérni a szállítótól. Ezek a kapcsolatok a szállítók dokumentációja alapján készültek; kérje meg a szállítót, hogy hagyja jóvá a kapcsolatot, és először próbálja ki a Kapcsolat tesztelése gombbal és egy blokkal;
  • egy demó (négy lakosztály, 4–7. szoba) a kipróbáláshoz;
  • Sirvoy, félkapcsolatként és csak Sirvoy Pro esetén. A Sirvoynak nincs API-ja, amellyel egy kassza bármit rávihetne egy foglalásra, fájllal sem (a CSV-import csak új foglalásokat hoz létre). Így a kassza ismeri a vendégeket (szoba, név, érkezés, távozás): a keresés a Szobára résznél, valamint az önkiszolgálás a kioszkon és a webshopban rendesen működik. A nyugta nem kerül át magától a Sirvoyba: fizetés után a Beállítások → Szálloda menüben a Még felvinni a Sirvoyba alatt látható, a szobával, a vendéggel, a nyugtaszámmal és az áfakulcsonkénti összeggel. A szálloda kézzel felviszi extraként a foglalásra, és a Benne van gombra kattint (vissza: Mégsincs benne). Szükséges:
    1. lehetőleg egy kassza, amely a kezelőportálhoz kapcsolódik: ekkor a cím a portálon keresztül megy (https://<portaal>/hotel/<kassa-id>/sirvoy?sleutel=...), és a szállodában nem kell portot nyitni. Különben magának a kasszának kell az internetről https-en keresztül elérhetőnek lennie (saját domain tanúsítvánnyal vagy porttovábbítás; a Sirvoy TLS 1.2 vagy újabb verziót kér), és ezt a címet adod meg;
    2. A cím csak egyszer látható; a kassza csak a hash-t tárolja. Új cím létrehozása = a régi nem működik többé;

A Sirvoy csak akkor küld valamit, ha egy foglalás megváltozik: a kapcsolás előtti foglalásokat a kassza csak egy Sirvoyban végzett módosítás után ismeri. Az üzenetek összekeveredve is érkezhetnek; a kasszánál már meglévőnél régebbi (generatedAt) üzenetet a rendszer kihagyja. A szállodában = nincs lemondva és nincs kijelentkezve, be van jelentkezve vagy az érkezés ma vagy korábban van, a távozás pedig ma vagy később. A Kapcsolat tesztelése megmutatja, hány foglalás érkezett.

Minden szállodai szoftver kapható Hollandiában és/vagy Belgiumban. A Kapcsolat tesztelése ellenőrzi az adatokat. Kód kapcsolatonként: apps/pos-server/src/lib/pms/<naam>.ts.

• Önkiszolgálás (alapból ki): a szállodai vendég maga terheli a rendelését a szobájára, a kioszkon és/vagy a webshopban (elvitel és házhozszállítás, asztali rendelésnél nem). Megadja a szobaszámot és a vezetéknevét; a pénztár a szállodai szoftverben ellenőrzi, hogy ez a vendég most abban a szobában lakik-e. Rendelésenkénti maximummal (alapból € 150), és 5 sikertelen próbálkozás után negyedórán belül előbb a recepcióra kell mennie. Az üzenet soha nem árulja el, ki lakik egy szobában.
• Fizetés: ha a kapcsolat be van kapcsolva, elérhető a Szobára fizetési mód. Keresd meg a vendéget név vagy szobaszám alapján (csak a jelenleg a szállodában lakó vendégek), és koppints a Szobára terhelés: ... gombra. A kassza a nyugtát áfakulcsonként a vendég szállodai számlájára könyveli; a vendég kijelentkezéskor fizet.
• Belgium: ha a rendelés már az asztalnál szerepel a fekete dobozban, előbb az asztalról a szobára kerül (signCostCenterChange ROOM-ra, UC4101); a nyugta szobahitelként (ROOM_CREDIT) kerül a fekete dobozba.
• Ha a könyvelés a szállodai szoftverben nem sikerül (nincs internet), az eladás akkor is megvan, és a könyvelés Sikertelen állapotban látható a Beállítások → Szálloda menüben, Újra gombbal.
• Jelentések és könyvelés: a Szobára (szálloda) külön fizetési mód a X- és Z-jelentésen, a napi kimutatásban és az auditfájlban (XAA).

Kód: apps/pos-server/src/lib/hotel.ts, routes/hotel.ts, a kapcsolatok a lib/pms/ mappában, katalógus packages/shared/src/hotelcatalogus.ts; képernyő Hotel.tsx. Napló: Szálloda. A titkos adatok (tokenek) csak az adatbázisban vannak, soha nem a képernyőn.

Borkezelés a Vinifyjal

Beállítások → Borkezelés (alapból ki; kikapcsoláskor minden megmarad). A Vinify nyilvántartja a borpincét, a borlapot és a készletet, és ez a borok fő forrása. A Vinify POS-követelményei szerint a kassza olyan API-t kínál, amellyel a Vinify:

bejelentkezhet a Vinify által ismert mindhárom módon (a rendszergazda kapcsolja be, melyiket):

1. API-azonosító és API-kulcs (X-Api-Id és X-Api-Key, vagy Authorization: Bearer <id>:<sleutel>);
2. API-kulcs és API-secret aláírással: X-Api-Key, X-Timestamp és X-Signature = hex HMAC-SHA256(secret, <timestamp>\n<METHODE>\n<pad met query>\n<sha256 van de body>), legfeljebb 5 perces.

A kulcsot és a secretet a kassza hozza létre (egyszer jelenik meg); a képernyők csak azt mutatják, hogy ki vannak-e töltve. A portálon keresztül érhető el: https://<portaal>/vinify/<kassa-id>/... (nincs nyitott port az üzletben; a cím a Beállítások → Borkezelés alatt található). Mely termékek borok: amit a Vinify létrehoz, plusz a bejelölt csoportok. Ha a Vinify megad egy címet az eladások küldéséhez, a kassza maga is elküldi őket (push, tokennel): minden kifizetett nyugta után és 5 percenként azt, ami még nem sikerült. A Vinify kapcsolja be a HorecaPOS-kapcsolatot (hello@vinify.no). Minden a naplóban. Nem összetévesztendő a Vinify.nl online borbolttal: az a beszállítóknál található (Rendelés a beszállítóktól).

Gyors címbevitel irányítószámmal és házszámmal

Bekapcsolás: Beállítások → Üzlet → Gyors címbevitel (alapból ki; csak hollandiai üzlethez). Írd be az irányítószámot és a házszámot (betűvel vagy toldalékkal is, pl. 12A vagy 12-1), és koppints a Cím keresése gombra: kitöltődik az utca, a házszám, az irányítószám és a település. Ha azon a számon több cím van (12, 12A, 12B), kiválasztod a megfelelőt. Utána mindent módosíthatsz még.

• Az üzlet adatainál (Beállítások → Üzlet, a cím fölött).
• Törzsvásárlói kártyás vendégnél: a kasszánál új vendégnél és a Jelentés → Vendégek alatt. A vendégek ehhez (nem kötelező) címet kapnak: utca és házszám, irányítószám és település.
• A címek a PDOK ingyenes Locatieserver szolgáltatásából jönnek (Hollandia hivatalos címei, BAG): nem kell fiók vagy kulcs, de internet igen. Internet nélkül vagy belga címnél egyszerűen beírod a címet magad.

Értesítés új verzióról

Bekapcsolás: Beállítások → Üzlet → Frissítési értesítés (alapból ki).

• Kassza frissítve: ha a kasszaszervert frissítették, miközben egy tableten még a régi képernyők vannak nyitva, felül megjelenik: "A kassza frissült (verzió …)" a Frissítés gombbal. A tablet 5 percenként ellenőriz, illetve amikor a képernyő újra láthatóvá válik és a szerver újraindítása után.
• Frissítés elérhető: ha a kassza össze van kapcsolva a kezelőportállal (PORTAAL_URL/PORTAAL_SLEUTEL), és ott ki van töltve a NIEUWSTE_VERSIE, akkor aki kezelheti a beállításokat, ezt látja: "Frissítés elérhető: verzió …" (az UPDATE_NOTITIE magyarázatával). A Később elrejti az értesítést azon a tableten, amíg újabb verzió nem jelenik meg. A frissítés a szokásos módon a scripts\windows\update.cmd paranccsal történik (lásd: Frissítés).

Foglalási platformok

A TheFork, Formitable, Zenchef, Resengo (csak Belgium), OpenTable (csak Hollandia), PlanPanther, RestoManager és Aqqo (csak Hollandia) foglalásai automatikusan bekerülnek a kasszába és az alaprajzra. Bekapcsolás: Beállítások → Foglalási platformok (alapból ki). Csak ha a Foglalások be vannak kapcsolva.

• Az üzlet országa: csak olyan platformot választhatsz, amely működik az üzlet országában (Resengo csak Belgiumban, OpenTable és Aqqo csak Hollandiában). A szerver ezt is ellenőrzi.
• Több platform egyszerre: több platformot is összekapcsolhat egymás mellett, például a TheForkot és a Formitable-t. Két platform soha nem kapja ugyanazt az asztalt ugyanabban az időszakban; a második foglalás ilyenkor asztal nélkül érkezik.
• + Platform összekapcsolása: válaszd ki a platformot, és add meg az adatokat. A titkok (Client secret, visszajelzési kulcs) soha nem jelennek meg az áttekintésben; üresen hagyva = megmarad, Törlés = eltávolítva.
• TheFork (nyilvános B2B API): Restaurant-UUID, Client ID és Client Secret (a TheForktól igényelhető). Ha a kassza lemond, a TheForknál is lemond.
• Formitable, Zenchef, Resengo, OpenTable, PlanPanther, RestoManager, Aqqo: az API-juk csak partnereknek érhető el, vagy nem nyilvános (PlanPanther, RestoManager és Aqqo: a kasszakapcsolat velük egyeztetve készül). A Formitable eseményeit (booking.created, .changed, .canceled, .checkin, .checkout) a rendszer felismeri.
• Az alaprajzon: ha a kasszában egy asztal neve megegyezik a platform asztalának nevével, és abban az idősávban szabad, a foglalás arra az asztalra kerül; különben asztal nélkül (érkezéskor válaszd ki). Az újra beérkező foglalás frissül, nem duplikálódik. Az áttekintésben "ezen keresztül: TheFork" látható.
• Állapot: ha a platform lemond vagy no-show-t jelez, a kassza átveszi. Ami a kasszában már megérkezett, az megérkezett marad.
• Visszajelzés (no-show visszajelzés): adj meg egy visszajelzési címet (például az integrációs szolgáltatásodét). A kassza minden kasszabeli változást (megérkezett, no-show, lemondva, kifizetve összeggel) JSON-ként küld: { platform, id, status, statusEn, bedrag, valuta, tafel, tijdstip, gemeldOp } (összeg centben, csak kifizetéskor), Authorization: Bearer <terugmeld-sleutel> fejléccel, ha megadtad. Ha nem sikerül, a kassza percenként újra próbálja, és a hiba a platformnál látható. Ami magától a platformtól jött, azt nem küldi vissza.
• Tesztfoglalás: olyan foglalást hoz létre, amilyet a platform küldene.
• Törlés: a kapcsolat és a kulcs törlődik; a foglalások megmaradnak.
• Minden változás szerepel a naplóban (titkok nélkül).

Hűségprogramok és értékelések

Két külön kapcsoló a Beállítások → Pontgyűjtés és értékelések alatt (alapból mindkettő ki, ilyenkor sehol semmi nem látszik belőle). Ha kikapcsolja őket, a beállítások és a már megtörtént dolgok megmaradnak.

Másik platform hűségprogramja: a vendég a Joyn (Belgium) és/vagy a Piggy (Leat; Hollandia és Belgium) rendszerében gyűjt pontot. Ez független a pénztár saját törzsvásárlói kártyájától; az nyugodtan mellette is működhet.

• Több egyszerre: Belgiumban a Piggy és a Joyn együtt is be lehet kapcsolva, mindegyik saját adatokkal (válassza ki a platformot, töltse ki, Mentés; Módosítás és Törlés platformonként). A vendég programonként saját QR-kódot kap a nyugtán, saját linket az e-mailben küldött nyugtában és saját gombot a webshopban, és programonként rendelésenként egyszer gyűjt. Ami már be volt állítva, az ugyanúgy működik tovább.
• QR-kód a nyugtán: fizetés után a nyugta alján QR-kód jelenik meg ezzel: "Szkenneld be, és gyűjts pontot itt: ...". Az e-mailben küldött nyugtában link van, a webshopban (elvitel és kiszállítás) pedig gomb a rendelési oldalon és link a visszaigazoló e-mailben. Egy rendelés csak egyszer ér pontot: a nyugta, az e-mail és a webshop ugyanazt az egyedi kódot (a rendelés számát) használja. A "QR-kód a nyomtatott nyugtán" kikapcsolható; az e-mail és a webshop ekkor is megkapja a linket.
• Piggy, "QR-kód és link" mód: adja meg a Piggy ügyfélportál címét, a Shop UUID-t és az Account secret-et (Piggy Business Dashboard). Internet nélkül is működik: a pénztár maga készíti a linket.
• Piggy, "Azonnali jóváírás" mód: adjon meg egy personal access token-t is (Piggy → Marketplace → Private App). Ha a pénztár e-mailben küldi a nyugtát, és az adott e-mail-címmel rendelkező vendég már tag, a pénztár azonnal jóváírja a pontokat; a nyugtán ekkor ez áll: "Pontok jóváírva a Piggynél". A pénztár soha nem hoz létre új tagot; nem tag (vagy nincs e-mail-cím) = QR-kód.
• Joyn, "QR-kód és link" mód: a Joyn partner key, shop reference és shared secret adataival (igényelhető: api-integration@joyn.be). Internet nélkül is működik. A QR-kód 2 óráig érvényes.
• Joyn, "A Joyn API-ján keresztül" mód: a shop API key segítségével (a kapcsolatot a Joyn kereskedői portálon kell bekapcsolni). A pénztár fizetéskor pontkódot kér a Joyntól. A beváltás a szokásos módon a Joyn-iPaden történik.
• Mintalink létrehozása: ellenőrzi, hogy az adatok helyesek-e (egy € 10 értékű link; csak megnézésre nyissa meg).
• Csak az üzlet országának platformjai választhatók; a titkos adatok csak az adatbázisban vannak, és soha nem jelennek meg a képernyőn (üresen hagyva = megtartás).

Értékelés kérése: a látogatás után egy e-mail egy gombbal a Google és/vagy a Trustpilot felé.

• Néhány órával később (beállítható, alapértelmezés 3) a vendég megkapja az e-mailt, a nyugta nyelvén.
• Webshop: elvitelnél és kiszállításnál a webshop maga küldi az e-mailt, néhány órával azután, hogy a rendelést a pénztárban lezárták, a vendég nyelvén.
• Google: illessze be az értékelési linket a cégprofiljából (Google → cégprofil → Értékelések kérése, https://g.page/r/.../review), vagy adja meg a Place ID-t.
• Trustpilot: adja meg az üzlet domainjét (a gomb ide visz: trustpilot.com/evaluate/<domein>). Ha van Trustpilot meghívási címe (Automatic Feedback Service, ...@invite.trustpilot.com), azt is adja meg: az e-mail ekkor titkos másolatban (BCC) megy a Trustpilotnak, láthatatlanul a névvel, az e-mail-címmel és a nyugtaszámmal, és a Trustpilot maga küldi a meghívót (ekkor nincs saját Trustpilot-gomb). Csak Trustpilot meghívási címmel: a pénztár csak a Trustpilotnak küld e-mailt.
• Nem túl gyakran: ugyanaz a vendég (e-mail-cím) időszakonként legfeljebb egy kérést kap (alapértelmezés 90 nap; 0 = minden alkalommal). Ehhez a pénztár csak a cím hash-ét tárolja; maga az e-mail-cím törlődik, amint a levél elment (ha nem sikerül, három próbálkozás után, egyébként 14 nap után).
• QR-kód a nyugtán (opcionális): QR-kód értékeléshez is a nyomtatott nyugta alján.
• E-mail előnézete és Várakozó e-mailek törlése (a címek ekkor azonnal törlődnek). A napló ezt mutatja: review_gevraagd a***@domain.hu címmel.
• A Google és a Trustpilot tiltja az értékelésért adott jutalmat és azt, hogy csak az elégedett vendégeket kérdezzük ("review gating"). Ezért a pénztár mindenkit ugyanúgy kérdez, és semmit nem ad az értékelésért cserébe.
• Értékelések olvasása és megválaszolása a kasszában: lásd lent az Értékeléskezelést.

Kapcsolat a Mailchimp és Klaviyo szolgáltatással

A törzsvásárlói kártya vendégei a saját levelezőprogramodban: Beállítások → Üzlet → Mailchimp és Klaviyo (az SMS- és e-mail-marketing alatt). Nincs kapcsoló: kiválasztott listával rendelkező kapcsolat nélkül nem történik semmi.

• Csatlakozás: API-kulccsal (Mailchimp: Profiel → Extra → API keys; Klaviyo: egy pk_… privát kulcs írási joggal a Lists, Profiles, Subscriptions, Events, Campaigns és Templates területekhez). Az ügyféltitok és a kulcs soha többé nem jelenik meg (üresen hagyva = megtartás). Ezután válassza ki a listát (Mailchimp: audience).
• Vendégek: aki hozzájárult az e-mailekhez, a listára kerül (feliratkozva) keresztnévvel, vezetéknévvel, telefonszámmal, születésnappal és hűségpontokkal (Mailchimp: PUNTEN mező, ezt a kassza maga hozza létre; Klaviyo: punten tulajdonság). Visszavont hozzájárulás, módosított e-mail-cím vagy törölt vendég: leiratkozva. Csak a változások mennek át újra. Kapcsolat esetén a kassza (és a webshopban az "ajánlatok" jelölőnégyzet) új vendégnél e-mail-hozzájárulást is kér, és ez a Jelentés → Vendégek alatt módosítható, saját e-mail-marketing nélkül is.
• Leiratkozás: aki a Mailchimpben vagy a Klaviyóban leiratkozik, annak a kasszában sincs többé e-mail-hozzájárulása (napló: "leiratkozott a Mailchimpben"). Aki saját maga iratkozott le, azt a kassza nem iratkoztatja fel újra.
• Rendelések: a listán szereplő vendég minden kifizetett blokkja eseményként megy át (Mailchimp: bestelling, összeggel, blokkszámmal és darabszámmal; Klaviyo: Placed Order, az értékkel euróban). Ezekkel automatikus e-maileket készíthetsz a levelezőprogramban, pl. az első rendelés után, vagy ha valaki egy hónapja nem járt nálad. A lista kiválasztása előtti blokkok nem mennek át.
• Akciók: a Jelentés → Marketing menüben egy akciót a Mailchimpen vagy a Klaviyón keresztül is elküldhetsz (lásd SMS- és e-mail-marketing); ilyenkor a kassza ott hozza létre a kampányt, és elküldi.
• Frissítés: 5 percenként, vagy a Frissítés most gombbal. Leválasztás: a kasszából eltűnik; a Mailchimpben és a Klaviyóban minden megmarad. A kulcsok az adatbázisban vannak (a biztonsági mentésben igen, a konfigurációs exportban nem).

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

BI és adatexport

Az értékesítési adatok Power BI, Looker Studio, Excel, Google Sheets, Tableau, Qlik Sense, Metabase, egy BI-szolgáltatás (például YourBI, BI4Horeca vagy Moore DRV) vagy saját adattárház felé. Bekapcsolás: Beállítások → BI és adatexport (alapból ki). Csak olvasás: egy kapcsolaton keresztül semmi sem módosítható a kasszában. Vendégadatok nélkül.

• Adatok: nyugták (a jóváírások is), eladott termékek (nyugtasorok), fizetések, napi forgalom, óránkénti forgalom, sztornók, termékek, munkatársak (PIN-kód nélkül) és ledolgozott órák. Összegek euróban, tizedespont használatával, időpontok az üzlet idejében.
• + Kapcsolat: válassza ki a szoftvert és a módot. Minden szoftver egy vagy több módot támogat; egyszerre több kapcsolata is lehet (ugyanahhoz a szoftverhez is).
• A szoftver maga kéri le (API): a kassza egyszer ad egy csak olvasható kulcsot. Időszak a ?van=&tot= (ÉÉÉÉ-HH-NN) paraméterrel, vagy fix cím a ?periode= paraméterrel (vandaag, gisteren, 7d, 30d, 90d, 365d, week, maand, vorigemaand, jaar); legfeljebb 366 nap, legfeljebb 200.000 sor. A kulcs helye: Authorization: Bearer, X-Sleutel vagy ?sleutel=.
• A portálon keresztül: ha a kassza kapcsolódik az ügyfélportálhoz, ugyanaz a cím az üzleten kívülről is működik, port megnyitása nélkül: https://<portaal>/bi/<kassa-id>/<gegevens>?periode=90d&formaat=csv&sleutel=.... Így a Power BI szolgáltatás ütemezetten frissíti (átjáró nélkül), a Google Sheets pedig lekérheti ezzel: =IMPORTDATA("...") (ez a Looker Studio forrása is). A kassza a kapcsolatnál megjeleníti a címet.
• Láncáttekintés az ügyfélportálon keresztül (több üzlet): egyetlen cím és egyetlen kulcs az összes kasszájához együtt. Minden részt vevő kasszán kapcsolja be a Láncáttekintés az ügyfélportálon keresztül opciót (a BI kapcsoló alatt), és az ügyfélportálon a Kasszáim → BI az összes üzletéhez részben hozzon létre egy kulcsot. Ezután: https://<portaal>/bi/keten/<gegevens>?periode=90d&formaat=csv&sleutel=hpk_.... A portál minden kasszától lekéri az adatokat és egyesíti őket, soronként kassaId és zaak értékkel. Az offline vagy részt nem vevő kasszák az ontbrekend mezőben (JSON) és az X-Ontbrekend fejlécben szerepelnek. Ehhez magának a kasszának nincs szüksége saját kulcsra; a kasszán vagy az ügyfélportálon történő kikapcsolás leállítja.
• Tokennel az Authorization: Bearer fejlécben megy, és aláírás kerül az X-HorecaPOS-Handtekening fejlécbe (sha256= HMAC a tartalomról). Ha nem sikerül, a kassza percenként újrapróbálja; semmi sem megy el kétszer. Az ettől beállítással régebbi nyugtákat is küld.
• A kassza fájlokat szolgáltat: minden nap (adott időpontban, az előző napról; a kimaradt napokat pótolja) vagy minden órában (ma eddig), CSV-ként (vessző, vagy pontosvessző holland Excelhez) vagy JSON-ként, egy mappába a kassza számítógépén (például OneDrive- vagy SharePoint-mappába Power BI-hoz vagy Excelhez), egy FTP(S)- vagy SFTP-szerverre vagy e-mailben. Fájlnevek: horecapos_<gegevens>_<datum>.csv.
• Teszt küldése (push) és Exportálás most (fájl) a kapcsolatnál.
• Saját letöltés: válassza ki az adatokat, az időszakot és a formátumot.
• Power BI-sablon (.pbit): kész jelentés a Power BI Desktophoz, a Power BI-sablon letöltése gombbal a BI és adatexport alatt. Előbb hozzon létre egy API-kapcsolatot (Power BI). A modellben: adatkészletenként egy tábla a megfelelő típusokkal, egy naptár (év, hónap, hét, a hét napja), kapcsolatok (dátum → naptár, blokksorok → termékek, ledolgozott órák → munkatársak) és mértékek (forgalom áfával és áfa nélkül, áfa, borravaló, blokkok, vendégek, átlag blokkonként és vendégenként, eladott mennyiség, termékforgalom, kifizetve, sztornók, ledolgozott órák, forgalom ledolgozott óránként). Három oldal: Áttekintés (kulcsszámok, forgalom naponként, a hét napjai és órák szerint, fizetési módok), Termékek (csoportonként és termékenként) és Személyzet (órák és forgalom munkatársanként). A portálon keresztül a Power BI szolgáltatás ütemezetten is frissíti.
• A titkos adatok (token, jelszó, kulcs) soha nem jelennek meg az áttekintésben; üresen hagyva = megtartás, Törlés = eltávolítás. Minden a naplóba kerül (titkos adatok nélkül).

Bér és beosztás

Bekapcsolt be- és kiblokkolás mellett (Beállítások → Üzlet) a Beállítások → Munkaidők alján található a Bér és beosztás (Beállítások kezelése jogosultság), két külön blokkban. Ha a blokkolás ki van kapcsolva, nincsenek órák: ilyenkor csak a Munkaerő-beosztás blokk (a forgalom, élőben vagy forgalmi fájlként) található a Beállítások → Könyvelés alján, a Forgalom a beosztásodba fejléc alatt:

• Bérszámfejtés (payroll): válaszd ki a bérszámfejtő programot vagy (Belgium) a szociális titkárságot, töltsd ki a mezőit, és munkatársanként a törzsszámát abban a programban. Ezután egy időszakra elkészíted a fájlt a ledolgozott órákkal (lezárt műszakok, munkatársanként a beblokkolás napja szerint) és a munkatársankénti forgalommal (áfa nélkül, amit ő maga kasszázott): használatra készen a Loket.nl (Variabele gegevens, munkatársanként összesítve az időszakra, fejléc aanslnr;persnr;ploeg;<looncomponent>) és az SD Worx Belgium (Tijdsregistratie, rögzített pozíciók, munkatársanként naponként) számára, egyébként az óralista (CSV: Dátum; Törzsszám; Név; Órák; Forgalom áfa nélkül). A törzsszám nélküli munkatársak nem kerülnek bele a Loket vagy SD Worx fájlba; a kassza jelzi, kik ők.
• Munkaerő-beosztás (WFM): válaszd ki a beosztáskezelő rendszert. Az újraküldés felülír. Emellett a forgalmi lista (CSV naponként és óránként, áfa nélkül és áfával) és a Strobbo számára az Excel-fájl az Importeer omzet funkcióhoz.
• Csak az üzlet országában működő programok, csoportonként és ábécérendben; a szerver elutasítja egy másik ország programját (400).
• A kulcsok és tokenek soha nem jelennek meg a képernyőn.
• Érinti a könyvelést: a bérköltséget a bérszámfejtő program könyveli a könyvelésben, a forgalmat a kassza könyveli (Beállítások → Könyvelés). Az AFAS Payroll és az Exact Online Loon ugyanabban a környezetben van, mint az AFAS és az Exact könyvelése.
• A kassza portálon lévő másolatán ez nem lehetséges (az üzletben lévő kassza végzi).
• Néhány program API-ja nem nyilvános vagy csak partnerek számára elérhető (többek között Loket, Nmbrs, Nostradamus, Employes, Shyfter, Planday, Eitje): ezek kérésre szerepelnek; addig a fájl. Az SD Worx és a Strobbo formátuma a dokumentációjukból származik: az első importot nézesd át.

Jogszabályi követelmények Belgiumban és Hollandiában

Mit ír elő a jogszabály, és mit tesz ezért a HorecaPOS (a könyvelőddel erősíttesd meg, mi vonatkozik az üzletedre):

Jogszabályok

Beállítások → Jogszabályok (rendszergazda; az áfaasszisztens a Termékek kezelése jogosultsággal is). Alapértelmezésként minden ki van kapcsolva; ezek nélkül a beállítások nélkül a kassza úgy működik, mint mindig.

• Életkor-ellenőrzés alkoholnál (18+): a Termékeknél jelölje be az Alkoholt tartalmaz lehetőséget (vagy használja az áfaasszisztenst). Alkoholt tartalmazó elvitelnél és kiszállításnál "18+" jelenik meg a konyhai bonon, a blokkon és a rendelési képernyőn. A webshopban a vendég maga erősíti meg, hogy elmúlt 18 éves (a négyzet nincs előre bejelölve), és látja, hogy átadáskor ellenőrzik az életkorát.
• Egyszer használatos csomagolás díja (Hollandia): termékenként egy összeg (irányárak: pohár € 0,25, ételdoboz € 0,50, kis doboz € 0,05). Elvitelnél és kiszállításnál a kassza magától tesz egy "Egyszer használatos csomagolás díja" tételt a blokkra (a termék áfájával); ez automatikusan követi a termékeket (az adatbázis nyomon követi, sztornó, áthelyezés vagy más rendeléstípus után is), és külön szerepel a forgalomban. Helyben nincs díj. A Thuisbezorgd.nl és a webshop saját díjat számol fel.
• Betétdíj (Hollandia): termékenként (€ 0,15 doboz/palack, € 0,25 nagy palack), "Betétdíj" tétel áfa nélkül, csak elvitelnél és kiszállításnál.
• € 3.000 vagy több készpénz (Hollandia, 1-1-2026 óta tilos áruért): elvitelnél és kiszállításnál figyelmeztetés fizetéskor és a készpénzautomatánál; a munkatárs megerősítheti (pl. catering mint szolgáltatás), ez bekerül a naplóba. A helyben fogyasztott étel és ital szolgáltatás: nincs figyelmeztetés.
• Áfaasszisztens: termékenként a típus (étel, alkoholmentes ital, alkoholos ital, elkészítést nem igénylő élelmiszer, egyéb; először tipp a név és a csoport alapján). A kassza mutatja a helyes kulcsot helyben és elvitelre (Belgium 1-3-2026 óta: ételek és üdítők 12%, elvitelre is; alkohol 21%; elkészítést nem igénylő élelmiszer 6%. Hollandia: 9% és 21%), és alkalmazza azonnal vagy egy dátumtól.
• Áfaváltozás ütemezése: egy termék másik kulcsra, vagy (csak Hollandiában) egy kulcs új százalékkal, egy dátumtól. A kassza azon a napon magától végrehajtja (negyedóránként ellenőrzi, és indításkor is).

A számlák (Belgiumban kötelezők a cégek között) a Számlák céges ügyfeleknek részben találhatók. Teendő: GKS 2.0, rákérdezni, hol tart a tanúsítás (lásd docs/backlog-concurrenten.md).

Számlák céges ügyfeleknek

Beállítások → Számlák (rendszergazda; alapból ki): kapcsold be a Számlák céges ügyfeleknek (UBL / Peppol) opciót. Ha be van kapcsolva, alatta található a Számlára vásárlás, az Adatok a számlán, a Peppol-szolgáltatások, a Bankkapcsolat (számlára vásárlással) és az összes számla listája. Belgiumban 2026. 1. 1. óta kötelező az e-számlázás a cégek között.

• Számlák céges ügyfeleknek: Nyugták → válaszd ki a nyugtát → Számla. Add meg az ügyfelet (vagy válassz egy korábbit); a kassza sorszámozott számlát készít (pl. F2026-0001, évente növekvő), UBL formátumban a Peppol BIS Billing 3.0 szerint, valamint nyomtatható vagy PDF-be menthető számlaként. Küldés e-mailben (mindkettő mellékletként, igény szerint másolat a könyvelőnek), a Billit révén a Peppol-hálózatra (BILLIT_API_KEY, BILLIT_PARTY_ID), a Storecove révén (STORECOVE_API_KEY, STORECOVE_LEGAL_ENTITY_ID; a címzett az ügyfél Peppol-azonosítójából adódik, pl. 0208 → BE:EN, 0106 → NL:KVK, egyébként e-mailben a Storecove-on keresztül) vagy az Unifiedpost Banqup szolgáltatásán át (BANQUP_CLIENT_ID, BANQUP_CLIENT_SECRET, BANQUP_SPACE_ID; BANQUP_SANDBOX=1 a tesztkörnyezethez; a Banqup ellenőrzi az UBL-t és maga kézbesíti), saját címre (FACTUUR_HTTP_URL, pl. könyvelőprogram vagy más Peppol-szolgáltatás) vagy letöltés. Nyugtánként egy számla; a nyugta már ki van fizetve, ezért "kiegyenlítve". KvK-/cégjegyzékszám, IBAN, Peppol-azonosító, előtag és fizetési határidő: Adatok a számlán. Minden számla a fül alján (jogosultság: Forgalom időszakonként).
• A kulcsok, titkos kulcsok és fejlécek soha nem jelennek meg (csak "megadva"; üresen hagyva = megtartás, Törlés = eltávolítás), és nem kerülnek a naplóba (csak az, hogy mely mezők változtak). Az adatbázisban vannak (vestiging.peppol_gegevens): a biztonsági mentésekben igen, a konfigurációs exportban nem.

Önkiszolgáló kioszk

A vendégek maguk rendelnek egy oszlopon vagy tableten, mint egy gyorsétteremben, és a kasszánál vagy kártyával a kioszknál fizetnek. A rendelőképernyők magának a kasszának a részei, így az étlap, az árak, opciók, menük, happy hourök, napszakok, fotók, allergének, nyelvek és a blokk a kasszából jönnek, és sehol máshol nem kell beállítani őket. A kioszkon a PinPortal Kiosk 2 alkalmazás fut (Android, Sunmi is, valamint Windows, Linux és macOS), amely megjeleníti az oldalt és nyomtatja a blokkot. Alapból ki van kapcsolva.

Bekapcsolás és beállítás (rendszergazda): Beállítások → Üzlet → Képernyők és kezelés → Önkiszolgáló kioszk.

• Válaszd ki, mit választhat a vendég: Helyben és/vagy Elvitelre (elvitelnél az elviteli ár és az elviteli áfakulcs számít, ha be van állítva).
• Üdvözlő szöveg, hány másodperc érintés nélkül tér vissza a kioszk az elejére (a kosár ekkor kiürül), és mely termékcsoportok vannak a kioszkon (semmi sincs bejelölve = mind).
• Még valamit mellé?: jelölj be termékcsoportokat (pl. italok, desszertek); a kosárnál a kioszk ezekből ajánl néhány terméket.
• Fizetés, kioszkonként (lásd Kioszk hozzáadása és párosítása):
  • A kasszánál (alapértelmezett, mint a régi kioszknál): a vendég rendel, átvételi számot kap és a kasszánál fizet. A kioszknál nem kell kártyaterminál.
  • Kártyával a kioszknál: a vendég a kioszk melletti kártyaterminálon fizet.
  • A vendég választ: a kasszánál vagy kártyával. Ha a kioszknak nincs terminálja, a kasszánál fizet.
• A konyhára (kasszánál fizetésnél): azonnal a kioszkos rendelés után (alapértelmezett), vagy csak ha a kasszánál kifizették.
• Blokk: a kioszk nyomtatóján (alapértelmezett), a kassza blokknyomtatóján, vagy nincs blokk (csak a szám a képernyőn). Kasszánál fizetésnél a kioszk egy cetlit nyomtat a számmal és azzal, hogy még nincs kifizetve; a blokk a kasszánál való elszámoláskor jön.
• Rendelés állapota a telefonon (opcionális, alapból kikapcsolva): a kioszk blokkján és a záróképernyőn QR-kód jelenik meg. A vendég beolvassa, látja a számát és az állapotot (megrendelve, készül, kész), és értesítést kap, ha kész a rendelés. Ez a kezelőportálon keresztül működik, ezért a kasszának csatlakoznia kell hozzá.
• Alkohol és kilós termékek soha nincsenek a kioszkon: személyzet nélkül nem ellenőrizhető az életkor, és nincs mérleg.
• Vonalkódolvasó (opcionális, alapból minden ki): jelöld be, mit tehet egy beolvasás a kioszkon:
  • egy termék a kosárba (a termék kódja);
  • egy kedvezménykód;
  • egy törzsvásárlói kártya (a vendég pontokat gyűjt);
  • egy ajándékutalvány vagy feltöltős kártya fizetésként. Ha elég az egyenleg, a rendelés azonnal ki van fizetve. Ha nem, az utalvány kifizet egy részt, a maradékot pedig a vendég kártyával vagy a kasszánál fizeti (ez ilyenkor a csak kártyás kioszkon is megengedett). Egy ilyen részfizetés után a vendég már nem tud lemondani; a rendelés a kasszában Kioszk … · szám néven jelenik meg.

Magát a szkennert a kioszkon állítod be: a PinPortal Kiosk 2 alkalmazásban a kezelés → Vonalkódolvasó menüpontban (billentyűzetként, beépített szkennerként vagy COM-porton), szkennerteszttel. A billentyűzetként működő szkenner az alkalmazás nélkül is működik.

• Egyenleg feltöltése (opcionális, alapból ki; csak akkor működik, ha a Feltölthető egyenleg be van kapcsolva): a kioszk kezdőképernyőjén ekkor megjelenik az Egyenleg feltöltése. A vendég beolvassa a kártyáját vagy utalványát (vagy beírja a kódot), látja az egyenleget, és kiválaszt egy összeget. Az összegeket te állítod be (1–6, alapból € 10, € 20 és € 50). A fizetés a kioszknál beállítottak szerint történik: kártyával, vagy a kasszánál az átvételi számmal. Fizetés után az összeg az egyenlegen van. Az ilyen feltöltés nem megy a konyhára, nem jelenik meg a behívókijelzőn, és nem kap QR-kódot. A Feltölthető egyenleg legmagasabb egyenlege itt is érvényes.
• A szobámra (szállodai kapcsolat, alapból ki; Beállítások → Szálloda → Önkiszolgálás): ekkor a kosárnál megjelenik a Terhelés a szobámra. A szállodai vendég megadja a szobaszámot és a vezetéknevét; ha ez egyezik egy most abban a szobában lakó vendéggel, a rendelés a konyhára megy, és fizetettként a szobára kerül (lásd Szállodai szoftver: szobára terhelés).
• Belgium (fekete doboz): ami még nincs tesztelve a fekete dobozzal, az a kioszkon automatikusan ki van kapcsolva (ajándékutalvány vagy egyenleg fizetésként, feltöltés, kedvezménykód, menük, felárás opciók, happy hour), ugyanúgy, mint a pénztárnál.

Kioszk hozzáadása és párosítása

1. A Kioszkok résznél adj meg egy nevet (pl. Kioszk bejárat), és válaszd a Kioszk hozzáadása lehetőséget. Kapsz egy 6 jegyű párosító kódot (30 percig érvényes).
2. Válaszd ki a kioszknál, hogyan fizet a vendég: alapból a kasszánál. Ha kártyaterminálos kioszkról van szó, válaszd a kártyával vagy a vendég választ lehetőséget, és válaszd ki a kioszk kártyaterminálját (a Beállítások → Fizetés menüből).
3. Nyisd meg a kioszkon a kioszkoldalt:
   • az üzletben: az alkalmazásban a kezelés → Vast adres alatt a beállításnál látható címet, pl. http://192.168.1.20:3000/kiosk;
   • vagy a kezelőportálon keresztül (https, akkor is, ha a kioszk nem ugyanazon a hálózaton van): kapcsold a beállításnál látható kioszkcímet az alkalmazás kioszkkódjához, mint a régi kioszknál.
4. Írd be a párosító kódot a kioszkon. Kész: a kioszk megjegyzi a saját kulcsát. Az Újrapárosítás új kódot ad; az Eltávolítás leválasztja.

Minden kioszknál látszik, hogy online-e.

Így rendel a vendég

1. Kezdőképernyő az üdvözlő szöveggel; a vendég kiválasztja a nyelvét (a kassza összes nyelve), és koppint a rendeléshez.
2. Helyben vagy elvitelre.
3. Az étlap termékcsoportonként, fotókkal, árral (happy hourral), allergénekkel és azzal, ami elfogyott. A választható termékek vagy menük megnyitják a választóablakot.
4. A kosár: mennyiségek módosítása és esetleg Még valamit mellé?.
5. Rendelés (fizetés a kasszánál): a vendég nagyban látja az átvételi számát az összeggel, megkapja a cetlit és a kasszánál fizet. A kasszában a rendelés nyitva van Kioszk Bejárat · 42 néven (a szám, amit a vendég mond); az elszámolás a szokásos. Ezután kifizetettként jelenik meg a hívóképernyőn, és a konyhára megy, ha annak csak fizetés után kellett.
6. Fizetés kártyával: a kassza az összeget ennek a kioszknak a termináljára küldi (ugyanaz a fizetési kapcsolat, mint a kasszánál). Ha nem sikerül, a vendég újrapróbálhatja vagy megszakíthatja (vagy, ha választhat, mégis a kasszánál fizethet). Csak sikeres fizetés után megy a rendelés a konyhára és kerül elszámolásra. A vendég nagyban látja az átvételi számát és megkapja a blokkot.
7. Néhány másodperc után a kioszk visszatér az elejére.

Üzemzavar esetén: értesítés és vészüzem (a kioszk alkalmazásban, kezelés → Bij storing; alapból kikapcsolva). Ha a kioszk nem éri el a kasszát, Even gesloten látható rajta. Két extra:

• Teams, Slack, Discord, ntfy, Home Assistant, Make vagy Zapier), és egy hersteld üzenetet, amikor újra működik. A Testmelding sturen gombbal ellenőrzöd a címet.
• Vészüzem: a kioszk elment egy egyszerű kínálatot, amelyet a kioszkoldal ad át neki: termékek választási lehetőségek és menük nélkül, helyben fogyasztási áron (vagy elviteles áron, ha csak az választható).
  • Ha a kassza egy ideig nem elérhető (alapból 60 másodperc), a vendég ebből a kínálatból rendel.
  • A vendég kártyával vagy a pultnál fizet. Kártyás fizetés csak akkor lehetséges, ha a Pinbetaling be van kapcsolva az alkalmazásban.
  • Két vészbizonylat készül: egy a vendégnek (N1, N2 …) és egy a pultnak/konyhának. Rajtuk szerepel, hogy nem blokkról van szó.
  • Amikor a kassza visszatér, a kioszkoldal a vészrendeléseket Nood N… <kioszk> néven beteszi a kasszába. Nem mennek a konyhára (az már megkapta a vészbizonylatot), és nem jelennek meg a behívókijelzőn.
  • Kártyával fizetve és ugyanaz az összeg, mint a kasszában: elszámolva mint Kézi kártyás fizetés. Különben (fizetés a pultnál vagy eltérő összeg) a rendelés nyitva marad a felszolgálásnak.
  • Minden benne van a naplóban.
• Belgium: a regisztrált kasszarendszerrel (GKS, fekete doboz) minden eladásnak azonnal át kell mennie a kasszán és az FDM-en. A vészüzem ekkor valószínűleg nem megengedett; előbb kérdezz utána. Belgiumban a kioszk alkalmazás csak egy további megerősítés után kapcsolja be, és a kassza figyelmeztet a kioszknál.

A kasszában a kioszkos rendelés egy szokásos rendelés (elvitel vagy helyben, Kioszk Bejárat néven) a Kiosk nevű munkatárs nevén. A kassza maga hozza létre; senki sem tud vele bejelentkezni. Ne állítsd inaktívra, különben a kioszk nem tud rendelni. A kioszkos rendelések megjelennek a riportokban, a Blokkok között és a hívóképernyőn. A kioszkon be nem fejezett rendelés (nem rendelték meg vagy nem fizették kártyával) 30 perc után magától megszűnik.

Kártyás fizetés tesztmódban (Beállítások → Fizetés)? Akkor a kioszk valójában nem szed be pénzt; hasznos kipróbáláshoz. Internet nélkül nem lehet kártyával fizetni; a kioszk ekkor jelzi, hogy a pultnál lehet rendelni.

Üzemzavar: ha a kassza nem érhető el, a kioszk alkalmazás "Rövid ideig zárva" feliratot mutat, és magától folytatja. Ha a kioszk a kezelőportálon keresztül fut és kiesik az internet, az alkalmazás átválthat a helyi hálózaton lévő kasszára (az alkalmazásban: kezelés → Bővítmények → Üzemzavarnál a helyi hálózat használata); a címet a kioszk maga adja át.

Kikapcsolás: a kioszk jelzi, hogy rövid ideig zárva van. A kioszkok és a beállítások megmaradnak. A naplóban szerepel a be-/kikapcsolás, a beállítások, a hozzáadott és eltávolított kioszkok, a párosítások és a törölt rendelések.

Digitális menütábla

Az árlap egy tévén (vagy más, böngészős monitoron), közvetlenül a kasszából. Alapból ki van kapcsolva; bekapcsolás: Beállítások → Üzlet → Képernyők és kezelés → Digitális menütábla. Ezután nyisd meg a tévén a http://<kassaserver>:3000/menubord címet (vagy a QR-kódos Saját képernyőn / Tableten vagy telefonon gombot). Nincs bejelentkezés és nincs párosítás.

• Termékcsoportonként a termékek árral, a kassza sorrendjében. Te választod ki, mely csoportok (és milyen sorrendben), 1–4 oszlop, sötét vagy világos, saját fejléc (üres = az üzlet neve), termékfotók és allergének.
• Mindig naprakész: a tábla 10 másodpercenként lekéri a kínálatot (és változáskor azonnal), így az elfogyott termék (áthúzva, Elfogyott felirattal, vagy levéve a tábláról), az üres készlet, a happy hour (akciós ár áthúzott normál árral, felül a névvel és a befejezési idővel) és a napszakok (csak ami most kapható) maguktól helyesen jelennek meg.
• Ha nem fér ki minden a képernyőre, az oldalak váltakoznak (alapból 12 másodpercenként, 5 és 120 között állítható).

Személyzet és PIN-kódok

Beállítások → Személyzet (csak adminisztrátor): munkatársak hozzáadása, név, szerepkör és PIN-kód módosítása, valamint inaktiválás.

• Szerepkörök: felszolgáló (rendelés, fizetés, X-jelentés), menedzser (ezen felül kedvezmény, visszáru, napzárás, kasszafiók és napló) és adminisztrátor (minden, az összes Beállítás is). Ez az alapértelmezés; a felszolgáló és a menedzser jogosultságai módosíthatók (lásd: Jogosultságok szerepkörönként).
• PIN-kód: 4–8 számjegy, egyedi az aktív munkatársak között. A PIN-kódok csak titkosítva (hash) vannak az adatbázisban, és nem olvashatók vissza.
• Végleges törlés nem lehetséges (a blokkok és a napló hivatkoznak a munkatársra); inaktív = már nem tud bejelentkezni.
• Mindig marad legalább egy aktív adminisztrátor.
• Más szerepkör, új PIN-kód vagy inaktiválás: a munkatárs futó munkamenetei azonnal véget érnek.
• Belgium: opcionálisan a nemzeti nyilvántartási szám a személyzeti nyilvántartáshoz.
• Nyelv: a képernyők nyelve ennek a munkatársnak (vagy "Az eszköz nyelve"). Bejelentkezés után a kassza azonnal ezen a nyelven jelenik meg; a munkatárs maga is módosíthatja a jobb alsó sarokban lévő kis zászlóval (lásd: Nyelvek).
• Tipp: cseréld le a demó PIN-kódokat (1111 és 2222), mielőtt a kassza élesben indul.

Bejelentkezés kártyával (opcionális)

Alapból ki van kapcsolva. Bekapcsolás: Beállítások → Személyzet, Bejelentkezés kártyával (NFC, RFID vagy iButton) jelölőnégyzet. Szükséges: egy USB-s kártyaolvasó, amely billentyűzetként működik (NFC- vagy RFID-kártyákhoz, kulcstartókhoz, karszalagokhoz vagy iButton-kulcsokhoz). Egy ilyen olvasó "begépeli" a kártya számát, és megnyomja az Entert; nincs szükség illesztőprogramra vagy kapcsolatra.

• Párosítás: koppints a munkatársra, majd a Kártya párosítása gombra, és tartsd a kártyát az olvasóhoz. Egy kártya egy munkatárshoz tartozik. Kártya eltávolítása, ha elveszett.
• Bejelentkezés: a bejelentkezési képernyőn tartsd a kártyát az olvasóhoz. A PIN-kód továbbra is ugyanúgy működik.
• Be- és kiblokkolás (ha be van kapcsolva): a bejelentkezési képernyőn Be- / kiblokkolás, majd a kártyát az olvasóhoz.
• A kártya száma csak titkosítva (hash) van az adatbázisban, akárcsak a PIN-kód. Az inaktív munkatársak a kártyájukkal sem tudnak bejelentkezni.
• Ki: bejelentkezés csak PIN-kóddal, a megszokott módon. A párosított kártyák megmaradnak.

Jogosultságok szerepkörönként

Beállítások → Jogosultságok (csak adminisztrátor): szerepkörönként jelöld be, mit tehet a felszolgáló és a menedzser. Alapértelmezés szerint minden pontosan a fentiek szerint áll (ahogy a kassza mindig is működött); az eltérő jelölőnégyzet színes.

• Az adminisztrátor mindig mindent megtehet. A személyzet és a jogosultságok módosítása mindig csak az adminisztrátoré marad (különben valaki több jogot adhatna saját magának).
• Azok a gombok és fülek, amelyeket egy szerepkör nem használhat, rejtve vannak előtte; a kasszaszerver is ellenőrzi ezt. Ha egy menedzser pl. megkapja a Termékek kezelése jogot, látja a Beállítások gombot, de csak a Termékek füllel.
• A módosítások azonnal érvényesek minden kasszán, és bekerülnek a naplóba. A Vissza az alapértelmezéshez mindent visszaállít az eredeti állapotra.

Az üzlet adatai

Beállítások → Üzlet (csak adminisztrátor): az üzlet neve, címe, irányítószáma, települése, telefonszáma és adószáma. Ezek minden blokk és pro forma tetején megjelennek. Itt állíthatod be a blokk alján lévő szöveget is (több sor is lehet; üres = nincs szöveg; alapértelmezés: "Bedankt en tot ziens!"), alatta pedig a blokk nyelvét (alapértelmezés: holland; lásd: Nyelvek). A blokk előnézete élőben frissül. Mentés után a következő blokk már az új adatokat használja. Az ország és az adózási adatok (GKS) itt szándékosan nem módosíthatók. Belgiumban az adószám kötelező. A Készpénzes fizetések kerekítése 5 centre jelölőnégyzettel (alapból ki) készpénzes fizetésnél a végösszeg kerekítésre kerül (€ 6,62 → € 6,60, € 6,63 → € 6,65); a különbség "Kerekítés" néven szerepel a blokkon. A kártyás fizetés mindig centre pontos marad.

Termékek kezelése

Jelentkezz be adminisztrátorként, és válaszd a Beállítások → Termékek menüpontot.

• Termékcsoportok és termékek hozzáadása, módosítása (név, ár, csoport, ÁFA-kulcs helyben fogyasztásra és elvitelre, név a blokkon, kód, elfogyott) és törlése. A csoportok és a termékek is saját színt kaphatnak; a színes termék színes gombot kap a rendelési képernyőn (a szöveg az olvashatóság érdekében automatikusan fehér vagy sötét).
• A sorrendet egy csoport vagy termék ≡ jelénél fogva húzással módosíthatod. Ez egérrel és tableten ujjal is működik. Ezután pontosan ez a sorrend jelenik meg a rendelési képernyőn; a nyitott kasszaképernyők azonnal frissülnek.
• A törlés eltávolítja a terméket a kasszából, de a régi rendelések és az adózási napló továbbra is ismerik. Egy csoportot csak akkor törölhetsz, ha üres.
• Opciók: nyiss meg egy terméket vagy termékcsoportot, és az "Opciók" alatt adj hozzá opciócsoportokat, például "Sütési mód" (pontosan egy, kötelező), "Szósz" (legfeljebb egy) vagy "Extra" (több, minimummal és maximummal; üres maximum = korlátlan). Minden opciónak van neve és felára (lehet negatív is, pl. -0,50). Egy termékcsoport opciócsoportjai a csoport minden termékére érvényesek, a termék saját opcióin felül. Sorrend: ▲▼. A törlés mindig lehetséges: a meglévő rendelések és blokkok maguk őrzik meg a kiválasztott opciókat. A szerver a kötelező opciókat és a maximumot is ellenőrzi.
• Fotó termékenként: lásd: Termékfotók.
• Kilogrammár, PLU-szám és tára (csak ha a mérleg be van kapcsolva): lásd: Mérleg beállítása. A jelölőnégyzet nélkül a termék darabonként marad.

Termékfotók

Minden termékhez tartozhat fotó.

• Fotó beállítása: Beállítások → Termékek → válaszd ki a terméket → Fotó kiválasztása (tableten vagy telefonon rögtön a kamerával is). A böngésző legfeljebb 512 × 512 képpontra kicsinyíti a fotót (JPEG, általában 20–80 kB), és azonnal menti; a Másik fotó lecseréli, a Fotó törlése eltávolítja. A terméklistában a név előtt egy kis fotó látszik. Csak a Termékek kezelése jogosultsággal; jpg, png és webp, legfeljebb 512 kB.
• A megjelenítést az adminisztrátor választja ki a Beállítások → Üzlet → Termékfotók alatt, egymástól függetlenül, alapértelmezés szerint kikapcsolva:
  • Termékfotó a rendelési képernyő gombjain: a fotó a termékgomb tetején, alatta a név és az ár.
  • Termékfotó a termékeknél az ügyfélkijelzőn: egy kis fotó az ügyfélkijelző minden sora előtt (magának az ügyfélkijelzőnek is bekapcsolva kell lennie). A fotó nélküli termékek változatlanok maradnak; kikapcsolva minden pontosan úgy működik, mint korábban.

Vonalkódolvasó

A kasszán lévő vonalkódolvasóval termékeket, kedvezménykódokat, törzsvásárlói kártyákat és ajándékutalványokat olvasol be. Bekapcsolás: Beállítások → Szkenner (fül a nyomtatók és a mérleg mellett; alapból ki). Jelöld be, mit csináljon egy beolvasás a rendelési képernyőn:

• Termék a nyugtára: az adott kódú termék (Beállítások → Termékek, Kód mező; pl. a csomagolás EAN-vonalkódja). Választásoknál, menünél vagy kilós árnál előbb a választóablak vagy a mérleg nyílik meg, ugyanúgy, mint koppintáskor. Ugyanezt csinálja a Beolvasás a rendelési képernyőn a Címkenyomtatásnál is; az ugyanúgy működik tovább.
• Kedvezménykód a nyugtára (ha a kedvezménykódok be vannak kapcsolva).
• Törzsvásárlói kártya: az adott kártyaszámú vendég a nyugtára kerül (ha a törzsvásárlói kártya be van kapcsolva). Ha egy vendéghez rendelt nyugtán ismeretlen kódot olvasol be, a kassza megkérdezi, hogy ez-e az új kártyája.
• Ajándékutalvány vagy feltöltős kártya: a kassza megmutatja az egyenleget (ha az egyenleges ajándékutalványok be vannak kapcsolva). Fizetni a Fizetés → Ajándékutalvány résznél lehet; ott az utalványt be is olvashatod.

A kassza először a termékek között keres, aztán a törzsvásárlói kártyák, az ajándékutalványok és a kedvezménykódok között. A beolvasás a rendelési képernyőn működik, ha nem vagy beviteli mezőben. Beviteli mezőben a kód egyszerűen abba a mezőbe kerül.

Szkennerteszt: a Beállítások → Szkenner résznél minden beolvasásnál látod a kódot, és hogy mit kezd vele a kassza, akkor is, ha a szkenner még ki van kapcsolva. Ha nem működik:

• Állítsd a szkennert billentyűzet (USB-HID) módra, a kód után Enterrel. A legtöbb szkennernél ez már így van.
• A beépített szkennert (pl. egy Sunmi kasszáét) a készülék szkennerbeállításaiban állítsd billentyűzetes bevitel módra.
• A TS6X mérleg címkéit (súly és ár) maga a mérleg intézi, bekapcsolt szkennerrel is.

A kioszkon a szkennert külön állítod be (Beállítások → Üzlet → Kioszk); lásd: Önkiszolgáló kioszk.

Címkenyomtatás

Termékcímkék névvel, árral és vonalkóddal, a számítógépre vagy táblagépre telepített címkenyomtatón (Brother, Dymo, Zebra ...). Bekapcsolás: Beállítások → Üzlet → Címkenyomtatás (alapértelmezés: ki). Ott választod ki a címke formátumát is (38 × 25, 57 × 32, 62 × 29 vagy 100 × 50 mm), és hogy rákerüljön-e az ár és a vonalkód. A Próbanyomtatás egy próbacímkét nyomtat.

• Beállítások → Termékek → (termék) → Címkék: válaszd ki a mennyiséget, majd Nyomtatás.
• Beszerzés → (beérkezett rendelés) → Címkenyomtatás: minden termékből annyi címke, amennyi beérkezett (beérkezett rendelési egységek × rendelési egységenkénti mennyiség; hozzávalók nélkül). Legfeljebb 500 címke egyszerre.
• A kassza megnyitja a nyomtatási párbeszédablakot: ott válaszd ki a címkenyomtatót és a tekercs papírméretét. Minden címke egy oldal.
• A vonalkód a termék kódja (Beállítások → Termékek): 8 vagy 13 számjegy helyes ellenőrző számjeggyel = EAN (12 számjegy: az ellenőrző számjegy hozzáadódik), egyébként Code 128 (betűk, számjegyek és írásjelek, legfeljebb 30 karakter). Kód nélkül nincs vonalkód.
• Beolvasás a rendelési képernyőn (jelölőnégyzet, alapértelmezés: ki): egy billentyűzetként működő vonalkódolvasó hozzáadja az adott kódú terméket, a szokásos választásokkal (opciók, mérleg, allergia). A TS6X mérleggel együtt nem, mert annak saját, súlyt és árat tartalmazó címkéi vannak.
• Jogosultság: Termékek kezelése vagy Készlet kezelése.

A mérleg beállítása (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)

Külön fül: Beállítások → Mérleg (Üzlet, fizetés és nyomtatók beállítása jogosultság, alapértelmezés szerint csak az adminisztrátor; a fül mindig ott van, akkor is, ha a mérleg még ki van kapcsolva). Alapértelmezés szerint ki van kapcsolva: ekkor a kassza pontosan úgy működik, mint korábban. Nem látod a fület?

Automatikus keresés. Ha még nincs semmi beállítva, a kassza a rész megnyitásakor magától keres (a Keresés gomb újra elvégzi):

• a kassza(szerver) maga egy Aclas PC- vagy AI-mérlegen fut (TS6X, TS3X, TS5EX/NX/GX, iS6X, iS2X, iR6X, Ti6X, iL8X; az eszköz gyártója/típusa: Windowson WMI, Androidon getprop, Linuxon DMI útján), és válaszol az Aclas Scale Module? Akkor ez a mérleg Ezen az eszközön beállítással lesz előkészítve, és a címkemérleg is; Linuxon (nincs Scale Module) a beépített mérleg a megtalált belső porton (/dev/ttyS...) "TS6X (ingebouwd)" néven, a típussal együtt;
• van OS6X egy COM-/USB-porton? Minden portot 9600, 4800, 2400 és 19200 baudon próbál: először rövid ideig figyel (folyamatos), majd W-t küld (Toledo), egyébként Dialog 06 (9600, 7 adatbit, páratlan paritás: állapot lekérése).

Megtalálva = a Bekapcsolás és használat gombbal kerül az űrlapba: egy koppintás, és működik. (A keresés W-t küld minden szabad COM-portra; a foglalt portot, pl. amit a kártyaterminál használ, kihagyja.)

Minden Aclas-mérleg. Mérlegenként kiválasztod a típust; a kassza így tudja, hogyan csatlakoztatható. Két fajta van:

• Ezen az eszközön (egyszer kell beállítani): a kassza a mérlegen fut (PC- vagy AI-mérleg). Windowson vagy Androidon az Aclas Scale Module segítségével mér, port, sebesség és protokoll nélkül; Linuxon (nincs Scale Module) a mérleg belső portján keresztül (általában /dev/ttyS0 vagy /dev/ttyS1), porttal, sebességgel és protokollal. Kasszánként csak egy ilyen lehet; a Keresés magától megtalálja. Egy PC- vagy AI-mérleg (TS6X, iS6X ...) mindig Ezen az eszközön: a listában csak egyszer szerepelhet, a többi PC-/AI-típus ekkor már nem választható. Egy TS6X az üzlet más részén viszont nyomtathat címkéket (ekkor csak a Címkék beolvasása legyen bekapcsolva).
• Csatlakoztatva (egyszerre több is): a mérleg kábellel (RS232/USB), Bluetooth-on vagy hálózaton csatlakozik a kasszaszerverhez. Annyi, amennyi kell (legfeljebb 8), mindegyik saját névvel.

Egy lista, két pipa. Minden mérleg egy listában van. Mérlegenként bekapcsolod, mit csinál: Mérés a kasszánál (a kassza rendeléskor lekéri a súlyt) és/vagy Címkék beolvasása (a mérleg vonalkódos címkét nyomtat, amit a kassza beolvas, és megkapja a kassza PLU-it). Egy PC- vagy AI-mérleg, mint a TS6X, mindkettőre képes; egy LS-címkemérleg csak címkékre. Címkék üzletenként egy mérlegről jöhetnek.

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 és Zebra. Ezen márkák gyakori modelljei szerepelnek, amelyekről ismert, hogyan kommunikál velük a kassza (tesztelendő = a protokoll szó szerint nem szerepel egyetlen forrásban sem; a kassza a legvalószínűbbet választja). Mind csatlakoztatva (egyszerre több is), vagy címkemérlegként, amelynek címkéjét a kassza beolvassa:

• A&D EK-i és HV-WP: állítsa a mérleget stream módra (EK-i: prt 0; gyárilag a PRINT gombra van állítva), a kasszát pedig Folyamatos módra 2400 baud és 7E1 beállítással (az A&D gyárilag így van beállítva). Az üzenet: ST,+00512.00 g (US = mozog, OL = túl nehéz).
• Adam Equipment Swift: állítsa a mérleget folyamatos küldés PC-re módra (8N1); a kassza ekkor Folyamatos módban van.
• Avery Berkel FX110, FX120 és FX131: a mérlegen válassza a Mettler Toledo 82/7 protokollt, a kasszát pedig állítsa Lekérdezés (Toledo) módra, 7E1 beállítással (9600 baud). A Dialog 06 is működik. Az FX125 (árkijelzővel) nem ismeri a Toledo protokollt: ott Dialog 06. A kassza ezt magától beállítja, amikor kiválasztja a modellt.
• Avery Weigh-Tronix 7820, 7829 és ZP900, valamint Brecknell 6702U, 6710U és 6720U: NCI, a Weigh-Tronix protokollja. A kassza W-t küld (mint a Toledónál), a mérleg a tömeggel ( 1.234KG) és egy állapotsorral válaszol; ez megmondja, hogy mozog-e, túl nehéz vagy túl könnyű. A kassza Lekérdezés (Toledo) módban van 7E1 beállítással (9600 baud). Az USB virtuális COM portként működik. A ZP900 esetén a kasszát a 2. portra állítsa (NCI). A 67xxU esetén a mérlegen 8213 (SCP03) is választható.
• Balanzas Marques BM1000P TOP: a COM-portnál válassza a B (METTLER) protokollt és 9600 baudot, 7 adatbitet, páros paritást; a kassza ekkor Lekérdezés (Toledo) módban van, 7E1 beállítással.
• Baxtran TW, VW, XTA és XTA-P (árszámoló mérlegek; a VW és az XTA-P oszloppal): a mérleg RS232 menüjében válassza a Toledo protokollt, 9600 baudot és 7 adatbitet páros paritással (7E1); a kassza ekkor Lekérdezés (Toledo) módban van, 7E1 beállítással. A kassza ezt magától beállítja, amikor kiválasztja a modellt. A CONT (a mérleg magától küld) is működik: ekkor állítsa a kasszát Folyamatos módra ugyanazzal a sebességgel és adatbitekkel. Csatlakoztatás az RS232 kábellel (9 tűs) vagy USB-RS232 kábellel.
• Bizerba CS 300: Checkout-Dialog 06 (a Bizerba-specifikáció): a kassza elküldi a kilónkénti árat, a hitelesített mérleg kiszámolja az összeget. Ha a mérleg ellenőrző kódokat kér, azokat a Bizerbától vagy a szállítótól kapja meg.
• CAS PD-II, PDN, PDI és PDS-B (a PDS-B többek között az LRE-nél): a mérlegen válassza az ECR type 2 (Toledo) beállítást, a kasszát pedig állítsa Lekérdezés (Toledo) módra 7E1 beállítással (9600 baud).
• Datalogic Magellan 9300i, 9400i és 9800i: a külön mérlegport Scale Interface Type beállítását tegye Mettler Toledo 8217 értékre, a kasszát pedig Lekérdezés (Toledo) módra 7E1 beállítással.
• Dibal KS-400, D-POS 400, G-325 és PI-100: a mérlegen válassza a Checkout_Dialog06 protokollt (24. protokoll), valamint 9600 baudot, 7 adatbitet és páratlan paritást (5. paramétertípus); a kassza ekkor Dialog 06 módban van. A D-POS 400 USB-n is csatlakozhat.
• DIGI DS-781: állítsa a mérleget Type B / szabványos parancs módra (data transmission 00011); a kassza ENQ-t küld, és visszakapja a nettót, a tárát, a kilónkénti árat és az összeget.
• Dini Argeo DFW, DGT és 3590E: állítsa a soros portot folyamatos küldésre (9600 8N1); a kassza ekkor Folyamatos módban van.
• Excell Precision TPE (és a 4. generációs AM4, FD4-P, FDP4-P, GE4, GEP4): állítsa az RS232 kimenetet folyamatos módra (9600 8N1); a kassza ekkor Folyamatos módban van.
• Gram XFOC RS, XFOC+ RS és ZFOC RS: Gram protokoll (9600 8N1). A kassza ENQ-t küld, a mérleg ACK-val válaszol, a kassza DC1-et küld, és a mérleg elküldi a tömeget: SOH STX S/U/F teken gewicht eenheid BCC ETX EOT (S = stabil, U = mozog, F = hiba; BCC = az állapottól a mértékegységig bezárólag vett XOR). Csatlakoztatás RS232 útján vagy a Gram USB-kábelével.
• Kern & Sohn RPB és RFC: a mérlegen állítsa be: Prot = DLG-06 (a kasszacsatlakozás a 965-419 opció); a kassza ekkor Dialog 06 módban van. RFE, IFB és EOC: folyamatos küldés (8N1), a kassza Folyamatos módban.
• Mettler Toledo Ariva/Viva: állítsa a mérleget Toledo protokollra (8217), a kasszát pedig Lekérdezés (Toledo) módra, Adatbitek / paritás = 7E1 (Mettler: 9600 baud, 7 adatbit, páros paritás; az Ariva USB-n virtuális COM portként is csatlakozhat). A kassza ezt magától beállítja, amikor kiválasztja a modellt.
• Minebea Intec Signum, Combics, Midrics és Puro, valamint Sartorius Entris és Quintix: SBI automatikus nyomtatással (9600 8N1); a kassza ekkor Folyamatos módban van. Az üzenet: N + 0.512 kg; mértékegység nélkül még mozog.
• Ohaus Aviator 7000: a mérleg beállításaiban (20. lépés) válassza a Dialog 06 protokollt; a kassza ekkor Dialog 06 módban van. RS232 vagy USB, a kábeltől függően.
• Ohaus Valor 7000, Ranger 3000/4000/7000 és Defender 3000 (mérés ár nélkül): állítsa a mérleget Auto Print Continuous módra (9600 baud, 8N1), a kasszát pedig Folyamatos módra. A mérleg ezt küldi: 0.512 kg G; a tömeg utáni ? azt jelenti, hogy még mozog. A Ranger 7000 Etherneten is csatlakozhat (9761-es TCP-port).
• Precia Molen DP400, DPOS CR és C 210 (a kereskedelmi mérlegek 2025 óta a Dibal tulajdonában vannak): Dialog 06 (9600 7O1), mint a Dibal esetén. Ha a C 210 esetén nem működik, próbálja a Lekérdezés (Toledo) módot 7E1 beállítással.
• Precisa XB, XT, LS és LX: állítsa a nyomtatási módot CONTINUOUS értékre és 9600 8N1 beállításra, dátum, idő és azonosító nélkül a sorban; a kassza ekkor Folyamatos módban van. Mértékegység nélkül a tömeg még mozog.
• Rice Lake BenchPro BP-S (Toledo 8213) és BP-R (NCI): a kassza Lekérdezés (Toledo) módban van 7E1 beállítással.
• Star Micronics mG-T és mG-S8200: RS232 vagy USB útján (virtuális COM port, a Star illesztőprogramjával) Folyamatos módban.
• UWE ASEP: RS232 a PC-hez/kasszához, a kassza Folyamatos módban (tesztelendő).
• Wedderburn TSDS983, TSDS781T és TSDS782T: saját típusszámmal árult DIGI mérlegek: DIGI (Type B), mint a DIGI DS-781. Ha ez nem működik, próbálja a Lekérdezés (Toledo) módot 7E1 beállítással.
• Wintec ScalePOS ACS-S60E: a kassza magán a ScalePOS-on fut; a beépített mérleg a COM6 (Windows) vagy COM4 (Android) porton van, 9600 8N1. Válassza a Folyamatos módot; ha semmit sem küld, a Keresés megtalálja a helyes protokollt.
• Zebra MP7000 és MP72: az RS232-AUX port gyárilag SASI-ra van állítva (9600 7E1, a kassza W-t küld): a kasszát állítsa Lekérdezés (Toledo) módra 7E1 beállítással.
• Ezen márkák címkemérlegei (Avery Berkel, Balanzas Marques, Bizerba, CAS, Dibal, DIGI, Ishida, Mettler Toledo, Precia Molen, Rongta, T-Scale, Wedderburn) önálló rendszerek saját PLU-fájllal. Kapcsolja be a mérlegnél a Címkék szkennelése opciót, és állítsa be ugyanazt a vonalkódot, mint a mérlegen (EAN-13, kezdet 20–29, PLU és tömeg vagy ár). A PLU-kat magán a mérlegen vagy a márka szoftverével állítja be; a Küldés a TS6X-re és a PLU-fájl letöltése csak Aclas esetén érhető el.

Ugyanez a lista a kasszában itt található: Beállítások → Mérleg → Minden mérleg (ACLAS_MODELLEN a packages/shared/src/weegschaal.ts fájlban, modellenként a márkával).

A lehető legkevesebb kitöltés: ha kiválaszt egy modellt, a kassza a többit úgy állítja be, ahogy a márka gyárilag: COM port / USB csatlakozás az első szabad porton, 9600 baud (A&D: 2400) és a márka protokollja (Toledo: Aclas 8N1 beállítással, 7E1 beállítással pedig Avery Berkel FX, Avery Weigh-Tronix, Balanzas Marques, Baxtran, Brecknell, CAS, Datalogic, Mettler Toledo, Rice Lake és Zebra; Dialog 06: Avery Berkel FX125, Bizerba, Dibal, Kern & Sohn RPB/RFC, Ohaus Aviator és Precia Molen; DIGI Type B: DIGI és Wedderburn; Gram: Gram; Folyamatos: A&D, Adam Equipment, Dini Argeo, Excell Precision, a többi Kern & Sohn, Minebea Intec, a többi Ohaus, Precisa, Sartorius, Star Micronics, UWE és Wintec), valamint egy név (pl. OS6X, OS6X 2). A PC- vagy AI-mérleg Ezen az eszközön lesz (pl. TS6X (ingebouwd); Linuxon a belső porton: /dev/ttyS0). Ha valami nem stimmel, a Keresés megtalálja a helyes portot, sebességet és protokollt.

Ezen az eszközön (Aclas Scale Module): a mérleg a hitelesített súlyt mutatja; a kassza elküldi a kilónkénti árat és a tárát (előre beállított táraként), és átveszi a mérleg által számolt összeget, ugyanúgy, mint a Dialog 06 esetén.

• Android: az Aclas AclasScaleDriver alkalmazása (com.aclas.aclasscaledriver) általában már fent van a mérlegen; ha nincs, telepítsd: aclas-android/AclasScaleDriver.apk. A HorecaPOS-alkalmazás közvetlenül ennek az alkalmazásnak a szolgáltatásával kommunikál, így nincs szükség további könyvtárra.
• Linux: az Aclasnak nincs Scale Module-ja Linuxra. Egyszerűen válaszd ki a típust (pl. TS6X): a csatlakozás ekkor Ezen az eszközön (belső port) lesz a /dev/ttyS0 porton, 9600 baud, Toledo. A beépített mérleg általában a /dev/ttyS0 vagy /dev/ttyS1 porton van; a Keresés kipróbálja őket, és beírja a helyes portot, sebességet és protokollt. Itt is csak egyszer adható hozzá.

Az Aclas szoftverei a kasszával együtt jönnek: a Scale Module Windowsra (aclas-module), az AclasScaleDriver Androidra (aclas-android) és az Aclas Sync SDK Windowsra és Linuxra (aclas-sdk). Az Aclas engedélyezi, hogy mellékeljük őket. A Windows- és Linux-telepítők tartalmazzák őket; semmit nem kell külön letölteni vagy telepíteni.

Bluetooth (pl. az OS6X): először párosítsd a mérleget. A Windows COM-portot hoz létre belőle (Bluetooth-beállítások → További Bluetooth-beállítások → COM-portok), a Linux /dev/rfcomm0-et: ezt a portot add meg. Az Android-alkalmazásban a Bluetooth-címet adod meg (00:11:22:AA:BB:CC); az alkalmazás egyszer engedélyt kér a Közeli eszközök használatához, és Bluetooth SPP-n keresztül csatlakozik.

AI-mérlegek (termékfelismerés): a kamera a mérlegen futó Aclas-szoftverben ismeri fel a terméket. A mérés a Scale Module-on (ezen az eszközön) vagy az RS232-porton keresztül működik; az AI-címkemérlegek felismerés után vonalkódos címkét nyomtatnak, amit a kassza beolvas (mint a TS6X esetén).

Aclas AI Recognition Plugin (AI-mérleg, amelyen a kassza fut, pl. az iS6X Windows-zal): az Aclas pluginja felismeri a terméket, és beírja a vonalkódját a kasszába, akárcsak egy szkenner (utána Enter); a rendelési képernyő a terméket a súllyal együtt a rendelésre teszi. Így állíthatja be:

• Kapcsolja be a mérlegnél a Címkék beolvasása opciót ugyanazzal a vonalkóddal, mint a pluginban. Ajánlott: 27 kezdet, 5 számjegyű PLU, súly (Aclas 17. típus): a kassza ekkor maga számol a kilónkénti árral. Az árral (12. típus, kezdete 22) is működik.
• Ennél a mérlegnél kapcsolja ki a Mérés a kasszánál opciót: a plugin és a Scale Module nem érheti el egyszerre a mérleget. A súly a vonalkódból jön. Ha a plugin válaszol a Keresés során, a kassza ezt a beállítást javasolja, és nem indítja el a Scale Module-t. Aktiválási kód nélkül a plugin mér és kiszámolja az összeget, de nem ismer fel termékeket.
• Magában a pluginban: a vonalkód a Scale and Barcode Format Settings → Default Barcode Format alatt (17. típus), az ablakbeállításoknál pedig az a pont, ahová a plugin kattint és beírja a kódot. Ehhez válasszon egy üres helyet a rendelési képernyőn, ne gombot. Az új termékeket az üzlet maga tanítja meg a pluginnak a mérlegen (AI-tanítás).
• Adjon PLU-számot a mérhető termékeknek, és küldje el a PLU-kat a mérlegre (Küldés a TS6X-re vagy a PLU-fájl); a plugin PLU-szám alapján ismer fel.
• A kassza csak addig engedi a plugint felismerni, amíg a rendelési képernyő magán a mérlegen nyitva van (POST /aiplugin/resume, bezáráskor /aiplugin/suspend, a mérleg 5003-s portja; az első alkalommal EmployeeMode is: a mérleg ügyfélkijelzője nem mutat termékeket). Más kasszákon és tableteken, illetve a kezelőportálon keresztül nem történik semmi.
• A plugin mindig Resume állapotban indul, és nem tudja jelezni az állapotát. Ezért a rendelési képernyő 30 másodpercenként újra elküldi a resume parancsot; ha ez elmarad (bezárt képernyő, újraindított plugin vagy mérleg), a kassza egy percen belül Suspend állapotba teszi a plugint, és ott tartja.
• A pluginhoz mérlegenként egy Aclas aktiválási kód kell (a sorozatszámhoz kötve). Jelenleg Windowson működik; az Aclas Android-verziója később jön (a kassza ott is ugyanezt teszi).

Aclas OS6X (POS-mérleg a kasszánál, RS232/USB; a többi csatlakoztatott mérleg is így működik):

• Egy vagy több mérleg (legfeljebb 8), mindegyik névvel (pl. Pult, Bár) és saját csatlakozással: COM-port / USB (Windowson COM3, Linuxon/Androidon /dev/ttyUSB0) a sebességgel, vagy hálózat soros–hálózati átalakítón keresztül (IP-cím és TCP-port, pl. 4001).
• Protokoll: Lekérdezés (Toledo) = a kassza W-t küld, és a mérleg a tömeggel válaszol (Toledo 8217, az OS6X általában így van beállítva; az instabil/túlterhelés/nulla alatt állapotüzenetek is) vagy Folyamatos = a mérleg magától folyamatosan küldi a tömeget (ST,GS, 0.512kg, US = instabil) vagy Dialog 06 (hitelesített), lásd lent, vagy DIGI (Type B) = a kassza ENQ-t küld, és a DIGI állapottal, nettóval, tárával, kilónkénti árral és összeggel válaszol (37 karakter: <status> <toestand> CR 0<netto> CR 4<tarra> CR U<kiloprijs> CR T<bedrag> CR LF; állapot 1. bit = stabil, 2. bit = nulla alatt, 3. bit = túl nehéz, 4. bit = túl könnyű), vagy Gram = a kassza ENQ-t küld, ACK-ra vár, DC1-et küld, és beolvassa ezt: SOH STX <S/U/F> <teken> <gewicht> <eenheid> <BCC> ETX EOT. Állítsa be a mérlegen ugyanazt a protokollt és sebességet. Adatbitek / paritás: 8N1 (Aclas, Adam Equipment, DIGI, Dini Argeo, Excell Precision, Gram, Kern & Sohn, Minebea Intec, Ohaus, Precisa, Sartorius, Star Micronics, UWE, Wedderburn, Wintec) vagy 7E1 (A&D, Avery Berkel, Avery Weigh-Tronix, Balanzas Marques, Baxtran, Brecknell, CAS, Datalogic, Mettler Toledo 8217, Rice Lake, Zebra); a Dialog 06 mindig 7O1. A Lekérdezés az NCI protokollt is olvassa (Avery Weigh-Tronix, Brecknell, Rice Lake BP-R): W-re a mérleg ezt válaszolja: LF 1.234KG CR LF S00 CR ETX; az állapotsor (S + 2 vagy 3 bájt) megmondja, hogy mozog-e (1. bájt 0. bit), túl könnyű-e (2. bájt 0. bit) vagy túl nehéz-e (2. bájt 1. bit); ^^^^^ = túl nehéz, _____ = túl könnyű.
• Dialog 06 (Checkout-Dialog 06, az európai protokoll kasszához csatlakoztatott hitelesített mérleghez): a kassza elküldi a kilónkénti árat (és a termék táráját) a mérlegnek; a mérleg mér, maga számolja ki az összeget, és a saját (hitelesített) kijelzőjén mutatja a kilónkénti árat, a súlyt és az összeget. A kassza átveszi a súlyt és az összeget; a mérési ablakban ez áll: "a mérleg számolta". Mindig 9600 baud, 7 adatbit, páratlan paritás, 1 stopbit (a beállításban megadott sebesség ilyenkor nem számít). Menete: EOT STX 01 ESC <kiloprijs 6> ESC ETX (tárával: 03 rekord 4 számjegyű grammal) → 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 = még nincs kész, ekkor 100 ms múlva újra; 20 = mozog; 21 = először emeld le; 30/31 = túl könnyű; 32 = túl nehéz; 11 = érvénytelen ár). Ellenőrző kódok: sok Dialog 06-mérleg időnként (pl. minden 30. mérésnél) lekéri a kasszaszoftver ellenőrző kódjait (11. rekord → 10. rekord). Ezeket a kódokat és a számításuk módját a mérleg gyártója csak a kasszaszállítónak adja meg. Add meg őket az Ellenőrző kódok mezőben (4 hexadecimális karakterből álló párok, pl. 74AE 1B2C); a kassza elküldi őket, amikor a mérleg kéri. Ha a mérleg változó számmal (Z) számol, és így a fix kódok nem egyeznek, a kassza jelzi ezt; ilyenkor kérd meg a szállítót, hogy ezen ellenőrzés nélkül állítsa be a mérleget, vagy használd a Toledót.
• A mérlegek ahhoz a PC-hez vagy eszközhöz csatlakoznak, ahol a kasszaszerver fut; minden kassza és tablet a kasszaszerveren keresztül mér, és a mérési ablakban választja ki, melyik mérleget használja. A Teszt egyszer mér.
• A hálózat mindenhol működik.
• Súly kézi beírása is: be = mérleg mellett is be lehet írni a súlyt; OS6X nélkül mindig lehetséges.

Címkék beolvasása (pipa a mérlegnél: Aclas TS6X, más PC- vagy AI-mérleg, az LS-sorozat vagy az LH15X; mérleg + címkenyomtató, üzletenként egy):

• IP-cím: csak a Naar TS6X sturen funkcióhoz kell. A mérés és a címkék beolvasása nélküle is működik. Ha a kassza magán a TS6X-en fut, hagyd üresen: a kassza ekkor saját magának küld (127.0.0.1). Ha ugyanaz a mérleg a kasszánál is mér, mindkét pipa ugyanannál a mérlegnél van (a Keresés így állítja be).
• Címkék beolvasása: címkék beolvasása a rendelési képernyőn. Állítsd be, hogyan néz ki a vonalkód, ugyanúgy, mint a TS6X-en: mivel kezdődik (20–29, alapértelmezés: 28), hány számjegyű a PLU (4, 5 vagy 6), utána a súly grammban vagy az ár centben, plusz az ellenőrző számjegy (EAN-13). A beállítás alatt egy példa látható.
• PLU-számok: a Beállítások → Termékek alatt a mérhető termék kilónkénti árat, esetleg tárát és (egyedi) PLU-számot kap. A PLU-számot listából választod (Nincs PLU, következő szabad, Más szám…); a Kilónkénti ár bepipálásakor a következő szabad szám már ki van töltve. Csak a TS6X címkéihez és PLU-ihoz kell: TS6X nélkül maradhat Nincs PLU.
• Közvetlen küldés Windowson és Linuxon működik; Androidon és macOS-en használd a PLU-fájlt. Az első telepítéskor ellenőrizd a PLU-fájl mezőneveit és az aclas-plu.ps1 kódjait a szállított mérleg SDK-kézikönyvével (egyetlen módosítandó hely: ACLAS_PLU_KOLOMMEN a packages/shared/src/weegschaal.ts fájlban).

Kezelőportál: a portálnak küldött jelentés tartalmazza a Mérleg (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) funkciót be/ki állapottal és a mérlegekkel modellenként (pl. TS6X (op dit apparaat), 2x OS6X, PS1CX, Ariva-S, DS-781, LS6RX, 5 producten per kilo); IP-címek, COM portok és Bluetooth-címek nélkül.

Mérésügyi törvény: az a mérleg, amellyel értékesítesz, hitelesített kell legyen (III. osztály, mint az OS6X). Toledo/folyamatos módban a kassza a mérleg által adott súllyal számol; Dialog 06 esetén a hitelesített mérleg maga számolja az árat.

Kód: packages/shared/src/weegschaal.ts (protokollok, címkék, PLU-fájl), apps/pos-server/src/lib/weegschaal.ts és routes/weegschaal.ts; képernyők: WeegschaalInstellingen.tsx és WeegDialoog.tsx.

Thuisbezorgd.nl / Takeaway.com

A Thuisbezorgd.nl rendelései közvetlenül a kasszába érkeznek, közvetítő nélkül (nincs Deliverect, HubRise vagy hasonló): a Just Eat Takeaway JET Connect a Pin Voordeel kezelőportáljával kommunikál, és a kassza onnan tölti le az üzeneteit.

Belgiumban a platform neve Takeaway.com: ugyanaz a cég (Just Eat Takeaway) és ugyanaz az integráció. Belga üzletnél a képernyőkön, értesítésekben, a konyhai bonon és a kezelőportálon mindenhol Takeaway.com szerepel a Thuisbezorgd.nl helyett. Lent a Thuisbezorgd mindkettőt jelenti.

Miért a portálon keresztül? A kasszának csak PORTAAL_URL és PORTAAL_SLEUTEL kell (lásd Kezelőportál), és csak kimenő kéréseket küld.

Beállítás (Beállítások → Kiszállítási platformok → Thuisbezorgd.nl / Takeaway.com, Üzlet, fizetés és nyomtatók beállítása jogosultság; korábban ez a Beállítások → Üzlet alatt volt):

1. Kapcsold be a Thuisbezorgd használata opciót (azonnal érvényes, a Mentéstől függetlenül).
2. Regisztráció a Thuisbezorgd-nál. Ezután az üzlet a Thuisbezorgd-nál (Partner Hub vagy ügyfélmenedzser) az OptimumPOS / Pin Voordeel rendszert választja kasszának. A JET ekkor elindít egy onboarding-munkamenetet; a portál megkeresi hozzá a regisztrált kasszát (irányítószám és név alapján, különben a Pin Voordeel kézzel kapcsolja össze a munkamenetet a portálon), elküldi a konfigurációt, és lekéri a kasszától az étlapot. Ezután élesedik az integráció.
3. Pipáld be a Thuisbezorgd-n keresztül rendelhető termékeket (csoportonként vagy egyenként), igény szerint Thuisbezorgd-leírással. Az étlap (ár, választási lehetőségek módosítóként, allergének, áfa) automatikusan átkerül; PLU = a termék/opció azonosítója. A katalógus módosítása után a kassza 30 másodpercen belül frissíti az étlapot; csak az "elfogyott"/"újra kapható" megy az elérhetőségi API-n keresztül.
4. Thuisbezorgd nyitvatartás: külön kiszállításra és elvitelre (pl. 16:00-22:00, több blokk vesszővel elválasztva). Az alattuk lévő Nyitvatartás mentése gombbal menthetők, és service times-ként kerülnek a Thuisbezorgdhoz, amint a kapcsolat kész.
5. Átmenetileg zárva / Újra nyitva (NL/BE-ben legkésőbb másnap reggel 07:00-kor újra nyit).

Rendelések. A rendelésből asztal nélküli normál rendelés lesz (bezorgen vagy afhalen, csoportnév TB <ordernummer>) a vendég által fizetett árakkal, a kiszállítási/szolgáltatási díj külön tételként, a Thuisbezorgd kedvezménye pedig kedvezménytételként; ha a végösszeg mégsem egyezik, "Verschil Thuisbezorgd" tétel kerül rá. A konyhai bon azonnal a konyhára/bárba megy (kikapcsolható). A kassza másodperceken belül visszaigazol a portálnak, amely jelzi ezt a JET-nek; ha ez 3 percen belül nem sikerül, vagy a kassza offline, a JET "sikertelen" választ kap, és az üzlet az Orderpadra áll vissza.

Thuisbezorgd gomb a felső sávban (a folyamatban lévő rendelések számával): lista, vendég és cím, elkészülési/kiszállítási idő és az idővonal (track & trace): beérkezett, a futár úton az üzlethez, a futár az üzletnél, úton a vendéghez, kiszállítva (a JET-től), valamint saját lépések (készül, kész, úton/kiszállítva saját kiszállításnál, elvitték). A futárt mutató élő térképet a JET Connect nem kínálja a kasszának; azt a vendég a Thuisbezorgd alkalmazásában látja. Új rendelés, lemondás és "futár az üzletnél" esetén narancssárga sáv és hangjelzés jelenik meg. A Lezárás (online fizetve) online fizetési móddal zárja a fizetést; ha a vendég az ajtóban fizet, egyszerűen fizettesd ki a szokásos módon. A Thuisbezorgd felőli lemondás érvényteleníti a rendelést, és "GEANNULEERD" (lemondva) konyhai bont nyomtat.

Kód: apps/pos-server/src/lib/thuisbezorgd.ts, routes/thuisbezorgd.ts; képernyők: ThuisbezorgdInstellingen.tsx és Thuisbezorgd.tsx. Portál oldal: horecapos-portaal/src/thuisbezorgd.mjs (lásd a portál README-jét).

Számlálás a kezelőportálon. A napi Thuisbezorgd-rendelések száma bekerül a kezelőportálnak küldött jelentésbe (verkoopTelling a lib/portaal.ts fájlban): a beérkezett és nem lemondott rendelések, a beérkezés napján. A kasszában kifizettetett Thuisbezorgd-rendelés (a Lezárás (online fizetve) is) ott nem számít bele még egyszer az elvitelbe/kiszállításba. A Thuisbezorgd-adatok a kassza adatbázisában vannak, így egyszerűen benne vannak a kassza biztonsági mentéseiben.

Webshop és online rendelés

Minden üzlet kaphat saját webshopot: rendelési oldalt (és appot) a saját arculatában elvitelhez, kiszállításhoz, QR-kódos asztali rendeléshez és foglaláshoz, online fizetéssel (MultiSafepay vagy Buckaroo) vagy fizetéssel elvitelkor/kiszállításkor. A webshop külön projekt, a horecapos-webshop (Node.js, lásd az ottani README-t), és ugyanazon a szerveren fut, mint a kezelőportál.

A bekapcsolás és beállítás a webshopkezelőben történik: Webshop kezelése gomb az ügyfélportálon (tulajdonos) vagy a telepítésnél a kezelőportálon (Pin Voordeel). Itt van a be/ki kapcsolás, a webcím (<zaak>.<webshopdomein> vagy saját domain), az arculat (színek, logó, fejléckép, betűtípus), a nyitvatartás és az idősávok elvitelhez és kiszállításhoz, a kiszállítási terület (irányítószámok, sugár vagy egy terület a térképen, díjjal és minimummal), a fizetés, a kuponkódok, a szövegek, a nyelvek, a QR-kódok az asztalokhoz, a foglalás és az app (PWA-ként telepíthető; Android-app Trusted Web Activityn keresztül), valamint a push-értesítések (opcionális, alapból kikapcsolva): a vendég a rendelése oldalán bekapcsolja az értesítést, és push-értesítést kap, amikor a rendelés elkészült vagy úton van; aki kéri, alkalmanként ajánlatot is kap, amelyet az üzlet a webshopkezelőben (Push-értesítések fül) küld ki. Működik Androidon és számítógépen (Chrome, Edge, Firefox, Samsung Internet), az Android-appban, valamint iPhone-on és iPaden (iOS 16.4 vagy újabb), ha a vendég a webshopot a főképernyőre teszi. Nem megy ki SMS vagy e-mail, és nem tárolunk nevet vagy telefonszámot. Részletek a webshop README-jében.

Menü. A kassza magától küldi a menüt: minden aktív terméket (nem kilós), termékcsoportonként, árral, választási lehetőségekkel, allergénekkel, elfogyott állapottal és termékfotóval, továbbá az asztalokat és az üzlet adatait, valamint hogy mely marketingcsatornák vannak bekapcsolva (a fizetéskori "ajánlatokat kapni" jelölőnégyzethez, lásd SMS- és e-mail-marketing). Ez induláskor történik, amint a webshop bekapcsol, a katalógus módosítása után 30 másodpercen belül, és a Beállítások → Üzlet módosítása után néhány másodpercen belül, például marketing vagy törzsvásárlói kártya esetén (vagy a Menü küldése most gombbal). Egy terméket a webshopkezelőben (elrejtés), vagy az adatbázisban a artikel.webshop = false beállítással lehet kihagyni a webshopból.

Rendelések. Az elvitel és a kiszállítás szokásos asztal nélküli rendelés lesz (csoportnév WEB <bestelnummer>) azokkal az árakkal, amelyeket a vendég látott, plusz a kiszállítási díj és a tranzakciós díj külön tételként, a kuponkód pedig kedvezménytételként; ha a végösszeg mégsem egyezik, egy "Verschil webshop" tétel kerül rá. A vendég borravalója nem számít bevételnek: a Lezárás (online fizetve) során borravalóként kerül a fizetésbe. Az asztali rendelés (QR-kód) az adott asztal nyitott számlájára kerül (online fizetve: külön csoportként annál az asztalnál). A konyhai bon azonnal megy a konyhára/bárba (kikapcsolható a Webshop ablakban). A kassza másodperceken belül visszaigazolja a bonszámmal; a vendég ekkor "megérkezett" állapotot és e-mailt kap. Ha a kassza offline, a webshop nem fogad rendelést (a vendég ezt azonnal látja), és e-mailt küld az üzletnek, ha egy rendelés túl sokáig várakozik. A webshopos foglalások a Foglalások közé kerülnek (csak ha a foglalás a kasszában be van kapcsolva). Ha van idősávonkénti maximum (Kiszállítás és idősávok), a benne lévő időpontú webshopos rendelések is beleszámítanak.

Belgium (fekete doboz). A webshopos rendelés azonnal rendelésként (signOrder) a fekete dobozba kerül, még a konyhai bon előtt, ugyanúgy, mint a Rendelés a pénztárnál. Ha ez nem sikerül, nem kerül be a pénztárba, és a webshop később újra elküldi. Ami még nincs tesztelve a fekete dobozzal, az a webshop menüjében ki van kapcsolva (ajándékutalványok, kedvezménykódok, számlára, szobára, menük, felárás opciók, happy hour és borravaló), és elutasításra kerül, ha egy régi webshop mégis elküldi. A Lezárás a pénztárhoz hasonlóan ellenőrzi a borravalót, a számlára és a szobára fizetést.

Szobára (szállodai kapcsolat, Beállítások → Szálloda → Önkiszolgálás → A webshopban): a menü megkapja: kamer: { maxBedrag }; a webshop betaling.wijze = "kamer" értéket küld kamer és achternaam mezővel. A pénztár ellenőrzi a vendéget a szállodai szoftverben (asztalnál nem, ajándékutalvánnyal nem), és a rendeléssel együtt menti; a Lezárás (szobára) a szobára számol el, és a blokkot a szállodai számlára könyveli. Gyűjtőszámla számlára fizetésnél: a blokk ilyenkor nyitott tételként szerepel.

Webshop gomb a felső sávban (a folyamatban lévő rendelések számával): lista, vendég és cím, kívánt idő vagy "amint lehet", fizetési mód és az idővonal. A Készül, Kész és Úton lépéseket a vendég élőben látja a webshopban (és e-mailben, ha az üzlet így szeretné). Kifizetve a kasszában = Lezárva; a Mégse csak az adott webshopos rendelés tételeit törli, "TÖRÖLVE" feliratú konyhai bont nyomtat, az online fizetett rendelés összegét pedig a webshop visszatéríti. Foglalásnál a megérkezett, nem jelent meg vagy lemondva állapot is visszamegy a webshopba. Új rendelésnél vagy foglalásnál narancssárga sáv jelenik meg és hang szól.

Kód: apps/pos-server/src/lib/webshop.ts, routes/webshop.ts; képernyő: Webshop.tsx. Portál oldal: horecapos-portaal/src/webshop.mjs.

Kassza és webshop egyformán (minden rész külön kapcsolható be, alapból ki; egy régebbi webshop figyelmen kívül hagyja az új mezőket). Ami a kasszában be van kapcsolva, az a webshopban is működik:

• Happy hour: a webshop ugyanazt az árat számolja, mint az adott pillanatban a kassza (áthúzott normál ár és a happy hour neve), szezonnal is.
• Napszakok és kiszolgálási mód (ha be vannak kapcsolva): a webshop csak azt mutatja, ami most kapható, elvitelnél és kiszállításnál pedig az adott választás árát és termékeit (asztalnál: helyben). Az étlap termékenként megkapja a prijzen (afhalen, bezorgen) és a nietBij mezőt, valamint a dagdelen listát.
• Menük: a vendég kiválasztja az ételeket (fix és választható, az opcióikkal); a kasszában menüsorként jelenik meg, alatta az ételekkel, a menüár pedig elosztva (az áfa ételenként helyes). A csak menühöz tartozó ételek menuArtikelen néven kerülnek át. Régi, választási lehetőség nélküli webshop: a menü egyszerű termékként kerül a nyugtára, mint korábban.
• Elfogyott készlet = elfogyott, a kifogyott összetevőt tartalmazó választható opciók is.
• Allergének: a kasszában kikapcsolva = a webshopban sem jelennek meg.
• Törzsvásárlói kártya: a vendég fizetéskor pontokat gyűjthet (telefonszám vagy e-mail alapján); a kassza a vendéget a rendeléshez kapcsolja, a pontok fizetéskor jóváíródnak (beváltani az üzletben lehet). A webshop mutatja az egyenleget.
• Ajándékutalványok (Beállítások → Üzlet → Ajándékutalványok → Ajándékutalványok értékesítése a webshopban, csak egyenleggel): a vendég utalványt vásárol és online fizet; a kassza létrehozza az azonnal aktív utalványt, a kód pedig a portálon keresztül visszajut a webshopba (állapot és e-mail). Ha az Ajándékutalvány fizetési módként is be van kapcsolva, a vendég elvitelnél választhatja az "ajándékutalvánnyal az üzletben" lehetőséget.
• Kedvezménykódok (Beállítások → Kedvezménykódok, a kapcsolóval az Üzlet menüben): kódonként a kasszán és/vagy a webshopban; a használat a kettőben együtt számít.
• Szünet és nagy forgalom: Webshop gomb a felső sávban: Webshop szüneteltetése (szöveggel a vendégnek) és Nagy forgalom (extra percek). Néhány másodpercen belül eljut a webshopba.
• Online foglalás a kassza szabályaival (Beállítások → Üzlet → Foglalások): legfeljebb fő, nappal előre, időrés, legalább mennyivel előtte, és az időpontok a hét napjai szerint.
• Kiszállítás és idősávok: lásd A webshop a kasszát követi a Kiszállítás és idősávok résznél.
• All-you-can-eat az asztalnál (Beállítások → Üzlet → All-you-can-eat → Asztali rendelésnél is QR-kóddal): ha az asztalnál egy csomag fut, a vendég a csomaghoz tartozó fogásokat Benne van jelöléssel, € 0 áron látja, a körökkel, a személyenkénti maximummal, a várakozási idővel és az időkorláttal. A többit a szokásos módon fizeti; minden az asztal számlájára kerül. Ha az asztal állása épp most változott, a kassza elutasítja a rendelést, és a vendég újra rendel.
• Számlára (Beállítások → Számlák → Számlára vásárlás → A webshopban is): lásd a Számlára vásárlás rész A webshopban pontját.
• Online a várólistára (Beállítások → Üzlet → Várólista): lásd a Várólista az előzetes foglalás nélküli vendégeknek rész Online a várólistára pontját.
• Upsell: "Még valamit mellé?" (opcionális, alapból ki; Beállítások → Üzlet → Fizetés → Upsell a webshopban): válaszd ki a termékcsoportokat (pl. italok, szószok, desszertek) és a javaslatok számát. A webshopban ekkor a kosárnál és a fizetésnél megjelennek azok a termékek ezekből a csoportokból, amelyek még nincsenek a kosárban (csak ami most kapható, nem elfogyott és kötelező választás nélküli); a vendég egy koppintással hozzáadja őket. Nincs kiválasztott csoport = ki, mint korábban. A kioszknak saját upsellje van (lásd Önkiszolgáló kioszk).

Ehhez a webshop menüje versie: 2 verziójú, a következő mezőkkel: menuArtikelen, allergenenAan, happyhours, menus, klantenkaart, cadeaubon, kortingscodes, pauze, drukteMin, volgt, bezetting, reserveren.online, ayce, opRekening, wachtlijst és upsell. A portálnak küldött visszaigazolásban ezen felül szerepel a cadeaubonnen (kódok), a klant (pontok) és a plek (várólista).

Számlálás a kezelőportálon. A webshopon keresztüli elvitel és kiszállítás külön számít (webshop, webshopGeannuleerd a verkoopTelling-ben), a beérkezés napján, és nem számít bele még egyszer az elvitelbe/kiszállításba. Az asztali rendelés egyszerűen az asztalnál számít.

Kártyás fizetés és fizetési terminálok

Beállítások → Fizetés (csak rendszergazda):

• Terminálok: terminálonként egy név, a terminálazonosító és a PinPortalból származó saját API-kulcs (Ügyfél → Ügyfél szerkesztése → Egyéb → API Keys). Mentés után a kulcsnak csak a vége látható; soha nem kerül vissza a böngészőbe. A Kapcsolat tesztelése gombbal ellenőrzöd a kulcsot és a terminált.
• Tesztmód: terminált szimulál (kb. 7 mp után sikeres; a 13 centre végződő összeget elutasítja). Hasznos kártyaterminál nélküli teszteléshez.

Ha legalább egy terminálnak van API-kulcsa (vagy be van kapcsolva a tesztmód), a Fizetés → Kártya / Bancontact automatikusan elindítja a fizetést a terminálon, a szerver által kiszámolt összegre.

Amíg az integráció be van kapcsolva, a szerver csak akkor fogadja el a "kártyás" fizetést, ha pontosan arra a rendelésre és összegre sikeres terminálos fizetés történt. A kérések – akárcsak a hivatalos PHP SDK-ban – normál űrlapként mennek, tartalék API-val (api-backup.pinvandaag.com), ha a fő API nem válaszol. Az API minden válasza [pin] jelöléssel megjelenik a szerverablakban, ami hibakeresésnél hasznos. Egy még fel nem dolgozott sikeres fizetést (pl. ha a tablet kiesett) a rendszer a rendelés következő fizetésekor megtalál.

Borravaló (kártya, készpénz és ajándékutalvány)

A fizetési képernyőn minden fizetési módnál van egy sor borravaló-gomb: Nincs, 5%, 10%, 15% (10 centre felfelé kerekítve), Kerekítés (a következő egész euróra) és Más összeg. Kártyánál a vendég az összeget + borravalót egyszerre fizeti a terminálon; készpénznél a borravaló beleszámít a visszajáróba és a kasszafiókba. A nyugtán a kártyával fizetett összeg szerepel, alatta "ebből borravaló"; a VÉGÖSSZEG és az áfa változatlan, mert a borravaló nem bevétel. Az X/Z-jelentésben a borravaló fizetési módonként és "Borravaló összesen" néven szerepel.

A rendszergazda a Beállítások → Üzlet → Borravaló alatt állítja be a borravaló-gombokat: be/ki, milyen százalékok (legfeljebb 4, pl. "5, 10, 15"), legyen-e "Kerekítés" gomb, és mely fizetési módoknál (kártya, készpénz, ajándékutalvány) adható borravaló. A "Nincs" és a "Más összeg" mindig szerepel.

"Legyen …" mindig megjelenik, minden fizetési módnál, akkor is, ha a borravaló-gombok ki vannak kapcsolva (nincs hozzá beállítás): a vendég maga kerekíti felfelé a számlát, és a különbözet a borravaló. Vannak gombok a következő egész euróval és a következő kerek összegekkel (pl. € 28,00 → 29, 30, 40; € 44,00 → 45, 50, 60), valamint a Más végösszeg, amellyel magad írhatod be a végösszeget. A kiválasztott gombra újra koppintva = nincs kerekítés. Legfeljebb € 500 borravaló (ugyanaz a határ, mint a kasszaszervernél).

Nincs internet

A kassza a helyi hálózaton működik, és nincs szüksége internetre; csak az integráción keresztüli kártyás fizetéshez kell. Ha az üzletben nincs internet, a felső sávban ez áll: Nincs internet · kártya kézzel (percenként ellenőrizve). A fizetési képernyőn ekkor – és a terminálon sikertelen indítás után is – megjelenik a Már kifizetve a terminálon gomb: üsd be az összeget magán a terminálon, és így rögzítsd.

Asztaltérképek és asztalok

Beállítások → Alaprajzok (csak rendszergazda):

• Alaprajzok hozzáadása (pl. Terem, Terasz, Télikert), átnevezése, törlése és sorrendjük módosítása a ◀ ▶ gombokkal.
• Asztalok hozzáadása a rács feletti gombokkal (kerek, négyzet, hosszú, bárasztal), majd egérrel vagy ujjal a helyükre húzása. A kiválasztott asztal kék sarkával nagyobbra vagy kisebbre állíthatod.
• Asztalonként név/szám, vendégszám (az asztal körüli székek is számítanak) és forma beállítása; másolás vagy törlés.
• Billentyűzettel: a nyilak mozgatnak (Shift = nagyobb lépés), a Delete töröl.
• A módosítások csak Mentés után érvényesek; a "Visszavonás" mindent visszaállít.
• Nyitott rendeléssel rendelkező asztal vagy alaprajz nem törölhető. A törölt asztalok a régi rendelésekben megmaradnak.

Konfiguráció átvitele egy második üzletbe

Beállítások → Import/export (csak a rendszergazda). Ha egy üzletet teljesen beállítottál, exportáld a konfigurációt egy .json fájlba, és importáld a második üzlet kasszájába. Részenként választható:

• Termékek: csoportok, termékek, árak (kiszolgálási mód szerint is), áfa, opciók, menük, happy hourök (szezonnal), napszakok, allergének, összetevők/receptek, pecsétgyűjtő kártyák, az all-you-can-eat csomagok és a termékfotók.
• Alaprajzok: termek és asztalok.
• Egyéb beállítások: az üzlet összes beállítása, nyomtatók (IP-cím nélkül), szerepkörönkénti jogosultságok és könyvelés.

Soha nem kerül át: az üzlet neve, címe, irányítószáma, települése, telefonszáma, e-mail-címe, adószáma és nyugtazáró sora, a Z-jelentés e-mail-címe, a kártyaterminálok és kulcsaik, a személyzet és a PIN-kódok, valamint minden forgalom, nyugta, vendég és készletmennyiség.

Az importálás erősen védett: nagy piros figyelmeztetés, egy "Megértettem..." jelölőnégyzet, ismét a rendszergazda saját PIN-kódja, nincs nyitott rendelés, ugyanaz az ország (áfakulcsok), és előtte automatikus biztonsági mentés. Az importálás egyetlen tranzakcióban történik: ha valami hiba van, semmi sem változik. A meglévő termékek, csoportok, összetevők és asztalok nem törlődnek véglegesen, hanem kikerülnek a kasszából (mint a Törlésnél), így a régi nyugták és jelentések továbbra is helyesek maradnak.

Importálás másik kasszából

Váltás mindennek az újragépelése nélkül. Mindig elérhető (kapcsoló nélkül): a Beállítások → Import/export alatt (csak rendszergazda) található az Importálás másik kasszából rész.

• Mit: termékeket (név, ár áfával, áfa, csoport, kód/PLU, készlet) vagy a törzsvásárlói kártya vendégeit (név, telefon, e-mail, pontok, cím, irányítószám, település; a kereszt- és vezetéknév összevonásra kerül).
• Fájl: az előző kasszád exportja (Dobizzz/DoPos, Lightspeed, MplusKASSA, unTill, Tebi ...) vagy saját lista: CSV (; , tabulátor vagy |; UTF-8 vagy holland Excel) vagy Excel (.xlsx), az első munkalap, az első sorban az oszlopnevekkel. Régi .xls fájlt előbb ments el .xlsx vagy CSV formátumban.
• Előnézet: a kassza a nevük alapján ismeri fel az oszlopokat (Omschrijving, Verkoopprijs incl. BTW, BTW %, Omzetgroep, Artikelnummer, GSM, Spaarpunten ...), és megmutatja az első 10 sort. Ha egy oszlop nem stimmel, válaszd ki magad. Csak az Importálás után változik bármi.
• Termékek: árak így: 3,50, € 3,50 vagy 1.234,50; áfa így: 21, 9%, 0,09, magas vagy alacsony (ismeretlen vagy üres: az általad választott kulcs, alapból a legmagasabb). A még nem létező termékcsoportok létrejönnek (csoport nélkül: "Importálva").
• Készlet (Voorraad, Stock, Aantal ... oszlop): ha a Készlet nyilvántartása be van kapcsolva (Beállítások → Üzlet), a termék készletet vezet, és a készlet erre a mennyiségre áll (egy leltár a készlettörténetben, ok: "Importálva"). Üres: a készlet változatlan marad.
• Mintafájl (CSV): egy saját kitöltésre szánt lista (Naam;Productgroep;Prijs;Btw;Voorraad;Code), például Excelben.
• Vendégek: a pontok "Importálva másik kasszából" korrekcióként adódnak hozzá (látható az előzményekben). Az SMS- vagy e-mail-hozzájárulás nem kerül át (GDPR): azt újra kérd el. Előbb kapcsold be a törzsvásárlói kártyát.
• A meglévő termékeket (azonos kód, vagy kód nélkül azonos név) és vendégeket (azonos telefon vagy e-mail) kihagyja, vagy frissíti, ha bepipálod (termékeknél a nevet, árat, áfát, csoportot és készletet). A fájlban lévő ismétlődő sorokat csak egyszer veszi.
• A végén: hány új, frissített és kihagyott, soronként azzal, mi nem stimmelt (pl. nincs ár). Egyszerre legfeljebb 5000 sor. A naplóban "Konfiguráció importálva" néven szerepel.

Nyelvek (42, többek között török, arab, darija, berber, lengyel, bolgár, magyar, orosz, szerb, albán, perzsa, tigrinya, amhara, szomáli, papiamento, sranantongo, hindi, urdu, indonéz, vietnámi, szír-arámi, kínai és ukrán)

Minden képernyőn a jobb alsó ©-gomb mellett van egy nyelvgomb (pl. NL és a kis zászló). Koppints rá a választómenühöz: a nyelvek ábécérendben vannak, a saját nyelvükön írt névvel a zászló előtt: Bahasa Indonesia (indonéz), Čeština (cseh), Darija (marokkói arab latin betűkkel), Deutsch, English, Español, Français, Hrvatski (horvát), Italiano, Kurdî (kurmandzsi), Latviešu (lett), Lietuvių (litván), Magyar (magyar), Nederlands, Papiamentu (papiamento), Polski, Português, Română, Shqip (albán), Slovenčina (szlovák), Soomaali (szomáli), Sranantongo, Srpski (szerb, latin betűkkel), Tarifit (rifi berber), Tiếng Việt (vietnámi), Türkçe, majd cirill betűkkel Български (bolgár), Русский (orosz) és Українська (ukrán), utána az arab írású nyelvek: اردو (urdu), الدارجة (Darija), العربية (arab), دری (dari), فارسی (perzsa, fárszi), پښتو (pastu) és کوردی (سۆرانی) (szoráni kurd), majd szír írással ܣܘܪܝܝܐ (szír-arámi, szurojo), dévanágari írással हिन्दी (hindi), ge'ez írással ትግርኛ (tigrinya) és አማርኛ (amhara), tifinag írással ⵜⴰⵎⴰⵣⵉⵖⵜ (tamazight, berber), végül 中文（简体）(kínai, egyszerűsített írás). A kasszaszerver összes képernyője, gombja, üzenete és hibaüzenete le van fordítva.

• Munkatársanként: a kiválasztott nyelv a bejelentkezett munkatársnál tárolódik (gebruiker.taal). Ha valaki más nyelvvel jelentkezik be, a kassza azonnal átvált. Maga az eszköz megjegyzi az utoljára használt nyelvet, így már a PIN-kód-képernyő is azon a nyelven jelenik meg. Ha kiválasztasz egy nyelvet (a PIN-kód-képernyőn vagy bejelentkezve), és 10 percen belül (újra) bejelentkezel, ez a választás élvez elsőbbséget, és ez lesz a munkatárs nyelve. A váltás újratölti a képernyőt; bejelentkezve maradsz, és a nyitott számla nyitva marad.
• Első alkalommal egy eszközön: ha egy tableten vagy PC-n még nincs nyelv beállítva, a kassza a telepítéskor választott nyelven indul. Ha nem választottak nyelvet, akkor magának az eszköznek a nyelvén (böngésző vagy operációs rendszer, az Android-alkalmazásban is), és ha az nincs a listán, hollandul. Ezután minden eszköz megjegyzi a saját választását.
• Kelet-Európa: lengyel, cseh, szlovák, magyar, román, bolgár, horvát (bosnyákhoz is), litván, lett, ukrán és orosz: a Hollandiában és Belgiumban dolgozó közép- és kelet-európai munkavállalók többségének nyelvei.
• Balkán: szerb (latin betűkkel, ahogy a legtöbb hollandiai és belgiumi szerb írja; a montenegrói nyelvhez is) és albán (Albánia, Koszovó és Észak-Macedónia).
• Afrika szarva: tigrinya (Eritrea) és amhara (Etiópia), mindkettő ge'ez írással, valamint szomáli (latin betűkkel).
• Irán: perzsa (fárszi). Az afganisztáni perzsára (fa-AF) állított eszköz darit kap, a többi fárszit.
• Karibi Hollandia és Suriname: papiamento (Papiamentu, curaçaói és bonaire-i helyesírással; Arubára is) és sranantongo.
• Ázsia: hindi (dévanágari; a szarnami hindusztanihoz is), urdu (jobbról balra), indonéz és vietnámi (latin betűs, a nyugtán is).
• Marokkói: Darija (marokkói arab, a beszélt nyelv) arab és latin betűkkel is (ahogy sok holland marokkói chatben írja), a modern standard arab mellett. Berber: tarifit (rifi, latin betűkkel; a legtöbb holland marokkói a Rif vidékéről származik) és standard marokkói tamazight tifinag írással.
• Jobbról balra: arab (modern standard arab), urdu, Darija arab írással, dari és pastu (Afganisztán), perzsa (fárszi, Irán), szoráni kurd (Irak/Irán) és szír-arámi (szurojo, szír írással). Az összegek, kódok és a számgombok balról jobbra maradnak. A kurmandzsi kurd (Törökország/Szíria) latin betűs.
• Konyhai bon (konyha/bár): alapértelmezés szerint a rendelést leadó munkatárs nyelvén. Nyomtatónként a Beállítások → Nyomtatók → Konyhai bon nyelve alatt fix nyelv is megadható (pl. a szakácsé), latin betűs: 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 vagy Türkçe. A bolgár, orosz és ukrán latin betűs átírásban kerül a konyhai bonra (a blokknyomtató nem ismeri a cirill betűket). Arab, szír, dévanágari, ge'ez és tifinag írás, valamint kínai nem nyomtatható blokknyomtatón: ilyenkor a Darija latin betűkkel, a tamazight tarifitként, a többi hollandul jelenik meg. A fix szövegek (TAFEL, Gang, WACHT op afroep, AFROEP GANG, LATER GEPRINT, Afhalen, Balie) le vannak fordítva; a terméknevek és megjegyzések úgy maradnak, ahogy beírták őket. A hollandra állított nyomtatók a munkatárs nyelvét követik.
• Nyugta (minden vendégnek): alapértelmezés szerint holland, a képernyők nyelvétől függetlenül. Más nyelvet a Beállítások → Üzlet → Nyugta nyelve alatt választhatsz (közvetlenül a nyugta alján lévő szöveg alatt), csak latin betűs nyelveket. Ez érvényes a pro formára, a visszárunyugtára, a másolatra, az ajándékutalványra és az e-mailes nyugtára is. Az összegek, áfakódok, az üzlet adószáma és az adózási sorok (Belgium) nem változnak; a nyugta alján lévő saját szöveg pontosan úgy marad, ahogy az üzlet beírta.
• A termékek, csoportok és opciók neve az, amit az üzlet megad; ezeket nem fordítjuk le.
• A munkatársankénti nyelvet a Beállítások → Személyzet alatt is beállíthatod.
• A bemutató és a kézikönyv is elérhető mindezeken a nyelveken. A ©-gombbal a kassza nyelvén nyílnak meg; felül a zászlókkal másik nyelvet választhatsz (ez a kasszán semmit nem változtat).

Fejlesztőknek: minden látható szöveg a kódban vt('Nederlandse tekst') formában szerepel (apps/pos-web/lib/i18n.ts); a holland szöveg a kulcs. A fordítások az apps/pos-web/lib/vertalingen/<taal>.ts fájlokban vannak. Ha egy fordítás hiányzik, a kassza a holland szöveget mutatja; az i18n teszt (pos-web) ellenőrzi, hogy minden szöveg minden nyelvre le van-e fordítva, és hogy a {0} helyőrzők stimmelnek-e. A kasszaszerver üzenetei hollandul maradnak, és a böngészőben fordítódnak le ({0} helyőrzővel is, pl. egy terméknév az üzenetben).

Nyomtatók beállítása

Egy új kasszának nincsenek nyomtatói. Jelentkezz be rendszergazdaként (demó: 1111), és válaszd a felső sávban a Beállítások menüt.

• Nyomtatók: adj hozzá annyi nyomtatót, amennyi az üzletben van (pl. kassza, konyha, bár, pizza), mindegyiket saját kapcsolattal (általában hálózat: IP-cím és port, 9100) és papírszélességgel. A Tesztnyomtatás gombbal ellenőrzöd, hogy működik-e. Felül választod ki, melyik nyomtató nyomtatja a nyugtát és a pro formát (és nyitja a kasszafiókot). Nyomtatónként a konyhai bon nyelvét is kiválasztod (lásd Nyelvek); a nyugta holland marad.
• Kapcsolat nyomtatónként:
  • Hálózat (IP-cím): IP-cím és port (általában 9100). Mindig így működött, és így is marad: a meglévő nyomtatók automatikusan hálózatra vannak állítva.
  • USB: Linuxon az eszköz, például /dev/usb/lp0. Androidon az eszközhöz csatlakoztatott USB-nyomtató (OTG-kábel; üres = az első USB-nyomtató). Windowson és macOS-en válaszd a Rendszernyomtató lehetőséget.
  • Soros (COM / ttyUSB): egy COM-port (Windows), /dev/ttyUSB0 vagy /dev/ttyS0 (Linux, Android) vagy /dev/cu.… (macOS), a sebességgel (általában 9600, 19200 vagy 38400 baud). Olyan Bluetooth-nyomtatóhoz is, amelyet a Windows vagy a Linux COM-portként vagy /dev/rfcomm0 eszközként párosít.
  • Bluetooth: a HorecaPOS-alkalmazásban Androidon, a párosított nyomtató Bluetooth-címével (pl. egy mobil blokknyomtatóé). Előbb párosítsd a nyomtatót az Android Bluetooth-beállításaiban.
  • Rendszernyomtató (Windows / CUPS): a nyomtató úgy, ahogy a Windows vagy a CUPS (Linux, macOS) ismeri, a saját illesztőprogramjával vagy Generic / Text Only nyomtatóként. A bon nyersen (RAW) megy a nyomtatóra, az illesztőprogram nem formázza.
  • Beépített (Sunmi, iMin ...): magában az androidos kasszában lévő nyomtató.
  • A Keresés megmutatja a kassza által látott nyomtatókat és portokat. Válassz egyet, és a cím kitöltődik.
• Protokoll: ESC/POS (szinte minden blokknyomtató, az ESC/POS módban lévő Star nyomtatók is) vagy Star (Star Line Mode). Star esetén a kassza maga alakítja át a bont; a bon ugyanúgy néz ki.
• Felszolgálói kijelző saját nyomtatóval: egy androidos felszolgálói kijelző a HorecaPOS-alkalmazással (pl. egy kézi terminál mobil Bluetooth-nyomtatóval, vagy egy Sunmi felszolgálói kijelzőként) maga is tud nyomtatni. Regisztráld magán az eszközön (Beállítások → Nyomtatók → Felszolgálói kijelzők saját nyomtatóval), majd a nyomtatónál válaszd a Csatlakoztatva ehhez lehetőséget. A felszolgálói kijelző a kasszától tölti le a bonjait; hagyd ott nyitva az alkalmazást. Ha ez nem sikerül (az alkalmazás be van zárva, a wifi hatótávolságán kívül van), a munkajegy nyomtatási sorba kerül, ugyanúgy, mint egy kikapcsolt hálózati nyomtatónál. Az Eszköz regisztrációjának törlése a nyomtatókat visszahelyezi magára a kasszára.
• Nyomtató csoportonként / termékenként: termékcsoportonként kiválasztod, melyik nyomtatóra kerüljön a konyhai bon. Termékenként ezt felülírhatod saját nyomtatóval vagy a "nincs konyhai bon" beállítással.

Nyomtatáskor az azonos termékek összevonódnak: kétszer 1x Cola → 2x Cola lesz, a konyhai bonon és a nyugtán is. Csak az azonos opciókkal és megjegyzéssel rendelkező termékek vonódnak össze.

A Linux-telepítő a kassza felhasználóját hozzáadja az lp és dialout csoportokhoz, hogy a kassza használhassa az USB- és soros nyomtatókat.

Segítségre van szükséged?

Optimum POS · 085 560 00 60 · support@optimumpos.nl · h–p 9:00–20:00, szo–v 14:00–20:00