Udhëzuesi i HorecaPOS

Ky udhëzues ka tri pjesë: së pari për stafin (kamarierët), pastaj për menaxherin dhe në fund për administratorin. Çdo pjesë bazohet te e mëparshmja: menaxheri mund të bëjë gjithçka që bëjnë kamarierët, dhe administratori mund të bëjë gjithçka.

Çfarë lejohet të bëjë roli yt, e cakton administratori te Cilësimet → Të drejtat. Nëse nuk e sheh një buton, roli yt (ende) nuk ka të drejtë për të.

Ky udhëzues gjendet edhe në arkë: prek butonin © poshtë djathtas në çdo ekran dhe zgjidh Udhëzuesi, ose hap http://<kassa-pc>:3000/handleiding. Shiko edhe prezantimin dhe dokumentacionin e API-së.

Pjesa 1 · Stafi

Fillimi

Hyrja. Hap arkën në arkë, tablet ose telefon dhe fut kodin PIN (4 deri në 8 shifra). Pastaj sheh planin e sallës.

Hapja e një tavoline. Prek një tavolinë. Një tavolinë e lirë merr një porosi të re; te një tavolinë e zënë vazhdon me porosinë që është aty. Lart kalon nga një hapësirë në tjetrën (për shembull Salla dhe Tarraca). Për banakun përdor Shitje e shpejtë, për porositë për ta marrë me vete Me vete.

Porosit. Zgjidh një grup produktesh dhe prek produktet. Ato shfaqen në faturë majtas. Nëse do, zgjidh fillimisht radhën (1 = menjëherë, 2 dhe 3 presin derisa t'i thërrasësh). Prek Porosit: fletëporositë shkojnë në kuzhinë dhe në bar. Derisa të mos kesh prekur Porosit, mund t'i heqësh rreshtat lirisht.

Paguaj. Prek Paguaj, zgjidh Kartë / Bancontact, Para në dorë ose Kartë dhuratë, nëse do një bakshish, dhe konfirmo. Te pagesa me kartë, pagesa nis vetë në terminalin e pagesës. Fatura printohet; mund ta dërgosh edhe me email.

Dil. Dil kur të mbarosh, që askush tjetër të mos punojë me emrin tënd. Pas 8 orësh del automatikisht.

Pa internet? Arka vazhdon të punojë normalisht. Nëse lart shkruan Pa internet · paguaj me kartë manualisht, fute shumën direkt në terminalin e pagesës dhe në ekranin e pagesës zgjidh Paguar tashmë në terminal.

Disa grupe në një tavolinë

Në një tavolinë mund të ulen disa grupe, secili me llogarinë dhe faturën e vet.

• Prek një tavolinë: e lirë = porosi e re; një grup = direkt ai grup; disa grupe = zgjidh fillimisht, ose + Grup i ri (emri mund të mbetet bosh).
• Në krye të ekranit të porosisë është shiriti i grupeve: kalo nga një grup te tjetri, + Grup, Emri i grupit (p.sh. "Jansen") dhe Ndaj / zhvendos.
• Ndaj / zhvendos: zgjidh për çdo rresht sa copë shkojnë (te 3× Pils p.sh. 1) dhe në cilin grup, ose krijo një grup të ri. Kështu zhvendos diçka që është në llogarinë e gabuar, ose ndan më pas "secili paguan pjesën e vet". Kur një grup mbetet bosh, ai hiqet.
• Disa pjesë njëherësh: me + Edhe një pjesë përgatit një pjesë dhe zgjedh tjetrën (p.sh. peshkun dhe një Dry Martini te tavolina 2, pjesën tjetër te tavolina 35). Një pjesë mund të shkojë edhe te + Tavolinë tjetër (atje si grup i ri). Me Zhvendos gjithçka shkon njëherësh. ½ e ndan një rresht përgjysmë, edhe një gjysmë shishe (0,667 bëhet 2 × 0,3335).
• Bashko: gjithçka nga një ose më shumë tavolina të tjera (ose grupe në këtë tavolinë) në këtë llogari, njëherësh.
• Belgjikë: ndarja ose bashkimi njëherësh te kutia e zezë është një ndërrim tavoline, siç e kërkon SPF Financat (UC242, UC251, UC252, UC4119bis). Nëse pas porosisë fshihet diçka ose jepet zbritje për një rresht të porositur tashmë, kjo shkon me mesazhin e radhës të asaj tavoline (porosi, llogari paraprake, ndërrim tavoline), përndryshe me shitjen: rreshti i vjetër negativ dhe i riu pozitiv (UC226, UC4102, UC4104, UC4107, UC4110).
• Në ekranin e tavolinave një rreth portokalli tregon sa grupe ka; shuma është totali i të gjitha grupeve.
• Fatura dhe fletëporosia e kuzhinës tregojnë "Tavolina 5 - grupi 2" ose "Tavolina 5 - Jansen".

Ndaje llogarinë gjatë arkëtimit

Pagesa funksionon si gjithmonë: Të gjitha njëherësh. Në ekranin e pagesës llogaria tani mund edhe të ndahet, me butonat poshtë Prapa dhe Paguaj (kështu ata mbeten gjithmonë në pamje, pa rrëshqitur):

• Ndaj në mënyrë të barabartë: zgjidh me − dhe + për sa persona (si parazgjedhje numri i mysafirëve, ose 2 nëse arka nuk regjistron persona). Ekrani tregon shumën për person; secili paguan pjesën e vet me kartë, para në dorë ose kartë dhuratë (me bakshish nëse dëshiron). Pas çdo pjese numërohet mbrapsht ("edhe 3 persona"); i fundit paguan saktësisht pjesën e mbetur.
• Shumë e lirë: dikush paguan një shumë të caktuar (p.sh. € 20); pjesa tjetër mbetet e hapur.
• Sipas produktit…: hap Ndaj / zhvendos për t'i kaluar produktet në një llogari më vete dhe për t'i paguar veçmas (si më sipër).

Një pagesë e pjesshme regjistron vetëm pagesën; llogaria mbetet e hapur dhe në ekranin e porosisë shkruan "paguar tashmë … · mbetet e hapur …". Fatura (me të gjitha pagesat) del me pagesën e fundit, si te pagesa e zakonshme. Pagesa me kartë përmes lidhjes bëhet për saktësisht shumën e pjesshme. Nëse është paguar tashmë një pjesë, rreshtat nuk mund të kalojnë më në një grup tjetër dhe nuk mund të shtohen më zbritje; heqja është e mundur vetëm nëse ka mjaftueshëm të hapur. Çdo pagesë e pjesshme shënohet në regjistër.

Shitje e shpejtë dhe marrje me vete (pa tavolinë)

Lart djathtas në ekranin e tavolinave janë Shitje e shpejtë dhe Për ta marrë. Të dyja hapin menjëherë një porosi pa tavolinë. Shitja e shpejtë është shitje në banak (TVSH për konsum në vend); Për ta marrë përdor shkallën e TVSH-së për marrje me vete të çdo produkti. Me "Emri i klientit" shton një emër; ai shfaqet në faturë ("Për ta marrë – Jansen") dhe në krye të fletëporosisë. Porositë e hapura pa tavolinë shfaqen poshtë butonave të sallave ("Pa tavolinë: Për ta marrë #12 – Jansen"), që t'i gjesh sërish. Nëse kthehesh pa shitur asgjë, porosia bosh zhduket vetë.

Të dy butonat mund të aktivizohen ose çaktivizohen për çdo lokal te Cilësimet → Lokali, direkt poshtë temës së çelët/errët (si parazgjedhje aktiv). Joaktiv = butoni fshihet; porositë pa tavolinë që janë tashmë të hapura mbeten të dukshme.

Dërgesa dhe intervalet kohore

Porositë që i merr vetë në arkë, për shembull me telefon ose në banak, me të njëjtat rregulla si dyqani online: zona dërgese dhe një numër maksimal porosish për interval kohor. Aktivizohet te Cilësimet → Lokali → Dërgesa dhe intervalet kohore, menjëherë poshtë butonave Shitje e shpejtë dhe Për të marrë (si parazgjedhje joaktiv).

• Butoni Dërgesë në ekranin e tavolinave (pranë Për të marrë): fut emrin, telefonin dhe adresën (me Futje e shpejtë e adresës aktive: kërkim me kod postar dhe numër shtëpie). Arka gjen zonën e dërgesës dhe tregon koston e dërgesës, minimumin dhe "falas nga". Nëse adresa është jashtë zonave, dërgesa nuk bëhet.
• Zonat e dërgesës: sipas kodit postar (intervale dhe kode të veçanta, p.sh. 5000-5049, 5051, 5052 AB), brenda një rrezeje në km nga lokali (në vijë ajrore) ose një zonë në hartë që e vizaton vetë. Rrezja dhe zona funksionojnë vetëm me adresa holandeze (vendndodhja përmes PDOK). Për çdo zonë: kostoja e dërgesës, minimumi, falas nga dhe minutat shtesë; vlen zona e parë nga lart që përputhet, kështu që llojet mund të kombinohen (p.sh. fillimisht disa kode postare, pastaj një zonë, pastaj një rreze për pjesën tjetër). Pa zona të caktuara = dërgesë kudo, pa kosto dhe pa minimum. Zonat e dyqanit online i cakton veçmas (menaxhimi i dyqanit online).
• Zonë në hartë: te një zonë dërgese zgjidh llojin Zonë në hartë dhe pastaj Vizato në hartë. Kliko në hartë për të vendosur pika (të paktën 3); tërhiq një pikë për ta zhvendosur, kliko mbi një pikë për ta hequr dhe tërhiq rrethin e vogël në mes të një brinje për të shtuar një pikë ndërmjet. Harta tregon gjithashtu zonat me rreze dhe lokalin. Pllakat e hartës vijnë nga OpenStreetMap, ndaj harta kërkon internet; vetë dërgesa jo (përveç kërkimit të adresës). Nëse adresa nuk mund të kërkohet, arka e njofton këtë në vend të "jashtë zonave të dërgesës".
• Kostoja e dërgesës shfaqet si rresht "Kostoja e dërgesës" në porosi dhe rillogaritet pas çdo ndryshimi (falas nga, pa produkte = pa kosto), për sa kohë nuk është paguar ende asgjë. Nën minimum nuk mund të paguhet; ekrani i porosisë tregon sa mungon ende, me butonin Gjithsesi për të marrë (kostoja e dërgesës dhe minimumi bien).
• Ora: Sa më shpejt (tani + koha e dërgesës, plus minutat shtesë të zonës) ose një interval kohor i sotëm. Nëse ke orare hapjeje te Thuisbezorgd, ato vlejnë edhe këtu.
• Maksimumi për interval kohor (0 = pa maksimum; intervali kohor 5 deri në 60 minuta): për Për të marrë dhe Dërgesë së bashku; llogariten edhe porositë e dyqanit online në arkë. Nëse ka një maksimum, edhe Për të marrë kërkon një orë dhe intervalet e mbushura nuk mund të zgjidhen. Dy arka njëkohësisht për vendin e fundit: e merr vetëm njëra.
• Në fletën e kuzhinës dalin adresa, emri, telefoni dhe ora; te "Pa tavolinë" dhe në krye të fletës së kuzhinës p.sh. "Dërgesë – 18:30 Jansen".

Zgjerime (gjithçka si parazgjedhje joaktive; pa këto cilësime funksionon saktësisht si më sipër):

• Orar i veçantë për marrje dhe dërgesë (për çdo ditë të javës, p.sh. 16:00-21:00 ose 11:30-14:00, 17:00-22:00; pas mesnate lejohet: 17:00-01:00; bosh = atë ditë e mbyllur). Joaktiv = si më parë (oraret te Thuisbezorgd, nëse ka, përndryshe gjithë ditën).
• Ditët e mbyllura (p.sh. 25-12-2026, 26-12-2026): atëherë nuk ka marrje as dërgesë.
• Porosi paraprake: nga 0 (vetëm sot, si më parë) deri në 14 ditë. Në dritaren Dërgesë/Për të marrë zgjedh fillimisht ditën; një ditë e mëvonshme shfaqet në fletën e porosisë përpara orës.
• Ngarkesë: kaq minuta shtesë te "sa më shpejt" (arka dhe dyqani online). Mund të caktohet shpejt edhe me butonin Dyqani online në shiritin e sipërm.
• Adresat belge (kod postar me 4 shifra): te një rreze ose zonë në hartë, arka e gjen vendndodhjen përmes OpenStreetMap (Nominatim; nevojiten rruga dhe vendi).
• Dyqani online ndjek arkën: arka ka përparësi. Dyqani online përdor atëherë zonat e dërgesës, kohën e dërgesës dhe të marrjes, intervalin kohor, maksimumin për interval kohor, orarin (nëse është caktuar këtu), ditët e mbyllura dhe ditët përpara të arkës, dhe numëron në intervalin kohor edhe porositë e pranuara në arkë. Joaktiv = dyqani online ka cilësimet e veta (menaxhimi i dyqanit online), si më parë. Aktivizimi ose çaktivizimi i marrjes/dërgesës mbetet te dyqani online.

Kodi: lib/bezorgen.ts, routes/bezorgen.ts, BezorgDialoog.tsx, BezorgInstellingen.tsx, BezorgKaart.tsx dhe lib/kaart.ts (harta, pa paketë shtesë; i njëjti kod ndodhet në dyqanin online si public/kaart.js).

Telefonia: njohja e klientit te një porosi me telefon

Cilësimet → Telefonia (si parazgjedhje joaktiv; çaktivizimi ruan gjithçka). Dy çelësa të veçantë:

• Kërkimi i klientit nga numri i telefonit te dërgesa dhe për të marrë: kur shkruani numrin në ekranin e dërgesës, arka tregon klientin me adresën dhe porositë e mëparshme; Merr të dhënat plotëson emrin, email-in dhe adresën. Funksionon edhe pa central telefonik.
• Njohja e numrit: kur telefonon një klient, centrali telefonik (ose aparati, FRITZ!Box, modemi apo telefoni Android) njofton numrin. Në ekrane shfaqet një njoftim me atë që telefonon: emri, adresa, porositë e fundit (me pjatat dhe shumën, edhe nga dyqani online, Thuisbezorgd dhe platformat e dërgesave), totali dhe një rezervim. Me Merr porosi me dërgesë ose Merr porosi për të marrë hapet ekrani i dërgesës me gjithçka të plotësuar (me Dërgesën dhe intervalet kohore aktive); porosia lidhet me telefonatën dhe njoftimi zhduket në të gjitha ekranet. Butoni 📞 në shiritin e sipërm: telefonatat e 24 orëve të fundit. Mund të fiket për çdo ekran (Shfaq njoftimet në këtë ekran).

Kërkohet në kartën e besnikërisë, në porositë me dërgesë dhe për të marrë të arkës, në dyqanin online, Thuisbezorgd, platformat e dërgesave dhe rezervimet. Numrat njësohen (+31 6 1234 5678, 0031612345678 dhe 06-12345678 janë i njëjti; edhe numrat belgë).

Si vjen numri (mund të keni disa njëkohësisht; e njëjta telefonatë llogaritet një herë):

Përgjigjja përmban telefonuesin, edhe si contact (firstname, lastname, phone, email, address) për një shabllon CRM të 3CX. Telefonatat dalëse dhe të brendshme nuk shfaqen; Vetëm këto linja kufizon në linja ose aparate të caktuara. Telefonatat fshihen pas afatit të ruajtjes (si parazgjedhje 30 ditë, GDPR). Telefonatë provë simulon që një numër po telefonon.

Kodi: apps/pos-server/src/lib/telefonie.ts, routes/telefonie.ts, packages/shared/src/telefonie.ts; ekranet Telefonie.tsx, BezorgDialoog.tsx; Android android-app/native/java/Beller*.java. Regjistri: Telefonia.

Korrierë të vetë: tura, dorëzimi i parave dhe gjurmimi i porosisë (track & trace)

Për bizneset me korrierë të vetë. Aktivizoje te Cilësimet → Biznesi → Dërgesë → Korrierë të vetë (si parazgjedhje joaktive). Korrieri nuk ka nevojë për aplikacion: përdor një faqe në shfletuesin e telefonit të vet (kush do, përdor aplikacionin Optimum Bezorger: shih Aplikacioni i korrierëve më poshtë).

Krijimi i një ture. Në arkë është butoni Turet (me numrin e dërgesave që duhet të nisen ende plus turet që janë në rrugë).

1. Te Gati për dërgesë shëno porositë që shkojnë. Këto janë porositë e dërgesës nga arka, dyqani online dhe Thuisbezorgd (vetëm dërgesë e vetë; ato me korrier të Thuisbezorgd jo).
2. Zgjidh korrierin (një punonjës) dhe kusurin që merr me vete (si parazgjedhje shuma nga cilësimi) dhe prek Krijo turë.
3. Shfaqet një kod QR. Korrieri e skanon me telefonin e vet dhe sheh për çdo adresë emrin, adresën me një buton Rruga (navigim), Telefono, shënimin, orën e dëshiruar dhe çfarë ka për të arkëtuar. Ka një llogaritës kusuri (klienti jep € 50 → kusur € 31,50). Nuk duhet hyrje. Ndaje lidhjen vetëm me korrierin: kush e ka, sheh adresat e kësaj ture. Me Kodi QR për korrierin krijon një lidhje të re; e vjetra nuk funksionon më.
4. Prek Nisu kur korrieri largohet. Kusuri del nga sirtari (dalje parash, me arsyen). Klienti merr njoftim se porosia është në rrugë:
   • për një porosi nga arka me SMS dhe/ose email, nëse Mesazhe për klientin është aktiv (shih Dërgesa dhe intervalet kohore);
   • për dyqanin online sipas cilësimeve të tij (email, SMS ose njoftim push);
   • për Thuisbezorgd përmes Thuisbezorgd.

Nëse tura nuk është nisur ende, mund të anulohet.

1. Në rrugë korrieri prek për çdo adresë Dorëzuar, para në dorë, Dorëzuar, kartë (terminal i vetë pagese) ose Dorëzuar (tashmë e paguar). Arka e sheh menjëherë. Nëse korrieri nuk mund ta njoftojë, mund të bëhet edhe në arkë. Kur kthehet në lokal, korrieri prek U ktheva në lokal.

Dorëzimi i parave. Pas turës prek Paguaj (e drejta Menaxho sirtarin e parave):

• Për çdo porosi zgjidh para në dorë, kartë te dera, tashmë e paguar ose nuk u dorëzua (kthim). Ajo që njoftoi korrieri është plotësuar tashmë.
• Arka e paguan çdo porosi me shumë të papaguar pa faturë të re (klienti e ka faturën; ristampimi te Faturat). Një porosi e padorëzuar hiqet nga tura dhe mbetet e hapur, që të shkojë me turën tjetër.
• Sheh çfarë pritet: kusuri plus paratë në dorë të marra. Fut çfarë dorëzon korrieri ose numëroje sipas kartëmonedhave dhe monedhave (Numëro sipas kartëmonedhave dhe monedhave). Arka tregon nëse përputhet ose sa është tepër apo mungesë.
• Kusuri kthehet në sirtar (hyrje parash). Diferenca shfaqet te tura dhe në regjistër, dhe del edhe si diferencë e arkës në raportin Z.

Gjurmimi i porosisë (track & trace) (aktivizohet veçmas te cilësimi). Te në rrugë klienti merr një lidhje për një faqe gjurmimi në portal. Lidhja është në SMS ose email, dhe në dyqanin online te faqja e statusit (Ndiq korrierin tënd). Në faqen e gjurmimit shfaqet:

• nëse porosia po përgatitet, është në rrugë apo është dorëzuar;
• ora e pritur: nga vendndodhja e korrierit përmes adresave që vijnë më parë, përndryshe ora e dëshiruar;
• sa adresa janë ende përpara (pa shfaqur adresat e tjera);
• me Korrieri live në hartë edhe korrieri, lokali dhe adresa e vet në një hartë (OpenStreetMap). Korrieri e aktivizon vetë ndarjen e vendndodhjes në telefon (Ndaj vendndodhjen time). Vendndodhja dërgohet vetëm sa kohë që faqja është e hapur; faqja e mban ekranin ndezur.

Faqet janë në gjuhën e telefonit (të gjitha gjuhët e portalit). Në arkë te tura sheh kur u dërgua vendndodhja për herë të fundit (me një lidhje për hartën).

Privatësia. Portali i ruan të dhënat e turës (emrat, adresat, numrat e telefonit, vendndodhjen) vetëm sa kohë që tura vazhdon. Gjatë llogaritjes fshihet gjithçka, përndryshe pas 24 orësh. Klienti sheh vetëm porosinë e vet. Vendndodhja e korrierit shihet vetëm gjatë turës dhe jo më sapo korrieri kthehet.

Planifikimi i turave (opsional)

Aktivizoje te Cilësimet → Biznesi → Dërgesë → Planifikimi i turave (si parazgjedhje joaktiv; funksionon me korrierë të vetë). Në dritaren Turet shfaqet atëherë butoni Propozo tura. Arka i bashkon në tura porositë që duhet të nisen ende:

• porositë që janë afër njëra-tjetrës dhe oraret e dëshiruara të të cilave bien brenda dritares kohore (si parazgjedhje 30 minuta) shkojnë bashkë;
• deri në numrin maksimal të adresave për turë (si parazgjedhje 4), për sa kohë që tura (vajtja, të gjitha adresat dhe kthimi te biznesi) nuk zgjat më shumë se maksimumi (si parazgjedhje 45 minuta);
• për çdo turë renditja më e mirë, distanca (km), koha e udhëtimit vajtje-ardhje dhe për çdo adresë mbërritja e pritur nëse niset tani. Nëse kjo është më vonë se ora e dëshiruar, pranë saj shkruhet më vonë se ç'është kërkuar.

Me Përdor këtë turë shënon ato porosi, në atë renditje; zgjidh korrierin dhe prek Krijo turë. Te një turë që ende nuk është nisur, Renditja më e mirë i vendos adresat në renditjen më të shpejtë (edhe në telefonin e korrierit). Te çdo turë shfaqen distanca dhe koha e udhëtimit.

Cilësimet: adresa për turë, sa mund të zgjasë një turë, dritarja kohore, shpejtësia e korrierit (biçikletë ~15, skuter ~25, makinë ~35 km/orë në qytet) dhe minutat për adresë (parkim, zile, pagesë; parazgjedhje 2). Këto vlera mund t'i cilësojë edhe menaxheri: në dritaren Turet me butonin Cilëso planifikimin e turave (e drejta Cilëso planifikimin e turave, parazgjedhur aktive për menaxherin; ndryshohet te Cilësimet → Të drejtat). Aktivizimi ose çaktivizimi i planifikimit të turave dhe shërbimi i rrugëve (adresa, çelësi API) mbeten te administratori.

Distanca dhe koha e udhëtimit, zgjidhet nga administratori:

• Vlerësim (parazgjedhje): vija ajrore herë 1,35 (faktor devijimi) me shpejtësinë e korrierit. Funksionon pa internet dhe pa llogari.
• OSRM: rrugë mbi rrugën automobilistike përmes një serveri OSRM. Plotëso adresën (https://, ose http:// në rrjetin e vet). Serveri publik demo (https://router.project-osrm.org) është vetëm për përdorim të rastësishëm; për përdorim të përditshëm vendos një server OSRM të vetin ose zgjidh një ofrues.
• OpenRouteService: rrugë mbi rrugën automobilistike me një çelës API të vetin (krijohet falas në openrouteservice.org, me një kufi në ditë). Adresa si parazgjedhje është https://api.openrouteservice.org dhe mund të ndryshohet në një server të vetin. Çelësi mbetet në arkë; ekranet tregojnë vetëm që është plotësuar.

Me Testo provon shërbimin. Nëse shërbimi nuk funksionon, planifikimi kthehet te vlerësimi dhe e njofton këtë. Një adresë vendndodhja e së cilës nuk dihet (pa kod postar dhe numër shtëpie të vlefshëm) del në propozim te pa vendndodhje të njohur dhe nuk planifikohet. Eksporti i konfigurimit i përfshin cilësimet, por jo çelësin.

Kodi: lib/ritplanning.ts.

Aplikacioni i korrierëve (opsional)

Aktivizoje te Cilësimet → Biznesi → Dërgesë → Aplikacioni i korrierëve (si parazgjedhje joaktive; funksionon me korrierë të vetë dhe portalin e menaxhimit). Çdo korrier e lidh atëherë telefonin e vet vetëm një herë, në vend që të skanojë një kod QR për çdo turë:

1. Te Telefonat e lidhur zgjidh korrierin (një punonjës), sipas dëshirës emrin e telefonit, dhe prek Lidh telefonin.
2. Shfaqet një kod QR. Korrieri e skanon në aplikacionin Optimum Bezorger (butoni Lidh) ose me kamerën e telefonit: atëherë faqja hapet në shfletues. Ajo funksionon edhe pa aplikacion dhe mund të vendoset në ekranin bazë.
3. Lidhja mbetet e vlefshme derisa ta revokosh; telefoni atëherë nuk sheh më asgjë menjëherë. Një lidhje e re për të njëjtin punonjës zëvendëson të vjetrën (për shembull me një telefon të ri).

Në aplikacion ose në faqe shfaqen të gjitha turet e veta (çdo turë që arka krijon për këtë korrier), me të njëjtët butona si te një turë: Rruga, Telefono, për t'u arkëtuar me llogaritës kusuri, Dorëzuar dhe U ktheva në lokal. Aktivizohen veçmas:

• Marrja vetë e porosive: korrieri sheh dërgesat që duhet të futen ende në një turë, shënon çfarë merr me vete dhe prek Merr me vete. Arka krijon turën (ose i shton nëse ai korrier ka tashmë një turë që nuk është nisur); kusuri standard shkon me të. Atë që e ka marrë tashmë dikush tjetër, nuk mund ta marrësh më.
• Nisja vetë: Nisu në aplikacion bën të njëjtën gjë si në arkë (kusur nga sirtari, klientët marrin njoftim).
• Hartë live: te Turet ndodhet butoni Harta me lokalin, të gjithë korrierët që janë në punë dhe adresat që duhet të dorëzohen ende. Korrieri e aktivizon dhe e çaktivizon vetë Në punë. Aplikacioni e dërgon vendndodhjen edhe me ekranin fikur (Android: një njoftim në shirit sa kohë ndarja është aktive); faqja web vetëm sa kohë është e hapur. Pa këtë cilësim vendndodhja ndahet vetëm gjatë një ture me track & trace.

Aplikacioni për Android gjendet në Google Play dhe në faqen e shkarkimit të portalit (/download/). Një version për iPhone është gati, por del vetëm kur të ketë një llogari zhvilluesi Apple; deri atëherë iPhone-ët përdorin faqen web. Te një turë që korrieri e mori vetë shkruhet marrë vetë në aplikacion.

Kodi: lib/bezorgersapp.ts, në portal src/volgen.mjs dhe aplikacioni në repon horecapos-bezorger.

Në regjistër shfaqet kush e krijoi një turë, e nisi, e njoftoi si të dorëzuar dhe e llogariti, me shumat. Çaktivizimi: pa butonin Turet; turet dhe cilësimet ruhen.

Në portal: /bezorger/<sleutel> dhe /volg/<code>. Kodi: lib/bezorgers.ts, routes/bezorgers.ts, Bezorgers.tsx dhe në portal src/volgen.mjs.

Njoftim për kohë përgatitjeje shumë të gjatë

Një porosi për të marrë ose me dërgesë që bëhet gati më vonë se sa u premtua: arka e vëren dhe e njofton, dhe mund t’i dërgojë menjëherë klientit një kërkim falje, sipas dëshirës me kupon krediti. Aktivizoje te Cilësimet → Lokali → Dërgesë → Njoftim për kohë përgatitjeje shumë të gjatë (si parazgjedhje joaktiv).

• Cilat porosi: për të marrë dhe me dërgesë me orë të premtuar, nga arka (dërgesë dhe intervale kohore), dyqani online dhe Thuisbezorgd.nl / Takeaway.com.
• Me vonesë: kaq minuta (si parazgjedhje 10) pas orës së premtuar ende jo gati ose në rrugë. Gati ose në rrugë do të thotë: gjithçka gati në ekranin e kuzhinës, statusi gati ose në rrugë në dyqanin online ose te Thuisbezorgd, mesazhi ✉ Gati / ✉ Në rrugë i dërguar klientit, ose e paguar. Arka kontrollon çdo minutë.
• Njoftim: butoni Me vonesë në shiritin e sipërm me numrin (me zë kur ka një të re), për çdo porosi ora e premtuar dhe sa minuta vonesë. Një porosi zhduket vetë kur është gati ose në rrugë, ose me Zgjidhur; poshtë janë ato të 24 orëve të fundit, me kohën kur u bënë gati. Gjithçka regjistrohet në regjistër.
• Dyqani online: faqja e statusit të klientit tregon që po zgjat më shumë, me orën e re të pritur.
• Te Thuisbezorgd kjo nuk është e mundur (klienti i përket Thuisbezorgd): aty vetëm njoftimi. Mund të përdorësh tekst vetjak; {naam}, {zaak}, {code}, {korting} dhe {geldig} plotësohen automatikisht.
• Kupon krediti (vetëm me Kodet e zbritjes aktive): me kërkimin e faljes një kod zbritjeje personal për porosinë e radhës (p.sh. SORRY-7K4Q2M), shumë ose përqindje, për një përdorim, i vlefshëm për disa ditë, në arkë dhe në dyqanin online. Kodet nuk shfaqen në listën te Kodet e zbritjes. Nëse dërgimi dështon, kodi skadon. Me butonin në arkë vetëm me të drejtën Jep zbritje.
• Joaktiv: njoftimet dhe kodet e lëshuara ruhen (edhe në kopjen rezervë); cilësimi përfshihet në eksportin e konfigurimit.

Kodi: lib/telaat.ts, routes/telaat.ts, TeLaat.tsx dhe packages/shared/src/telaat.ts.

Butoni Porosit: çfarë bën dhe kur të duhet

Prekja e një produkti dhe prekja e Porosit janë dy hapa të ndryshëm:

• Prekja e vendos produktin menjëherë në llogari (në listën majtas), si i ri. Vetëm ti e sheh: kuzhina dhe bari ende nuk dinë asgjë. Një rresht i ri është si një shënim provizor: heqja, ndryshimi i sasisë ose i opsioneve bëhet ende pa problem, pa storno.
• Porosit i dërgon të gjithë rreshtat e rinj njëherësh: fletët e punës shkojnë te printerët e kuzhinës dhe të barit (dhe te ekrani i kuzhinës), pastaj rreshtat kalojnë në porositur. Heqja atëherë bëhet vetëm me Storno (e drejta storno). Mbi buton shkruhet sa rreshta të rinj janë gati, p.sh. Porosit (3); nëse nuk ka rreshta të rinj, butoni është gri.

Pse dy hapa? Në tavolinë merr gjithë porosinë (pijet, antipastën, pjatën kryesore), rregullon diçka nëse klienti ndërron mendje, dhe pastaj e dërgon njëherësh në kuzhinë, me një fletë për çdo stacion në vend të një flete për çdo produkt. Kështu kuzhina mund të fillojë herët, shumë kohë përpara pagesës.

Çfarë tjetër ndodh me Porosit:

• Radhët e gjellëve: radha 1 shkon menjëherë në kuzhinë; radhët 2, 3 dhe 4 dërgohen si PRIT dhe kuzhina fillon vetëm kur e thërret atë radhë (shih Radhët e gjellëve).
• Raundet: çdo herë që shtyp Porosit është një raund; ↻ Edhe një raund funksionon mbi këtë bazë.
• Stoku zbritet dhe një rubinet me dozim lirohet.
• All-you-can-eat: nëse është shumë, shumë herët ose shumë vonë për paketën, arka pyet fillimisht nëse lejohet gjithsesi.
• Belgjika (GKS 2.0): rreshtat shkojnë fillimisht si pro forma te kutia e zezë; nëse kjo nuk ia del, asgjë nuk shkon në kuzhinë dhe ata mbeten të rinj.
• Pa lidhje: porosia ruhet dhe shkon në kuzhinë sapo të kthehet lidhja. Printeri i fikur: porosia vazhdon gjithsesi, fleta e punës hyn në radhën e printimit (shih Printeri i kuzhinës i fikur ose pa ekran kuzhine).

Mund të paguash edhe direkt. Nëse prek Paguaj ndërkohë që ka ende rreshta të rinj në llogari, arka i porosit ato fillimisht automatikisht, që kuzhina dhe bari të marrin gjithmonë fletën e tyre. Pra në bar ose për marrje me vete nuk ke nevojë të prekësh fillimisht Porosit: prek produktin dhe menjëherë Paguaj. Nëse kjo porositje automatike nuk ia del (pa lidhje, rresht all-you-can-eat, kutia e zezë), ekrani i pagesës mbetet i mbyllur dhe sheh arsyen.

Nuk dëshiron faturë për barin kur paguan menjëherë? Te Cilësimet → Biznesi → Porositja dhe pagesa aktivizo Pagesë e drejtpërdrejtë pa fletë pune. Atëherë vetëm ajo që dërgon me Porosit shkon te kuzhina dhe bari; ajo që paguan menjëherë nuk merr fletë pune.

Butoni Paguaj i madh ose i vogël

Me kutinë Butoni i madh "Paguaj" të shënuar, ekrani i porosisë ka një buton të madh Paguaj menjëherë poshtë produkteve të porositura: të gjerë, të lartë dhe me shumën, që të shtypet shpejt. Nëse një pjesë e faturës është paguar, butoni tregon shumën që mbetet. Butoni i vogël poshtë pranë Porosit atëherë zhduket.

Me butonin e madh edhe butonat në ekranin e pagesës janë të mëdhenj: Paguaj (te Kartë, Kartë dhuratë dhe mënyrat e tjera të pagesës) dhe te Para në dorë Para të sakta dhe Paguaj janë të gjerë dhe të lartë, të lehtë për t'u shtypur, edhe me gishta të pistë (për shembull te një kasap). Mënyrat e pagesës janë pak më të mëdha dhe butonat e bakshishit pak më të vegjël, që gjithçka të mbetet në ekran.

Në një instalim të ri kutia është e çaktivizuar: atëherë butoni i vogël poshtë pranë Porosit dhe një ekran pagese me butona të zakonshëm. Preferon të madh? Te Cilësimet → Biznesi, menjëherë poshtë temës së çelët/të errët, shëno Butoni i madh "Paguaj". Një arkë që ishte tashmë në përdorim mban atë që kishte. Zgjedhja vlen për të gjitha arkat dhe tabletët e biznesit.

Shëno një produkt si "mbaroi" (shitur plotësisht)

Në ekranin e porosisë kushdo mund ta mbajë të shtypur një produkt (ose ta klikojë me butonin e djathtë të miut) dhe të zgjedhë Mbaroi (i shitur). Produkti bëhet gri dhe nuk mund të porositet më në asnjë arkë. Në të njëjtën mënyrë e kthen me Sërish në dispozicion. Çdo ndryshim shënohet në regjistër. Administratori mund ta bëjë këtë ende edhe te Cilësimet → Produktet. Edhe serveri i arkës e refuzon një produkt që është "mbaroi" ("Cola" ka mbaruar), pra edhe nga një tablet që nuk e kishte marrë ende ndryshimin ose nga porositë e ruajtura offline; ai tablet tregon atëherë "Dërgimi nuk u krye".

Ekrani i kuzhinës (KDS)

Përveç (jo në vend të) printerëve të fletëporosive, kuzhina ose bari mund të përdorë një ekran. Në një tablet/kompjuter në kuzhinë hap http://<kassaserver>:3000/keuken, hyr me një kod PIN dhe zgjidh stacionin: këta janë të njëjtët emra si të printerëve (kuzhina, bari, ...), kështu që në ekran shfaqet saktësisht ajo që do të dilte në atë fletëporosi. "Të gjitha" tregon të gjitha stacionet.

• Një fletë për çdo porosi, më e vjetra e para, me tavolinën/për ta marrë, numrin dhe sa kohë ka që pret (portokalli pas 10, e kuqe pas 20 minutash).
• Radhët shfaqen veçmas; një radhë që nuk është thirrur ende shfaqet gri si "PRET thirrjen". Anulimet shfaqen të vijëzuara.
• Prek një rresht për ta shënuar gati, ose Gati për gjithë fletën. Kamarierët marrin atëherë në shiritin e sipërm "Kuzhina: Tavolina 5 është gati". Me Cilësimet → Lokali → Ekrani i kuzhinës → Tingull për kamarierët (si parazgjedhje joaktiv) arka lëshon edhe një bip ("ding-dong", pa skedar zanor). Shfletuesi lejon tingull vetëm pas prekjes së parë të ekranit; ngrije volumin e tabletit.
• Rikthe tregon çfarë është shënuar gati në orën e fundit; kështu mund të rikthesh diçka të hequr gabimisht.

Ekrani përditësohet menjëherë vetë. Fletëporositë vazhdojnë të printohen normalisht; kush nuk e përdor ekranin, nuk vëren asgjë.

Ekrani i kuzhinës: kalimi, renditja dhe radha

Cilësimet → Printerët → Ekrani i kuzhinës. Çdo pjesë aktivizohet veçmas, joaktive si parazgjedhje; çaktivizimi ruan gjithçka.

• Kalimi ndërmjet stacioneve, për shembull ftohtë → ngrohtë → dorëzim. Për çdo stacion caktoni një stacion të ardhshëm fiks; në porosi shfaqet atëherë një buton → ngrohtë (dhe gjithmonë Kaloje te… për të zgjedhur një stacion tjetër). Kalojnë vetëm rreshtat e hapur të atij stacioni. Një stacion nuk ka nevojë për printer: shkruani stacione si dorëzim te Stacione pa printer. Gati (dhe njoftimi për kamarierin) vjen vetëm në stacionin e fundit. Te "Të gjitha", te një rresht i kaluar shfaqet ku ndodhet tani. Çdo hap shfaqet te rreshti dhe në regjistër.
• Rirenditja: tërhiqni porositë (me maus) ose zhvendosini me ◀ ▶ (ekran me prekje). Renditja vlen për stacion dhe për të gjitha ekranet e atij stacioni; porositë e reja shkojnë në fund.
• Radha tjetër nga ekrani i kuzhinës: te një porosi me një radhë në pritje shfaqet Kërko radhën 2. Kamarieri merr atëherë "Kuzhina kërkon radhën 2 për Tavolina 5" (me zë) dhe thërret si zakonisht; në ekranin e kuzhinës shfaqet "Radha 2 u kërkua · n min" derisa radha të thirret. Ose zgjidhni Thirr: atëherë ekrani i kuzhinës e thërret vetë radhën, me fletën e punës "THIRRJE RADHA 2", njësoj si butoni në arkë.

Printeri i kuzhinës i fikur ose pa ekran kuzhine

Arka vazhdon gjithmonë të punojë, edhe kur printeri i kuzhinës ose i barit është i fikur (ose ka mbaruar letra, ose kablloja është e shkëputur) dhe edhe pa ekran kuzhine:

• Porosia kalon gjithmonë. Rreshtat shënohen menjëherë si porositur, llogaria është e saktë dhe pagesa bëhet normalisht. Printerët thirren njëkohësisht dhe secili printer merr më së shumti rreth 4 sekonda: një printer i fikur nuk i lë të tjerët (dhe kamarierët) të presin gjatë.
• Radha e printimit. Një fletëporosi që nuk u printua shkon në radhën e printimit. Serveri i arkës e provon sërish çdo 30 sekonda, për një çerek ore; sapo printeri funksionon sërish, ajo del, me PRINTUAR MË VONË në krye. Nëse fatura tjetër në atë printer printohet sërish, fletët në pritje dalin menjëherë pas saj.
• Pas një çerek ore riprovimi ndalon vetë; Printo sërish tani mbetet ende i mundur.
• Ekrani i kuzhinës. Nëse porosia është në ekranin e kuzhinës, kuzhina e sheh atje edhe kur printeri është i fikur. Kush nuk përdor ekran kuzhine, nuk humbet asgjë: arka nuk pret askund për "Gati" nga kuzhina.
• Radha e printimit ruhet vetëm në kujtesën e serverit të arkës (pas një rinisjeje është bosh).
• Edhe fatura e klientit: nëse nuk printohet, pagesa është kryer gjithsesi (arka njofton "printimi dështoi") dhe më vonë mund të printosh një kopje te Faturat.

Radha e pjatave (paragjellë, pjatë kryesore ...)

Butonat e radhëve shfaqen vetëm kur nevojiten: sapo në porosi ka një meny (produkt i përbërë), ose kur ka tashmë diçka në radhën 2 deri 4. Me produkte të zakonshme, si një kola, nuk i sheh dhe gjithçka shkon menjëherë në kuzhinë. Nuk ka asgjë për të vendosur.

Poshtë listës së porosisë është Radha 1 2 3 4. Si parazgjedhje radha 1 është aktive dhe gjithçka funksionon si gjithmonë: "Porosit" i dërgon të gjitha menjëherë në kuzhinë, pa tituj radhësh në fletëporosi. Nëse zgjedh radhën 2 (ose më të lartë) para se të prekësh produktet, atëherë:

• me "Porosit" ato shkojnë tashmë në kuzhinë, nën "-- Radha 2 · PRET thirrjen --", që kuzhina të mund të përgatitet;
• në listën e porosisë shkruan "Radha 2 · pret" me një buton Thirr;
• me Thirr kuzhina merr një fletë " THIRRJE RADHA 2 " me atë që duhet përgatitur tani.

Radha 1 shkon gjithmonë menjëherë. Nëse radha 2 është thirrur tashmë, një pjatë e porositur më vonë në radhën 2 shkon gjithashtu menjëherë.

Alergjenet për produkt

Si parazgjedhje joaktiv: atëherë alergjenet nuk shfaqen askund. Aktivizoje te Cilësimet → Lokali → Plotëso dhe shfaq alergjenet për çdo produkt.

• Cilësimet → Produktet: te çdo produkt shëno 14 alergjenet e BE-së (gluten, krustace, vezë, peshk, kikirikë, soje, qumësht, arra, selino, mustardë, susam, sulfite, lupinë, molusqe). Në listën e produkteve shkurtimet shfaqen pas emrit.
• Ekrani i porosisë: në çdo buton produkti shkurtimet me shkronja të vogla (p.sh. Gl Me), dhe butoni ⚠ Alergjenet në shiritin e grupeve tregon për çdo produkt të grupit të zgjedhur alergjenet të plota, me shpjegimin e shkurtimeve.
• Ndryshimet e alergjeneve shënohen në regjistër (i vjetër → i ri). Nëse cilësimi është joaktiv, alergjenet e plotësuara më parë ruhen.

All-you-can-eat

Si parazgjedhje joaktiv. Aktivizohet te Cilësimet → Lokali → All-you-can-eat (vetëm administratori). Krijon një ose më shumë paketa, p.sh. Peshk, Mish dhe Sushi, secila me:

• një emër (del në faturë: "Peshk i rritur", "Peshk fëmijë");
• një çmim për të rritur dhe për fëmijë (me TVSH) dhe shkallën e TVSH-së (si parazgjedhje NL LAAG, BE B);
• pjatat që përfshihen (€ 0): grupe të tëra produktesh dhe/ose produkte të veçanta (edhe nga grupe të tjera, p.sh. patate të skuqura te Peshk edhe te Mish);
• një kufi kohor në minuta (0 = pa kufi);
• raunde: më së shumti kaq pjata për person për raund (0 = pa kufi) dhe të paktën kaq minuta mes dy raundeve (0 = pa kufi);
• një tarifë për ushqim të mbetur për copë (0 = pa tarifë).

Me ↑ ↓ cakton renditjen. Ajo ka rëndësi kur një pjatë përfshihet në disa paketa: atëherë shkon te paketa më e lartë që ka zgjedhur grupi. Fshi e heq një paketë për tavolinat e reja; tavolinat aktive i mbajnë rreshtat e çmimit (aty mund të ulësh numrin e personave, por jo ta rritësh).

Në tavolinë:

• Në ekranin e porosisë, mbi faturën, ndodhet + All-you-can-eat. Për çdo paketë zgjidh numrin e të rriturve dhe fëmijëve; lejohet e përzier (p.sh. 2× Peshk dhe 2× Mish). Çmimi shtohet si rreshta në llogari; ato nuk shkojnë në kuzhinë. Numri i personave të grupit bëhet totali i pjesëmarrësve (nëse arka regjistron persona).
• Shiriti tregon për çdo paketë: personat, kohën e mbetur (e kuqe kur koha ka mbaruar), në cilin raund jeni me maksimumin, dhe sa kohë mbetet deri në raundin tjetër. Pjatat e përfshira shfaqen në butona si AYCE dhe në faturë me etiketën AYCE për € 0. Gjithçka që nuk përfshihet në asnjë paketë të zgjedhur (pije, ëmbëlsira ...) paguhet normalisht.
• Porosit: çdo herë që shtyp "Porosit" me pjata falas është një raund, për çdo paketë (vetëm paketat nga të cilat ka pjata). Ajo që është prekur offline dhe dërguar më vonë nuk bllokohet.
• Ndrysho: ndrysho numrat për çdo paketë. Më pak persona llogaritet si anulim (e drejta "anulim"). Vendosja e një pakete në 0 (ose Ndalo për të gjitha) është e mundur derisa në llogari të mos ketë ende pjata nga ajo paketë.
• Tarifë (vetëm nëse një paketë e zgjedhur ka tarifë për ushqim të mbetur): zgjidh sasinë (dhe paketën, nëse ka disa); "Tarifë për ushqim të mbetur × sasia" shtohet në llogari.
• Pagesa, ndarja, zbritjet dhe fatura funksionojnë si gjithmonë: çmimet e paketave, tarifa dhe pijet janë rreshta të zakonshëm me TVSH-në e tyre.
• Nëse administratori e çaktivizon all-you-can-eat ndërkohë që ka grupe aktive, pjatat e prekura rishtas kushtojnë sërish çmimin normal; ajo që është tashmë në llogari mbetet.
• Në dyqanin online (opsionale, si parazgjedhje joaktive): me Edhe kur porositet në tavolinë përmes kodit QR (dyqani online), mysafiri që porosit në një tavolinë me paketë i sheh pjatat e paketës si Të përfshira për € 0, me gjendjen sipër (persona, raund, kohë). Një porosi është një raund, me të njëjtat rregulla si Porosit; shumë, shumë herët ose shumë vonë, dyqani online e refuzon menjëherë. Pijet dhe pjatat e tjera mysafiri i paguan normalisht; gjithçka shkon në llogarinë e tavolinës. Joaktive = dyqani online llogarit çmimet e zakonshme, si më parë.

Karta dhurate

Dy çelësa te Cilësimet → Lokali → Kartat dhuratë:

• Kartë dhuratë si mënyrë pagese në arkë: si parazgjedhje aktiv, si gjithmonë. Joaktiv = butoni Kartë dhuratë nuk shfaqet te pagesa (as te kthe paratë me gjatë një kthimi), dhe serveri i arkës e refuzon pagesën me kartë dhuratë.
• Shit karta dhuratë me saldo: si parazgjedhje joaktiv. Aktiv:
  • Në ekranin e porosisë është butoni Kartë dhuratë: zgjidh shumën (€ 10, 25, 50, 100 ose një shumë tjetër) dhe lëre arkën të krijojë një kod, ose skano kodin e një karte të parashtypur. Karta shtohet si rresht në llogari (kodi i TVSH-së BON: pa qarkullim, pa TVSH, nuk shkon në kuzhinë). Aty mund edhe të shohësh saldon për një klient.
  • Pas pagesës karta aktivizohet dhe printeri i faturave printon një kartë dhuratë me shumën, kodin dhe një kod QR.
  • Përdorimi: te pagesa zgjidh Kartë dhuratë dhe skano ose shkruaj kodin (butoni Saldo tregon saldon). Shuma zbritet nga saldo. Nëse saldo është më e ulët se llogaria, i gjithë saldo zbritet si pagesë e pjesshme dhe pjesën tjetër e paguan me kartë ose para në dorë. Saldo mund të përdoret në disa herë.
  • Kodi bosh = kartë dhuratë pa kod, si më parë (p.sh. një kupon i vjetër letre).
  • Raporti → Kartat dhuratë (e drejta Menaxho kartat dhuratë, si parazgjedhje menaxheri dhe administratori): kërko sipas kodit, kredia e papërdorur, historiku për çdo kartë, blloko (e humbur/e vjedhur) dhe korrigjo saldon me një arsye. Kjo shënohet në regjistër.
  • Raportet: kartat dhuratë të shitura nuk llogariten si qarkullim dhe shfaqen veçmas (Karta dhuratë të shitura); paratë e marra shfaqen megjithatë te mënyrat e pagesës. Ajo që paguhet me kartë dhuratë është qarkullim i zakonshëm (me TVSH) te mënyra e pagesës Kartë dhuratë.
  • Kontabiliteti: kartat e shitura regjistrohen në kredi dhe kartat e përdorura në debi në llogarinë Kartat dhuratë (kredia e klientëve).
  • Një kartë dhuratë e shitur mund të kthehet përmes Faturat → Kthim, për sa kohë nuk është përdorur ende (saldo = vlera). Pas kthimit karta anulohet (saldo 0, e bllokuar; shënohet në historikun e kartës). Nëse është përdorur tashmë (pjesërisht), vendos saldon në 0 te Raporti → Kartat dhuratë dhe ktheje mbetjen veçmas. Zbritje në një kartë dhuratë nuk është e mundur.

Gjendje e rimbushshme (opsionale)

Për klube, mensa sportive, qendra rinore dhe evente: një kartë dhuratë me gjendje bëhet një kartë e rimbushshme. Aktivizohet te Cilësimet → Biznesi → Gjendje e rimbushshme, nën kartat dhuratë (si parazgjedhje joaktiv; funksionon vetëm nëse Shit karta dhuratë me bilanc është aktiv).

• Kartë ose byzylyk: shit një kartë dhuratë me Kartë e parashtypur dhe skano kartën (një lexues NFC/RFID që punon si tastierë, ose një barkod). Numri i kartës bëhet atëherë kodi; me të mysafiri paguan si me kartë dhuratë.
• Rimbushja: ekrani i porosisë → Kartë dhuratë → Rimbush gjendjen: skano kartën dhuratë ose kartën dhe fut shumën. Ajo shtohet si rresht në llogari (kodi i TVSH-së BON: pa xhiro, pa TVSH, njësoj si një kartë dhuratë e shitur) dhe pas pagesës është në gjendje. Në historikun e kartës shfaqet Rimbushur.
• Gjendja maksimale për kartë dhuratë ose kartë (si parazgjedhje € 500, mund të caktohet deri në € 5.000).
• Kthe gjendjen e mbetur (kutizë, si parazgjedhje joaktive; e drejta Menaxho sirtarin e parave): pas Kontrollo gjendjen shfaqet Kthe gjendjen e mbetur. Gjendja shkon në € 0 dhe shuma shfaqet si para nga sirtari në raportin X dhe Z (Gjendje e kthyer …).
• Një rimbushje mund të anulohet përmes Faturat → Kthim për sa kohë gjendja është ende të paktën ajo shumë; karta dhuratë ose karta mbetet e vlefshme.
• Rimbushja në kiosk (opsionale): shih Kiosk vetëshërbimi.

Kupona ushqimi

Vetëm për lokale në Belgjikë, si parazgjedhje joaktiv: Cilësimet → Biznesi → Paguaj → Kupona ushqimi. Kuponat e ushqimit janë një përfitim nga paga: punëdhënësi i ngarkon në një kartë të punonjësit (Edenred, Monizze ose Pluxee). Mysafiri paguan me to në terminalin e zakonshëm të pagesës; nuk nevojitet lidhje me lëshuesit.

• Aktiv: gjatë pagesës shfaqet butoni Kupon ushqimi. Zgjidh lëshuesin (vetëm lëshuesit që pranon lokali) dhe lëre mysafirin ta mbajë kartën te terminali i pagesës, njësoj si te pagesa me kartë. Pa lidhje me terminalin: mysafiri paguan në vetë terminalin e pagesës dhe ti prek Paguaj.
• Pa bakshish dhe pa kusur me kupona ushqimi. Nëse gjendja nuk mjafton, mysafiri e paguan pjesën tjetër ndryshe (llogaria mbetet e hapur derisa të paguhet gjithçka).
• Vetëm për kategori të caktuara (opsionale, p.sh. ushqim por jo alkool): atëherë me kupona ushqimi mund të paguhet maksimumi shuma e këtyre produkteve në llogari. Ekrani i pagesës tregon sa; pjesën tjetër mysafiri e paguan ndryshe.
• Në faturë: Kupon ushqimi Pluxee (me lëshuesin në fund).
• Raporti Z dhe raporti X: një rresht më vete për çdo lëshues (Kupon ushqimi Edenred, … Monizze, … Pluxee).
• Kontabiliteti: një llogari kontabël më vete për çdo lëshues (Kupona ushqimi Pluxee (për t'u arkëtuar) etj., si parazgjedhje 416100, 416200 dhe 416300), sepse paratë vijnë nga lëshuesi dhe jo nga banka e terminalit të pagesës.
• Nevojitet: një marrëveshje me çdo lëshues kuponat e të cilit pranon, dhe një terminal pagese që i pranon këto karta (pyet për këtë furnitorin e terminalit të pagesës).

Valutë e huaj

Pagesë me para në dorë në një monedhë tjetër, p.sh. turistë britanikë ose amerikanë, ose në zonën kufitare me franga zvicerane. Si parazgjedhje joaktiv: Cilësimet → Biznesi → Paguaj → Valutë e huaj. Shto monedhat (CHF, CZK, DKK, GBP, HUF, NOK, PLN, SEK, TRY, USD) me një kurs për çdo monedhë: sa euro llogarit për 1 njësi (p.sh. 1 GBP = € 1,15).

• I futur vetë: një kurs fiks; ndryshoje vetë kur ai ndryshon.
• Live (BQE): kursi ditor i Bankës Qendrore Evropiane (kurse reference, çdo ditë pune rreth orës 16:00; falas, pa llogari). Me një shtesë në përqindje (0-20) kursi ulet po aq, që biznesi të mos e paguajë vetë këmbimin. Arka i merr vetë kurset kur janë më të vjetër se 6 orë; Përditëso tani i merr menjëherë. Pa internet mbetet kursi i fundit.
• Aktiv: gjatë pagesës shfaqet butoni Valutë e huaj. Zgjidh monedhën; kasa tregon sa është në atë monedhë. Fut sa jep mysafiri: kasa e konverton dhe jep kusurin në euro. Nëse mysafiri nuk do kusur, shëno Kusuri është bakshish: kusuri shkon si bakshish në faturë, në Belgjikë në atë monedhë (GKS 2.0, UC296).
• Nëse mysafiri jep më pak se shuma e plotë, është një pjesë; pjesën tjetër e paguan ndryshe.
• Në faturë: monedha, shuma dhe kursi, si dhe kusuri në euro.
• Raporti X dhe Z: një rresht më vete për çdo monedhë (Valutë e huaj GBP, në euro), dhe te sirtari i parave sa ka në sirtar në atë monedhë. Kusuri në euro zbritet nga paratë e pritura në sirtar; monedhat e huaja i numëron veçmas.
• Kontabiliteti: llogaritet si para në dorë (arkë), në euro.

Butona shtesë te porosia dhe pagesa

Butona për gjëra që nuk i duhen çdo biznesi. Të gjitha janë joaktive si parazgjedhje; aktivizohen për çdo buton te Cilësimet → Biznesi → Porositja dhe pagesa (e drejta Konfigurimi i biznesit, pagesave dhe printerëve). Joaktiv = butoni nuk shfaqet askund në arkë dhe serveri i arkës e refuzon veprimin. Në Holandë gjithçka funksionon pa kutinë e zezë; në Belgjikë një buton funksionon vetëm kur ai funksion është testuar me kutinë e zezë (te butoni shkruhet nëse nuk është ende).

Kur hap një tavolinë:

• Regjistro numrin e personave: pyetja "Sa persona?" te një tavolinë e lirë, personat në planin e sallës dhe në ekranin e porosisë, si dhe mysafirët në raporte. Shih Numri i personave.

Gjatë porosisë (ekrani i porosisë, për çfarë prek më pas):

• Mbledhja e produkteve të njëjta (pa buton, si parazgjedhje aktiv): nëse prek sërish të njëjtin produkt (të njëjtat opsione, ende i paporositur), sasia rritet në vend të një rreshti të ri: 4 Cola në një rresht me çmimin herë 4. Me − hiqet përsëri një, edhe nëse është porositur tashmë (storno e një). Me një shënim, vend ose për ta marrë me vete mbetet rresht më vete; ajo që është porositur tashmë mbetet rresht më vete (një raund i ri).
• − dhe + (para çmimit në çdo rresht): − heq një, + shton një (i njëjti produkt, opsione dhe shënim; nëse Mbledhja e produkteve të njëjta është e çaktivizuar, një rresht i ri). Ende e paporositur dhe në 0: rreshti hiqet. Tashmë e porositur: një më pak është storno, ai rresht mbetet i vijëzuar (për kuzhinën dhe raportet); një më shumë bëhet rresht i ri që duhet ende porositur. Prekja e vetë çmimit nuk heq më asgjë. Te një menu vetëm −.
• Për të marrë (vetëm në lokal): mysafiri e merr këtë produkt me vete, p.sh. një shishe ujë ose një ëmbëlsirë. Ai rresht merr TVSH-në e marrjes me vete (në Belgjikë etiketa C), pjesa tjetër e llogarisë TVSH-në e lokalit. Në faturë te rreshti shkruhet me vete.
• Vendi (në një tavolinë): prek disa herë për vendin 1, 2, 3 ...; rreshtat marrin atë numër vendi (edhe në fletën e kuzhinës). Në Belgjikë çdo rresht shkon me qendrën e kostos së vendit (CHAIR, UC4123) te kutia e zezë. Edhe një herë pas vendit 12 = përsëri pa vend.
• Merr mbrapsht: produkti i radhës shtohet me -1, p.sh. një shishe ose gotë bosh (depozitë). Kjo mundet vetëm te produktet me Mund të kthehet (depozitë) (Cilësimet → Produktet). Nëse e gjithë llogaria është negative (vetëm depozitë e kthyer, pa shitje), Paguaj bëhet rimbursim: para në dorë mbrapsht ose me kartë (kthyer në vetë terminalin). Në Belgjikë si rimbursim (REFUND, UC4108 dhe UC4114).
• Shfrytëzo SPV: mysafiri paguan një produkt ose menu me një single purpose voucher (një kupon pikërisht për atë produkt, p.sh. "1 menu all-in"). Prek Shfrytëzo SPV dhe pastaj produktin në faturë: ai shtohet me -1 (i njëjti çmim dhe TVSH, te një menu me pjesët), me SPV pranë. Nuk shkon në kuzhinë; mund të hiqet normalisht. Një produkt-kupon e shet paraprakisht si produkt të zakonshëm; shëno te Cilësimet → Produktet SPV (kupon). Në Belgjikë rreshti shkon në shitje si VOUCHER te kutia e zezë (UC271).
• Llogarit paradhënien: shih më poshtë.
• Çmim i hapur (pa buton, për produkt): te një produkt me Çmim i hapur arka kërkon çmimin, p.sh. pjata e ditës ose një paradhënie.

Gjatë pagesës:

• Pagesë e drejtpërdrejtë pa fletë pune (nuk është buton): si parazgjedhje Paguaj porosit fillimisht atë që nuk është porositur ende, që kuzhina dhe bari të marrin gjithmonë faturën e tyre (shih Butoni Porosit). Aktiv: ajo që paguan menjëherë pa prekur më parë Porosit nuk merr fletë pune, p.sh. te bari ku e merr vetë. Ajo që është porositur tashmë nuk ndryshon.
• Pagesë veçmas (në një tavolinë, te Ndaj llogarinë): zgjidh çfarë paguan tani një mysafir, edhe një pjesë të një rreshti (½ për gjysmë shishe). Kjo bëhet pjesë më vete që e paguan menjëherë; pjesa tjetër mbetet në llogari, pa e ndarë më parë llogarinë apo pa e zhvendosur në një grup tjetër. Zbritja në përqindje për të gjithë faturën kalon në proporcion. Kthehu pa paguar = gjithçka përsëri në llogari. Në Belgjikë shitja mbetet në vendin e tavolinës, pa ndërrim tavoline (UC4103bis, UC4104).
• Mysafiri iku pa paguar (e drejta Mbyllje pa pagesë, si parazgjedhje vetëm menaxheri dhe administratori): llogaria mbyllet si shitje pa pagesë, me një arsye në regjistër. Në raportin X dhe Z dhe në pasqyrën ditore shfaqet si E papaguar (mysafiri iku); në regjistrimin kontabël te e pambledhshme (si parazgjedhje 4985 / 643000). Në Belgjikë një shitje pa pagesë (UC4109).

Më vonë (Faturat):

• Korrigjo çmimin (e drejta Korrigjimi i çmimit të një fature, si parazgjedhje vetëm menaxheri dhe administratori): çmimi i një fature të paguar nuk ishte i saktë, p.sh. 50% zbritje në vend të 5%. Arka krijon një faturë të re pa tavolinë me rreshtat e faturës së vjetër mbrapsht (negativ, me sa u pagua atëherë) dhe të njëjtat produkte përsëri me çmimin e zakonshëm. Jep atje zbritjen e saktë dhe paguaj diferencën (ose rimburso nëse çmimi i ri është më i ulët). Fatura e vjetër mbetet siç ishte; një herë për faturë, dhe jo nëse është kthyer tashmë diçka. Në Belgjikë rreshtat e vjetër shkojnë si CORRECTION (UC4116).

Kodi: apps/pos-server/src/lib/kassaopties.ts, routes/kassaopties.ts; ekrani KassaOpties.tsx. Regjistri: Cilësimi u ndryshua, SPV u shfrytëzua, Korrigjim fature, E papaguar.

Llogarit paradhënien

Një paradhënie (kapar, p.sh. për një festë ose një rezervim) e shet si produkt të zakonshëm me Paradhënie aktiv (Cilësimet → Produktet; ka gjithmonë çmim të hapur). Krijo një për çdo normë TVSH-je nëse paradhënia duhet sipas normës (p.sh. Paradhënie ushqim dhe Paradhënie pije), ose një produkt nëse është pjesë e ofertës. Mysafiri e paguan paradhënien përpara dhe merr një faturë.

Aktivizimi: Cilësimet → Biznesi → Porositja dhe pagesa → Llogarit paradhënien (si parazgjedhje joaktiv). Në pagesën përfundimtare prek në ekranin e porosisë Llogarit paradhënien dhe fut numrin e faturës së paradhënies. Arka vendos rreshtat e paradhënies së asaj fature me sasi negative në llogari (i njëjti produkt, çmim dhe TVSH). Çfarë është llogaritur tashmë nuk mund të llogaritet sërish. Nëse paradhënia është më shumë se llogaria, mysafiri merr diferencën mbrapsht (rimbursim). Në Belgjikë rreshtat e llogaritur shkojnë si rimbursim (REFUND) te kutia e zezë (UC4110, UC4111, UC4113). Regjistri: Paradhënia u llogarit.

Fatura me e-mail

Si parazgjedhje joaktiv. Aktivizoje te Cilësimet → Lokali → Fatura edhe me email.

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

Rinise arkën pasi t'i plotësosh. Më pas te Paguaj shfaqet fusha Dërgo faturën edhe me email (opsionale): bosh = vetëm printim si gjithmonë; me një adresë email = e njëjta faturë (me specifikimin e TVSH-së dhe rreshtat fiskalë) i dërgohet edhe mysafirit me email, me emrin e lokalit si dërgues.

• Adresa email nuk ruhet; në regjistër shënohet vetëm "fatura N u dërgua te a***@domein.nl" dhe nëse u krye.
• Nëse dërgimi me email nuk funksionon (p.sh. të dhëna hyrjeje të gabuara), fatura është paguar dhe printuar normalisht; njoftimi tregon çfarë shkoi keq.
• Jo te një pagesë e pjesshme (ndarje e llogarisë): fatura del me pagesën e fundit, prandaj adresën e shkruan aty.
• Dërgo me email më vonë: te Faturat, pranë një fature është butoni Dërgo me email (e drejta Printo kopje të faturës). Ai e dërgon faturën me shënimin KOPJE, njësoj si një kopje e printuar (në Belgjikë regjistrohet si kopje).
• Nuk nevojiten paketa shtesë: arka komunikon vetë me serverin e postës (STARTTLS në 587, TLS në 465).

Rezervimet

Aktivizoje te Cilësimet → Lokali → Rezervimet (si parazgjedhje joaktiv). Aty cakton edhe sa minuta përpara shfaqet një tavolinë e rezervuar në planimetri (si parazgjedhje 60) dhe kohëzgjatjen standarde të një rezervimi (si parazgjedhje 120 minuta).

• Butoni Rezervimet në shiritin e sipërm: përmbledhje për çdo ditë (◀ ▶), me numrin e rezervimeve, personave dhe mosparaqitjeve. + Rezervim i ri: emri, telefoni, email, personat, data, ora, kohëzgjatja, tavolina (mund edhe më vonë) dhe shënim. Rezervimet i bën stafi; rezervim online (ende) nuk ka.
• Nëse në të njëjtën tavolinë në atë interval kohor ka tashmë një rezervim, arka të njofton; "Ruaje gjithsesi" është e mundur.
• Konfirmim me email (shenjë, ose më vonë "Dërgo me email") nëse ka një adresë email dhe një server poste (SMTP_HOST, shih Fatura me email).
• Në planimetri një tavolinë e lirë e rezervuar shfaqet vjollcë me "R 19:30 Jansen (4)". Nëse e prek: "Jansen erdhi" e hap tavolinën me 4 persona dhe "Jansen" si emër grupi; "Mysafirë të tjerë" e hap normalisht.
• Në përmbledhje: Mbërriti (hap tavolinën; pa tavolinë zgjedh fillimisht një), Ndrysho, Mosparaqitje, Anulo dhe Rikthe. Gjithçka shënohet në regjistër.
• Rezervime nga platformat online: shihni Platformat e rezervimeve më poshtë.

Lidhja e arkës me TheFork: tavolina hapet në mbërritje, fatura kthehet

Me POS-API të TheFork arka punon së bashku me TheFork Manager (si parazgjedhje joaktiv), krahas marrjes së rezervimeve më sipër. Aktivizohet te Cilësimet → Platformat e rezervimeve → Lidhja e arkës me TheFork; funksionon përmes portalit të menaxhimit.

• Nëse në TheFork Manager një mysafir vendoset në Mbërriti ose Në tavolinë, në arkë hapet tavolina me të njëjtin emër, me numrin e mysafirëve dhe një shënim: emri, alergjitë dhe dieta, paradhënia, oferta/zbritja dhe pikët e besnikërisë (Yums). Nëse në atë tavolinë ka tashmë një porosi të hapur, ajo lidhet. Nuk ka tavolinë me atë emër: shfaqet një njoftim dhe te Platformat zgjidhni tavolinën.
• Pas pagesës fatura shkon te TheFork (totali dhe rreshtat me emrin, grupin e produktit, sasinë dhe shumën); TheFork e vendos atëherë rezervimin në U largua. Me pagesë të ndarë, një faturë me totalin. Nëse nuk ia del, arka provon përsëri çdo çerek ore (dy ditë), ose me Dërgo përsëri te Platformat.
• Çiftimi: arka shfaq një kod çiftimi; shkruajeni në TheFork Manager (Integrimet → arka). ID-në e restorantit në TheFork (Customer-id) e plotëson administratori, ose vjen automatikisht me porosinë e parë.
• Kutitë e zgjedhjes: hap automatikisht tavolinën, emri, alergjitë dhe paradhënia si shënim, fatura te TheFork.
• Kusht: Pin Voordeel ka çelësin API të TheFork (vetëm për partnerë) dhe e ka regjistruar arkën atje si POS (buton në portalin e menaxhimit); TheFork e aktivizon lidhjen pas një sesioni testimi.

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

Lista e pritjes për klientët pa rezervim

Për mysafirët pa rezervim që presin për një tavolinë. Aktivizoje te Cilësimet → Lokali → Lista e pritjes (walk-ins) (si parazgjedhje joaktiv). Shfaqet vetëm nëse SMS-ja përmes CM.com është konfiguruar; përndryshe lista e pritjes nuk shfaqet askund në arkë (as te cilësimet). Funksionon e pavarur nga rezervimet: edhe kur ato janë joaktive. Aty është edhe teksti i SMS-së (bosh = "Hallo {naam}, uw tafel bij {zaak} is klaar. Wilt u zich melden bij de bediening?"; {naam}, {zaak} dhe {personen} plotësohen automatikisht).

• Butoni Lista e pritjes në shiritin e sipërm, me numrin e atyre që presin (portokalli kur pret dikush). + Në listën e pritjes: emri, telefoni (për SMS-në), personat, koha e pritjes e thënë dhe një dëshirë (tarracë, karrige për fëmijë).
• Lista është sipas radhës së regjistrimit, me sa kohë ka që pret secili (e kuqe kur zgjat më shumë se sa u tha) dhe në krye numri i atyre që presin, personat dhe koha mesatare e pritjes sot.
• Nëse SMS-ja nuk dërgohet, shfaqet arsyeja. Dërgo SMS sërish është e mundur.
• Ul: zgjidh tavolinën; arka e hap me numrin e personave (nëse arka regjistron persona) dhe emrin si emër grupi (njësoj si te një rezervim që mbërrin).
• Iku (u largua ose u çregjistrua) dhe Rikthe. Poshtë listës shfaqen ata që sot u vendosën ose ikën, me sa kohë kanë pritur.
• Privatësia: numrat e telefonit fshihen pas një dite; kush është ende në listë pas 12 orësh, hiqet automatikisht. Regjistrimi, thirrja (vetëm me 3 shifrat e fundit të numrit) dhe vendosja shënohen në regjistër.
• Pse jo te Rezervimet? Një rezervim është për më vonë (data, ora, tavolina paraprakisht); lista e pritjes është për tani (radha, koha e pritjes, SMS kur tavolina lirohet). Prandaj ka çelës dhe buton të vetin, me të njëjtën "hap tavolinën" si te një rezervim.
• Online në listën e pritjes (opsionale, si parazgjedhje joaktive; vetëm me dyqanin online): me Mysafirët mund të regjistrohen edhe vetë përmes dyqanit online, në dyqanin online shfaqet Lista e pritjes (dhe ka një kod QR për te dera, te menaxhimi i dyqanit online te Tavolinat dhe QR). Mysafiri plotëson emrin, telefonin, numrin e personave dhe një dëshirë dhe e sheh vendin e tij drejtpërdrejt. Në arkë ai shfaqet në listë me online; thirrja, vendosja dhe iku funksionojnë si gjithmonë, dhe mysafiri e sheh edhe në telefon (aty mund edhe të çregjistrohet).

Kartë besnikërie / pikë

Aktivizoje te Cilësimet → Lokali → Karta e klientit / pikët (si parazgjedhje joaktiv, atëherë nuk duket asgjë askund). Aty cakton edhe: pikë për euro (0 = vetëm karta me vula), pas sa pikësh jepet një shpërblim dhe sa euro zbritje është ai shpërblim.

• Në arkë mbi faturë është "+ Karta e klientit": kërko klientin sipas emrit ose numrit të telefonit, ose krijo një klient të ri (emri, opsionalisht telefoni dhe email). Më pas emri me saldon e pikëve shfaqet në faturë.
• Shkëmbe: me mjaftueshëm pikë "Shkëmbe 100 pikë: € 5 zbritje"; me kartë vulash të plotë "Kafe falas" (ajo kafe duhet të jetë në faturë). Kjo bëhet rresht zbritjeje; kushdo mund ta heqë sërish.
• Pikët dhe vulat shtohen dhe zbriten vetëm në momentin e pagesës: pikët mbi shumën pas zbritjes (pa kartat dhuratë të shitura), vulat për çdo copë të një produkti me kartë vulash (produkti falas nuk llogaritet).
• Në faturë: të grumbulluara, të shkëmbyera, saldo dhe gjendja e kartave me vula.
• Raporti → Klientët (e drejta Menaxho kartën e klientit): kërko klientë, ndrysho të dhënat, korrigjo pikët (me arsye), historiku, dhe fshi (GDPR: emri, telefoni dhe email-i hiqen; historiku mbetet anonim). Poshtë janë kartat me vula për çdo produkt (p.sh. 10 kafe = 1 falas).
• Një kthim nuk i anulon automatikisht pikët e grumbulluara; korrigjoji sipas nevojës te Raporti → Klientët.
• Kartë besnikërie me numër (opsionale): te Raporti → Klientët → (klienti) plotëso numrin e kartës (ose skano kartën në atë fushë). Me skanerin e barkodit, skanimi i asaj karte e lidh klientin me faturën, në arkë dhe te kioska. Kërkimi sipas numrit të kartës bëhet edhe te + Kartë besnikërie.

Profili i mysafirit: VIP, kërkesat ushqimore dhe preferencat (opsionale)

Aktivizohet te Cilësimet → Biznesi → Profili i mysafirit, poshtë kartës së besnikërisë (si parazgjedhje joaktiv; funksionon vetëm kur karta e besnikërisë është aktive). Pastaj:

• Në ekranin e porosisë, poshtë klientit të lidhur, shfaqet "+ Profili i mysafirit": shëno VIP, zgjidh kërkesat ushqimore (vegjetarian, vegan, peskatarian, hallall, kosher) dhe alergjitë (14 alergjenet) dhe shkruaj preferencat (p.sh. "tavolinë e përhershme pranë dritares", maksimumi 300 karaktere). Pastaj ato shfaqen te klienti në ekranin e porosisë, alergjitë me të kuqe. Mund të ndryshohen edhe te Raporti → Klientët → (klienti) → Profili i mysafirit.
• Nëse prek një produkt me një alergjen të mysafirit (shih Alergjenet për produkt), arka pyet fillimisht nëse duhet shtuar gjithsesi. Vlen vetëm ajo që është plotësuar te produkti; në rast dyshimi pyet gjithmonë kuzhinën.
• Një VIP merr një ★ në planin e sallës: te një llogari e hapur dhe te rezervimi i shfaqur i atij klienti. Kur mbërrijnë mysafirët e një rezervimi, arka e lidh klientin e rezervimit me llogarinë.
• Kërkesat ushqimore dhe alergjitë (dhe VIP) dalin në fletën e kuzhinës për kuzhinën dhe barin: GAST: VIP · Vegetarisch · allergie: Noten.
• Kërkesat ushqimore dhe alergjitë janë të dhëna shëndetësore: plotësoji vetëm me pëlqimin e mysafirit. Në regjistër shënohet vetëm që profili është ndryshuar, jo vetë kërkesat. Fshirja e klientit fshin edhe profilin e mysafirit.

Të preferuarat / butonat e shpejtë

Si parazgjedhje joaktiv. Cilësimet → Lokali → Të preferuarat / butona të shpejtë:

• Më të shiturat: në fillim të shiritit të grupeve butoni ★ Të preferuarat me 12 produktet më të shitura në 14 ditët e fundit (përditësohet vetë). Ekrani i porosisë hapet te të preferuarat.
• Zgjidh vetë: në ekranin e porosisë mbaje të shtypur një produkt (ose kliko me të djathtën) dhe zgjidh ★ I preferuar (buton i shpejtë); edhe një herë = hiqe. E drejta Menaxho produktet. Të gjitha arkat e shohin menjëherë.
• Prekja, opsionet, menutë, happy hour dhe "mbaroi" funksionojnë te të preferuarat saktësisht si te grupet e zakonshme.

Edhe një raund

Në ekranin e porosisë është butoni ↻ Edhe një raund (sapo të ketë diçka në llogari, edhe nëse nuk është porositur ende). Një prekje shton edhe një herë raundin e fundit (gjithçka që shkoi njëherësh me "Porosit", ose atë që sapo preke) si rreshta të rinj; më pas thjesht Porosit. Çmimet janë ato të tanishmet (edhe happy hour).

• Shtypje e gjatë (ose kliko djathtas): zgjidh vetë. Me ◀ ▶ shfleton raundet e mëparshme, për çdo produkt aktiv/joaktiv (p.sh. hiq shenjën nga ushqimi) dhe sasia me − / +. Opsionet dhe shënimet përfshihen.
• Produktet që kanë mbaruar dhe menutë nuk përfshihen (menutë i prek veçmas). Funksionon edhe pa lidhje.
• Rreshtat shtohen ashtu siç janë në llogari: me Mbledhja e produkteve të njëjta të aktivizuar, një rresht për produkt (2 Cola); të çaktivizuar, çdo rresht veçmas (2 herë 1 Cola).

Koha në tavolinë në planin e sallës

Në çdo tavolinë të zënë shfaqet ⏱ 45m · 12m: sa kohë ka që tavolina është e zënë dhe sa kohë ka kaluar nga prekja e fundit e diçkaje (prek dhe mbaje tavolinën, ose kalo mbi të me miun, për kohët e sakta). Nëse për një kohë nuk është porositur asgjë, tavolina merr një kornizë portokalli: kalo një herë. Sa minuta e cakton te Cilësimet → Lokali → Koha e tavolinës (si parazgjedhje 20, 0 = pa kornizë portokalli). Nëse ende nuk është prekur asgjë, llogaritet nga hapja e tavolinës.

Nëse në një tavolinë janë disa grupe (llogari të veçanta), shfaqet një rresht për çdo grup, p.sh. G1 ⏱ 50m · 12m dhe Jansen ⏱ 10m (emri i grupit, përndryshe numri i grupit). Një grup që qëndron shumë gjatë pa porositur merr një etiketë portokalli dhe tavolina një kornizë portokalli.

Zhvendos të gjithë tavolinën

Në ekranin e porosisë ka Zhvendos tavolinën. Zgjidh sallën (p.sh. Tarraca) dhe një tavolinë: të gjitha grupet e tavolinës zhvendosen, secili me llogarinë e vet. Nëse zgjedh një tavolinë të zënë, tavolinat bashkohen (grupet shtohen). Nëse do të zhvendosësh vetëm një pjesë, përdor si më parë Ndaj / zhvendos. Nëse gjithçka duhet në një llogari, përdor Bashko.

Vazhdo offline (tablet pa Wi-Fi)

Nëse lidhja mes një tableti dhe serverit të arkës bie (Wi-Fi në tarracë, serveri i fikur për pak), shfaqet një shirit i verdhë dhe tableti vazhdon të punojë me tavolinat, produktet dhe porositë e hapura të ruajtura së fundi:

• hapja e tavolinave, prekja e produkteve dhe Porosit ruhen në tablet (edhe nëse ai riniset) dhe shfaqen në listën e porosisë me kornizë me pika ("ende pa dërguar");
• sapo lidhja kthehet, gjithçka shkon sipas radhës te serveri dhe vetëm atëherë fletëporosia shkon në kuzhinë. Çdo paketë ka një çelës, kështu që asgjë nuk mbërrin dy herë. Nëse dikush tjetër e hapi tavolinën ndërkohë, produktet shtohen te ajo porosi;
• pagesa, zbritja, ndarja etj. janë të mundura vetëm me lidhje; "Paguaj" pret derisa gjithçka e asaj tavoline të jetë dërguar.

Numri i personave

Opsionale dhe si parazgjedhje joaktive: Cilësimet → Biznesi → Porositja dhe pagesa → Regjistro numrin e personave. Joaktive = sa më pak prekje: një tavolinë e lirë hapet me një prekje, askund nuk shfaqen persona, dhe raporti, paneli dhe përmbledhja e ditës nuk tregojnë mysafirë dhe as shpenzim për mysafir.

Aktive: kur prek një tavolinë të lirë, arka pyet sa persona janë (butona të mëdhenj 1-8, ose shkruaje; "Kapërce" = 1). Në planin e sallës, te një tavolinë e zënë shfaqet "3/4 pers." (persona/vende, me të verdhë nëse ulen më shumë njerëz se vende). Në ekranin e porosisë e ndryshon me butonin "3 pers." në shiritin e grupeve; me disa grupe, tavolina i mbledh të gjitha grupet.

Pa persona gjithçka vazhdon të funksionojë: Ndaj në mënyrë të barabartë te pagesa nis nga 2, all-you-can-eat pyet vetë numrin e të rriturve dhe fëmijëve, ndërsa rezervimet dhe lista e pritjes mbajnë numrin e tyre të personave (tavolina atëherë hapet pa persona).

Regjistrimi HACCP

Çdo lokal duhet të mbikëqyrë dhe të dokumentojë sigurinë ushqimore: në Holandë sipas Hygiënecode voor de Horeca (Kodi i higjienës për hotelerinë, kontrolli nga NVWA), në Belgjikë sipas autokontrollit të FAVV (udhëzuesi G-023). Aktivizo Regjistrimi HACCP te Cilësimet → Ligje dhe rregulla (si parazgjedhje i çaktivizuar).

• Pikat e matjes (administratori): p.sh. dhoma ftohëse, ngrirësi, mbajtja ngrohtë, temperatura në thelb pas gatimit, ftohja e shpejtë dhe pranimi i mallrave, me një minimum dhe/ose maksimum në °C dhe sa shpesh (çdo ditë, dy herë në ditë, çdo javë ose gjatë përdorimit). Shto listën standarde krijon një pikënisje (ftohja deri në 7 °C, në Belgjikë deri në 4 °C; ngrirësi deri në -18 °C; mbajtja ngrohtë nga 60 °C; gatimi nga 75 °C).
• Pastrim dhe kontroll: detyra sipas ditës, javës (sipas dëshirës në një ditë të caktuar) ose muajit, me hapësirë dhe udhëzim, p.sh. dezinfektimi i dërrasave të prerjes, filtrat e yndyrës, kontrolli i dëmtuesve, kontrolli i termometrit.
• Regjistrimi (kushdo që është i identifikuar): butoni HACCP në shiritin e sipërm, me numrin e atyre që janë ende të hapura sot. Shkruaj temperaturën ose shëno një detyrë (U bë ose Nuk u arrit). Nëse një temperaturë del jashtë kufirit, duhet shtuar një masë korrigjuese (p.sh. "dera u mbyll, produkti u hodh"). Regjistrimet nuk mund të ndryshohen; një gabim e korrigjon me një regjistrim të ri.
• Përmbledhja (e drejta Xhiro sipas periudhës): për çdo periudhë të gjitha regjistrimet, numri i devijimeve dhe regjistrimet e humbura për ditë; si CSV (Excel) ose për ta printuar / ruajtur si PDF për një kontroll.

Sistemi i birrës me fuçi dhe matësit e rrjedhjes

Çdo mbushje që raporton një kompjuter rubinetash ose matës rrjedhjeje shkon në faturë, kështu që asgjë nuk "rrjedh" jashtë. Aktivizoje te Cilësimet → Sistemi i birrës me fuçi (fikur si parazgjedhje).

• Burimet (administratori): kompjuteri i birrës ose sistemi i matësve të rrjedhës. Zgjidhni markën; arka plotëson një paracaktim. Nga Holanda dhe Belgjika: Van Duijnen Horeca (automatizim i rubinetave, Dashbar), Beconet (Multi-Tap), TapSystems, Horecatechniek Nederland, Heineken SmartDispense, WeissBeerger / AB InBev dhe BarTrack; gjithashtu Gruber, Addimat, WMF / Hogatron (E-Protokoll), Drinkotec (ex-Hartec), , Berg, Easybar, Azbar, Scanabar, PourMyBeer, iPourIt, BeerBoard, US BeerSAVER, Bevchek, Capton/BarVision, Kegtron, Kegbot Kegboard, një "rubinet i zgjuar" ose një sistem i juaji. Lidhja bëhet në pesë mënyra (Kegboard: shihni Mbushje e dozuar dhe Kegboard më poshtë):
  • Fushat: kraan (ose tap, plu), ml (ose cl, liter, volume me eenheid) ose porties, id (e njëjta mbushje dy herë = regjistruar një herë), tijdstip, tafel, bediening; një mbushje, një listë ose { "taps": [...] }.
  • Rrjet (TCP): arka lidhet me kompjuterin e rubinetave (adresa dhe porti) ose dëgjon vetë në një port.
  • Port serial: port COM ose USB-serial, 1200–115200 baud, 8N1, 7E1 ose 7O1.
  • Për rrjet dhe serial cakton formatin e mesazhit (një mesazh për rresht, ose STX … ETX me kontroll XOR të mundshëm dhe ACK/NAK mbrapsht) dhe modelin e një mesazhi, me pjesët kraan ose plu dhe sipas nevojës ml, cl, liter, porties, tafel, bediening dhe id (p.sh. kraan;ml ose vetëm një PLU për gotë). Furnizuesit ua japin formatin e saktë vetëm instaluesve; pyet furnizuesin e kompjuterit të rubinetave. Mbushje prove dërgon një mbushje ashtu siç do ta bënte kompjuteri i rubinetave.
• Rubinetat (administratori): për çdo rubinet ose PLU produkti dhe si shkon në faturë: për gotë (gota në ml; një mbushje prej 520 ml me gota 250 ml = 2 gota; nga 50% llogaritet një gotë) ose për litër (çmimi i produktit është çmimi për litër; në faturë p.sh. "Pils 0,33 l" për shumën e saktë).
• Në faturë: nëse kompjuteri i rubinetave raporton një tavolinë, mbushja shkon menjëherë në porosinë e hapur të asaj tavoline. Përndryshe qëndron te Mbushur: në ekranin e porosisë shfaqet shiriti "… herë mbushur pa faturë"; zgjidh mbushjet dhe prek Në këtë faturë. Rreshtat janë menjëherë porositur (nuk shkon më fletë pune te bari) dhe stoku zbritet. Butoni Mbushur në shiritin e sipërm tregon gjithçka që nuk ka ende faturë.
• Refuzimi (e drejta Storno): shpëlarje, thyerje, provë, staf, falas ose të tjera (me shpjegim); kjo regjistrohet në ditar. Shumë pak për një gotë (p.sh. shpëlarje) duhet refuzuar.
• Përmbledhja (e drejta Xhiro sipas periudhës): për çdo rubinet mbushur, në faturë, refuzuar (sipas arsyes), anuluar dhe ende të hapura, në litra, me përqindjen e shitur, dhe si CSV.
• Mbushjet e raportuara nuk mund të ndryshohen (vetëm të trajtohen).

Mbushje e dozuar dhe Kegboard

Me mbushje të dozuar, një rubinet hapet vetëm pasi gota të jetë regjistruar në arkë, dhe vetëm për atë sasi. Kështu nuk mbushet asgjë që nuk është në faturë. Funksionon vetëm kur sistemi i birrës është aktiv, dhe e aktivizoni për çdo rubinet (si parazgjedhje joaktiv).

• Për rubinet (administratori, Cilësimet → Sistemi i birrës me fuçi → Rubinetat): shënoni Mbushje e dozuar dhe zgjidhni sa gjatë mund të qëndrojë hapur rubineti pas regjistrimit (10–600 sekonda, parazgjedhje 120). Te Kegboard plotësoni edhe relenë (valvulën solenoide). Mbushja e dozuar është e mundur vetëm për gotë.
• Regjistrimi: te Porosit (ose te Paguaj direkt) arka krijon për çdo rresht fature me atë produkt një lëshim (numri i gotave × gota në ml) dhe e dërgon te kompjuteri i birrës. Mbushja që vjen më pas i përket atij rreshti. Prandaj nuk shtohet përsëri në faturë dhe as te Mbushur. Një mbushje pa lëshim shkon normalisht te Mbushur.
• Storno e rreshtit para mbushjes: rubineti mbyllet përsëri. Një lëshim që nuk mbushet në kohë skadon; rubineti nuk hapet kurrë më vonë.
• Lëshimet në ekranin e porosisë (një shirit mbi faturë): shihni çfarë po ndodh, Ndalo dhe Lësho përsëri. Lëshimi përsëri është i mundur vetëm nëse ende nuk është mbushur asgjë, kështu që nuk lëshohet kurrë diçka shtesë. Lëshim test (administratori) lëshon një gotë pa faturë; kjo shënohet në regjistër.
• Si arrin lëshimi te kompjuteri i birrës:
  • Kegboard (Kegbot, me burim të hapur, ESP32 me matës rrjedhe dhe valvula solenoide; protokoll plotësisht publik): arka jep një grant për rubinetat me atë produkt, relete dhe sasinë. Pllaka e mbyll vetë rubinetin kur arrihet sasia ose mbaron koha.
  • Rrjet/serial: një komandë lëshimi e konfigurueshme me {kraan}, {ml}, {porties}, {sec} dhe {id} (p.sh. V{kraan};{ml}), e dërguar në formatin e mesazhit të burimit (rresht ose STX … ETX me XOR). Opsionalisht ka një komandë ndalimi. Komandën e saktë e jep furnizuesi.
• Lidhja e Kegboard: te + Burim zgjidhni markën Kegbot Kegboard. Pllaka paraqitet te burimi; klikoni Lejo (ose Refuzo). Pllaka merr atëherë një herë një çelës të vetin, që arka e ruan vetëm si hash. Një pajisje tjetër ose një çelës i gabuar nuk ndryshon asgjë te një pllakë e lidhur; nëse pllaka e ka humbur çelësin, përdorni fillimisht Shkëput lidhjen. Burimi tregon firmware-in, matësit dhe relétë e pllakës. Rubinetat janë numrat e matësve (0, 1 …). Një kartë te pllaka refuzohet: pagesa bëhet në arkë. Nëse sistemi i rubinetave është i fikur, pllaka i ruan mesazhet dhe i dërgon më vonë.
• Te burimi caktoni pas sa sekondash pa rrjedhë mbyllet rubineti (5–300, parazgjedhje 30). Për çdo rubinet plotësoni numrin e matësit, reléun (valvola solenoidi) dhe sa kohë mund të qëndrojë i hapur rubineti pas regjistrimit.

Kontrolli i muzikës nga arka

Stafi kontrollon muzikën nga ekrani me prekje i arkës, kështu që nuk nevojitet ekran i veçantë në banak. Aktivizoje te Cilësimet → Lokali → Ekranet dhe përdorimi → Kontrolli i muzikës nga arka (si parazgjedhje joaktiv). Atëherë në shiritin e sipërm shfaqet butoni Muzika: për çdo burim (p.sh. Bari dhe Tarraca) Luaj, Pauzë, Tjetra, E mëparshmja, Më fort, Më ulët dhe një rrëshqitës për volumin, bashkë me atë që po luhet. Kthehu te arka mbyll panelin. Kur e çaktivizon, burimet mbeten të ruajtura.

• Radha e luajtjes (Sonos, Bluesound dhe VLC): lista me atë që po luan tani. Prek një këngë për ta luajtur; me Përshtat heq këngë (✕), i ngre ose i ul (↑ ↓; Sonos dhe Bluesound) ose zbraz radhën e luajtjes. Me Zgjidh muzikë tjetër luan një të preferuar Sonos (p.sh. një stacion radioje ose kanal Tunify) ose listë luajtjeje Sonos, ose një paracaktim BluOS.
• Në një ekran të veçantë: i njëjti kontroll dhe radha e luajtjes në madhësi të madhe te http://<kassaserver>:3000/muziek, p.sh. në një monitor të dytë pranë arkës ose në një tablet në banak (nëse je identifikuar tashmë në të njëjtën pajisje, përndryshe me kod PIN).
• Në tablet ose telefon: një kod QR me adresën e atij ekrani të veçantë në rrjetin e lokalit. Një punonjës e skanon me tabletin ose telefonin e vet (në rrjetin wifi të lokalit) dhe identifikohet me kodin e vet PIN; me Dil mbyllet përsëri. Shih Ekran i dytë në tablet ose telefon.

Administratori shton burimet me + Burim muzike, zgjedh si është lidhur secili dhe e provon me Testo:

• Soundtrack (soundtrack.io): përmes API-së publike, me një token API (kërkohet te Soundtrack) dhe një zonë zëri (Ngarko zonat). Luaj, pauzë, tjetra, volumi dhe çfarë po luhet.
• Sonos: adresa IP e altoparlantit (në grup: altoparlanti që drejton grupin). Funksionon me gjithçka që luhet në Sonos, p.sh. Tunify, Spotify ose radio.
• Bluesound (BluOS): adresa IP e luajtësit; funksionon gjithashtu me gjithçka që luhet në të, p.sh. Tunify.
• VLC në kompjuterin e muzikës: ndërfaqja e uebit aktive (Mjete → Parapëlqime → Shfaq të gjitha → Ndërfaqja → Ndërfaqet kryesore: Web, me fjalëkalim te Lua); adresa IP (sipas nevojës me :poort, parazgjedhja 8080) dhe fjalëkalimi.
• Kompjuter muzike i yti (adresa uebi): për një kompjuter ose pajisje muzike me një adresë uebi për çdo buton; GET ose POST, dhe {volume} (0-100) në adresë për volumin. Pa adresë për Më fort/Më ulët, arka e ndryshon volumin me hapa.
• Web player-i i shërbimit të muzikës: adresa e uebit e web player-it ose e faqes së kontrollit (p.sh. web player-i i Tunify ose Media Tools) hapet në arkë me butonin Muzika; nëse shërbimi nuk lejohet në një faqe tjetër, përdor Hape në dritare të veçantë.

Arka komunikon me luajtësit nga serveri, prandaj ata duhet të jenë në të njëjtin rrjet me arkën (Soundtrack përmes internetit). Kontrollin mund ta përdorë kushdo që është i identifikuar; konfigurimi kërkon lejen Konfigurimi i lokalit, pagesave dhe printerëve. Tokeni dhe fjalëkalimi nuk shfaqen më kurrë në ekran dhe as në regjistër; në regjistër shënohet vetëm konfigurimi (aktiv/joaktiv, burimet), jo çdo shtypje butoni. Eksporti i konfigurimit përfshin vetëm aktiv/joaktiv (burimet i përkasin një lokali).

Ekran i dytë në tablet ose telefon

Muzika dhe kamerat mund të shfaqen edhe në tabletin ose telefonin e një punonjësi, si ekran i dytë pranë arkës. Në dritaren Muzika ose Kamerat ndodhet butoni Në tablet ose telefon: ai shfaq një kod QR me adresën, p.sh. http://192.168.1.20:3000/muziek ose .../camera.

1. Lidhe tabletin ose telefonin me rrjetin wifi të lokalit.
2. Skano kodin QR me kamerën (ose shkruaj adresën në shfletues).
3. Identifikohu me kodin tënd PIN. Sheh vetëm atë që të lejohet: muzikën të gjithë, kamerat vetëm me të drejtën Shiko pamjet e kamerave.
4. Gati: Dil lart djathtas. Nëse identifikimi ka skaduar (p.sh. tableti ka qëndruar i papërdorur gjithë natën), ekrani kërkon përsëri kodin PIN.

Këshillë: vendose faqen në ekranin bazë të tabletit (në shfletues: Shto në ekranin bazë), atëherë hapet si aplikacion.

Prandaj arka kërkon adresën IP të kompjuterit të arkës në rrjet (nëse kompjuteri ka më shumë se një, p.sh. wifi dhe kabllo, zgjedh rrjetin). Në portalin e menaxhimit (arka në distancë) është adresa e portalit. Kodin QR e krijon vetë arka, pa internet.

Lidhja e tabletëve: me një buton te tableti (opsionale)

Edhe më e thjeshtë: lidh një tablet një herë dhe arka dërgon muzikën ose kamerat në atë tablet me një buton. Aktivizoje te Cilësimet → Lokali → Ekranet dhe përdorimi → Tabletët si ekran i dytë (si parazgjedhje joaktiv).

1. Në tablet: hap http://<kassaserver>:3000/tablet (te cilësimi gjendet Në tablet ose telefon me kodin QR), hyr me një kod PIN dhe jepi tabletit një emër, p.sh. Tableti i Barit. Lidh.
2. Në arkë: në dritaren Muzika ose Kamerat tani shfaqet butoni Te Tableti i Barit (me një pikë të gjelbër nëse tableti është i ndezur). Prek atë: tableti e hap vetë atë ekran. Te muzika kalon edhe burimi i zgjedhur (p.sh. Tarraca).
3. Në tablet: Mbyll kthehet te pritja; Shkëput këtë tablet e heq lidhjen.

Lëre faqen të hapur në tablet; nëse tableti është i fikur ose në gjumë, ai e hap ekranin sapo të ndizet sërish. Tableti mbetet i identifikuar si punonjësi që hyri në të: dërgimi dhe shikimi i kamerave është i mundur vetëm me të drejtën Shiko pamjet e kamerave. Administratori sheh te cilësimi cilët tabletë janë të lidhur dhe nëse janë të ndezur, dhe mund t'u ndryshojë emrin ose t'i heqë. Tableti ruan një çelës të vetin; arka ruan prej tij vetëm një hash. Kur çaktivizohet, tabletët e lidhur mbeten të ruajtur. Në regjistër shihet kush e lidhi, e riemërtoi ose e hoqi një tablet.

Ekrani i thirrjes për porositë për të marrë

Një ekran për klientët me Në përgatitje majtas dhe Gati djathtas, me numra të mëdhenj, si në një snack-bar ose fast-food. Ndize te Cilësimet → Biznesi → Ekranet dhe përdorimi → Ekrani i thirrjes për porositë për të marrë (si parazgjedhje i fikur).

Nuk nevojitet çiftim: hap në një televizor me shfletues (smart TV, stick ose mini-PC), tablet ose monitor të dytë adresën e arkës me /oproep, p.sh. http://192.168.1.20:3000/oproep. Te cilësimi dhe në dritaren Thirr gjen butonat Në një ekran të veçantë dhe Në tablet ose telefon (kod QR me adresën). Nuk nevojitet hyrje: ekrani shfaq vetëm numra. Prek ekranin një herë dhe shfletuesi mund të lëshojë zë.

Çfarë shfaqet:

• porositë për të marrë nga arka, dyqani online dhe Thuisbezorgd (dhe sipas dëshirës edhe porositë në banak pa tavolinë, te shitja e shpejtë), nga 12 orët e fundit;
• sapo diçka dërgohet në kuzhinë ose në bar (ose dyqani online është në në përgatitje): numri shfaqet te Në përgatitje;
• Gati vendoset vetë kur ekrani i kuzhinës njofton se e gjithë porosia është gati ose kur porosia online është në gati. Numri pulson shkurt dhe ekrani bën ding-dong;
• një numër gati qëndron aq minuta sa është caktuar (si parazgjedhje 10) ose deri te U mor;
• porositë nga kioska (shih Kiosk vetëshërbimi) shfaqen gjithmonë sapo paguhen ose do të paguhen në arkë, edhe për "ha këtu", me numrin e marrjes nga fatura e tyre;
• sipas dëshirës edhe porositë për korrierët e Thuisbezorgd, Uber Eats, Deliveroo dhe HubRise (kutia Edhe porositë për korrierët …): me numrin e porosisë së platformës dhe emrin e platformës poshtë, që korrieri të shohë kur është gati porosia e tij. U mor i njofton atëherë edhe platformës se korrieri e ka marrë (si në dritaren e platformës).

Numri: te dyqani online, Thuisbezorgd dhe platformat e dorëzimit, numri i porosisë që mysafiri ose korrieri e ka tashmë; përndryshe numri i marrjes (1 deri 999). Shtypet i madh në faturë, me shpjegimin se numri shfaqet në ekran kur porosia të jetë gati (në gjuhën e faturës).

Opsionale (si parazgjedhje joaktive, te cilësimi):

• Lajmëro numrin me zë: për një numër të ri gati, ekrani thotë p.sh. "Nummer 42…" në gjuhën e zgjedhur (holandisht, anglisht, gjermanisht, frëngjisht, spanjisht, italisht, portugalisht, polonisht, turqisht ose arabisht). Zëri vjen nga shfletuesi i ekranit dhe tingëllon ndryshe në çdo pajisje; pasi ta hapni, prekni ekranin një herë. Pas ziles, nëse edhe zëri është aktiv.
• Gjendja e porosisë në telefon: nën numrin e marrjes në faturë shfaqet një kod QR. Mysafiri e skanon, sheh numrin dhe gjendjen (porositur, po përgatitet, gati, marrë) dhe merr një njoftim kur porosia është gati. Kjo kalon nëpërmjet portalit të menaxhimit, ndaj arka duhet të jetë e lidhur me të. Jo për dyqanin online dhe Thuisbezorgd (kanë gjendjen e tyre) dhe jo për kioskën (ka cilësimin e vet).

Në arkë është butoni Thirr (me numrin e porosive që ende përgatiten):

1. Gati e vendos me dorë një numër në gati (pa ekran kuzhine ose kur është më shpejt). Te një porosi nga dyqani online ose Thuisbezorgd përditësohet edhe statusi, kështu që klienti merr edhe njoftim.
2. Kthehu e kthen sërish te Në përgatitje.
3. U mor e heq nga ekrani (me Zhbëj).

Te cilësimi zgjedh gjithashtu nëse emri shfaqet pranë numrit (si parazgjedhje jo, për privatësinë) dhe nëse ekrani lëshon zë. Kur e fik: pa butonin Thirr dhe pa numër marrjeje në faturë; cilësimet ruhen. Në regjistër shihet kush çfarë vendosi me dorë në gati, ktheu ose shënoi si të marrë.

Hyrja dhe dalja nga turni

Si parazgjedhje regjistrimi i orarit është joaktiv: atëherë nuk shfaqet askund në arkë (asnjë buton në shiritin e sipërm, jo në ekranin e hyrjes, asnjë skedë Oraret e punës). Aktivizoje te Cilësimet → Lokali, nën Regjistrimi i hyrjes dhe daljes së stafit:

• Joaktiv: mos e përdor. Nëse e çaktivizon regjistrimin më vonë, nuk duket më askund, por orët e regjistruara më parë ruhen (nuk fshihet asgjë); nëse e aktivizon sërish, ato janë përsëri aty.
• Aktiv: punonjësit mund të regjistrojnë hyrjen dhe daljen. Pas hyrjes në arkë, arka pyet nëse do të regjistrosh hyrjen në punë (Jo tani lejohet). Në shiritin e sipërm shfaqet atëherë Fillo punën ose Në punë që nga 17:02; prek aty për të mbaruar punën.
• I detyrueshëm: pas hyrjes në arkë fillimisht regjistro fillimin e punës, përndryshe nuk mund ta përdorësh arkën. Mbarimi i punës të nxjerr menjëherë nga arka.

Kush nuk e përdor arkën (p.sh. kuzhina) regjistrohet në ekranin e hyrjes: prek Fillo / mbaro punën dhe fut kodin PIN. Kjo kalon mes fillimit dhe mbarimit, pa hyrë në arkë.

Kur regjistrimi i orarit është aktiv, administratori sheh te Cilësimet → Oraret e punës:

• kush është tani në punë (dhe mund të mbyllë turnin e dikujt që ka harruar);
• orët e punuara për çdo punonjës për çdo periudhë, me të gjitha turnet, dhe shkarkim si CSV (orët edhe si numër dhjetor për pagat);
• ndrysho ose shto turne (prek një turn, ose + Shto turn). Çdo ndryshim shënohet me oraret e vjetra dhe të reja në regjistër.

Në Belgjikë çdo fillim dhe mbarim pune i raportohet edhe kutisë së zezë. Nëse ajo nuk arrihet, regjistrimi nuk kryhet (njësoj si pagesa). Nëse kjo përputhet saktësisht me regjistrimin belg të personelit, duhet ende të konfirmohet.

Peshimi dhe etiketat (peshore)

Kur peshorja është aktive (Cilësimet → Peshorja), produktet mund të kenë një çmim për kilogram. Të gjitha produktet e tjera mbeten për copë.

• Peshimi: prek një produkt me çmim për kilogram (butoni tregon p.sh. 12,95/kg). Dritarja Peshimi tregon peshën e peshores (p.sh. një Aclas OS6X, ose peshorja mbi të cilën punon vetë arka) drejtpërdrejt; jeshile = e qëndrueshme. Vendos produktin në peshore dhe prek Shto sapo pesha të qëndrojë. Çmimi është çmimi për kilogram × pesha (rrumbullakosur në cent); tara e enës së produktit zbritet vetë. Nëse produkti ka opsione zgjedhjeje, ato vijnë më pas.
• Disa peshore: nëse ka disa peshore, zgjedh në krye të dritares në cilën peshon. Çdo arkë/tablet e mban mend zgjedhjen e vet.
• Manualisht: pa peshore (ose kur lejohet manualisht), shkruaj peshën: 0,512 ose 1,2 janë kilogramë, 512 ose 512 g janë gramë.
• Etiketa e TS6X: skano barkodin e etiketës me skanerin e barkodeve në ekranin e porosisë (thjesht skano, s'ka nevojë të jetë diçka e hapur), ose prek Etiketa dhe skano ose shkruaj 13 shifrat. Produkti (PLU) dhe pesha merren nga etiketa. Nëse në etiketë ka një çmim, arka llogarit saktësisht atë çmim.
• Në ekran, në faturë dhe në ekranin e klientit shfaqet edhe pesha, p.sh. Gehakt 6,63 me poshtë 0,512 kg x € 12,95/kg; në fletëporosi 0,512 kg Gehakt. Ndarja, zhvendosja dhe kthimi bëhen në kilogramë.
• Një produkt i peshuar është i mundur vetëm me lidhje me serverin e arkës (pesha vjen përmes serverit të arkës).

Uber Eats, Deliveroo dhe HubRise

Përveç Thuisbezorgd.nl / Takeaway.com, në arkë vijnë edhe porosi nga Uber Eats (Holandë dhe Belgjikë), Deliveroo (vetëm Belgjikë; Deliveroo u largua nga Holanda në fund të 2022) dhe gjithçka që është në HubRise (ndër to Uber Eats, Deliveroo, Just Eat/Takeaway.com dhe aplikacione më të vogla porosish). Çdo platformë aktivizohet veçmas te Cilësimet → Platformat e dërgesave (si parazgjedhje joaktiv; çaktivizimi ruan gjithçka). Skeda tregon për çdo platformë në cilat vende funksionon dhe paralajmëron nëse nuk funksionon në vendin e biznesit.

• Aktivizoni, pastaj Identifikohu në Uber Eats dhe lidh dyqanin (biznesi identifikohet me llogarinë e vet Uber Eats). Nëse llogaria ka më shumë dyqane, plotësoni ID-në e dyqanit (store id) dhe identifikohuni përsëri. Për këtë Uber Eats duhet fillimisht ta miratojë Pin Voordeel si partner.
• Deliveroo: drejtpërdrejt, përmes portalit. Plotësoni site-id (location id) dhe ID-në e markës (brand id). Pa tablet (parazgjedhje): arka pranon ose refuzon; me tablet: biznesi pranon në tablet dhe portali njofton vetëm nëse porosia është në arkë.
• HubRise: arka i merr vetë porositë (çdo 20 sekonda, nuk nevojitet portal).
• Për çdo platformë: prano automatikisht, fleta e kuzhinës menjëherë në kuzhinë/bar dhe (Uber Eats, Deliveroo) dërgo automatikisht menunë pas një ndryshimi dhe Dërgo menunë tani. Në menu janë produktet e shënuara te Produktet në menunë e Uber Eats dhe Deliveroo, me opsione zgjedhjeje; edhe statusi mbaroi transmetohet.

Porositë. Një porosi bëhet porosi e zakonshme (bezorgen ose afhalen, emri i grupit <platform> <nummer>) me çmimet e platformës: produktet njihen nga ID-ja (nga menuja), kodi ose numri PLU, i panjohur = një rresht më vete me çmimin e platformës (dhe një njoftim); kostot e dërgesës, shtesat dhe zbritja si rreshta më vete; nëse totali prapë nuk përputhet, një rresht "Diferenca". Fleta e kuzhinës shkon menjëherë në kuzhinë/bar. Butoni Platformat në shiritin e sipërm (me numrin e porosive në vazhdim; portokalli kur ka diçka për t'u pranuar): prano ose refuzo (me arsye), në përgatitje, gati, në rrugë, dorëzuar ose marrë, anulo dhe Përfundo (paguar online). Çfarë njeh platforma kthehet mbrapsht (Uber Eats: prano, refuzo, anulo; Deliveroo: prano, refuzo, në përgatitje, gati, marrë; HubRise: të gjitha statuset). Nëse biznesi dërgon vetë (dërgesë e vetë), porosia është edhe te Turet, dhe nisja dhe dorëzimi shkojnë automatikisht te platforma. Një anulim nga platforma e bën porosinë të skadojë. Nëse arka nuk është e lidhur me portalin për më shumë se 2 minuta, portali refuzon një porosi të re nga Uber Eats dhe i thotë Deliveroo (me tablet) që nuk u arrit, që biznesi ta shohë në tablet.

Kodi: apps/pos-server/src/lib/bezorgplatforms.ts, routes/bezorgplatforms.ts; ekranet Bezorgplatforms.tsx. Ana e portalit: horecapos-portaal/src/platforms.mjs. Regjistri: Platformat e dërgesave (aktiv/joaktiv, cilësimet, porositë). Gjithçka përfshihet në kopjet rezervë të arkës.

Platformat më të vogla në Holandë dhe Belgjikë (Homie, Hebtrek, sneleten.nl, Bistroo ...) nuk kanë lidhje publike me arkën; nëse janë në HubRise, funksionojnë përmes HubRise. Për më shumë: shih backlog-un.

Automati i parave (sistem i mbyllur i parave në dorë)

Si parazgjedhje joaktiv: paratë në dorë punojnë si gjithmonë. Me një sistem të mbyllur të parave në dorë stafi nuk i prek paratë: klienti ose punonjësi i fut paratë në automat, i cili i numëron, kontrollon për para false dhe kthen kusurin.

• Automatet me të cilët arka komunikon drejtpërdrejt:
  • CashDro (3, 4+, 5, 7, S Compact; NuKassa, KluisKassa): përmes rrjetit (shërbim web). Në CashDro aktivizoni Web Integration dhe krijoni një përdorues të veçantë për arkën.
  • Cashmatic (SelfPay 460/860/1060; në Belgjikë Xpos): përmes rrjetit (porta 50301) me një përdorues të Cashmatic.
  • Azkoyen Cashlogy (POS1000, POS1500): përmes CashlogyConnector në një PC Windows pranë automatit (porta 8092).
  • CashKeeper: përmes CKMonitor në një PC Windows (porta 16501).
  • Glory CASHINFINITY (CI-5, CI-10, CI-10X; edhe përmes Cikam): përmes kontrollit (FCC) të automatit. Ende beta: kërkojini Glory-t ose shitësit tuaj ta kontrollojë ndërlidhjen e parë.
  • I jashtëm: një softuer tjetër e drejton automatin dhe komunikon me arkën (si Cikam, ImaCash për 25 marka, softueri i CashGuard/StrongPoint (Merlin), PayComplete (SUZOHAPP), Gunnebo SafePay ose marka franceze si CashMag).
  • Automat prove: pa pajisje, për ushtrim ose demonstrim. Me Testo lidhjen kontrolloni adresën dhe hyrjen. Vendoseni automatin në rrjetin tuaj (kurrë të hapur ndaj internetit) dhe përdorni një përdorues të veçantë për arkën, jo administrator.
• Paguaj me Para në dorë: Paguaj në automatin e parave nis pagesën për shumën (e rrumbullakosur për para në dorë nëse kjo është aktive, plus bakshishi; te ndarja e llogarisë pjesa). Ekrani tregon çfarë është futur dhe çfarë kthehet; arka e kryen pagesën vetëm kur automati njofton gati. Anulo = automati i kthen paratë. Nëse automati nuk mundi të japë gjithë kusurin (shumë pak monedha), shënohet sa duhet nxjerrë nga sirtari i parave. Një pagesë e suksesshme që ende nuk është mbyllur në arkë (p.sh. tableti u fik) gjendet sërish te ajo porosi.
• Para në dorë vetëm përmes automatit (si parazgjedhje aktiv): atëherë serveri i arkës pranon para në dorë vetëm me një pagesë të suksesshme në automat për pikërisht atë porosi dhe atë shumë. Joaktiv = edhe para në dorë të zakonshme në sirtar.
• Sirtari i parave (Raporti → Arka, e drejta Menaxho sirtarin e parave): Kërko gjendjen (për çdo monedhë dhe kartëmonedhë, te Cashmatic, Cashlogy, Glory dhe automati i provës), Nxirr para me arsye (p.sh. kusur për sirtarin), Rimbushje dhe Heqje e tepricës (kusuri mbetet; te Cashmatic). Pritet në sirtarin e kasës nuk i llogarit paratë në automat (ato shfaqen veçmas më poshtë: Në automatin e parave), por llogarit kusurin që duhej dhënë nga sirtari.

Butoni ©

Poshtë djathtas në çdo ekran (kodi PIN, planimetria, porosia dhe kuzhina) është një buton i vogël ©. Ai hap të dhënat e OptimumPOS: logo, adresa, telefoni, email-i dhe faqja e internetit. Ikona ruhet lokalisht në aplikacion, prandaj funksionon edhe pa internet. E njëjta ikonë është ikona e aplikacionit (skeda dhe ekrani bazë).

Pjesa 2 · Menaxheri

Fillimi

Si parazgjedhje një menaxher mund të bëjë gjithçka që bëjnë kamarierët, si dhe ndër të tjera të japë zbritje, të bëjë kthime, të mbyllë ditën, të menaxhojë sirtarin e arkës dhe të shohë regjistrin dhe stokun. Kjo gjendet kryesisht nën butonin Raporti:

• Gjendja e ndërmjetme (X): qarkullimi deri tani, pa e mbyllur ditën.
• Sirtari i arkës: paratë fillestare, hyrje/dalje parash dhe hapja e sirtarit.
• Mbyll ditën (Z): në fund të ditës; më pas fillon një ditë e re.
• Raportet Z të mëparshme, Qarkullimi sipas periudhës dhe Paneli.
• Regjistri, Kartat dhuratë dhe Klientët.

Stoku

Si parazgjedhje joaktiv. Aktivizoje te Cilësimet → Biznesi → Ndiq stokun. Joaktiv = nuk duket askund në arkë.

• Për çdo produkt zgjedh te Cilësimet → Produktet → (produkti) → Stoku:
  • Jo: si gjithmonë;
  • Për produkt: çdo shitje zbret 1 (p.sh. shishe, kanaçe), me një nivel njoftimi për "gati mbaroi";
  • Përmes përbërësve: një recetë, p.sh. hamburger = 1 panine + 150 g mish + 1 fetë djathë. Çdo shitje zbret përbërësit.
• Cilësimet → Stoku (e drejta Menaxho stokun, si parazgjedhje menaxheri dhe administratori):
  • Produktet dhe Përbërësit: gjendja, me mbaroi / gati mbaroi; filtri "vetëm (gati) të mbaruarat" dhe eksport në CSV.
  • Për çdo produkt ose përbërës regjistron Pranim (+) (furnizim), Numërim (=) (sasia e numëruar bëhet gjendja e re) ose Nxjerrje (−) (thyerje, i skaduar; arsyeja e detyrueshme).
  • Krijo përbërës me njësi (copë, g, kg, ml, cl, l, porcion, shishe, fuçi) dhe nivel njoftimi.
  • Historiku: të gjitha lëvizjet (shitje, anulim, pranim, numërim, nxjerrje) me kush dhe kur. Veprimet e menaxhimit shkojnë edhe në regjistër.
• Zbritja ndodh te Porosit (ose gjatë arkëtimit për atë që u arkëtua direkt). Një anulim e kthen sasinë. Ndarja dhe zhvendosja nuk zbresin dy herë. Te menutë zbriten pjatat, jo rreshti i menusë. Kthimet (faturë krediti) nuk e rikthejnë sasinë (ajo që kthehet zakonisht nuk mund të shitet më); nëse duhet, regjistroje si pranim.
• Kur stoku mbaron (ose një përbërës nuk mjafton për edhe një herë), produkti del vetvetiu në të gjitha arkat si i mbaruar. Kur gati mbaron, në butonin e produktit shkruhet edhe N. Pas një pranimi ose numërimi mund të porositet menjëherë sërish. Edhe serveri i arkës e refuzon atëherë produktin ("Pils" ka mbaruar (stoku 0)), pra edhe nga një tablet që nuk e dinte ende.
• Stoku mund të bjerë nën 0 (p.sh. dy tableta njëkohësisht, ose porositur offline); numërimi e rregullon sërish.
• Lista e porosive: Cilësimet → Stoku → Lista e porosive. Për çdo produkt (për produkt) dhe për çdo përbërës cakton, përveç nivelit të njoftimit, edhe plotëso deri në dhe furnitorin. Në listën e porosive del gjithçka që është në nivelin e njoftimit ose më poshtë (pa nivel njoftimi: në 0), për furnitor, me propozimin plotëso deri në − gjendja. Sasitë mund të ndryshohen dhe të shënohen/çshënohen. Pastaj Printo (printeri i faturave), Kopjo (për e-mail ose WhatsApp), Eksporto (CSV), dhe pas furnizimit Furnizuar: regjistro si pranim (i regjistron të gjitha njëherësh). Me kutizën lart sheh edhe atë që nuk ka mbaruar ende, për të porositur më shumë.
• Opsionet e zgjedhjes: te një grup zgjedhjesh (Cilësimet → Produktet → Opsionet e zgjedhjes) gjendet butoni Stoku. Për çdo zgjedhje jep përbërësit për copë, p.sh. Djathë shtesë = 1 fetë djathë, Patate të skuqura = 150 g patate. Kur zgjidhet ajo zgjedhje, ata përbërës zbriten për copë (edhe nëse vetë produkti nuk ndjek stok; me anulim kthehen). Nëse një përbërës ka mbaruar, zgjedhja del në arkë si (mbaroi) dhe nuk mund të zgjidhet.

Porositë te furnitorët

Si parazgjedhje joaktiv. Aktivizohet te Cilësimet → Stoku → Porositë te furnitorët (vetëm me Ndiq stokun aktiv). Joaktiv = lista e porosive punon si gjithmonë.

• Furnitorët (skeda Furnitorët): zgjidhni një nga lista ose krijoni një furnitor tuajin. Lista ka shitës me shumicë dhe cash & carry (Sligro, Sligro-ISPC/Sligro-M, HANOS, Makro, De Kweker, Horeca Totaal, Van Zon, zegro, Lekkerland), foodservice (Bidfood dhe Bidfood Belgium, Solucious, Chefs Culinar, Java, Q-Food, Agora Culinair, VHC Jongens/Kreko/Actifood, Hocras, Van Hoeckel ...), shitës me shumicë të pijeve (De Klok, Henk Smit, Horesca, De Monnik, Hansen, Dranken Geers ...), prodhues birre dhe pije joalkoolike (Heineken përmes Sligro, AB InBev/BEES, Alken-Maes, Haacht, Duvel Moortgat, Martens, Coca-Cola, Spadel, Grolsch, Bavaria), furnitorë produktesh të freskëta (Van Gelder, Driessen, FiliusKaas, Bakkers Brigade, Rungis ...), joushqimore (Bunzl, Takeaware, Supplierz), dyqanin online të verërave Vinify.nl dhe platforma porosish (Apicbase, Exact Horeko, Growzer, inOne, Cuisin.io, OrderXL). Në listë janë vetëm furnitorët nga vendi i lokalit. Nëse zgjidhni një, mënyra e porositjes, skedari dhe kolonat janë tashmë të sakta; te çdo furnitor shkruhet si porositet aty.
• Për çdo furnitor: numri i klientit, porosit përmes:
  • E-mail: porosia si e-mail (me tabelë) në adresën e e-mailit për porosi, opsionalisht një kopje, me listën e porosive si bashkëngjitje: CSV, Excel, CSV për Care4Fresh (shumë shitës me shumicë të produkteve të freskëta), UBL 2.1 Order (Peppol BIS Order), EANCOM ORDERS (D96A në Holandë, D01B/HO2C në Belgjikë) ose cXML. Përgjigjet vijnë në adresën e e-mailit të lokalit.
  • Skedar: arka krijon skedarin, ju e ngarkoni në dyqanin online të furnitorit (p.sh. Bunzl Snel bestellen: artikel;aantal, Takeaware: SKU,Quantity). Ndarësi, rreshti i kokës dhe kolonat mund të konfigurohen (artikel, ean, omschrijving, aantal, eenheid, prijs, totaal; me artikel=SKU i jepni kokës një emër tuajin).
  • Ndërlidhje (cXML): një cXML OrderRequest me numrin e klientit dhe sekretin e përbashkët në adresën e porosive të furnitorit, ashtu si sistemet e blerjeve që dërgojnë te Sligro, HANOS dhe Bidfood. Adresën, numrin e klientit dhe sekretin i merrni nga furnitori (Sligro: koppelingen@sligro.nl). Sekreti nuk kthehet kurrë në ekran.
  • Për të dyja ndërlidhjet mund të vendosësh edhe një emër përdoruesi dhe fjalëkalim (Basic) dhe header-a shtesë (një për rresht, p.sh. X-Api-Key: ...).
  • Ngarkim (SFTP/FTPS): arka e vendos vetë skedarin (EANCOM, UBL, CSV, Excel ...) në një dosje në serverin e furnitorit, siç pranojnë shumë shitës me shumicë porositë EDI. SFTP (SSH), FTPS (eksplicit në portën 21 ose implicit në portën 990) ose, vetëm në rrjetin tënd, FTP. Hyrje me fjalëkalim ose me çelës SSH (OpenSSH, PEM ose PuTTY .ppk; ed25519, ECDSA ose RSA). Krijo çelës krijon një çift çelësash në arkë; çelësin publik ia dërgon furnitorit. Testo lidhjen hyn dhe kërkon dosjen. Gjurma e serverit SFTP regjistrohet në lidhjen e parë dhe kontrollohet më pas (një server tjetër nuk e merr fjalëkalimin); te FTPS me certifikatë të vetën e fikson ti gjurmën e certifikatës. Nuk nevojitet asnjë program shtesë.
  • Printo: porosia në printerin e faturave, për ta dhënë me telefon.
• Fjalëkalimet, çelësat, tokenët dhe header-at nuk kthehen kurrë në ekran (lëre bosh = mbahet, Fshi = hiqet).
• Kërko ndërlidhje: te një furnitor arka harton një email për një ndërlidhje (cXML, EDI nëpërmjet SFTP/FTPS, UBL/Peppol ose API e vetë furnitorit) me të dhënat e lokalit (emri, adresa, numri i TVSH-së, numri i klientit, GLN) dhe çfarë nevojitet; te EDI me çelësin publik. Përshtate dhe dërgoje; një kopje dhe përgjigjet shkojnë në adresën email të lokalit. Data e kërkesës shfaqet te furnitori. Te Sligro ajo shkon te koppelingen@sligro.nl, përndryshe plotëso adresën e menaxherit tënd të llogarisë.
• Një furnitor i vetë (jo nga lista) mund të bëjë gjithçka përveç asaj që duhet ta ofrojë vetë furnitori: email-i, skedari dhe printimi funksionojnë gjithmonë; një ndërlidhje ose ngarkim vetëm me të dhënat e atij furnitori.
• Ditët e porosisë dhe dorëzimi: ditët e porosisë, ora e fundit, koha e dorëzimit (data e dëshiruar e dorëzimit në porosi) dhe një shumë minimale porosie. Automatikisht: në ditët e porosisë nga ajo orë arka përgatit vetë një porosi si draft (ti e kontrollon) ose e dërgon menjëherë (me email, ngarkim ose ndërlidhje; nën shumën minimale të porosisë vetëm përgatitje si draft). Një herë në ditë për çdo furnitor.
• Për produkt (Cilësimet → Produktet → (produkti) → Stoku, te Për produkt) dhe për përbërës: Porosit te (furnitori), numri i porosisë te ai furnitor, EAN, për paketim (arkë me 24 = 24), emri i paketimit dhe çmimi i blerjes për paketim. Niveli i njoftimit është momenti për të porositur; Plotëso deri në sa duhet të ketë atëherë.
• Porositë e blerjes (skeda Porositë e blerjes):
  • Porosi e propozuar për çdo furnitor: gjithçka që është në ose nën nivelin e njoftimit. Ajo që është porositur tashmë dhe ende nuk ka ardhur (në rrugë) llogaritet, që të mos porositni asgjë dy herë. Propozimi = plotëso deri në − gjendja − në rrugë (pa Plotëso deri në: deri te niveli i njoftimit), i rrumbullakosur lart në paketime të plota. Ndryshoni sasitë dhe Krijo porosi.
  • Një porosi fillimisht është përgatitur si draft: sasitë, rreshtat e veçantë (pa produkt, p.sh. peceta), shënimi dhe data e dorëzimit mund të ndryshohen ende. Pastaj Dërgo (në mënyrën e furnitorit ose këtë herë ndryshe). Nëse dështon (p.sh. furnitori refuzon), shënohet arsyeja dhe mund të provoni sërish.
  • U mor: për çdo rresht sasia e marrë (është plotësuar tashmë me sasinë e porositur); stoku rritet sipas paketimit (2 arka me 24 = 48), me porosinë në historik.
  • Çdo skedar (CSV, Excel, UBL, EANCOM, cXML) mund të shkarkohet edhe veçmas.
• Të dërguarat, të dështuarat, të marrat dhe të anuluarat regjistrohen në regjistër. Lista e porosive e zakonshme vazhdon të punojë; nëse një produkt ka një furnitor nga lista, ai shfaqet aty nën atë emër.

Menaxhimi i vlerësimeve

Lexoni dhe përgjigjuni vlerësimeve nga Google dhe Trustpilot në arkë. Aktivizohet te Cilësimet → Pikë dhe vlerësime → Menaxhimi i vlerësimeve (si parazgjedhje joaktiv, atëherë nuk duket asgjë askund). Leximi dhe përgjigjja te Raporti → Vlerësime (e drejta Lexo dhe përgjigju vlerësimeve, si parazgjedhje edhe për menaxherin). Nëse e çaktivizoni, lidhjet dhe vlerësimet mbeten të ruajtura.

• Më pas çdo lokal vetëm prek Lidhu me Google dhe hyn me llogarinë e vet Google të profilit të biznesit. Një çelës Places mund të rregullohet edhe në mënyrë qendrore (kostot i mbulon atëherë furnizuesi). Trustpilot është për çdo lokal: çdo lokal ka llogarinë e vet Trustpilot Business (API përfshihet në një abonim me pagesë), nga e cila vijnë çelësi, sekreti dhe business user ID. Në arkë, te çdo mënyrë shkruhet "Kush e rregullon këtë?".
• Aplikacioni i furnitorit (përmes portalit të klientit): nëse aplikacioni Google dhe/ose aplikacioni Trustpilot i furnitorit janë në portalin e klientit (shih README-në e horecapos-portaal, "Reviews: apps van de leverancier"), administratori zgjedh te Hyrja dhe çelësat Aplikacioni i furnitorit (parazgjedhje për një lidhje të re nëse portali e ka aplikacionin). Biznesi prek Lidhu me Google ose Hyr me Trustpilot dhe hyn me llogarinë e vet; arka pret vetë derisa të përfundojë hyrja (çdo 3 sekonda, jo më shumë se 15 minuta) dhe i merr tokens një herë nga portali. Rinovimi bëhet gjithashtu përmes portalit. Në arkë nuk nevojitet client-ID, secret apo çelës API; për Trustpilot nevojiten domeni dhe, për përgjigjet, business user ID. Trustpilot publik lexon atëherë përmes çelësit të portalit. Kërkon PORTAAL_URL dhe PORTAAL_SLEUTEL. Aplikacion i yti ose çelës API vazhdon të funksionojë si më poshtë.
• Të kujt janë vlerësimet: ato mbeten në profilin e biznesit në Google dhe në faqen Trustpilot të vetë biznesit, dhe arka i ruan vetëm në bazën e vet të të dhënave. Përgjigjet shfaqen me emrin e biznesit. Portali vetëm e përcjell hyrjen (në memorie, jo më shumë se 15 minuta, merret vetëm një herë) dhe nuk ruan vlerësime apo tokens; emri i aplikacionit të furnitorit shfaqet vetëm në ekranin e pëlqimit.
• Regjistrohu vetë: te çdo platformë ka një lidhje për të krijuar vetë një profil biznesi në Google (business.google.com/create) ose një llogari Trustpilot Business (business.trustpilot.com), dhe te Trustpilot edhe për te paketat (business.trustpilot.com/plans). Regjistrimi dhe pagesa bëhen te vetë platforma; për këtë nuk ka API.
• Pastaj Lidhu me Google dhe hyni me llogarinë që menaxhon profilin e biznesit. Një pikë biznesi në profil = zgjidhet menjëherë; më shumë = zgjedhje në arkë.
• Google Places (vetëm lexim): me Place ID-në dhe një çelës API të Places API (ose GOOGLE_PLACES_API_KEY): mesatarja, numri i vlerësimeve dhe 5 vlerësimet më të rëndësishme. Kështu nuk mund të përgjigjeni.
• Trustpilot Business (lexim dhe përgjigje): çelësi API dhe sekreti API i një aplikacioni në Trustpilot Business (Integrations → API; ose TRUSTPILOT_API_KEY dhe TRUSTPILOT_API_SECRET), domeni i lokalit (arka e gjen vetë business unit) dhe, për përgjigjet, business user ID i personit që përgjigjet.
• Trustpilot publik (vetëm lexim): vetëm çelësi API.
• Arka merr çdo 30 minuta (dhe menjëherë pas lidhjes; Merr tani). Adresën e email-it dhe numrin e porosisë së mysafirit (që i jep Trustpilot) arka nuk i ruan.
• Raporti → Vlerësime: mesatarja, numri sipas yjeve, pa përgjigje dhe të palexuara; filtrim sipas platformës, yjeve, pa përgjigje dhe të palexuara. Për çdo vlerësim Përgjigju (maksimumi 4000 karaktere; të gjithë mund ta lexojnë), Ndrysho përgjigjen, Hiq përgjigjen dhe Lexuar. Një vlerësim i ri ose i ndryshuar është i palexuar. Në regjistër shfaqen review_beantwoord dhe review_antwoord_weg.
• Shkëputja i mban vlerësimet e marra.

Marketing me SMS dhe email

Mesazhe për klientët e kartës së besnikërisë që kanë dhënë pëlqimin për këtë. Pa kartë besnikërie asnjëra nuk mund të aktivizohet.

• Pëlqim për çdo klient dhe për çdo kanal: te një klient i ri në arkë janë shenjat "Klienti dëshiron të marrë fushata me SMS" dhe "... me email" (si parazgjedhje joaktive). Te Raporti → Klientët sheh dhe ndryshon pëlqimin (me datën kur është dhënë) dhe një ditëlindje (vetëm dita dhe muaji). Çregjistrimi: hiq shenjat dhe ruaj.
• Menuja përditësohet menjëherë: kur aktivizon ose çaktivizon marketingun ose kartën e besnikërisë, arka brenda pak sekondash ia dërgon sërish menunë dyqanit online (vetëm nëse ndryshoi diçka), që kutia e zgjedhjes të shfaqet ose të zhduket menjëherë.
• Pëlqimi përmes dyqanit online: nëse lokali ka dyqan online, gjatë pagesës shfaqet kutia "Dua të marr oferta me email/SMS" (vetëm kanalet aktive; si parazgjedhje joaktive). Kur vjen një porosi e tillë, arka e kërkon klientin sipas numrit të telefonit (përndryshe sipas adresës email), e krijon nëse duhet dhe ruan pëlqimin me datën. Një numër ose adresë që mungon te një klient ekzistues plotësohet; në regjistër shfaqet klant_toestemming me burim webshop.
• Raporti → Marketing (e drejta Menaxho kartën e besnikërisë): lart sa klientë kanë dhënë pëlqimin për SMS dhe për email.
• Fushatat (një herë): emri, SMS ose email, (subjekti,) teksti me {naam}, {zaak} dhe {punten}, dhe sipas dëshirës vetëm klientët që nuk kanë ardhur për njëfarë kohe ose kanë të paktën kaq pikë. Shiko tregon sa klientë përfshihen, mesazhin siç e merr klienti dhe numrin e SMS-ve për klient. Dërgo provë në numrin ose adresën tënde. Pastaj Dërgo: arka dërgon në sfond (deri në 1000 njëherësh) dhe numëron çfarë u dërgua dhe çfarë dështoi. Askush nuk merr të njëjtën fushatë dy herë; nëse arka ndalon në mes, Vazhdo dërgimin vazhdon me ata që s'kanë marrë ende asgjë.
• Dërgimi përmes Mailchimp ose Klaviyo (me lidhje me një listë të zgjedhur, shih më poshtë): te një ofertë me email zgjedh te Dërgo përmes arkën (serveri i vet i postës, si më sipër) ose Mailchimp ose Klaviyo. Atëherë arka fillimisht përditëson listën (çregjistrimet, pikët) dhe krijon atje një fushatë pikërisht për klientët e zgjedhur që janë në listë (Mailchimp: një grup i përhershëm te audience; Klaviyo: një listë e veçantë për ofertën), dhe e dërgon me dërguesin e paracaktuar të audience-it ose të llogarisë. {naam} dhe {punten} i plotëson Mailchimp/Klaviyo për çdo klient; poshtë është lidhja e çregjistrimit të shërbimit. Pa kufi prej 1000 për dërgim dhe pa kod personal zbritjeje ({code}). Nëse nuk ia del, oferta mbetet draft me mesazhin pranë. Skeda Marketing shfaqet edhe kur është aktive vetëm lidhja (atëherë vetëm oferta përmes Mailchimp/Klaviyo; Dërgo provë funksionon me serverin e postës së arkës). Mesazhet automatike i dërgon gjithmonë vetë arka; në Mailchimp/Klaviyo i krijon si Customer Journey ose Flow. Çelësi i Klaviyo: edhe të drejta shkrimi për Campaigns dhe Templates (kush ka hyrë tashmë: hyr sërish).
• Si njoftim push përmes dyqanit online (nëse në administrimin e dyqanit online janë aktive Njoftime push me oferta): te Dërgo me zgjidh Njoftim push (dyqani online si aplikacion), me një titull (deri në 60 karaktere) dhe një tekst të shkurtër (deri në 200 karaktere; plotësohet vetëm {zaak}, sepse dyqani online nuk e di kush është mysafiri). Arka e dërgon ofertën përmes portalit të menaxhimit te dyqani online, dhe ai e dërgon te mysafirët që aty aktivizojnë Oferta si njoftim; prekja hap menynë e dyqanit online. Pas disa sekondash te oferta shfaqet sa mbërritën. Deri në 3 në ditë, së bashku me ato që lokali dërgon nga menaxhimi i dyqanit; përndryshe oferta mbetet draft me arsyen përkrah. Skeda Marketing shfaqet edhe kur është aktiv vetëm ky (pa kartë besnikërie ose marketing me email). Pa kod zbritjeje ose përzgjedhje (ditë, pikë); për test: në telefonin tënd aktivizo te dyqani online Oferta si njoftim.
• Automatike: një mesazh ditëlindjeje (në ditëlindje, një herë në vit) dhe "na mungoni" (pas kaq ditësh pa vizitë, një herë sa herë që klienti mungon). Aktiv/joaktiv për çdo mesazh; dërgohen vetëm gjatë ditës (10:00–20:00).
• Kod zbritjeje personal (opsional, për çdo mesazh ose ofertë; vetëm nëse Kodet e zbritjes janë aktive te Cilësimet → Biznesi): çdo klient merr kodin e vet, p.sh. TERUG-7K4Q2M (ditëlindje JARIG-…, ofertë ACTIE-…), në përqindje ose shumë fikse, sipas dëshirës me një shumë minimale porosie, i përdorshëm një herë, i vlefshëm për numrin e caktuar të ditëve pas dërgimit (parazgjedhje 30), në arkë dhe/ose në dyqanin online. Vendos {code} dhe {geldig} në tekst aty ku i do; përndryshe arka vendos poshtë mesazhit "Uw kortingscode: … (10% korting, aan de kassa of in de webshop, geldig t/m …)". Shiko dhe Dërgo provë shfaqin një kod shembull (TERUG-VOORBEELD, nuk funksionon). Nëse dërgimi dështon, kodi nuk krijohet. Te oferta shihet sa kode janë lëshuar dhe përdorur.
• Çregjistrimi shkruhet poshtë çdo mesazhi: te SMS-ja "Çregjistrim? Telefono ... ose na thuaj në vizitën e ardhshme", te email-i një lidhje çregjistrimi drejt adresës së email-it të biznesit (edhe butoni Çregjistrohu në Gmail dhe Outlook). Përgjigjja ndaj email-it shkon te biznesi.
• Privatësia (GDPR): vetëm klientë me pëlqim dhe me numër ose adresë; asnjë numër apo adresë në regjistër, por për çdo fushatë sa u dërguan dhe sa dështuan. Nëse fshin një klient, ai zhduket edhe nga lista e dërgimit.
• Kostot: SMS-të shkojnë përmes llogarisë tënde CM.com (më shumë se 160 karaktere = më shumë SMS për klient). Gmail dhe serverët e tjerë të postës kanë kufi ditor; me shumë klientë dërgo në pjesë.

Bakshish për punonjës

Te Cilësimet → Biznesi → Bakshishi (vetëm nëse "Shfaq butonat e bakshishit gjatë arkëtimit" është aktiv) zgjedh si del bakshishi për punonjës në gjendjen e ndërmjetme (X), në raportin Z (faturë dhe e-mail) dhe te Xhiro për periudhë (edhe në CSV):

Centët e tepërt shkojnë te ai që është më afër centit tjetër, që totali të përputhet gjithmonë. Është një pasqyrë: arka nuk paguan asgjë (këtë mund ta bësh me "Para nga sirtari"). Raportet Z të vjetra mbeten siç ishin.

Raporti Z me e-mail

Te Cilësimet → Biznesi → Dërgo raportin Z me e-mail te fut një herë adresën e e-mailit të administratorit (më shumë adresa: me presje mes tyre, maks. 3). Pas Mbyll ditën raporti Z shkon atëherë automatikisht në atë adresë, krahas faturës së printuar. Bosh = pa e-mail, si gjithmonë.

• Dërgimi me e-mail bëhet në sfond, që një server i ngadaltë e-maili të mos e vonojë mbylljen e ditës.
• Dështoi ose duhet sërish: Raporti → Raportet Z të mëparshme → (raporti) → Dërgo sërish me e-mail (me shënimin KOPJE).

Përmbledhja e ditës (opsionale)

Nëse ka një adresë te Dërgo raportin Z me email te, poshtë saj shfaqet kutia Me një përmbledhje të shkurtër të ditës në krye të emailit (si parazgjedhje joaktive). Aktive = në krye të emailit të raportit Z disa rreshta në gjuhë të thjeshtë, vetëm nga të dhënat e vetë arkës (pa AI, asgjë nuk del jashtë):

• xhiro, faturat dhe mysafirët dhe shpenzimi për faturë, kundrejt së njëjtës periudhë një javë më parë (në përqindje); nëse atëherë nuk kishte asgjë, kjo shënohet;
• 5 produktet më të shitura dhe çfarë bie në sy: produkte nga të cilat janë shitur të paktën 3 më shumë ose më pak se java e kaluar;
• numri i stornove (kundrejt javës së kaluar) dhe ora më e ngarkuar (faturat dhe xhiro).

Vetë raporti Z (fatura dhe emaili) mbetet saktësisht i njëjtë. Shembulli i sotëm tregon përmbledhjen nga mbyllja e fundit e ditës deri tani. Përmbledhja është në holandisht, njësoj si emaili i raportit Z.

Paneli

Skeda Paneli te Raporti (e drejta Xhiro për periudhë), vetëm për lexim:

• Xhiro për orë si grafik: dita e zgjedhur (blu) krahas së njëjtës ditë të javës së kaluar (gri). Sot krahasohet me javën e kaluar deri në të njëjtën orë, që përqindja të jetë e drejtë. Me ◀ ▶ ose me datën zgjedh një ditë tjetër.
• Pllaka: xhiro (± % krahasuar me javën e kaluar), fatura dhe mesatarja për faturë, shpenzimi mesatar për mysafir (vetëm në lokal; marrja me vete/dërgesa nuk llogariten) për atë ditë dhe për periudhën e zgjedhur.
• 10 produktet kryesore dhe orët më të ngarkuara për 7, 28 ose 90 ditët e fundit. Orët më të ngarkuara janë një hartë nxehtësie ditë jave × orë (xhiro mesatare për ditë pune) me tri orët më të ngarkuara sipër, e dobishme për orarin.

Kartat dhurate të shitura nuk llogariten si xhiro, zbritjet dhe titujt e menuve nuk hyjnë te 10 kryesoret (si te raportet e tjera). Një ditë zgjat nga 00:00 deri në 24:00.

Raporte shtesë

Tre skeda shtesë te Raporti, secila aktivizohet veçmas te Cilësimet → Biznesi → Menaxhimi dhe raportet → Raporte shtesë (si parazgjedhje joaktiv: atëherë nuk ka skedë). Kërkojnë të njëjtën të drejtë si Xhiro sipas periudhës dhe janë vetëm për lexim. Periudha: kjo javë, java e kaluar, ky muaj, muaji i kaluar, 90 ditët e fundit, ky vit ose sipas zgjedhjes (deri në pak më shumë se një vit).

• Inxhinieria e menusë: për çdo produkt, sa shpesh është shitur (pjesa nga të gjitha copët e shitura) përballë asaj që sjell për copë (marzhi = çmimi i shitjes pa TVSH minus kostoja). Çdo produkt merr një klasifikim: Yll (popullor dhe marzh i lartë: lëre ashtu), Kalë pune (popullor, marzh i ulët: ngri pak çmimin ose ule koston), Enigmë (shitet pak, marzh i lartë: vëre më shumë në pah) dhe Qen (shitet pak, marzh i ulët: hiqe nga menuja ose zëvendësoje). Popullor = të paktën 70% e një pjese të barabartë; marzh i lartë = të paktën marzhi mesatar për copë të shitur. Kostoja vjen nga Apicbase (Cilësimet → Recetat), përndryshe nga çmimi i blerjes së produktit (çmimi i blerjes për paketim pjesëtuar me numrin për paketim), përndryshe nga receta e përbërësve me çmim blerjeje (Stoku). Produktet pa kosto dalin veçmas poshtë. Opsionalisht sipas kategorisë (?groep=).
• Oferta dhe kode: për çdo kod zbritjeje, për çdo fushatë nga Marketing (kodet personale së bashku) dhe për çdo happy hour: sa herë është përdorur (fatura; te një happy hour edhe copët), sa zbritje, xhiroja dhe mesatarja për faturë.
• Humbjet: çfarë është zbritur nga stoku (Cilësimet → Stoku, Zbrit nga stoku (−)), sipas arsyes (shkronjat e mëdha dhe hapësirat nuk kanë rëndësi) dhe sipas produktit ose përbërësit, me vlerën me kosto; dhe çfarë është anuluar pasi ishte dërguar tashmë në kuzhinë ose në bar, me vlerën e shitjes dhe të kostos.

Zbritjet

Menaxheri ose administratori sheh në ekranin e porosisë, pranë totalit, butonin % Zbritje:

• në të gjithë faturën ose në një rresht;
• si përqindje (10, 15, 20, 25, 50, 100% = falas, ose shkruaje vetë) ose si shumë fikse;
• gjithmonë me një arsye (Stafi, Klient i rregullt, Ankesë, Ofertë, Përdorim personal ose shkruaje vetë).

Zbritja del si rresht më vete në faturë ("Zbritje 10%", me arsyen poshtë) me të njëjtën normë TVSH-je, që totali dhe specifikimi i TVSH-së të përputhen. Në të gjithë faturën zbritja ndahet sipas normës së TVSH-së. Për ta hequr: prek shumën e rreshtit të zbritjes. Nëse anulohet një rresht me zbritjen e vet, bie edhe ajo zbritje. Nëse heq një produkt nga një faturë me zbritje në përqindje për të gjithë faturën, arka e rillogarit zbritjen për atë që mbetet (në Belgjikë UC226); një shumë fikse mbetet dhe gjatë pagesës ndahet përsëri nëpër rreshta. Nëse për shkak të zbritjes 100% nuk ka asgjë për të paguar, mbyll me "Mbyll (asgjë për të paguar)". Zbritjet shënohen në regjistër, si dhe në raportin X/Z dhe në pasqyrën e periudhës si "nga të cilat zbritje". Te kthimi i një fature me zbritje, zbritja kthehet në përpjesëtim.

Kodet e zbritjes (opsionale)

Kode me zbritje për gjithë faturën, për shembull për një ofertë (ZOMER10). Aktivizohen te Cilësimet → Biznesi → Kodet e zbritjes (si parazgjedhje joaktiv); kodet i krijon te Cilësimet → Kodet e zbritjes (e drejta Menaxho produktet):

• zbritje në përqindje ose një shumë fikse, sipas dëshirës me një shumë minimale porosie, i vlefshëm nga/deri dhe maksimumi i përdorimeve (bosh = pa kufi);
• për çdo kod: në arkë dhe/ose në dyqanin online (arka i dërgon kodet bashkë me menunë; përdorimi numërohet bashkë për arkën dhe dyqanin online).

Në ekranin e porosive gjendet butoni Kodi i zbritjes (kushdo mund të fusë një kod; kodi është krijuar paraprakisht nga biznesi). Zbritja shfaqet në faturë si rreshti "Kodi i zbritjes CODE", e ndarë sipas normave të TVSH-së; një kod për faturë, dhe jo më pasi është paguar (pjesërisht). Nëse e heq rreshtin ose porosia anulohet, përdorimi nuk numërohet më. Fshirja e një kodi të përdorur e çaktivizon atë (raportet mbeten të sakta). Gjithçka ruhet në regjistër (Kodi i zbritjes). Kodi: lib/kortingscodes.ts, routes/kortingscodes.ts, Kortingscodebeheer.tsx, KortingscodeDialoog.tsx.

Nuk shfaqen në listën te Cilësimet → Kodet e zbritjes (numri për çdo ofertë po, te Raporti → Marketing) dhe kalojnë në dyqanin online për sa kohë janë të vlefshme dhe të papërdorura.

Raportet dhe mbyllja e ditës

Butoni Raporti në shiritin e sipërm:

• Gjendja e ndërmjetme (X): xhiro, TVSH, mënyrat e pagesës, për grup dhe sirtari i parave që nga mbyllja e fundit e ditës. Mund edhe të printohet. Nuk mbyll asgjë.
• Mbyll ditën (Z) (menaxheri ose administratori): numëro sirtarin e parave (tregohet diferenca me fondin fillestar + paratë në dorë), fut fondin fillestar për ditën tjetër, mbyll. Raporti Z merr një numër vijues, ruhet dhe printohet në printerin e faturave. Nuk mund të bëhet sa kohë ka porosi të hapura. Opsionale: Numëro sipas monedhës dhe kartëmonedhës (ndihmë numërimi) e plotëson për ty shumën e numëruar; numërimi sipas monedhës/kartëmonedhës del atëherë edhe në raportin Z. Shkrimi vetë i totalit funksionon si gjithmonë.
• Sirtari i parave (menaxheri ose administratori, opsionale):
  • Para nga sirtari (depozitë në bankë, shpenzim, bakshish i paguar) ose para në sirtar (kusur) me shumën dhe arsyen. Sirtari hapet dhe del një faturë e vogël me rresht për nënshkrim, për ta mbajtur me paratë (mund të çaktivizohet). Llogaritet te pritet në sirtar dhe shfaqet për rresht në raportin X dhe Z.
  • Fut ose korrigjo fondin fillestar të sotëm (zakonisht e fut gjatë mbylljes së ditës për ditën tjetër).
  • Hap sirtarin pa shitje, me arsye.
  • Gjithçka shkon në regjistër. Nëse nuk e përdor këtë, mbyllja e ditës funksionon saktësisht si më parë (fondi fillestar + paratë në dorë = pritet në sirtar).
• Nën xhiron shfaqet numri i mysafirëve (personat e porosive të arkëtuara) dhe mesatarja për mysafir, edhe në raportin e printuar X/Z.
• Xhiro për periudhë (menaxheri ose administratori): sot, dje, këtë/javën e kaluar, këtë/muajin e kaluar, këtë vit ose zgjidh vetë nga-deri. Tregon xhiron, TVSH-në, mënyrat e pagesës, bakshishin, mysafirët, grupet e produkteve, për ditë dhe për punonjës. Me Eksporto (Excel/CSV) merr një skedar për kontabilistin (pikëpresje dhe presje dhjetore, hapet direkt në Excel-in holandez).
• Raportet Z të mëparshme: listë me xhiron dhe diferencën e arkës; hapi dhe printo një kopje (me shënimin "KOPJE").

Eksport për kontabilitetin

Raporti → Xhiro sipas periudhës → Eksport kontabiliteti (ditari) (e drejta Xhiro sipas periudhës) krijon një CSV me një artikull ditari për çdo ditë, gati për t'u lexuar në e-Boekhouden, Exact, SnelStart, Twinfield etj. (përmes importit të tyre CSV/memorial), ose një nga formatet më poshtë (UBL, XAF dhe gati për 14 programe).

Për çdo ditë një dokument (KASSA-JJJJMMDD) që gjithmonë barazohet (debi = kredi):

Kthimet dhe zbritjet janë tashmë në fatura dhe e ulin xhiron. Kolonat: Datum; Boekstuk; Dagboek; Rekening; Omschrijving; Debet; Credit; Btw-code; Btw-% (pikëpresje, presje dhjetore). Pas shkarkimit arka njofton nëse ka ditë që nuk barazohen ose që kanë diferencë më të madhe se rrumbullakimi.

Pranë butonit zgjedh formatin (zgjedhja mbahet mend në shfletues). I njëjti ditar, por i formatuar që programi ta lexojë drejtpërdrejt. Lista tregon vetëm formatet për vendin e biznesit (Cilësimet → Biznesi), fillimisht standardet (CSV, UBL, XAF), pastaj programet sipas alfabetit:

Përmbledhje: cili program kontabiliteti në cilën mënyrë

Sipas segmentit, sipas alfabetit. NL/BE = në cilin vend funksionon programi: te Cilësimet → Kontabiliteti → Programi i kontabilitetit sheh vetëm programet për vendin e biznesit (programet holandeze nuk funksionojnë në Belgjikë dhe anasjelltas). Drejtpërdrejt = arka regjistron vetë çdo ditë (zgjidhet te Cilësimet → Kontabiliteti → Programi i kontabilitetit); me kërkesë = ka një API, por ajo kërkon fillimisht një regjistrim si partner ose miratim nga furnizuesi (na njofto). Skedar = formati te Eksport kontabiliteti. Kur janë të mundshme të dyja, mund t'i përdorësh të dyja. Lista ndodhet në packages/shared/src/boekhoudcatalogus.ts dhe shfaqet edhe te Cilësimet → Kontabiliteti.

Lëre kontabilistin të kontrollojë importin e parë. Formatimi ndodhet në packages/shared/src/journaalexport.ts (me teste).

Cilësimet → Kontabiliteti (e drejta Konfiguro biznesin, pagesat dhe printerët): kodi i ditarit (si parazgjedhje MEM) dhe llogaria e librit kryesor për çdo zë. Bosh = llogari shembull (NL: 8000/8010/8020 xhiro, 1500/1510 TVSH, 1000 arka, 1100 karta; BE: 7000xx xhiro, 451000 TVSH, 570000 arka). Lëre kontabilistin të plotësojë llogaritë e vërteta.

Lidhja me një program kontabiliteti

Lidhje të drejtpërdrejta me Acumulus, AFAS Profit, Microsoft Dynamics 365 Business Central, Exact Online, Horus, Moneybird, Odoo, QuickBooks Online, SAP Business One, Silvasoft, SnelStart, Twinfield, Xero, Yuki dhe Zoho Books. Pas çdo dite arka regjistron të njëjtin ditar si eksporti më sipër (xhiro dhe TVSH sipas normës, mënyrat e pagesës, bakshishi, rrumbullakimi, sirtari dhe diferenca e arkës) si veprim memorial në programin e zgjedhur, me ditarin dhe llogaritë kontabël nga Cilësimet → Kontabiliteti. Gjithmonë është aktiv më së shumti një program.

• Lista është e ndarë sipas segmentit (biznese të vogla dhe të vetëpunësuar, ndërkombëtare, ndërmarrje dhe zinxhirë) dhe tregon vetëm programet që funksionojnë në vendin e biznesit; serveri refuzon një program nga një vend tjetër (400) dhe nuk regjistron me të (409). Menjëherë poshtë administratori merr pikërisht fushat e atij programi; lidhja dhe lista e ditëve të regjistruara ndodhen poshtë llogarive kontabël, dhe poshtë tyre përmbledhja e të gjitha programeve për këtë vend. Nëse gjatë përditësimit ishin dy aktivë (në një version më të vjetër kjo ishte e mundur), Exact Online mbetet aktiv dhe programi tjetër çaktivizohet.

• OAuth (Horus, QuickBooks, Twinfield, Xero, Zoho): regjistro një herë një aplikacion te programi.
• Për disa programe fushat e API-së nuk mund të konfirmohen plotësisht nga dokumentacioni publik (ndër të tjera Horus, Zoho Books, shenja te Business Central dhe struktura te SAP Business One): lëre gjithmonë kontabilistin të kontrollojë regjistrimin e parë.
• Exact Online: regjistron ditarin si veprim memorial në administratën e zgjedhur.
  • Zgjidhet te Cilësimet → Kontabiliteti → Programi i kontabilitetit → Exact Online (si parazgjedhje Joaktiv). Belgjika: arka përdor vetvetiu start.exactonline.be.
  • Cilësimet → Kontabiliteti → Exact Online: Lidhu me Exact Online hap hyrjen në Exact; pas kësaj shkruhet me cilën administratë është lidhur arka. Te Ditari fut kodin e një memoriali në Exact (p.sh. 90) dhe sigurohu që llogaritë kontabël ekzistojnë në Exact.
  • Kur: menjëherë pas Mbyll ditën dhe më pas çdo orë, për të gjitha ditët e kaluara (deri dje përfshirë) nga Regjistro nga data (si parazgjedhje dita e lidhjes; ditët e mëparshme i ka tashmë kontabilisti). Çdo ditë një herë; ditët pa xhiro kapërcehen. Regjistro tani mund të bëhet gjithmonë.
  • Gabimet (një llogari nuk ekziston në Exact, dita nuk balancon, s'ka internet) shfaqen me arsyen te ajo ditë; arka provon sërish më vonë, dhe ditët pasuese presin derisa të ketë sukses (kështu rendi mbetet i saktë). Në regjistër: "exact_geboekt".
  • TVSH-ja është në llogaritë kontabël të TVSH-së (pa kod TVSH-je, njësoj si në eksport). Lëre kontabilistin të kontrollojë regjistrimet e para.
  • Exact: lidhja vazhdon të funksionojë për sa kohë arka e përdor (çdo 10 minuta një token i ri, çdo herë një refresh token i ri). Nëse është revokuar ose s'është përdorur shumë gjatë, arka kërkon Lidhu përsëri. Shkëput fshin tokenët; çfarë është regjistruar mbetet.
• AFAS Profit: numri i mjedisit (p.sh. 12345; prodhim, test ose pranim), tokeni i një app-connector me UpdateConnector FiEntries dhe numri i administratës (si parazgjedhje 1). Ditari = kodi i një memoriali në AFAS (p.sh. 90).
• Ditari = numri ose emri i një ditari memorial; nëse ka vetëm një ditar memorial, arka merr atë. Llogaritë kontabël duhet të jenë numra.
• Twinfield: hyrje me OAuth. Pa atë aplikacion arka nuk mund të lidhet. Arka kërkon cluster-in dhe administratën (bosh = e para); ditari = kodi i një memoriali (p.sh. MEMO). Regjistron në mënyrë përfundimtare (destiny="final").
• Yuki: çelësi API i administratës (Yuki → Cilësimet → Shërbimet web); administrata bosh = e para për atë çelës. Regjistron një memorial (GeneralJournal); Yuki nuk përdor kod ditari.
• Kur: menjëherë pas Mbyll ditën dhe çdo orë, për të gjitha ditët e kaluara nga Regjistro nga data (si parazgjedhje dita e lidhjes; me një program tjetër sërish nga ajo ditë). Çdo ditë një herë për program; ditët pa xhiro anashkalohen; në rast gabimi arsyeja shfaqet te ajo ditë dhe ditët pasuese presin. Regjistro tani është gjithmonë i mundur. Në regjistër: "boekhoudpakket_geboekt".
• Çelësat dhe tokenët kurrë nuk shfaqen në ekran (lëre bosh kur lidhesh përsëri = mbaje). Në kopjen e arkës në portal nuk regjistrohet asgjë.

Skedari i auditimit të arkës (XAA)

Për bizneset holandeze, te Raporti → Xhiro sipas periudhës pranë eksportit të kontabilitetit ndodhet butoni Skedari i auditimit të arkës (XAA): XML Auditfile Afrekensystemen 3.2 i Administratës Tatimore Holandeze (Belastingdienst) dhe i XML Platform (SRA) për periudhën e zgjedhur (më së shumti pak më shumë se një vit; e drejta Xhiro sipas periudhës). Ky është skedari që Belastingdienst rekomandon për të dorëzuar të dhënat e një arke gjatë një kontrolli ose te kontabilisti; rregullat janë në Handreiking voor een betrouwbaar afrekensysteem (Udhëzues për një sistem arke të besueshëm) (docs/xaa).

Në skedar (auditfile_kassa_<van>_tm_<tot>.xml, skema docs/xaa/XmlAuditfileAfrekensystemen3.2.xsd):

• të dhënat bazë: biznesi (emri, numri i TVSH-së, adresa), kodet e TVSH-së, të gjithë punonjësit (me rolin dhe datën e krijimit; plus SYSTEEM për atë që arka bën vetë, si dyqani online dhe lidhjet) dhe të gjithë artikujt me grupin e tyre;
• ngjarjet: gjithçka nga regjistri në periudhë (hyrja dhe dalja nga sistemi, hapja e sirtarit të parave, mbyllja e ditës, ndryshimi i cilësimeve dhe çmimeve, storno, zbritje, kthim, kopje fature, hyrje dhe dalje nga puna ...) dhe hapja e ditës së arkës me paratë fillestare, secila me kodin e Belastingdienst (18001 hyrje, 18003 sirtar, 18006 ndryshim instalimi, 18008 raport Z, të tjera 18999);
• transaksionet e arkës: çdo faturë (shitje, kthim dhe proforma, me numrin e faturës, punonjësin dhe statusin fiskal nëse nuk është në rregull) me të gjitha rreshtat (artikulli, grupi, sasia, çmimi, TVSH; edhe zbritjet, kuponat dhuratë, titujt e menysë dhe rreshtat e anuluar para pagesës, këta me shumën 0), TVSH sipas normës, rrumbullakimi, pagesat sipas mënyrës së pagesës (para në dorë, kartë, kupon dhuratë, online; bakshishi veçmas) dhe paratë e futura/nxjerra nga sirtari i parave.

Shumat janë pozitive me C (shitje, arkëtim) ose D (kthim, pagesë); oraret në kohën e Holandës me zhvendosje. Të gjithë çelësat janë id-të nga baza e të dhënave pa viza, pra mund të gjenden në arkë.

Nënshkrimi (kapitulli 6 i specifikimit): nëse Optimum POS ka konfiguruar një certifikatë, skedari i auditimit vjen i nënshkruar në një zarf (XML Signature) dhe skedari quhet …_ondertekend.xml; përndryshe është një skedar auditimi i veçantë, dhe arka e njofton këtë gjatë shkarkimit.

Pagesë në llogari

Klientët e biznesit (një firmë që merr drekë çdo javë, një hotel, një shoqatë) blejnë në llogari dhe paguajnë më vonë, me faturë. Aktivizoje te Cilësimet → Fatura → Pagesë në llogari (vetëm me Faturat aktive; si parazgjedhje joaktive).

• Klientët: te Raporti → Në llogari regjistron klientët e biznesit me të dhënat për faturën (emri, adresa, numri i TVSH-së, numri KvK / numri i ndërmarrjes, Peppol-ID, e-mail), sipas dëshirës një kufi (sa mund të jetë e hapur maksimalisht) dhe një afat pagese të veçantë (përndryshe ai i faturave), dhe nëse fatura dërgohet menjëherë.
• Pagesa në arkë: mënyra e pagesës Në llogari, zgjidh klientin (me shumën që është tashmë e hapur dhe kufirin). Fatura e arkës është shitje e zakonshme: xhiro dhe TVSH në atë ditë, në Belgjikë normalisht përmes kutisë së zezë, në faturën e arkës "Në llogari". Arka krijon menjëherë faturën (UBL/Peppol dhe për printim) me shumën që mbetet e hapur dhe datën e skadencës, dhe e dërgon siç është caktuar te faturat (e-mail, Peppol përmes Billit/Storecove/Banqup ose adresa e vet). Në llogari është një shumë për pjesën e mbetur të llogarisë (një pjesë mund të paguhet më parë ndryshe), pa bakshish; një kartë dhuratë nuk mund të shitet në llogari. Mbi kufirin arka refuzon.
• Pagesa: klienti paguan në lokal me para në dorë, kartë ose kartë dhuratë (Raporti → Në llogari → Pagesa u mor; edhe pjesërisht). Kjo nuk është shitje e re dhe as faturë e re e arkës: paratë në dorë shfaqen si para në sirtar (sirtari hapet), gjithçka është në X dhe Z te Marrë në llogari. Kur gjithçka është paguar, fatura del "paguar". Pagesa online nuk përfshihet.
• Transfertë: nëse te Të dhënat në faturë ka një IBAN, ai shfaqet në faturë (dhe në UBL), me "Mund të paguani edhe në lokal". Nëse klienti e ka transferuar, e regjistron me Pagesa u mor → Transferuar (bankë): jo në sirtar, por në X dhe Z te Marrë në llogari. Pa IBAN shkruhet "Për t'u paguar në lokal". Në Belgjikë, në faturë dhe në UBL shfaqet një referencë e strukturuar (+++123/4567/89012+++, nga numri i faturës), që banka ta dërgojë bashkë me pagesën.
• Banka: shlyerja e transfertave pa rishkruar, shih më poshtë.
• Kredi (para paraprakisht): te Raporti → Në llogari → Depozito kredi vendos para paraprakisht në llogarinë e një klienti, para në dorë (sirtari hapet) ose me kartë, p.sh. për një seri drekash. Në shitjen e ardhshme në llogari kredia zbritet fillimisht nga fatura; nëse fatura është më e madhe, pjesa tjetër mbetet e hapur. Kredia shfaqet te klienti (kredi € ...), në X dhe Z te Marrë në llogari (Kredi e depozituar, Me kredinë e klientit) dhe në regjistrimin kontabël si marrë paraprakisht (si parazgjedhje 1640 / 460000). Në Belgjikë depozitimi shkon si hyrje parash (signMoneyInOut) te kutia e zezë (UC4100).
• Faturë përmbledhëse (për klient, si parazgjedhje joaktive): me Një faturë për të gjitha kuponat klienti nuk merr ende faturë te një shitje në llogari. Kuponi mbetet i hapur te klienti (Kupona ende të pafaturuara, llogaritet në kufi) dhe mund të paguhet që tani. Me Krijo faturë përmbledhëse (p.sh. në fund të muajit) të gjithë kuponat e hapur shkojnë në një faturë, çdo rresht me numrin e kuponit përpara; ajo që është paguar tashmë, shfaqet si e paguar. Një kthim në llogari shfaqet si rreshta negativë. Joaktive = si gjithmonë, një faturë për çdo shitje. Në Belgjikë një faturë me të gjithë kuponat te kutia e zezë (signInvoice, UC4121 dhe UC4122).
• Belgjikë: nëse klienti paguan më vonë një shitje në llogari (para në dorë, kartë, kartë dhuratë ose transfertë), arka e raporton këtë si korrigjim pagese në faturë: nga kredia e klientit te mënyra e vërtetë e pagesës (signPaymentCorrection, UC4118).
• Përmbledhje: faturat e hapura me datën e skadencës (me vonesë me të kuqe), për çdo klient faturat dhe pagesat. Te Cilësimet → Faturat një kolonë E hapur.
• Kontabiliteti: në regjistrin kontabël shitja në llogari shkon te Debitorët (si parazgjedhje 1300 në Holandë, 400000 në Belgjikë; caktohet te Cilësimet → Kontabiliteti) dhe pagesa nga arka, karta, karta dhuratë ose banka (si parazgjedhje 1050 / 550000) te debitorët. XAA: mënyra e pagesës "Në llogari".
• E drejtë: Pagesë në llogari dhe marrje pagesash në llogari (si parazgjedhje kamarieri jo, menaxheri po). Gjithçka ruhet në regjistër.
• Joaktiv: klientët, faturat dhe pagesat ruhen (edhe në kopjen rezervë); çelësi përfshihet në eksportin e konfigurimit, klientët jo (ata i përkasin një lokali të vetëm).
• Në dyqanin online (opsionale, si parazgjedhje joaktive): me Edhe në dyqanin online, klientët e biznesit porosisin online në llogari (marrje dhe dërgesë). Te Raporti → Në llogari krijon për çdo klient një kod klienti dhe ia jep klientit; arka ruan vetëm një version të koduar, prandaj e sheh vetëm një herë. Kod i ri klienti = i vjetri nuk funksionon më; Hiq kodin e klientit = ai klient nuk mund të porosisë më online në llogari. Dyqani online e respekton kufirin. Në dritaren Dyqani online e përfundon një porosi të tillë me Përfundo (në llogari): pagesë në llogari, me faturën menjëherë.

Banka: shlyerja e transfertave

Te Raporti → Në llogari → Banka, arka kërkon për çdo hyrje faturën përkatëse në llogari:

• Ngarko ekstraktin bankar: skedari nga e-banking, si CAMT.053 (XML, të gjitha bankat në Holandë dhe Belgjikë), MT940 (.sta/.940) ose CODA (.cod, Belgjikë). Vetëm hyrje; ngarkimi dy herë i të njëjtit ekstrakt nuk krijon rreshta të dyfishtë.
• Kërkimi: sipas numrit të faturës ose referencës së strukturuar në përshkrim (e sigurt), përndryshe sipas shumës (dhe emrit): atëherë është propozim. Çdo rresht mund ta shlyesh (te propozimi ose te një faturë tjetër), ta injorosh ose më vonë ta shlyesh gjithsesi. Shlyerja = Transferuar (bankë) me datën e bankës, kurrë më shumë se shuma e hapur; jo në sirtar.
• Lidhja me bankën (PSD2, opsionale): te Cilësimet → Fatura → Lidhja me bankën, arka merr vetë çdo orë hyrjet përmes Enable Banking (banka në Holandë, Belgjikë dhe në pjesën tjetër të Evropës). Zgjidh bankën dhe hyr në bankë (llogari biznesi); pëlqimi vlen 180 ditë, pastaj lidhe sërish. Shkëputja e tërheq pëlqimin; hyrjet mbeten. Pa kontratë me Enable Banking kjo funksionon vetëm për llogaritë e tua (restricted production).
• Shlyerje automatike (si parazgjedhje joaktive): një hyrje që i përket me siguri një fature, arka e shlyen menjëherë (edhe gjatë ngarkimit).
• E drejta: shlyerja me Pagesë në llogari dhe marrje pagesash në llogari; konfigurimi i lidhjes me bankën me Konfiguro lokalin, pagesat dhe printerët. Ngarkimi, lidhja, marrja dhe shlyerja regjistrohen në regjistër.
• Joaktive: kur pagesa në llogari është joaktive, arka nuk merr asgjë; hyrjet dhe lidhja ruhen (edhe në kopjen rezervë).

Pamjet e kamerave në arkë

Të gjitha pamjet e kamerave të lokalit në një faqe, pa ekran apo aplikacion të veçantë. Aktivizoje te Cilësimet → Lokali → Ekranet dhe përdorimi → Pamjet e kamerave në arkë (standard joaktiv). Atëherë butoni Kamerat shfaqet në shiritin e sipërm për ata që kanë të drejtën Shiko pamjet e kamerave (standard menaxheri dhe administratori; te Cilësimet → Të drejtat mund të aktivizohet edhe për kamarierët). Të gjitha kamerat janë njëra pranë tjetrës; prek një kamerë për pamje të madhe. Kur çaktivizohet, sistemet e kamerave mbeten të ruajtura.

Edhe si ekran i veçantë: Në një ekran të veçantë hap http://<kassaserver>:3000/camera (p.sh. një monitor pas banakut), dhe Në tablet ose telefon shfaq një kod QR: një punonjës e skanon me tabletin ose telefonin e vet dhe identifikohet me kodin e vet PIN (edhe atje vetëm me të drejtën Shiko pamjet e kamerave). Në një ekran të ngushtë kamerat shfaqen njëra nën tjetrën. Shih Ekran i dytë në tablet ose telefon.

Administratori shton sistemet e kamerave me + Sistem kamerash, i teston me Testo dhe për çdo kamerë zgjedh emrin dhe nëse shfaqet në faqe:

• Hikvision, Dahua, Axis dhe Reolink: një kamerë ose regjistrues (NVR) në rrjet: adresa IP (sipas nevojës me :poort), një përdorues (mundësisht vetëm për shikim) dhe kanalet, p.sh. 1-8 ose 1,3,5. Hyrja me Basic ose Digest; lejohet https me certifikatë të vetë.
• Synology Surveillance Station: adresa e NAS-it (porta standarde 5000, me https 5001) dhe një përdorues; Merr kamerat i merr kamerat me emrat e tyre.
• UniFi Protect: adresa e konsolës (https) dhe një llogari lokale; Merr kamerat.
• ONVIF: çdo kamerë ose regjistrues me ONVIF (p.sh. Hanwha, Bosch, Uniview, Annke); Merr kamerat gjen adresën e fotos për çdo burim video.
• Adresë uebi e vetë: një foto (JPEG), një rrjedhë MJPEG ose një adresë rtsp://.
• Faqja e uebit e sistemit të kamerave (p.sh. Frigate, Blue Iris ose go2rtc): hapet në arkë me butonin Kamerat (ose në një dritare të veçantë).

Pa ffmpeg: fotoja.

Privatësia: arka i merr pamjet nga sistemi i kamerave dhe vetëm i përcjell; nuk ruhet asgjë (pa regjistrime, pa cache). Përdoruesit dhe fjalëkalimet mbeten në server dhe nuk shfaqen kurrë në ekran ose në regjistër. Në regjistër shënohet kush i shikoi kamerat. Vetë pamjet faqja i kërkon me një çelës (i vlefshëm 12 orë, për sa kohë punonjësi është i identifikuar), sepse një pamje në shfletues nuk mund të dërgojë token. Eksporti i konfigurimit përfshin vetëm aktiv/joaktiv.

Regjistri i veprimeve të ndjeshme

Raporti → Regjistri (menaxheri ose administratori) tregon kush bëri çfarë dhe kur.

• Zgjidh një periudhë (sot, dje, këtë javë, këtë/muajin e kaluar ose vetë nga-deri), çfarë do të shohësh (si parazgjedhje Veprimet e ndjeshme, ose p.sh. vetëm anulimet dhe zbritjet, ose Të gjitha) dhe sipas dëshirës një punonjës.
• Lart për punonjës: numri dhe shuma e anulimeve (fshirë pas porosisë), zbritjeve dhe kthimeve, dhe sa herë u hap sirtari pa shitje, para nga sirtari, kopje faturash, pro forma dhe pagesa manuale me kartë. Prek një emër për të parë vetëm atë punonjës. Edhe numri i herëve që është futur një kod PIN i gabuar.
• Më poshtë çdo veprim me orën, kush, çfarë dhe një përshkrim të lexueshëm (p.sh. "2x Cola fshirë pas porosisë € 5,60 · tavolina 4 · arsyeja: klienti nuk e deshi").
• Shkarko (CSV) për Excel.

Çfarë regjistrohet: anulime, zbritje (dhe heqja e tyre), kthime, kopje faturash, pro forma, pagesa manuale me kartë, hapja e sirtarit, para hyrëse/dalëse në sirtar, fondi fillestar, mbyllja ditore, zhvendosja e rreshtave ose tavolinave, mbyllja e porosive bosh, ndryshimi i çmimit/emrit/TVSH-së së produkteve, produkte të reja ose të fshira, ndryshime të personelit dhe cilësimeve, përshtatja e orarit të punës, hyrja dhe dalja nga sistemi, kode PIN të gabuara dhe regjistrimi i hyrjes dhe daljes në punë. Me pagesën me llogari gjithashtu: klientë, shitje dhe pagesa me llogari, ngarkimi i ekstrakteve bankare, lidhja me bankën dhe marrja nga banka. Me njoftimin për kohë përgatitjeje shumë të gjatë: porositë me vonesë dhe kërkimet e faljes të dërguara. Me Mailchimp ose Klaviyo: lidhja, zgjedhja e listës, shkëputja dhe çregjistrimet nga atje. Me kontrollin e muzikës: aktivizimi/çaktivizimi dhe shtimi, ndryshimi dhe heqja e burimeve të muzikës. Me pamjet e kamerave: kush i shikoi kamerat (më së shumti një herë në gjysmë ore për punonjës), aktivizimi/çaktivizimi dhe sistemet e kamerave. Me sinjalizimin: çdo sinjal, zgjidhja e tij dhe aktivizimi e çaktivizimi.

Sinjalizimi: mashtrime dhe devijime

Cilësimet → Sinjalizimi. Dy pjesë, secila aktivizohet veçmas dhe është e çaktivizuar si parazgjedhje; çaktivizimi ruan të gjitha sinjalet dhe cilësimet. Konfiguron kush ka të drejtën Konfiguro sinjalizimin (si parazgjedhje menaxheri dhe administratori); sinjalet i sheh dhe i zgjidh kush mund të shohë regjistrin. Arka kontrollon çdo 5 minuta (dhe me Kontrollo tani); jo në arkën hije.

Sinjalizimi i mashtrimeve dhe vjedhjeve (për punonjës, për ditë pune nga 05:00), çdo rregull aktivizohet veçmas me kufirin e vet:

• storno pas pro formës: hequr pasi klienti e kishte parë tashmë faturën;
• storno, zbritje dhe kthime: nga një numër i caktuar herësh, ose gjithsej nga një shumë (0 = jo sipas shumës);
• sirtar i hapur pa shitje (butoni Hap sirtarin);
• faturë e hapur gjatë: e porositur, por pas disa minutash ende e papaguar.

Njoftime për devijime, krahasuar me të njëjtën ditë të javës dhe të njëjtën orë në javët e fundit (si parazgjedhje 4; ditët pa xhiro nuk llogariten, të paktën dy ditë krahasimi):

• xhiro deri tani më e ulët (dhe/ose më e lartë) se zakonisht me më shumë se marzhi, vetëm nga një xhiro normale prej një shume të caktuar;
• koha e kuzhinës (nga dërgimi i faturës në kuzhinë deri në gati në ekranin e kuzhinës) në orën e fundit mbi marzhin, ose mbi një numër fiks minutash;
• storno sot mbi marzhin, vetëm nga një numër minimal.

Çdo sinjal vjen një herë (për rregull, punonjës dhe ditë; koha e kuzhinës më së shumti një herë në orë) dhe shkon te:

• arka: butoni Sinjalet (n) në shiritin e sipërm me sinjalet e ditës, javës ose 30 ditëve të fundit; Zgjidhur me një shënim. Ekranet e tjera marrin vetëm një sinjal pa emra;
• njoftim push me ntfy (aplikacion falas; ntfy.sh ose server i yti, topic dhe sipas nevojës një token), Pushover (API-token i aplikacionit dhe user key) ose Telegram (tokeni i botit dhe chat-id);

Për çdo kanal ka një buton Mesazh testues. Tokenet dhe çelësat mbeten në arkë (ekranet shohin vetëm nëse janë plotësuar). Një sinjal nuk është provë: shiko faturën dhe regjistrin dhe bisedo me punonjësin.

Faturat: kopje dhe kthim (faturë krediti)

Butoni Faturat në shiritin e sipërm:

• Lista e faturave që nga mbyllja e fundit e ditës, ose e 7 ditëve të fundit; një faturë më të vjetër e kërkon me numrin e saj.
• Printo kopje: e njëjta faturë me shënimin "KOPJE" (në Belgjikë me bllokun FDM të faturës origjinale). Regjistrohet në regjistër.
• Kthim / faturë krediti (menaxheri ose administratori): zgjidh për çdo rresht sa kthehet, një arsye dhe si kthehen paratë (para në dorë, kartë, kartë dhurate, të tjera). Fatura e vjetër mbetet e paprekur: shtohet një faturë e re krediti me numrin e vet në ditar (lloji i biletës retour, shuma negative, në Belgjikë si NR te FDM). Nuk mund të kthehet kurrë më shumë se sa është shitur. Në raportin X dhe Z kthimi llogaritet si xhiro negative.
• Te CCV ose një terminal tjetër: së pari kthe paratë në vetë terminalin dhe pastaj shëno "Kthyer tashmë në terminal".
• Para në dorë me rrumbullakim në 5 cent: shuma që kthehet rrumbullakohet gjithashtu.
• Mbrapsht në llogari (shitje në llogari): nëse fatura ishte në llogari të një klienti biznesi, zgjidh Në llogari. Shuma zbritet nga fatura e hapur dhe arka krijon menjëherë një notë krediti (në UBL një CreditNote, lloji 381, me referencë te fatura; në Belgjikë e nënshkruar me signInvoice, UC4122). Më shumë se sa është e hapur në faturë nuk mund të kthehet në llogari; ktheje pjesën tjetër me para në dorë ose me kartë. Nota e kreditit shfaqet te Fatura dhe e dërgon si një faturë.

Sirtari i parave me sensor dhe sirtar për çdo punonjës

Si parazgjedhje joaktiv. Konfigurohet te Cilësimet → Pagesat → Sirtari i parave.

• Sensor: shumë sirtarë njoftojnë përmes printerit të faturave nëse janë të hapur apo të mbyllur (ESC/POS DLE EOT 1, pini 3 i portës DK). Kjo është e mundur vetëm me printer faturash në rrjet. Prekni Mat: sirtari i mbyllur dhe Mat: sirtari i hapur; nëse ka ndryshim, merrni gjendjen e saktë (i lartë = i hapur ose i ulët = i hapur). Asnjë ndryshim = ky sirtar (ose kablloja) nuk ka sensor. Asnjë përgjigje nga printeri = e panjohur, kurrë "i mbyllur".
  • Mos paguaj sa kohë që sirtari është i hapur: serveri i arkës atëherë refuzon një pagesë të re me "Sirtari i parave është ende i hapur".
• Sirtar i veçantë për çdo punonjës: një printer faturash mund të hapë dy sirtarë (sirtari 1 dhe sirtari 2). Zgjidhni sirtarin për çdo punonjës; arka atëherë, gjatë pagesës me para në dorë, futjes/nxjerrjes së parave në/nga sirtari dhe Hap sirtarin, hap sirtarin e atij që është i identifikuar. Te Raporti → Arka shfaqet atëherë Sirtari për punonjës: fondi fillestar për punonjës, para në dorë (pa automatin e parave), pritet, Numëro dhe diferenca për çdo person (në regjistër si ladetelling). Mbyllja e zakonshme e ditës mbetet siç është.
• Testo sirtarin 1 dhe Testo sirtarin 2 hapin sirtarin për kontroll.
• Hap sirtarin pa shitje (me arsye) regjistrohet gjithmonë në regjistër dhe në skedarin e auditimit të arkës (XAA), siç kërkon Administrata Tatimore (Belastingdienst) (përjashtime si "no sale").

Pjesa 3 · Administratori

Fillimi

Instalimi. HorecaPOS e instalon me programin e instalimit për sistemin tënd, që gjendet në faqen e shkarkimeve të OptimumPOS: Android (aplikacion), Windows (program instalimi), macOS (instalues për Mac me Apple Silicon dhe Intel), Linux (instalues grafik, ose paketa .deb ose .rpm), Raspberry Pi (instalues grafik ose .deb për një Raspberry Pi 3, 4 ose 5 me Raspberry Pi OS 64-bit) dhe Chromebook (aplikacioni Android nga Google Play). Zgjidh për të gjithë përdoruesit për një server arke me të cilin lidhen tabletat dhe ekrani i kuzhinës, ose vetëm për mua për vetëm një arkë në atë pajisje. Instaluesi vendos gjithçka që nevojitet, edhe bazën e të dhënave, dhe bën çdo natë një kopje rezervë. Për përditësim instalo versionin e ri: të dhënat e tua mbeten. Programi i instalimit niset në gjuhën e kompjuterit tënd (përndryshe në anglisht); te Windows dhe Linux mund të zgjedhësh në ekranin e parë një gjuhë tjetër. Arka niset pastaj menjëherë në atë gjuhë. Paketat .deb dhe .rpm dhe aplikacioni Android ndjekin gjuhën e sistemit, përndryshe holandishten.

Administratori e konfiguron arkën te Cilësimet. Aty ka skeda si Biznesi, Stafi, Të drejtat, Orari i punës, Produktet, Happy hour, Stoku, Planet e sallës, Pagesat, Printerët, Kontabiliteti, Kopjet rezervë, Import/eksport dhe Baza e të dhënave. Cilat skeda sheh edhe menaxheri varet nga të drejtat.

Baza e të dhënave. Te Cilësimet → Baza e të dhënave (vetëm administratori) zgjedh midis MySQL / MariaDB, bazës së integruar të të dhënave dhe PostgreSQL; gjatë kalimit merren me vete të gjitha të dhënat (shih Baza e të dhënave). Nëse Optimum POS ka vendosur tashmë një adresë fikse gjatë instalimit, vlen ajo adresë dhe nuk ka fusha për t'u plotësuar. Përndryshe, i plotëson vetë Serveri, Porta, Baza e të dhënave, Përdoruesi dhe Fjalëkalimi. Arka i ruan vetë, pastaj i shfaq përsëri të plotësuara dhe mund t'i ndryshosh gjithmonë me Ndrysho të dhënat e MySQL/MariaDB ose Ndrysho të dhënat e PostgreSQL. Ta lësh fjalëkalimin bosh do të thotë: mbahet fjalëkalimi i ruajtur (për të njëjtin përdorues). Instaluesi dhe një përditësim nuk ndryshojnë asgjë te DATABASE_URL apo te baza e zgjedhur e të dhënave.

Kontabiliteti

Gjithçka për kontabilitetin ndodhet te Cilësimet → Kontabiliteti. Plotëso së bashku me kontabilistin ditarin dhe llogaritë kontabël. Nëse dëshiron që arka ta regjistrojë vetë xhiron ditore çdo ditë, zgjidh lart te Programi i kontabilitetit programin tënd, edhe Exact Online: sheh vetëm programet që funksionojnë në vendin e biznesit tënd. Menjëherë poshtë plotëson të dhënat e atij programi dhe lidhesh. Për programet ku hyn me llogari (si Exact Online, Twinfield ose Xero) plotëso fillimisht aplikacionin: ID-në e klientit dhe sekretin e klientit. Nëse Optimum POS e ka caktuar në mënyrë fikse programin ose një të dhënë gjatë instalimit, atë zgjedhje ose atë fushë nuk e sheh. Aty ka edhe një përmbledhje të të gjitha programeve: cilat mund të lidhen drejtpërdrejt dhe cilat marrin një skedar. Një skedar e krijon te Raporti → Xhiro sipas periudhës → Eksport kontabiliteti: zgjidh formatin e programit tënd, ose UBL (Peppol), XAF ose një pasqyrë ditore. Lëre gjithmonë kontabilistin të kontrollojë regjistrimin ose importin e parë.

Për një biznes holandez aty ndodhet edhe Skedari i auditimit të arkës (XAA): XML Auditfile Afrekensystemen i Administratës Tatimore Holandeze (Belastingdienst) me të gjitha faturat, rreshtat, pagesat dhe ngjarjet e arkës për periudhën e zgjedhur. Atë ia jep kontabilistit tënd ose gjatë një kontrolli Belastingdienst.

Paga dhe planifikimi

Nëse stafi yt punon me hyrje dhe dalje nga turni, te Cilësimet → Oraret e punës poshtë gjendet Paga dhe planifikimi, në dy blloqe. Te Administrimi i pagave zgjedh programin tënd të pagave ose (në Belgjikë) sekretariatin tënd social, dhe për çdo punonjës plotëson numrin e tij të punonjësit në atë program. Pastaj krijon për një periudhë skedarin me orët e punuara dhe xhiron për çdo punonjës, dhe e importon në programin tënd të pagave. Te Planifikimi i personelit zgjedh sistemin tënd të planifikimit: te Deputy, Dyflexis dhe Shiftbase xhiroja shkon automatikisht çdo orë, te të tjerët krijon një skedar xhiroje. Kështu në planifikimin tënd i sheh kostot e pagave pranë xhiros. Nëse punon pa hyrje dhe dalje nga turni, prapë mund ta dërgosh xhiron te planifikimi yt: atëherë kjo gjendet poshtë te Cilësimet → Kontabiliteti, te Xhiroja te planifikimi yt. Nëse Optimum POS ka vendosur diçka në mënyrë fikse gjatë instalimit, atë zgjedhje ose atë fushë nuk e sheh.

Kopjet rezervë

Arka bën automatikisht një kopje rezervë çdo natë, dhe gjithmonë para një përditësimi. Te Cilësimet → Kopjet rezervë sheh të gjitha kopjet rezervë (kur, nga kush ose automatikisht, madhësia) dhe me Bëj kopje rezervë mund të bësh vetë një. Nëse kopja e fundit rezervë është më e vjetër se dy ditë, shfaqet një paralajmërim i kuq: në atë rast kontakto Optimum POS.

Rikthimi bëhet me butonin Rikthe pranë një kopjeje rezervë. Gjithçka që ka ndodhur pas asaj kopjeje rezervë humbet. Duhet ta konfirmosh me shenjë dhe të futësh përsëri kodin tënd PIN. Arka bën fillimisht një kopje rezervë sigurie të gjendjes aktuale dhe pastaj nxjerr të gjithë nga sistemi. Në Belgjikë kjo nuk mund të bëhet nga arka (numëruesit e kutisë së zezë vazhdojnë); atje e bën Optimum POS.

Baza e të dhënave

Te Cilësimet → Baza e të dhënave (vetëm administratori) sheh ku i ruan arka të dhënat e saj. Lart është databaza aktuale me programin, versionin, tabelat, rreshtat dhe adresën ose dosjen. Për stafin dhe tabletët arka punon njësoj me çdo databazë. Në Windows, macOS, Linux dhe Raspberry Pi zgjedh mes tri databazash:

• MySQL / MariaDB: një program i veçantë databaze (MySQL 8.0 ose më i ri, MariaDB 10.6 ose më i ri), për shembull në një server ose NAS që e ke tashmë. Të gjitha të dhënat janë atëherë në tabela të zakonshme në MySQL ose MariaDB, të lexueshme nga programi yt i raporteve ose BI. Arka llogarit saktësisht si me PostgreSQL.
• E integruar (PGlite): është brenda vetë arkës, s'ke nevojë të instalosh asgjë. Zgjedhja më e mirë për shumicën e lokaleve dhe databaza në Android e Chromebook.
• PostgreSQL: një program i veçantë databaze në kompjuterin e arkës ose diku në rrjet.

Kur MySQL ose MariaDB? Nëse lokali yt ka tashmë një server MySQL ose MariaDB, nëse administratori yt i IT-së punon me të, ose nëse do t'i lexosh të dhënat në raportet e tua, në Excel ose në një program BI. Nëse ke dyshime, zgjidh të integruarën: punon menjëherë.

Çfarë duhet për MySQL ose MariaDB?

• MySQL 8.0 ose më i ri, ose MariaDB 10.6 ose më i ri, i arritshëm nga serveri i arkës.
• Një databazë më vete për arkën (ose për arkat e një zinxhiri), me grupin e karaktereve utf8mb4.
• Një përdorues databaze që në atë databazë mund të krijojë, ndryshojë, riemërtojë dhe fshijë tabela (CREATE, ALTER, DROP, INDEX, SELECT, INSERT, UPDATE, DELETE), për shembull kështu:

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

Nëse MySQL ose MariaDB punon në një kompjuter tjetër, në dy rreshtat e fundit vendos adresën IP të serverit të arkës në vend të localhost.

Konvertimi në MySQL / MariaDB:

1. Te Adresa e MySQL/MariaDB plotëso fushat: Serveri (parazgjedhje localhost), Porta (parazgjedhje 3306), Baza e të dhënave (parazgjedhje horecapos), Përdoruesi dhe Fjalëkalimi; njësoj për MariaDB. Nëse adresa është vendosur tashmë, fushat janë të plotësuara; nëse e lë fjalëkalimin bosh, mbetet fjalëkalimi i ruajtur (për të njëjtin përdorues). Arka e ruan vetë adresën; nëse Optimum POS ka vendosur tashmë një adresë fikse, vlen ajo adresë dhe nuk ka fusha. Nëse arka punon tashmë me MySQL/MariaDB, të dhënat i ndryshon më vonë me Ndrysho të dhënat e MySQL/MariaDB. Lidhjen e enkriptuar ta konfiguron Optimum POS.
2. Prek Testo lidhjen: sheh programin dhe versionin, ose pse nuk funksionon.
3. Prek Konverto në MySQL/MariaDB, shëno që e kupton dhe fut PIN-in tënd.

Konvertimi funksionon në çdo drejtim mes tri databazave, dhe të gjitha të dhënat kalojnë:

1. Arka për pak kohë nuk pranon kërkesa (zakonisht më pak se një minutë); pastaj tabletët vazhdojnë vetë.
2. Fillimisht arka bën një kopje rezervë të gjendjes aktuale (te Cilësimet → Kopjet rezervë).
3. Gjithçka kalon në databazën e re dhe arka numëron për çdo tabelë nëse gjithçka është aty saktësisht.
4. Vetëm kur gjithçka përputhet, arka vazhdon me databazën e re. Punonjësit e identifikuar mbeten të identifikuar.

Nëse diçka nuk shkon, asgjë nuk ndryshon dhe arka vazhdon punën me databazën e vjetër. Databaza e vjetër mbetet, kështu që mund të kthehesh gjithmonë. Të dhënat e arkës që ishin tashmë në databazën e re MySQL/MariaDB ose PostgreSQL zëvendësohen. Funksionon edhe në Belgjikë: numëruesit e kutisë së zezë kalojnë saktësisht.

Kopjet rezervë dhe rikthimi funksionojnë njësoj me të tri databazat (Cilësimet → Kopjet rezervë). Një kopje rezervë e një databaze mund të rikthehet në çdo databazë tjetër, edhe një kopje e PostgreSQL në MySQL ose MariaDB.

Çfarë ka në MySQL ose MariaDB? Çdo tabelë e arkës, me të njëjtin emër dhe kolona (orët në UTC). Çdo tabelë merr edhe kolonën çelës _hp_sleutel, dhe në tabelat ndihmëse _horecapos_stand, _horecapos_kolom, _horecapos_reeks dhe _horecapos_wijziging (regjistri i ndryshimeve, ruhet 14 ditë) arka mban gjendjen, llojet e kolonave, numëruesit dhe ndryshimet. Programet e tjera i lexojnë të dhënat; shkruajnë vetëm arkat.

Si funksionon: arka llogarit në një kopje pune të shpejtë në serverin e arkës dhe çdo ndryshim e shkruan në MySQL/MariaDB në të njëjtin hap. Nëse kjo nuk ia del, ndryshimi nuk kryhet dhe arka tregon një gabim; prandaj mbaje MySQL/MariaDB të arritshëm. Në nisje arka i lexon të gjitha nga MySQL/MariaDB.

Disa arka në një databazë. Ashtu si me PostgreSQL, disa arka mund të përdorin të njëjtën databazë MySQL/MariaDB, për shembull çdo lokal i një zinxhiri me serverin e vet të arkës. Ndryshimet bëhen njëri pas tjetrit dhe çdo arkë merr fillimisht atë që bënë të tjerat, kështu që asgjë nuk humbet kur ndryshohet njëkohësisht. Nëse një arkë rikthen një kopje rezervë ose një arkë me version më të ri përditëson databazën, arkat e tjera i rilexojnë vetë të gjitha; prandaj përditëso të gjitha arkat njëkohësisht. Një arkë që ka qenë e fikur më shumë se 14 ditë i rilexon të gjitha në nisje.

Gjatë instalimit zgjedh edhe databazën: MySQL / MariaDB, të integruarën (e rekomanduar) ose PostgreSQL me adresën. Nëse nuk arrihet, arka instalohet me databazën e integruar; konvertimin mund ta bësh më pas këtu. Me një përditësim zgjedhja mbetet.

Lidhja e tabletave dhe ekraneve

• Në çdo tablet/arkë hap adresën e serverit të arkës, p.sh. http://192.168.1.20:3000, dhe vendose si shkurtore në ekranin kryesor (Chrome: Shto në ekranin bazë).
• Ekrani i kuzhinës: http://192.168.1.20:3000/keuken.
• Ekrani i klientit (i kthyer nga klienti, opsional): http://192.168.1.20:3000/klantscherm, shih Ekrani i klientit.
• Ekranet e gjejnë vetë serverin e arkës (e njëjta adresë, porta 4000).

Ekrani i klientit

Një ekran në arkë që është i kthyer nga klienti. Klienti sheh përafërsisht çfarë është porositur dhe shumë qartë shumën dhe si paguhet. Nuk ka komanda: ekrani thjesht ndjek atë që bën arka. Si parazgjedhje joaktiv; aktivizohet te Cilësimet → Lokali → Ekrani i klientit. Në një kompjuter arke me dy ekrane, arka e aktivizon vetë herën e parë; nëse e çaktivizon më pas, mbetet joaktiv. Pa ekran klienti (joaktiv, ose nuk ka të lidhur) gjithçka funksionon saktësisht si gjithmonë: arka e dërgon pamjen në sfond dhe personeli nuk e vë re kurrë një gabim ose një ekran që mungon.

Çfarë sheh klienti:

• Pushim (askush nuk po paguan): emri i lokalit dhe një tekst mirëseardhjeje sipas dëshirës (Cilësimet → Lokali; bosh = "Mirë se vini").
• Porosia: produktet me sasinë dhe shumën (rreshtat e njëjtë bashkë, një menu si një rresht me pjesët me shkrim të vogël poshtë, zbritja si një rresht), dhe totali me shkrim të madh. Shumat e paguara tashmë te pagesa e ndarë shfaqen poshtë. Me Cilësimet → Lokali → Fotot e produkteve → në ekranin e klientit shfaqet një foto e vogël pranë çdo produkti.
• Pagesa: mënyra e pagesës (Kartë, Para në dorë, Kartë dhuratë), bakshishi dhe me shkrim të madh Për t'u paguar. Para në dorë: sa jep klienti dhe sa kusur merr, sapo kjo të jetë futur në arkë. Kartë: "Ndiq udhëzimet në terminalin e pagesës".
• Faleminderit: pas pagesës për disa sekonda "Faleminderit!" me shumën e paguar (para në dorë: kusuri i klientit), pastaj përsëri ekrani i pushimit.

Lidhja, në dy mënyra (të dyja vendosen në vetë pajisjen):

• Monitor i dytë te kompjuteri i arkës (Windows, Linux/Raspberry Pi, macOS): automatikisht. Gjatë hyrjes dhe pas instalimit, arka e hap ekranin e klientit në ekran të plotë në ekranin më të vogël që nuk është ekrani kryesor (me madhësi të njëjtë, në atë më në të djathtë); në Windows gjithmonë në një ekran tjetër nga ai i arkës (arka ndodhet në ekranin me prekje dhe gjithashtu hapet vetë gjatë nisjes). Madhësia dhe pozicioni vijnë nga sistemi, ndaj funksionon çdo format. Pa ekran të dytë nuk ndodh asgjë. Në Windows, ekrani i klientit i mbyllur kthehet vetë; në Linux dhe macOS, shkurtorja HorecaPOS ekrani i klientit në meny e rregullon përsëri. Në Windows hapet në modalitetin kiosk të Chrome (ose Edge): në ekran të plotë, pa shiritin e titullit dhe pa shiritin e detyrave (mbyllet me Alt+F4). Ai ndjek arkën në të njëjtin kompjuter pa kod lidhjeje.
  • Në çdo shfletues, shtypja e gjatë nuk hap askund menynë e shfletuesit dhe nuk shfaqet asnjë pyetje për ta përkthyer faqen.
  • Arka e mbyllur = ekrani i klientit i mbyllur. Nëse softueri i arkës ndalon (Rinis, një përditësim, arka e ndalur ose e hequr), edhe ekrani i klientit mbyllet pas pak më shumë se 10 sekondash; kur arka punon sërish, ai kthehet vetë. Në Windows mbyllet edhe nëse mbyll vetëm dritaren e arkës. Nën Wayland (Linux) arka nuk mund ta mbyllë vetë dritaren.
  • Ekrani i klientit u mbyll gabimisht? Në Windows ai kthehet vetë pas disa sekondash, për sa kohë që arka është e hapur dhe ekrani i dytë është i lidhur.
  • Gjithmonë vetëm një ekran i klientit. Në Windows ekrani i klientit shfaqet vetëm në modalitetin kiosk në ekranin e dytë. Një ekran i klientit në dritaren e arkës (p.sh. i rikthyer nga Edge pas një ndërprerjeje të energjisë, ose i hapur me butonin në arkë) mbyllet vetë brenda pak sekondash; vendin e tij e zë atëherë ekrani i duhur i klientit.
  • Askush i identifikuar = vetëm mirëseardhja. Nëse arka është në ekranin e kodit PIN (edhe pas një rinisjeje ose daljeje), ekrani i klientit shfaq vetëm tekstin e mirëseardhjes, kurrë faturën e mëparshme.
  • Në Windows hapja automatike mund të çaktivizohet edhe me kutinë e zgjedhjes Ekrani i klientit automatikisht ... në instalues.
  • Në Linux arka e zhvendos dritaren me wmctrl (vjen me paketën). Nën Wayland (p.sh. Raspberry Pi OS me labwc) kjo nuk është e mundur: atëherë vendoseni vetë një herë ekranin e klientit në ekranin e dytë (shfletuesi e mban mend), ose zgjidhni X11 te raspi-config. Në macOS, herën e parë Mac kërkon leje te Qasshmëria.
  • Manualisht: Cilësimet → Lokali → Ekrani i klientit → Hap ekranin e klientit (monitori i dytë). Në Chrome dhe Edge (edhe në Chromebook) butoni e vendos menjëherë dritaren në ekranin e klientit (herën e parë shfletuesi kërkon leje); një klikim në ekranin e klientit e kalon në ekran të plotë. Në shfletues të tjerë: tërhiqeni dritaren dhe shtypni F11.
• Arkë Android me ekran klienti të integruar (p.sh. Sunmi D2/T2) ose një monitor përmes HDMI/USB-C: gjithashtu automatikisht. Sapo aplikacioni të jetë në arkë, ekrani i klientit shfaqet në ekranin e dytë; lidhja dhe shkëputja funksionojnë menjëherë.
• Sunmi T1 mini / T2 mini me ekranin e vogël të tekstit (2 rreshta): aplikacioni shfaq automatikisht shumën aty: Totali, Për t'u paguar, me para në dorë Kusuri, pas pagesës Faleminderit! dhe në pritje emrin e lokalit. Ekrani i klientit duhet të jetë i ndezur.
• iPad (ekrani i punës) me një ekran të jashtëm përmes HDMI/USB-C ose AirPlay: aplikacioni e vendos automatikisht ekranin e klientit në atë ekran (i përgatitur; aplikacioni iOS nuk është publikuar ende).
• Chromebook: si ekran pune në Chrome, butoni Hap ekranin e klientit (monitori i dytë) funksionon si më sipër. Në aplikacionin Android ekrani i klientit shfaqet automatikisht në ekranin e dytë sapo ChromeOS ta kalojë atë ekran te aplikacionet Android; nëse nuk e bën, përdorni një pajisje të veçantë me kod lidhjeje.
• Pajisje më vete (tablet ose kompjuter tjetër pranë arkës): hap http://<kassaserver>:3000/klantscherm. Ekrani tregon poshtë djathtas një kod lidhjeje me 6 karaktere. Fute në arkë te Cilësimet → Lokali → Ekrani i klientit → Lidh. Shkëput e kthen ekranin te kodi i lidhjes. Lidhja ruhet për çdo arkë (në shfletuesin e asaj arke), kështu që çdo arkë mund të ketë ekranin e vet të klientit.

Ekrani i klientit nuk kërkon kod PIN (nuk ka asgjë për të komanduar) dhe tregon vetëm pamjen e arkës me të cilën është lidhur. Pamja mbahet vetëm në kujtesën e serverit të arkës; pas një rinisjeje ekrani është bosh deri në ndryshimin e radhës. Cilësimi (aktiv/joaktiv dhe teksti i mirëseardhjes) përfshihet në kopjen rezervë dhe në Import/eksport (Cilësime të tjera).

Faturë digjitale me QR (opsionale)

Si parazgjedhje joaktiv. Aktivizohet te Cilësimet → Biznesi → Kuzhina dhe ekrani i klientit → Faturë digjitale (zgjedhja shfaqet kur ekrani i klientit është ruajtur si aktiv). Pas pagesës, te Faleminderit! shfaqet një kod QR; ai qëndron atëherë 45 sekonda në vend të disa sekondave. Klienti e skanon me telefonin e vet dhe sheh faturën, saktësisht si fatura në letër (i njëjti tekst, te një arkë belge edhe me bllokun FDM). Në telefon mund ta printojë faturën, ta ruajë si PDF ose ta shkarkojë si skedar teksti.

• Kjo kalon përmes portalit të menaxhimit: https://kassa.<portaal>/__bon/<kassa>/<sleutel>. Arka duhet pra të jetë e lidhur me portalin; përndryshe nuk shfaqet kod QR dhe nuk ndryshon asgjë.
• Çelësi është i rastësishëm dhe i pamundur për t'u gjetur, dhe vlen 30 ditë. Pas kësaj arka e fshin vetë. Portali nuk ruan asgjë.
• Funksionon me një monitor të dytë dhe me një ekran klienti të veçantë. Fatura në letër dhe fatura me e-mail vazhdojnë të funksionojnë normalisht.

Ekrani i klientit në pritje: shfaqje diapozitivash (opsionale)

Si parazgjedhje joaktiv. Aktivizohet te Cilësimet → Biznesi → Kuzhina dhe ekrani i klientit → Ekrani i klientit në pritje. Kur nuk ka llogari në ekranin e klientit, diapozitivat ndërrohen (si parazgjedhje çdo 8 sekonda, e rregullueshme nga 4 deri në 60):

• Fushatat: happy hour-et (nëse happy hour është aktiv), me zbritjen, ditët dhe oraret dhe produktet ose grupet; ato që janë tani dalin të parat, me "Tani!".
• Produktet e veçuara (deri në 12, për shembull të reja në menu), me çmim dhe (nëse fotot e produkteve në ekranin e klientit janë aktive) foton. Një produkt që ka mbaruar ekrani e kapërcen.
• Karta e pikëve: pikë për euro, shpërblimi dhe kartat me vula (vetëm nëse karta e besnikërisë është aktive).
• Tekste të veta: deri në 5, secili me diapozitivin e vet (për shembull "Nga e premtja e re: menuja jonë e verës").

Pa diapozitiva, ekrani i klientit shfaq ekranin e mirëseardhjes, si gjithmonë.

Happy hour

Si parazgjedhje joaktiv. Aktivizohet te Cilësimet → Lokali → Përdor happy hour; pastaj shfaqet skeda Cilësimet → Happy hour.

• Për çdo happy hour: emri (shfaqet te fatura), ditët, nga–deri (mund të kalojë mesnatën, p.sh. 23:00–01:00), zbritje në % ose një çmim fiks, dhe për cilat kategori produktesh dhe/ose produkte të veçanta.
• Brenda atij intervali arka llogarit automatikisht çmimin e happy hour kur shtohen artikujt (kurrë më shtrenjtë se normalisht; me çmim fiks opsionet e zgjedhjes shtohen si zakonisht). Në butonin e produktit çmimi i vjetër shfaqet i vijëzuar me çmimin e ri dhe HH; në porosi dhe te fatura shfaqet emri i happy hour. Artikujt e shtuar tashmë e mbajnë çmimin e tyre.
• Oferta e ditës: shëno Gjithë ditën (00:00–24:00) dhe zgjidh ditën (ditët), p.sh. çdo të martë brinjë derri me çmim fiks.
• Sezoni: shëno Vetëm në një sezon (çdo vit) dhe zgjidh nga dhe deri më (dita dhe muaji, p.sh. nga 1 qershor deri më 31 gusht; mund të kalojë edhe ndërrimin e vitit, p.sh. nga 1 dhjetor deri më 28 shkurt). Jashtë sezonit happy hour nuk vlen.
• Ndryshimet regjistrohen në regjistër.

Periudhat e menusë dhe sezonet

Si parazgjedhje joaktiv. Aktivizohet te Cilësimet → Biznesi → Periudhat e menusë dhe mënyra e porosisë → Asortimenti sipas periudhave të menusë dhe sezonit; pastaj shfaqet skeda Cilësimet → Periudhat e menusë. Nëse e çaktivizon, të gjitha produktet shiten sërish gjithmonë dhe periudhat e menusë ruhen.

• Për çdo periudhë të menusë: emri (p.sh. Mëngjesi, Dreka, Darka, Menuja e verës), ditët, nga–deri (mund të kalojë mesnatën; Gjithë ditën = 00:00–24:00), sipas dëshirës një sezon (çdo vit, dita dhe muaji), dhe cilat kategori dhe/ose produkte të veçanta bëjnë pjesë.
• Produktet dhe kategoritë që janë në një ose më shumë periudha të menusë shiten vetëm kur është në vazhdim njëra prej këtyre periudhave; ajo që nuk është në asnjë periudhë, shitet gjithmonë. Ekrani i porosive tregon vetëm atë që shitet tani dhe ndërrohet vetë kur një periudhë fillon ose mbaron; serveri refuzon pjesën tjetër ("nuk shitet tani, vetëm te Mëngjesi").
• Dyqani online tregon dhe llogarit të njëjtin asortiment (në momentin e porosisë).
• Një çmim tjetër në një ditë ose në një sezon është një happy hour (oferta e ditës, shih më lart).
• Menu për çdo vendndodhje: çdo arkë (pikë shitjeje) ka produktet, periudhat e menusë dhe çmimet e veta.
• Ndryshimet regjistrohen në regjistër.

Asortimenti dhe çmimet sipas mënyrës së porosisë

Si parazgjedhje joaktiv. Aktivizohet te Cilësimet → Biznesi → Periudhat e menusë dhe mënyra e porosisë → Asortimenti dhe çmimet sipas mënyrës së porosisë. Nëse e çaktivizon, kudo vlen sërish çmimi i zakonshëm dhe gjithçka shitet kudo; çmimet e futura ruhen.

• Te Cilësimet → Produktet për çdo produkt: Çmimi për të marrë dhe Çmimi me dërgesë (bosh = çmimi i zakonshëm) dhe Shitet për (në lokal, për të marrë, dërgesë; të paktën një). Edhe kategoria ka Shitet për, për të gjitha produktet e saj.
• Për një porosi për të marrë ose me dërgesë, ekrani i porosive tregon çmimin e asaj mënyre porosie dhe vetëm atë që shitet aty; serveri llogarit atë çmim dhe refuzon pjesën tjetër. Happy hour, menutë dhe opsionet llogariten me atë çmim.
• Norma e TVSH-së për marrje (te produkti) është e pavarur nga kjo, si gjithmonë.
• Për marrje dhe dërgesë, dyqani online tregon çmimet dhe produktet e asaj zgjedhjeje (kur ndërron, faqja e menusë ringarkohet), kurse në tavolinë ato për në lokal.
• Eksporti dhe importi i konfigurimit (Cilësimet → Import/eksport) përfshijnë çmimet sipas mënyrës së porosisë, "shitet për", periudhat e menusë dhe sezonin e happy hours.

Menutë

Si parazgjedhje joaktiv. Aktivizohet te Cilësimet → Lokali → Përdor menutë.

• Një menu është një produkt i zakonshëm (me çmimin e menusë) për të cilin te Cilësimet → Produktet → (produkti) → Menu vendos pjesët:
  • fikse: gjithmonë ky produkt (p.sh. "Pije: Vera e shtëpisë");
  • sipas zgjedhjes: zgjidh 1 (ose më shumë) nga një kategori produktesh, sipas dëshirës të kufizuar në produkte të caktuara (p.sh. "Pjata kryesore: zgjidh 1 nga Pjatat kryesore").
  • Për çdo pjesë radha e shërbimit (1 = menjëherë, 2/3 = pret thirrjen).
• Kur shton menunë, zgjedh pjatat për çdo pjesë. Për çdo pjatë (edhe ato fikse) mund të zgjedhësh opsionet e zgjedhjes si te një produkt i veçantë (shkalla e pjekjes, djathë shtesë; opsionet e detyrueshme duhet të zgjidhen) dhe një shënim. Çmimi shtesë i opsioneve shtohet mbi çmimin e menusë. Menuja shfaqet si një rresht me pjatat (dhe opsionet e tyre) poshtë.
• Pjatat shkojnë si rreshta të veçantë në kuzhinë/bar (fleta e kuzhinës dhe ekrani i kuzhinës), në radhën e tyre të shërbimit. Vetë rreshti i menusë jo.
• Për TVSH-në, çmimi i menusë ndahet mes pjesëve në proporcion me çmimin e tyre normal, që ushqimi dhe pijet të kenë secili normën e duhur. Te fatura shfaqet menuja me çmimin total dhe pjatat poshtë.
• Nëse vetë menuja ka opsione zgjedhjeje (p.sh. madhësia), i zgjedh ato lart në dritaren e menusë. Ato shfaqen pranë rreshtit të menusë te fatura, dhe pranë çdo pjate të menusë në fletën e kuzhinës dhe në ekranin e kuzhinës si "(menu)".
• Heqja/stornimi bëhet për të gjithë menunë (prek rreshtin e menusë).
• Ndaj / zhvendos: zgjidh rreshtin e menusë; pjatat shkojnë bashkë me të. Me 2× të njëjtën menu mund të zhvendosësh edhe 1 (koka dhe pjatat ndahen).
• Pa lidhje mund t'i shtosh menutë normalisht; ato ruhen në tablet dhe dërgohen sapo lidhja të kthehet (njësoj si produktet e veçanta).
• Happy hour mund të vlejë edhe për një menu.

Recetat dhe kostoja (Apicbase)

Lidhje me Apicbase (receta, kosto, stok dhe blerje) përmes Generic POS API të Apicbase (si parazgjedhje joaktiv, çdo pjesë aktivizohet ose çaktivizohet veçmas). Konfigurohet te Cilësimet → Recetat (e drejta Konfigurimi i biznesit, pagesave dhe printerëve). Arka komunikon vetë me Apicbase (vetëm trafik dalës, nuk nevojitet portali).

1. Lidhja (gjithçka plotësohet nga administratori), në një nga tri mënyrat:
   • Ngjit token-in: në Apicbase Library Settings → API Settings → New token → Service Account Token (scopes accounts, library, sales); ngjit access token dhe refresh token;
   • Hyr me API-app të vetë biznesit (client-id dhe sekreti nga API Settings): Hyr në Apicbase dhe ngjit kodin që Apicbase tregon më pas;
   • Një token të skaduar (pas 7 ditësh) arka e rinovon vetë me refresh token.
2. Outlet: Merr outlet-et dhe zgjidh outlet-in e këtij biznesi. Arka vendos atje POS-in në Generic POS API me location-id të vetin (mund të plotësohet; si parazgjedhje HORECAPOS-…, unik për çdo arkë).
3. Aktiv, me kutiza:
   • Produktet, grupet dhe opsionet te Apicbase: grupet e produkteve, produktet (PLU = numri PLU i produktit, përndryshe kodi, përndryshe id), opsionet si modifiers, me çmim dhe TVSH. Automatikisht pas çdo ndryshimi (pas një minute) dhe çdo ditë. Në Apicbase pastaj lidh çdo produkt të arkës me një recetë;
   • Çdo faturë e paguar te Apicbase: më të vjetrat së pari, jo më shumë se 100 njëherësh, brenda një çerek ore pas pagesës (dhe çdo 5 minuta). Zbritja shpërndahet mbi rreshtat; shumat e hapura, tarifa e paketimit njëpërdorimshëm dhe depozita janë produkte më vete në Apicbase; produktet e peshuara si 1 copë me shumën totale. Nëse dështon, arka ndalon (Apicbase i do faturat sipas radhës) dhe provon përsëri më vonë: pagesa nuk ndikohet. Kur e aktivizon zgjedh nga cila ditë (si parazgjedhje nga tani);
   • Merr koston për porcion (çdo 6 orë): për çdo recetë të lidhur food cost (përbërësit dhe humbjet), me kostot e personelit, çmimin e shitjes dhe marzhin sipas Apicbase. Llogaritet me furnitorin më të lirë, çmimin e porositur së fundi ose vlerën mesatare të stokut;
   • Merr çmimin e shitjes nga Apicbase (si parazgjedhje joaktive): vendos çmimin e shitjes së produkteve të lidhura në arkë (shënohet në regjistër).
4. Poshtë: Kostoja për produkt me koston, koston me personelin, çmimin në arkë, koston % dhe marzhin. Butonat Dërgo katalogun tani, Dërgo faturat tani dhe Merr kostot tani.

Kodi: apps/pos-server/src/lib/apicbase.ts, routes/apicbase.ts; ekrani Apicbase.tsx. Regjistri: Apicbase. Kusht: moduli API i Apicbase. Për aplikacionin e Pin Voordeel për të gjithë klientët: partneritet dhe certifikim te Apicbase (shih backlog). Dokumentacioni: https://developers.apicbase.com/docs/generic-pos-api-guide

Softuer hoteli: në dhomë

Për një restorant ose bar pranë një hoteli: llogaria vendoset në dhomën e një mysafiri. Si parazgjedhje joaktiv: Cilësimet → Hotel (e drejta Konfigurimi i biznesit, pagesave dhe printerëve).

• Një listë me gjithë softuerin e hoteleve (Softueri hotelier i hotelit). Lidhje të integruara:
  • Mews (Connector API: client token dhe access token, shërbimi i restorantit dhe për çdo normë TVSH-je kodi i TVSH-së në Mews), apaleo (aplikacion i vetin me client ID dhe client secret, property ID; për çdo normë TVSH-je sipas nevojës lloji i TVSH-së) dhe Cloudbeds (çelës API dhe property ID), secili me mjedis testimi dhe mjedis real;
  • Oracle OPERA Cloud (OHIP), protel (protel I/O), RoomRaccoon, Booking Experts, Amadeus (XMLPOS), VIPS, Stayntouch, Clock PMS+, Guestline (Rezlynx), Hotelogix, eviivo, Little Hotelier, Shiji dhe Infor HMS (Databridge). Pas zgjedhjes shfaqen pikërisht fushat që i përkasin atij softueri hoteli (çelësat, ID-ja e hotelit, sipas nevojës adresa e API-së së tyre dhe kodi i tyre për çdo normë TVSH-je), me një shpjegim të shkurtër se çfarë t'i kërkoni furnizuesit. Këto lidhje janë ndërtuar sipas dokumentacionit të furnizuesve; kërkojini furnizuesit ta konfirmojë lidhjen dhe provoni fillimisht me Testo lidhjen dhe një faturë;
  • një demo (katër suita, dhomat 4 deri 7) për ta provuar;
  • Sirvoy, si lidhje e pjesshme dhe vetëm me Sirvoy Pro. Sirvoy nuk ka API që një arkë të shtojë diçka në një rezervim, as me skedar (importi CSV krijon vetëm rezervime të reja). Kështu arka i njeh mysafirët (dhoma, emri, mbërritja, largimi): kërkimi te Në dhomë dhe vetëshërbimi në kiosk dhe në dyqanin online funksionojnë normalisht. Fatura nuk shkon vetë në Sirvoy: pas pagesës ajo shfaqet te Cilësimet → Hotel nën Për t'u futur në Sirvoy, me dhomën, mysafirin, numrin e faturës dhe shumën sipas normës së TVSH-së. Hoteli e fut me dorë si ekstra në rezervim dhe klikon Është futur (kthim me Ende jo). Nevojitet:
    1. mundësisht një arkë e lidhur me portalin e menaxhimit: atëherë adresa kalon përmes portalit (https://<portaal>/hotel/<kassa-id>/sirvoy?sleutel=...) dhe në hotel nuk duhet hapur asnjë port. Përndryshe vetë arka duhet të jetë e arritshme nga interneti përmes https (domen i vetin me certifikatë ose përcjellje portash; Sirvoy kërkon TLS 1.2 ose më të lartë) dhe e fut atë adresë;
    2. Adresa shfaqet vetëm një herë; arka ruan vetëm hash-in. Krijimi i një adrese të re = e vjetra nuk funksionon më;

Sirvoy dërgon diçka vetëm kur ndryshon një rezervim: rezervimet nga para lidhjes arka i njeh vetëm pas një ndryshimi në Sirvoy. Mesazhet mund të vijnë të përziera; një mesazh më i vjetër (generatedAt) se ai që ka arka tashmë anashkalohet. Në hotel = jo i anuluar dhe pa check-out, me check-in ose mbërritje sot a më herët, dhe largim sot a më vonë. Testo lidhjen tregon sa rezervime kanë ardhur.

I gjithë softueri i hoteleve shitet në Holandë dhe/ose Belgjikë. Testo lidhjen kontrollon të dhënat. Kodi për çdo lidhje: apps/pos-server/src/lib/pms/<naam>.ts.

• Vetëshërbim (si parazgjedhje joaktiv): mysafiri i hotelit e vendos vetë porosinë në dhomën e tij, në kiosk dhe/ose në dyqanin online (marrje dhe dërgesë, jo në porosinë në tavolinë). Ai shkruan numrin e dhomës dhe mbiemrin; arka kontrollon në softuerin e hotelit nëse ky mysafir po qëndron tani në atë dhomë. Me një maksimum për porosi (si parazgjedhje € 150), dhe pas 5 përpjekjesh të gabuara brenda një çerek ore duhet të shkojë fillimisht te recepsioni. Mesazhi nuk tregon kurrë se kush qëndron në një dhomë.
• Paguaj: kur lidhja është aktive, ekziston mënyra e pagesës Në dhomë. Kërko mysafirin me emër ose numër dhome (vetëm mysafirët që qëndrojnë tani në hotel) dhe prek Vendos në dhomën .... Arka e regjistron faturën sipas normës së TVSH-së në llogarinë e hotelit të mysafirit; mysafiri paguan në largim.
• Belgjikë: nëse porosia është tashmë në tavolinë te kutia e zezë, ajo kalon fillimisht nga tavolina në dhomë (signCostCenterChange te ROOM, UC4101); fatura shkon si kredi dhome (ROOM_CREDIT) te kutia e zezë.
• Nëse regjistrimi në softuerin e hotelit nuk arrihet (pa internet), shitja ekziston gjithsesi dhe regjistrimi shfaqet si Dështoi te Cilësimet → Hotel, me Përsëri.
• Raporte dhe kontabilitet: Në dhomë (hotel) është mënyrë pagese më vete në raportin X dhe Z, në pasqyrën ditore dhe në skedarin e auditimit (XAA).

Kodi: apps/pos-server/src/lib/hotel.ts, routes/hotel.ts, lidhjet në lib/pms/, katalogu packages/shared/src/hotelcatalogus.ts; ekrani Hotel.tsx. Regjistri: Hotel. Të dhënat sekrete (tokenat) janë vetëm në bazën e të dhënave, kurrë në ekran.

Menaxhimi i verërave me Vinify

Cilësimet → Menaxhimi i verërave (si parazgjedhje joaktiv; çaktivizimi ruan gjithçka). Vinify mban bodrumin e verërave, kartën e verërave dhe stokun dhe është burimi kryesor i verërave. Sipas kërkesave POS të Vinify, arka ofron një API me të cilin Vinify:

Identifikohet, me të tria mënyrat që njeh Vinify (administratori aktivizon cilën):

1. ID API dhe çelës API (X-Api-Id dhe X-Api-Key, ose Authorization: Bearer <id>:<sleutel>);
2. Çelës API dhe secret API me nënshkrim: X-Api-Key, X-Timestamp dhe X-Signature = hex HMAC-SHA256(secret, <timestamp>\n<METHODE>\n<pad met query>\n<sha256 van de body>), jo më i vjetër se 5 minuta.

Çelësin dhe secret-in i krijon arka (shfaqen një herë); ekranet shohin vetëm nëse janë plotësuar. I arritshëm përmes portalit në https://<portaal>/vinify/<kassa-id>/... (pa port të hapur në lokal; adresa është te Cilësimet → Menaxhimi i verërave). Cilat produkte janë verëra: ato që krijon Vinify, plus grupet që shënoni. Nëse Vinify jep një adresë për shitjet, arka i dërgon edhe vetë (push, me token): pas çdo fature të paguar dhe çdo 5 minuta atë që nuk ka arritur ende. Vinify aktivizon lidhjen me HorecaPOS (hello@vinify.no). Gjithçka në regjistër. Mos e ngatërroni me Vinify.nl, një dyqan online verërash: ai është te furnitorët (Porositë te furnitorët).

Futje e shpejtë e adresës me kodin postar dhe numrin e shtëpisë

Aktivizohet te Cilësimet → Biznesi → Futje e shpejtë e adresës (si parazgjedhje joaktiv; vetëm për një lokal në Holandë). Shkruaj kodin postar dhe numrin e shtëpisë (edhe me shkronjë ose shtesë, p.sh. 12A ose 12-1) dhe prek Kërko adresën: rruga, numri i shtëpisë, kodi postar dhe qyteti plotësohen. Nëse në atë numër ka disa adresa (12, 12A, 12B), zgjedh të saktën. Pastaj mund të ndryshosh gjithçka vetë.

• Te të dhënat e biznesit (Cilësimet → Biznesi, mbi adresën).
• Te një klient i kartës së besnikërisë: në arkë te një klient i ri dhe te Raporti → Klientët. Klientët marrin për këtë një adresë (opsionale): rruga dhe numri i shtëpisë, kodi postar dhe qyteti.
• Adresat vijnë nga Locatieserver i PDOK, falas (adresat zyrtare të Holandës, BAG): s'nevojitet llogari apo çelës, por nevojitet internet. Pa internet ose për një adresë belge, adresën e shkruan thjesht vetë.

Njoftim për një version të ri

Aktivizohet te Cilësimet → Lokali → Njoftimi për përditësim (si parazgjedhje joaktiv).

• Arka u përditësua: nëse serveri i arkës është përditësuar ndërkohë që një tablet ka ende ekranet e vjetra të hapura, lart shfaqet "Arka u përditësua (versioni …)" me Rifresko. Tableti kontrollon çdo 5 minuta, kur ekrani bëhet përsëri i dukshëm dhe pas një rinisjeje të serverit.
• Përditësim i disponueshëm: nëse arka është e lidhur me portalin e menaxhimit (PORTAAL_URL/PORTAAL_SLEUTEL) dhe atje është plotësuar NIEUWSTE_VERSIE, kush ka të drejtë të menaxhojë cilësimet sheh "Përditësim i disponueshëm: versioni …" (me shpjegimin nga UPDATE_NOTITIE). Më vonë e fsheh njoftimin në atë tablet derisa të ketë përsëri një version më të ri. Përditësimi bëhet si gjithmonë me scripts\windows\update.cmd (shih Përditësimi).

Platformat e rezervimeve

Rezervimet nga TheFork, Formitable, Zenchef, Resengo (vetëm Belgjikë), OpenTable (vetëm Holandë), PlanPanther, RestoManager dhe Aqqo (vetëm Holandë) vijnë automatikisht në arkë dhe në planimetri. Aktivizohet te Cilësimet → Platformat e rezervimeve (si parazgjedhje joaktive). E mundur vetëm kur Rezervimet janë aktive.

• Vendi i lokalit: mund të zgjidhni vetëm platforma që funksionojnë në vendin e lokalit (Resengo vetëm në Belgjikë, OpenTable dhe Aqqo vetëm në Holandë). Serveri e kontrollon edhe këtë.
• Disa platforma njëkohësisht: mund të lidhni disa platforma krah njëra-tjetrës, për shembull TheFork dhe Formitable. Dy platforma nuk marrin kurrë të njëjtën tavolinë në të njëjtin interval kohor; rezervimi i dytë vjen atëherë pa tavolinë.
• + Lidh platformë: zgjidhni platformën dhe plotësoni të dhënat. Sekretet (client secret, çelësi i kthimit) nuk shfaqen kurrë në pasqyrë; bosh = ruaj, Pastro = fshi.
• TheFork (API publike B2B): Restaurant-UUID, Client ID dhe Client Secret (kërkohen te TheFork). Nëse arka anulon, anulon edhe te TheFork.
• Formitable, Zenchef, Resengo, OpenTable, PlanPanther, RestoManager, Aqqo: API e tyre është vetëm për partnerë ose nuk është publike (PlanPanther, RestoManager dhe Aqqo: lidhja me arkën bëhet në marrëveshje me ta). Ngjarjet e Formitable (booking.created, .changed, .canceled, .checkin, .checkout) njihen.
• Në planimetri: nëse një tavolinë në arkë ka të njëjtin emër si tavolina e platformës dhe është e lirë në atë interval, rezervimi shkon te ajo tavolinë; përndryshe pa tavolinë (zgjidheni në mbërritje). Një rezervim që vjen përsëri përditësohet, nuk dyfishohet. Në pasqyrë shkruhet "përmes TheFork".
• Statusi: nëse platforma anulon ose njofton një no-show, arka e merr përsipër. Çfarë është shënuar si mbërritur në arkë, mbetet mbërritur.
• Njoftimi i kthimit (no-show kthehen): vendosni një adresë njoftimi kthimi (për shembull të shërbimit tuaj të integrimit). Arka dërgon çdo ndryshim nga arka (mbërriti, no-show, anuluar, paguar me shumë) si JSON: { platform, id, status, statusEn, bedrag, valuta, tafel, tijdstip, gemeldOp } (shuma në cent, vetëm kur paguhet), me Authorization: Bearer <terugmeld-sleutel> nëse e keni vendosur. Nëse dështon, arka provon përsëri çdo minutë dhe gabimi shfaqet te platforma. Çfarë vjen nga vetë platforma nuk kthehet.
• Rezervim provë: krijon një rezervim siç do ta dërgonte platforma.
• Fshi: lidhja dhe çelësi fshihen; rezervimet mbeten.
• Të gjitha ndryshimet janë në regjistër (pa sekrete).

Programe besnikërie dhe vlerësime

Dy çelësa të veçantë te Cilësimet → Pikë dhe vlerësime (të dyja si parazgjedhje joaktive, atëherë nuk duket asgjë askund). Nëse i çaktivizon, cilësimet dhe ajo që ka ndodhur tashmë ruhen.

Program besnikërie i një platforme tjetër: mysafiri mbledh pikë te Joyn (Belgjikë) dhe/ose Piggy (Leat; Holandë dhe Belgjikë). Kjo është e pavarur nga karta e besnikërisë e vetë arkës; ajo mund të jetë aktive njëkohësisht.

• Disa njëkohësisht: në Belgjikë Piggy dhe Joyn mund të jenë aktive së bashku, secili me të dhënat e veta (zgjidhni platformën, plotësoni, Ruaj; Ndrysho dhe Fshi për çdo platformë). Mysafiri merr për çdo program kodin e vet QR në faturë, lidhjen e vet në faturën e dërguar me email dhe butonin e vet në dyqanin online, dhe mbledh pikë në çdo program një herë për porosi. Ajo që ishte konfiguruar tashmë vazhdon të funksionojë.
• Kod QR në faturë: pas pagesës, poshtë faturës ka një kod QR me "Skano dhe mblidh pikë te ...". Në faturën me email ka një lidhje, dhe në dyqanin online (marrje dhe dërgesë) një buton në faqen e porosisë dhe një lidhje në emailin e konfirmimit. Një porosi jep pikë vetëm një herë: fatura, emaili dhe dyqani online përdorin të njëjtin kod unik (numrin e porosisë). "Kod QR në faturën e printuar" mund ta çaktivizosh; emaili dhe dyqani online e marrin ende lidhjen.
• Piggy, mënyra "Kod QR dhe lidhje": plotëso adresën e portalit tënd Piggy të klientëve, Shop UUID dhe Account secret (Piggy Business Dashboard). Funksionon pa internet: arka e krijon vetë lidhjen.
• Piggy, mënyra "Kredito menjëherë": plotëso edhe një personal access token (Piggy → Marketplace → Private App). Nëse arka e dërgon faturën me email dhe mysafiri me atë adresë është tashmë anëtar, arka i krediton pikët menjëherë; në faturë shkruhet atëherë "Pikët u kredituan te Piggy". Arka nuk krijon kurrë anëtar të ri; jo anëtar (ose pa adresë emaili) = kodi QR.
• Joyn, mënyra "Kod QR dhe lidhje": me partner key, shop reference dhe shared secret të Joyn (kërkohen te api-integration@joyn.be). Funksionon pa internet. Kodi QR është i vlefshëm 2 orë.
• Joyn, mënyra "Përmes API-së": me shop API key (aktivizo lidhjen në portalin e tregtarëve të Joyn). Gjatë pagesës arka i kërkon Joyn një kod pikësh. Shpenzimi i pikëve bëhet si gjithmonë në Joyn-iPad.
• Krijo lidhje provë: kontrollon nëse të dhënat janë të sakta (një lidhje prej € 10; hape vetëm për ta parë).
• Mund të zgjidhen vetëm platformat e vendit të biznesit; të dhënat sekrete ruhen vetëm në bazën e të dhënave dhe nuk shfaqen kurrë në ekran (lëre bosh = mbaj).

Kërko vlerësime: pas vizitës një email me një buton për te Google dhe/ose Trustpilot.

• Disa orë më vonë (e rregullueshme, parazgjedhur 3) mysafiri merr emailin, në gjuhën e faturës.
• Dyqani online: për marrje dhe dërgesë, dyqani online e dërgon vetë emailin, disa orë pasi porosia është mbyllur në arkë, në gjuhën e mysafirit.
• Google: ngjit lidhjen e vlerësimit nga profili yt i biznesit (Google → profili i biznesit → Kërko vlerësime, https://g.page/r/.../review) ose plotëso Place ID.
• Trustpilot: plotëso domenin e biznesit tënd (butoni të çon te trustpilot.com/evaluate/<domein>). Nëse ke te Trustpilot një adresë ftesash (Automatic Feedback Service, ...@invite.trustpilot.com), plotësoje edhe atë: emaili shkon atëherë si kopje e fshehtë (BCC) te Trustpilot, me emrin, adresën e emailit dhe numrin e faturës të padukshme, dhe Trustpilot dërgon vetë ftesën (atëherë pa buton Trustpilot të vetin). Vetëm Trustpilot me adresë ftesash: arka i dërgon email vetëm Trustpilot.
• Jo shumë shpesh: i njëjti mysafir (adresë emaili) merr maksimumi një kërkesë për periudhë (parazgjedhur 90 ditë; 0 = çdo herë). Për këtë arka ruan vetëm një hash të adresës; vetë adresa e emailit fshihet sapo emaili është dërguar (nëse nuk ia del, pas tri përpjekjesh, përndryshe pas 14 ditësh).
• Kod QR në faturë (opsionale): edhe një kod QR për vlerësim poshtë faturës së printuar.
• Shembull i emailit dhe Fshi emailet në pritje (adresat fshihen atëherë menjëherë). Regjistri tregon review_gevraagd me a***@domeni.al.
• Google dhe Trustpilot ndalojnë shpërblimin për një vlerësim dhe pyetjen vetëm të mysafirëve të kënaqur ("review gating"). Prandaj arka i pyet të gjithë njësoj dhe nuk jep asgjë në këmbim të një vlerësimi.
• Leximi dhe përgjigjja e vlerësimeve në arkë: shihni Menaxhimi i vlerësimeve më poshtë.

Lidhja me Mailchimp dhe Klaviyo

Klientët e kartës së besnikërisë në programin tënd të email-it: te Cilësimet → Biznesi → Mailchimp dhe Klaviyo (poshtë marketingut me SMS dhe email). Nuk ka çelës ndezës: pa lidhje me një listë të zgjedhur nuk ndodh asgjë.

• Lidhja: me një çelës API (Mailchimp: Profili → Extras → API keys; Klaviyo: një çelës privat pk_… me të drejta shkrimi për Lists, Profiles, Subscriptions, Events, Campaigns dhe Templates). Sekreti i klientit dhe çelësi nuk shfaqen më kurrë në ekran (lëre bosh = mbaje). Pastaj zgjedh listën (Mailchimp: audience).
• Klientët: kush ka dhënë pëlqim për email shkon në listë (i regjistruar), me emrin, mbiemrin, telefonin, ditëlindjen dhe pikët e besnikërisë (Mailchimp: fusha PUNTEN, të cilën e krijon vetë arka; Klaviyo: vetia punten). Pëlqim i tërhequr, adresë email e ndryshuar ose klient i fshirë: i çregjistruar. Dërgohet sërish vetëm ajo që ka ndryshuar. Me lidhjen, arka (dhe kutia "oferta" në dyqanin online) i kërkon klientit të ri edhe pëlqim për email, dhe ky mund të ndryshohet te Raporti → Klientët, edhe pa marketingun me email të arkës.
• Çregjistrimi: kush çregjistrohet në Mailchimp ose Klaviyo nuk ka më pëlqim për email as në arkë (regjistri: "i çregjistruar në Mailchimp"). Kush është çregjistruar vetë, arka nuk e regjistron sërish.
• Porositë: çdo faturë e paguar e një klienti në listë dërgohet si ngjarje (Mailchimp: bestelling, me shumën, numrin e faturës dhe sasinë; Klaviyo: Placed Order, me vlerën në euro). Me to krijon në programin e email-it email-e automatike, p.sh. pas porosisë së parë ose kur dikush nuk ka ardhur për një muaj. Faturat para zgjedhjes së listës nuk dërgohen.
• Ofertat: te Raporti → Marketing një ofertë mund ta dërgosh edhe përmes Mailchimp ose Klaviyo (shih Marketing me SMS dhe email); arka atëherë krijon atje fushatën dhe e dërgon.
• Përditësimi: çdo 5 minuta, ose me Përditëso tani. Shkëputja: hiqet nga arka; në Mailchimp dhe Klaviyo gjithçka mbetet. Çelësat ruhen në bazën e të dhënave (po në kopjen rezervë, jo në eksportin e konfigurimit).

Kodi: lib/mailinglijst.ts, routes/mailinglijst.ts dhe MailingKoppelingen.tsx.

BI dhe eksport të dhënash

Të dhënat e shitjeve në Power BI, Looker Studio, Excel, Google Sheets, Tableau, Qlik Sense, Metabase, një shërbim BI (për shembull YourBI, BI4Horeca ose Moore DRV) ose data warehouse-in tënd. Aktivizohet te Cilësimet → BI dhe eksport të dhënash (si parazgjedhje joaktiv). Vetëm lexim: përmes një lidhjeje nuk mund të ndryshohet asgjë në arkë. Asnjë e dhënë e klientëve.

• Të dhënat: faturat (edhe faturat kreditore), produktet e shitura (rreshtat e faturës), pagesat, xhiroja për ditë, xhiroja për orë, anulimet, produktet, punonjësit (pa kod PIN) dhe orët e punuara. Shumat në euro me pikë si ndarës dhjetor, oraret sipas orës së lokalit.
• + Lidhje: zgjidh paketën dhe mënyrën. Çdo paketë mbështet një ose më shumë mënyra; mund të kesh disa lidhje njëkohësisht (edhe për të njëjtën paketë).
• Paketa i merr vetë (API): arka jep një herë të vetme një çelës vetëm për lexim. Periudha me ?van=&tot= (VVVV-MM-DD) ose një adresë fikse me ?periode= (vandaag, gisteren, 7d, 30d, 90d, 365d, week, maand, vorigemaand, jaar); maksimumi 366 ditë, maksimumi 200.000 rreshta. Çelësi në Authorization: Bearer, X-Sleutel ose ?sleutel=.
• Përmes portalit: nëse arka është e lidhur me portalin e klientit, e njëjta adresë funksionon edhe nga jashtë lokalit, pa hapur ndonjë portë: https://<portaal>/bi/<kassa-id>/<gegevens>?periode=90d&formaat=csv&sleutel=.... Kështu shërbimi Power BI e rifreskon sipas planifikimit (pa gateway) dhe Google Sheets mund ta marrë me =IMPORTDATA("...") (që është edhe burimi për Looker Studio). Arka e tregon adresën te lidhja.
• Pasqyra e zinxhirit përmes portalit të klientit (disa lokale): një adresë dhe një çelës për të gjitha arkat e tua së bashku. Në çdo arkë që duhet të marrë pjesë aktivizo Pasqyra e zinxhirit përmes portalit të klientit (nën ndërprerësin e BI) dhe krijo një çelës në portalin e klientit te Arkat e mia → BI për të gjitha lokalet e tua. Pastaj: https://<portaal>/bi/keten/<gegevens>?periode=90d&formaat=csv&sleutel=hpk_.... Portali i merr të dhënat nga çdo arkë dhe i bashkon, me kassaId dhe zaak në çdo rresht. Arkat që janë offline ose nuk marrin pjesë shfaqen te ontbrekend (JSON) dhe në kokën X-Ontbrekend. Vetë arka nuk ka nevojë për çelës të vetin për këtë; çaktivizimi në arkë ose në portalin e klientit e ndalon.
• Me një token, ai dërgohet si Authorization: Bearer dhe në X-HorecaPOS-Handtekening ka një nënshkrim (sha256= HMAC i përmbajtjes). Nëse nuk ia del, arka provon përsëri çdo minutë; asgjë nuk dërgohet dy herë. Me nga dërgon edhe fatura më të vjetra.
• Arka jep skedarë: çdo ditë (në një orë të caktuar, për ditën e mëparshme; ditët e humbura plotësohen) ose çdo orë (sot deri tani), si CSV (presje, ose pikëpresje për Excel holandez) ose JSON, në një dosje në kompjuterin e arkës (për shembull një dosje OneDrive ose SharePoint për Power BI ose Excel), në një server FTP(S) ose SFTP ose me e-mail. Emrat e skedarëve: horecapos_<gegevens>_<datum>.csv.
• Dërgo provë (push) dhe Eksporto tani (skedar) te lidhja.
• Shkarko vetë: zgjidh të dhënat, periudhën dhe formatin.
• Shablloni Power BI (.pbit): një raport i gatshëm për Power BI Desktop, me Shkarko shabllonin Power BI te BI dhe eksport të dhënash. Krijoni fillimisht një lidhje API (Power BI). Në model: një tabelë për çdo grup të dhënash me tipet e duhura, një kalendar (vit, muaj, javë, ditë e javës), marrëdhënie (data → kalendari, rreshtat e faturave → produktet, orët e punuara → punonjësit) dhe matje (xhiro me dhe pa TVSH, TVSH, bakshish, fatura, mysafirë, mesatarja për faturë dhe për mysafir, sasia e shitur, xhiro e produkteve, paguar, storno, orët e punuara, xhiro për orë pune). Tri faqe: Përmbledhje (treguesit kryesorë, xhiro sipas ditës, ditës së javës dhe orës, mënyrat e pagesës), Produktet (sipas grupit dhe produktit) dhe Personeli (orët dhe xhiro për punonjës). Përmes portalit, shërbimi Power BI e rifreskon edhe sipas planit.
• Sekretet (token, fjalëkalim, çelës) nuk shfaqen kurrë në përmbledhje; lëre bosh = mbaje, Fshi = hiqe. Gjithçka regjistrohet në regjistër (pa sekrete).

Paga dhe planifikimi

Me Hyrjen dhe daljen nga turni të aktivizuar (Cilësimet → Biznesi), te Cilësimet → Oraret e punës poshtë gjendet Paga dhe planifikimi (e drejta Menaxho cilësimet), në dy blloqe të veçanta. Nëse regjistrimi i turnit është i çaktivizuar, nuk ka orë: atëherë ka vetëm bllokun Planifikimi i personelit (xhiroja, live ose si skedar xhiroje) poshtë te Cilësimet → Kontabiliteti, nën titullin Xhiroja te planifikimi yt:

• Administrimi i pagave (payroll): zgjidh programin e pagave ose (Belgjikë) sekretariatin social, plotëso fushat e tij dhe për çdo punonjës numrin e punonjësit në atë program. Pastaj krijon për një periudhë skedarin me orët e punuara (turne të mbyllura, për punonjës për ditën e hyrjes) dhe xhiron për punonjës (pa TVSH, çfarë ka arkëtuar ai/ajo): gati për Loket.nl (Variabele gegevens, totali për punonjës gjatë periudhës, rreshti i kokës aanslnr;persnr;ploeg;<looncomponent>) dhe SD Worx Belgjikë (Tijdsregistratie, pozicione fikse, për punonjës për ditë), përndryshe lista e orëve (CSV: Data; Numri i punonjësit; Emri; Orët; Xhiroja pa TVSH). Punonjësit pa numër punonjësi nuk hyjnë në skedarin e Loket ose SD Worx; arka njofton se cilët janë.
• Planifikimi i personelit (WFM): zgjidh sistemin e planifikimit. Dërgimi sërish i mbishkruan të dhënat. Përveç kësaj lista e xhiros (CSV për ditë dhe orë, pa dhe me TVSH) dhe për Strobbo skedari Excel për Importeer omzet.
• Vetëm programe që funksionojnë në vendin e biznesit, sipas grupit dhe sipas alfabetit; serveri refuzon një program nga një vend tjetër (400).
• Çelësat dhe tokenët nuk shfaqen kurrë në ekran.
• Prek kontabilitetin: kostot e pagave i regjistron programi i pagave në kontabilitet, xhiron e regjistron arka (Cilësimet → Kontabiliteti). AFAS Payroll dhe Exact Online Loon janë në të njëjtin mjedis si kontabiliteti i AFAS dhe Exact.
• Në kopjen e arkës në portal kjo nuk është e mundur (e bën arka në biznes).
• Për disa programe API-ja nuk është publike ose është vetëm për partnerë (p.sh. Loket, Nmbrs, Nostradamus, Employes, Shyfter, Planday, Eitje): ato janë me kërkesë; deri atëherë skedari. Struktura e SD Worx dhe Strobbo vjen nga dokumentacioni i tyre: kërko që importi i parë të kontrollohet.

Kërkesat ligjore në Belgjikë dhe Holandë

Çfarë kërkon ligji dhe çfarë bën HorecaPOS për këtë (lëre kontabilistin të konfirmojë çfarë vlen për biznesin tënd):

Ligje dhe rregulla

Cilësimet → Ligje dhe rregulla (administratori; asistenti i TVSH-së edhe me të drejtën Menaxho produktet). Gjithçka është joaktive si parazgjedhje; pa këto cilësime arka funksionon si gjithmonë.

• Kontrolli i moshës për alkoolin (18+): te Produktet shënoni Përmban alkool (ose përdorni asistentin e TVSH-së). Në marrje dhe dërgesë me alkool shfaqet "18+" në fletën e punës, në kupon dhe në ekranin e porosive. Në dyqanin online klienti konfirmon vetë se është 18 vjeç ose më i madh (kutia nuk është e shënuar paraprakisht) dhe sheh që mosha kontrollohet në dorëzim.
• Tarifa e paketimit (Holanda): një shumë për çdo produkt (çmime orientuese: gotë € 0,25, enë vakti € 0,50, enë e vogël € 0,05). Në marrje dhe dërgesë arka shton vetë në kupon një rresht "Tarifë paketimi" (me TVSH-në e produktit); ai ndjek automatikisht produktet (baza e të dhënave e mban, edhe pas anulimit, zhvendosjes ose një lloji tjetër porosie) dhe shfaqet veçmas në xhiro. Në lokal nuk ka tarifë. Thuisbezorgd.nl dhe dyqani online aplikojnë tarifën e tyre.
• Depozitë (Holanda): për çdo produkt (€ 0,15 kanaçe/shishe, € 0,25 shishe e madhe), rresht "Depozitë" pa TVSH, vetëm në marrje dhe dërgesë.
• Para në dorë € 3.000 ose më shumë (Holanda, e ndaluar për mallra që nga 1-1-2026): në marrje dhe dërgesë një njoftim gjatë pagesës dhe në automatin e parave; punonjësi mund të konfirmojë (p.sh. catering si shërbim), gjë që regjistrohet në ditar. Ushqimi dhe pija në lokal janë shërbim: pa njoftim.
• Asistenti i TVSH-së: për çdo produkt lloji (vakt, pije joalkoolike, pije alkoolike, ushqim pa përgatitje, tjetër; në fillim një hamendje sipas emrit dhe grupit). Arka tregon normën e saktë në lokal dhe për marrje (Belgjika që nga 1-3-2026: vakte dhe pije freskuese 12%, edhe për marrje; alkool 21%; ushqim pa përgatitje 6%. Holanda: 9% dhe 21%) dhe e zbaton, menjëherë ose nga një datë.
• Planifikimi i ndryshimit të TVSH-së: një produkt në një normë tjetër ose (vetëm Holanda) një normë me përqindje të re, nga një datë. Arka e kryen vetë atë ditë (kontroll çdo çerek ore dhe gjatë ndezjes).

Faturat (në Belgjikë të detyrueshme mes kompanive) gjenden te Fatura për klientë biznesi. Për t'u bërë: GKS 2.0, të pyetet si qëndron certifikimi (shih docs/backlog-concurrenten.md).

Fatura për klientë biznesi

Cilësimet → Fatura (administratori; si parazgjedhje joaktive): aktivizo Fatura për klientë biznesi (UBL / Peppol). Kur është aktive, poshtë gjenden Pagesë në llogari, Të dhënat në faturë, Shërbimet Peppol, Lidhja me bankën (me pagesë në llogari) dhe lista me të gjitha faturat. Në Belgjikë faturimi elektronik mes kompanive është i detyrueshëm që nga 1-1-2026.

• Fatura për klientë biznesi: Kuponat → zgjidh kuponin → Faturë. Plotëso klientin (ose zgjidh një të mëparshëm); arka krijon një faturë me numër (p.sh. F2026-0001, rritës sipas vitit), si UBL sipas Peppol BIS Billing 3.0 dhe si faturë për ta printuar ose ruajtur si PDF. Dërgim me e-mail (të dyja si bashkëngjitje, sipas dëshirës një kopje për kontabilistin), përmes Billit në rrjetin Peppol (BILLIT_API_KEY, BILLIT_PARTY_ID), përmes Storecove (STORECOVE_API_KEY, STORECOVE_LEGAL_ENTITY_ID; marrësi del nga Peppol-ID i klientit, p.sh. 0208 → BE:EN, 0106 → NL:KVK, përndryshe me e-mail përmes Storecove) ose përmes Banqup të Unifiedpost (BANQUP_CLIENT_ID, BANQUP_CLIENT_SECRET, BANQUP_SPACE_ID; BANQUP_SANDBOX=1 për mjedisin e testimit; Banqup kontrollon UBL-në dhe e dorëzon vetë), në një adresë tënden (FACTUUR_HTTP_URL, p.sh. një program kontabiliteti ose një shërbim tjetër Peppol) ose shkarkim. Një faturë për kupon; kuponi është paguar tashmë, prandaj "e paguar". Numri KvK/i ndërmarrjes, IBAN, Peppol-ID, parashtesa dhe afati i pagesës te Të dhënat në faturë. Të gjitha faturat në fund të skedës (e drejta Xhiro sipas periudhës).
• Çelësat, sekretet dhe headers nuk shfaqen kurrë (vetëm "plotësuar"; lëreni bosh = mbahet, Fshi = hiqet) dhe nuk shënohen në regjistër (vetëm cilat fusha ndryshuan). Ruhen në bazën e të dhënave (vestiging.peppol_gegevens): po në kopjet rezervë, jo në eksportin e konfigurimit.

Kiosk vetëshërbimi

Mysafirët porositin vetë në një kolonë ose tablet, si në një fast food, dhe paguajnë në arkë ose me kartë në kiosk. Ekranet e porosisë janë pjesë e vetë arkës, kështu që menuja, çmimet, opsionet, menutë, happy hours, pjesët e ditës, fotot, alergjenët, gjuhët dhe fatura vijnë nga arka dhe s'duhen konfiguruar gjetkë. Në kiosk punon aplikacioni PinPortal Kiosk 2 (Android, edhe Sunmi, si dhe Windows, Linux dhe macOS), që shfaq faqen dhe printon faturën. Joaktiv si parazgjedhje.

Aktivizimi dhe konfigurimi (administratori): Cilësimet → Biznesi → Ekranet dhe përdorimi → Kiosk vetëshërbimi.

• Zgjidh çfarë mund të zgjedhë mysafiri: Këtu dhe/ose Për të marrë (për të marrë llogaritet me çmimin për të marrë dhe normën e TVSH-së për të marrë, nëse janë vendosur).
• Teksti i mirëseardhjes, pas sa sekondash pa prekje kioski kthehet në fillim (shporta zbrazet) dhe cilat grupe produktesh janë në kiosk (asgjë e shënuar = të gjitha).
• Diçka tjetër?: shëno grupe produktesh (p.sh. pije, ëmbëlsira); te shporta kioski propozon atëherë disa produkte prej tyre.
• Pagesa, për çdo kiosk (shih Shtimi dhe lidhja e një kiosku):
  • Në arkë (parazgjedhje, si te kioska e vjetër): mysafiri porosit, merr një numër marrjeje dhe paguan në arkë. Në kiosk s'nevojitet terminal.
  • Me kartë në kiosk: mysafiri paguan në terminalin pranë kioskës.
  • Mysafiri zgjedh: në arkë ose me kartë. Nëse kioska s'ka terminal, paguhet në arkë.
• Në kuzhinë (kur paguhet në arkë): menjëherë pas porosisë në kiosk (parazgjedhje), ose vetëm pasi të jetë paguar në arkë.
• Fatura: në printerin e kioskës (parazgjedhje), në printerin e faturave të arkës, ose pa faturë (vetëm numri në ekran). Kur paguhet në arkë, kioska printon një fletë me numrin dhe ende pa paguar; fatura vjen kur llogaria mbyllet në arkë.
• Gjendja e porosisë në telefon (opsionale, si parazgjedhje joaktive): në faturën e kioskës dhe në ekranin përfundimtar shfaqet një kod QR. Mysafiri e skanon, sheh numrin dhe gjendjen (porositur, po përgatitet, gati) dhe merr një njoftim kur porosia është gati. Kjo kalon nëpërmjet portalit të menaxhimit, ndaj arka duhet të jetë e lidhur me të.
• Alkooli dhe produktet me kilogram nuk janë kurrë në kiosk: pa personel nuk mund të kontrollohet mosha dhe nuk ka peshore.
• Skaner barkodi (opsional, si parazgjedhje gjithçka joaktive): shëno çfarë mund të bëjë një skanim te kioska:
  • një produkt në shportë (kodi i produktit);
  • një kod zbritjeje;
  • një kartë besnikërie (mysafiri mbledh pikë);
  • një kartë dhuratë ose kartë me parapagim si pagesë. Nëse gjendja mjafton, porosia paguhet menjëherë. Përndryshe karta paguan një pjesë dhe mysafiri paguan pjesën tjetër me kartë ose te arka (kjo lejohet atëherë edhe te një kioskë vetëm me kartë). Pas një pagese të tillë të pjesshme mysafiri nuk mund të anulojë më; porosia shfaqet në arkë si Kiosk … · numri.

Vetë skanerin e vendos te kioska: në aplikacionin PinPortal Kiosk 2 te menaxhimi → Skaner barkodi (si tastierë, skaneri i integruar ose një portë COM), me një test skaneri. Një skaner që punon si tastierë punon edhe pa aplikacionin.

• Rimbush gjendjen (opsionale, si parazgjedhje joaktive; funksionon vetëm nëse Gjendje e rimbushshme është aktive): në ekranin fillestar të kioskut shfaqet atëherë Rimbush gjendjen. Mysafiri skanon kartën ose kartën dhuratë (ose shkruan kodin), sheh gjendjen dhe zgjedh një shumë. Shumat i cakton vetë (nga 1 deri në 6, si parazgjedhje € 10, € 20 dhe € 50). Pagesa bëhet siç është caktuar për kioskun: me kartë, ose në arkë me numrin e marrjes. Pas pagesës shuma është në gjendje. Një rimbushje e tillë nuk shkon në kuzhinë, nuk shfaqet në ekranin e thirrjes dhe nuk merr kod QR. Edhe këtu vlen gjendja maksimale nga cilësimi Gjendje e rimbushshme.
• Në dhomën time (lidhje hoteli, si parazgjedhje joaktive; Cilësimet → Hotel → Vetëshërbim): atëherë te shporta shfaqet Vendose në dhomën time. Mysafiri i hotelit shkruan numrin e dhomës dhe mbiemrin; nëse përputhet me një mysafir që po qëndron tani në atë dhomë, porosia shkon në kuzhinë dhe regjistrohet e paguar në dhomë (shih Softuer hoteli: në dhomë).
• Belgjikë (kutia e zezë): ajo që ende nuk është testuar me kutinë e zezë çaktivizohet automatikisht në kiosk (kartë dhuratë ose kredit si pagesë, rimbushje, kod zbritjeje, menu, opsione me pagesë shtesë, happy hour), njësoj si në arkë.

Shtimi dhe lidhja e një kiosku

1. Te Kioskët shkruaj një emër (p.sh. Kiosk hyrja) dhe zgjidh Shto kiosk. Merr një kod lidhjeje me 6 shifra (i vlefshëm 30 minuta).
2. Zgjidh te kioska si paguan mysafiri: si parazgjedhje në arkë. Nëse është kiosk me terminal, zgjidh me kartë ose mysafiri zgjedh dhe zgjidh terminalin e kësaj kioske (nga Cilësimet → Pagesat).
3. Hap në kiosk faqen e kioskut:
   • në biznes: në aplikacion te menaxhimi → Vast adres adresën që shfaqet te cilësimi, p.sh. http://192.168.1.20:3000/kiosk;
   • ose përmes portalit të menaxhimit (https, edhe kur kioski nuk është në të njëjtin rrjet): lidhe adresën e kioskut që shfaqet te cilësimi me kodin e kioskut të aplikacionit, si me kioskun e vjetër.
4. Shkruaj kodin e lidhjes në kiosk. Gati: kioski mban mend çelësin e vet. Lidh përsëri jep një kod të ri; Hiq e shkëput.

Te çdo kiosk shihet nëse është online.

Si porosit mysafiri

1. Ekrani fillestar me tekstin e mirëseardhjes; mysafiri zgjedh gjuhën (të gjitha gjuhët e arkës) dhe prek për të porositur.
2. Këtu ose për të marrë.
3. Menyja sipas grupeve të produkteve, me foto, çmimin (me happy hour), alergjenët dhe çfarë ka mbaruar. Produktet me zgjedhje ose një meny hapin dritaren e zgjedhjes.
4. Shporta: ndrysho sasitë dhe sipas dëshirës Diçka tjetër?.
5. Porosit (pagesa në arkë): mysafiri sheh numrin e marrjes të madh në ekran me shumën, merr fletën dhe paguan në arkë. Në arkë porosia është e hapur si Kiosk Hyrja · 42 (numri që thotë mysafiri); llogaria mbyllet si zakonisht. Pastaj shfaqet si e paguar në ekranin e thirrjes dhe shkon në kuzhinë nëse kjo duhej të ndodhte vetëm pas pagesës.
6. Paguaj me kartë: arka dërgon shumën te terminali i kësaj kioske (e njëjta lidhje pagese si në arkë). Nëse s'ia del, mysafiri mund të provojë sërish ose të anulojë (ose, nëse mund të zgjedhë, të paguajë megjithatë në arkë). Vetëm kur pagesa ka sukses, porosia shkon në kuzhinë dhe mbyllet. Mysafiri sheh numrin e marrjes të madh në ekran dhe merr faturën.
7. Pas disa sekondash kioska kthehet në fillim.

Në rast defekti: njoftim dhe modaliteti i emergjencës (në aplikacionin e kioskës, menaxhimi → Bij storing; standard i fikur). Nëse kioska nuk e arrin arkën, shfaq Even gesloten. Dy shtesa:

• Teams, Slack, Discord, ntfy, Home Assistant, Make ose Zapier), dhe një mesazh hersteld kur punon sërish. Me Testmelding sturen kontrollon adresën.
• Modaliteti i emergjencës: kioska ruan një menu të thjeshtë, që ia jep faqja e kioskut: produkte pa zgjedhje ose menu, me çmimin për ta ngrënë këtu (ose për të marrë, nëse kjo është e vetmja zgjedhje).
  • Nëse arka mungon për një kohë (standard 60 sekonda), mysafiri porosit nga kjo menu.
  • Mysafiri paguan me kartë ose në banak. Pagesa me kartë është e mundur vetëm nëse Pinbetaling është aktiv në aplikacion.
  • Printohen dy fletë emergjence: një për mysafirin (N1, N2 …) dhe një për banakun/kuzhinën. Në to shkruhet se nuk janë faturë arke.
  • Kur arka kthehet, faqja e kioskut i fut porositë e emergjencës në arkë si Nood N… <kiosk>. Ato nuk shkojnë në kuzhinë (ajo e kishte tashmë fletën e emergjencës) dhe nuk shfaqen në ekranin e thirrjes.
  • Paguar me kartë dhe e njëjta shumë si në arkë: u llogarit si Pagesë me kartë manuale. Përndryshe (pagesë në banak, ose një shumë tjetër) porosia mbetet e hapur për kamarierët.
  • Gjithçka shënohet në regjistër.
• Belgjika: me sistemin e arkës së regjistruar (GKS, kuti e zezë) çdo shitje duhet të kalojë menjëherë përmes arkës dhe FDM. Modaliteti i emergjencës atëherë ka të ngjarë të mos lejohet; pyet fillimisht. Në Belgjikë aplikacioni i kioskës e aktivizon vetëm pas një konfirmimi shtesë, dhe arka paralajmëron te kioska.

Në arkë, një porosi nga kioska është porosi e zakonshme (për ta marrë ose në vend, me emrin Kiosk Hyrja) në emër të punonjësit Kiosk. Arka e krijon vetë; askush s'mund të hyjë me të. Mos e bëj joaktiv, përndryshe kioska s'mund të porosisë. Porositë nga kioska janë në raporte, te Faturat dhe në ekranin e thirrjes. Një porosi e papërfunduar në kiosk (e pa porositur ose e papaguar me kartë) skadon vetë pas 30 minutash.

Pagesa me kartë në modalitet testimi (Cilësimet → Pagesat)? Atëherë kioski nuk arkëton vërtet; e dobishme për provë. Pa internet nuk mund të paguhet me kartë; kioski thotë atëherë se mund të porositësh te banaku.

Defekt: nëse arka nuk arrihet, aplikacioni i kioskës shfaq "Mbyllur përkohësisht" dhe vazhdon vetë. Nëse kioska punon nëpërmjet portalit të menaxhimit dhe bie interneti, aplikacioni mund të kalojë te arka në rrjetin lokal (në aplikacion: menaxhimi → Shtesat → Në defekt kalo te rrjeti lokal); adresën e jep vetë kioska.

Çaktivizimi: kioski tregon se është i mbyllur për një moment. Kioskët dhe cilësimet ruhen. Në regjistër janë aktivizimi/çaktivizimi, cilësimet, kioskët e shtuar dhe të hequr, lidhjet dhe porositë e anuluara.

Tabela digjitale e menusë

Menuja me çmime në një televizor (ose monitor tjetër me shfletues), drejtpërdrejt nga arka. Si parazgjedhje joaktiv; aktivizohet te Cilësimet → Biznesi → Ekranet dhe përdorimi → Tabela digjitale e menusë. Pastaj hap në televizor http://<kassaserver>:3000/menubord (ose butonin Në një ekran të veçantë / Në tablet ose telefon me kodin QR). Pa hyrje dhe pa çiftim.

• Sipas kategorisë, produktet me çmim, në rendin e arkës. Zgjidh vetë cilat kategori (dhe në çfarë rendi), 1 deri në 4 kolona, e errët ose e çelët, një titull të vetin (bosh = emri i biznesit), fotot e produkteve dhe alergjenët.
• Gjithmonë e saktë: tabela e kërkon menunë çdo 10 sekonda (dhe menjëherë kur ka ndryshim), kështu që një produkt i mbaruar (i vizatuar me Mbaroi, ose i hequr nga tabela), një stok bosh, një happy hour (çmimi i ofertës me çmimin normal të vizatuar, dhe emri e ora e mbarimit lart) dhe periudhat e menusë (vetëm ajo që shitet tani) dalin vetë saktë.
• Nëse nuk nxë gjithçka në ekran, faqet ndërrohen (si parazgjedhje çdo 12 sekonda, e rregullueshme nga 5 deri në 120).

Stafi dhe kodet PIN

Cilësimet → Personeli (vetëm administratori): shto punonjës, ndrysho emrin, rolin dhe kodin PIN, dhe çaktivizoji.

• Rolet: kamarier (porosit, paguan, raporti X), menaxher (për më tepër zbritje, kthime, mbyllje dite, sirtari i parave dhe regjistri) dhe administrator (gjithçka, edhe të gjitha Cilësimet). Kjo është parazgjedhja; çfarë mund të bëjnë kamarieri dhe menaxheri mund të përshtatet (shih Të drejtat sipas rolit).
• Kodi PIN nga 4 deri në 8 shifra, unik mes punonjësve aktivë. Kodet PIN ruhen vetëm të enkriptuara (hash) në bazën e të dhënave dhe nuk mund të lexohen më.
• Fshirja përfundimtare nuk është e mundur (faturat dhe regjistri i referohen punonjësit); joaktiv = nuk mund të hyjë më.
• Mbetet gjithmonë të paktën një administrator aktiv.
• Rol tjetër, kod PIN i ri ose joaktiv: seancat aktuale të atij punonjësi mbyllen menjëherë.
• Belgjikë: opsionalisht numri i regjistrit kombëtar për regjistrimin e personelit.
• Gjuha: gjuha e ekraneve për këtë punonjës (ose "Gjuha e pajisjes"). Pas hyrjes arka është menjëherë në atë gjuhë; punonjësi mund ta ndryshojë edhe vetë me flamurin e vogël poshtë djathtas (shih Gjuhët).
• Këshillë: zëvendëso kodet PIN demo 1111 dhe 2222 përpara se arka të fillojë punën.

Hyrje me kartë (opsionale)

Si parazgjedhje joaktiv. Aktivizimi: Cilësimet → Personeli, kutia Hyrje me kartë (NFC, RFID ose iButton). Nevojitet: një lexues kartash USB që funksionon si tastierë (për karta NFC ose RFID, varëse çelësash, byzylykë ose çelësa iButton). Një lexues i tillë "shkruan" numrin e kartës dhe shtyp Enter; nuk nevojitet as drajver, as lidhje.

• Lidhja: prek punonjësin, pastaj Lidh kartën dhe mbaje kartën te lexuesi. Një kartë i përket vetëm një punonjësi. Hiq kartën nëse ka humbur.
• Hyrja: në ekranin e hyrjes mbaje kartën te lexuesi. Kodi PIN vazhdon të funksionojë si zakonisht.
• Regjistrimi i hyrjes dhe daljes (nëse është aktiv): në ekranin e hyrjes Hyrje / dalje (orari) dhe karta te lexuesi.
• Numri i kartës ruhet në bazën e të dhënave vetëm i enkriptuar (hash), njësoj si kodi PIN. Punonjësit joaktivë nuk mund të hyjnë as me kartën e tyre.
• Joaktiv: hyrje vetëm me kodin PIN, si gjithmonë. Kartat e lidhura ruhen.

Të drejtat sipas rolit

Cilësimet → Të drejtat (vetëm administratori): shëno për çdo rol çfarë mund të bëjnë kamarieri dhe menaxheri. Si parazgjedhje gjithçka është saktësisht si më sipër (si e ka bërë gjithmonë arka); një kuti që ndryshon është me ngjyrë.

• Administratori mund të bëjë gjithmonë gjithçka. Ndryshimi i personelit dhe i të drejtave mbetet gjithmonë vetëm për administratorin (përndryshe dikush mund t'i japë vetes më shumë të drejta).
• Butonat dhe skedat që një rol nuk i lejohen, janë të fshehura për atë rol; serveri i arkës e kontrollon gjithashtu. Nëse një menaxher merr p.sh. Menaxho produktet, ai sheh butonin Cilësimet vetëm me skedën Produktet.
• Ndryshimet vlejnë menjëherë në të gjitha arkat dhe regjistrohen në regjistër. Kthe te parazgjedhja i rikthen të gjitha siç ishin.

Të dhënat e lokalit

Cilësimet → Lokali (vetëm administratori): emri, adresa, kodi postar, qyteti, telefoni dhe numri i TVSH-së së njësisë. Këto shfaqen lart në çdo faturë dhe pro forma. Këtu mund të vendoset edhe teksti në fund të faturës (lejohen disa rreshta; bosh = pa tekst; parazgjedhje "Bedankt en tot ziens!"), dhe poshtë tij gjuha e faturës (parazgjedhje holandisht; shih Gjuhët). Një parapamje e faturës përditësohet drejtpërdrejt. Pas ruajtjes, fatura e radhës përdor menjëherë të dhënat e reja. Shteti dhe të dhënat fiskale (GKS) qëllimisht nuk mund të ndryshohen këtu. Në Belgjikë numri i TVSH-së është i detyrueshëm. Me shenjën Rrumbullako pagesat me para në dorë në 5 centë (si parazgjedhje joaktiv) totali rrumbullakohet te pagesat me para në dorë (€ 6,62 → € 6,60, € 6,63 → € 6,65); diferenca shfaqet si "Rrumbullakim" te fatura. Pagesa me kartë mbetet gjithmonë e saktë deri në cent.

Menaxhimi i produkteve

Hyr si administrator dhe zgjidh Cilësimet → Produktet.

• Shto, ndrysho (emrin, çmimin, kategorinë, normën e TVSH-së për konsum në lokal dhe për marrje me vete, emrin te fatura, kodin, mbaroi) dhe fshi kategori produktesh dhe produkte. Kategoritë dhe produktet mund të kenë secili ngjyrën e vet; një produkt me ngjyrë merr një buton me ngjyrë në ekranin e porosive (teksti automatikisht i bardhë ose i errët për lexueshmëri).
• Ndrysho renditjen duke tërhequr një kategori ose produkt nga ≡. Funksionon me maus dhe me gisht në tablet. Pikërisht kjo renditje shfaqet pastaj në ekranin e porosive; ekranet e hapura të arkës përditësohen menjëherë vetë.
• Fshirja e heq një produkt nga arka, por porositë e vjetra dhe ditari fiskal e njohin ende produktin. Një kategori mund të fshihet vetëm kur është bosh.
• Opsionet e zgjedhjes: hap një produkt ose kategori produktesh dhe shto te "Opsionet e zgjedhjes" grupe zgjedhjesh, si "Pjekja" (saktësisht një, e detyrueshme), "Salca" (maksimumi një) ose "Ekstra" (disa, me minimum dhe maksimum; maksimum bosh = pa kufi). Çdo zgjedhje ka një emër dhe një çmim shtesë (mund të jetë negativ, p.sh. -0,50). Grupet e zgjedhjeve të një kategorie vlejnë për të gjitha produktet në atë kategori, mbi zgjedhjet e vetë produktit. Renditja me ▲▼. Fshirja është gjithmonë e mundur: porositë dhe faturat ekzistuese i ruajnë vetë opsionet e zgjedhura. Serveri kontrollon gjithashtu zgjedhjet e detyrueshme dhe maksimumin.
• Foto për çdo produkt: shih Fotot e produkteve.
• Çmimi për kilogram, numri PLU dhe tara (vetëm kur peshorja është aktive): shih Konfigurimi i peshores. Pa shenjë, produkti mbetet normalisht për copë.

Fotot e produkteve

Çdo produkt mund të ketë një foto.

• Vendos foton: Cilësimet → Produktet → zgjidh produktin → Zgjidh foton (në tablet ose telefon mund të përdorësh edhe kamerën direkt). Fotoja zvogëlohet në shfletues deri në maksimumi 512 × 512 piksela (JPEG, zakonisht 20–80 kB) dhe ruhet menjëherë; Foto tjetër e zëvendëson, Fshi foton e heq. Në listën e produkteve shfaqet një foto e vogël para emrit. Vetëm me të drejtën Menaxho produktet; jpg, png dhe webp, maksimumi 512 kB.
• Çfarë shfaqet e zgjedh administratori te Cilësimet → Lokali → Fotot e produkteve, veçmas njëra nga tjetra dhe si parazgjedhje joaktive:
  • Foto e produktit në butonat e ekranit të porosive: fotoja lart në butonin e produktit, me emrin dhe çmimin poshtë saj.
  • Foto e produktit pranë produkteve në ekranin e klientit: një foto e vogël para çdo rreshti në ekranin e klientit (edhe vetë ekrani i klientit duhet të jetë aktiv). Produktet pa foto mbeten siç janë; nëse është joaktive, gjithçka funksionon saktësisht si më parë.

Skaner barkodi

Me një skaner barkodi në arkë skanon produkte, kode zbritjeje, karta besnikërie dhe karta dhuratë. Aktivizohet te Cilësimet → Skaneri (skeda pranë printerëve dhe peshores; si parazgjedhje joaktiv). Shëno çfarë bën një skanim në ekranin e porosisë:

• Produkt në faturë: produkti me atë kod (Cilësimet → Produktet, fusha Kodi; p.sh. barkodi EAN i paketimit). Me zgjedhje, menu ose çmim për kilogram hapet fillimisht dritarja e zgjedhjes ose peshorja, njësoj si me prekje. Këtë e bën edhe Skanimi në ekranin e porosisë te Printo etiketa; ai vazhdon të punojë si zakonisht.
• Kod zbritjeje në faturë (nëse kodet e zbritjes janë aktive).
• Karta e besnikërisë: klienti me atë numër karte vendoset në faturë (nëse karta e besnikërisë është aktive). Nëse skanon një kod të panjohur në një faturë me klient, arka pyet nëse është karta e tij e re.
• Kartë dhuratë ose kartë me parapagim: arka shfaq gjendjen (nëse kartat dhuratë me gjendje janë aktive). Pagesa bëhet te Paguaj → Kartë dhuratë; atje mund ta skanosh gjithashtu kartën.

Arka kërkon fillimisht te produktet, pastaj te kartat e besnikërisë, kartat dhuratë dhe kodet e zbritjes. Skanimi punon në ekranin e porosisë, kur nuk je në një fushë hyrjeje. Në një fushë hyrjeje kodi thjesht shkon në atë fushë.

Testi i skanerit: te Cilësimet → Skaneri sheh për çdo skanim kodin dhe çfarë kupton arka prej tij, edhe kur skaneri është ende joaktiv. Nëse nuk punon:

• Vendose skanerin në tastierë (USB-HID), me një Enter pas kodit. Te shumica e skanerëve kjo është tashmë kështu.
• Një skaner të integruar (p.sh. të një arke Sunmi) e vendos te cilësimet e skanerit të pajisjes në futje me tastierë.
• Etiketat e peshores TS6X (pesha dhe çmimi) i trajton vetë peshorja, edhe me skanerin aktiv.

Te kioska skanerin e vendos veçmas (Cilësimet → Biznesi → Kiosk); shih Kiosk vetëshërbimi.

Printimi i etiketave

Etiketa artikujsh me emrin, çmimin dhe një barkod, në një printer etiketash (Brother, Dymo, Zebra ...) të instaluar në kompjuter ose tablet. Aktivizohet te Cilësimet → Biznesi → Printo etiketa (si parazgjedhje joaktiv). Aty zgjedh edhe formatin e etiketës (38 × 25, 57 × 32, 62 × 29 ose 100 × 50 mm) dhe nëse çmimi dhe barkodi dalin në të. Printo provë printon një etiketë prove.

• Cilësimet → Produktet → (produkti) → Etiketat: zgjidh numrin dhe Printo.
• Blerjet → (porosia e marrë) → Printo etiketa: për çdo produkt aq etiketa sa kanë mbërritur (njësitë e porosisë të marra × sasia për njësi porosie; jo përbërësit). Maksimumi 500 etiketa njëherësh.
• Arka hap dritaren e printimit: zgjidh aty printerin e etiketave dhe formatin e letrës së rrotullës. Çdo etiketë është një faqe.
• Barkodi është kodi i produktit (Cilësimet → Produktet): 8 ose 13 shifra me shifër kontrolli të saktë = EAN (12 shifra: shifra e kontrollit shtohet), përndryshe Code 128 (shkronja, shifra dhe shenja pikësimi, deri në 30 karaktere). Pa kod nuk ka barkod.
• Skanimi në ekranin e porosisë (kutia, si parazgjedhje joaktive): një skaner barkodi që punon si tastierë e shton produktin me atë kod, me zgjedhjet e zakonshme (opsione, peshore, alergji). Jo së bashku me peshoren TS6X, e cila ka etiketat e veta me peshë dhe çmim.
• E drejta: Menaxho produktet ose Menaxho stokun.

Konfigurimi i peshores (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)

Skedë më vete Cilësimet → Peshorja (e drejta Konfiguro lokalin, pagesat dhe printerët, si parazgjedhje vetëm administratori; skeda është gjithmonë aty, edhe kur peshorja është ende joaktive). Si parazgjedhje joaktive: atëherë arka funksionon saktësisht si më parë. Nuk e sheh skedën?

Kërkim automatik. Nëse ende nuk është konfiguruar asgjë, arka kërkon vetë kur hapet ky seksion (butoni Kërko e bën sërish):

• a funksionon arka (serveri i arkës) vetë në një peshore PC ose AI të Aclas (TS6X, TS3X, TS5EX/NX/GX, iS6X, iS2X, iR6X, Ti6X, iL8X; marka/modeli i pajisjes: Windows përmes WMI, Android përmes getprop, Linux përmes DMI) dhe a përgjigjet Aclas Scale Module? Atëherë kjo peshore përgatitet si Në këtë pajisje, po ashtu edhe peshorja e etiketave; në Linux (pa Scale Module) peshorja e integruar në portin e brendshëm të gjetur (/dev/ttyS...) si "TS6X (e integruar)", bashkë me modelin;
• a është lidhur një OS6X në një port COM/USB? Çdo port provohet me 9600, 4800, 2400 dhe 19200 baud: fillimisht dëgjon pak (vazhdimisht), pastaj dërgon W (Toledo), dhe ndryshe Dialog 06 (9600, 7 bit të dhënash, paritet tek: kërkon statusin).

E gjetur = vendoset në formular me butonin Aktivizo dhe përdor: një prekje dhe funksionon. (Kërkimi dërgon një W në çdo port COM të lirë; një port i zënë, p.sh. nga terminali i pagesave, anashkalohet.)

Të gjitha peshoret Aclas. Për çdo peshore zgjedh modelin; arka e di atëherë si mund të lidhet. Ka dy lloje:

• Në këtë pajisje (konfigurohet një herë): arka funksionon në peshore (peshore PC ose AI). Me Windows ose Android peshon përmes Aclas Scale Module, pa port, shpejtësi apo protokoll; me Linux (pa Scale Module) përmes portit të brendshëm të peshores (zakonisht /dev/ttyS0 ose /dev/ttyS1), me port, shpejtësi dhe protokoll. Ka vetëm një të tillë për arkë; Kërkimi e gjen vetë. Një peshore PC ose AI (TS6X, iS6X ...) është gjithmonë Në këtë pajisje: në listë mund të jetë vetëm një herë, modelet e tjera PC/AI nuk mund të zgjidhen më. Një TS6X diku tjetër në lokal mund të printojë etiketa (atëherë aktivizo vetëm Skano etiketat).
• E lidhur (disa njëkohësisht): peshorja lidhet me kabllo (RS232/USB), Bluetooth ose rrjet me serverin e arkës. Sa të nevojiten (deri në 8), secila me emrin e vet.

Një listë, dy shenja. Të gjitha peshoret janë në një listë. Për çdo peshore aktivizon çfarë bën: Peshim në arkë (arka kërkon peshën gjatë porosisë) dhe/ose Skano etiketat (peshorja printon një etiketë me barkod që arka e skanon, dhe merr PLU-të nga arka). Një peshore PC ose AI si TS6X mund t'i bëjë të dyja; një peshore etiketash LS vetëm etiketa. Etiketat mund të vijnë nga një peshore për lokal.

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 dhe Zebra. Janë përfshirë modelet e zakonshme të këtyre markave për të cilat dihet si komunikon arka me to (për t'u testuar = protokolli nuk shkruhet fjalë për fjalë në asnjë burim; arka zgjedh atë që është më e mundshme). Të gjitha të lidhura (disa njëkohësisht) ose si peshore etiketash, etiketën e së cilës arka e skanon:

• A&D EK-i dhe HV-WP: vendoseni peshoren në stream (EK-i: prt 0; nga fabrika është në tastin PRINT) dhe arkën në I vazhdueshëm me 2400 baud dhe 7E1 (kështu është A&D nga fabrika). Mesazhi është ST,+00512.00 g (US = lëviz, OL = shumë e rëndë).
• Adam Equipment Swift: vendoseni peshoren në vazhdimisht te PC (8N1); arka është atëherë në I vazhdueshëm.
• Avery Berkel FX110, FX120 dhe FX131: në peshore zgjidhni protokollin Mettler Toledo 82/7 dhe vendoseni arkën në Kërko (Toledo) me 7E1 (9600 baud). Funksionon edhe Dialog 06. FX125 (me ekran çmimi) nuk e njeh Toledo: aty Dialog 06. Arka e vendos këtë vetë kur zgjidhni modelin.
• Avery Weigh-Tronix 7820, 7829 dhe ZP900 dhe Brecknell 6702U, 6710U dhe 6720U: NCI, protokolli i Weigh-Tronix. Arka dërgon W (si te Toledo), peshorja përgjigjet me peshën ( 1.234KG) dhe një rresht gjendjeje; ky tregon nëse lëviz, nëse është shumë e rëndë apo shumë e lehtë. Arka është në Kërko (Toledo) me 7E1 (9600 baud). USB funksionon si port COM virtual. Te ZP900 vendoseni arkën në portin 2 (NCI). Te 67xxU mund të zgjidhet në peshore edhe 8213 (SCP03).
• Balanzas Marques BM1000P TOP: te porti COM zgjidhni protokollin B (METTLER) dhe 9600 baud, 7 bit të dhënash, paritet çift; arka është atëherë në Kërko (Toledo) me 7E1.
• Baxtran TW, VW, XTA dhe XTA-P (peshore me llogaritje çmimi; VW dhe XTA-P me shtyllë): në menynë RS232 të peshores zgjidhni protokollin Toledo, 9600 baud dhe 7 bit të dhënash me paritet çift (7E1); arka është atëherë në Kërko (Toledo) me 7E1. Arka e vendos këtë vetë kur zgjidhni modelin. Funksionon edhe CONT (peshorja dërgon vetë): atëherë vendoseni arkën në I vazhdueshëm me të njëjtën shpejtësi dhe bit të dhënash. Lidhja bëhet me kabllon RS232 (9 pina) ose me një kabllo USB në RS232.
• Bizerba CS 300: Checkout-Dialog 06 (specifikimi i Bizerba): arka dërgon çmimin për kg, peshorja e verifikuar llogarit shumën. Nëse peshorja kërkon kode kontrolli, i merrni nga Bizerba ose furnitori.
• CAS PD-II, PDN, PDI dhe PDS-B (PDS-B ndër të tjera te LRE): në peshore zgjidhni ECR type 2 (Toledo) dhe vendoseni arkën në Kërko (Toledo) me 7E1 (9600 baud).
• Datalogic Magellan 9300i, 9400i dhe 9800i: vendosni Scale Interface Type të portit të veçantë të peshimit në Mettler Toledo 8217 dhe arkën në Kërko (Toledo) me 7E1.
• Dibal KS-400, D-POS 400, G-325 dhe PI-100: në peshore zgjidhni protokollin Checkout_Dialog06 (protokolli 24) dhe 9600 baud, 7 bit të dhënash, paritet tek (lloji i parametrit 5); arka është atëherë në Dialog 06. D-POS 400 mund të lidhet edhe me USB.
• DIGI DS-781: vendoseni peshoren në Type B / komandë standarde (data transmission 00011); arka dërgon ENQ dhe merr neto, tarën, çmimin për kg dhe shumën.
• Dini Argeo DFW, DGT dhe 3590E: vendoseni portin serial në dërgim të vazhdueshëm (9600 8N1); arka është atëherë në I vazhdueshëm.
• Excell Precision TPE (dhe gjenerata e 4-të AM4, FD4-P, FDP4-P, GE4, GEP4): vendoseni daljen RS232 në të vazhdueshme (9600 8N1); arka është atëherë në I vazhdueshëm.
• Gram XFOC RS, XFOC+ RS dhe ZFOC RS: protokolli Gram (9600 8N1). Arka dërgon ENQ, peshorja përgjigjet ACK, arka dërgon DC1 dhe peshorja dërgon peshën: SOH STX S/U/F teken gewicht eenheid BCC ETX EOT (S = e qëndrueshme, U = lëviz, F = gabim; BCC = XOR i statusit deri te njësia përfshirë). Lidhet me RS232 ose me kabllon USB të Gram.
• Kern & Sohn RPB dhe RFC: vendosni në peshore Prot = DLG-06 (lidhja me arkën është opsioni 965-419); arka është atëherë në Dialog 06. RFE, IFB dhe EOC: dërgim i vazhdueshëm (8N1), arka në I vazhdueshëm.
• Mettler Toledo Ariva/Viva: vendoseni peshoren në protokollin Toledo (8217) dhe arkën në Kërko (Toledo) me Bitët e të dhënave / pariteti = 7E1 (Mettler: 9600 baud, 7 bit të dhënash, paritet çift; Ariva mund të lidhet edhe me USB si port COM virtual). Arka e vendos këtë vetë kur zgjidhni modelin.
• Minebea Intec Signum, Combics, Midrics dhe Puro dhe Sartorius Entris dhe Quintix: SBI me printim automatik (9600 8N1); arka është atëherë në I vazhdueshëm. Mesazhi është N + 0.512 kg; pa njësi do të thotë që pesha ende lëviz.
• Ohaus Aviator 7000: në cilësimet e peshores (hapi 20) zgjidhni protokollin Dialog 06; arka është atëherë në Dialog 06. RS232 ose USB, në varësi të kabllos.
• Ohaus Valor 7000, Ranger 3000/4000/7000 dhe Defender 3000 (peshim pa çmim): vendoseni peshoren në Auto Print Continuous (9600 baud, 8N1) dhe arkën në I vazhdueshëm. Peshorja dërgon 0.512 kg G; një ? pas peshës do të thotë që ende lëviz. Ranger 7000 mund të lidhet edhe me Ethernet (porti TCP 9761).
• Precia Molen DP400, DPOS CR dhe C 210 (peshoret tregtare janë që nga 2025 të Dibal): Dialog 06 (9600 7O1), si te Dibal. Nëse nuk funksionon te C 210, provoni Kërko (Toledo) me 7E1.
• Precisa XB, XT, LS dhe LX: vendosni modalitetin e printimit në CONTINUOUS dhe 9600 8N1, pa datë, orë dhe ID në rresht; arka është atëherë në I vazhdueshëm. Pa njësi do të thotë që pesha ende lëviz.
• Rice Lake BenchPro BP-S (Toledo 8213) dhe BP-R (NCI): arka është në Kërko (Toledo) me 7E1.
• Star Micronics mG-T dhe mG-S8200: përmes RS232 ose USB (port COM virtual, me drajverin e Star) në I vazhdueshëm.
• UWE ASEP: RS232 te PC/arka, arka në I vazhdueshëm (për t'u testuar).
• Wedderburn TSDS983, TSDS781T dhe TSDS782T janë peshore DIGI me numër të vetin: DIGI (Type B), si te DIGI DS-781. Nëse nuk funksionon, provoni Kërko (Toledo) me 7E1.
• Wintec ScalePOS ACS-S60E: arka punon në vetë ScalePOS; peshorja e integruar është në COM6 (Windows) ose COM4 (Android), 9600 8N1. Zgjidhni I vazhdueshëm; nëse nuk dërgon asgjë, Kërko gjen protokollin e duhur.
• Zebra MP7000 dhe MP72: porti AUX RS232 është nga fabrika në SASI (9600 7E1, arka dërgon W): arka në Kërko (Toledo) me 7E1.
• Peshoret e etiketave të këtyre markave (Avery Berkel, Balanzas Marques, Bizerba, CAS, Dibal, DIGI, Ishida, Mettler Toledo, Precia Molen, Rongta, T-Scale, Wedderburn) janë sisteme të pavarura me skedarin e tyre PLU. Aktivizoni Skano etiketat për peshoren dhe vendosni të njëjtin barkod si në peshore (EAN-13, fillimi 20–29, PLU dhe pesha ose çmimi). PLU-të i vendosni në vetë peshoren ose me softuerin e markës; Dërgo te TS6X dhe Shkarko skedarin PLU ekzistojnë vetëm për Aclas.

E njëjta listë është në arkë te Cilësimet → Peshorja → Të gjitha peshoret (ACLAS_MODELLEN në packages/shared/src/weegschaal.ts, me markën për çdo model).

Sa më pak për të plotësuar: kur zgjidhni një model, arka përgatit pjesën tjetër siç e vendos marka në fabrikë: lidhja Port COM / USB në portin e parë të lirë, 9600 baud (A&D: 2400) dhe protokolli i markës (Toledo: Aclas me 8N1, dhe me 7E1 Avery Berkel FX, Avery Weigh-Tronix, Balanzas Marques, Baxtran, Brecknell, CAS, Datalogic, Mettler Toledo, Rice Lake dhe Zebra; Dialog 06: Avery Berkel FX125, Bizerba, Dibal, Kern & Sohn RPB/RFC, Ohaus Aviator dhe Precia Molen; DIGI Type B: DIGI dhe Wedderburn; Gram: Gram; I vazhdueshëm: A&D, Adam Equipment, Dini Argeo, Excell Precision, Kern & Sohn të tjera, Minebea Intec, Ohaus të tjera, Precisa, Sartorius, Star Micronics, UWE dhe Wintec) dhe një emër (p.sh. OS6X, OS6X 2). Një peshore PC ose AI bëhet Në këtë pajisje (p.sh. TS6X (ingebouwd); në Linux në portin e brendshëm /dev/ttyS0). Nëse diçka nuk shkon, Kërko gjen portin, shpejtësinë dhe protokollin e duhur.

Në këtë pajisje (Aclas Scale Module): peshorja shfaq peshën e kalibruar; arka dërgon çmimin për kilogram dhe tarën (si tarë paraprake) dhe merr shumën që llogarit peshorja, njësoj si te Dialog 06.

• Android: aplikacioni i Aclas AclasScaleDriver (com.aclas.aclasscaledriver) zakonisht është tashmë në peshore; nëse jo, instaloni aclas-android/AclasScaleDriver.apk. Aplikacioni HorecaPOS komunikon drejtpërdrejt me shërbimin e atij aplikacioni, ndaj nuk nevojitet asnjë librari shtesë.
• Linux: Aclas nuk ka Scale Module për Linux. Thjesht zgjidh modelin (p.sh. TS6X): lidhja bëhet atëherë Në këtë pajisje (port i brendshëm) në /dev/ttyS0, 9600 baud, Toledo. Peshorja e integruar është zakonisht në /dev/ttyS0 ose /dev/ttyS1; Kërkimi i provon dhe vendos portin, shpejtësinë dhe protokollin e duhur. Edhe këtu mund të jetë vetëm një herë.

Softueri i Aclas vjen me arkën: Scale Module për Windows (aclas-module), AclasScaleDriver për Android (aclas-android) dhe Aclas Sync SDK për Windows dhe Linux (aclas-sdk). Aclas na lejon t'i shpërndajmë. Instaluesit për Windows dhe Linux i përfshijnë; asgjë për të shkarkuar ose instaluar veçmas.

Bluetooth (p.sh. OS6X): fillimisht çifto peshoren. Windows krijon prej saj një port COM (Cilësimet e Bluetooth → Më shumë opsione Bluetooth → Portat COM), Linux /dev/rfcomm0: plotëso atë port. Në aplikacionin Android plotëson adresën Bluetooth (00:11:22:AA:BB:CC); aplikacioni kërkon një herë leje për Pajisjet në afërsi dhe lidhet përmes Bluetooth SPP.

Peshoret AI (njohje produktesh): kamera e njeh produktin në softuerin e Aclas në peshore. Peshimi funksionon përmes Scale Module (në këtë pajisje) ose portit RS232; peshoret AI të etiketave, pas njohjes, printojnë një etiketë me barkod që arka e skanon (si te TS6X).

Aclas AI Recognition Plugin (peshore AI me arkën në të, p.sh. iS6X me Windows): plugin-i i Aclas e njeh produktin dhe e shkruan barkodin e tij në arkë, njësoj si një skaner (me Enter pas tij); ekrani i porosisë e vendos produktin me peshën në porosi. Ja si ta konfiguroni:

• Për peshoren aktivizoni Skano etiketat me të njëjtin barkod si në plugin. Rekomandim: fillon me 27, PLU 5 shifra, pesha (Aclas lloji 17): atëherë arka e llogarit vetë me çmimin për kilogram. Me çmimin (lloji 12, fillon me 22) funksionon gjithashtu.
• Për atë peshore çaktivizoni Peshim në arkë: plugin-i dhe Scale Module nuk mund ta përdorin peshoren njëkohësisht. Pesha vjen nga barkodi. Nëse plugin-i përgjigjet te Kërko, arka e propozon atë dhe nuk e nis Scale Module. Pa kod aktivizimi plugin-i peshon dhe e llogarit shumën, por nuk njeh produkte.
• Në vetë plugin-in: barkodi te Scale and Barcode Format Settings → Default Barcode Format (lloji 17), dhe te cilësimet e dritares pika ku plugin-i klikon dhe shkruan kodin. Zgjidhni për këtë një vend bosh në ekranin e porosisë, jo mbi një buton. Produktet e reja lokali ia mëson vetë plugin-it në peshore (trajnim AI).
• Jepuni produkteve që peshohen një numër PLU dhe dërgojini PLU-të te peshorja (Dërgo te TS6X ose skedari PLU); plugin-i njeh sipas numrit PLU.
• Arka e lejon plugin-in të njohë vetëm për sa kohë që ekrani i porosisë është i hapur në vetë peshoren (POST /aiplugin/resume, gjatë mbylljes /aiplugin/suspend, porti 5003 në peshore; herën e parë edhe EmployeeMode: ekrani i klientit i peshores nuk shfaq produkte). Në arka dhe tableta të tjera dhe përmes portalit të menaxhimit nuk ndodh asgjë.
• Plugin-i niset gjithmonë në Resume dhe nuk mund ta njoftojë gjendjen e tij. Prandaj ekrani i porosisë dërgon sërish resume çdo 30 sekonda; nëse kjo mungon (ekrani i mbyllur, plugin-i ose peshorja rinisen), arka e vendos plugin-in brenda një minute në Suspend dhe e mban aty.
• Plugin-i kërkon një kod aktivizimi nga Aclas për çdo peshore (i lidhur me numrin serial). Tani funksionon në Windows; versioni Android i Aclas vjen më vonë (arka bën aty të njëjtën gjë).

Aclas OS6X (peshore POS në arkë, RS232/USB; kështu funksionojnë edhe peshoret e tjera të lidhura):

• Një ose më shumë peshore (deri në 8), secila me një emër (p.sh. Banaku, Bari) dhe lidhjen e vet: Port COM / USB (COM3 në Windows, /dev/ttyUSB0 në Linux/Android) me shpejtësinë, ose rrjet përmes një konvertuesi serial-në-rrjet (adresa IP dhe porti TCP, p.sh. 4001).
• Protokolli: Kërko (Toledo) = arka dërgon W dhe peshorja përgjigjet me peshën (Toledo 8217, kështu është zakonisht OS6X; edhe mesazhet e gjendjes e paqëndrueshme/mbingarkesë/nën zero) ose I vazhdueshëm = peshorja vetë dërgon vazhdimisht peshën (ST,GS, 0.512kg, US = e paqëndrueshme) ose Dialog 06 (i kalibruar), shih më poshtë, ose DIGI (Type B) = arka dërgon ENQ dhe DIGI përgjigjet me gjendjen, neto, tarën, çmimin për kg dhe shumën (37 karaktere: <status> <toestand> CR 0<netto> CR 4<tarra> CR U<kiloprijs> CR T<bedrag> CR LF; gjendja biti 1 = e qëndrueshme, biti 2 = nën zero, biti 3 = shumë e rëndë, biti 4 = shumë e lehtë), ose Gram = arka dërgon ENQ, pret ACK, dërgon DC1 dhe lexon SOH STX <S/U/F> <teken> <gewicht> <eenheid> <BCC> ETX EOT. Vendosni në peshore të njëjtin protokoll dhe shpejtësi. Bitët e të dhënave / pariteti: 8N1 (Aclas, Adam Equipment, DIGI, Dini Argeo, Excell Precision, Gram, Kern & Sohn, Minebea Intec, Ohaus, Precisa, Sartorius, Star Micronics, UWE, Wedderburn, Wintec) ose 7E1 (A&D, Avery Berkel, Avery Weigh-Tronix, Balanzas Marques, Baxtran, Brecknell, CAS, Datalogic, Mettler Toledo 8217, Rice Lake, Zebra); Dialog 06 është gjithmonë 7O1. Kërko lexon edhe NCI (Avery Weigh-Tronix, Brecknell, Rice Lake BP-R): te W peshorja përgjigjet LF 1.234KG CR LF S00 CR ETX; rreshti i gjendjes (S + 2 ose 3 bajte) tregon nëse lëviz (bajti 1 biti 0), nëse është shumë e lehtë (bajti 2 biti 0) apo shumë e rëndë (bajti 2 biti 1); ^^^^^ = shumë e rëndë, _____ = shumë e lehtë.
• Dialog 06 (Checkout-Dialog 06, protokolli evropian për një peshore të kalibruar në arkë): arka dërgon çmimin për kilogram (dhe tarën e produktit) te peshorja; peshorja peshon, llogarit vetë shumën dhe shfaq çmimin për kilogram, peshën dhe shumën në ekranin e vet (të kalibruar). Arka merr peshën dhe shumën; në dritaren e peshimit shkruhet "llogaritur nga peshorja". Gjithmonë 9600 baud, 7 bit të dhënash, paritet tek, 1 bit ndalimi (shpejtësia në cilësim atëherë nuk vlen). Rrjedha: EOT STX 01 ESC <kiloprijs 6> ESC ETX (me tarë: rekordi 03 me 4 shifra gram) → ACK; ENQ → STX 02 ESC 3 ESC <gram 5> ESC <kiloprijs 6> ESC <bedrag 6> ETX; NAK → EOT STX 08 ETX → STX 09 ESC <code> ETX (22 = ende jo gati, atëherë sërish pas 100 ms; 20 = lëviz; 21 = ngrije fillimisht; 30/31 = shumë e lehtë; 32 = shumë e rëndë; 11 = çmim i pavlefshëm). Kodet e kontrollit: shumë peshore Dialog 06 kërkojnë herë pas here (p.sh. çdo 30 peshime) kodet e kontrollit të softuerit të arkës (rekordi 11 → rekordi 10). Këto kode dhe mënyrën si llogariten prodhuesi i peshores ia jep vetëm furnitorit të arkës. Plotësoji te Kodet e kontrollit (çifte me 4 karaktere heksadecimale, p.sh. 74AE 1B2C); arka i dërgon kur peshorja i kërkon. Nëse peshorja llogarit me një numër të ndryshueshëm (Z) dhe kodet fikse nuk përputhen, arka e njofton këtë; atëherë kërkoji furnitorit ta konfigurojë peshoren pa këtë kontroll, ose përdor Toledo.
• Peshoret lidhen me kompjuterin ose pajisjen ku funksionon serveri i arkës; të gjitha arkat dhe tabletët peshojnë përmes serverit të arkës dhe zgjedhin në dritaren e peshimit cilën peshore përdorin. Testo peshon një herë.
• Rrjeti funksionon kudo.
• Shkruaj peshën edhe me dorë: aktiv = edhe me peshore pesha mund të shkruhet me dorë; pa OS6X kjo është gjithmonë e mundur.

Skano etiketat (shenjë te peshorja: Aclas TS6X, një peshore tjetër PC ose AI, seria LS ose LH15X; peshore + printer etiketash, një për lokal):

• Adresa IP: nevojitet vetëm për Dërgo te TS6X. Peshimi dhe skanimi i etiketave funksionojnë pa të. Nëse arka funksionon në vetë TS6X, lëre bosh: arka atëherë i dërgon vetes (127.0.0.1). Nëse e njëjta peshore peshon edhe në arkë, të dyja shenjat janë te e njëjta peshore (Kërkimi e përgatit kështu).
• Skano etiketat: skanim etiketash në ekranin e porosive. Cakto si duket barkodi, njësoj si në TS6X: fillon me (20–29, standard 28), numri i shifrave për PLU (4, 5 ose 6) dhe pastaj pesha në gram ose çmimi në cent, plus shifra e kontrollit (EAN-13). Poshtë cilësimit ka një shembull.
• Numrat PLU: te Cilësimet → Produktet një produkt që peshohet merr një çmim për kilogram, mundësisht një tarë dhe një numër PLU (unik). Numrin PLU e zgjedh nga një listë (Pa PLU, i radhës i lirë, Numër tjetër…); kur shënon Çmim për kilogram, numri i radhës i lirë është vendosur tashmë. Nevojitet vetëm për etiketat dhe PLU-të e TS6X: pa TS6X mund të mbetet Pa PLU.
• Dërgimi i drejtpërdrejtë funksionon në Windows dhe Linux; në Android dhe macOS përdorni skedarin PLU. Në instalimin e parë kontrollo emrat e fushave të skedarit PLU dhe kodet në aclas-plu.ps1 me manualin e SDK të peshores së dorëzuar (një vend për ta ndryshuar: ACLAS_PLU_KOLOMMEN në packages/shared/src/weegschaal.ts).

Portali i menaxhimit: njoftimi te portali ka funksionin Peshorja (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) me ndezur/fikur dhe peshoret sipas modelit (p.sh. TS6X (op dit apparaat), 2x OS6X, PS1CX, Ariva-S, DS-781, LS6RX, 5 producten per kilo); pa adresa IP, porte COM apo adresa Bluetooth.

Ligji i metrologjisë: një peshore me të cilën shet duhet të jetë e kalibruar (klasa III, si OS6X). Me Toledo/vazhdimisht arka llogarit me peshën që jep peshorja; me Dialog 06 peshorja e kalibruar llogarit vetë çmimin.

Kodi: packages/shared/src/weegschaal.ts (protokollet, etiketat, skedari PLU), apps/pos-server/src/lib/weegschaal.ts dhe routes/weegschaal.ts; ekranet WeegschaalInstellingen.tsx dhe WeegDialoog.tsx.

Thuisbezorgd.nl / Takeaway.com

Porositë nga Thuisbezorgd.nl vijnë drejtpërdrejt në arkë, pa ndërmjetës (pa Deliverect, HubRise etj.): Just Eat Takeaway JET Connect komunikon me portalin e menaxhimit të Pin Voordeel, dhe arka i merr mesazhet e saj prej andej.

Në Belgjikë platforma quhet Takeaway.com: e njëjta kompani (Just Eat Takeaway) dhe e njëjta lidhje. Për një lokal belg, në ekrane, njoftime, në fletën e punës dhe në portalin e menaxhimit kudo shkruhet Takeaway.com në vend të Thuisbezorgd.nl. Më poshtë Thuisbezorgd vlen për të dyja.

Pse përmes portalit? Arka ka nevojë vetëm për PORTAAL_URL dhe PORTAAL_SLEUTEL (shih Portali i menaxhimit) dhe bën vetëm kërkesa dalëse.

Konfigurimi (Cilësimet → Platformat e dërgesave → Thuisbezorgd.nl / Takeaway.com, e drejta Konfiguro lokalin, pagesat dhe printerët; deri tani kjo ishte te Cilësimet → Biznesi):

1. Aktivizo Përdor Thuisbezorgd (vlen menjëherë, pavarësisht nga Ruaj).
2. Regjistrohu te Thuisbezorgd. Pastaj lokali zgjedh te Thuisbezorgd (Partner Hub ose menaxheri i llogarisë) OptimumPOS / Pin Voordeel si arkë. JET nis atëherë një seancë onboarding; portali gjen arkën e regjistruar (sipas kodit postar dhe emrit, ndryshe Pin Voordeel e lidh seancën me dorë në portal), dërgon konfigurimin dhe i kërkon arkës menunë. Pas kësaj lidhja bëhet aktive.
3. Shëno produktet që mund të porositen përmes Thuisbezorgd (sipas grupit ose veç e veç), mundësisht me një përshkrim për Thuisbezorgd. Menuja (çmimi, opsionet si modifikues, alergjenët, TVSH) dërgohet automatikisht; PLU = id e produktit/opsionit. Pas një ndryshimi në katalog, arka e përditëson menunë brenda 30 sekondash; vetëm "mbaroi"/"sërish në dispozicion" kalon përmes API-së së disponueshmërisë.
4. Orari i hapjes Thuisbezorgd: veçmas për dërgesë dhe për të marrë (p.sh. 16:00-22:00, disa blloqe të ndara me presje). Ruhen me butonin Ruaj orarin e hapjes poshtë tyre dhe dërgohen si service times te Thuisbezorgd sapo lidhja të jetë gati.
5. Mbyllur përkohësisht / Sërish hapur (në NL/BE më së voni të nesërmen në mëngjes në 07:00 sërish hapur).

Porositë. Një porosi bëhet porosi e zakonshme pa tavolinë (bezorgen ose afhalen, emri i grupit TB <ordernummer>) me çmimet që pagoi klienti, plus kostot e dërgesës/shërbimit si rresht më vete dhe zbritjen e Thuisbezorgd si rresht zbritjeje; nëse totali prapë nuk përputhet, shtohet një rresht "Diferenca Thuisbezorgd". Fleta e punës shkon menjëherë në kuzhinë/bar (mund të çaktivizohet). Arka konfirmon brenda sekondash te portali, i cili ia njofton JET; nëse kjo nuk ndodh brenda 3 minutash ose arka është offline, JET merr "dështoi" dhe lokali kalon te Orderpad.

Butoni Thuisbezorgd në shiritin e sipërm (me numrin e porosive në vazhdim): lista, klienti dhe adresa, ora e gatishmërisë/dërgesës dhe rrjedha kohore (track & trace): marrë, korrieri drejt lokalit, korrieri në lokal, drejt klientit, dorëzuar (nga JET), plus hapat e vetë lokalit (në përgatitje, gati, në rrugë/dorëzuar kur dërgon vetë, marrë nga klienti). Një hartë live me korrierin JET Connect nuk ia ofron arkës; atë e sheh klienti në aplikacionin e Thuisbezorgd. Porosia e re, anulimi dhe "korrieri në lokal" japin një shirit portokalli dhe një tingull. Përfundo (paguar online) e mbyll pagesën me mënyrën e pagesës online; nëse klienti paguan te dera, thjesht paguaj si zakonisht. Një anulim nga Thuisbezorgd e anulon porosinë dhe printon një fletë kuzhine "ANULUAR".

Kodi: apps/pos-server/src/lib/thuisbezorgd.ts, routes/thuisbezorgd.ts; ekranet ThuisbezorgdInstellingen.tsx dhe Thuisbezorgd.tsx. Ana e portalit: horecapos-portaal/src/thuisbezorgd.mjs (shih README-n e portalit).

Numërimi në portalin e menaxhimit. Numri i porosive Thuisbezorgd për ditë përfshihet në njoftimin te portali i menaxhimit (verkoopTelling në lib/portaal.ts): të ardhura dhe të paanuluara, në ditën e ardhjes. Një porosi Thuisbezorgd që paguhet në arkë (edhe Përfundo (paguar online)) nuk llogaritet aty edhe një herë te marrja/dërgesa. Të dhënat e Thuisbezorgd janë në bazën e të dhënave të arkës dhe kështu përfshihen normalisht në kopjet rezervë të arkës.

Dyqani online dhe porositja online

Çdo lokal mund të ketë dyqanin e vet online: një faqe porosish (dhe aplikacion) me identitetin vizual të lokalit për marrje, dërgesë, porositje në tavolinë me kod QR dhe rezervime, me pagesë online (MultiSafepay ose Buckaroo) ose pagesë në marrje/dërgesë. Dyqani online është projekt më vete, horecapos-webshop (Node.js, shih README-në atje), dhe punon në të njëjtin server si portali i menaxhimit.

Aktivizimi dhe konfigurimi bëhen te menaxhimi i dyqanit online: butoni Menaxho dyqanin online në portalin e klientit (pronari) ose te instalimi në portalin e menaxhimit (Pin Voordeel). Aty janë aktiv/joaktiv, adresa e uebit (<zaak>.<webshopdomein> ose një domen i vetin), identiteti vizual (ngjyrat, logoja, fotoja e kokës, shkronjat), oraret e hapjes dhe intervalet kohore për marrje dhe dërgesë, zona e dërgesës (kode postare, rreze ose një zonë në hartë, me kosto dhe minimum), pagesa, kodet e zbritjes, tekstet, gjuhët, kodet QR për tavolinat, rezervimet dhe aplikacioni (i instalueshëm si PWA; një aplikacion Android përmes një Trusted Web Activity), si dhe njoftimet push (opsionale, të çaktivizuara si parazgjedhje): klienti aktivizon një njoftim në faqen e porosisë së tij dhe merr një njoftim push kur porosia është gati ose në rrugë; kush dëshiron merr edhe herë pas here një ofertë, që lokali e dërgon nga menaxhimi i dyqanit online (skeda Njoftime push). Funksionon në Android dhe në kompjuterë (Chrome, Edge, Firefox, Samsung Internet), në aplikacionin Android, si dhe në iPhone dhe iPad (iOS 16.4 ose më i ri) nëse klienti e vendos dyqanin online në ekranin bazë. Nuk dërgohet asnjë SMS ose e-mail dhe nuk ruhet asnjë emër ose numër. Detaje në README-në e dyqanit online.

Menuja. Arka e dërgon menunë vetë: të gjitha produktet aktive (jo me kilogram), sipas grupit të produkteve, me çmim, opsione zgjedhjeje, alergjenë, gjendjen e shitur dhe foton e produktit, plus tavolinat dhe të dhënat e lokalit, si dhe cilat kanale marketingu janë aktive (për kutinë "të marr oferta" gjatë pagesës, shih Marketing me SMS dhe email). Kjo ndodh në nisje, sapo aktivizohet dyqani online, brenda 30 sekondave pas një ndryshimi në katalog dhe brenda pak sekondash pas një ndryshimi te Cilësimet → Lokali, si marketingu ose karta e besnikërisë (ose me Dërgo menunë tani). Një produkt mund ta mbash jashtë dyqanit online te menaxhimi i dyqanit online (fshih), ose në bazën e të dhënave me artikel.webshop = false.

Porositë. Marrja dhe dërgesa bëhen një porosi e zakonshme pa tavolinë (emri i grupit WEB <bestelnummer>) me çmimet që pa klienti, plus koston e dërgesës dhe tarifën e transaksionit si rreshta më vete dhe një kod zbritjeje si rresht zbritjeje; nëse totali prapë nuk përputhet, shtohet një rresht "Diferenca e dyqanit online". Bakshishi i klientit nuk llogaritet si xhiro: ai shkon te Përfundo (paguar online) si bakshish në pagesë. Porositja në tavolinë (kod QR) shkon te llogaria e hapur e asaj tavoline (paguar online: si grup më vete në atë tavolinë). Fleta e kuzhinës shkon menjëherë te kuzhina/bari (mund të çaktivizohet te dritarja Dyqani online). Arka konfirmon brenda sekondash me numrin e faturës; klienti merr atëherë "marrë" dhe një email. Nëse arka është offline, dyqani online nuk pranon porosi (klienti e sheh menjëherë) dhe i dërgon email lokalit nëse një porosi pret shumë gjatë. Rezervimet nga dyqani online shkojnë te Rezervimet (vetëm nëse rezervimi në arkë është aktiv). Nëse ka një maksimum për interval kohor (Dërgesa dhe intervalet kohore), llogariten edhe porositë e dyqanit online me një orë në atë interval.

Belgjikë (kutia e zezë). Një porosi nga dyqani online shkon menjëherë si porosi (signOrder) te kutia e zezë, para fletës së kuzhinës, njësoj si Porosit në arkë. Nëse kjo nuk ia del, ajo nuk hyn në arkë dhe dyqani online e dërgon përsëri më vonë. Ajo që ende nuk është testuar me kutinë e zezë është e çaktivizuar në menunë e dyqanit online (karta dhuratë, kode zbritjeje, me llogari, në dhomë, menu, opsione me pagesë shtesë, happy hour dhe bakshish) dhe refuzohet nëse një dyqan online i vjetër e dërgon gjithsesi. Përfundo kontrollon bakshishin, pagesën me llogari dhe në dhomë njësoj si arka.

Në dhomë (lidhje hoteli, Cilësimet → Hotel → Vetëshërbim → Në dyqanin online): menuja merr kamer: { maxBedrag }; dyqani online dërgon betaling.wijze = "kamer" me kamer dhe achternaam. Arka e kontrollon mysafirin në softuerin e hotelit (jo në tavolinë, jo me kartë dhuratë) dhe e ruan me porosinë; Përfundo (në dhomë) e paguan në dhomë dhe e regjistron faturën në llogarinë e hotelit. Faturë përmbledhëse për pagesën me llogari: fatura atëherë mbetet si zë i hapur.

Butoni Dyqani online në shiritin e sipërm (me numrin e porosive në vazhdim): lista, klienti dhe adresa, ora e dëshiruar ose "sa më shpejt", mënyra e pagesës dhe rrjedha kohore. Hapat Në përgatitje, Gati dhe Në rrugë klienti i sheh drejtpërdrejt në dyqanin online (dhe me email, nëse lokali e dëshiron). E paguar në arkë = Përfunduar; Anulo anulon vetëm rreshtat e asaj porosie të dyqanit online, printon një fletë kuzhine "ANULUAR", dhe për një porosi të paguar online dyqani online i kthen paratë. Mbërritur, mosparaqitje ose anuluar te një rezervim kthehet gjithashtu te dyqani online. Një porosi ose rezervim i ri jep një shirit portokalli dhe një tingull.

Kodi: apps/pos-server/src/lib/webshop.ts, routes/webshop.ts; ekrani Webshop.tsx. Ana e portalit: horecapos-portaal/src/webshop.mjs.

Arka dhe dyqani online njësoj (çdo pjesë aktivizohet veçmas, si parazgjedhje joaktiv; një dyqan online më i vjetër i shpërfill fushat e reja). Ajo që është aktive në arkë funksionon edhe në dyqanin online:

• Happy hour: dyqani online llogarit të njëjtin çmim si arka në atë moment (çmimi normal i vizatuar dhe emri i happy hour), edhe me sezon.
• Periudhat e menusë dhe mënyra e porosisë (nëse janë aktive): dyqani online tregon vetëm atë që shitet tani, dhe për marrje e dërgesë çmimin dhe produktet e asaj zgjedhjeje (në tavolinë: në lokal). Menuja merr për çdo produkt prijzen (afhalen, bezorgen) dhe nietBij, si dhe listën dagdelen.
• Menutë: mysafiri zgjedh pjatat (fikse dhe me zgjedhje, me opsionet e tyre); në arkë shfaqet si rresht menuje me pjatat poshtë tij dhe çmimi i menusë i ndarë (TVSH-ja për çdo pjatë është e saktë). Pjatat që i përkasin vetëm një menuje dërgohen si menuArtikelen. Një dyqan online i vjetër pa zgjedhje: menuja shfaqet në faturë si produkt i zakonshëm, si më parë.
• Stoku mbaroi = shitur, edhe opsionet me një përbërës që ka mbaruar.
• Alergjenët: joaktivë në arkë = nuk shfaqen në dyqanin online.
• Karta e besnikërisë: gjatë pagesës mysafiri mund të mbledhë pikë (me numër telefoni ose e-mail); arka e lidh klientin me porosinë dhe pikët shtohen gjatë pagesës (shkëmbimi bëhet në lokal). Dyqani online tregon bilancin.
• Kartat dhuratë (Cilësimet → Biznesi → Kartat dhuratë → Shit karta dhuratë në dyqanin online, vetëm me bilanc): mysafiri blen një kartë dhe paguan online; arka krijon kartën, e cila aktivizohet menjëherë, dhe kodi kthehet te dyqani online përmes portalit (statusi dhe e-mail). Nëse është aktive edhe Kartë dhuratë si mënyrë pagese, mysafiri mund të zgjedhë te marrja "me kartë dhuratë në lokal".
• Kodet e zbritjes (Cilësimet → Kodet e zbritjes, me çelësin te Biznesi): për çdo kod në arkë dhe/ose në dyqanin online; përdorimi numërohet bashkë për të dyja.
• Pauzë dhe ngarkesë: butoni Dyqani online në shiritin e sipërm: Vendos dyqanin online në pauzë (me një tekst për mysafirin) dhe Ngarkesë (minuta shtesë). Arrin te dyqani online brenda pak sekondash.
• Rezervimi online me rregullat e arkës (Cilësimet → Biznesi → Rezervimet): maksimumi i personave, ditë përpara, intervali i rezervimit, minimumi paraprak dhe oraret për çdo ditë të javës.
• Dërgesa dhe intervalet kohore: shih Dyqani online ndjek arkën te Dërgesa dhe intervalet kohore.
• All-you-can-eat në tavolinë (Cilësimet → Lokali → All-you-can-eat → Edhe kur porositet në tavolinë përmes kodit QR): nëse në tavolinë po vazhdon një paketë, mysafiri i sheh pjatat e paketës si Të përfshira për € 0, me raundet, maksimumin për person, kohën e pritjes dhe kufirin e kohës. Pjesën tjetër e paguan normalisht; gjithçka shkon në llogarinë e tavolinës. Nëse gjendja në tavolinë sapo ka ndryshuar, arka e refuzon porosinë dhe mysafiri porosit përsëri.
• Në llogari (Cilësimet → Fatura → Pagesë në llogari → Edhe në dyqanin online): shih Në dyqanin online te Pagesë në llogari.
• Online në listën e pritjes (Cilësimet → Lokali → Lista e pritjes): shih Online në listën e pritjes te Lista e pritjes për klientët pa rezervim.
• Upsell: "Diçka tjetër?" (opsionale, si parazgjedhje joaktiv; Cilësimet → Biznesi → Paguaj → Upsell në dyqanin online): zgjidh kategoritë (p.sh. pije, salca, ëmbëlsira) dhe sa sugjerime. Në dyqanin online shfaqen atëherë, te shporta dhe gjatë pagesës, produkte nga këto kategori që nuk janë ende në shportë (vetëm ajo që shitet tani, jo të mbaruara dhe pa zgjedhje të detyrueshme); mysafiri i shton me një prekje. Asnjë kategori e zgjedhur = joaktiv, si më parë. Kioski ka upsell-in e vet (shih Kiosk vetëshërbimi).

Për këtë, menuja e dyqanit online ka versie: 2 me fushat menuArtikelen, allergenenAan, happyhours, menus, klantenkaart, cadeaubon, kortingscodes, pauze, drukteMin, volgt, bezetting, reserveren.online, ayce, opRekening, wachtlijst dhe upsell. Konfirmimi për portalin ka gjithashtu cadeaubonnen (kode), klant (pikë) dhe plek (lista e pritjes).

Numërimi në portalin e menaxhimit. Marrja dhe dërgesa përmes dyqanit online numërohen veçmas (webshop, webshopGeannuleerd në verkoopTelling), në ditën e ardhjes, dhe nuk numërohen edhe një herë te marrja/dërgesa. Porositja në tavolinë numërohet normalisht te tavolina.

Pagesa me kartë dhe terminalet e pagesave

Cilësimet → Pagesa (vetëm administratori):

• Terminalet: për çdo terminal një emër, ID-ja e terminalit dhe çelësi API i vet nga PinPortal (Klienti → Ndrysho klientin → Të tjera → API Keys). Pas ruajtjes nga çelësi duket vetëm fundi; ai nuk kthehet kurrë te shfletuesi. Me Testo lidhjen kontrollon çelësin dhe terminalin.
• Modaliteti test: imiton një terminal (pas ±7 s me sukses; një shumë që mbaron me 13 cent refuzohet). I dobishëm për të testuar pa terminal pagese.

Nëse ka të paktën një terminal me çelës API (ose modaliteti test është aktiv), atëherë Paguaj → Kartë / Bancontact e nis pagesën automatikisht në terminal, për shumën që llogarit serveri.

Për sa kohë lidhja është aktive, serveri e pranon "kartë" vetëm me një pagesë të suksesshme në terminal për pikërisht atë porosi dhe atë shumë. Kërkesat dërgohen si në PHP-SDK zyrtar si formular i thjeshtë, me API-në rezervë (api-backup.pinvandaag.com) nëse API-ja kryesore nuk përgjigjet. Çdo përgjigje e API-së shfaqet me [pin] në dritaren e serverit, e dobishme kur ka defekte. Një pagesë e suksesshme që ende nuk është përpunuar (p.sh. tableti u fik) gjendet sërish në pagesën e radhës të asaj porosie.

Bakshishi (kartë, para në dorë dhe kartë dhuratë)

Në ekranin e pagesës, te çdo mënyrë pagese ka një rresht butonash bakshishi: Asnjë, 5%, 10%, 15% (rrumbullakosur lart në 10 cent), Rrumbullako (në euron e plotë të radhës) dhe Shumë tjetër. Me kartë klienti paguan shumën + bakshishin njëherësh në terminal; me para në dorë bakshishi llogaritet te kusuri dhe në sirtarin e arkës. Në faturë shfaqet shuma e paguar me kartë me "nga të cilat bakshish" poshtë saj; TOTALI dhe TVSH-ja mbeten të njëjta, sepse bakshishi nuk është xhiro. Në raportin X/Z bakshishi shfaqet sipas mënyrës së pagesës dhe si "Bakshishi gjithsej".

Administratori i cakton butonat e bakshishit te Cilësimet → Lokali → Bakshishi: aktiv/joaktiv, cilat përqindje (deri në 4, p.sh. "5, 10, 15"), nëse shfaqet butoni "Rrumbullako" dhe me cilat mënyra pagese (kartë, para në dorë, kartë dhuratë) lejohet bakshishi. "Asnjë" dhe "Shumë tjetër" janë gjithmonë aty.

"Bëje …" shfaqet gjithmonë, te çdo mënyrë pagese, edhe kur butonat e bakshishit janë joaktivë (pa cilësim): klienti e rrumbullakos vetë llogarinë lart dhe diferenca është bakshish. Ka butona me euron e plotë të radhës dhe shumat e rrumbullakëta të radhës (p.sh. € 28,00 → 29, 30, 40; € 44,00 → 45, 50, 60) dhe Total tjetër për ta shkruar vetë totalin. Prek sërish butonin e zgjedhur = pa rrumbullakim. Më së shumti € 500 bakshish (i njëjti kufi si te serveri i arkës).

Pa internet

Arka funksionon në rrjetin lokal dhe nuk ka nevojë për internet; vetëm pagesa me kartë përmes lidhjes ka nevojë. Nëse lokali nuk ka internet, në shiritin e sipërm shfaqet Pa internet · kartë manualisht (kontrollohet çdo minutë). Atëherë në ekranin e pagesës, dhe po ashtu pas një nisjeje të dështuar në terminal, shfaqet butoni Tashmë paguar me kartë në terminal: paguaj shumën me kartë në vetë terminalin dhe regjistroje kështu.

Planet e sallës dhe tavolinat

Cilësimet → Planet e sallës (vetëm administratori):

• Shto planet e sallës (p.sh. Salla, Tarraca, Serra), riemërtoji, fshiji dhe ndrysho renditjen me ◀ ▶.
• Shto tavolina me butonat mbi rrjetë (e rrumbullakët, katrore, e gjatë, tavolinë në këmbë) dhe tërhiqi me miun ose gishtin në vendin e tyre. Këndi blu i një tavoline të zgjedhur e zmadhon ose e zvogëlon.
• Për çdo tavolinë cakto emrin/numrin, numrin e personave (karriget rreth tavolinës llogariten) dhe formën; dyfishoje ose fshije.
• Me tastierë: shigjetat zhvendosin (Shift = hap më i madh), Delete fshin.
• Ndryshimet vlejnë vetëm pas Ruaj; "Zhbëj" i kthen të gjitha mbrapsht.
• Një tavolinë ose plan salle me një porosi të hapur nuk mund të fshihet. Tavolinat e fshira ruhen në porositë e vjetra.

Kalo konfigurimin te një lokal i dytë

Cilësimet → Import/Eksport (vetëm administratori). Nëse e ke konfiguruar plotësisht një lokal, eksporto konfigurimin në një skedar .json dhe importoje në arkën e lokalit të dytë. Mund të zgjidhet për çdo pjesë:

• Produktet: grupet, produktet, çmimet (edhe sipas mënyrës së porosisë), TVSH-ja, opsionet, menutë, happy hours (me sezon), periudhat e menusë, alergjenët, përbërësit/recetat, kartat me vula, paketat all-you-can-eat dhe fotot e produkteve.
• Planet e sallës: sallat dhe tavolinat.
• Cilësime të tjera: të gjitha opsionet e lokalit, printerët (pa adresë IP), lejet sipas rolit dhe kontabiliteti.

Nuk kalojnë kurrë: emri, adresa, kodi postar, qyteti, telefoni, emaili, numri i TVSH-së dhe rreshti mbyllës i faturës së lokalit, adresa email për raportin Z, terminalet e pagesave dhe çelësat e tyre, stafi dhe kodet PIN, si dhe e gjithë xhiroja, faturat, klientët dhe sasitë e stokut.

Importimi është shumë i mbrojtur: një paralajmërim i madh i kuq, një shenjë "E kuptoj...", sërish PIN-i i vet i administratorit, asnjë porosi e hapur, i njëjti shtet (normat e TVSH-së) dhe paraprakisht një kopje rezervë automatike. Importi bëhet në një transaksion të vetëm: nëse diçka shkon keq, nuk ndryshon asgjë. Produktet, grupet, përbërësit dhe tavolinat ekzistuese nuk fshihen, por hiqen nga arka (si te Fshi), që faturat dhe raportet e vjetra të mbeten të sakta.

Importo nga një arkë tjetër

Kalim pa i rishkruar të gjitha. Gjithmonë në dispozicion (pa çelës): te Cilësimet → Import/eksport (vetëm administratori) gjendet pjesa Importo nga një arkë tjetër.

• Çfarë: produkte (emri, çmimi me TVSH, TVSH, kategoria, kodi/PLU, stoku) ose klientë të kartës së besnikërisë (emri, telefoni, email, pikët, adresa, kodi postar, qyteti; emri dhe mbiemri bashkohen).
• Skedari: një eksport nga arka jote e mëparshme (Dobizzz/DoPos, Lightspeed, MplusKASSA, unTill, Tebi ...) ose një listë e jotja: CSV (; , tab ose |; UTF-8 ose Excel në format holandez) ose Excel (.xlsx), fleta e parë, me emrat e kolonave në rreshtin e parë. Një skedar i vjetër .xls ruaje fillimisht si .xlsx ose CSV.
• Pamja paraprake: arka i njeh kolonat nga emri (Omschrijving, Verkoopprijs incl. BTW, BTW %, Omzetgroep, Artikelnummer, GSM, Spaarpunten ...) dhe shfaq 10 rreshtat e parë. Nëse një kolonë nuk përputhet, zgjidhe vetë. Asgjë nuk ndryshon para Importo.
• Produktet: çmimet si 3,50, € 3,50 ose 1.234,50; TVSH si 21, 9%, 0,09, e lartë ose e ulët (e panjohur ose bosh: norma që zgjedh, si parazgjedhje më e larta). Kategoritë që nuk ekzistojnë ende krijohen (pa kategori: "Të importuara").
• Stoku (kolona Voorraad, Stock, Aantal ...): nëse Ndiq stokun është aktiv (Cilësimet → Biznesi), produkti ndjek stokun dhe stoku bëhet ajo sasi (një numërim në historikun e stokut, arsyeja "Të importuara"). Bosh: stoku mbetet siç është.
• Skedar shembull (CSV): një listë për ta plotësuar vetë (Naam;Productgroep;Prijs;Btw;Voorraad;Code), për shembull në Excel.
• Klientët: pikët shtohen si korrigjim "Importuar nga një arkë tjetër" (e dukshme në historik). Pëlqimi për SMS ose email nuk kalon (GDPR): kërkoje sërish. Aktivizo fillimisht kartën e besnikërisë.
• Produktet ekzistuese (i njëjti kod, ose pa kod i njëjti emër) dhe klientët (i njëjti telefon ose email) kapërcehen, ose përditësohen nëse e shënon këtë (te produktet: emri, çmimi, TVSH, kategoria dhe stoku). Rreshtat e dyfishtë në skedar merren një herë.
• Në fund: sa të reja, të përditësuara dhe të kapërcyera, me atë që nuk ishte në rregull për çdo rresht (p.sh. pa çmim). Deri në 5000 rreshta njëherësh. Në regjistër shfaqet si "Konfigurimi u importua".

Gjuhët (42, mes tyre turqisht, arabisht, darija, berberisht, polonisht, bullgarisht, hungarisht, rusisht, serbisht, shqip, persisht, tigrinjisht, amharisht, somalisht, papiamento, sranantongo, hindisht, urdu, indonezisht, vietnamisht, siriano-aramaisht, kinezisht dhe ukrainisht)

Pranë butonit © poshtë djathtas, në çdo ekran ka një buton me gjuhën (p.sh. NL dhe flamurin). Prek atë për menunë e zgjedhjes: gjuhët janë sipas rendit alfabetik, me emrin në gjuhën e vet para flamurit: Bahasa Indonesia (indonezisht), Čeština (çekisht), Darija (arabishtja marokene me alfabet latin), Deutsch, English, Español, Français, Hrvatski (kroatisht), Italiano, Kurdî (Kurmancî), Latviešu (letonisht), Lietuvių (lituanisht), Magyar (hungarisht), Nederlands, Papiamentu (papiamento), Polski, Português, Română, Shqip, Slovenčina (sllovakisht), Soomaali (somalisht), Sranantongo, Srpski (serbisht, me alfabet latin), Tarifit (berberishtja e Rifit), Tiếng Việt (vietnamisht), Türkçe, pastaj me alfabet cirilik Български (bullgarisht), Русский (rusisht) dhe Українська (ukrainisht), më pas gjuhët me alfabet arab: اردو (urdu), الدارجة (darija), العربية (arabisht), دری (dari), فارسی (persisht, farsi), پښتو (pashtu) dhe کوردی (سۆرانی) (kurdisht sorani), pastaj me alfabet siriak ܣܘܪܝܝܐ (aramaishtja siriake, suryoyo), me alfabet devanagari हिन्दी (hindisht), me alfabet ge'ez ትግርኛ (tigrinjisht) dhe አማርኛ (amharisht), me Tifinagh ⵜⴰⵎⴰⵣⵉⵖⵜ (tamazight, berberisht), dhe në fund 中文（简体）(kinezisht, e thjeshtuar). Të gjitha ekranet, butonat, njoftimet dhe mesazhet e gabimit të serverit të arkës përkthehen.

• Për punonjës: gjuha e zgjedhur ruhet te punonjësi i kyçur (gebruiker.taal). Nëse dikush hyn me një gjuhë tjetër, arka kalon menjëherë në të. Në vetë pajisjen mbahet mend gjuha e përdorur së fundi, që edhe ekrani i PIN-it të jetë që në fillim në atë gjuhë. Nëse zgjedh një gjuhë (në ekranin e PIN-it ose i kyçur) dhe hyn (sërish) brenda 10 minutash, ajo zgjedhje ka përparësi dhe bëhet gjuha e atij punonjësi. Ndërrimi e ringarkon ekranin; mbetesh i kyçur dhe llogaria e hapur mbetet e hapur.
• Herën e parë në një pajisje: nëse në një tablet ose kompjuter ende nuk ka gjuhë, arka niset në gjuhën e zgjedhur gjatë instalimit. Nëse nuk është zgjedhur gjuhë, atëherë në gjuhën e vetë pajisjes (shfletuesi ose sistemi operativ, edhe në aplikacionin Android), dhe nëse ajo nuk është në listë, në holandisht. Pas kësaj çdo pajisje mban mend zgjedhjen e vet.
• Evropa Lindore: polonisht, çekisht, sllovakisht, hungarisht, rumanisht, bullgarisht, kroatisht (edhe për boshnjakisht), lituanisht, letonisht, ukrainisht dhe rusisht: gjuhët e shumicës së punëtorëve migrantë nga Evropa Qendrore dhe Lindore në Holandë dhe Belgjikë.
• Ballkani: serbisht (me alfabet latin, siç e shkruajnë shumica e serbëve në Holandë dhe Belgjikë; edhe për malazezisht) dhe shqip (Shqipëri, Kosovë dhe Maqedoni e Veriut).
• Briri i Afrikës: tigrinjisht (Eritre) dhe amharisht (Etiopi), të dyja me alfabet ge'ez, dhe somalisht (me alfabet latin).
• Iran: persisht (farsi). Një pajisje në persishten e Afganistanit (fa-AF) merr dari, të tjerat farsi.
• Holanda Karaibike dhe Surinami: papiamento (Papiamentu, drejtshkrimi i Kuraçaos dhe Bonaires; edhe për Arubën) dhe sranantongo.
• Azia: hindisht (devanagari; edhe për sarnami hindustani), urdu (nga e djathta në të majtë), indonezisht dhe vietnamisht (alfabet latin, edhe në faturë).
• Marokene: darija (arabishtja marokene, gjuha e folur) me alfabet arab dhe me alfabet latin (siç e shkruajnë në mesazhe shumë holandezë me origjinë marokene), krahas arabishtes standarde. Berberisht: tarifit (e Rifit, me alfabet latin; shumica e holandezëve me origjinë marokene vijnë nga Rifi) dhe tamazight standarde marokene me alfabet Tifinagh.
• Nga e djathta në të majtë: arabisht (arabishtja standarde), urdu, darija me alfabet arab, dari dhe pashtu (Afganistan), persisht (farsi, Iran), kurdisht sorani (Irak/Iran) dhe aramaishtja siriake (suryoyo, me alfabet siriak). Shumat, kodet dhe tastet e numrave mbeten nga e majta në të djathtë. Kurdishtja kurmanxhi (Turqi/Siri) është me alfabet latin.
• Fleta e kuzhinës (kuzhinë/bar): si standard në gjuhën e punonjësit që e dërgon porosinë. Për çdo printer, te Cilësimet → Printerët → Gjuha e fletës së kuzhinës mund të caktohet edhe një gjuhë fikse (p.sh. ajo e kuzhinierit), me alfabet latin: 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 ose Türkçe. Bullgarishtja, rusishtja dhe ukrainishtja dalin në fletën e kuzhinës me transkriptim latin (printeri i faturave nuk njeh cirilikën). Alfabeti arab, siriak, devanagari, ge'ez dhe Tifinagh si dhe kinezishtja nuk mund të printohen në printer faturash: atëherë del darija me alfabet latin, tamazight si tarifit dhe të tjerat në holandisht. Tekstet fikse (TAVOLINA, Radha, NË PRITJE për thirrje, THIRR RADHËN, PRINTUAR MË VONË, Për të marrë, Banaku) përkthehen; emrat e produkteve dhe shënimet mbeten siç janë futur. Printerët që ishin në holandisht ndjekin pas kësaj punonjësin.
• Fatura e arkës (për të gjithë klientët): si standard në holandisht, pavarësisht nga gjuha e ekraneve. Një gjuhë tjetër zgjidhet te Cilësimet → Lokali → Gjuha e faturës (menjëherë poshtë tekstit në fund të faturës), vetëm gjuhë me alfabet latin. Kjo vlen edhe për pro forma, faturën e kthimit, kopjen, kartën dhuratë dhe faturën me email. Shumat, kodet e TVSH-së, numri i TVSH-së i lokalit dhe rreshtat fiskalë (Belgjikë) mbeten të njëjta; një tekst i vetë lokalit në fund të faturës mbetet ashtu siç e shkruan lokali.
• Produktet, grupet dhe opsionet quhen ashtu siç i fut lokali; ato nuk përkthehen.
• Gjuhën për punonjës mund ta caktosh edhe te Cilësimet → Stafi.
• Hyrja dhe manuali janë gjithashtu në të gjitha këto gjuhë. Përmes butonit © hapen në gjuhën e arkës; lart zgjedh me flamujt një gjuhë tjetër (kjo nuk ndryshon asgjë në arkë).

Për zhvilluesit: çdo tekst i dukshëm është në kod si vt('Nederlandse tekst') (apps/pos-web/lib/i18n.ts); teksti holandez është çelësi. Përkthimet janë në apps/pos-web/lib/vertalingen/<taal>.ts. Nëse mungon një përkthim, arka shfaq holandishten; testi i18n (pos-web) kontrollon që çdo tekst të jetë përkthyer në çdo gjuhë dhe që vendet {0} të jenë të sakta. Mesazhet e serverit të arkës mbeten në holandisht dhe përkthehen në shfletues (edhe me {0}, p.sh. një emër produkti në mesazh).

Konfigurimi i printerëve

Një arkë e re nuk ka printerë. Hyr si administrator (demo: 1111) dhe zgjidh Cilësimet në shiritin e sipërm.

• Printerët: shto aq printerë sa ka lokali (p.sh. arka, kuzhina, bari, pica), secili me një lidhje (zakonisht rrjeti: adresë IP dhe portë 9100) dhe gjerësi letre. Me Faturë testimi kontrollon nëse funksionon. Lart zgjedh cili printer printon faturën e arkës dhe pro forma (dhe hap sirtarin e arkës). Për çdo printer zgjedh edhe gjuhën e fletës së kuzhinës (shih Gjuhët); fatura e arkës mbetet në holandisht.
• Lidhja për çdo printer:
  • Rrjeti (adresa IP): adresa IP dhe porta (zakonisht 9100). Kështu ka funksionuar gjithmonë dhe kështu vazhdon: printerët ekzistues janë vetvetiu në rrjet.
  • USB: në Linux pajisja, për shembull /dev/usb/lp0. Në Android printeri USB i lidhur me pajisjen (kabllo OTG; bosh = printeri i parë USB). Në Windows dhe macOS zgjidh Printer i sistemit.
  • Serial (COM / ttyUSB): një portë COM (Windows), /dev/ttyUSB0 ose /dev/ttyS0 (Linux, Android) ose /dev/cu.… (macOS), me shpejtësinë (zakonisht 9600, 19200 ose 38400 baud). Edhe për një printer Bluetooth që Windows ose Linux e çiftëzon si portë COM ose /dev/rfcomm0.
  • Bluetooth: në aplikacionin HorecaPOS në Android, me adresën Bluetooth të printerit të çiftëzuar (p.sh. një printer faturash portativ). Çiftëzo fillimisht printerin te cilësimet e Bluetooth në Android.
  • Printer i sistemit (Windows / CUPS): printeri siç e njeh Windows ose CUPS (Linux, macOS), me drajverin e vet ose si Generic / Text Only. Fatura dërgohet e papërpunuar (RAW) te printeri, pa formatim nga drajveri.
  • I integruar (Sunmi, iMin ...): printeri brenda vetë arkës Android.
  • Kërko shfaq printerët dhe portat që sheh arka. Zgjidh njërin dhe adresa plotësohet.
• Protokolli: ESC/POS (pothuajse të gjithë printerët e faturave, edhe printerët Star në modalitetin ESC/POS) ose Star (Star Line Mode). Me Star arka e konverton vetë faturën; fatura duket njësoj.
• Pajisje shërbimi me printer të vetin: një pajisje shërbimi Android me aplikacionin HorecaPOS (p.sh. një terminal dore me printer portativ Bluetooth, ose një Sunmi si pajisje shërbimi) mund të printojë vetë. Regjistroje në vetë pajisjen (Cilësimet → Printerët → Pajisje shërbimi me printer të vetin) dhe te printeri zgjidh I lidhur me. Pajisja e shërbimit i merr faturat e saj nga arka; lëre aplikacionin të hapur atje. Nëse nuk funksionon (aplikacioni i mbyllur, jashtë rrezes së wifi-t), fleta e kuzhinës shkon në radhën e printimit, njësoj si me një printer rrjeti të fikur. Çregjistro pajisjen i kthen printerët te vetë arka.
• Printer për grup / produkt: për çdo grup artikujsh zgjidh në cilin printer del fleta e kuzhinës. Për çdo produkt mund ta zëvendësosh këtë me një printer të vetin ose "pa fletë kuzhine".

Produktet e njëjta bashkohen gjatë printimit: dy herë 1x Cola bëhet 2x Cola, në fletën e kuzhinës dhe në faturën e arkës. Vetëm produktet me të njëjtat opsione dhe shënim bashkohen.

Instaluesi për Linux e shton përdoruesin e arkës në grupet lp dhe dialout, që arka të mund të përdorë printerë USB dhe serialë.

Të duhet ndihmë?

Optimum POS · 085 560 00 60 · support@optimumpos.nl · hën–pre 9:00–20:00, sht–die 14:00–20:00