Priručnik HorecaPOS

Ovaj priručnik ima tri dijela: najprije za osoblje (poslugu), zatim za voditelja i na kraju za administratora. Svaki dio nadovezuje se na prethodni: voditelj može sve što može posluga, a administrator može sve.

Što točno vaša uloga smije, administrator postavlja u Postavke → Prava. Ako ne vidite neki gumb, vaša uloga za njega (još) nema pravo.

Ovaj priručnik nalazi se i u blagajni: dodirnite gumb © dolje desno na bilo kojem zaslonu i odaberite Priručnik ili otvorite http://<kassa-pc>:3000/handleiding. Pogledajte i uvod i API dokumentaciju.

Dio 1 · Osoblje

Prvi koraci

Prijava. Otvorite blagajnu na blagajni, tabletu ili mobitelu i unesite svoj PIN (od 4 do 8 znamenki). Zatim vidite tlocrt stolova.

Otvaranje stola. Dodirnite stol. Slobodan stol dobiva novu narudžbu; kod zauzetog stola nastavljate s postojećom narudžbom. Gore se prebacujete između prostorija (na primjer Sala i Terasa). Za šank koristite Brza prodaja, a za narudžbe za van Za van.

Naručivanje. Odaberi grupu proizvoda i dodirni proizvode. Pojavit će se na računu lijevo. Po želji najprije odaberi slijed (1 = odmah, 2 i 3 čekaju dok ih ne pozoveš). Dodirni Naruči: kuhinjski listići tada odlaze u kuhinju i šank. Dok još nisi dodirnuo Naruči, stavke možeš jednostavno ukloniti.

Naplata. Dodirni Naplati, odaberi Kartica / Bancontact, Gotovina ili Poklon bon, po želji napojnicu, i potvrdi. Kod plaćanja karticom plaćanje se samo pokreće na terminalu. Račun se ispisuje; možeš ga poslati i e-poštom.

Odjava. Odjavi se kad završiš, da nitko drugi ne radi pod tvojim imenom. Nakon 8 sati odjavljuješ se automatski.

Nema interneta? Blagajna normalno radi dalje. Ako gore piše Nema interneta · kartica ručno, unesi iznos izravno na terminalu za plaćanje i na zaslonu naplate odaberi Već plaćeno na terminalu.

Više skupina za jednim stolom

Za jednim stolom može sjediti više grupa, svaka sa svojim računom i svojim ispisom računa.

• Dodirni stol: slobodan = nova narudžba; jedna grupa = odmah ta grupa; više grupa = najprije odaberi ili + Nova grupa (naziv može ostati prazan).
• Na vrhu zaslona narudžbe nalazi se traka grupa: prebacivanje između grupa, + Grupa, Naziv grupe (npr. "Horvat") i Podijeli / premjesti.
• Podijeli / premjesti: za svaku stavku odaberi koliko ih ide (npr. 1 od 3× Pils) i u koju grupu, ili napravi novu grupu. Tako premještaš nešto što je na pogrešnom računu ili naknadno dijeliš "svatko plaća svoj dio". Ako grupa ostane prazna, nestaje.
• Više dijelova odjednom: tipkom + Još jedan dio pripremiš jedan dio i odabereš sljedeći (npr. ribu i Dry Martini na stol 2, ostatak na stol 35). Dio može ići i na + Drugi stol (tamo kao nova grupa). Tipkom Premjesti sve ide odjednom. ½ dijeli stavku na pola, i pola boce (0,667 postaje 2 × 0,3335).
• Spoji: sve s jednog ili više drugih stolova (ili grupa za ovim stolom) na ovaj račun, odjednom.
• Belgija: dijeljenje ili spajanje odjednom u crnoj je kutiji jedna promjena stola, kako to traži FOD, belgijska porezna uprava (UC242, UC251, UC252, UC4119bis). Ako se nakon narudžbe nešto prekriži ili se odobri popust na već naručenu stavku, to ide uz sljedeću poruku tog stola (narudžba, privremeni račun, promjena stola), a inače uz prodaju: stara stavka negativno, a nova pozitivno (UC226, UC4102, UC4104, UC4107, UC4110).
• Na zaslonu stolova narančasta točkica pokazuje koliko ima grupa; iznos je ukupan zbroj svih grupa.
• Račun i kuhinjski listić prikazuju "Stol 5 - grupa 2" ili "Stol 5 - Horvat".

Dijeljenje računa pri naplati

Naplata radi kao i uvijek: Sve odjednom. Na zaslonu naplate račun se sada može i podijeliti, gumbima ispod Natrag i Naplati (tako uvijek ostaju vidljivi, bez listanja):

• Podijeli jednako: s − i + odaberite na koliko osoba (zadano broj gostiju ili 2 ako blagajna ne prati goste). Zaslon prikazuje iznos po osobi; svatko plaća svoj dio karticom, gotovinom ili poklon-bonom (uz napojnicu po želji). Nakon svakog dijela odbrojava se ("još 3 osoba"); posljednji plaća točno ostatak.
• Vlastiti iznos: netko plaća fiksni iznos (npr. € 20); ostatak ostaje otvoren.
• Po proizvodu…: otvara Podijeli / premjesti kako bi se proizvodi stavili na zaseban račun i zasebno naplatili (kao gore).

Djelomično plaćanje knjiži samo plaćanje; račun ostaje otvoren, a na zaslonu narudžbe piše "već plaćeno … · još otvoreno …". Račun (sa svim plaćanjima) ispisuje se kod posljednjeg plaćanja, kao kod obične naplate. Plaćanje karticom preko integracije ide na točno djelomični iznos. Ako je već djelomično plaćeno, stavke se više ne mogu premještati u drugu grupu niti se mogu dodavati popusti; uklanjanje je moguće samo ako je otvoreno dovoljno. Svako djelomično plaćanje bilježi se u zapisnik.

Brza prodaja i za van (bez stola)

Gore desno na zaslonu stolova nalaze se Brza prodaja i Za van. Oboje odmah otvaraju narudžbu bez stola. Brza prodaja je prodaja na šanku (PDV za konzumaciju na mjestu); Za van koristi stopu PDV-a za van svakog proizvoda. S "Ime kupca" dodaješ ime; ono se pojavljuje na računu ("Za van – Horvat") i na vrhu kuhinjskog listića. Otvorene narudžbe bez stola prikazane su ispod gumba prostorija ("Bez stola: Za van #12 – Horvat"), da ih lako pronađeš. Ako se vratiš bez prodaje, prazna narudžba sama nestaje.

Oba gumba mogu se uključiti ili isključiti za svaki lokal u Postavke → Lokal, odmah ispod svijetle/tamne teme (zadano uključeno). Isključeno = gumb skriven; već otvorene narudžbe bez stola ostaju vidljive.

Dostava i termini

Narudžbe koje sam primaš na blagajni, na primjer telefonom ili na pultu, s istim pravilima kao web-trgovina: područja dostave i maksimalan broj narudžbi po terminu. Uključuje se u Postavke → Objekt → Dostava i termini, odmah ispod gumba Brza prodaja i Za van (zadano isključeno).

• Gumb Dostava na zaslonu stolova (pokraj Za van): upiši ime, telefon i adresu (s uključenim Brzi unos adrese: traženje po poštanskom i kućnom broju). Blagajna traži područje dostave i prikazuje trošak dostave, minimum i "besplatno od". Ako je adresa izvan područja, narudžba nije moguća.
• Područja dostave: po poštanskom broju (rasponi i pojedinačni brojevi, npr. 5000-5049, 5051, 5052 AB), unutar radijusa u km od objekta (zračnom linijom) ili područje na karti koje sam ucrtaš. Radijus i područje rade samo s nizozemskim adresama (lokacija preko PDOK-a). Po području: trošak dostave, minimum, besplatno od i dodatne minute; vrijedi prvo odgovarajuće područje odozgo, pa se vrste mogu kombinirati (npr. najprije nekoliko poštanskih brojeva, zatim područje, pa radijus za ostalo). Nema postavljenih područja = dostava svugdje, bez troškova i minimuma. Područja web-trgovine postavljaš zasebno (upravljanje web-trgovinom).
• Područje na karti: kod područja dostave odaberi vrstu Područje na karti, a zatim Crtaj na karti. Klikni na kartu da postaviš točke (barem 3); povuci točku da je pomakneš, klikni na točku da je ukloniš i povuci kružić na sredini ruba za točku između. Karta prikazuje i područja po radijusu i objekt. Pločice karte dolaze s OpenStreetMapa, pa je za kartu potreban internet; za samu dostavu nije (osim za pronalaženje adrese). Ako se adresa ne može pronaći, blagajna to javlja umjesto "izvan područja dostave".
• Trošak dostave stoji na narudžbi kao stavka "Bezorgkosten" i ponovno se izračunava nakon svake promjene (besplatno od, bez proizvoda = bez troška), dok još ništa nije plaćeno. Ispod minimuma nije moguće naplatiti; zaslon narudžbe pokazuje koliko još nedostaje, s gumbom Ipak za van (trošak dostave i minimum otpadaju).
• Vrijeme: Što prije (sada + vrijeme dostave, plus dodatne minute područja) ili termin od danas. Ako imaš radno vrijeme kod Thuisbezorgda, ono vrijedi i ovdje.
• Maksimum po terminu (0 = bez maksimuma; termin od 5 do 60 minuta): za Za van i Dostavu zajedno; ubrajaju se i narudžbe iz web-trgovine u blagajni. Ako je postavljen maksimum, i Za van traži vrijeme, a puni termini se ne mogu odabrati. Dvije blagajne istodobno za posljednje mjesto: dobiva ga samo jedna.
• Na radnom nalogu stoje adresa, ime, telefon i vrijeme; u "Bez stola" i na vrhu radnog naloga npr. "Dostava – 18:30 Horvat".

Proširenja (sve zadano isključeno; bez ovih postavki sve radi točno kao gore):

• Vlastito radno vrijeme za van i dostavu (po danu u tjednu, npr. 16:00-21:00 ili 11:30-14:00, 17:00-22:00; može i nakon ponoći: 17:00-01:00; prazno = taj dan zatvoreno). Isključeno = kao dosad (vremena kod Thuisbezorgd, ako postoje, inače cijeli dan).
• Neradni dani (npr. 25-12-2026, 26-12-2026): tada nema za van ni dostave.
• Narudžba unaprijed: od 0 (samo danas, kao dosad) do 14 dana. U prozoru Dostava/Za van tada najprije biraš dan; kasniji dan piše na radnom nalogu ispred vremena.
• Gužva: toliko minuta više kod "što prije" (blagajna i web-trgovina). Brzo se postavlja i gumbom Web-trgovina u gornjoj traci.
• Belgijske adrese (poštanski broj od 4 znamenke): kod radijusa ili područja na karti blagajna traži lokaciju preko OpenStreetMap (Nominatim; potrebni su ulica i mjesto).
• Web-trgovina slijedi blagajnu: blagajna je mjerodavna. Web-trgovina tada koristi područja dostave, vrijeme dostave i preuzimanja, termin, maksimum po terminu, radno vrijeme (ako je ovdje postavljeno), neradne dane i dane unaprijed s blagajne te u termin ubraja narudžbe primljene na blagajni. Isključeno = web-trgovina ima vlastite postavke (upravljanje web-trgovinom), kao dosad. Uključivanje ili isključivanje za van/dostave ostaje na web-trgovini.

Kôd: lib/bezorgen.ts, routes/bezorgen.ts, BezorgDialoog.tsx, BezorgInstellingen.tsx, BezorgKaart.tsx i lib/kaart.ts (karta, bez dodatnog paketa; isti kôd nalazi se u web-trgovini kao public/kaart.js).

Telefonija: prepoznati kupca kod telefonske narudžbe

Postavke → Telefonija (zadano isključeno; isključivanjem se sve čuva). Dva zasebna prekidača:

• Traži kupca po telefonskom broju kod dostave i za van: upišete li broj na zaslonu dostave, blagajna prikaže kupca s adresom i prethodnim narudžbama; Preuzmi podatke ispunjava ime, e-poštu i adresu. Radi i bez telefonske centrale.
• Prepoznavanje broja: kad kupac nazove, centrala (ili stolni telefon, FRITZ!Box, modem ili Android telefon) javlja broj. Na zaslonima se pojavljuje obavijest o tome tko zove: ime, adresa, zadnje narudžbe (s jelima i iznosom, i iz web-trgovine, Thuisbezorgda i platformi za dostavu), ukupni iznos i rezervacija. S Primi narudžbu za dostavu ili Primi narudžbu za van otvara se zaslon dostave sa svime već ispunjenim (uz uključenu dostavu i termine); narudžba se veže uz poziv, a obavijest nestaje sa svih zaslona. Gumb 📞 u gornjoj traci: pozivi iz zadnjih 24 sati. Može se isključiti po zaslonu (Prikaži obavijesti na ovom zaslonu).

Traži se u kartici vjernosti, narudžbama za dostavu i za van na blagajni, web-trgovini, Thuisbezorgdu, platformama za dostavu i rezervacijama. Brojevi se ujednačuju (+31 6 1234 5678, 0031612345678 i 06-12345678 su isti; i belgijski brojevi).

Kako broj stiže (moguće je više istodobno; isti poziv broji se jednom):

Odgovor sadrži pozivatelja, i kao contact (firstname, lastname, phone, email, address) za CRM predložak 3CX-a. Odlazni i interni pozivi ne prikazuju se; Samo ove linije ograničava na određene linije ili telefone. Pozivi se brišu nakon roka čuvanja (zadano 30 dana, GDPR). Probni poziv simulira poziv s nekog broja.

Kod: apps/pos-server/src/lib/telefonie.ts, routes/telefonie.ts, packages/shared/src/telefonie.ts; zasloni Telefonie.tsx, BezorgDialoog.tsx; Android android-app/native/java/Beller*.java. Dnevnik: Telefonija.

Vlastiti dostavljači: ture, predaja novca i praćenje narudžbe (track & trace)

Za objekte s vlastitim dostavljačima. Uključite to u Postavke → Objekt → Dostava → Vlastiti dostavljači (zadano isključeno). Dostavljaču nije potrebna aplikacija: dostavljač koristi stranicu u pregledniku vlastitog telefona (tko želi, koristi aplikaciju Optimum Bezorger: vidi Aplikacija za dostavljače u nastavku).

Stvaranje ture. U blagajni je gumb Ture (s brojem dostava koje još trebaju krenuti plus ture koje su na putu).

1. Kod Spremno za dostavu označi narudžbe koje idu. To su narudžbe za dostavu iz blagajne, web-trgovine i Thuisbezorgda (samo vlastita dostava; one s dostavljačem Thuisbezorgda ne).
2. Odaberi dostavljača (djelatnika) i sitniš koji nosi (zadano iznos iz postavke) i dodirni Stvori turu.
3. Pojavljuje se QR kod. Dostavljač ga skenira vlastitim mobitelom i za svaku adresu vidi ime, adresu s gumbom Ruta (navigacija), Nazovi, napomenu, željeno vrijeme i što treba naplatiti. Postoji kalkulator ostatka (kupac daje € 50 → ostatak € 31,50). Prijava nije potrebna. Poveznicu dijeli samo s dostavljačem: tko je ima, vidi adrese ove ture. S QR kod za dostavljača stvaraš novu poveznicu; stara tada više ne radi.
4. Dodirni Polazak kad dostavljač odlazi. Sitniš izlazi iz ladice (isplata novca, s razlogom). Kupac dobiva obavijest da je narudžba na putu:
   • kod narudžbe iz blagajne SMS-om i/ili e-poštom, ako su uključene Poruke kupcu (vidi Dostava i termini);
   • kod web-trgovine prema postavkama web-trgovine (e-pošta, SMS ili push obavijest);
   • kod Thuisbezorgda putem Thuisbezorgda.

Ako tura još nije krenula, još se može poništiti.

1. Na putu dostavljač za svaku adresu dodiruje Dostavljeno, gotovina, Dostavljeno, kartica (vlastiti POS uređaj) ili Dostavljeno (već plaćeno). Blagajna to odmah vidi. Ako dostavljač to ne može prijaviti, može se i u blagajni. Natrag u objektu dostavljač dodiruje Vratio sam se u objekt.

Predaja novca. Nakon ture dodirni Naplati (pravo Upravljanje ladicom blagajne):

• Za svaku narudžbu odaberi gotovina, kartica na vratima, već plaćeno ili nije dostavljeno (natrag). Ono što je dostavljač prijavio već je popunjeno.
• Blagajna naplaćuje svaku narudžbu s otvorenim iznosom bez novog računa (kupac već ima račun; ponovni ispis u Računi). Narudžba koja nije dostavljena izlazi iz ture i ostaje otvorena, pa može ići u sljedeću turu.
• Vidiš što se očekuje: sitniš plus primljena gotovina. Unesi što dostavljač predaje ili prebroji po novčanicama i kovanicama (Brojanje po novčanicama i kovanicama). Blagajna pokazuje je li točno ili koliko je viška ili manjka.
• Sitniš se vraća u ladicu (uplata novca). Razlika je vidljiva kod ture i u dnevniku, a pojavljuje se i kao blagajnička razlika u Z-izvještaju.

Praćenje narudžbe (track & trace) (uključuje se zasebno u postavci). Kupac kod statusa na putu dobiva poveznicu na stranicu za praćenje na portalu. Ta je poveznica u SMS-u ili e-poruci, a u web-trgovini na statusnoj stranici (Prati svog dostavljača). Na stranici za praćenje vidi se:

• priprema li se narudžba, je li na putu ili dostavljena;
• očekivano vrijeme: od lokacije dostavljača preko adresa koje su prije, inače željeno vrijeme;
• koliko je adresa još prije (bez prikazivanja drugih adresa);
• uz Dostavljač uživo na karti i dostavljač, objekt i vlastita adresa na karti (OpenStreetMap). Dostavljač sam uključuje dijeljenje lokacije na mobitelu (Dijeli moju lokaciju). Lokacija se šalje samo dok je stranica otvorena; stranica drži zaslon uključenim.

Stranice su na jeziku mobitela (svi jezici portala). U blagajni kod ture vidiš kada je lokacija zadnji put poslana (s poveznicom na kartu).

Privatnost. Portal čuva podatke ture (imena, adrese, brojeve telefona, lokaciju) samo dok tura traje. Pri obračunu sve se briše, a inače nakon 24 sati. Kupac vidi samo svoju narudžbu. Lokacija dostavljača vidljiva je samo tijekom ture i više nije čim se dostavljač vrati.

Planiranje tura (neobavezno)

Uključi ga u Postavke → Objekt → Dostava → Planiranje tura (zadano isključeno; radi s vlastitim dostavljačima). U prozoru Ture tada je gumb Predloži ture. Blagajna spaja narudžbe koje još trebaju krenuti u ture:

• narudžbe koje su blizu jedna drugoj i čija željena vremena padaju unutar vremenskog prozora (zadano 30 minuta) idu zajedno;
• do najvećeg broja adresa po turi (zadano 4), dok god tura (odlazak, sve adrese i povratak u objekt) ne traje dulje od maksimuma (zadano 45 minuta);
• za svaku turu najbolji redoslijed, udaljenost (km), vrijeme vožnje tamo i natrag i za svaku adresu očekivani dolazak pri polasku sada. Ako je on kasniji od željenog vremena, uz njega piše kasnije od traženog.

S Koristi ovu turu označavaš te narudžbe, tim redoslijedom; odaberi dostavljača i dodirni Stvori turu. Kod ture koja još nije krenula Najbolji redoslijed slaže adrese najbržim redoslijedom (i na mobitelu dostavljača). Uz svaku turu prikazani su udaljenost i vrijeme vožnje.

Postavke: adrese po turi, koliko tura smije trajati, vremenski okvir, brzina dostavljača (bicikl ~15, skuter ~25, auto ~35 km/h u gradu) i minute po adresi (parkiranje, zvonjenje, naplata; zadano 2). Te brojeve može postaviti i voditelj: u prozoru Ture gumbom Postavi planiranje tura (ovlast Postavi planiranje tura, zadano uključena za voditelja; mijenja se u Postavke → Ovlasti). Uključivanje ili isključivanje planiranja tura i usluga ruta (adresa, API ključ) ostaju kod administratora.

Udaljenost i vrijeme vožnje, bira administrator:

• Procjena (zadano): zračna linija puta 1,35 (faktor obilaženja) uz brzinu dostavljača. Radi bez interneta i bez računa.
• OSRM: rute po cesti putem OSRM poslužitelja. Unesi adresu (https:// ili http:// u vlastitoj mreži). Javni demo poslužitelj (https://router.project-osrm.org) samo je za povremenu upotrebu; za svakodnevnu upotrebu postavi vlastiti OSRM poslužitelj ili odaberi pružatelja usluge.
• OpenRouteService: rute po cesti s vlastitim API ključem (besplatno se izrađuje na openrouteservice.org, s dnevnim ograničenjem). Adresa je zadano https://api.openrouteservice.org i može se promijeniti na vlastiti poslužitelj. Ključ ostaje na blagajni; zasloni prikazuju samo da je unesen.

S Testiraj isprobavaš uslugu. Ako usluga ne radi, planiranje se vraća na procjenu i to javlja. Adresa čija lokacija nije poznata (nema valjanog poštanskog broja i kućnog broja) u prijedlogu dolazi pod bez poznate lokacije i ne planira se. Izvoz konfiguracije uključuje postavke, ali ne i ključ.

Kod: lib/ritplanning.ts.

Aplikacija za dostavljače (neobavezno)

Uključite to u Postavke → Objekt → Dostava → Aplikacija za dostavljače (zadano isključeno; radi s vlastitim dostavljačima i upravljačkim portalom). Svaki dostavljač tada upari vlastiti telefon samo jednom, umjesto da za svaku turu skenira QR kôd:

1. Kod Upareni telefoni odaberite dostavljača (djelatnika), po želji naziv telefona, i dodirnite Upari telefon.
2. Pojavljuje se QR kôd. Dostavljač ga skenira u aplikaciji Optimum Bezorger (gumb Upari) ili kamerom telefona: tada se stranica otvara u pregledniku. Radi i bez aplikacije i može se staviti na početni zaslon.
3. Uparivanje vrijedi dok ga ne opozovete; telefon tada odmah više ništa ne vidi. Novo uparivanje za istog djelatnika zamjenjuje staro (na primjer kod novog telefona).

U aplikaciji ili na stranici nalaze se sve vlastite ture (svaka tura koju blagajna izradi za tog dostavljača), s istim gumbima kao kod ture: Ruta, Nazovi, za naplatu s kalkulatorom ostatka, Dostavljeno i Vratio sam se u objekt. Zasebno se uključuje:

• Samostalno preuzimanje narudžbi: dostavljač vidi dostave koje još trebaju ići u turu, označi što nosi i dodirne Ponesi. Blagajna izrađuje turu (ili ih dodaje ako taj dostavljač već ima turu koja još nije krenula); standardni sitniš ide s njim. Ono što je netko drugi već uzeo više se ne može uzeti.
• Samostalni polazak: Polazak u aplikaciji radi isto što i na blagajni (sitniš iz ladice, kupci dobivaju poruku).
• Karta uživo: kod Ture nalazi se gumb Karta s objektom, svim dostavljačima koji su na poslu i adresama koje još treba dostaviti. Dostavljač sam uključuje i isključuje Na poslu. Aplikacija šalje lokaciju i s isključenim zaslonom (Android: obavijest na traci dok je dijeljenje uključeno); web stranica samo dok je otvorena. Bez ove postavke lokacija se dijeli samo tijekom ture s track & trace.

Aplikacija za Android nalazi se na Google Playu i na stranici za preuzimanje na portalu (/download/). Verzija za iPhone je gotova, ali dolazi tek kad bude Apple razvojni račun; do tada iPhonei koriste web stranicu. Kod ture koju je dostavljač sam preuzeo piše sam preuzeo u aplikaciji.

Kôd: lib/bezorgersapp.ts, na portalu src/volgen.mjs, a aplikacija u repozitoriju horecapos-bezorger.

U dnevniku piše tko je stvorio turu, poslao je na put, prijavio dostavu i obračunao je, s iznosima. Isključivanje: nema gumba Ture; ture i postavke ostaju spremljene.

Na portalu: /bezorger/<sleutel> i /volg/<code>. Kod: lib/bezorgers.ts, routes/bezorgers.ts, Bezorgers.tsx i u portalu src/volgen.mjs.

Obavijest o predugom vremenu pripreme

Narudžba za van ili dostava gotova kasnije nego što je obećano: blagajna to primijeti i javi te može odmah poslati ispriku kupcu, po želji s bonom. Uključite to pod Postavke → Objekt → Dostava → Obavijest o predugom vremenu pripreme (zadano isključeno).

• Koje narudžbe: za van i dostava s obećanim vremenom, s blagajne (dostava i vremenski termini), iz web-trgovine i s Thuisbezorgd.nl / Takeaway.com.
• Kasni: toliko minuta (zadano 10) nakon obećanog vremena još nije gotovo ili na putu. Gotovo ili na putu znači: sve gotovo na kuhinjskom zaslonu, status gotovo ili na putu u web-trgovini ili kod Thuisbezorgd, poruka ✉ Gotovo / ✉ Na putu poslana kupcu ili naplaćeno. Blagajna provjerava svake minute.
• Obavijest: gumb Kasni u gornjoj traci s brojem (sa zvukom kod nove), uz svaku narudžbu obećano vrijeme i koliko minuta kasni. Narudžba nestaje sama kad je gotova ili na putu, ili gumbom Riješeno; ispod su one iz posljednjih 24 sati, s vremenom kad su bile gotove. Sve se bilježi u dnevnik.
• Web-trgovina: stranica statusa za gosta prikazuje da traje dulje, s novim očekivanim vremenom.
• Kod Thuisbezorgd to nije moguće (kupac pripada Thuisbezorgdu): tamo samo obavijest. Može se koristiti vlastiti tekst; {naam}, {zaak}, {code}, {korting} i {geldig} popunjavaju se automatski.
• Bon (samo uz uključene Kodove za popust): uz ispriku osobni kod za popust za sljedeću narudžbu (npr. SORRY-7K4Q2M), iznos ili postotak, za jednokratnu upotrebu, vrijedi određeni broj dana, na blagajni i u web-trgovini. Kodovi nisu na popisu pod Kodovi za popust. Ako slanje ne uspije, kod prestaje vrijediti. Gumbom u blagajni samo uz pravo Odobri popust.
• Isključeno: obavijesti i izdani kodovi ostaju spremljeni (i u sigurnosnoj kopiji); postavka je uključena u izvoz konfiguracije.

Kod: lib/telaat.ts, routes/telaat.ts, TeLaat.tsx i packages/shared/src/telaat.ts.

Gumb Naruči: što radi i kada vam treba

Dodir proizvoda i dodir na Naruči dva su različita koraka:

• Dodirom se proizvod odmah stavlja na račun (lijevo na popisu) kao novo. Vidite ga samo vi: kuhinja i šank još ne znaju ništa o tome. Nova stavka je skica: još je možete ukloniti ili promijeniti količinu ili opcije, bez storna.
• Naruči šalje sve nove stavke odjednom: radni nalozi idu na pisače u kuhinji i za šankom (i na kuhinjski zaslon), a stavke zatim imaju status naručeno. Tada ih možete ukloniti samo putem Storno (pravo storno). Na gumbu piše koliko je novih stavki spremno, npr. Naruči (3); ako nema novih stavki, gumb je siv.

Zašto dva koraka? Za stolom primate cijelu narudžbu (pića, predjelo, glavno jelo), još nešto prilagodite ako se gost predomisli, a zatim je odjednom pošaljete u kuhinju, s jednim nalogom po stanici umjesto naloga po proizvodu. Tako kuhinja može početi mnogo prije nego što se plati.

Što se još događa pri Naruči:

• Slijedovi: slijed 1 odmah ide u kuhinju; slijedovi 2, 3 i 4 šalju se kao ČEKA i kuhinja počinje tek kad pozovete taj slijed (vidi Slijedovi).
• Runde: svaki Naruči je jedna runda; na tome se temelji ↻ Još jedna runda.
• Zaliha se umanjuje, a dozirana slavina se otključava.
• All-you-can-eat: ako je previše, prerano ili prekasno za aranžman, blagajna najprije pita smije li ipak.
• Belgija (GKS 2.0): stavke najprije idu kao pro forma u crnu kutiju; ako to ne uspije, ništa ne ide u kuhinju i ostaju novo.
• Nema veze: narudžba se sprema i ide u kuhinju čim se veza vrati. Pisač isključen: narudžba ipak prolazi, a radni nalog ide u red čekanja za ispis (vidi Kuhinjski pisač isključen ili nema kuhinjskog zaslona).

Možete i odmah naplatiti. Ako dodirnete Naplati dok su na računu još nove stavke, blagajna ih najprije automatski naruči, tako da kuhinja i šank uvijek dobiju svoj nalog. Za šankom ili kod preuzimanja dakle ne morate najprije dodirnuti Naruči: dodirnite proizvode i odmah Naplati. Ako automatsko naručivanje ne uspije (nema veze, pravilo all-you-can-eat, crna kutija), zaslon naplate ostaje zatvoren i vidite zašto.

Ne želite bon za šank kad odmah naplaćujete? U Postavke → Objekt → Naručivanje i naplata uključite Izravna naplata bez narudžbenice. Tada u kuhinju i na šank ide samo ono što pošaljete s Naruči; ono što odmah naplatite ne dobiva narudžbenicu.

Veliki ili mali gumb Naplati

Uz kvačicu Veliki gumb "Naplati" na zaslonu narudžbe odmah ispod naručenih proizvoda nalazi se veliki gumb Naplati: širok, visok i s iznosom, da ga brzo pogodite. Ako je dio računa već plaćen, gumb pokazuje preostali iznos. Mali gumb dolje pokraj Naruči tada nestaje.

S velikim gumbom i gumbi na zaslonu za naplatu su veliki: Naplati (kod Kartice, Poklon-bona i ostalih načina plaćanja), a kod Gotovine Točan iznos u gotovini i Naplati su široki i visoki, lako ih je pogoditi, čak i prljavim prstima (na primjer u mesnici). Načini plaćanja su malo veći, a gumbi za napojnicu malo manji, tako da sve ostane na zaslonu.

Kod nove instalacije kvačica je isključena: tada mali gumb dolje pokraj Naruči i zaslon naplate s običnim gumbima. Radije veliko? U Postavke → Lokal, odmah ispod svijetle/tamne teme, uključi kvačicu Veliki gumb "Naplati". Blagajna koja je već bila u upotrebi zadržava ono što je imala. Izbor vrijedi za sve blagajne i tablete u lokalu.

Označavanje proizvoda kao "rasprodano"

Svatko na zaslonu narudžbe može dugo pritisnuti proizvod (ili kliknuti desnom tipkom miša) i odabrati Nema (rasprodano). Proizvod tada postaje siv i više se ne može naručiti ni na jednoj blagajni. Na isti način ga vraćaš s Ponovno dostupno. Svaka promjena bilježi se u zapisnik. Administrator to i dalje može i u Postavke → Proizvodi. I poslužitelj blagajne odbija proizvod označen kao "nema" ("Cola" je rasprodana), dakle i s tableta koji još nije primio promjenu ili s narudžbi spremljenih offline; taj tablet tada prikazuje "Slanje nije uspjelo".

Kuhinjski zaslon (KDS)

Uz (a ne umjesto) pisača kuhinjskih listića kuhinja ili šank mogu koristiti zaslon. Na tabletu/računalu u kuhinji otvori http://<kassaserver>:3000/keuken, prijavi se PIN-om i odaberi stanicu: to su isti nazivi kao pisači (kuhinja, šank, ...), pa je na zaslonu točno ono što bi bilo na tom kuhinjskom listiću. "Sve" prikazuje sve stanice.

• Jedan listić po narudžbi, najstariji prvi, sa stolom/za van, brojem i koliko već čeka (narančasto nakon 10, crveno nakon 20 minuta).
• Slijedovi su prikazani zasebno; slijed koji još nije pozvan prikazan je sivo kao "ČEKA na poziv". Storna su prekrižena.
• Dodirni stavku da je označiš kao gotovu ili Gotovo za cijeli listić. Osoblje tada u gornjoj traci dobiva "Kuhinja: Stol 5 je gotov". S Postavke → Lokal → Kuhinjski zaslon → Zvuk za osoblje (zadano isključeno) blagajna uz to i zapišti ("ding-dong", bez zvučne datoteke). Preglednik dopušta zvuk tek nakon prvog dodira zaslona; pojačaj glasnoću tableta.
• Vrati prikazuje što je u posljednjih sat vremena označeno kao gotovo, pa se slučajno uklonjeno može vratiti.

Zaslon se odmah sam ažurira. Kuhinjski listići se i dalje normalno ispisuju; tko ne koristi zaslon, neće primijetiti nikakvu razliku.

Kuhinjski zaslon: prosljeđivanje, redoslijed i slijed

Postavke → Pisači → Kuhinjski zaslon. Svaki dio uključuje se zasebno, zadano isključen; isključivanjem se sve čuva.

• Prosljeđivanje između stanica, na primjer hladno → toplo → izdavanje. Za svaku stanicu postavljate fiksnu sljedeću stanicu; na narudžbi se tada pojavljuje gumb → toplo (i uvijek Proslijedi na… za odabir druge stanice). Prosljeđuju se samo otvorene stavke te stanice. Stanica ne treba pisač: unesite stanice poput izdavanje pod Stanice bez pisača. Spremno (i obavijest konobaru) dolazi tek na posljednjoj stanici. Pod "Sve" kod proslijeđene stavke piše gdje se sada nalazi. Svaki korak vidi se kod stavke i u dnevniku.
• Promjena redoslijeda: povlačite narudžbe (mišem) ili ih pomičite s ◀ ▶ (zaslon osjetljiv na dodir). Redoslijed vrijedi po stanici i za sve zaslone te stanice; nove narudžbe dolaze na kraj.
• Sljedeći slijed s kuhinjskog zaslona: kod narudžbe sa slijedom na čekanju stoji Zatraži slijed 2. Konobar tada dobiva "Kuhinja traži slijed 2 za Stol 5" (sa zvukom) i poziva kao i uvijek; na kuhinjskom zaslonu stoji "Slijed 2 zatražen · n min" dok slijed ne bude pozvan. Ili odaberite Pozovi: tada kuhinjski zaslon sam poziva slijed, s radnim nalogom "POZIV SLIJED 2", kao i gumb na blagajni.

Kuhinjski pisač isključen ili nema kuhinjskog zaslona

Blagajna uvijek radi dalje, čak i kad je pisač u kuhinji ili šanku isključen (ili nema papira, ili je kabel odspojen) i čak bez kuhinjskog zaslona:

• Naručivanje uvijek prolazi. Stavke su odmah naručene, račun je točan i naplata normalno radi. Pisačima se šalje istodobno i svaki pisač dobiva najviše oko 4 sekundi: isključeni pisač ne tjera ostale (ni osoblje) da dugo čekaju.
• Red čekanja za ispis. Kuhinjski listić koji se nije mogao ispisati ide u red čekanja za ispis. Poslužitelj blagajne pokušava ponovno svakih 30 sekundi, petnaest minuta; čim pisač opet radi, listić izlazi s natpisom ISPISANO KASNIJE na vrhu. Ako sljedeći listić na tom pisaču uspije, listići na čekanju odmah idu za njim.
• Nakon petnaest minuta automatsko ponavljanje prestaje; Ispiši ponovno sada tada je i dalje moguće.
• Kuhinjski zaslon. Ako je narudžba na kuhinjskom zaslonu, kuhinja je vidi ondje i kad je pisač isključen. Tko ne koristi kuhinjski zaslon, ništa ne propušta: blagajna nigdje ne čeka "Gotovo" iz kuhinje.
• Red čekanja postoji samo u memoriji poslužitelja blagajne (nakon ponovnog pokretanja je prazan).
• Isto vrijedi za račun: ako ispis ne uspije, naplata je ipak obavljena (blagajna javlja "ispis nije uspio"), a kopiju možeš kasnije ispisati u Računi.

Sljedovi (predjelo, glavno jelo ...)

Gumbi slijedova prikazuju se samo kad su potrebni: čim je na narudžbi meni (složeni proizvod) ili kad je već nešto u slijedu od 2 do 4. Kod običnih proizvoda, poput cole, ne vidiš ih i sve ide odmah u kuhinju. Nema ništa za postavljanje.

Ispod popisa narudžbe nalazi se Slijed 1 2 3 4. Zadano je uključen slijed 1 i sve radi kao i uvijek: "Naruči" sve odmah šalje u kuhinju, bez naslova slijedova na kuhinjskom listiću. Ako odabereš slijed 2 (ili viši) prije nego što dodirneš proizvode, onda:

• oni kod "Naruči" ipak odlaze u kuhinju, pod "-- Slijed 2 · ČEKA na poziv --", kako bi se kuhinja mogla pripremiti;
• na popisu narudžbe piše "Slijed 2 · čeka" s gumbom Pozovi;
• kuhinja kod poziva dobiva listić " POZIV SLIJED 2 " s onim što sada treba pripremiti.

Slijed 1 uvijek ide odmah. Ako je slijed 2 već pozvan, jelo naknadno naručeno u slijedu 2 također ide odmah.

Alergeni po proizvodu

Zadano isključeno: alergeni se tada nigdje ne prikazuju. Uključi u Postavke → Lokal → Unesi i prikaži alergene po proizvodu.

• Postavke → Proizvodi: za svaki proizvod označi 14 EU alergena (gluten, rakovi, jaja, riba, kikiriki, soja, mlijeko, orašasti plodovi, celer, gorušica, sjeme sezama, sulfiti, lupina, mekušci). Na popisu proizvoda kratice stoje iza naziva.
• Zaslon narudžbe: na svakom gumbu proizvoda sitno su prikazane kratice (npr. Gl Me), a gumb ⚠ Alergeni u traci grupa prikazuje alergene u cijelosti za svaki proizvod odabrane grupe, s objašnjenjem kratica.
• Promjene alergena bilježe se u zapisnik (staro → novo). Ako je postavka isključena, prethodno uneseni alergeni ostaju spremljeni.

All-you-can-eat

Zadano isključeno. Uključuje se u Postavke → Lokal → All-you-can-eat (samo administrator). Izradiš jedan ili više paketa, npr. Riba, Meso i Sushi, svaki s:

• nazivom (pojavljuje se na računu: "Riba odrasli", "Riba dijete");
• cijenom po odrasloj osobi i po djetetu (s PDV-om) i stopom PDV-a (zadano NL LAAG, BE B);
• jelima koja su uključena (€ 0): cijele grupe proizvoda i/ili pojedinačni proizvodi (i iz drugih grupa, npr. pomfrit uz Ribu i Meso);
• vremenskim ograničenjem u minutama (0 = bez);
• rundama: najviše toliko jela po osobi po rundi (0 = neograničeno) i najmanje toliko minuta između dvije runde (0 = bez);
• naknadom za bacanje hrane po komadu (0 = bez).

S ↑ ↓ postavljaš redoslijed. On je važan kad jelo pripada u više paketa: tada se računa za najviši paket koji je grupa odabrala. Izbriši uklanja paket za nove stolove; stolovi koji su već u tijeku zadržavaju svoje stavke cijene (manje osoba je ondje još moguće, više nije).

Za stolom:

• Na zaslonu narudžbe iznad računa nalazi se + All-you-can-eat. Za svaki paket odaberite broj odraslih i djece; može i kombinirano (npr. 2× Riba i 2× Meso). Cijena se dodaje kao stavke na račun; one ne idu u kuhinju. Broj osoba u grupi postaje ukupan broj sudionika (ako blagajna prati goste).
• Traka za svaki paket prikazuje: osobe, preostalo vrijeme (crveno kad vrijeme istekne), koja je runda s maksimumom i koliko još do sljedeće runde. Uključena jela označena su na gumbima s AYCE, a na računu s oznakom AYCE za € 0. Sve što ne pripada nijednom odabranom paketu (pića, deserti ...) normalno se naplaćuje.
• Naruči: svaki "Naruči" s besplatnim jelima je jedna runda, po paketu (samo paketi čija su jela uključena). Ono što je dodirnuto offline i poslano kasnije ne blokira se.
• Uredi: prilagodi brojeve po paketu. Manje osoba računa se kao storno (pravo "storno"). Postavljanje paketa na 0 (ili Zaustavi za sve) moguće je dok na računu još nema jela iz tog paketa.
• Naknada (samo ako odabrani paket ima naknadu za bacanje hrane): odaberi količinu (i paket, ako ih ima više); "Naknada za bacanje hrane × količina" dodaje se na račun.
• Naplata, dijeljenje, popusti i račun rade kao i uvijek: cijene paketa, naknada i pića obične su stavke sa svojim PDV-om.
• Ako administrator isključi all-you-can-eat dok su grupe u tijeku, novo dodirnuta jela opet imaju običnu cijenu; ono što je već na računu ostaje.
• U web-trgovini (neobavezno, zadano isključeno): uz I kod naručivanja za stolom putem QR koda (web-trgovina) gost koji naručuje za stolom s paketom vidi jela iz paketa kao Uključeno za € 0, s trenutačnim stanjem na vrhu (osobe, runda, vrijeme). Jedna narudžba je jedna runda, s istim pravilima kao Naruči; previše, prerano ili prekasno web-trgovina odmah odbija. Pića i ostala jela gost plaća normalno; sve ide na račun stola. Isključeno = web-trgovina naplaćuje uobičajene cijene, kao dosad.

Poklon-bonovi

Dva prekidača u Postavke → Lokal → Poklon bonovi:

• Poklon bon kao način plaćanja pri naplati: zadano uključeno, kao i uvijek. Isključeno = gumb Poklon bon ne prikazuje se pri naplati (ni kod povrat novca putem pri povratu), a poslužitelj blagajne odbija plaćanje poklon bonom.
• Prodaja poklon bonova sa stanjem: zadano isključeno. Uključeno:
  • Na zaslonu narudžbe nalazi se gumb Poklon bon: odaberi iznos (€ 10, 25, 50, 100 ili drugi iznos) i neka blagajna izradi kôd, ili skeniraj kôd unaprijed tiskane kartice. Bon se dodaje na račun kao stavka (PDV oznaka BON: bez prometa, bez PDV-a, ne ide u kuhinju). Ondje možeš i provjeriti stanje za kupca.
  • Nakon naplate bon je aktivan, a pisač računa ispisuje poklon bon s iznosom, kôdom i QR kôdom.
  • Iskorištavanje: pri naplati odaberi Poklon bon i skeniraj ili upiši kôd (gumb Stanje prikazuje stanje). Iznos se oduzima od stanja. Ako je stanje manje od računa, cijelo stanje oduzima se kao djelomično plaćanje, a ostatak plaćaš karticom ili gotovinom. Stanje se smije trošiti u dijelovima.
  • Ostavi kôd prazan = poklon bon bez kôda, kao prije (npr. stari papirnati bon).
  • Izvješće → Poklon bonovi (pravo Upravljanje poklon bonovima, zadano voditelj i administrator): pretraživanje po kôdu, otvoreno stanje, povijest po bonu, blokiranje (izgubljen/ukraden) i ispravak stanja s razlogom. To se bilježi u zapisnik.
  • Izvješća: prodani poklon bonovi ne računaju se kao promet i prikazani su zasebno (Prodani poklon bonovi); primljeni novac ipak je prikazan kod načina plaćanja. Ono što se plati poklon bonom običan je promet (s PDV-om) kod načina plaćanja Poklon bon.
  • Knjigovodstvo: prodani bonovi knjiže se u potražnu, a iskorišteni bonovi u dugovnu stranu računa Poklon bonovi (predujmovi kupaca).
  • Prodani poklon bon može se vratiti putem Računi → Povrat dok još nije iskorišten (stanje = vrijednost). Nakon povrata bon je poništen (stanje 0, blokiran; vidljivo u povijesti bona). Ako je već (djelomično) iskorišten, postavi stanje na 0 u Izvješće → Poklon bonovi i ostatak vrati zasebno. Popust na poklon bon nije moguć.

Nadoplativi kredit (neobavezno)

Za klubove, sportske kantine, domove za mlade i događanja: poklon-bon sa stanjem postaje nadoplativa kartica. Uključuje se u Postavke → Objekt → Nadoplativi kredit, ispod poklon-bonova (zadano isključeno; radi samo ako je uključeno Prodaja poklon-bonova sa stanjem).

• Kartica ili narukvica: prodaj poklon-bon s Unaprijed tiskana kartica i skeniraj karticu (NFC/RFID čitač koji radi kao tipkovnica, ili crtični kôd). Broj kartice tada je kôd; njime gost plaća kao poklon-bonom.
• Nadoplata: zaslon za narudžbe → Poklon-bon → Nadoplati kredit: skeniraj bon ili karticu i unesi iznos. Ide kao stavka na račun (PDV oznaka BON: bez prometa, bez PDV-a, kao i prodani poklon-bon) i nakon naplate je na stanju. U povijesti bona stoji Nadoplaćeno.
• Najveće stanje po bonu ili kartici (zadano € 500, može se postaviti do € 5.000).
• Isplati preostalo stanje (kvačica, zadano isključeno; ovlast Upravljanje ladicom blagajne): nakon Provjeri saldo pojavljuje se Isplati preostalo stanje. Stanje pada na € 0, a iznos se na X- i Z-izvještaju prikazuje kao novac iz ladice (Tegoed terugbetaald …).
• Nadoplata se može poništiti putem Računi → Povrat dok je stanje još barem toliko; bon ili kartica ostaju valjani.
• Nadoplata na kiosku (neobavezno): vidi Samoposlužni kiosk.

Bonovi za obrok

Samo za objekte u Belgiji, zadano isključeno: Postavke → Objekt → Naplati → Bonovi za obrok. Bonovi za obrok pogodnost su uz plaću: poslodavac ih stavlja na karticu zaposlenika (Edenred, Monizze ili Pluxee). Gost njima plaća na običnom platnom terminalu; povezivanje s izdavateljima nije potrebno.

• Uključeno: pri naplati se pojavljuje gumb Bon za obrok. Odaberi izdavatelja (samo izdavatelje koje objekt prihvaća) i neka gost prinese karticu platnom terminalu, kao kod plaćanja karticom. Bez povezanog terminala: gost plaća na samom platnom terminalu, a ti dodirneš Naplati.
• Bez napojnice i bez ostatka s bonovima za obrok. Ako je saldo prenizak, gost ostatak plaća na drugi način (račun ostaje otvoren dok se sve ne plati).
• Samo za određene kategorije (neobavezno, npr. hrana, ali ne alkohol): tada se bonovima za obrok može platiti najviše iznos tih proizvoda na računu. Zaslon za naplatu pokazuje koliko; ostatak gost plaća na drugi način.
• Na računu: Bon za obrok Pluxee (s nazivom izdavatelja iza).
• Z-izvještaj i X-izvještaj: zaseban redak po izdavatelju (Bon za obrok Edenred, … Monizze, … Pluxee).
• Knjigovodstvo: zaseban konto glavne knjige po izdavatelju (Bonovi za obrok Pluxee (potraživanje) itd., zadano 416100, 416200 i 416300), jer novac dolazi od izdavatelja, a ne od banke platnog terminala.
• Potrebno: ugovor sa svakim izdavateljem čije bonove prihvaćaš i platni terminal koji prihvaća te kartice (provjeri kod dobavljača platnog terminala).

Strana valuta

Plaćanje gotovinom u drugoj valuti, npr. britanski ili američki turisti, ili u pograničnom području sa švicarskim frankom. Zadano isključeno: Postavke → Objekt → Naplati → Strana valuta. Dodaj valute (CHF, CZK, DKK, GBP, HUF, NOK, PLN, SEK, TRY, USD) s tečajem za svaku valutu: koliko eura računaš za 1 jedinicu (npr. 1 GBP = € 1,15).

• Uneseno ručno: fiksni tečaj; sam ga prilagodi kad se promijeni.
• Uživo (ESB): dnevni tečaj Europske središnje banke (referentni tečajevi, svakog radnog dana oko 16:00; besplatno, bez računa). Uz maržu u postocima (0-20) tečaj je toliko niži, pa objekt ne plaća sam trošak mijenjanja. Blagajna sama dohvaća tečajeve kad su stariji od 6 sati; Ažuriraj sada ih odmah dohvaća. Bez interneta ostaje zadnji tečaj.
• Uključeno: pri naplati postoji gumb Strana valuta. Odaberi valutu; blagajna pokazuje koliko je to u toj valuti. Unesi što gost daje: blagajna to preračunava i vraća ostatak u eurima. Ako gost ne želi ostatak, označi Ostatak je napojnica: ostatak ide kao napojnica na račun, u Belgiji u toj valuti (GKS 2.0, UC296).
• Ako gost da manje od cijelog iznosa, to je dio; ostatak plaća na drugi način.
• Na računu: valuta, iznos i tečaj te ostatak u eurima.
• X- i Z-izvještaj: za svaku valutu zasebna stavka (Strana valuta GBP, u eurima), a kod ladice blagajne ono što je u toj valuti u ladici. Ostatak u eurima oduzima se od očekivanog novca u ladici; same valute brojiš zasebno.
• Knjigovodstvo: računa se kao gotovina (blagajna), u eurima.

Dodatni gumbi pri naručivanju i naplati

Gumbi za ono što ne treba svaki objekt. Sve je zadano isključeno; uključuje se po gumbu u Postavke → Objekt → Naručivanje i naplata (pravo Postavljanje objekta, plaćanja i pisača). Isključeno = gumba nema nigdje u blagajni, a poslužitelj blagajne odbija radnju. U Nizozemskoj sve radi bez crne kutije; u Belgiji gumb radi tek kad je ta funkcija testirana s crnom kutijom (uz gumb piše ako još nije).

Pri otvaranju stola:

• Praćenje broja gostiju: pitanje "Koliko osoba?" kod slobodnog stola, gosti na tlocrtu i na zaslonu narudžbe te gosti u izvješćima. Vidi Broj gostiju.

Pri naručivanju (zaslon narudžbe, za ono što zatim dodirnete):

• Zbrajanje istih proizvoda (bez gumba, zadano uključeno): ako ponovno dodirnete isti proizvod (iste opcije, još nije naručen), povećava se količina umjesto novog retka: 4 Cola u jednom retku s cijenom puta 4. Sa − se ponovno oduzima jedan, čak i ako je već naručen (storno jednog). S napomenom, mjestom ili za van ostaje zaseban redak; ono što je već naručeno ostaje zaseban redak (nova runda).
• − i + (ispred cijene u svakom retku): − oduzima jedan, + dodaje jedan (isti proizvod, opcije i napomena; ako je Zbrajanje istih proizvoda isključeno, novi redak). Još nije naručeno i na 0: redak nestaje. Već naručeno: jedan manje je storno, taj redak ostaje prekrižen (za kuhinju i izvještaje); jedan više postaje novi redak koji tek treba naručiti. Dodir same cijene više ništa ne uklanja. Kod menija samo −.
• Za van (samo u lokalu): gost nosi ovaj proizvod sa sobom, npr. bocu vode ili desert. Ta stavka dobiva PDV za van (u Belgiji oznaka C), ostatak računa PDV u lokalu. Na računu uz stavku piše van.
• Mjesto (za stolom): dodirujte za mjesto 1, 2, 3 ...; stavke dobivaju taj broj mjesta (i na kuhinjskom nalogu). U Belgiji svaka stavka ide s mjestom troška mjesta (CHAIR, UC4123) u crnu kutiju. Još jednom nakon mjesta 12 = opet bez mjesta.
• Primi povrat: sljedeći proizvod dolazi s -1, npr. prazna boca ili čaša (povratna naknada). To je moguće samo kod proizvoda s Povratno (povratna naknada) (Postavke → Proizvodi). Ako je cijeli račun negativan (samo vraćena povratna naknada, bez prodaje), Naplati postaje povrat novca: gotovina natrag ili karticom (vraćeno na samom terminalu). U Belgiji kao povrat novca (REFUND, UC4108 i UC4114).
• Iskoristi SPV: gost plaća proizvod ili meni single purpose voucherom (vaučer upravo za taj proizvod, npr. "1 menu all-in"). Dodirnite Iskoristi SPV i zatim proizvod na računu: on dolazi s -1 (ista cijena i PDV, kod menija s dijelovima), uz oznaku SPV. Ne ide u kuhinju; može se normalno ukloniti. Proizvod-vaučer prodajete unaprijed kao običan proizvod; u Postavke → Proizvodi označite SPV (vaučer). U Belgiji stavka pri prodaji ide kao VOUCHER u crnu kutiju (UC271).
• Obračunaj predujam: vidi niže.
• Otvorena cijena (bez gumba, po proizvodu): kod proizvoda s Otvorena cijena blagajna traži cijenu, npr. za jelo dana ili predujam.

Pri naplati:

• Izravna naplata bez narudžbenice (nije gumb): prema zadanim postavkama Naplati najprije naručuje ono što još nije naručeno, tako da kuhinja i šank uvijek dobiju svoj bon (vidi Gumb Naruči: što radi i kada vam treba). Uključeno: ono što odmah naplatite bez da prvo dodirnete Naruči ne dobiva narudžbenicu, npr. za šankom gdje sami uzmete piće. Ono što je već naručeno ostaje nepromijenjeno.
• Odvojena naplata (za stolom, pri Podijeli račun): odaberite što jedan gost sada plaća, i dio stavke (½ za pola boce). To postaje zaseban dio koji odmah naplaćujete; ostatak ostaje na računu stola, bez prethodnog dijeljenja računa ili premještanja u drugu grupu. Postotni popust na cijeli račun prenosi se razmjerno. Natrag bez plaćanja = sve opet na računu stola. U Belgiji prodaja ostaje na mjestu stola, bez promjene stola (UC4103bis, UC4104).
• Gost otišao bez plaćanja (pravo Zatvaranje bez plaćanja, zadano samo voditelj i administrator): račun se zatvara kao prodaja bez plaćanja, s razlogom u dnevniku. Na X i Z izvješću i u dnevnom izvješću stoji kao Neplaćeno (gost otišao); u knjiženju na nenaplativo (zadano 4985 / 643000). U Belgiji prodaja bez plaćanja (UC4109).

Naknadno (Računi):

• Ispravi cijenu (pravo Ispravljanje cijene računa, zadano samo voditelj i administrator): cijena naplaćenog računa nije bila točna, npr. 50% popusta umjesto 5%. Blagajna izrađuje novi račun bez stola sa stavkama starog računa natrag (negativno, po onome što je tada plaćeno) i istim proizvodima ponovno po redovnoj cijeni. Tamo dajte točan popust i naplatite razliku (ili vratite novac ako je nova cijena niža). Stari račun ostaje kakav je bio; jednom po računu, i ne ako je već nešto vraćeno. U Belgiji stare stavke idu kao CORRECTION (UC4116).

Kod: apps/pos-server/src/lib/kassaopties.ts, routes/kassaopties.ts; zaslon KassaOpties.tsx. Dnevnik: Postavka promijenjena, SPV iskorišten, Ispravak računa, Neplaćeno.

Obračunaj predujam

Predujam (kapara, npr. za proslavu ili rezervaciju) prodajete kao običan proizvod s uključenim Predujam (Postavke → Proizvodi; uvijek ima otvorenu cijenu). Napravite po jedan za svaku stopu PDV-a ako predujam mora biti po stopi (npr. Predujam hrana i Predujam pića), ili jedan proizvod ako je dio ponude. Gost plaća predujam unaprijed i dobiva račun.

Uključivanje: Postavke → Objekt → Naručivanje i naplata → Obračunaj predujam (zadano isključeno). Pri konačnoj naplati na zaslonu narudžbe dodirnete Obračunaj predujam i unesete broj računa predujma. Blagajna stavlja stavke predujma s tog računa s negativnom količinom na račun stola (isti proizvod, cijena i PDV). Ono što je već obračunato ne može se obračunati ponovno. Ako je predujam veći od računa, gost dobiva razliku natrag (povrat novca). U Belgiji obračunate stavke idu kao povrat novca (REFUND) u crnu kutiju (UC4110, UC4111, UC4113). Dnevnik: Predujam obračunat.

Račun e-poštom

Zadano isključeno. Uključi u Postavke → Lokal → Račun i e-poštom.

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

Nakon unosa ponovno pokreni blagajnu. Zatim se kod Naplati pojavljuje polje Pošalji račun i e-poštom (neobavezno): ostavi prazno = samo ispis kao i uvijek; upiši e-adresu = isti račun (sa specifikacijom PDV-a i fiskalnim stavkama) šalje se gostu i e-poštom, s nazivom lokala kao pošiljateljem.

• E-adresa se ne sprema; u zapisniku piše samo "račun N poslan na a***@domena.hr" i je li uspjelo.
• Ako slanje e-poštom ne uspije (npr. pogrešni podaci za prijavu), račun je ipak naplaćen i ispisan; poruka kaže što je pošlo po zlu.
• Ne kod djelomičnog plaćanja (dijeljenje računa): račun se izdaje kod posljednjeg plaćanja, pa adresu upiši tamo.
• Naknadno slanje e-poštom: u Računi uz svaki račun stoji gumb Pošalji e-poštom (pravo Ispis kopije računa). On šalje račun s oznakom KOPIJA, kao i ispisana kopija (u Belgiji se registrira kao kopija).
• Nisu potrebni dodatni paketi: blagajna sama komunicira s poslužiteljem e-pošte (STARTTLS na 587, TLS na 465).

Rezervacije

Uključi u Postavke → Lokal → Rezervacije (zadano isključeno). Ondje postavljaš i koliko minuta unaprijed se rezervirani stol prikazuje na tlocrtu (zadano 60) i zadano trajanje rezervacije (zadano 120 minuta).

• Gumb Rezervacije u gornjoj traci: pregled po danu (◀ ▶), s brojem rezervacija, osoba i nedolazaka. + Nova rezervacija: ime, telefon, e-pošta, osobe, datum, vrijeme, trajanje, stol (može i kasnije) i napomena. Rezervacije unosi osoblje; online rezervacija (još) ne postoji.
• Ako na istom stolu u tom terminu već postoji rezervacija, blagajna to javlja; "Ipak spremi" je moguće.
• Potvrda e-poštom (kvačica ili kasnije "Pošalji e-poštom") ako postoji e-adresa i poslužitelj e-pošte (SMTP_HOST, vidi Račun e-poštom).
• Na tlocrtu je rezervirani slobodni stol prikazan ljubičasto s "R 19:30 Jansen (4)". Kad ga dodirneš: "Jansen je stigao" otvara stol s 4 osoba i "Jansen" kao nazivom grupe; "Drugi gosti" ga jednostavno otvara.
• U pregledu: Stigli (otvara stol; bez stola najprije odabereš jedan), Uredi, Nedolazak, Otkaži i Vrati. Sve se bilježi u zapisnik.
• Rezervacije s online platformi: pogledajte Platforme za rezervacije u nastavku.

Povezivanje blagajne s TheForkom: stol se otvara pri dolasku, račun se vraća

S TheForkovim POS-API-jem blagajna surađuje s TheFork Managerom (zadano isključeno), uz preuzimanje rezervacija opisano gore. Uključuje se u Postavke → Platforme za rezervacije → Povezivanje blagajne s TheForkom; radi preko upravljačkog portala.

• Ako se gost u TheFork Manageru postavi na Stigao ili Za stolom, u blagajni se otvara stol s istim nazivom, s brojem gostiju i napomenom: ime, alergije i prehrana, predujam, ponuda/popust i bodovi vjernosti (Yums). Ako na tom stolu već postoji otvorena narudžba, ona se povezuje. Nema stola s tim nazivom: pojavljuje se obavijest, a u Platforme se odabire stol.
• Nakon naplate račun ide u TheFork (ukupno i stavke s nazivom, grupom proizvoda, količinom i iznosom); TheFork tada rezervaciju postavlja na Otišao. Kod podijeljene naplate jedan račun s ukupnim iznosom. Ako ne uspije, blagajna pokušava ponovno svakih petnaest minuta (dva dana), ili gumbom Pošalji ponovno u Platformama.
• Uparivanje: blagajna prikazuje kôd za uparivanje; upišite ga u TheFork Manager (Integracije → blagajna). ID restorana na TheForku (Customer-id) upisuje administrator ili dolazi automatski s prvom narudžbom.
• Kvačice: automatski otvori stol, ime, alergije i predujam kao napomena, račun u TheFork.
• Uvjet: Pin Voordeel ima TheForkov API ključ (samo za partnere) i ondje je registrirao blagajnu kao POS (gumb u upravljačkom portalu); TheFork pušta povezivanje u rad nakon testne sesije.

TheForkova dokumentacija: https://docs.thefork.io/POS-API/introduction

Lista čekanja za goste bez rezervacije

Za goste bez rezervacije koji čekaju stol. Uključi u Postavke → Lokal → Lista čekanja (walk-ins) (zadano isključeno). Vidljivo samo ako je postavljen SMS preko CM.com; inače se lista čekanja nigdje ne prikazuje u blagajni (ni u postavkama). Radi neovisno o rezervacijama: i kad su one isključene. Ondje je i tekst SMS-a (prazno = "Hallo {naam}, uw tafel bij {zaak} is klaar. Wilt u zich melden bij de bediening?"; {naam}, {zaak} i {personen} se automatski popunjavaju).

• Gumb Lista čekanja u gornjoj traci, s brojem gostiju koji čekaju (narančasto kad netko čeka). + Na listu čekanja: ime, telefon (za SMS), osobe, najavljeno vrijeme čekanja i želja (terasa, dječja stolica).
• Popis je poredan prema redoslijedu prijave, s time koliko netko već čeka (crveno ako traje dulje od najavljenog), a na vrhu su broj gostiju koji čekaju, osobe i današnje prosječno vrijeme čekanja.
• Ako SMS ne uspije, uz njega se prikazuje razlog. Pošalji SMS ponovno je moguće.
• Smjesti: odaberite stol; blagajna ga otvara s brojem osoba (ako blagajna prati goste) i imenom kao nazivom grupe (kao kod rezervacije koja stiže).
• Otišli (otišli ili odjavljeni) i Vrati. Ispod popisa vidiš tko je danas smješten ili otišao, s time koliko su čekali.
• Privatnost: brojevi telefona brišu se nakon jednog dana; tko je nakon 12 sati još na popisu, automatski se uklanja. Prijava, pozivanje (samo sa zadnje 3 znamenke broja) i smještanje bilježe se u zapisnik.
• Zašto ne u Rezervacijama? Rezervacija je za kasnije (datum, vrijeme, stol unaprijed); lista čekanja je za sada (redoslijed, vrijeme čekanja, SMS kad je stol slobodan). Zato ima vlastiti prekidač i gumb, s istim "otvori stol" kao kod rezervacije.
• Online na listu čekanja (neobavezno, zadano isključeno; samo s web-trgovinom): uz Gosti se mogu prijaviti i sami putem web-trgovine u web-trgovini postoji Lista čekanja (i za to postoji QR kod za vrata, u upravljanju web-trgovinom pod Stolovi i QR). Gost upiše ime, telefon, broj osoba i želju te uživo vidi svoje mjesto. U blagajni je na popisu s oznakom online; pozivanje, smještanje i odlazak rade kao i uvijek, a gost to vidi i na svom telefonu (tamo se može i odjaviti).

Kartica vjernosti / bodovi

Uključi u Postavke → Lokal → Kartica vjernosti / bodovi (zadano isključeno, tada se nigdje ništa od toga ne vidi). Ondje postavljaš i: bodove po euru (0 = samo kartice s pečatima), nakon koliko bodova slijedi nagrada i koliko eura popusta vrijedi ta nagrada.

• Na blagajni iznad računa nalazi se "+ Kartica vjernosti": potraži kupca po imenu ili broju telefona ili izradi novog kupca (ime, po želji telefon i e-pošta). Nakon toga ime sa stanjem bodova stoji na računu.
• Zamjena: uz dovoljno bodova "Zamijeni 100 bodova: € 5 popusta"; uz punu karticu s pečatima "Besplatna kava" (ta kava mora biti na računu). To postaje stavka popusta; svatko je smije ponovno ukloniti.
• Bodovi i pečati dodaju se i oduzimaju tek pri naplati: bodovi na iznos nakon popusta (bez prodanih poklon bonova), pečati po komadu proizvoda s karticom s pečatima (besplatni proizvod se ne računa).
• Na računu: skupljeno, iskorišteno, stanje i stanje kartica s pečatima.
• Izvješće → Kupci (pravo Upravljanje karticom vjernosti): traženje kupaca, uređivanje podataka, ispravak bodova (s razlogom), povijest i brisanje (GDPR: ime, telefon i e-pošta se uklanjaju; povijest ostaje anonimna). Pri dnu su kartice s pečatima po proizvodu (npr. 10 kava = 1 besplatna).
• Povrat ne poništava automatski skupljene bodove; po potrebi ih ispravi u Izvješće → Kupci.
• Kartica vjernosti s brojem (neobavezno): u Izvješće → Kupci → (kupac) upiši broj kartice (ili skeniraj karticu u to polje). Sa skenerom crtičnog kôda skeniranje te kartice povezuje kupca s računom, na blagajni i na kiosku. Pretraživati po broju kartice možeš i putem + Kartica vjernosti.

Profil gosta: VIP, prehrambene želje i preferencije (neobavezno)

Uključuje se pod Postavke → Objekt → Profil gosta, ispod kartice vjernosti (zadano isključeno; radi samo ako je kartica vjernosti uključena). Zatim:

• Na zaslonu za narudžbe ispod povezanog kupca nalazi se "+ Profil gosta": označi VIP, odaberi prehrambene želje (vegetarijanski, veganski, peskatarijanski, halal, košer) i alergije (14 alergena) te upiši preferencije (npr. "stalni stol uz prozor", najviše 300 znakova). Zatim se prikazuju uz kupca na zaslonu za narudžbe, alergije crvenom bojom. Mogu se mijenjati i pod Izvješće → Kupci → (kupac) → Profil gosta.
• Ako dodirneš proizvod s alergenom gosta (vidi Alergeni po proizvodu), blagajna najprije pita treba li ga ipak dodati. Vrijedi samo ono što je uneseno kod proizvoda; u slučaju sumnje uvijek pitaj kuhinju.
• VIP gost dobiva ★ na tlocrtu: kod otvorenog računa i kod prikazane rezervacije tog kupca. Kad gosti s rezervacije stignu, blagajna povezuje kupca s rezervacije s računom.
• Prehrambene želje i alergije (i VIP) ispisuju se na radnom nalogu za kuhinju i šank: GAST: VIP · Vegetarisch · allergie: Noten.
• Prehrambene želje i alergije su zdravstveni podaci: unosi ih samo uz pristanak gosta. U dnevniku se bilježi samo da je profil promijenjen, a ne same želje. Brisanjem kupca briše se i profil gosta.

Favoriti / brzi gumbi

Zadano isključeno. Postavke → Lokal → Favoriti / brzi gumbi:

• Najprodavanije: na početku trake grupa gumb ★ Favoriti s 12 proizvoda koji su se u posljednjih 14 dana najviše prodavali (automatski se ažurira). Zaslon narudžbe otvara se na favoritima.
• Odaberi sam: na zaslonu narudžbe dugo pritisni proizvod (ili desni klik) i odaberi ★ Favorit (brzi gumb); ponovno = ukloni. Pravo Upravljanje proizvodima. Sve blagajne to odmah vide.
• Unos, opcije, meniji, happy hour i "nema" rade na favoritima točno kao u običnim grupama.

Još jedna runda

Na zaslonu narudžbe nalazi se gumb ↻ Još jedna runda (čim je nešto na računu, čak i ako još nije naručeno). Jedan dodir ponovno dodaje posljednju rundu (sve što je odjednom poslano s "Naruči", ili ono što si upravo unio) kao nove stavke; zatim samo Naruči. Cijene su trenutačne (i happy hour).

• Dugi pritisak (ili desni klik): biraš sam. S ◀ ▶ listaš do ranijih rundi, svaki proizvod uključi/isključi (npr. ukloni kvačicu s hrane) i promijeni količinu s − / +. Opcije i napomene se prenose.
• Rasprodani proizvodi i meniji se ne prenose (menije unosiš zasebno). Radi i bez veze.
• Stavke se dodaju onako kako stoje na računu: s uključenim Zbrajanje istih proizvoda jedna stavka po proizvodu (2 Cola), s isključenim svaka stavka zasebno (2 puta 1 Cola).

Vrijeme za stolom na tlocrtu

Na svakom zauzetom stolu stoji ⏱ 45m · 12m: koliko je stol već zauzet i prije koliko je vremena posljednji put nešto uneseno (dodirni i drži stol ili prijeđi preko njega mišem za točna vremena). Ako neko vrijeme ništa nije naručeno, stol dobiva narančasti rub: vrijeme je za obilazak. Broj minuta postavljaš u Postavke → Lokal → Vrijeme stola (zadano 20, 0 = bez narančastog ruba). Ako još ništa nije uneseno, vrijeme se računa od otvaranja stola.

Ako za jednim stolom sjedi više grupa (zasebni računi), za svaku grupu prikazuje se redak, npr. G1 ⏱ 50m · 12m i Jansen ⏱ 10m (naziv grupe, inače broj grupe). Grupa koja predugo miruje dobiva narančastu oznaku, a stol narančasti rub.

Premještanje cijelog stola

Na zaslonu za narudžbe nalazi se Premjesti stol. Odaberi prostor (npr. Terasa) i stol: sve grupe sa stola idu zajedno, svaka sa svojim računom. Odabereš li zauzeti stol, stolovi se spajaju (grupe se dodaju). Želiš li premjestiti samo dio, koristi kao i dosad Podijeli / premjesti. Mora li sve na jedan račun, koristi Spoji.

Izvanmrežni rad (tablet bez Wi-Fi veze)

Ako se prekine veza između tableta i poslužitelja blagajne (Wi-Fi na terasi, poslužitelj nakratko isključen), pojavljuje se žuta traka i tablet radi dalje s posljednjim spremljenim stolovima, proizvodima i otvorenim narudžbama:

• otvaranje stolova, unos proizvoda i Naruči spremaju se na tabletu (i ako se ponovno pokrene) i prikazuju se na popisu narudžbe s točkastim rubom ("još nije poslano");
• čim se veza vrati, sve odlazi na poslužitelj redom, a tek tada kuhinjski listić odlazi u kuhinju. Svaki paket ima ključ, pa ništa ne stiže dvaput. Ako je netko drugi u međuvremenu otvorio stol, proizvodi se dodaju toj narudžbi;
• naplata, popust, dijeljenje i slično mogući su samo uz vezu; "Naplati" čeka dok se sve s tog stola ne pošalje.

Broj osoba

Neobavezno i zadano isključeno: Postavke → Objekt → Naručivanje i naplata → Praćenje broja gostiju. Isključeno = što manje dodira: slobodan stol otvara se jednim dodirom, nigdje se ne prikazuju gosti, a izvješće, nadzorna ploča i dnevni sažetak ne prikazuju goste ni potrošnju po gostu.

Uključeno: kad dodirnete slobodan stol, blagajna pita koliko je osoba (veliki gumbi 1-8 ili unos; "Preskoči" = 1). Na tlocrtu kod zauzetog stola piše "3/4 os." (osobe/mjesta, žuto ako sjedi više ljudi nego što ima mjesta). Na zaslonu narudžbe broj mijenjate gumbom "3 os." u traci grupa; kod više grupa stol zbraja sve grupe.

Bez praćenja gostiju sve radi: Podijeli jednako pri naplati počinje od 2, all-you-can-eat sam pita broj odraslih i djece, a rezervacije i lista čekanja zadržavaju vlastiti broj osoba (stol se tada otvara bez broja osoba).

HACCP evidencija

Svaki ugostiteljski objekt mora pratiti i bilježiti sigurnost hrane: u Nizozemskoj prema Hygiënecode voor de Horeca (Higijenski kodeks za ugostiteljstvo, nadzor NVWA), u Belgiji prema samokontroli FAVV-a (vodič G-023). Uključi HACCP evidencija u Postavke → Zakoni i propisi (zadano isključeno).

• Mjerne točke (administrator): npr. hladnjača, zamrzivač, održavanje toplim, temperatura u jezgri nakon termičke obrade, brzo hlađenje i prijem robe, s minimumom i/ili maksimumom u °C i učestalošću (svaki dan, dvaput dnevno, svaki tjedan ili pri korištenju). Dodaj standardni popis postavlja početnu osnovu (hlađenje do 7 °C, u Belgiji do 4 °C; zamrzivač do -18 °C; održavanje toplim od 60 °C; termička obrada od 75 °C).
• Čišćenje i kontrola: zadaci po danu, tjednu (po želji na određeni dan) ili mjesecu, s prostorom i uputom, npr. dezinfekcija dasaka za rezanje, filtri za masnoću, kontrola štetnika, provjera termometra.
• Evidentiranje (svatko tko je prijavljen): gumb HACCP u gornjoj traci, s brojem onoga što je danas još otvoreno. Upiši temperaturu ili označi zadatak (Gotovo ili Nije uspjelo). Ako je temperatura izvan granice, treba dodati korektivnu mjeru (npr. "zatvorena vrata, proizvod bačen"). Zapisi se ne mogu mijenjati; grešku ispravljaš novim zapisom.
• Pregled (pravo Promet po razdoblju): po razdoblju svi zapisi, broj odstupanja i propušteni zapisi po danu; kao CSV (Excel) ili za ispis / spremanje kao PDF za inspekciju.

Sustav za točenje i mjerači protoka

Svako točenje koje javi računalo za točenje ili mjerač protoka dolazi na račun, tako da ništa ne "iscuri". Uključite ga u Postavke → Sustav za točenje (prema zadanim postavkama isključeno).

• Izvori (administrator): računalo za točenje ili sustav mjerača protoka. Odaberite marku; blagajna ispunjava unaprijed zadane postavke. Iz Nizozemske i Belgije: Van Duijnen Horeca (automatizacija točenja, Dashbar), Beconet (Multi-Tap), TapSystems, Horecatechniek Nederland, Heineken SmartDispense, WeissBeerger / AB InBev i BarTrack; nadalje Gruber, Addimat, WMF / Hogatron (E-Protokoll), Drinkotec (ex-Hartec), , Berg, Easybar, Azbar, Scanabar, PourMyBeer, iPourIt, BeerBoard, US BeerSAVER, Bevchek, Capton/BarVision, Kegtron, Kegbot Kegboard, "pametna slavina" ili vlastiti sustav. Povezivanje je moguće na pet načina (Kegboard: vidi Dozirano točenje i Kegboard u nastavku):
  • Polja: kraan (ili tap, plu), ml (ili cl, liter, volume s eenheid) ili porties, id (isto točenje dvaput = knjiženo jednom), tijdstip, tafel, bediening; jedno točenje, popis ili { "taps": [...] }.
  • Mreža (TCP): blagajna se spaja na računalo za točenje (adresa i port) ili sama osluškuje na portu.
  • Serijski port: COM port ili USB-serijski, 1200–115200 baud, 8N1, 7E1 ili 7O1.
  • Za mrežu i serijski port postavljate oblik poruke (jedna poruka po retku, ili STX … ETX s mogućom XOR provjerom i povratnim ACK/NAK) i uzorak poruke, s dijelovima kraan ili plu te po potrebi ml, cl, liter, porties, tafel, bediening i id (npr. kraan;ml ili samo PLU po čaši). Dobavljači svoj točan format daju samo instalaterima; zatražite ga od dobavljača računala za točenje. Probno točenje šalje točenje kao što bi to učinilo računalo za točenje.
• Slavine (administrator): za svaku slavinu ili PLU proizvod i način na koji dolazi na račun: po čaši (čaša u ml; točenje od 520 ml s čašama od 250 ml = 2 čaše; od 50% računa se čaša) ili po litri (cijena proizvoda je cijena po litri; na računu npr. "Pils 0,33 l" za točan iznos).
• Na računu: ako računalo za točenje javi stol, točenje odmah ide na otvorenu narudžbu tog stola. Inače se nalazi pod Natočeno: na zaslonu narudžbe pojavljuje se traka "… puta natočeno bez računa"; odaberite točenja i dodirnite Na ovaj račun. Stavke su odmah naručene (na šank više ne ide radni nalog) i zaliha se umanjuje. Gumb Natočeno u gornjoj traci prikazuje sve što još nema račun.
• Otpiši (pravo Storno): ispiranje, lom, kušanje, osoblje, besplatno ili ostalo (s napomenom); to se upisuje u dnevnik. Premalo za čašu (npr. ispiranje) mora se otpisati.
• Pregled (pravo Promet po razdoblju): po slavini natočeno, na računu, otpisano (po razlogu), poništeno i još otvoreno, u litrama, s postotkom prodanog, i kao CSV.
• Javljena točenja ne mogu se mijenjati (samo obraditi).

Dozirano točenje i Kegboard

Uz dozirano točenje slavina se otvara tek nakon što je čaša unesena na blagajni, i to samo za tu količinu. Tako se ne toči ništa što nije na računu. Radi samo ako je sustav za točenje uključen, a uključujete ga po slavini (zadano isključeno).

• Po slavini (administrator, Postavke → Sustav za točenje → Slavine): označite Dozirano točenje i odaberite koliko dugo slavina smije biti otvorena nakon unosa (10–600 sekundi, zadano 120). Kod Kegboarda unesite i relej (magnetni ventil). Dozirano točenje moguće je samo po čaši.
• Unos: kod Naruči (ili izravno kod Naplati) blagajna za svaku stavku računa s tim proizvodom stvara odobrenje (broj čaša × čaša u ml) i šalje ga računalu za točenje. Točenje koje zatim stigne pripada toj stavci računa. Zato ne dolazi još jednom na račun niti u Natočeno. Točenje bez odobrenja ide normalno u Natočeno.
• Storno stavke prije točenja: slavina se ponovno zatvara. Odobrenje koje nije natočeno na vrijeme istječe; slavina se nikad ne otvara naknadno.
• Odobrenja na zaslonu narudžbe (traka iznad računa): vidite što je u tijeku, Zaustavi i Ponovno odobri. Ponovno odobrenje moguće je samo ako još ništa nije natočeno, pa se nikad ne odobri ništa dodatno. Probno odobrenje (administrator) odobrava jednu čašu bez računa; to se upisuje u dnevnik.
• Kako odobrenje stiže do računala za točenje:
  • Kegboard (Kegbot, otvoreni kod, ESP32 s mjeračima protoka i magnetnim ventilima; potpuno javni protokol): blagajna daje grant za slavine s tim proizvodom, releje i količinu. Ploča sama zatvara slavinu kad je količina dosegnuta ili je vrijeme isteklo.
  • Mreža/serijski: podesiva naredba za odobrenje s {kraan}, {ml}, {porties}, {sec} i {id} (npr. V{kraan};{ml}), poslana u obliku poruke izvora (redak ili STX … ETX s XOR). Neobavezno postoji i naredba za zaustavljanje. Točnu naredbu daje dobavljač.
• Povezivanje Kegboarda: u + Izvor odaberite marku Kegbot Kegboard. Pločica se javlja izvoru; kliknite Dopusti (ili Odbij). Pločica tada jednom dobiva vlastiti ključ, koji blagajna čuva samo kao hash. Drugi uređaj ili pogrešan ključ ne mijenja ništa na povezanoj pločici; ako je pločica izgubila ključ, najprije upotrijebite Prekini vezu. Izvor prikazuje firmware, mjerače i releje pločice. Slavine su brojevi mjerača (0, 1 …). Kartica prislonjena na pločicu odbija se: plaćanje se obavlja na blagajni. Ako je sustav za točenje isključen, pločica čuva svoje poruke i šalje ih kasnije.
• U izvoru postavljate nakon koliko sekundi bez protoka se slavina zatvara (5–300, zadano 30). Za svaku slavinu unesite broj mjerača, relej (elektromagnetski ventil) i koliko dugo slavina smije biti otvorena nakon unosa na blagajni.

Upravljanje glazbom s blagajne

Osoblje upravlja glazbom sa zaslona osjetljivog na dodir na blagajni, pa nije potreban zaseban zaslon za šankom. Uključite to u Postavke → Objekt → Zasloni i rukovanje → Upravljanje glazbom s blagajne (zadano isključeno). Tada se u gornjoj traci pojavljuje gumb Glazba: za svaki izvor (npr. Šank i Terasa) Reproduciraj, Pauza, Sljedeće, Prethodno, Glasnije, Tiše i klizač za glasnoću, uz prikaz onoga što sada svira. Natrag na blagajnu zatvara ploču. Pri isključivanju izvori ostaju spremljeni.

• Red za reprodukciju (Sonos, Bluesound i VLC): popis s onim što trenutno svira. Dodirni pjesmu da je pustiš; s Prilagodi uklanjaš pjesme (✕), pomičeš ih gore ili dolje (↑ ↓; Sonos i Bluesound) ili prazniš red za reprodukciju. S Odaberi drugu glazbu puštaš Sonos favorit (npr. radijsku postaju ili Tunify kanal) ili Sonos popis za reprodukciju, ili BluOS predložak.
• Na zasebnom zaslonu: isto upravljanje i red za reprodukciju u velikom na http://<kassaserver>:3000/muziek, npr. na drugom monitoru pokraj blagajne ili tabletu za šankom (ako si već prijavljen na istom uređaju, inače s PIN-om).
• Na tabletu ili mobitelu: QR kod s adresom tog zasebnog zaslona u mreži lokala. Djelatnik ga skenira vlastitim tabletom ili mobitelom (na wifi mreži lokala) i prijavljuje se vlastitim PIN-om; s Odjava se ponovno zatvara. Vidi Drugi zaslon na tabletu ili mobitelu.

Administrator dodaje izvore gumbom + Izvor glazbe, odabire kako je pojedini povezan i provjerava ga gumbom Testiraj:

• Soundtrack (soundtrack.io): putem javnog API-ja, s API tokenom (zatražite ga od Soundtracka) i zvučnom zonom (Učitaj zone). Reprodukcija, pauza, sljedeće, glasnoća i što svira.
• Sonos: IP adresa zvučnika (kod grupe: zvučnik koji vodi grupu). Radi sa svime što svira na Sonosu, npr. Tunify, Spotify ili radio.
• Bluesound (BluOS): IP adresa playera; također radi sa svime što na njemu svira, npr. Tunify.
• VLC na glazbenom računalu: uključeno web sučelje (Alati → Postavke → Prikaži sve → Sučelje → Glavna sučelja: Web, s lozinkom kod Lua); IP adresa (po potrebi s :poort, zadano 8080) i lozinka.
• Vlastito glazbeno računalo (web adrese): za glazbeno računalo ili uređaj s web adresom za svaki gumb; GET ili POST, te {volume} (0-100) u adresi za glasnoću. Bez adrese za Glasnije/Tiše blagajna mijenja glasnoću u koracima.
• Web player glazbene usluge: web adresa web playera ili upravljačke stranice (npr. web player Tunifyja ili Media Toolsa) otvara se u blagajni na gumb Glazba; ako se usluga ne smije prikazivati na drugoj stranici, koristite Otvori u zasebnom prozoru.

Blagajna komunicira s playerima sa servera, pa oni moraju biti u istoj mreži kao blagajna (Soundtrack putem interneta). Upravljati može svatko tko je prijavljen; za postavljanje je potrebna ovlast Postavljanje objekta, plaćanja i pisača. Token i lozinka nikada se više ne prikazuju na zaslonu ni u zapisniku; u zapisniku je samo postavljanje (uklj./isklj., izvori), a ne svaki pritisak gumba. Izvoz konfiguracije prenosi samo uklj./isklj. (izvori pripadaju jednom objektu).

Drugi zaslon na tabletu ili mobitelu

Glazba i kamere mogu se prikazati i na vlastitom tabletu ili mobitelu djelatnika, kao drugi zaslon pokraj blagajne. U prozoru Glazba ili Kamere nalazi se gumb Na tabletu ili mobitelu: on prikazuje QR kod s adresom, npr. http://192.168.1.20:3000/muziek ili .../camera.

1. Spoji tablet ili mobitel na wifi mrežu lokala.
2. Skeniraj QR kod kamerom (ili upiši adresu u preglednik).
3. Prijavi se vlastitim PIN-om. Vidiš samo ono što smiješ: glazbu svi, kamere samo s pravom Gledanje slika kamera.
4. Gotovo: Odjava gore desno. Ako je prijava istekla (npr. tablet je cijelu noć mirovao), zaslon ponovno traži PIN.

Savjet: dodaj stranicu na početni zaslon tableta (u pregledniku: Dodaj na početni zaslon), tada se otvara kao aplikacija.

Zato blagajna traži IP adresu računala blagajne u mreži (ako računalo ima više adresa, npr. wifi i kabel, odabereš mrežu). Na portalu za upravljanje (blagajna na daljinu) to je adresa portala. QR kod izrađuje sama blagajna, bez interneta.

Uparivanje tableta: jednim gumbom na tablet (opcionalno)

Još jednostavnije: jednom uparite tablet i blagajna jednim gumbom šalje glazbu ili kamere na taj tablet. Uključite to pod Postavke → Objekt → Zasloni i rukovanje → Tableti kao drugi zaslon (zadano isključeno).

1. Na tabletu: otvorite http://<kassaserver>:3000/tablet (uz postavku stoji Na tabletu ili mobitelu s QR kodom), prijavite se PIN-om i dajte tabletu naziv, npr. Tablet Šank. Upari.
2. Na blagajni: u prozoru Glazba ili Kamere sada stoji gumb Na Tablet Šank (sa zelenom točkom ako je tablet uključen). Dodirnite ga: tablet sam otvara taj zaslon. Kod glazbe se prenosi i odabrani izvor (npr. Terasa).
3. Na tabletu: Zatvori vraća na čekanje; Prekini uparivanje ovog tableta uklanja uparivanje.

Ostavite stranicu na tabletu otvorenom; ako je tablet isključen ili spava, otvorit će zaslon čim se ponovno uključi. Tablet ostaje prijavljen kao djelatnik koji se na njemu prijavio: slanje i gledanje kamera moguće je samo s pravom Gledanje slika kamera. Administrator uz postavku vidi koji su tableti upareni i jesu li uključeni te ih može preimenovati ili ukloniti. Tablet čuva vlastiti ključ; blagajna od njega čuva samo hash. Pri isključivanju upareni tableti ostaju spremljeni. U zapisniku stoji tko je uparivao, preimenovao ili uklonio tablet.

Zaslon za pozivanje narudžbi za van

Zaslon za goste s U pripremi lijevo i Spremno desno, s velikim brojevima, kao u zalogajnici ili restoranu brze hrane. Uključi ga u Postavke → Objekt → Zasloni i rukovanje → Zaslon za pozivanje narudžbi za van (zadano isključeno).

Uparivanje nije potrebno: na televizoru s preglednikom (smart TV, stick ili mini-PC), tabletu ili drugom monitoru otvori adresu blagajne s /oproep, npr. http://192.168.1.20:3000/oproep. Kod postavke i u prozoru Pozovi nalaze se gumbi Na zasebnom zaslonu i Na tabletu ili mobitelu (QR kod s adresom). Prijava nije potrebna: zaslon prikazuje samo brojeve. Dodirni zaslon jednom i preglednik smije puštati zvuk.

Što se prikazuje:

• narudžbe za van s blagajne, iz web-trgovine i s Thuisbezorgd (i po želji narudžbe na šanku bez stola, kod brze prodaje), iz zadnjih 12 sati;
• čim je nešto poslano u kuhinju ili šank (ili je web-trgovina na u pripremi): tada je broj pod U pripremi;
• Spremno se postavlja samo kad kuhinjski zaslon javi da je cijela narudžba spremna ili kad je narudžba iz web-trgovine na spremno. Broj kratko zatreperi i zaslon zazvoni ding-dong;
• spreman broj ostaje onoliko minuta koliko je postavljeno (zadano 10) ili do Preuzeto;
• narudžbe s kioska (vidi Samoposlužni kiosk) uvijek su prikazane čim su plaćene ili će biti plaćene na blagajni, i kod "jedem ovdje", s brojem za preuzimanje s njihova računa;
• po želji i narudžbe za dostavljače Thuisbezorgda, Uber Eatsa, Deliverooa i HubRisea (kvačica Također narudžbe za dostavljače …): s brojem narudžbe platforme i nazivom platforme ispod, da dostavljač vidi kad mu je narudžba spremna. Preuzeto tada i platformi javlja da ju je dostavljač preuzeo (kao u prozoru platforme).

Broj: kod web-trgovine, Thuisbezorgda i platformi za dostavu broj narudžbe koji gost ili dostavljač već ima; inače broj za preuzimanje (1 do 999). Velik je na računu, s objašnjenjem da će se broj pojaviti na zaslonu kad narudžba bude gotova (na jeziku računa).

Neobavezno (zadano isključeno, u postavci):

• Najava broja glasom: kod novog gotovog broja zaslon kaže npr. "Nummer 42…" na odabranom jeziku (nizozemski, engleski, njemački, francuski, španjolski, talijanski, portugalski, poljski, turski ili arapski). Glas dolazi iz preglednika zaslona i zvuči drukčije na svakom uređaju; nakon otvaranja jednom dodirnite zaslon. Nakon zvona, ako je i zvuk uključen.
• Status narudžbe na mobitelu: ispod broja za preuzimanje na računu pojavljuje se QR kod. Gost ga skenira, vidi svoj broj i status (naručeno, priprema se, gotovo, preuzeto) i dobiva obavijest kad je narudžba gotova. Radi preko portala za upravljanje, pa blagajna mora biti povezana s njim. Ne za web-trgovinu i Thuisbezorgd (imaju vlastiti status) i ne za kiosk (ima vlastitu postavku).

Na blagajni je gumb Pozovi (s brojem narudžbi koje su još u pripremi):

1. Spremno ručno postavlja broj na spremno (bez kuhinjskog zaslona ili kad je brže). Kod narudžbe iz web-trgovine ili s Thuisbezorgd mijenja se i status, pa gost dobiva i obavijest.
2. Natrag ga vraća pod U pripremi.
3. Preuzeto ga uklanja sa zaslona (uz Poništi).

Kod postavke biraš i hoće li se ime prikazivati pokraj broja (zadano ne, zbog privatnosti) i hoće li zaslon davati zvuk. Isključivanje: nema gumba Pozovi ni broja za preuzimanje na računu; postavke ostaju spremljene. U dnevniku piše tko je što ručno postavio na spremno, vratio ili označio kao preuzeto.

Prijava i odjava s posla

Evidencija radnog vremena zadano je isključena: tada se nigdje u blagajni ne vidi (nema gumba u gornjoj traci, ništa na zaslonu za prijavu, nema kartice Radno vrijeme). Uključi je u Postavke → Lokal, pod Prijava i odjava rada osoblja:

• Isključeno: ne koristiti. Ako kasnije isključite evidenciju, više se nigdje ne vidi, ali već evidentirani sati ostaju spremljeni (ništa se ne briše); kad je ponovno uključite, opet su tu.
• Uključeno: zaposlenici mogu prijaviti početak i kraj rada. Nakon prijave blagajna pita želiš li prijaviti početak rada (Ne sada je dopušteno). U gornjoj traci tada stoji Početak rada ili Na poslu od 17:02; dodirni to za kraj rada.
• Obavezno: nakon prijave najprije prijavi početak rada, inače ne možeš koristiti blagajnu. Kraj rada te odmah odjavljuje.

Tko ne koristi blagajnu (npr. kuhinja) bilježi rad na zaslonu za prijavu: dodirni Početak / kraj rada i unesi svoj PIN. To se izmjenjuje između početka i kraja, bez prijave u blagajnu.

Ako je evidencija rada uključena, administrator u Postavke → Radno vrijeme vidi:

• tko je trenutačno na poslu (i može odjaviti nekoga tko je zaboravio prijaviti kraj rada);
• odrađene sate po zaposleniku po razdoblju, sa svim smjenama, i preuzimanje kao CSV (sati i kao decimalni broj za obračun plaća);
• uređivanje ili dodavanje smjena (dodirni smjenu ili + Dodaj smjenu). Svaka promjena bilježi se u zapisnik sa starim i novim vremenima.

U Belgiji se svaki početak i kraj rada prijavljuje i crnoj kutiji. Ako ona nije dostupna, evidencija ne prolazi (kao i naplata). Zadovoljava li to u potpunosti belgijsku evidenciju osoblja, još treba potvrditi.

Vaganje i etikete (vaga)

Ako je vaga uključena (Postavke → Vaga), proizvodi mogu imati cijenu po kilogramu. Svi ostali proizvodi ostaju po komadu.

• Vaganje: dodirni proizvod s cijenom po kilogramu (gumb prikazuje npr. 12,95/kg). Prozor Vaganje uživo prikazuje težinu s vage (npr. Aclas OS6X ili vaga na kojoj radi sama blagajna); zeleno = stabilno. Stavi proizvod na vagu i dodirni Dodaj čim je težina stabilna. Cijena je cijena po kilogramu × težina (zaokruženo na cent); posuda (tara) proizvoda automatski se oduzima. Ako proizvod ima opcije, one dolaze nakon toga.
• Više vaga: ako postoji više vaga, na vrhu prozora odaberi na kojoj važeš. Svaka blagajna/tablet pamti svoj odabir.
• Ručno: nema vage (ili je ručni unos dopušten)? Tada upiši težinu: 0,512 ili 1,2 su kilogrami, 512 ili 512 g su grami.
• Etiketa s TS6X: skeniraj crtični kôd etikete skenerom crtičnog kôda na zaslonu narudžbe (samo skeniraj, ništa ne treba biti otvoreno) ili dodirni Etiketa i skeniraj ili upiši 13 znamenki. Proizvod (PLU) i težina dolaze s etikete. Ako je na etiketi cijena, blagajna naplaćuje točno tu cijenu.
• Na zaslonu, računu i zaslonu za kupce prikazuje se i težina, npr. Gehakt 6,63, a ispod toga 0,512 kg x € 12,95/kg; na kuhinjskom listiću 0,512 kg Gehakt. Dijeljenje, premještanje i povrat rade se u kilogramima.
• Vagani proizvod moguć je samo uz vezu s poslužiteljem blagajne (težina dolazi preko poslužitelja blagajne).

Uber Eats, Deliveroo i HubRise

Osim Thuisbezorgd.nl / Takeaway.com u blagajnu stižu i narudžbe s Uber Eatsa (Nizozemska i Belgija), Deliveroa (samo Belgija; Deliveroo je krajem 2022. napustio Nizozemsku) i sve što je na HubRiseu (npr. Uber Eats, Deliveroo, Just Eat/Takeaway.com i manje aplikacije za naručivanje). Svaka se platforma posebno uključuje u Postavke → Platforme za dostavu (zadano isključeno, isključivanjem se sve čuva). Kartica za svaku platformu prikazuje u kojim zemljama radi i upozorava ako ne radi u zemlji objekta.

• Uključite, zatim Prijavi se na Uber Eats i poveži trgovinu (objekt se prijavljuje vlastitim Uber Eats računom). Ako račun ima više trgovina, upišite ID trgovine (store id) i ponovno se prijavite. Za to Uber Eats najprije mora odobriti Pin Voordeel kao partnera.
• Deliveroo: izravno, preko portala. Upišite site-id (location id) i ID marke (brand id). Bez tableta (zadano): blagajna prihvaća ili odbija; s tabletom: objekt prihvaća na tabletu, a portal samo javlja je li narudžba u blagajni.
• HubRise: blagajna sama preuzima narudžbe (svakih 20 sekundi, portal nije potreban).
• Po platformi: automatski prihvaćaj, kuhinjski nalog odmah u kuhinju/šank i (Uber Eats, Deliveroo) automatski pošalji jelovnik nakon promjene te Pošalji jelovnik sada. Na jelovniku su proizvodi označeni pod Proizvodi na jelovniku Uber Eatsa i Deliveroa, s opcijama izbora; rasprodano se također prenosi.

Narudžbe. Narudžba postaje obična narudžba (bezorgen ili afhalen, naziv grupe <platform> <nummer>) s cijenama platforme: proizvodi se prepoznaju po ID-u (iz jelovnika), kôdu ili PLU broju, nepoznato = zasebna stavka s cijenom platforme (i obavijest); troškovi dostave, nadoplate i popust kao zasebne stavke; ako ukupni iznos ipak ne odgovara, stavka "Razlika". Kuhinjski nalog odmah ide u kuhinju/šank. Gumb Platforme u gornjoj traci (s brojem narudžbi u tijeku; narančast kad ima nešto za prihvatiti): prihvaćanje ili odbijanje (s razlogom), u pripremi, spremno, na putu, dostavljeno ili preuzeto, otkazivanje i Završi (plaćeno online). Ono što platforma poznaje vraća se natrag (Uber Eats: prihvaćanje, odbijanje, otkazivanje; Deliveroo: prihvaćanje, odbijanje, u pripremi, spremno, preuzeto; HubRise: svi statusi). Ako objekt sam dostavlja (vlastita dostava), narudžba je i u Ture, a polazak i dostava automatski idu platformi. Otkazivanje od strane platforme poništava narudžbu. Ako blagajna dulje od 2 minuta nije povezana s portalom, portal odbija novu narudžbu s Uber Eatsa i javlja Deliveroou (s tabletom) da nije uspjelo, kako bi objekt to vidio na tabletu.

Kôd: apps/pos-server/src/lib/bezorgplatforms.ts, routes/bezorgplatforms.ts; zasloni Bezorgplatforms.tsx. Strana portala: horecapos-portaal/src/platforms.mjs. Dnevnik: Platforme za dostavu (uklj./isklj., postavke, narudžbe). Sve je uključeno u sigurnosne kopije blagajne.

Manje platforme u Nizozemskoj i Belgiji (Homie, Hebtrek, sneleten.nl, Bistroo ...) nemaju javno povezivanje s blagajnom; ako su na HubRiseu, rade preko HubRisea. Dalje: vidi backlog.

Automat za gotovinu (zatvoreni sustav za gotovinu)

Zadano isključeno: gotovina radi kao i uvijek. Kod zatvorenog sustava za gotovinu osoblje ne dira gotovinu: kupac ili djelatnik ubacuje novac u automat, koji ga broji, provjerava ima li krivotvorenog novca i vraća ostatak.

• Automati s kojima blagajna izravno komunicira:
  • CashDro (3, 4+, 5, 7, S Compact; NuKassa, KluisKassa): putem mreže (web service). Na CashDro uključi Web Integration i izradi vlastitog korisnika za blagajnu.
  • Cashmatic (SelfPay 460/860/1060; u Belgiji Xpos): putem mreže (priključak 50301) s korisnikom Cashmatica.
  • Azkoyen Cashlogy (POS1000, POS1500): putem CashlogyConnector na Windows računalu uz automat (priključak 8092).
  • CashKeeper: putem CKMonitor na Windows računalu (priključak 16501).
  • Glory CASHINFINITY (CI-5, CI-10, CI-10X; i putem Cikama): putem upravljanja (FCC) automata. Još beta: neka prvo povezivanje provjeri Glory ili tvoj zastupnik.
  • Vanjski: drugi softver upravlja automatom i komunicira s blagajnom (npr. Cikam, ImaCash za 25 marki, softver CashGuard/StrongPoint (Merlin), PayComplete (SUZOHAPP), Gunnebo SafePay ili francuske marke poput CashMag).
  • Probni automat: bez hardvera, za vježbu ili prezentaciju. S Testiraj vezu provjeravaš adresu i prijavu. Stavi automat u vlastitu mrežu (nikada otvoren prema internetu) i koristi vlastitog korisnika za blagajnu, ne administratora.
• Naplati s Gotovina: Plati na automatu za gotovinu pokreće plaćanje za iznos (zaokružena gotovina ako je to uključeno, plus napojnica; kod dijeljenja računa dio). Zaslon prikazuje što je ubačeno i što se vraća; blagajna naplaćuje tek kada automat javi gotovo. Odustani = automat vraća novac. Ako automat nije mogao vratiti sav ostatak (premalo kovanica), navedeno je koliko treba isplatiti iz ladice blagajne. Uspješno plaćanje koje još nije naplaćeno (npr. tablet se ugasio) ponovno se pronalazi kod te narudžbe.
• Gotovina samo putem automata (zadano uključeno): tada poslužitelj blagajne prihvaća gotovinu samo uz uspješno plaćanje na automatu za točno tu narudžbu i taj iznos. Isključeno = i obična gotovina u ladicu.
• Ladica blagajne (Izvješće → Blagajna, pravo Upravljanje ladicom blagajne): Dohvati stanje (po kovanici i novčanici, kod Cashmatica, Cashlogyja, Gloryja i probnog automata), Isplati s razlogom (npr. ostatak za ladicu), Punjenje i Izdvajanje viška (ostatak ostaje; kod Cashmatica). Očekivano u ladici blagajne ne uračunava novac u automatu (on je naveden zasebno ispod: U automatu za gotovinu), ali uračunava ostatak koji se morao isplatiti iz ladice.

Gumb ©

Dolje desno na svakom zaslonu (PIN, tlocrt, naručivanje i kuhinja) nalazi se mali gumb ©. On otvara podatke o OptimumPOS-u: logotip, adresu, telefon, e-poštu i web-stranicu. Ikona je spremljena lokalno u aplikaciji pa radi i bez interneta. Ista ikona je i ikona aplikacije (kartica preglednika i početni zaslon).

Dio 2 · Voditelj

Prvi koraci

Voditelj prema zadanim postavkama može sve što može i konobar, a uz to, među ostalim, davati popuste, obavljati povrate, zaključiti dan, upravljati ladicom blagajne te pregledavati zapisnik i zalihu. To je uglavnom pod gumbom Izvješće:

• Međustanje (X): dosadašnji promet, bez zaključivanja dana.
• Ladica blagajne: početni novac, novac u/iz ladice i otvaranje ladice.
• Zaključi dan (Z): na kraju dana; nakon toga počinje novi dan.
• Prethodna Z-izvješća, Promet po razdoblju i Nadzorna ploča.
• Zapisnik, Poklon bonovi i Kupci.

Zalihe

Prema zadanim postavkama isključeno. Uključite putem Postavke → Lokal → Praćenje zaliha. Isključeno = nigdje se ne vidi na blagajni.

• Za svaki proizvod u Postavke → Proizvodi → (proizvod) → Zalihe birate:
  • Ne: kao i uvijek;
  • Po proizvodu: svaka prodaja oduzima 1 (npr. bočice, limenke), s razinom upozorenja za "skoro nestalo";
  • Putem sastojaka: recept, npr. hamburger = 1 pecivo + 150 g mesa + 1 kriška sira. Svaka prodaja oduzima sastojke.
• Postavke → Zalihe (pravo Upravljanje zalihama, prema zadanim postavkama voditelj i administrator):
  • Proizvodi i Sastojci: stanje, s oznakom nestalo / skoro nestalo; filtar "samo (skoro) nestalo" i izvoz u CSV.
  • Za svaki proizvod ili sastojak knjižite Primitak (+) (isporuka), Inventura (=) (prebrojana količina postaje novo stanje) ili Otpis (−) (lom, istekao rok; razlog je obavezan).
  • Izrada sastojaka s jedinicom (kom, g, kg, ml, cl, l, porcija, boca, bačva) i razinom upozorenja.
  • Povijest: sve promjene (prodaja, storno, primitak, inventura, otpis) s time tko i kada. Upravljačke radnje bilježe se i u dnevnik.
• Oduzimanje se događa pri Naruči (ili pri naplati za ono što je odmah naplaćeno). Storno vraća količinu. Dijeljenje i premještanje ne broje se dvaput. Kod menija se oduzimaju jela, a ne stavka menija. Povrati (storno račun) ne vraćaju količinu (vraćena roba se obično više ne može prodati); po potrebi to knjižite kao primitak.
• Ako su zalihe nestale (ili sastojka nema dovoljno ni za još jedan put), proizvod se na svim blagajnama automatski označava kao rasprodano. Kad je skoro nestalo, na gumbu proizvoda piše još N. Nakon primitka ili inventure proizvod se odmah ponovno može naručiti. I poslužitelj blagajne tada odbija proizvod ("Pils" je nestao (zaliha 0)), dakle i s tableta koji to još nije znao.
• Zalihe smiju pasti ispod 0 (npr. dva tableta istodobno ili narudžba izvan mreže); inventura to ponovno ispravlja.
• Popis za narudžbu: Postavke → Zalihe → Popis za narudžbu. Za svaki proizvod (po proizvodu) i svaki sastojak uz razinu upozorenja postavljate i dopuni do te dobavljača. Na popisu za narudžbu nalazi se sve što je na razini upozorenja ili ispod nje (bez razine upozorenja: na 0), po dobavljaču, s prijedlogom dopuni do − stanje. Količine se mogu mijenjati i uključivati/isključivati kvačicom. Zatim Ispiši (pisač računa), Kopiraj (za e-poštu ili WhatsApp), Izvoz (CSV), a nakon isporuke Isporučeno: knjiži kao primitak (sve knjiži odjednom). Kvačicom na vrhu vidite i ono što još nije nestalo, kako biste naručili dodatno.
• Opcije izbora: kod grupe izbora (Postavke → Proizvodi → Opcije izbora) nalazi se gumb Zalihe. Za svaki izbor unesite sastojke po komadu, npr. Dodatni sir = 1 kriška sira, Pomfrit = 150 g pomfrita. Kad se izbor odabere, ti se sastojci oduzimaju po komadu (čak i ako sam proizvod ne prati zalihe; pri stornu se vraćaju). Ako sastojka nema, izbor se na blagajni prikazuje kao (nestalo) i ne može se odabrati.

Naručivanje od dobavljača

Zadano isključeno. Uključuje se u Postavke → Zalihe → Naručivanje od dobavljača (samo uz uključeno Praćenje zaliha). Isključeno = popis za naručivanje radi kao i uvijek.

• Dobavljači (kartica Dobavljači): odaberi jednog s popisa ili izradi vlastitog dobavljača. Popis sadrži veleprodaje i cash & carry (Sligro, Sligro-ISPC/Sligro-M, HANOS, Makro, De Kweker, Horeca Totaal, Van Zon, zegro, Lekkerland), foodservice (Bidfood i Bidfood Belgium, Solucious, Chefs Culinar, Java, Q-Food, Agora Culinair, VHC Jongens/Kreko/Actifood, Hocras, Van Hoeckel ...), veleprodaje pića (De Klok, Henk Smit, Horesca, De Monnik, Hansen, Dranken Geers ...), pivovare i bezalkoholna pića (Heineken putem Sligra, AB InBev/BEES, Alken-Maes, Haacht, Duvel Moortgat, Martens, Coca-Cola, Spadel, Grolsch, Bavaria), dobavljače svježih proizvoda (Van Gelder, Driessen, FiliusKaas, Bakkers Brigade, Rungis ...), neprehrambene proizvode (Bunzl, Takeaware, Supplierz), internetsku trgovinu vinima Vinify.nl i platforme za naručivanje (Apicbase, Exact Horeko, Growzer, inOne, Cuisin.io, OrderXL). Na popisu su samo dobavljači iz zemlje lokala. Kad odabereš jednog, način naručivanja, datoteka i stupci već su ispravno postavljeni; uz svakog dobavljača piše kako se kod njega naručuje.
• Po dobavljaču: broj kupca, naruči putem:
  • E-pošta: narudžba kao e-poruka (s tablicom) na adresu e-pošte za narudžbe, neobavezno kopija, s popisom za naručivanje u privitku: CSV, Excel, CSV za Care4Fresh (mnoge veleprodaje svježih proizvoda), UBL 2.1 Order (Peppol BIS Order), EANCOM ORDERS (D96A u Nizozemskoj, D01B/HO2C u Belgiji) ili cXML. Odgovori stižu na adresu e-pošte lokala.
  • Datoteka: blagajna izrađuje datoteku, ti je učitavaš u web trgovinu dobavljača (npr. Bunzl Snel bestellen: artikel;aantal, Takeaware: SKU,Quantity). Razdjelnik, redak zaglavlja i stupci mogu se podesiti (artikel, ean, omschrijving, aantal, eenheid, prijs, totaal; s artikel=SKU stupcu daješ vlastiti naziv).
  • Povezivanje (cXML): cXML OrderRequest s brojem kupca i zajedničkom tajnom na adresu za narudžbe dobavljača, kao što ih sustavi za nabavu šalju Sligru, HANOS-u i Bidfoodu. Adresu, broj kupca i tajnu dobivaš od dobavljača (Sligro: koppelingen@sligro.nl). Tajna se nikada ne vraća na zaslon.
  • Kod oba povezivanja mogu se koristiti i korisničko ime i lozinka (Basic) te dodatna zaglavlja (jedno po retku, npr. X-Api-Key: ...).
  • Prijenos (SFTP/FTPS): blagajna sama stavlja datoteku (EANCOM, UBL, CSV, Excel ...) u mapu na poslužitelju dobavljača, kao što mnogi veletrgovci primaju EDI narudžbe. SFTP (SSH), FTPS (eksplicitni na priključku 21 ili implicitni na priključku 990) ili, samo u vlastitoj mreži, FTP. Prijava lozinkom ili SSH ključem (OpenSSH, PEM ili PuTTY .ppk; ed25519, ECDSA ili RSA). Izradi ključ izrađuje par ključeva u blagajni; javni ključ šalješ dobavljaču. Testiraj vezu se prijavljuje i traži mapu. Otisak SFTP poslužitelja bilježi se pri prvom povezivanju i zatim provjerava (drugi poslužitelj ne dobiva lozinku); kod FTPS-a s vlastitim certifikatom fiksiraš otisak certifikata. Za to nije potreban dodatni softver.
  • Ispis: narudžba na pisaču računa, za prosljeđivanje telefonom.
• Lozinke, ključevi, tokeni i zaglavlja nikada se ne vraćaju na zaslon (ostaviti prazno = zadrži, Obriši = ukloni).
• Zatraži povezivanje: kod dobavljača blagajna sastavlja e-poruku za povezivanje (cXML, EDI putem SFTP/FTPS, UBL/Peppol ili vlastiti API dobavljača) s podacima lokala (naziv, adresa, PDV broj, broj kupca, GLN) i onim što je potrebno; kod EDI-ja s javnim ključem. Prilagodi i pošalji; kopija i odgovori idu na e-adresu lokala. Datum zahtjeva prikazan je kod dobavljača. Kod Sligra ide na koppelingen@sligro.nl, inače uneseš adresu svog account managera.
• Vlastiti dobavljač (nije s popisa) može sve osim onoga što dobavljač sam mora ponuditi: e-pošta, datoteka i ispis rade uvijek; povezivanje ili prijenos samo s podacima tog dobavljača.
• Dani naručivanja i isporuka: dani naručivanja, krajnje vrijeme, rok isporuke (željeni datum isporuke na narudžbi) i minimalni iznos narudžbe. Automatski: na dane naručivanja od tog vremena blagajna sama pripremi narudžbu kao nacrt (ti je pregledaš) ili je odmah pošalje (e-poštom, prijenosom ili povezivanjem; ispod minimalnog iznosa narudžbe samo je pripremi kao nacrt). Jednom dnevno po dobavljaču.
• Po proizvodu (Postavke → Proizvodi → (proizvod) → Zalihe, kod Po proizvodu) i po sastojku: Naruči od (dobavljač), broj artikla za narudžbu kod tog dobavljača, EAN, po pakiranju (gajba od 24 = 24), naziv pakiranja i nabavna cijena po pakiranju. Razina upozorenja je trenutak za naručivanje; dopuni do koliko tada mora biti na zalihi.
• Narudžbenice (kartica Narudžbenice):
  • Prijedlog narudžbe po dobavljaču: sve što je na razini upozorenja ili ispod nje. Ono što je već naručeno, a još nije stiglo (na putu), uračunava se, tako da ništa ne naručiš dvaput. Prijedlog = dopuni do − stanje − na putu (bez dopuni do: do razine upozorenja), zaokruženo naviše na cijela pakiranja. Prilagodi količine i Izradi narudžbu.
  • Narudžba je najprije pripremljena: količine, zasebne stavke (bez proizvoda, npr. salvete), napomena i datum isporuke još se mogu mijenjati. Zatim Pošalji (na način dobavljača ili ovaj put drukčije). Ako ne uspije (npr. dobavljač odbije), razlog je naveden i možeš pokušati ponovno.
  • Primljeno: po stavci primljena količina (već je postavljena na naručenu količinu); zalihe se povećavaju po pakiranju (2 gajbi od 24 = 48), s narudžbom zabilježenom u povijesti.
  • Svaka datoteka (CSV, Excel, UBL, EANCOM, cXML) može se i zasebno preuzeti.
• Poslano, neuspjelo, primljeno i otkazano bilježe se u dnevnik. Obični Popis za naručivanje i dalje radi; ako je kod proizvoda dobavljač s popisa, proizvod je ondje pod tim nazivom.

Upravljanje recenzijama

Recenzije s Googlea i Trustpilota čitate i na njih odgovarate u blagajni. Uključuje se u Postavke → Bodovi i recenzije → Upravljanje recenzijama (zadano isključeno, tada se nigdje ništa od toga ne vidi). Čitanje i odgovaranje u Izvješće → Recenzije (pravo Čitanje recenzija i odgovaranje na njih, standardno i za voditelja). Ako to isključite, veze i recenzije ostaju spremljene.

• Svaki objekt zatim samo dodirne Poveži s Googleom i prijavi se vlastitim Google računom poslovnog profila. Ključ za Places može se postaviti i centralno (troškove tada snosi dobavljač). Trustpilot je po objektu: svaki objekt ima vlastiti Trustpilot Business račun (API je dio plaćene pretplate), iz kojeg dolaze ključ, tajni ključ i business user ID. U blagajni uz svaki način piše "Tko to uređuje?".
• Aplikacija dobavljača (putem portala za korisnike): ako su Google aplikacija i/ili Trustpilot aplikacija dobavljača u portalu za korisnike (vidi README od horecapos-portaal, "Reviews: apps van de leverancier"), administrator u Prijava i ključevi odabire Aplikacija dobavljača (zadano kod nove veze ako portal ima aplikaciju). Objekt dodirne Poveži s Googleom ili Prijavi se s Trustpilotom i prijavi se vlastitim računom; blagajna sama čeka da prijava završi (svakih 3 sekundi, najviše 15 minuta) i jednom preuzima tokens s portala. Obnavljanje također ide putem portala. U blagajni nisu potrebni client-ID, secret ni API ključ; za Trustpilot jesu domena i, za odgovore, business user ID. Javni Trustpilot tada čita putem ključa portala. Zahtijeva PORTAAL_URL i PORTAAL_SLEUTEL. Vlastita aplikacija ili API ključ i dalje radi kako je opisano u nastavku.
• Čije su recenzije: ostaju na vlastitom Google poslovnom profilu i vlastitoj Trustpilot stranici objekta, a blagajna ih sprema samo u vlastitoj bazi podataka blagajne. Odgovori se pojavljuju pod imenom objekta. Portal samo prosljeđuje prijavu (u memoriji, najviše 15 minuta, može se preuzeti jednom) i ne sprema recenzije ni tokens; naziv aplikacije dobavljača vidi se samo na zaslonu za privolu.
• Registriraj se sam: kod svake platforme nalazi se poveznica za samostalnu izradu Google poslovnog profila (business.google.com/create) ili Trustpilot Business računa (business.trustpilot.com), a kod Trustpilota i poveznica na pakete (business.trustpilot.com/plans). Registracija i plaćanje obavljaju se na samoj platformi; za to ne postoji API.
• Zatim Poveži s Googleom i prijavite se računom koji upravlja poslovnim profilom. Jedna poslovnica u profilu = odmah odabrana; više njih = odabir u blagajni.
• Google Places (samo čitanje): s Place ID-jem i API ključem za Places API (ili GOOGLE_PLACES_API_KEY): prosjek, broj recenzija i 5 najrelevantnijih recenzija. Na ovaj način odgovaranje nije moguće.
• Trustpilot Business (čitanje i odgovaranje): API ključ i API tajna aplikacije u Trustpilot Businessu (Integrations → API; ili TRUSTPILOT_API_KEY i TRUSTPILOT_API_SECRET), domena objekta (blagajna sama traži business unit) i, za odgovore, business user ID osobe koja odgovara.
• Trustpilot javno (samo čitanje): samo API ključ.
• Blagajna dohvaća svakih 30 minuta (i odmah nakon povezivanja; Dohvati sada). E-adresu i broj narudžbe gosta (koje Trustpilot šalje) blagajna ne sprema.
• Izvješće → Recenzije: prosjek, broj po zvjezdici, bez odgovora i nepročitano; filtriranje po platformi, zvjezdicama, bez odgovora i nepročitano. Za svaku recenziju Odgovori (najviše 4000 znakova; svi ga mogu pročitati), Izmijeni odgovor, Ukloni odgovor i Pročitano. Nova ili izmijenjena recenzija je nepročitana. U dnevniku se bilježe review_beantwoord i review_antwoord_weg.
• Prekid veze zadržava dohvaćene recenzije.

SMS i e-mail marketing

Poruke kupcima s karticom vjernosti koji su za to dali pristanak. Bez kartice vjernosti ne može se uključiti ni jedno ni drugo.

• Pristanak po kupcu i po kanalu: kod novog kupca na blagajni postoje kvačice "Kupac želi primati akcije SMS-om" i "... e-poštom" (zadano isključene). U Izvješće → Kupci vidiš i mijenjaš pristanak (s datumom kad je dan) i rođendan (samo dan i mjesec). Odjava: makni kvačice i spremi.
• Meni odmah ažuriran: ako uključiš ili isključiš marketing ili karticu vjernosti, blagajna u roku od nekoliko sekundi ponovno šalje meni web-trgovini (samo ako se nešto promijenilo), tako da se kvačica odmah pojavi ili nestane.
• Privola preko web-trgovine: ako objekt ima web-trgovinu, pri plaćanju postoji kvačica "Želim primati ponude e-poštom/SMS-om" (samo uključeni kanali; zadano isključena). Kad takva narudžba stigne, blagajna traži kupca po broju telefona (inače po e-mail adresi), po potrebi ga stvara i sprema privolu s datumom. Broj ili adresa koji nedostaju kod postojećeg kupca se dopunjuju; u zapisniku stoji klant_toestemming s izvorom webshop.
• Izvješće → Marketing (ovlast Upravljanje karticom vjernosti): na vrhu vidiš koliko je kupaca dalo pristanak za SMS, a koliko za e-poštu.
• Akcije (jednokratne): naziv, SMS ili e-pošta, (predmet,) tekst s {naam}, {zaak} i {punten}, a po želji samo kupci koji neko vrijeme nisu došli ili imaju najmanje toliko bodova. Pregledaj pokazuje kojem broju kupaca ide, poruku onako kako je kupac dobiva i broj SMS-ova po kupcu. Pošalji test na vlastiti broj ili adresu. Zatim Pošalji: blagajna šalje u pozadini (najviše 1000 odjednom) i broji što je poslano, a što nije uspjelo. Nitko ne dobiva istu akciju dvaput; ako blagajna stane na pola puta, Nastavi slanje nastavlja kod onih koji još ništa nisu dobili.
• Slanje putem Mailchimpa ili Klaviya (uz povezivanje s odabranim popisom, vidi dolje): kod akcije e-poštom u Slanje putem odabireš blagajnu (vlastiti poslužitelj e-pošte, kao gore) ili Mailchimp ili Klaviyo. Tada blagajna najprije ažurira popis (odjave, bodovi) i ondje izrađuje kampanju točno za odabrane kupce koji su na popisu (Mailchimp: stalna grupa u audienceu; Klaviyo: vlastiti popis za akciju) te je šalje sa zadanim pošiljateljem audiencea ili računa. {naam} i {punten} Mailchimp/Klaviyo popunjava za svakog kupca; ispod je poveznica za odjavu usluge. Bez ograničenja od 1000 po slanju i bez osobnog koda za popust ({code}). Ako ne uspije, akcija ostaje skica s porukom uz nju. Kartica Marketing postoji i kad je aktivno samo povezivanje (tada samo akcije putem Mailchimpa/Klaviya; Pošalji test radi s poslužiteljem e-pošte blagajne). Automatske poruke blagajna uvijek šalje sama; u Mailchimpu/Klaviyu ih izrađuješ kao Customer Journey ili Flow. Klaviyo ključ: i prava pisanja za Campaigns i Templates (tko se već prijavio: ponovno se prijaviti).
• Kao push obavijest putem web-trgovine (ako su u upravljanju web-trgovinom uključene Push obavijesti s ponudama): u Šalji putem odaberi Push obavijest (web-trgovina kao aplikacija), s naslovom (najviše 60 znakova) i kratkim tekstom (najviše 200 znakova; popunjava se samo {zaak}, jer web-trgovina ne zna tko je gost). Blagajna šalje akciju preko upravljačkog portala web-trgovini, a ona je šalje gostima koji su ondje uključili Ponude kao obavijest; dodir otvara izbornik web-trgovine. Nakon nekoliko sekundi uz akciju piše koliko ih je stiglo. Najviše 3 dnevno, zajedno s onim što objekt šalje iz upravljanja web-trgovinom; inače akcija ostaje skica s navedenim razlogom. Kartica Marketing postoji i kad je uključeno samo ovo (bez kartice vjernosti ili marketinga e-poštom). Bez koda za popust ili odabira (dani, bodovi); za test: na vlastitom telefonu u web-trgovini uključi Ponude kao obavijest.
• Automatski: rođendanska poruka (na rođendan, jednom godišnje) i "Nedostajete nam" (nakon toliko dana bez posjeta, jednom svaki put kad kupac izostane). Uključi/isključi po poruci; šalju se samo tijekom dana (10:00–20:00).
• Osobni kod za popust (neobavezno, po poruci ili akciji; samo ako su Kodovi za popust uključeni u Postavke → Objekt): svaki kupac dobiva svoj kod, npr. TERUG-7K4Q2M (rođendan JARIG-…, akcija ACTIE-…), u postotku ili kao fiksni iznos, po želji s minimalnim iznosom narudžbe, za jednokratnu upotrebu, vrijedi zadani broj dana nakon slanja (zadano 30) i na blagajni i/ili u web-trgovini. Stavi {code} i {geldig} u tekst gdje ih želiš; inače blagajna ispod poruke stavlja "Uw kortingscode: … (10% korting, aan de kassa of in de webshop, geldig t/m …)". Pregledaj i Pošalji test prikazuju primjer koda (TERUG-VOORBEELD, ne radi). Ako slanje ne uspije, kod se ne stvara. Kod akcije piše koliko je kodova izdano i iskorišteno.
• Odjava stoji ispod svake poruke: kod SMS-a "Odjava? Nazovite ... ili nam recite pri sljedećem posjetu", kod e-pošte poveznica za odjavu na adresu e-pošte objekta (i gumb Otkaži pretplatu u Gmailu i Outlooku). Odgovor na e-poruku ide objektu.
• Privatnost (GDPR): samo kupci s pristankom i brojem ili adresom; u dnevniku nema brojeva ni adresa, samo po akciji koliko je poslano i koliko nije uspjelo. Ako izbrišeš kupca, nestaje i s popisa za slanje.
• Troškovi: SMS-ovi idu preko tvog vlastitog CM.com računa (više od 160 znakova = više SMS-ova po kupcu). Gmail i drugi poslužitelji e-pošte imaju dnevno ograničenje; kod mnogo kupaca šalji u dijelovima.

Napojnica po djelatniku

U Postavke → Lokal → Napojnica (samo ako je uključeno "Prikaži gumbe za napojnicu pri naplati") birate kako se napojnica po djelatniku prikazuje na međustanju (X), Z-izvještaju (račun i e-pošta) i u Promet po razdoblju (i u CSV-u):

Preostali centi idu onome tko je najbliže sljedećem centu, tako da se ukupni iznos uvijek slaže. Ovo je pregled: blagajna ništa ne isplaćuje (to možete s "Novac iz ladice"). Stari Z-izvještaji ostaju kakvi su bili.

Z-izvještaj e-poštom

U Postavke → Lokal → Pošalji Z-izvještaj na jednom unesite adresu e-pošte administratora (više adresa: odvojite zarezom, najviše 3). Nakon Zaključi dan Z-izvještaj se tada automatski šalje na tu adresu, uz ispisani račun. Prazno = bez slanja, kao i uvijek.

• Slanje se odvija u pozadini, tako da spori poslužitelj e-pošte ne usporava dnevno zaključenje.
• Ako nije uspjelo ili treba ponovno: Izvještaj → Raniji Z-izvještaji → (izvještaj) → Pošalji ponovno (s oznakom KOPIJA).

Sažetak dana (neobavezno)

Ako je unesena adresa pod Pošalji Z-izvještaj e-poštom na, ispod se nalazi kvačica S kratkim sažetkom dana na vrhu e-pošte (zadano isključeno). Uključeno = na vrhu e-pošte sa Z-izvještajem nekoliko redaka običnim jezikom, samo iz vlastitih podataka blagajne (bez AI-ja, ništa ne izlazi van):

• promet, računi i gosti te potrošnja po računu, u usporedbi s istim razdobljem tjedan dana ranije (u postocima); ako tada nije bilo ničega, to se navodi;
• 5 najprodavanijih proizvoda i što se ističe: proizvodi kojih je prodano barem 3 više ili manje nego prošlog tjedna;
• broj storna (u usporedbi s prošlim tjednom) i najprometniji sat (računi i promet).

Sam Z-izvještaj (račun i e-pošta) ostaje potpuno isti. Primjer za danas prikazuje sažetak od posljednjeg zaključenja dana do sada. Sažetak je na nizozemskom, kao i e-pošta sa Z-izvještajem.

Nadzorna ploča

Kartica Nadzorna ploča u Izvještaju (pravo Promet po razdoblju), samo za čitanje:

• Promet po satu kao grafikon: odabrani dan (plavo) uz isti dan prošlog tjedna (sivo). Današnji dan uspoređuje se s prošlim tjednom do istog vremena, tako da je postotak pošten. Pomoću ◀ ▶ ili datuma birate drugi dan.
• Pločice: promet (± % u odnosu na prošli tjedan), računi i prosjek po računu, prosječna potrošnja po gostu (samo u lokalu; za van/dostava se ne broje) za taj dan i za odabrano razdoblje.
• Top 10 proizvoda i najprometniji sati u zadnjih 7, 28 ili 90 dana. Najprometniji sati su toplinska karta dan u tjednu × sat (prosječni promet po radnom danu) s tri najprometnija sata iznad nje, korisno za raspored smjena.

Prodani poklon-bonovi ne računaju se kao promet, a popusti i naslovi menija nisu u top 10 (kao i u drugim izvještajima). Dan traje od 00:00 do 24:00.

Dodatna izvješća

Tri dodatne kartice u izborniku Izvješće, svaka se zasebno uključuje putem Postavke → Objekt → Upravljanje i izvješća → Dodatna izvješća (zadano isključeno: tada nema kartice). Traže isto pravo kao Promet po razdoblju i služe samo za čitanje. Razdoblje: ovaj tjedan, prošli tjedan, ovaj mjesec, prošli mjesec, posljednjih 90 dana, ova godina ili po izboru (najviše nešto više od godinu dana).

• Menu engineering: za svaki proizvod koliko se često prodaje (udio u svim prodanim komadima) u odnosu na to koliko donosi po komadu (marža = prodajna cijena bez PDV-a umanjena za cijenu koštanja). Svaki proizvod dobiva kategoriju: Zvijezda (popularan i visoka marža: ostavi tako), Radni konj (popularan, niska marža: malo podigni cijenu ili ga pojeftini), Zagonetka (malo se prodaje, visoka marža: bolje ga istakni) i Pas (malo se prodaje, niska marža: makni ga s jelovnika ili ga zamijeni). Popularan = najmanje 70% jednakog udjela; visoka marža = najmanje prosječna marža po prodanom komadu. Cijena koštanja dolazi iz Apicbasea (Postavke → Normativi), inače iz nabavne cijene proizvoda (nabavna cijena po pakiranju podijeljena s količinom u pakiranju), inače iz recepta sastojaka s nabavnom cijenom (Zalihe). Proizvodi bez cijene koštanja navedeni su zasebno na dnu. Po želji po kategoriji (?groep=).
• Akcije i kodovi: po kodu za popust, po akciji iz Marketinga (osobni kodovi zajedno) i po happy houru: koliko je puta korišteno (računi; kod happy houra i komadi), koliko popusta, promet i prosjek po računu.
• Otpad: što je otpisano sa zaliha (Postavke → Zalihe, Otpiši (−)), po razlogu (velika slova i razmaci nisu bitni) i po proizvodu ili sastojku, s vrijednošću po cijeni koštanja; te što je stornirano nakon što je već poslano u kuhinju ili šank, s prodajnom vrijednošću i vrijednošću po cijeni koštanja.

Popusti

Voditelj ili administrator na zaslonu narudžbe uz ukupni iznos vidi gumb % Popust:

• na cijeli račun ili na jednu stavku;
• kao postotak (10, 15, 20, 25, 50, 100% = besplatno ili sami unesite) ili kao fiksni iznos;
• uvijek s razlogom (Osoblje, Stalni gost, Pritužba, Akcija, Vlastita potrošnja ili sami upišite).

Popust se na računu prikazuje kao zasebna stavka ("Popust 10%", s razlogom ispod) s istom stopom PDV-a, tako da se ukupni iznos i specifikacija PDV-a slažu. Na cijelom računu popust se raspodjeljuje po stopi PDV-a. Uklanjanje: dodirnite iznos stavke popusta. Ako se otkaže stavka s vlastitim popustom, otpada i taj popust. Ako uklonite proizvod s računa s postotnim popustom na cijeli račun, blagajna ponovno izračunava popust za ono što ostaje (u Belgiji UC226); fiksni iznos ostaje i pri naplati se ponovno raspodjeljuje po stavkama. Ako zbog 100% popusta nema ništa za platiti, zaključite s "Zaključi (ništa za platiti)". Popusti su u dnevniku te u X/Z-izvještaju i pregledu razdoblja kao "od toga popust". Pri povratu računa s popustom popust se razmjerno uzima u obzir.

Kodovi za popust (neobavezno)

Kodovi s popustom na cijeli račun, na primjer za akciju (ZOMER10). Uključuju se u Postavke → Objekt → Kodovi za popust (zadano isključeno); kodove izrađuješ u Postavke → Kodovi za popust (ovlast Upravljanje proizvodima):

• popust u postocima ili fiksni iznos, po potrebi s minimalnim iznosom narudžbe, vrijedi od/do i najviše toliko puta (prazno = neograničeno);
• za svaki kod: na blagajni i/ili u web-trgovini (blagajna šalje kodove zajedno s menijem; korištenje se broji zajedno za blagajnu i web-trgovinu).

Na zaslonu za narudžbe nalazi se gumb Kod za popust (svatko smije unijeti kod; kod je unaprijed izradio objekt). Popust se pojavljuje kao stavka "Kod za popust KOD" na računu, raspoređen po stopama PDV-a; jedan kod po računu, i ne više ako je već (djelomično) plaćeno. Ako ukloniš stavku ili se narudžba otkaže, korištenje se više ne broji. Uklanjanje korištenog koda ga isključuje (izvještaji ostaju točni). Sve je u dnevniku (Kod za popust). Kod: lib/kortingscodes.ts, routes/kortingscodes.ts, Kortingscodebeheer.tsx, KortingscodeDialoog.tsx.

Nisu na popisu u Postavke → Kodovi za popust (ali broj po akciji jest, u Izvješće → Marketing) i prenose se u web-trgovinu dok su valjani i neiskorišteni.

Izvještaji i dnevno zaključenje

Gumb Izvještaj u gornjoj traci:

• Međustanje (X): promet, PDV, načini plaćanja, po grupi i blagajnička ladica od prethodnog dnevnog zaključenja. Može se i ispisati. Ništa ne zaključuje.
• Zaključi dan (Z) (voditelj ili administrator): prebrojite blagajničku ladicu (prikazuje se razlika u odnosu na početni polog + gotovinu), unesite početni polog za sljedeći dan, zaključite. Z-izvještaj dobiva redni broj, sprema se i ispisuje na pisaču računa. Nije moguće dok su narudžbe još otvorene. Opcionalno: Brojanje po kovanici i novčanici (pomoć pri brojanju) umjesto vas unosi prebrojani iznos; brojanje po kovanici/novčanici tada se prikazuje i na Z-izvještaju. Ručni unos ukupnog iznosa radi kao i uvijek.
• Blagajnička ladica (voditelj ili administrator, opcionalno):
  • Novac iz ladice (polog u banku, izdatak, isplaćena napojnica) ili novac u ladicu (sitniš) s iznosom i razlogom. Ladica se otvara i ispisuje se potvrdnica s crtom za potpis koju čuvate uz novac (može se isključiti). Uračunava se u očekivano u ladici i prikazuje se po stavci na X- i Z-izvještaju.
  • Unesite ili ispravite današnji početni polog (obično ga unosite pri dnevnom zaključenju za sljedeći dan).
  • Otvori ladicu bez prodaje, s razlogom.
  • Sve se bilježi u dnevnik. Ako ovo ne koristite, dnevno zaključenje radi točno kao prije (početni polog + gotovina = očekivano u ladici).
• Ispod prometa nalazi se broj gostiju (osobe iz naplaćenih narudžbi) i prosjek po gostu, i na ispisanom X/Z-izvještaju.
• Promet po razdoblju (voditelj ili administrator): danas, jučer, ovaj/prošli tjedan, ovaj/prošli mjesec, ova godina ili sami odaberite od-do. Prikazuje promet, PDV, načine plaćanja, napojnicu, goste, grupe proizvoda, po danu i po djelatniku. Pomoću Izvoz (Excel/CSV) dobivate datoteku za knjigovođu (točka-zarezi i decimalni zarez, otvara se izravno u nizozemskom Excelu).
• Raniji Z-izvještaji: popis s prometom i blagajničkom razlikom; otvaranje i ispis kopije (s oznakom "KOPIJA").

Izvoz u knjigovodstvo

Izvješće → Promet po razdoblju → Izvoz za knjigovodstvo (dnevnik) (pravo Promet po razdoblju) izrađuje CSV s jednim knjiženjem po danu, spreman za učitavanje u e-Boekhouden, Exact, SnelStart, Twinfield i sl. (preko njihova uvoza CSV-a/temeljnice), ili jedan od formata u nastavku (UBL, XAF i spremno za 14 programa).

Po danu jedna temeljnica (KASSA-JJJJMMDD) koja je uvijek u ravnoteži (duguje = potražuje):

Povrati i popusti već su sadržani u računima i smanjuju promet. Stupci: Datum; Boekstuk; Dagboek; Rekening; Omschrijving; Debet; Credit; Btw-code; Btw-% (točka-zarezi, decimalni zarez). Nakon preuzimanja blagajna javlja postoje li dani koji nisu u ravnoteži ili imaju veću razliku od zaokruživanja.

Pored gumba odabirete format (izbor se pamti u pregledniku). Isti dnevnik, ali oblikovan tako da ga program može izravno učitati. Popis prikazuje samo formate za zemlju objekta (Postavke → Objekt), najprije standarde (CSV, UBL, XAF), zatim programe abecednim redom:

Pregled: koji knjigovodstveni program na koji način

Po segmentu, abecednim redom. NL/BE = u kojoj zemlji program radi: u Postavke → Knjigovodstvo → Knjigovodstveni program vidite samo programe za zemlju objekta (nizozemski programi ne rade u Belgiji i obrnuto). Izravno = blagajna sama knjiži svaki dan (odabir u Postavke → Knjigovodstvo → Knjigovodstveni program); na zahtjev = postoji API, ali najprije zahtijeva partnersku registraciju ili odobrenje dobavljača (javite nam). Datoteka = format u Izvoz za knjigovodstvo. Gdje je moguće oboje, možete koristiti oboje. Popis se nalazi u packages/shared/src/boekhoudcatalogus.ts i prikazuje se i u Postavke → Knjigovodstvo.

Neka knjigovođa provjeri prvi uvoz. Oblikovanje se nalazi u packages/shared/src/journaalexport.ts (s testovima).

Postavke → Knjigovodstvo (pravo Postavljanje lokala, plaćanja i pisača): oznaka dnevnika (zadano MEM) i konto glavne knjige za svaku stavku. Prazno = primjer konta (NL: 8000/8010/8020 promet, 1500/1510 PDV, 1000 blagajna, 1100 kartica; BE: 7000xx promet, 451000 PDV, 570000 blagajna). Neka knjigovođa unese prava konta.

Povezivanje s knjigovodstvenim programom

Izravna povezivanja s Acumulus, AFAS Profit, Microsoft Dynamics 365 Business Central, Exact Online, Horus, Moneybird, Odoo, QuickBooks Online, SAP Business One, Silvasoft, SnelStart, Twinfield, Xero, Yuki i Zoho Books. Nakon svakog dana blagajna knjiži isti zapis kao izvoz iznad (promet i PDV po stopi, načini plaćanja, napojnica, zaokruživanje, ladica i blagajnička razlika) kao temeljnicu u odabrani program, s dnevnikom knjiženja i kontima glavne knjige iz Postavke → Knjigovodstvo. Uvijek je uključen najviše jedan program.

• Popis je podijeljen po segmentima (mala poduzeća i samostalni poduzetnici, međunarodno, veliki sustavi i lanci) i prikazuje samo programe koji rade u zemlji objekta; poslužitelj odbija program iz druge zemlje (400) i ne knjiži s njim (409). Odmah ispod administrator dobiva upravo polja tog programa; povezivanje i popis proknjiženih dana nalaze se ispod konta glavne knjige, a ispod toga pregled svih programa za ovu zemlju. Ako su pri ažuriranju bila uključena dva (u starijoj verziji to je bilo moguće), Exact Online ostaje uključen, a drugi se program isključuje.

• OAuth (Horus, QuickBooks, Twinfield, Xero, Zoho): jednom registrirajte aplikaciju kod programa.
• Za neke programe polja API-ja ne mogu se u potpunosti potvrditi iz javne dokumentacije (među ostalima Horus, Zoho Books, predznak kod Business Central i struktura kod SAP Business One): neka knjigovođa uvijek provjeri prvo knjiženje.
• Exact Online: knjiži zapis kao temeljnicu u odabranu administraciju.
  • Odabir u Postavke → Knjigovodstvo → Knjigovodstveni program → Exact Online (zadano Isključeno). Belgija: blagajna automatski koristi start.exactonline.be.
  • Postavke → Knjigovodstvo → Exact Online: Poveži s Exact Online otvara prijavu u Exact; nakon toga piše s kojom je administracijom blagajna povezana. U Dnevnik knjiženja upiši šifru dnevnika temeljnica u Exactu (npr. 90) i pobrini se da konta glavne knjige postoje u Exactu.
  • Kada: odmah nakon Zaključi dan i dalje svaki sat, za sve protekle dane (do jučer uključivo) od Knjiži od (zadano dan povezivanja; ranije dane knjigovođa već ima). Svaki dan jednom; dani bez prometa se preskaču. Proknjiži sada može uvijek.
  • Greške (konto ne postoji u Exactu, dan nije uravnotežen, nema interneta) prikazane su s razlogom uz taj dan; blagajna pokušava ponovno kasnije, a sljedeći dani čekaju dok ne uspije (tako redoslijed ostaje ispravan). U dnevniku: "exact_geboekt".
  • PDV je na kontima PDV-a u glavnoj knjizi (bez PDV šifre, kao i u izvozu). Neka tvoj knjigovođa provjeri prva knjiženja.
  • Exact: veza radi dok je blagajna koristi (svakih 10 minuta novi token, svaki put novi refresh token). Ako je opozvana ili predugo nije korištena, blagajna traži Ponovno poveži. Odspoji briše tokene; ono što je proknjiženo ostaje.
• AFAS Profit: broj okruženja (npr. 12345; produkcija, test ili prihvaćanje), token app-connectora s UpdateConnector FiEntries i broj administracije (zadano 1). Dnevnik knjiženja = šifra dnevnika temeljnica u AFAS-u (npr. 90).
• Dnevnik knjiženja = broj ili naziv dnevnika temeljnica; ako postoji samo jedan dnevnik temeljnica, blagajna uzima njega. Konta glavne knjige moraju biti brojevi.
• Twinfield: prijava putem OAuth. Bez te aplikacije blagajna se ne može povezati. Blagajna traži klaster i administraciju (prazno = prva); dnevnik knjiženja = kod temeljnice (npr. MEMO). Knjiži konačno (destiny="final").
• Yuki: API ključ administracije (Yuki → Postavke → Web-servisi); prazna administracija = prva za taj ključ. Knjiži temeljnicu (GeneralJournal); Yuki ne koristi šifru dnevnika.
• Kada: odmah nakon Zaključi dan i svakih sat vremena, za sve protekle dane od Knjiži od (zadano dan povezivanja; kod drugog programa ponovno od tog dana). Svaki dan jednom po programu; dani bez prometa se preskaču; kod greške razlog stoji uz taj dan, a sljedeći dani čekaju. Proknjiži sada moguće je uvijek. U dnevniku: "boekhoudpakket_geboekt".
• Ključevi i tokeni nikada se ne prikazuju na zaslonu (ostavi prazno pri ponovnom povezivanju = zadrži). Na kopiji blagajne na portalu ne knjiži se.

Revizijska datoteka blagajne (XAA)

Za nizozemske objekte u Izvješće → Promet po razdoblju pored izvoza za knjigovodstvo nalazi se gumb Revizijska datoteka blagajne (XAA): XML Auditfile Afrekensystemen 3.2 nizozemske Porezne uprave (Belastingdienst) i XML Platform (SRA) za odabrano razdoblje (najviše nešto više od godine dana; pravo Promet po razdoblju). To je datoteka koju Belastingdienst preporučuje za dostavu podataka blagajne pri nadzoru ili knjigovođi; pravila su u Handreiking voor een betrouwbaar afrekensysteem (Smjernice za pouzdan blagajnički sustav, docs/xaa).

U datoteci (auditfile_kassa_<van>_tm_<tot>.xml, shema docs/xaa/XmlAuditfileAfrekensystemen3.2.xsd):

• matični podaci: objekt (naziv, PDV broj, adresa), PDV šifre, svi zaposlenici (s ulogom i datumom izrade; plus SYSTEEM za ono što blagajna radi sama, poput web-trgovine i povezivanja) i svi artikli sa svojom grupom;
• događaji: sve iz dnevnika u razdoblju (prijava i odjava, otvorena ladica blagajne, zaključenje dana, promijenjene postavke i cijene, storno, popust, povrat, kopija računa, dolazak i odlazak ...) i otvaranje blagajničkog dana s početnim novcem, svaki sa šifrom Belastingdiensta (18001 prijava, 18003 ladica, 18006 promjena instalacije, 18008 Z-izvješće, inače 18999);
• blagajničke transakcije: svaki račun (prodaja, povrat i predračun, s brojem računa, zaposlenikom i fiskalnim statusom ako nije u redu) sa svim stavkama (artikl, grupa, količina, cijena, PDV; također popusti, poklon-bonovi, zaglavlja menija i stavke poništene prije naplate, one s iznosom 0), PDV po stopi, zaokruživanje, plaćanja po načinu plaćanja (gotovina, kartica, poklon-bon, online; napojnica zasebno) te ulaz/izlaz novca iz ladice blagajne.

Iznosi su pozitivni s C (prodaja, primitak) ili D (povrat, isplata); vremena su u nizozemskom vremenu s pomakom. Svi ključevi su id-ovi iz baze podataka bez crtica, pa ih se može pronaći u blagajni.

Potpisivanje (poglavlje 6 specifikacije): ako je Optimum POS postavio certifikat, revizijska datoteka dolazi potpisana u omotnici (XML Signature) i datoteka se zove …_ondertekend.xml; inače je to samostalna revizijska datoteka, a blagajna to javlja pri preuzimanju.

Plaćanje na račun

Poslovni kupci (tvrtka koja svaki tjedan naručuje ručak, hotel, udruga) kupuju na račun i plaćaju kasnije. Uključi u Postavke → Računi → Plaćanje na račun (samo kad su Računi uključeni; zadano isključeno).

• Kupci: u Izvješće → Na račun dodaješ poslovne kupce s podacima za račun (naziv, adresa, PDV broj, KvK broj / broj poduzeća, Peppol-ID, e-pošta), po želji limit (koliko najviše smije biti otvoreno) i vlastiti rok plaćanja (inače onaj kod računa) te hoće li se račun odmah poslati.
• Naplata: način plaćanja Na račun, odaberi kupca (s onim što je već otvoreno i limitom). Blagajnički račun je obična prodaja: promet i PDV za taj dan, u Belgiji normalno preko crne kutije, na računu „Na račun”. Blagajna odmah izrađuje račun za kupca (UBL/Peppol i za ispis) s iznosom koji je još otvoren i datumom dospijeća te ga šalje kako je postavljeno kod računa (e-pošta, Peppol preko Billit/Storecove/Banqup ili vlastita adresa). Na račun je jedan iznos za ostatak računa (dio se može prvo platiti drukčije), bez napojnice; poklon-bon se ne može prodati na račun. Iznad limita blagajna odbija.
• Plaćanje: kupac plaća u objektu gotovinom, karticom ili poklon-bonom (Izvješće → Na račun → Plaćanje primljeno; i djelomično). To nije nova prodaja ni novi blagajnički račun: gotovina ide kao novac u ladici (ladica se otvara), sve je na X i Z izvješću pod Primljeno na račun. Kad je sve plaćeno, račun je „plaćeno”. Online plaćanje nije dio ovoga.
• Uplata: ako u Podaci na računu stoji IBAN, on je na računu (i u UBL-u), uz "Plaćanje je moguće i u objektu". Ako je kupac uplatio, evidentiraš to preko Plaćanje primljeno → Uplaćeno (banka): ne u ladicu, ali na X i Z izvješću pod Primljeno na račun. Bez IBAN-a piše "Plaćanje u objektu". U Belgiji je na računu i u UBL-u strukturirani poziv na broj (+++123/4567/89012+++, iz broja računa), tako da ga banka prosljeđuje.
• Banka: knjiženje uplata bez prepisivanja, vidi dolje.
• Kredit (novac unaprijed): u Izvješće → Na račun → Uplati kredit uplaćujete novac unaprijed na račun kupca, gotovinom (ladica se otvara) ili karticom, npr. za niz ručkova. Pri sljedećoj prodaji na račun kredit se najprije oduzima od fakture; ako je na fakturi više, ostatak ostaje otvoren. Kredit se vidi kod kupca (kredit € ...), na X i Z pod Primljeno na račun (Kredit uplaćen, S kreditom kupca) i u knjiženju kao primljeno unaprijed (zadano 1640 / 460000). U Belgiji uplata ide kao ulaz novca (signMoneyInOut) u crnu kutiju (UC4100).
• Zbirna faktura (po kupcu, zadano isključeno): s opcijom Jedna faktura za sve račune kupac kod prodaje na račun još ne dobiva fakturu. Račun ostaje otvoren kod kupca (Računi još nisu fakturirani, ulazi u limit) i već se može platiti. Tipkom Izradi zbirnu fakturu (npr. na kraju mjeseca) svi otvoreni računi idu na jednu fakturu, svaka stavka s brojem računa ispred; ono što je već plaćeno navedeno je kao plaćeno. Povrat na račun pojavljuje se kao negativne stavke. Isključeno = kao i uvijek jedna faktura po prodaji. U Belgiji jedna faktura sa svim računima u crnoj kutiji (signInvoice, UC4121 i UC4122).
• Belgija: ako kupac kasnije plati prodaju na račun (gotovinom, karticom, poklon-bonom ili uplatom), blagajna to prijavljuje kao ispravak plaćanja na računu: s kredita kupca na stvarni način plaćanja (signPaymentCorrection, UC4118).
• Pregled: otvoreni računi s datumom dospijeća (oni koji kasne crveno), po kupcu računi i plaćanja. U Postavke → Računi stupac Otvoreno.
• Knjigovodstvo: u dnevniku prodaja na račun ide na Potraživanja od kupaca (zadano 1300 u Nizozemskoj, 400000 u Belgiji; postavlja se u Postavke → Knjigovodstvo), a plaćanje s blagajne, kartice, poklon-bona ili banke (zadano 1050 / 550000) na potraživanja od kupaca. XAA: način plaćanja „Na račun”.
• Ovlast: Naplata na račun i primanje plaćanja na račun (zadano konobar ne, voditelj da). Sve se bilježi u dnevniku.
• Isključeno: kupci, računi i plaćanja ostaju sačuvani (i u sigurnosnoj kopiji); prekidač ide u izvoz konfiguracije, kupci ne (oni pripadaju jednom objektu).
• U web-trgovini (neobavezno, zadano isključeno): uz I u web-trgovini poslovni kupci naručuju online na račun (preuzimanje i dostava). U Izvješće → Na račun za svakog kupca izradiš kod kupca i daš ga kupcu; blagajna čuva samo šifriranu verziju, pa ga vidiš samo jednom. Novi kod kupca = stari više ne radi; Ukloni kod kupca = taj kupac više ne može naručivati online na račun. Web-trgovina poštuje limit. U prozoru Web-trgovina takvu narudžbu završiš s Završi (na račun): naplata na račun, odmah s računom.

Banka: knjiženje uplata

U Izvješće → Na račun → Banka blagajna za svaki priljev traži pripadajući račun s plaćanjem na račun:

• Učitaj bankovni izvadak: datoteka iz internetskog bankarstva, kao CAMT.053 (XML, sve banke u Nizozemskoj i Belgiji), MT940 (.sta/.940) ili CODA (.cod, Belgija). Samo priljevi; dvostruko učitavanje izvatka ne stvara dvostruke retke.
• Traženje: po broju računa ili strukturiranom pozivu na broj u opisu (sigurno), inače po iznosu (i imenu): tada je to prijedlog. Svaki redak možeš proknjižiti (na predloženi ili drugi račun), zanemariti ili kasnije ipak proknjižiti. Knjiženje = Uplaćeno (banka) na datum banke, nikad više od otvorenog iznosa; ne u ladicu.
• Veza s bankom (PSD2, neobavezno): u Postavke → Računi → Veza s bankom blagajna svaki sat sama dohvaća priljeve preko Enable Banking (banke u Nizozemskoj, Belgiji i ostatku Europe). Odaberi banku i prijavi se u banku (poslovni račun); suglasnost vrijedi 180 dana, zatim ponovno poveži. Odspajanje povlači suglasnost; priljevi ostaju. Bez ugovora s Enable Bankingom ovo radi samo za tvoje vlastite račune (restricted production).
• Automatsko knjiženje (zadano isključeno): priljev koji sigurno pripada računu blagajna odmah proknjiži (i pri učitavanju).
• Pravo: knjiženje s Naplata na račun i primanje plaćanja na račun; postavljanje veze s bankom s Postavljanje objekta, plaćanja i pisača. Učitavanje, povezivanje, dohvaćanje i knjiženje bilježe se u dnevniku.
• Isključeno: kad je plaćanje na račun isključeno, blagajna ništa ne dohvaća; priljevi i veza ostaju sačuvani (i u sigurnosnoj kopiji).

Slike kamera na blagajni

Sve slike kamera objekta na jednoj stranici, bez zasebnog zaslona ili aplikacije. Uključi u Postavke → Objekt → Zasloni i rukovanje → Slike kamera na blagajni (zadano isključeno). Tada se gumb Kamere pojavljuje u gornjoj traci za one s ovlašću Gledanje slika kamera (zadano voditelj i administrator; u Postavke → Ovlasti može se uključiti i za konobare). Sve kamere su jedna pokraj druge; dodirni kameru za veliku sliku. Pri isključivanju sustavi kamera ostaju spremljeni.

I kao zaseban zaslon: Na zasebnom zaslonu otvara http://<kassaserver>:3000/camera (npr. monitor iza šanka), a Na tabletu ili mobitelu prikazuje QR kod: djelatnik ga skenira vlastitim tabletom ili mobitelom i prijavljuje se vlastitim PIN-om (i ondje samo s pravom Gledanje slika kamera). Na uskom zaslonu kamere su jedna ispod druge. Vidi Drugi zaslon na tabletu ili mobitelu.

Administrator dodaje sustave kamera s + Sustav kamera, testira ih s Testiraj i za svaku kameru bira naziv i je li na stranici:

• Hikvision, Dahua, Axis i Reolink: kamera ili snimač (NVR) u mreži: IP adresa (po potrebi s :poort), korisnik (po mogućnosti samo za gledanje) i kanali, npr. 1-8 ili 1,3,5. Prijava s Basic ili Digest; https s vlastitim certifikatom je dopušten.
• Synology Surveillance Station: adresa NAS-a (zadani port 5000, s https 5001) i korisnik; Dohvati kamere dohvaća kamere s njihovim nazivima.
• UniFi Protect: adresa konzole (https) i lokalni račun; Dohvati kamere.
• ONVIF: svaka kamera ili snimač s ONVIF-om (npr. Hanwha, Bosch, Uniview, Annke); Dohvati kamere za svaki video izvor pronalazi adresu fotografije.
• Vlastita web adresa: fotografija (JPEG), MJPEG stream ili rtsp:// adresa.
• Web stranica sustava kamera (npr. Frigate, Blue Iris ili go2rtc): otvara se u blagajni na gumb Kamere (ili u zasebnom prozoru).

Bez ffmpega: fotografija.

Privatnost: blagajna dohvaća slike sa sustava kamera i samo ih prosljeđuje; ništa se ne sprema (bez snimki, bez predmemorije). Korisnici i lozinke ostaju na poslužitelju i nikad se ne prikazuju na zaslonu ni u dnevniku. U dnevniku piše tko je gledao kamere. Same slike stranica traži s ključem (vrijedi 12 sati, dok je djelatnik prijavljen), jer slika u pregledniku ne može poslati token. Izvoz konfiguracije uključuje samo uključeno/isključeno.

Dnevnik osjetljivih radnji

Izvještaj → Dnevnik (voditelj ili administrator) pokazuje tko je što napravio i kada.

• Odaberite razdoblje (danas, jučer, ovaj tjedan, ovaj/prošli mjesec ili sami od-do), što želite vidjeti (zadano Osjetljive radnje ili npr. samo storna i popuste ili Sve) i po želji jednog djelatnika.
• Na vrhu po djelatniku: broj i iznos storna (brisano nakon narudžbe), popusta i povrata te koliko je puta ladica otvorena bez prodaje, novac iz ladice, kopije računa, predračuni i ručno plaćanje karticom. Dodirnite ime da biste vidjeli samo tog djelatnika. Također broj unosa pogrešnog PIN-a.
• Ispod toga svaka radnja s vremenom, tko, što i čitljivim opisom (npr. "2x Cola brisano nakon narudžbe € 5,60 · stol 4 · razlog: gost se predomislio").
• Preuzmi (CSV) za Excel.

Što se bilježi: storna, popusti (i njihovo uklanjanje), povrati, kopije računa, predračuni, ručna plaćanja karticom, otvaranje ladice, uplate/isplate iz ladice, početni polog, dnevno zaključenje, premještanje stavki ili stolova, zatvaranje praznih narudžbi, promjena cijene/naziva/PDV-a proizvoda, novi ili obrisani proizvodi, promjene osoblja i postavki, izmjena radnog vremena, prijava i odjava, pogrešni PIN-ovi te evidencija dolaska i odlaska. Uz plaćanje na račun još: kupci, prodaje i uplate na račun, učitavanje bankovnih izvoda, veza s bankom i preuzimanje iz banke. Uz obavijest o predugom vremenu pripreme: zakašnjele narudžbe i poslane isprike. Uz Mailchimp ili Klaviyo: povezivanje, odabir popisa, odspajanje i odjave odande. Uz upravljanje glazbom: uključivanje/isključivanje te dodavanje, uređivanje i uklanjanje izvora glazbe. Uz slike kamera: tko je gledao kamere (najviše jednom u pola sata po djelatniku), uključivanje/isključivanje i sustavi kamera. Uz signalizaciju: svaki signal, njegovo rješavanje te uključivanje i isključivanje.

Signalizacija: prijevare i odstupanja

Postavke → Signalizacija. Dva dijela, svaki se zasebno uključuje i zadano je isključen; isključivanje čuva sve signale i postavke. Postavljati smije onaj tko ima pravo Postavljanje signalizacije (zadano voditelj i administrator); signale vidi i rješava onaj tko smije vidjeti dnevnik. Blagajna provjerava svakih 5 minuta (i s Provjeri sada); ne na rezervnoj (shadow) blagajni.

Otkrivanje prijevara i krađa (po djelatniku, po radnom danu od 05:00), svako pravilo zasebno uključeno s vlastitom granicom:

• storna nakon predračuna: brisano nakon što je gost već vidio račun;
• storna, popusti i povrati: od određenog broja puta ili ukupno od određenog iznosa (0 = ne po iznosu);
• ladica otvorena bez prodaje (gumb Otvori ladicu);
• račun dugo otvoren: naručeno, ali nakon određenog broja minuta još nije plaćeno.

Obavijesti o odstupanjima, u usporedbi s istim danom u tjednu i istim vremenom u proteklim tjednima (zadano 4; dani bez prometa se ne broje, barem dva dana za usporedbu):

• promet do sada niži (i/ili viši) od uobičajenog za više od marže, tek od uobičajenog prometa od zadanog iznosa;
• vrijeme kuhinje (od slanja računa u kuhinju do gotovo na kuhinjskom zaslonu) u zadnjem satu iznad marže ili iznad fiksnog broja minuta;
• storna danas iznad marže, tek od minimalnog broja.

Svaki signal dolazi jednom (po pravilu, djelatniku i danu; vrijeme kuhinje najviše jednom na sat) i ide na:

• blagajnu: gumb Signali (n) u gornjoj traci sa signalima iz zadnjeg dana, tjedna ili 30 dana; Riješeno s bilješkom. Ostali zasloni dobivaju samo upozorenje bez imena;
• push obavijest putem ntfy (besplatna aplikacija; ntfy.sh ili vlastiti poslužitelj, topic i po potrebi token), Pushover (API-token aplikacije i user key) ili Telegram (token bota i chat-id);

Za svaki kanal postoji gumb Testna poruka. Tokeni i ključevi ostaju na blagajni (zasloni vide samo jesu li upisani). Signal nije dokaz: pogledaj račun i dnevnik i razgovaraj s djelatnikom.

Računi: kopija i povrat (storno račun)

Gumb Računi u gornjoj traci:

• Popis računa od zadnjeg dnevnog zaključenja ili zadnjih 7 dana; stariji račun tražite po njegovom broju.
• Ispiši kopiju: isti račun s oznakom "KOPIJA" (u Belgiji s FDM blokom izvornog računa). Bilježi se u dnevnik.
• Povrat / storno račun (voditelj ili administrator): za svaku stavku odaberite koliko se vraća, razlog i kako se novac vraća (gotovina, kartica, poklon-bon, ostalo). Stari račun ostaje netaknut: dodaje se novi storno račun s vlastitim brojem u žurnalu (vrsta računa retour, negativni iznosi, u Belgiji kao NR prema FDM-u). Nikad se ne može vratiti više nego što je prodano. U X- i Z-izvještaju povrat se računa kao negativni promet.
• Kod CCV-a ili drugog terminala: najprije izvršite povrat na samom terminalu, a zatim označite "Već vraćeno na terminalu".
• Gotovina sa zaokruživanjem na 5 centi: iznos za povrat također se zaokružuje.
• Natrag na račun kupca (prodaja na račun): ako je račun bio na račun poslovnog kupca, odaberite Na račun. Iznos se oduzima od otvorene fakture i blagajna odmah izrađuje odobrenje (u UBL-u CreditNote, tip 381, s pozivom na fakturu; u Belgiji potpisano sa signInvoice, UC4122). Više nego što je otvoreno na fakturi ne može se vratiti na račun kupca; ostatak vratite gotovinom ili karticom. Odobrenje je u Računi i šaljete ga kao fakturu.

Ladica blagajne sa senzorom i ladicom po djelatniku

Zadano isključeno. Postavlja se u Postavke → Plaćanje → Ladica blagajne.

• Senzor: mnoge ladice putem pisača računa javljaju jesu li otvorene ili zatvorene (ESC/POS DLE EOT 1, DK priključak pin 3). To je moguće samo s mrežnim pisačem računa. Dodirni Izmjeri: ladica zatvorena i Izmjeri: ladica otvorena; ako postoji razlika, preuzimaš ispravnu postavku (visoko = otvoreno ili nisko = otvoreno). Nema razlike = ova ladica (ili kabel) nema senzor. Nema odgovora pisača = nepoznato, nikada "zatvoreno".
  • Ne naplaćuj dok je ladica otvorena: poslužitelj blagajne tada odbija novu naplatu porukom "Ladica blagajne još je otvorena".
• Vlastita ladica po djelatniku: pisač računa može otvoriti dvije ladice (ladica 1 i ladica 2). Odaberi ladicu za svakog djelatnika; blagajna tada pri naplati gotovinom, uplati/isplati novca u ladicu i Otvori ladicu otvara ladicu prijavljenog djelatnika. U Izvješće → Blagajna tada je Ladica po djelatniku: početni polog po djelatniku, gotovina (bez automata za gotovinu), očekivano, Prebroji i razlika po osobi (u dnevniku kao ladetelling). Uobičajeno zaključenje dana ostaje kakvo jest.
• Testiraj ladicu 1 i Testiraj ladicu 2 otvaraju ladicu radi provjere.
• Otvori ladicu bez prodaje (s razlogom) uvijek se već bilježi u dnevnik i u revizijsku datoteku blagajne (XAA), kako zahtijeva Porezna uprava (Belastingdienst) (iznimke poput "no sale").

Dio 3 · Administrator

Prvi koraci

Instalacija. HorecaPOS instalirate instalacijskim programom za svoj sustav, koji ćete naći na stranici za preuzimanje OptimumPOS: Android (aplikacija), Windows (instalacijski program), macOS (instalacijski program za Mac računala s Apple Silicon i Intel procesorima), Linux (grafički instalacijski program ili paket .deb ili .rpm), Raspberry Pi (grafički instalacijski program ili .deb za Raspberry Pi 3, 4 ili 5 s 64-bitnim Raspberry Pi OS-om) i Chromebook (Android aplikacija s Google Playa). Odaberite za sve korisnike za poslužitelj blagajne na koji se spajaju tableti i kuhinjski zaslon ili samo za mene za samo blagajnu na tom uređaju. Instalacijski program postavlja sve što je potrebno, uključujući bazu podataka, i svake noći izrađuje sigurnosnu kopiju. Ažurirate tako da instalirate novu verziju: vaši podaci ostaju sačuvani. Instalacijski program pokreće se na jeziku vašeg računala (inače na engleskom); kod Windowsa i Linuxa na prvom zaslonu po želji birate drugi jezik. Blagajna se zatim odmah pokreće na tom jeziku. Paketi .deb i .rpm te Android aplikacija slijede jezik sustava, a inače nizozemski.

Administrator postavlja blagajnu putem Postavke. Tamo se nalaze kartice kao što su Lokal, Osoblje, Prava, Radno vrijeme, Proizvodi, Happy hour, Zalihe, Tlocrti, Plaćanje, Pisači, Knjigovodstvo, Sigurnosne kopije, Uvoz/izvoz i Baza podataka. Koje kartice vidi i voditelj, ovisi o pravima.

Baza podataka. U Postavke → Baza podataka (samo administrator) biraš između MySQL / MariaDB, ugrađene baze podataka i PostgreSQL-a; pri prebacivanju prenose se svi podaci (vidi Baza podataka). Ako je Optimum POS pri instalaciji već postavio fiksnu adresu, vrijedi ta adresa i nema polja za unos. Inače sam ispunjavaš Poslužitelj, Priključak, Baza podataka, Korisnik i Lozinka. Blagajna ih sama sprema, zatim ih ponovno prikazuje ispunjene i uvijek ih možeš promijeniti s Promijeni podatke za MySQL/MariaDB ili Promijeni podatke za PostgreSQL. Ostaviti lozinku praznom znači: zadržati spremljenu lozinku (za istog korisnika). Instalacijski program i ažuriranje ne mijenjaju ništa na DATABASE_URL ni na odabranoj bazi podataka.

Knjigovodstvo

Sve za knjigovodstvo nalazi se u Postavke → Knjigovodstvo. Zajedno sa svojim knjigovođom upišite dnevnik knjiženja i konta glavne knjige. Želite li da blagajna sama knjiži dnevni promet svaki dan, odaberite svoj program na vrhu u Knjigovodstveni program, uključujući Exact Online: vidite samo programe koji rade u zemlji vašeg objekta. Odmah ispod upisujete podatke tog programa i povezujete se. Kod programa u koje se prijavljujete (kao što su Exact Online, Twinfield ili Xero) najprije upišite aplikaciju: ID klijenta i tajnu klijenta. Ako je Optimum POS pri instalaciji fiksno postavio program ili neki podatak, taj izbor ili to polje nećete vidjeti. Ondje je i pregled svih programa: koji se mogu izravno povezati, a koji dobivaju datoteku. Datoteku izrađujete u Izvješće → Promet po razdoblju → Izvoz za knjigovodstvo: odaberite format svog programa, ili UBL (Peppol), XAF ili dnevno izvješće. Neka knjigovođa uvijek provjeri prvo knjiženje ili uvoz.

Za nizozemski objekt tamo je i Revizijska datoteka blagajne (XAA): XML Auditfile Afrekensystemen nizozemske Porezne uprave (Belastingdienst) sa svim računima, stavkama, plaćanjima i događajima blagajne za odabrano razdoblje. Nju daješ svom knjigovođi ili pri nadzoru Belastingdienstu.

Plaće i planiranje

Ako tvoje osoblje evidentira dolazak i odlazak, pod Postavke → Radno vrijeme na dnu je Plaće i planiranje, u dva bloka. Pod Obračun plaća biraš svoj program za plaće ili (u Belgiji) svoj socijalni sekretarijat i za svakog zaposlenika upisuješ njegov broj zaposlenika u tom programu. Zatim za neko razdoblje izrađuješ datoteku s odrađenim satima i prometom po zaposleniku te je učitavaš u svoj program za plaće. Pod Planiranje osoblja biraš svoj sustav za planiranje: kod Deputyja, Dyflexisa i Shiftbasea promet ide automatski svaki sat, kod ostalih izrađuješ datoteku prometa. Tako u svom planiranju vidiš troškove plaća uz promet. Radiš li bez evidencije dolaska i odlaska, promet ipak možeš slati u svoje planiranje: to je tada na dnu Postavke → Knjigovodstvo, pod Promet u tvoje planiranje. Ako je Optimum POS nešto fiksno postavio pri instalaciji, taj izbor ili to polje ne vidiš.

Sigurnosne kopije

Blagajna svake noći automatski radi sigurnosnu kopiju, i uvijek prije ažuriranja. Pod Postavke → Sigurnosne kopije vidiš sve sigurnosne kopije (kada, tko ili automatski, veličina) i gumbom Napravi sigurnosnu kopiju možeš sam napraviti novu. Ako je zadnja sigurnosna kopija starija od dva dana, pojavljuje se crveno upozorenje: tada se obrati Optimum POS-u.

Vraćanje se radi gumbom Vrati pokraj sigurnosne kopije. Sve što se dogodilo nakon te kopije tada se gubi. To moraš označiti i ponovno unijeti svoj PIN. Blagajna najprije napravi zaštitnu kopiju trenutačnog stanja, a zatim sve odjavi. U Belgiji to nije moguće s blagajne (brojači crne kutije nastavljaju teći); ondje to radi Optimum POS.

Baza podataka

U Postavke → Baza podataka (samo administrator) vidiš gdje blagajna čuva svoje podatke. Gore je trenutačna baza podataka s programom, verzijom, tablicama, redcima i adresom ili mapom. Za osoblje i tablete blagajna radi jednako sa svakom bazom. Na Windowsu, macOS-u, Linuxu i Raspberry Piju biraš između tri baze podataka:

• MySQL / MariaDB: zaseban program za baze podataka (MySQL 8.0 ili noviji, MariaDB 10.6 ili noviji), na primjer na poslužitelju ili NAS-u koji već imaš. Svi podaci tada su u običnim tablicama u MySQL-u ili MariaDB-u, čitljivi tvom vlastitom programu za izvještaje ili BI. Blagajna računa točno kao s PostgreSQL-om.
• Ugrađena (PGlite): dio je same blagajne, ne trebaš ništa instalirati. Najbolji izbor za većinu objekata i baza podataka na Androidu i Chromebooku.
• PostgreSQL: zaseban program za baze podataka na računalu blagajne ili negdje u mreži.

Kada MySQL ili MariaDB? Ako tvoj objekt već ima MySQL ili MariaDB poslužitelj, ako tvoj IT administrator radi s njim ili ako podatke želiš čitati u vlastitim izvještajima, Excelu ili BI programu. Ako nisi siguran, odaberi ugrađenu: radi odmah.

Što treba za MySQL ili MariaDB?

• MySQL 8.0 ili noviji, ili MariaDB 10.6 ili noviji, dostupan s poslužitelja blagajne.
• Vlastita baza podataka za blagajnu (ili za blagajne jednog lanca), sa skupom znakova utf8mb4.
• Korisnik baze podataka koji u toj bazi smije stvarati, mijenjati, preimenovati i brisati tablice (CREATE, ALTER, DROP, INDEX, SELECT, INSERT, UPDATE, DELETE), na primjer ovako:

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

Ako MySQL ili MariaDB radi na drugom računalu, u zadnja dva retka upiši IP adresu poslužitelja blagajne umjesto localhost.

Prebacivanje na MySQL / MariaDB:

1. Pod Adresa MySQL-a/MariaDB-a ispuni polja: Poslužitelj (zadano localhost), Priključak (zadano 3306), Baza podataka (zadano horecapos), Korisnik i Lozinka; za MariaDB isto. Ako je adresa već postavljena, polja su već ispunjena; ostaviš li lozinku praznom, ostaje spremljena lozinka (za istog korisnika). Blagajna sama sprema adresu; ako je Optimum POS već postavio fiksnu adresu, vrijedi ta adresa i polja nema. Ako blagajna već radi na MySQL/MariaDB, podatke kasnije mijenjaš s Promijeni podatke za MySQL/MariaDB. Šifriranu vezu postavit će ti Optimum POS.
2. Dodirni Testiraj vezu: vidiš program i verziju ili zašto ne uspijeva.
3. Dodirni Prebaci na MySQL/MariaDB, označi da razumiješ i unesi svoj PIN.

Prebacivanje radi u svim smjerovima između tri baze podataka, i svi podaci idu sa sobom:

1. Blagajna kratko ne prima zahtjeve (obično manje od minute); tableti zatim sami nastavljaju.
2. Najprije blagajna napravi sigurnosnu kopiju trenutačnog stanja (u Postavke → Sigurnosne kopije).
3. Sve ide u novu bazu, a blagajna po tablicama broji je li sve točno ondje.
4. Tek kad se sve slaže, blagajna nastavlja na novoj bazi. Prijavljeni djelatnici ostaju prijavljeni.

Ako nešto ne uspije, ništa se ne mijenja i blagajna radi dalje na staroj bazi. Stara baza ostaje, pa se uvijek možeš vratiti. Podaci blagajne koji su već bili u novoj MySQL/MariaDB ili PostgreSQL bazi bit će zamijenjeni. I u Belgiji to ide: brojači crne kutije prenose se točno.

Sigurnosne kopije i vraćanje rade jednako sa sve tri baze (Postavke → Sigurnosne kopije). Kopiju jedne baze možeš vratiti u bilo koju drugu, i kopiju iz PostgreSQL-a u MySQL ili MariaDB.

Što je u MySQL-u ili MariaDB-u? Svaka tablica blagajne, s istim nazivom i stupcima (vremena u UTC-u). Svaka tablica dobiva dodatni ključni stupac _hp_sleutel, a u pomoćnim tablicama _horecapos_stand, _horecapos_kolom, _horecapos_reeks i _horecapos_wijziging (zapisnik promjena, čuva se 14 dana) blagajna vodi stanje, vrste stupaca, brojače i promjene. Drugi programi čitaju podatke; pišu samo blagajne.

Kako radi: blagajna računa u brzoj radnoj kopiji na poslužitelju blagajne i svaku promjenu u istom koraku zapisuje u MySQL/MariaDB. Ako to ne uspije, promjena se ne provodi i blagajna javlja pogrešku; zato neka MySQL/MariaDB bude dostupan. Pri pokretanju blagajna sve učitava iz MySQL-a/MariaDB-a.

Više blagajni na jednoj bazi. Kao i kod PostgreSQL-a, više blagajni može koristiti istu MySQL/MariaDB bazu, na primjer svaki objekt lanca s vlastitim poslužiteljem blagajne. Promjene idu jedna za drugom i svaka blagajna najprije preuzme ono što su napravile druge, pa se pri istodobnim promjenama ništa ne gubi. Ako blagajna vrati sigurnosnu kopiju ili blagajna s novijom verzijom ažurira bazu, ostale blagajne same ponovno učitaju sve; zato ažuriraj sve blagajne istodobno. Blagajna koja je bila isključena dulje od 14 dana pri pokretanju sve ponovno učitava.

Pri instalaciji biraš i bazu podataka: MySQL / MariaDB, ugrađenu (preporučeno) ili PostgreSQL s adresom. Ako nije dostupna, blagajna se instalira s ugrađenom bazom; prebaciti možeš poslije ovdje. Pri ažuriranju izbor ostaje.

Povezivanje tableta i zaslona

• Na svakom tabletu/blagajni otvori adresu poslužitelja blagajne, npr. http://192.168.1.20:3000, i dodaj je kao prečac na početni zaslon (Chrome: Dodaj na početni zaslon).
• Kuhinjski zaslon: http://192.168.1.20:3000/keuken.
• Zaslon za kupce (okrenut prema kupcu, neobavezno): http://192.168.1.20:3000/klantscherm, vidi Zaslon za kupce.
• Zasloni sami pronalaze poslužitelj blagajne (ista adresa, priključak 4000).

Zaslon za kupca

Zaslon na blagajni koji je okrenut prema kupcu. Kupac otprilike vidi što je naručeno, a vrlo jasno iznos i način plaćanja. Na njemu nema upravljanja: zaslon samo prati što radi blagajna. Zadano isključen; uključuje se pod Postavke → Objekt → Zaslon za kupce. Na blagajničkom računalu s dva zaslona blagajna ga prvi put sama uključi; ako ga nakon toga isključite, ostaje isključen. Bez zaslona za kupce (isključen ili ga nema) sve radi točno kao i uvijek: blagajna šalje prikaz u pozadini, a osoblje nikad ne primijeti grešku ili zaslon koji nedostaje.

Što kupac vidi:

• Mirovanje (nitko ne plaća): naziv objekta i vlastiti tekst dobrodošlice (Postavke → Objekt; prazno = "Dobro došli").
• Naručivanje: proizvodi s količinom i iznosom (iste stavke zajedno, meni kao jedna stavka s dijelovima sitno ispod, popust kao jedna stavka) i krupno ukupni iznos. Ono što je već plaćeno kod podijeljene naplate prikazano je ispod. Uz Postavke → Objekt → Fotografije proizvoda → na zaslonu za kupce uz svaki proizvod stoji mala fotografija.
• Naplata: način plaćanja (Kartica, Gotovina, Poklon-bon), napojnica i krupno Za platiti. Gotovina: koliko kupac daje i koliko dobiva natrag, čim je to uneseno na blagajni. Kartica: "Slijedite upute na terminalu".
• Hvala: nakon naplate nekoliko sekundi "Hvala!" s plaćenim iznosom (gotovina: koliko kupac dobiva natrag), zatim ponovno zaslon mirovanja.

Spajanje, na dva načina (oba se postavljaju na samom uređaju):

• Drugi monitor na blagajničkom računalu (Windows, Linux/Raspberry Pi, macOS): automatski. Pri prijavi i nakon instalacije blagajna otvara zaslon za kupca preko cijelog zaslona na najmanjem zaslonu koji nije glavni (kod iste veličine na onom najdesnijem); u sustavu Windows uvijek na drugom zaslonu, a ne na zaslonu blagajne (blagajna je na zaslonu osjetljivom na dodir i pri pokretanju se također sama otvara). Veličinu i položaj određuje sustav, pa radi svaki format. Bez drugog zaslona ništa se ne događa. U sustavu Windows zatvoreni zaslon za kupca sam se vraća; u Linuxu i macOS-u prečac HorecaPOS zaslon za kupca u izborniku ponovno ga ispravno postavlja. U sustavu Windows otvara se u kiosk načinu preglednika Chrome (ili Edge): preko cijelog zaslona, bez naslovne trake i bez programske trake (zatvaranje s Alt+F4). Prati blagajnu na istom računalu bez koda za povezivanje.
  • U svakom pregledniku dugo pritiskanje nigdje ne otvara izbornik preglednika i ne pojavljuje se upit za prijevod stranice.
  • Blagajna zatvorena = zaslon za kupca zatvoren. Ako se softver blagajne zaustavi (Ponovno pokreni, ažuriranje, blagajna zaustavljena ili uklonjena), zaslon za kupca također se zatvara nakon nešto više od 10 sekundi; kada blagajna ponovno radi, vraća se sam. U sustavu Windows zatvara se i ako zatvorite samo prozor blagajne. Pod Waylandom (Linux) blagajna ne može sama zatvoriti prozor.
  • Zaslon za kupca slučajno zatvoren? U sustavu Windows vraća se sam nakon nekoliko sekundi, dok god je blagajna otvorena i drugi zaslon priključen.
  • Uvijek samo jedan zaslon za kupca. U sustavu Windows zaslon za kupca nalazi se samo u kiosk načinu na drugom zaslonu. Zaslon za kupca u prozoru blagajne (npr. koji je Edge vratio nakon nestanka struje ili otvoren gumbom u blagajni) sam se zatvara u roku od nekoliko sekundi; na njegovo mjesto tada dolazi ispravan zaslon za kupca.
  • Nitko nije prijavljen = samo dobrodošlica. Ako je blagajna na zaslonu za PIN (i nakon ponovnog pokretanja ili odjave), zaslon za kupca prikazuje samo tekst dobrodošlice, nikada prethodni račun.
  • U Windowsima se automatsko otvaranje može isključiti i kvačicom Zaslon za kupca automatski ... u instalacijskom programu.
  • Na Linuxu blagajna pomiče prozor pomoću wmctrl (dolazi s paketom). Pod Waylandom (npr. Raspberry Pi OS s labwc) to nije moguće: tada jednom sami premjestite zaslon za kupca na drugi zaslon (preglednik to pamti) ili odaberite X11 u raspi-config. Na macOS-u Mac prvi put traži dopuštenje u Pristupačnost.
  • Ručno: Postavke → Objekt → Zaslon za kupca → Otvori zaslon za kupca (drugi monitor). U Chromeu i Edgeu (i na Chromebooku) gumb odmah postavlja prozor na zaslon za kupca (prvi put preglednik traži dopuštenje); jedan klik na zaslon za kupca prikazuje ga preko cijelog zaslona. U drugim preglednicima: povucite prozor i pritisnite F11.
• Android blagajna s ugrađenim zaslonom za kupca (npr. Sunmi D2/T2) ili monitor preko HDMI/USB-C: također automatski. Čim je aplikacija na blagajni, zaslon za kupca pojavljuje se na drugom zaslonu; ukopčavanje i iskopčavanje rade odmah.
• Sunmi T1 mini / T2 mini s malim tekstualnim zaslonom (2 retka): aplikacija ondje automatski prikazuje iznos: Ukupno, Za platiti, kod gotovine Ostatak, nakon naplate Hvala!, a u mirovanju naziv objekta. Zaslon za kupca mora biti uključen.
• iPad (radni zaslon) s vanjskim zaslonom preko HDMI/USB-C ili AirPlay: aplikacija automatski postavlja zaslon za kupca na taj zaslon (pripremljeno; iOS aplikacija još nije objavljena).
• Chromebook: kao radni zaslon u Chromeu gumb Otvori zaslon za kupca (drugi monitor) radi kao što je gore opisano. U Android aplikaciji zaslon za kupca automatski se pojavljuje na drugom zaslonu čim ChromeOS taj zaslon proslijedi Android aplikacijama; ako to ne učini, koristite zaseban uređaj s kodom za povezivanje.
• Zaseban uređaj (tablet ili vlastito računalo pokraj blagajne): otvori http://<kassaserver>:3000/klantscherm. Zaslon dolje desno prikazuje kôd za uparivanje od 6 znakova. Unesi ga na blagajni pod Postavke → Objekt → Zaslon za kupce → Upari. Odspoji vraća zaslon na kôd za uparivanje. Uparivanje se sprema po blagajni (u pregledniku te blagajne), pa svaka blagajna može imati svoj zaslon za kupce.

Zaslon za kupce ne traži PIN (nema čime upravljati) i prikazuje samo prikaz blagajne s kojom je uparen. Prikaz se čuva samo u memoriji poslužitelja blagajne; nakon ponovnog pokretanja zaslon je prazan do sljedeće promjene. Postavka (uključeno/isključeno i tekst dobrodošlice) uključena je u sigurnosnu kopiju i u Uvoz/izvoz (Ostale postavke).

Digitalni račun putem QR koda (neobavezno)

Zadano isključeno. Uključuje se putem Postavke → Objekt → Kuhinja i zaslon za kupca → Digitalni račun (opcija se pojavljuje kad je zaslon za kupca uključen i spremljen). Nakon naplate uz Hvala stoji QR kod; on tada ostaje prikazan 45 sekundi umjesto nekoliko sekundi. Gost ga skenira vlastitim mobitelom i vidi račun, točno kao papirnati račun (isti tekst, kod belgijske blagajne i s FDM blokom). Na mobitelu račun može ispisati, spremiti kao PDF ili preuzeti kao tekstualnu datoteku.

• Ide preko upravljačkog portala: https://kassa.<portaal>/__bon/<kassa>/<sleutel>. Blagajna dakle mora biti povezana s portalom; inače se QR kod ne pojavljuje i ništa se ne mijenja.
• Ključ je nasumičan i ne može se pogoditi, a vrijedi 30 dana. Nakon toga ga blagajna sama briše. Portal ništa ne pohranjuje.
• Radi s drugim monitorom i sa zasebnim zaslonom za kupca. Papirnati račun i račun e-poštom i dalje normalno rade.

Zaslon za kupca u mirovanju: dijaprojekcija (neobavezno)

Zadano isključeno. Uključuje se putem Postavke → Objekt → Kuhinja i zaslon za kupca → Zaslon za kupca u mirovanju. Ako na zaslonu za kupca nema računa, slajdovi se izmjenjuju (zadano svakih 8 sekundi, podesivo od 4 do 60):

• Akcije: happy hourovi (ako je happy hour uključen), s popustom, danima i vremenima te proizvodima ili grupama; trenutačni su prvi, s "Sada!".
• Istaknuti proizvodi (najviše 12, npr. novo na jelovniku), s cijenom i (ako su fotografije proizvoda na zaslonu za kupca uključene) fotografijom. Rasprodani proizvod zaslon preskače.
• Program vjernosti: bodovi po euru, nagrada i kartice s pečatima (samo ako je kartica vjernosti uključena).
• Vlastiti tekstovi: najviše 5, svaki na svom slajdu (npr. "Od petka novo: naš ljetni jelovnik").

Bez slajdova zaslon za kupca prikazuje zaslon dobrodošlice, kao i uvijek.

Happy hour

Zadano isključeno. Uključuje se pod Postavke → Objekt → Koristi happy hour; nakon toga se pojavljuje kartica Postavke → Happy hour.

• Po happy houru: naziv (ispisuje se na računu), dani, od–do (smije prijeći ponoć, npr. 23:00–01:00), popust u % ili fiksna cijena, te za koje kategorije i/ili pojedinačne proizvode.
• U tom razdoblju blagajna pri unosu automatski obračunava happy hour cijenu (nikad skuplje nego inače; kod fiksne cijene opcije se dodaju normalno). Na gumbu proizvoda stara cijena je prekrižena, uz novu cijenu i HH; u narudžbi i na računu stoji naziv happy houra. Ono što je već uneseno zadržava svoju cijenu.
• Ponuda dana: označi Cijeli dan (00:00–24:00) i odaberi dan (dane), npr. svakog utorka rebarca po fiksnoj cijeni.
• Sezona: označi Samo u sezoni (svake godine) i odaberi od i do (dan i mjesec, npr. od 1. lipnja do 31. kolovoza; može i preko Nove godine, npr. od 1. prosinca do 28. veljače). Izvan sezone happy hour ne vrijedi.
• Promjene se bilježe u dnevniku.

Razdoblja menija i sezone

Zadano isključeno. Uključuje se pod Postavke → Objekt → Razdoblja menija i način narudžbe → Ponuda po razdobljima menija i sezonama; nakon toga se pojavljuje kartica Postavke → Razdoblja menija. Ako to isključiš, svi su proizvodi ponovno uvijek u prodaji, a razdoblja menija ostaju spremljena.

• Za svako razdoblje menija: naziv (npr. Doručak, Ručak, Večera, Ljetni meni), dani, od–do (može i preko ponoći; Cijeli dan = 00:00–24:00), po želji sezona (svake godine, dan i mjesec) te koje kategorije i/ili pojedinačni proizvodi pripadaju razdoblju.
• Proizvodi i kategorije koji su u jednom ili više razdoblja menija mogu se kupiti samo dok traje jedno od tih razdoblja; ono što nije ni u jednom razdoblju uvijek je u prodaji. Zaslon za narudžbe prikazuje samo ono što je trenutno u prodaji i sam se mijenja kad razdoblje počne ili završi; poslužitelj odbija ostalo ("trenutno nije u prodaji, samo uz Doručak").
• Web-trgovina prikazuje i naplaćuje istu ponudu (u trenutku narudžbe).
• Druga cijena određenog dana ili u sezoni je happy hour (ponuda dana, vidi gore).
• Meni po lokaciji: svaka blagajna (poslovnica) ima svoje proizvode, razdoblja menija i cijene.
• Promjene se bilježe u dnevniku.

Ponuda i cijene po načinu narudžbe

Zadano isključeno. Uključuje se pod Postavke → Objekt → Razdoblja menija i način narudžbe → Ponuda i cijene po načinu narudžbe. Ako to isključiš, svugdje ponovno vrijedi redovna cijena i sve je svugdje u prodaji; upisane cijene ostaju spremljene.

• Pod Postavke → Proizvodi za svaki proizvod: Cijena za van i Cijena za dostavu (prazno = redovna cijena) te Prodaje se za (u lokalu, za van, dostava; barem jedno). Kategorija također ima Prodaje se za, za sve proizvode u toj kategoriji.
• Kod narudžbe za van ili dostave zaslon za narudžbe prikazuje cijenu za taj način narudžbe i samo ono što se ondje prodaje; poslužitelj naplaćuje tu cijenu i odbija ostalo. Happy hour, meniji i opcije računaju se s tom cijenom.
• Stopa PDV-a za van (kod proizvoda) neovisna je o tome, kao i uvijek.
• Kod preuzimanja i dostave web-trgovina prikazuje cijene i proizvode tog izbora (pri promjeni se stranica menija ponovno učitava), a za stolom one za lokal.
• Izvoz i uvoz konfiguracije (Postavke → Uvoz/izvoz) uključuju cijene po načinu narudžbe, "prodaje se za", razdoblja menija i sezonu happy houra.

Meniji

Zadano isključeno. Uključuje se pod Postavke → Objekt → Koristi menije.

• Meni je običan proizvod (s cijenom menija) kojem pod Postavke → Proizvodi → (proizvod) → Meni postavljaš dijelove:
  • fiksno: uvijek ovaj proizvod (npr. "Piće: Kućno vino");
  • po izboru: odaberi 1 (ili više) iz kategorije, po želji ograničeno na određene proizvode (npr. "Glavno jelo: odaberi 1 iz Glavnih jela").
  • Za svaki dio slijed (1 = odmah, 2/3 = čeka na pozivanje).
• Kad uneseš meni, za svaki dio biraš jela. Za svako jelo (i fiksno) možeš odabrati opcije kao kod pojedinačnog proizvoda (način pečenja, dodatni sir; obavezne opcije moraju biti odabrane) i napomenu. Nadoplata za opcije dodaje se na cijenu menija. Meni se prikazuje kao jedna stavka s jelima (i njihovim opcijama) ispod.
• Jela idu u kuhinju/šank kao zasebne stavke (kuhinjski nalog i kuhinjski zaslon), u svom slijedu. Sama stavka menija ne ide.
• Za PDV se cijena menija raspodjeljuje na dijelove razmjerno njihovoj normalnoj cijeni, tako da hrana i piće imaju ispravnu stopu. Na računu stoji meni s ukupnom cijenom i jelima ispod.
• Ako sam meni ima opcije (npr. veličinu), biraš ih na vrhu prozora menija. Prikazuju se uz stavku menija na računu, a uz svako jelo menija na kuhinjskom nalogu i kuhinjskom zaslonu kao "(meni)".
• Uklanjanje/storniranje radi se za cijeli meni (dodirni stavku menija).
• Podijeli / premjesti: odaberi stavku menija; jela idu s njom. Kod 2× istog menija možeš premjestiti i 1 (zaglavlje i jela se dijele).
• Bez veze menije možeš normalno unositi; spremaju se na tabletu i šalju čim se veza vrati (kao i pojedinačni proizvodi).
• Happy hour može vrijediti i za meni.

Normativi i nabavna cijena (Apicbase)

Povezivanje s Apicbaseom (normativi, nabavna cijena, zalihe i nabava) putem Generic POS API od Apicbasea (zadano isključeno, svaki se dio zasebno uključuje ili isključuje). Postavlja se pod Postavke → Normativi (ovlast Postavljanje objekta, plaćanja i pisača). Blagajna sama komunicira s Apicbaseom (samo odlazni promet, portal nije potreban).

1. Poveži (sve popunjava administrator), na jedan od tri načina:
   • Zalijepi token: u Apicbaseu Library Settings → API Settings → New token → Service Account Token (scopeovi accounts, library, sales); zalijepiti access token i refresh token;
   • Prijava vlastitom API-app objekta (client-id i client secret iz API Settings): Prijava u Apicbase i zalijepiti kôd koji Apicbase zatim prikaže;
   • Istekli token (nakon 7 dana) blagajna automatski obnavlja pomoću refresh tokena.
2. Outlet: Dohvati outlete i odabrati outlet ovog objekta. Blagajna tamo postavlja POS na Generic POS API s vlastitim location-id (može se mijenjati; zadano HORECAPOS-…, jedinstven za svaku blagajnu).
3. Uključeno, s kvačicama:
   • Proizvodi, grupe i opcije u Apicbase: grupe proizvoda, proizvodi (PLU = PLU broj proizvoda, inače kôd, inače id), opcije kao modifiers, s cijenom i PDV-om. Automatski nakon svake promjene (nakon minute) i svaki dan. U Apicbaseu zatim svaki proizvod s blagajne povezuješ s receptom;
   • Svaki naplaćeni račun u Apicbase: najstariji prvi, najviše 100 odjednom, unutar četvrt sata od naplate (i svakih 5 minuta). Popust se raspoređuje po stavkama; slobodni iznosi, doplata za jednokratnu ambalažu i povratna naknada vode se kao zaseban proizvod u Apicbaseu; vagani proizvodi kao 1 kom s ukupnim iznosom. Ako ne uspije, blagajna staje (Apicbase želi račune redom) i pokušava ponovno kasnije: naplata to ne osjeti. Pri uključivanju biraš od kojeg dana (zadano od sada);
   • Dohvaćaj nabavnu cijenu po porciji (svakih 6 sati): za svaki povezani recept food cost (sastojci i otpad), s troškovima osoblja, prodajna cijena i marža prema Apicbaseu. Izračunato prema najjeftinijem dobavljaču, zadnjoj naručenoj cijeni ili prosječnoj vrijednosti zaliha;
   • Preuzmi prodajnu cijenu iz Apicbasea (zadano isključeno): postavljanje prodajne cijene povezanih proizvoda u blagajni (bilježi se u dnevniku).
4. Na dnu: Nabavna cijena po proizvodu s nabavnom cijenom, nabavnom cijenom s osobljem, cijenom u blagajni, nabavnom cijenom % i maržom. Gumbi Pošalji katalog sada, Pošalji račune sada i Dohvati nabavne cijene sada.

Kôd: apps/pos-server/src/lib/apicbase.ts, routes/apicbase.ts; zaslon Apicbase.tsx. Dnevnik: Apicbase. Uvjet: API modul Apicbasea. Za aplikaciju Pin Voordeel za sve klijente: partnerstvo i certifikacija kod Apicbasea (vidi backlog). Dokumentacija: https://developers.apicbase.com/docs/generic-pos-api-guide

Hotelski softver: na sobu

Za restoran ili bar uz hotel: račun stavljate na sobu gosta. Zadano isključeno: Postavke → Hotel (pravo Postavljanje objekta, plaćanja i pisača).

• Jedan popis sa svim hotelskim softverom (Hotelski softver hotela). Ugrađene veze:
  • Mews (Connector API: client token i access token, usluga restorana i za svaku stopu PDV-a Mewsova šifra PDV-a), apaleo (vlastita aplikacija s client ID-om i client secretom, ID objekta; za svaku stopu PDV-a eventualno vrsta PDV-a) i Cloudbeds (API ključ i ID objekta), svaki s testnim i stvarnim okruženjem;
  • Oracle OPERA Cloud (OHIP), protel (protel I/O), RoomRaccoon, Booking Experts, Amadeus (XMLPOS), VIPS, Stayntouch, Clock PMS+, Guestline (Rezlynx), Hotelogix, eviivo, Little Hotelier, Shiji i Infor HMS (Databridge). Nakon odabira prikazuju se točno ona polja koja pripadaju tom hotelskom softveru (ključevi, ID hotela, eventualno adresa njihova API-ja i za svaku stopu PDV-a njihova šifra), s kratkim objašnjenjem što zatražiti od dobavljača. Ove veze izrađene su prema dokumentaciji dobavljača; neka dobavljač potvrdi vezu i najprije isprobajte s Testiraj vezu i jednim računom;
  • demo (četiri apartmana, sobe od 4 do 7) za isprobavanje;
  • Sirvoy, kao polovična veza i samo uz Sirvoy Pro. Sirvoy nema API kojim bi blagajna mogla nešto upisati na rezervaciju, ni putem datoteke (CSV uvoz stvara samo nove rezervacije). Time blagajna poznaje goste (soba, ime, dolazak, odlazak): pretraživanje kod Na sobu te samoposluga na kiosku i u web-trgovini rade normalno. Račun ne stiže sam u Sirvoy: nakon naplate nalazi se u Postavke → Hotel pod Još upisati u Sirvoy, sa sobom, gostom, brojem računa i iznosom po stopi PDV-a. Hotel ga ručno upisuje kao dodatak na rezervaciju i klikne Upisano (natrag s Ipak još ne). Potrebno:
    1. po mogućnosti blagajna povezana s administratorskim portalom: tada adresa ide preko portala (https://<portaal>/hotel/<kassa-id>/sirvoy?sleutel=...) i u hotelu nije potrebno otvarati port. Inače sama blagajna mora biti dostupna s interneta preko https (vlastita domena s certifikatom ili prosljeđivanje portova; Sirvoy traži TLS 1.2 ili noviji) i unesete tu adresu;
    2. Adresa se prikazuje samo jednom; blagajna čuva samo hash. Izrada nove adrese = stara više ne radi;

Sirvoy šalje nešto samo kad se rezervacija promijeni: rezervacije od prije povezivanja blagajna upozna tek nakon promjene u Sirvoyu. Poruke mogu stizati izmiješanim redom; poruka starija (generatedAt) od onoga što blagajna već ima preskače se. U hotelu = nije otkazano i nije odjavljeno, prijavljeno ili dolazak danas ili ranije, a odlazak danas ili kasnije. Testiraj vezu pokazuje koliko je rezervacija stiglo.

Sav hotelski softver dostupan je u Nizozemskoj i/ili Belgiji. Testiraj vezu provjerava podatke. Kod po vezi: apps/pos-server/src/lib/pms/<naam>.ts.

• Samoposluga (zadano isključena): hotelski gost sam stavlja svoju narudžbu na svoju sobu, na kiosku i/ili u web-trgovini (preuzimanje i dostava, ne pri naručivanju za stolom). Upisuje broj sobe i prezime; blagajna u hotelskom softveru provjerava boravi li taj gost sada u toj sobi. S najvećim iznosom po narudžbi (zadano € 150), a nakon 5 neuspjelih pokušaja u četvrt sata gost najprije mora na recepciju. Poruka nikada ne otkriva tko boravi u sobi.
• Naplata: kad je veza uključena, postoji način plaćanja Na sobu. Potražite gosta po imenu ili broju sobe (samo gosti koji su sada u hotelu) i dodirnite Stavi na sobu .... Blagajna knjiži račun po stopi PDV-a na hotelski račun gosta; gost plaća pri odjavi.
• Belgija: ako je narudžba već za stolom u crnoj kutiji, ona najprije prelazi sa stola na sobu (signCostCenterChange na ROOM, UC4101); račun ide kao kredit sobe (ROOM_CREDIT) u crnu kutiju.
• Ako knjiženje u hotelskom softveru ne uspije (nema interneta), prodaja ipak postoji, a knjiženje stoji kao Neuspjelo u Postavke → Hotel, s Pokušaj ponovno.
• Izvješća i knjigovodstvo: Na sobu (hotel) je zaseban način plaćanja na X i Z izvješću, u dnevnom izvješću i u revizijskoj datoteci (XAA).

Kod: apps/pos-server/src/lib/hotel.ts, routes/hotel.ts, veze u lib/pms/, katalog packages/shared/src/hotelcatalogus.ts; zaslon Hotel.tsx. Dnevnik: Hotel. Tajni podaci (tokeni) nalaze se samo u bazi podataka, nikad na zaslonu.

Upravljanje vinima s Vinifyjem

Postavke → Upravljanje vinima (zadano isključeno; isključivanjem se sve čuva). Vinify vodi vinski podrum, vinsku kartu i zalihu te je glavni izvor vina. Prema Vinifyjevim POS zahtjevima blagajna nudi API kojim Vinify:

Se prijavljuje na sva tri načina koja Vinify poznaje (administrator uključuje koji):

1. API ID i API ključ (X-Api-Id i X-Api-Key ili Authorization: Bearer <id>:<sleutel>);
2. API ključ i API secret s potpisom: X-Api-Key, X-Timestamp i X-Signature = hex HMAC-SHA256(secret, <timestamp>\n<METHODE>\n<pad met query>\n<sha256 van de body>), star najviše 5 minuta.

Ključ i secret stvara blagajna (prikazuju se jednom); zasloni vide samo jesu li uneseni. Dostupno putem portala na https://<portaal>/vinify/<kassa-id>/... (bez otvorenog porta u objektu; adresa je u Postavke → Upravljanje vinima). Koji su proizvodi vina: ono što Vinify stvori, plus grupe koje označite. Ako Vinify da adresu za slanje prodaje, blagajna je šalje i sama (push, s tokenom): nakon svakog naplaćenog računa i svakih 5 minuta ono što još nije uspjelo. Vinify uključuje povezivanje s HorecaPOS-om (hello@vinify.no). Sve u dnevniku. Ne miješati s Vinify.nl, internetskom trgovinom vinima: ona je među dobavljačima (Naručivanje od dobavljača).

Brzi unos adrese s poštanskim i kućnim brojem

Uključuje se u Postavke → Objekt → Brzi unos adrese (zadano isključeno; samo za objekt u Nizozemskoj). Upiši poštanski i kućni broj (i sa slovom ili dodatkom, npr. 12A ili 12-1) i dodirni Traži adresu: ulica, kućni broj, poštanski broj i mjesto se popunjavaju. Ako na tom broju ima više adresa (12, 12A, 12B), odabereš pravu. Nakon toga sve još možeš sam promijeniti.

• Kod podataka objekta (Postavke → Objekt, iznad adrese).
• Kod kupca s karticom vjernosti: na blagajni kod novog kupca i u Izvješće → Kupci. Kupci za to dobivaju (neobaveznu) adresu: ulicu i kućni broj, poštanski broj i mjesto.
• Adrese dolaze iz besplatnog Locatieservera od PDOK-a (službene adrese Nizozemske, BAG): ne treba račun ni ključ, ali treba internet. Bez interneta ili za belgijsku adresu jednostavno sam upišeš adresu.

Obavijest o novoj verziji

Uključuje se pod Postavke → Objekt → Obavijest o ažuriranju (zadano isključeno).

• Blagajna ažurirana: ako je poslužitelj blagajne ažuriran dok tablet još ima otvorene stare zaslone, na vrhu piše "Blagajna je ažurirana (verzija …)" s gumbom Osvježi. Tablet provjerava svakih 5 minuta, kad zaslon ponovno postane vidljiv i nakon ponovnog pokretanja poslužitelja.
• Dostupno ažuriranje: ako je blagajna povezana s portalom za upravljanje (PORTAAL_URL/PORTAAL_SLEUTEL) i ondje je popunjen NIEUWSTE_VERSIE, tko smije upravljati postavkama vidi "Dostupno ažuriranje: verzija …" (s objašnjenjem iz UPDATE_NOTITIE). Kasnije skriva obavijest na tom tabletu dok ne izađe novija verzija. Ažuriranje se radi kao i uvijek pomoću scripts\windows\update.cmd (vidi Ažuriranje).

Platforme za rezervacije

Rezervacije s TheFork, Formitable, Zenchef, Resengo (samo Belgija), OpenTable (samo Nizozemska), PlanPanther, RestoManager i Aqqo (samo Nizozemska) automatski dolaze u blagajnu i na tlocrt. Uključuje se u Postavke → Platforme za rezervacije (zadano isključeno). Moguće samo ako su Rezervacije uključene.

• Zemlja objekta: možeš odabrati samo platforme koje rade u zemlji objekta (Resengo samo u Belgiji, OpenTable i Aqqo samo u Nizozemskoj). Poslužitelj to također provjerava.
• Više platformi istodobno: možete povezati više platformi jednu uz drugu, na primjer TheFork i Formitable. Dvije platforme nikada ne dobivaju isti stol u istom terminu; druga rezervacija tada stiže bez stola.
• + Poveži platformu: odaberi platformu i unesi podatke. Tajne (Client secret, ključ za povratnu adresu) nikad se ne prikazuju u pregledu; ostaviti prazno = zadržati, Obriši = ukloniti.
• TheFork (javni B2B API): Restaurant-UUID, Client ID i Client Secret (zatražiti od TheFork). Ako blagajna otkaže, otkazuje i na TheFork.
• Formitable, Zenchef, Resengo, OpenTable, PlanPanther, RestoManager, Aqqo: njihov API je samo za partnere ili nije javan (PlanPanther, RestoManager i Aqqo: povezivanje s blagajnom dogovara se s njima). Formitable događaji (booking.created, .changed, .canceled, .checkin, .checkout) se prepoznaju.
• Na tlocrtu: ako se stol u blagajni zove isto kao stol na platformi i slobodan je u tom terminu, rezervacija ide na taj stol; inače bez stola (odaberi ga pri dolasku). Rezervacija koja ponovno stigne se ažurira, ne udvostručuje. U pregledu piše "putem TheFork".
• Status: ako platforma otkaže ili prijavi no-show, blagajna to preuzima. Ono što je u blagajni već označeno kao stiglo, ostaje stiglo.
• Javljanje natrag (no-show natrag): unesi povratnu adresu (npr. svog servisa za povezivanje). Blagajna šalje svaku promjenu iz blagajne (stigao, no-show, otkazano, plaćeno s iznosom) kao JSON: { platform, id, status, statusEn, bedrag, valuta, tafel, tijdstip, gemeldOp } (iznos u centima, samo kod plaćanja), s Authorization: Bearer <terugmeld-sleutel> ako ga uneseš. Ako ne uspije, blagajna pokušava ponovno svake minute i greška se prikazuje kod platforme. Ono što je došlo sa same platforme ne šalje se natrag.
• Probna rezervacija: stvara rezervaciju kakvu bi platforma poslala.
• Ukloni: veza i ključ se brišu; rezervacije ostaju.
• Sve promjene su u dnevniku (bez tajni).

Programi vjernosti i recenzije

Dva zasebna prekidača u Postavke → Bodovi i recenzije (oba zadano isključena, tada se nigdje ništa od toga ne vidi). Ako ih isključite, postavke i ono što se već dogodilo ostaju sačuvani.

Program vjernosti druge platforme: gost skuplja bodove kod Joyn (Belgija) i/ili Piggy (Leat; Nizozemska i Belgija). To je neovisno o vlastitoj kartici vjernosti blagajne; ona može normalno raditi uz to.

• Više istodobno: u Belgiji Piggy i Joyn mogu biti uključeni zajedno, svaki s vlastitim podacima (odaberite platformu, ispunite, Spremi; Uredi i Izbriši po platformi). Gost za svaki program dobiva vlastiti QR kod na računu, vlastitu poveznicu u računu poslanom e-poštom i vlastiti gumb u web-trgovini te u svakom programu skuplja jednom po narudžbi. Ono što je već bilo postavljeno i dalje normalno radi.
• QR kod na računu: nakon naplate ispod računa je QR kod s natpisom "Skenirajte i skupljajte bodove kod ...". U računu poslanom e-poštom je poveznica, a u web-trgovini (preuzimanje i dostava) gumb na stranici narudžbe i poveznica u e-mailu potvrde. Jedna narudžba donosi bodove samo jednom: račun, e-mail i web-trgovina koriste isti jedinstveni kod (broj narudžbe). "QR kod na ispisanom računu" možete isključiti; e-mail i web-trgovina i dalje dobivaju poveznicu.
• Piggy, način "QR kod i poveznica": unesite adresu svog Piggy korisničkog portala, Shop UUID i Account secret (Piggy Business Dashboard). Radi bez interneta: blagajna sama izrađuje poveznicu.
• Piggy, način "Odmah pripiši": unesite i personal access token (Piggy → Marketplace → Private App). Ako blagajna pošalje račun e-poštom, a gost s tom adresom već je član, blagajna odmah pripisuje bodove; na računu tada piše "Bodovi pripisani kod Piggyja". Blagajna nikad ne stvara novog člana; nije član (ili nema adrese e-pošte) = QR kod.
• Joyn, način "QR kod i poveznica": s partner key, shop reference i shared secret od Joyna (zatražite na api-integration@joyn.be). Radi bez interneta. QR kod vrijedi 2 sata.
• Joyn, način "Putem API-ja": sa shop API key (uključite povezivanje u Joyn portalu za trgovce). Blagajna pri naplati traži kod za bodove od Joyna. Iskorištavanje bodova ide kao i uvijek na Joyn-iPad.
• Izradi probnu poveznicu: provjerava jesu li podaci ispravni (poveznica od € 10; otvorite je samo da pogledate).
• Mogu se odabrati samo platforme iz zemlje objekta; tajni podaci nalaze se samo u bazi podataka i nikad se ne prikazuju na zaslonu (prazno = zadrži).

Traženje recenzija: nakon posjeta jedan e-mail s gumbom za Google i/ili Trustpilot.

• Nekoliko sati kasnije (podesivo, zadano 3) gost dobiva e-mail, na jeziku računa.
• Web-trgovina: kod preuzimanja i dostave web-trgovina sama šalje e-mail, nekoliko sati nakon što je narudžba završena u blagajni, na jeziku gosta.
• Google: zalijepite poveznicu za recenziju iz poslovnog profila (Google → vaš poslovni profil → Zatraži recenzije, https://g.page/r/.../review) ili unesite Place ID.
• Trustpilot: unesite domenu svog objekta (gumb vodi na trustpilot.com/evaluate/<domein>). Ako kod Trustpilota imate adresu za pozivnice (Automatic Feedback Service, ...@invite.trustpilot.com), unesite i nju: e-mail tada ide Trustpilotu kao skrivena kopija (BCC), s nevidljivim imenom, adresom e-pošte i brojem računa, a Trustpilot sam šalje pozivnicu (tada nema vlastitog gumba za Trustpilot). Samo Trustpilot s adresom za pozivnice: blagajna šalje e-mail samo Trustpilotu.
• Ne prečesto: isti gost (adresa e-pošte) dobiva najviše jedan upit po razdoblju (zadano 90 dana; 0 = svaki put). Za to blagajna čuva samo hash adrese; sama adresa e-pošte briše se čim je e-mail poslan (ako ne uspije, nakon tri pokušaja, a inače nakon 14 dana).
• QR kod na računu (neobavezno): i QR kod za recenziju ispod ispisanog računa.
• Primjer e-maila i Obriši e-mailove na čekanju (adrese se tada odmah brišu). Dnevnik prikazuje review_gevraagd s a***@domena.hr.
• Google i Trustpilot zabranjuju nagradu za recenziju i traženje recenzija samo od zadovoljnih gostiju ("review gating"). Zato blagajna svima šalje isti upit i ne daje ništa zauzvrat za recenziju.
• Čitanje recenzija i odgovaranje na njih u blagajni: vidi Upravljanje recenzijama u nastavku.

Povezivanje s Mailchimpom i Klaviyom

Kupci s karticom vjernosti u tvom vlastitom programu za e-poštu: u Postavke → Objekt → Mailchimp i Klaviyo (ispod SMS i e-mail marketinga). Nema prekidača: bez povezivanja s odabranim popisom ništa se ne događa.

• Povezivanje: s API ključem (Mailchimp: Profiel → Extra → API keys; Klaviyo: privatni ključ pk_… s pravima pisanja za Lists, Profiles, Subscriptions, Events, Campaigns i Templates). Tajna klijenta i ključ nikad se više ne prikazuju (ostaviti prazno = zadržati). Zatim odaberite popis (Mailchimp: audience).
• Kupci: tko je dao pristanak za e-poštu, ide na popis (prijavljen) s imenom, prezimenom, telefonom, rođendanom i bodovima vjernosti (Mailchimp: polje PUNTEN, koje blagajna sama izrađuje; Klaviyo: svojstvo punten). Povučen pristanak, promijenjena adresa e-pošte ili obrisan kupac: odjavljen. Ponovno se šalje samo ono što se promijenilo. Uz povezivanje blagajna (i kvačica "ponude" u web-trgovini) od novog kupca traži i pristanak za e-poštu, a on se može promijeniti u Izvješće → Kupci, i bez vlastitog marketinga e-poštom.
• Odjava: tko se odjavi u Mailchimpu ili Klaviyu, ni u blagajni više nema pristanak za e-poštu (dnevnik: "odjavljen u Mailchimpu"). Tko se sam odjavio, blagajna ga ne prijavljuje ponovno.
• Narudžbe: svaki plaćeni račun kupca s popisa šalje se kao događaj (Mailchimp: bestelling, s iznosom, brojem računa i količinom; Klaviyo: Placed Order, s vrijednošću u eurima). Tako u programu za e-poštu izrađuješ automatske e-poruke, npr. nakon prve narudžbe ili kad netko mjesec dana nije došao. Računi od prije odabira popisa ne šalju se.
• Akcije: u Izvješće → Marketing akciju možeš poslati i putem Mailchimpa ili Klaviya (vidi SMS i e-mail marketing); blagajna tada ondje izrađuje kampanju i šalje je.
• Ažuriranje: svakih 5 minuta ili s Ažuriraj sada. Odspajanje: nestaje iz blagajne; u Mailchimpu i Klaviyu sve ostaje. Ključevi su u bazi podataka (u sigurnosnoj kopiji da, u izvozu konfiguracije ne).

Kod: lib/mailinglijst.ts, routes/mailinglijst.ts i MailingKoppelingen.tsx.

BI i izvoz podataka

Podaci o prodaji u Power BI, Looker Studio, Excel, Google Sheets, Tableau, Qlik Sense, Metabase, BI uslugu (na primjer YourBI, BI4Horeca ili Moore DRV) ili vlastito skladište podataka. Uključuje se u Postavke → BI i izvoz podataka (zadano isključeno). Samo čitanje: putem veze ništa se u blagajni ne može promijeniti. Bez podataka o gostima.

• Podaci: računi (i odobrenja), prodani proizvodi (stavke računa), plaćanja, promet po danu, promet po satu, storna, proizvodi, zaposlenici (bez PIN-a) i odrađeni sati. Iznosi u eurima s točkom kao decimalnim znakom, vremena prema vremenu objekta.
• + Veza: odaberite paket i način. Svaki paket podržava jedan ili više načina; možete imati više veza istodobno (i za isti paket).
• Paket sam dohvaća (API): blagajna jednokratno daje ključ samo za čitanje. Razdoblje s ?van=&tot= (GGGG-MM-DD) ili fiksna adresa s ?periode= (vandaag, gisteren, 7d, 30d, 90d, 365d, week, maand, vorigemaand, jaar); najviše 366 dana, najviše 200.000 redaka. Ključ u Authorization: Bearer, X-Sleutel ili ?sleutel=.
• Putem portala: ako je blagajna povezana s korisničkim portalom, ista adresa radi i izvan objekta, bez otvaranja porta: https://<portaal>/bi/<kassa-id>/<gegevens>?periode=90d&formaat=csv&sleutel=.... Tako je usluga Power BI osvježava prema rasporedu (bez pristupnika), a Google Sheets je može dohvatiti s =IMPORTDATA("...") (to je i izvor za Looker Studio). Blagajna prikazuje adresu kod veze.
• Pregled lanca putem portala za korisnike (više poslovnica): jedna adresa i jedan ključ za sve vaše blagajne zajedno. Na svakoj blagajni koja treba sudjelovati uključite Pregled lanca putem portala za korisnike (ispod BI prekidača) i u portalu za korisnike pod Moje blagajne → BI za sve vaše poslovnice izradite ključ. Zatim: https://<portaal>/bi/keten/<gegevens>?periode=90d&formaat=csv&sleutel=hpk_.... Portal preuzima podatke sa svake blagajne i spaja ih, uz kassaId i zaak u svakom retku. Blagajne koje su izvan mreže ili ne sudjeluju navedene su u ontbrekend (JSON) i u zaglavlju X-Ontbrekend. Sama blagajna za to ne treba vlastiti ključ; isključivanje na blagajni ili u portalu za korisnike to zaustavlja.
• Ako postoji token, šalje se kao Authorization: Bearer, a potpis se nalazi u X-HorecaPOS-Handtekening (sha256= HMAC sadržaja). Ako ne uspije, blagajna pokušava ponovno svake minute; ništa se ne šalje dvaput. S opcijom od šalje i starije račune.
• Blagajna isporučuje datoteke: svaki dan (u određeno vrijeme, za prethodni dan; propušteni dani se nadoknađuju) ili svaki sat (danas do sada), kao CSV (zarez ili točka-zarez za nizozemski Excel) ili JSON, u mapu na računalu blagajne (na primjer OneDrive ili SharePoint mapu za Power BI ili Excel), na FTP(S) ili SFTP poslužitelj ili e-poštom. Nazivi datoteka: horecapos_<gegevens>_<datum>.csv.
• Pošalji test (push) i Izvezi sada (datoteka) kod veze.
• Preuzmi sam: odaberite podatke, razdoblje i format.
• Power BI predložak (.pbit): gotovo izvješće za Power BI Desktop, gumbom Preuzmi Power BI predložak u BI i izvoz podataka. Najprije napravite API povezivanje (Power BI). U modelu: tablica po skupu podataka s ispravnim tipovima, kalendar (godina, mjesec, tjedan, dan u tjednu), relacije (datum → kalendar, stavke računa → proizvodi, odrađeni sati → zaposlenici) i mjere (promet s PDV-om i bez PDV-a, PDV, napojnica, računi, gosti, prosjek po računu i po gostu, prodana količina, promet proizvoda, plaćeno, storna, odrađeni sati, promet po odrađenom satu). Tri stranice: Pregled (ključni pokazatelji, promet po danu, danu u tjednu i satu, načini plaćanja), Proizvodi (po grupi i po proizvodu) i Osoblje (sati i promet po zaposleniku). Preko portala ga usluga Power BI osvježava i prema rasporedu.
• Tajni podaci (token, lozinka, ključ) nikad se ne prikazuju u pregledu; ostaviti prazno = zadržati, Obriši = ukloniti. Sve se bilježi u dnevnik (bez tajnih podataka).

Plaće i planiranje

Uz uključenu Evidenciju dolaska i odlaska osoblja (Postavke → Objekt), pod Postavke → Radno vrijeme na dnu je Plaće i planiranje (ovlast Upravljanje postavkama), u dva odvojena bloka. Ako je evidencija isključena, nema sati: tada je samo blok Planiranje osoblja (promet, uživo ili kao datoteka prometa) na dnu Postavke → Knjigovodstvo, pod naslovom Promet u tvoje planiranje:

• Obračun plaća (payroll): odaberi program za plaće ili (Belgija) socijalni sekretarijat, ispuni njegova polja i za svakog zaposlenika njegov broj zaposlenika u tom programu. Zatim za neko razdoblje izrađuješ datoteku s odrađenim satima (zatvorene smjene, po zaposleniku po danu dolaska) i prometom po zaposleniku (bez PDV-a, ono što je on/ona naplatio/la): spremno za Loket.nl (Variabele gegevens, ukupno po zaposleniku za razdoblje, zaglavlje aanslnr;persnr;ploeg;<looncomponent>) i SD Worx Belgija (Tijdsregistratie, fiksne pozicije, po zaposleniku po danu), inače popis sati (CSV: Datum; Broj zaposlenika; Ime; Sati; Promet bez PDV-a). Zaposlenici bez broja zaposlenika ne ulaze u datoteku za Loket ili SD Worx; blagajna javlja o kome se radi.
• Planiranje osoblja (WFM): odaberi sustav za planiranje. Ponovno slanje prepisuje podatke. Uz to popis prometa (CSV po danu i satu, bez i s PDV-om) i za Strobbo Excel datoteka za Importeer omzet.
• Samo programi koji rade u zemlji objekta, po grupi i abecednim redom; poslužitelj odbija program iz druge zemlje (400).
• Ključevi i tokeni nikad se ne prikazuju na zaslonu.
• Utječe na knjigovodstvo: troškove plaća knjiži program za plaće u knjigovodstvu, promet knjiži blagajna (Postavke → Knjigovodstvo). AFAS Payroll i Exact Online Loon nalaze se u istom okruženju kao knjigovodstvo AFAS-a i Exacta.
• Na kopiji blagajne na portalu to nije moguće (to radi blagajna u objektu).
• Za neke programe API nije javan ili je samo za partnere (među ostalim Loket, Nmbrs, Nostradamus, Employes, Shyfter, Planday, Eitje): oni su označeni na zahtjev; do tada datoteka. Format za SD Worx i Strobbo preuzet je iz njihove dokumentacije: daj provjeriti prvi uvoz.

Zakonski zahtjevi u Belgiji i Nizozemskoj

Što zakon traži i što HorecaPOS za to čini (neka vaš knjigovođa potvrdi što vrijedi za vaš objekt):

Zakoni i propisi

Postavke → Zakoni i propisi (administrator; PDV asistent i s pravom Upravljanje proizvodima). Sve je zadano isključeno; bez ovih postavki blagajna radi kao i uvijek.

• Provjera dobi za alkohol (18+): u Proizvodima označite Sadrži alkohol (ili koristite PDV asistenta). Za van i dostavu s alkoholom piše "18+" na radnom nalogu, računu i na zaslonu narudžbi. U web-trgovini kupac sam potvrđuje da ima 18 ili više godina (kućica nije unaprijed označena) i vidi da se dob provjerava pri predaji.
• Naknada za jednokratnu ambalažu (Nizozemska): iznos po proizvodu (okvirne cijene: čaša € 0,25, posuda za obrok € 0,50, mala posuda € 0,05). Za van i dostavu blagajna sama dodaje stavku "Naknada za jednokratnu ambalažu" na račun (s PDV-om proizvoda); ona automatski prati proizvode (baza podataka je vodi, i nakon storniranja, premještanja ili druge vrste narudžbe) i stoji zasebno u prometu. U lokalu nema naknade. Thuisbezorgd.nl i web-trgovina naplaćuju vlastitu naknadu.
• Povratna naknada (Nizozemska): po proizvodu (€ 0,15 limenka/boca, € 0,25 velika boca), stavka "Povratna naknada" bez PDV-a, samo za van i dostavu.
• Gotovina € 3.000 ili više (Nizozemska, zabranjeno za robu od 1-1-2026): za van i dostavu poruka pri naplati i na automatu za gotovinu; djelatnik može potvrditi (npr. catering kao usluga), što se bilježi u dnevnik. Hrana i piće u lokalu su usluga: bez poruke.
• PDV asistent: po proizvodu vrsta (obrok, bezalkoholno piće, alkoholno piće, hrana bez pripreme, ostalo; najprije pretpostavka na temelju naziva i grupe). Blagajna prikazuje ispravnu stopu u lokalu i za van (Belgija od 1-3-2026: jela i bezalkoholna pića 12%, i za van; alkohol 21%; hrana bez pripreme 6%. Nizozemska: 9% i 21%) i primjenjuje je, odmah ili od datuma.
• Zakazivanje promjene PDV-a: proizvod na drugu stopu ili (samo Nizozemska) stopa s novim postotkom, od određenog datuma. Blagajna to sama izvršava tog dana (provjera svakih petnaest minuta i pri pokretanju).

Računi (u Belgiji obvezni među tvrtkama) opisani su u Računi za poslovne kupce. Za napraviti: GKS 2.0, provjeriti stanje certifikacije (vidi docs/backlog-concurrenten.md).

Računi za poslovne kupce

Postavke → Računi (administrator; zadano isključeno): uključi Računi za poslovne kupce (UBL / Peppol). Ispod se, kad je uključeno, nalaze Plaćanje na račun, Podaci na računu, Peppol usluge, Veza s bankom (uz plaćanje na račun) i popis svih računa. U Belgiji je e-fakturiranje među tvrtkama obvezno od 1. 1. 2026.

• Fakture za poslovne kupce: Računi → odaberite račun → Faktura. Unesite kupca (ili odaberite prethodnog kupca); blagajna izrađuje numeriranu fakturu (npr. F2026-0001, redni broj po godini), kao UBL prema Peppol BIS Billing 3.0 i kao fakturu za ispis ili spremanje u PDF. Slanje e-poštom (oboje kao privitak, po želji kopija knjigovođi), putem Billit u mrežu Peppol (BILLIT_API_KEY, BILLIT_PARTY_ID), putem Storecove (STORECOVE_API_KEY, STORECOVE_LEGAL_ENTITY_ID; primatelj se određuje prema Peppol ID-u kupca, npr. 0208 → BE:EN, 0106 → NL:KVK, inače e-poštom putem Storecovea) ili putem Banqup tvrtke Unifiedpost (BANQUP_CLIENT_ID, BANQUP_CLIENT_SECRET, BANQUP_SPACE_ID; BANQUP_SANDBOX=1 za testno okruženje; Banqup provjerava UBL i sam ga dostavlja), na vlastitu adresu (FACTUUR_HTTP_URL, npr. knjigovodstveni program ili druga Peppol usluga) ili preuzimanje. Jedna faktura po računu; račun je već plaćen, dakle "plaćeno". KvK broj / broj poduzeća, IBAN, Peppol ID, prefiks i rok plaćanja u Podaci na fakturi. Sve fakture na dnu kartice (pravo Promet po razdoblju).
• Ključevi, tajne i zaglavlja nikad se ne prikazuju (samo "uneseno"; ostaviti prazno = zadržati, Obriši = ukloniti) i ne bilježe se u dnevnik (samo koja su polja promijenjena). Spremljeni su u bazi podataka (vestiging.peppol_gegevens): u sigurnosnim kopijama da, u izvozu konfiguracije ne.

Samoposlužni kiosk

Gosti sami naručuju na stupu ili tabletu, kao u fast foodu, i plaćaju na blagajni ili karticom na kiosku. Zasloni za narudžbu dio su same blagajne, pa jelovnik, cijene, opcije, meniji, happy hour, dijelovi dana, fotografije, alergeni, jezici i račun dolaze s blagajne i ne treba ih nigdje drugdje postavljati. Na kiosku radi aplikacija PinPortal Kiosk 2 (Android, i Sunmi, te Windows, Linux i macOS), koja prikazuje stranicu i ispisuje račun. Zadano isključeno.

Uključivanje i postavljanje (administrator): Postavke → Objekt → Zasloni i rukovanje → Samoposlužni kiosk.

• Odaberite što gost može birati: Jedem ovdje i/ili Za van (za van računa cijenu za van i stopu PDV-a za van, ako su postavljene).
• Tekst dobrodošlice, nakon koliko sekundi bez dodira se kiosk vraća na početak (košarica se tada prazni) i koje su grupe proizvoda na kiosku (ništa označeno = sve).
• Još nešto uz to?: označite grupe proizvoda (npr. pića, deserti); kod košarice kiosk tada predloži nekoliko proizvoda iz njih.
• Plaćanje, za svaki kiosk (vidi Dodavanje i povezivanje kioska):
  • Na blagajni (zadano, kao kod starog kioska): gost naruči, dobije broj za preuzimanje i plati na blagajni. Na kiosku nije potreban terminal.
  • Karticom na kiosku: gost plaća na terminalu kod kioska.
  • Gost bira: na blagajni ili karticom. Ako kiosk nema terminal, plaća se na blagajni.
• U kuhinju (kod plaćanja na blagajni): odmah nakon narudžbe na kiosku (zadano) ili tek kada je plaćeno na blagajni.
• Račun: na pisaču kioska (zadano), na pisaču računa blagajne ili bez računa (samo broj na zaslonu). Kod plaćanja na blagajni kiosk ispisuje listić s brojem i još nije plaćeno; račun dolazi pri naplati na blagajni.
• Status narudžbe na mobitelu (neobavezno, zadano isključeno): na računu s kioska i na završnom zaslonu pojavljuje se QR kod. Gost ga skenira, vidi svoj broj i status (naručeno, priprema se, gotovo) i dobiva obavijest kad je narudžba gotova. Radi preko portala za upravljanje, pa blagajna mora biti povezana s njim.
• Alkohol i proizvodi na kilogram nikad nisu na kiosku: bez osoblja se dob ne može provjeriti i nema vage.
• Skener crtičnog kôda (neobavezno, zadano sve isključeno): označi što skeniranje na kiosku smije:
  • proizvod u košaricu (kod proizvoda);
  • kod za popust;
  • karticu vjernosti (gost skuplja bodove);
  • poklon-bon ili prepaid karticu kao plaćanje. Ako je saldo dovoljan, narudžba je odmah plaćena. Inače bon plaća dio, a gost ostatak plaća karticom ili na blagajni (to je tada dopušteno i na kiosku samo s plaćanjem karticom). Nakon takvog djelomičnog plaćanja gost više ne može otkazati; narudžba se na blagajni vidi kao Kiosk … · broj.

Sam skener postavljaš na kiosku: u aplikaciji PinPortal Kiosk 2 pod upravljanje → Skener crtičnog kôda (kao tipkovnica, ugrađeni skener ili COM priključak), s testom skenera. Skener koji radi kao tipkovnica radi i bez aplikacije.

• Nadoplati kredit (neobavezno, zadano isključeno; radi samo ako je uključen Nadoplativi kredit): na početnom zaslonu kioska tada stoji Nadoplati kredit. Gost skenira svoju karticu ili bon (ili upiše kôd), vidi saldo i odabere iznos. Iznose postavljaš sam (od 1 do 6, zadano € 10, € 20 i € 50). Plaćanje ide kako je postavljeno za kiosk: karticom ili na blagajni s brojem za preuzimanje. Nakon naplate iznos je na stanju. Takva nadoplata ne ide u kuhinju, nije na zaslonu za pozivanje i ne dobiva QR kod. I ovdje vrijedi najveće stanje iz postavke Nadoplativi kredit.
• Na moju sobu (hotelska veza, zadano isključena; Postavke → Hotel → Samoposluga): uz košaricu tada stoji Stavi na moju sobu. Hotelski gost upisuje broj sobe i prezime; ako se to podudara s gostom koji sada boravi u toj sobi, narudžba ide u kuhinju i plaćena je na sobu (vidi Hotelski softver: stavljanje na sobu).
• Belgija (crna kutija): ono što još nije testirano s crnom kutijom automatski je isključeno na kiosku (poklon-bon ili saldo kao plaćanje, nadoplata, kod za popust, meniji, opcije s nadoplatom, happy hour), isto kao na blagajni.

Dodavanje i povezivanje kioska

1. Kod Kioski upišite naziv (npr. Kiosk ulaz) i odaberite Dodaj kiosk. Dobit ćete kod za povezivanje od 6 znamenki (vrijedi 30 minuta).
2. Odaberite kod kioska kako gost plaća: zadano na blagajni. Ako je to kiosk s terminalom, odaberite karticom ili gost bira i odaberite terminal ovog kioska (iz Postavke → Plaćanje).
3. Otvorite stranicu kioska na kiosku:
   • u objektu: u aplikaciji pod upravljanje → Vast adres adresu navedenu kod postavke, npr. http://192.168.1.20:3000/kiosk;
   • ili preko upravljačkog portala (https, i kad kiosk nije u istoj mreži): povežite adresu kioska navedenu kod postavke s kodom kioska u aplikaciji, kao kod starog kioska.
4. Upišite kod za povezivanje na kiosku. Gotovo: kiosk pamti svoj ključ. Ponovno poveži daje novi kod; Ukloni ga odspaja.

Kod svakog kioska vidi se je li online.

Kako gost naručuje

1. Početni zaslon s tekstom dobrodošlice; gost bira jezik (svi jezici blagajne) i dodirne za narudžbu.
2. Jedem ovdje ili za van.
3. Jelovnik po grupama proizvoda, s fotografijama, cijenom (s happy hourom), alergenima i onim što je rasprodano. Proizvodi s izborom ili meni otvaraju prozor za izbor.
4. Košarica: promjena količina i po želji Još nešto uz to?.
5. Naruči (plaćanje na blagajni): gost vidi svoj broj za preuzimanje velik na zaslonu s iznosom, dobije listić i plati na blagajni. Na blagajni je narudžba otvorena kao Kiosk Ulaz · 42 (broj koji gost kaže); naplata kao i uvijek. Zatim je na zaslonu za pozivanje prikazana kao plaćena i ide u kuhinju ako je to trebalo tek nakon plaćanja.
6. Plati karticom: blagajna šalje iznos na terminal ovog kioska (ista veza za plaćanje kao na blagajni). Ako ne uspije, gost može pokušati ponovno ili odustati (ili, ako smije birati, ipak platiti na blagajni). Tek kad plaćanje uspije, narudžba ide u kuhinju i naplaćuje se. Gost vidi svoj broj za preuzimanje velik na zaslonu i dobije račun.
7. Nakon nekoliko sekundi kiosk se vraća na početak.

Pri kvaru: obavijest i hitni način rada (u aplikaciji kioska, upravljanje → Bij storing; zadano isključeno). Ako kiosk ne može doći do blagajne, prikazuje Even gesloten. Dva dodatka:

• Teams, Slack, Discord, ntfy, Home Assistant, Make ili Zapier), i poruku hersteld kad opet radi. Pomoću Testmelding sturen provjeravate adresu.
• Hitni način rada: kiosk sprema jednostavan jelovnik koji mu prosljeđuje stranica kioska: proizvodi bez izbora i menija, po cijeni za jelo na licu mjesta (ili za van ako je to jedini izbor).
  • Ako blagajne nema neko vrijeme (zadano 60 sekundi), gost naručuje s tog jelovnika.
  • Gost plaća karticom ili na šanku. Plaćanje karticom moguće je samo ako je u aplikaciji uključeno Pinbetaling.
  • Ispisuju se dva hitna listića: jedan za gosta (N1, N2 …) i jedan za šank/kuhinju. Na njima piše da nisu račun.
  • Kad se blagajna vrati, stranica kioska unosi hitne narudžbe u blagajnu kao Nood N… <kiosk>. Ne idu u kuhinju (ona je već imala hitni listić) i ne prikazuju se na zaslonu za pozivanje.
  • Plaćeno karticom i isti iznos kao u blagajni: obračunato kao Ručno plaćeno karticom. Inače (plaćanje na šanku ili drugi iznos) narudžba ostaje otvorena za konobare.
  • Sve je zapisano u dnevniku.
• Belgija: s registriranim blagajničkim sustavom (GKS, crna kutija) svaka prodaja mora odmah proći kroz blagajnu i FDM. Hitni način rada tada vjerojatno nije dopušten; najprije provjerite. U Belgiji ga aplikacija kioska uključuje samo nakon dodatne potvrde, a blagajna upozorava kod kioska.

Na blagajni je narudžba s kioska obična narudžba (za van ili na mjestu, s nazivom Kiosk Ulaz) na ime zaposlenika Kiosk. Blagajna ga sama stvara; nitko se ne može njime prijaviti. Ne postavljajte ga kao neaktivnog, inače kiosk ne može naručivati. Narudžbe s kioska su u izvješćima, u Računima i na zaslonu za pozivanje. Narudžba nedovršena na kiosku (nenaručena ili neplaćena karticom) sama istječe nakon 30 minuta.

Plaćanje karticom u testnom načinu (Postavke → Plaćanje)? Tada kiosk zapravo ne naplaćuje; zgodno za probu. Bez interneta plaćanje karticom nije moguće; kiosk tada kaže da se može naručiti na šanku.

Kvar: ako blagajna nije dostupna, aplikacija kioska prikazuje "Privremeno zatvoreno" i sama nastavlja. Ako kiosk radi preko portala za upravljanje i nestane interneta, aplikacija može prijeći na blagajnu u lokalnoj mreži (u aplikaciji: upravljanje → Proširenja → Pri kvaru prijeđi na lokalnu mrežu); adresu kiosk sam prosljeđuje.

Isključivanje: kiosk javlja da je na trenutak zatvoren. Kioski i postavke ostaju spremljeni. U zapisniku su uključivanje/isključivanje, postavke, dodani i uklonjeni kioski, povezivanja i otkazane narudžbe.

Digitalna ploča s jelovnikom

Jelovnik s cijenama na TV-u (ili drugom monitoru s preglednikom), izravno iz blagajne. Zadano isključeno; uključuje se putem Postavke → Objekt → Zasloni i rukovanje → Digitalna ploča s jelovnikom. Zatim na TV-u otvori http://<kassaserver>:3000/menubord (ili gumb Na zasebnom zaslonu / Na tabletu ili mobitelu s QR kodom). Bez prijave i bez uparivanja.

• Po kategoriji proizvodi s cijenom, redoslijedom kao na blagajni. Sam odaberi koje kategorije (i kojim redom), 1 do 4 stupaca, tamno ili svijetlo, vlastiti naslov (prazno = naziv objekta), fotografije proizvoda i alergene.
• Uvijek točno: ploča svakih 10 sekundi dohvaća jelovnik (i odmah pri promjeni), pa su rasprodani proizvod (precrtan oznakom Rasprodano ili uklonjen s ploče), prazne zalihe, happy hour (akcijska cijena s precrtanom redovnom cijenom te naziv i vrijeme završetka na vrhu) i razdoblja menija (samo ono što se sada prodaje) automatski ispravno prikazani.
• Ako sve ne stane na zaslon, stranice se izmjenjuju (zadano svakih 12 sekundi, podesivo od 5 do 120).

Osoblje i PIN-ovi

Postavke → Osoblje (samo administrator): dodavanje zaposlenika, promjena imena, uloge i PIN-a te deaktivacija.

• Uloge: konobar (naručivanje, naplata, X izvješće), voditelj (uz to popust, povrat, zatvaranje dana, ladica za novac i dnevnik) i administrator (sve, uključujući sve Postavke). To je zadano; što smiju konobar i voditelj može se prilagoditi (vidi Ovlasti po ulozi).
• PIN od 4 do 8 znamenki, jedinstven među aktivnim zaposlenicima. PIN-ovi su u bazi podataka spremljeni samo šifrirano (hash) i ne mogu se iščitati.
• Trajno brisanje nije moguće (računi i dnevnik upućuju na zaposlenika); neaktivan = više se ne može prijaviti.
• Uvijek ostaje barem jedan aktivni administrator.
• Druga uloga, novi PIN ili deaktivacija: aktivne sesije tog zaposlenika odmah se prekidaju.
• Belgija: po želji nacionalni registarski broj za evidenciju osoblja.
• Jezik: jezik zaslona za ovog zaposlenika (ili "Jezik uređaja"). Nakon prijave blagajna je odmah na tom jeziku; zaposlenik ga može i sam promijeniti zastavicom dolje desno (vidi Jezici).
• Savjet: zamijeni demo PIN-ove 1111 i 2222 prije nego što blagajna počne s radom.

Prijava karticom (neobavezno)

Zadano isključeno. Uključivanje: Postavke → Osoblje, kvačica Prijava karticom (NFC, RFID ili iButton). Potrebno: USB čitač kartica koji radi kao tipkovnica (za NFC ili RFID kartice, privjeske za ključeve, narukvice ili iButton ključeve). Takav čitač "utipka" broj kartice i pritisne Enter; nije potreban upravljački program ni povezivanje.

• Uparivanje: dodirni djelatnika, zatim Upari karticu i prinesi karticu čitaču. Jedna kartica pripada jednom djelatniku. Ukloni karticu ako se izgubi.
• Prijava: na zaslonu za prijavu prinesi karticu čitaču. PIN i dalje normalno radi.
• Dolazak i odlazak (ako je uključeno): na zaslonu za prijavu Dolazak / odlazak i prinesi karticu čitaču.
• Broj kartice sprema se u bazu podataka samo šifrirano (hash), kao i PIN. Neaktivni djelatnici ne mogu se prijaviti ni svojom karticom.
• Isključeno: prijava samo PIN-om, kao i uvijek. Uparene kartice ostaju spremljene.

Prava po ulozi

Postavke → Ovlasti (samo administrator): po ulozi označi što smiju konobar i voditelj. Zadano je sve točno kao gore (kako je blagajna uvijek radila); polje koje odstupa je obojeno.

• Administrator uvijek smije sve. Promjena osoblja i ovlasti uvijek ostaje samo za administratora (inače bi netko sebi mogao dati više ovlasti).
• Gumbi i kartice koje uloga ne smije koristiti skriveni su za tu ulogu; poslužitelj blagajne to također provjerava. Ako voditelj npr. dobije Upravljanje proizvodima, vidi gumb Postavke samo s karticom Proizvodi.
• Promjene odmah vrijede na svim blagajnama i bilježe se u dnevniku. Vrati na zadano vraća sve kako je bilo.

Podaci o lokalu

Postavke → Objekt (samo administrator): naziv, adresa, poštanski broj, mjesto, telefon i PDV broj poslovnice. Oni stoje na vrhu svakog računa i predračuna. Ovdje se postavlja i tekst na dnu računa (smije više redaka; prazno = bez teksta; zadano "Bedankt en tot ziens!"), a ispod toga jezik računa (zadano nizozemski; vidi Jezici). Primjer računa mijenja se uživo. Nakon spremanja sljedeći račun odmah koristi nove podatke. Država i fiskalni podaci (GKS) ovdje se namjerno ne mogu mijenjati. U Belgiji je PDV broj obavezan. Kvačicom Zaokruži gotovinska plaćanja na 5 centi (zadano isključeno) ukupni iznos se kod gotovine zaokružuje (€ 6,62 → € 6,60, € 6,63 → € 6,65); razlika se na računu prikazuje kao "Zaokruživanje". Kartično plaćanje uvijek ostaje točno na cent.

Upravljanje proizvodima

Prijavi se kao administrator i odaberi Postavke → Proizvodi.

• Dodavanje, uređivanje (naziv, cijena, kategorija, stopa PDV-a za konzumaciju na mjestu i za ponijeti, naziv na računu, kôd, rasprodano) i brisanje kategorija i proizvoda. Kategorije i proizvodi mogu imati vlastitu boju; proizvod s bojom dobiva obojeni gumb na zaslonu za narudžbe (tekst automatski bijel ili taman radi čitljivosti).
• Redoslijed mijenjaš povlačenjem kategorije ili proizvoda za ≡. To radi mišem i prstom na tabletu. Upravo taj redoslijed zatim se prikazuje na zaslonu za narudžbe; otvoreni zasloni blagajne odmah se sami ažuriraju.
• Brisanje uklanja proizvod iz blagajne, ali stare narudžbe i fiskalni dnevnik i dalje poznaju proizvod. Kategoriju možeš izbrisati tek kad je prazna.
• Opcije: otvori proizvod ili kategoriju i pod "Opcije" dodaj grupe opcija, kao što su "Način pečenja" (točno jedna, obavezno), "Umak" (najviše jedan) ili "Dodatno" (više njih, s minimumom i maksimumom; prazan maksimum = neograničeno). Svaka opcija ima naziv i nadoplatu (smije biti negativna, npr. -0,50). Grupe opcija kategorije vrijede za sve proizvode u toj kategoriji, uz vlastite opcije proizvoda. Redoslijed s ▲▼. Brisanje je uvijek moguće: postojeće narudžbe i računi sami čuvaju odabrane opcije. Poslužitelj također provjerava obavezne opcije i maksimum.
• Fotografija po proizvodu: vidi Fotografije proizvoda.
• Cijena po kilogramu, PLU broj i tara (samo kad je vaga uključena): vidi Postavljanje vage. Bez kvačice proizvod ostaje po komadu.

Fotografije proizvoda

Svaki proizvod može imati fotografiju.

• Postavljanje fotografije: Postavke → Proizvodi → odaberi proizvod → Odaberi fotografiju (na tabletu ili telefonu možeš odmah koristiti i kameru). Fotografija se u pregledniku smanjuje na najviše 512 × 512 piksela (JPEG, obično 20–80 kB) i odmah sprema; Druga fotografija je zamjenjuje, Izbriši fotografiju je uklanja. U popisu proizvoda ispred naziva stoji mala fotografija. Samo s ovlasti Upravljanje proizvodima; jpg, png i webp, najviše 512 kB.
• Prikaz bira administrator pod Postavke → Objekt → Fotografije proizvoda, neovisno jedno o drugom i zadano isključeno:
  • Fotografija proizvoda na gumbima zaslona za narudžbe: fotografija na vrhu gumba proizvoda, s nazivom i cijenom ispod.
  • Fotografija proizvoda uz proizvode na zaslonu za kupce: mala fotografija ispred svake stavke na zaslonu za kupce (i sam zaslon za kupce mora biti uključen). Proizvodi bez fotografije ostaju kakvi jesu; ako je isključeno, sve radi točno kao prije.

Skener crtičnog kôda

Skenerom crtičnog kôda na blagajni skeniraš proizvode, kodove za popust, kartice vjernosti i poklon-bonove. Uključuje se u Postavke → Skener (kartica uz pisače i vagu; zadano isključeno). Označi što skeniranje radi na zaslonu za narudžbe:

• Proizvod na račun: proizvod s tim kodom (Postavke → Proizvodi, polje Kod; npr. EAN crtični kôd s pakiranja). Kod izbora, menija ili cijene po kilogramu najprije se otvara prozor za izbor ili vaga, isto kao pri dodiru. Isto radi i Skeniranje na zaslonu za narudžbe kod Ispis etiketa; to i dalje radi kao i dosad.
• Kod za popust na račun (ako su kodovi za popust uključeni).
• Kartica vjernosti: kupac s tim brojem kartice dolazi na račun (ako je kartica vjernosti uključena). Ako skeniraš nepoznat kod na računu s kupcem, blagajna pita je li to njegova nova kartica.
• Poklon-bon ili prepaid kartica: blagajna prikazuje saldo (ako su poklon-bonovi sa stanjem uključeni). Plaća se putem Naplati → Poklon-bon; tamo možeš i skenirati bon.

Blagajna najprije traži među proizvodima, zatim među karticama vjernosti, poklon-bonovima i kodovima za popust. Skeniranje radi na zaslonu za narudžbe kad nisi u polju za unos. U polju za unos kod jednostavno ide u to polje.

Test skenera: u Postavke → Skener pri svakom skeniranju vidiš kod i što blagajna radi s njim, čak i dok je skener još isključen. Ako ne radi:

• Postavi skener na tipkovnicu (USB-HID), s Enter nakon koda. Kod većine skenera to je već tako.
• Ugrađeni skener (npr. Sunmi blagajne) postavljaš u postavkama skenera uređaja na unos s tipkovnice.
• Etikete s vage TS6X (težina i cijena) obrađuje sama vaga, i kad je skener uključen.

Na kiosku skener postavljaš zasebno (Postavke → Objekt → Kiosk); vidi Samoposlužni kiosk.

Ispis etiketa

Etikete artikala s nazivom, cijenom i crtičnim kôdom, na pisaču etiketa (Brother, Dymo, Zebra ...) instaliranom na računalu ili tabletu. Uključuje se pod Postavke → Objekt → Ispis etiketa (zadano isključeno). Ondje biraš i format etikete (38 × 25, 57 × 32, 62 × 29 ili 100 × 50 mm) te hoće li se na nju ispisati cijena i crtični kôd. Ispiši primjer ispisuje jednu probnu etiketu.

• Postavke → Proizvodi → (proizvod) → Etikete: odaberi količinu i Ispiši.
• Nabava → (primljena narudžba) → Ispis etiketa: za svaki proizvod onoliko etiketa koliko je stiglo (primljene jedinice narudžbe × količina po jedinici narudžbe; bez sastojaka). Najviše 500 etiketa odjednom.
• Blagajna otvara dijalog za ispis: ondje odaberi pisač etiketa i format papira role. Svaka etiketa je jedna stranica.
• Crtični kôd je kod proizvoda (Postavke → Proizvodi): 8 ili 13 znamenki s ispravnom kontrolnom znamenkom = EAN (12 znamenki: kontrolna znamenka se dodaje), inače Code 128 (slova, znamenke i interpunkcija, do 30 znakova). Bez koda nema crtičnog kôda.
• Skeniranje na zaslonu za narudžbe (kvačica, zadano isključeno): skener crtičnog kôda koji radi kao tipkovnica dodaje proizvod s tim kodom, s uobičajenim izborima (opcije, vaga, alergija). Ne zajedno s vagom TS6X, koja ima vlastite etikete s težinom i cijenom.
• Pravo: Upravljanje proizvodima ili Upravljanje zalihama.

Postavljanje vage (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)

Zasebna kartica Postavke → Vaga (ovlast Postavljanje objekta, plaćanja i pisača, zadano samo administrator; kartica uvijek postoji, čak i ako je vaga još isključena). Zadano isključeno: tada blagajna radi točno kao prije. Ne vidiš karticu?

Automatsko traženje. Ako još ništa nije postavljeno, blagajna sama traži kad otvorite ovaj odjeljak (gumb Traži to radi ponovno):

• radi li blagajna (poslužitelj) sama na Aclas PC ili AI vagi (TS6X, TS3X, TS5EX/NX/GX, iS6X, iS2X, iR6X, Ti6X, iL8X; marka/model uređaja: Windows putem WMI, Android putem getprop, Linux putem DMI) i odgovara li Aclas Scale Module? Tada se ta vaga postavlja kao Na ovom uređaju, a i kao vaga za etikete; na Linuxu (nema Scale Module) ugrađena vaga na pronađenom internom priključku (/dev/ttyS...) kao "TS6X (ingebouwd)", s pripadajućim modelom;
• je li OS6X spojena na COM/USB priključak? Svaki se priključak isprobava na 9600, 4800, 2400 i 19200 bauda: najprije kratko slušanje (kontinuirano), zatim slanje W (Toledo), a inače Dialog 06 (9600, 7 podatkovnih bitova, neparni paritet: upit statusa).

Pronađeno = upisano u obrazac gumbom Uključi i koristi: jedan dodir i radi. (Traženje šalje W na svaki slobodni COM priključak; zauzeti priključak, npr. od POS terminala za kartice, preskače se.)

Sve Aclas vage. Za svaku vagu odaberete model; blagajna tada zna kako se može spojiti. Postoje dvije vrste:

• Na ovom uređaju (postavlja se jednom): blagajna radi na vagi (PC ili AI vaga). Na Windowsu ili Androidu važe putem Aclas Scale Module, bez priključka, brzine ili protokola; na Linuxu (nema Scale Module) putem internog priključka vage (obično /dev/ttyS0 ili /dev/ttyS1), s priključkom, brzinom i protokolom. Takva je samo jedna po blagajni; Traženje je pronalazi samo. PC ili AI vaga (TS6X, iS6X ...) uvijek je Na ovom uređaju: na popisu može biti samo jednom, a ostali PC/AI modeli tada se više ne mogu odabrati. TS6X negdje drugdje u objektu ipak može ispisivati etikete (tada uključite samo Skeniranje etiketa).
• Spojene (više odjednom): vaga je s poslužiteljem blagajne povezana kabelom (RS232/USB), Bluetoothom ili mrežom. Koliko god treba (najviše 8), svaka sa svojim nazivom.

Jedan popis, dvije kvačice. Sve su vage na jednom popisu. Za svaku vagu uključite što radi: Vaganje na blagajni (blagajna traži težinu pri naručivanju) i/ili Skeniranje etiketa (vaga ispisuje etiketu s crtičnim kodom koju blagajna skenira i dobiva PLU-ove od blagajne). PC ili AI vaga poput TS6X može oboje; LS vaga za etikete samo etikete. Etikete mogu dolaziti s jedne vage po objektu.

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 i Zebra. Uključeni su uobičajeni modeli tih marki za koje je utvrđeno kako blagajna s njima komunicira (za testiranje = protokol nije doslovno naveden ni u jednom izvoru; blagajna bira najvjerojatniji). Svi povezani (više njih istodobno) ili kao vaga za etikete čiju etiketu blagajna skenira:

• A&D EK-i i HV-WP: postavite vagu na stream (EK-i: prt 0; tvornički je postavljena na tipku PRINT), a blagajnu na Kontinuirano s 2400 bauda i 7E1 (tako je A&D tvornički postavljen). Poruka je ST,+00512.00 g (US = pomiče se, OL = preteško).
• Adam Equipment Swift: postavite vagu na kontinuirano na PC (8N1); blagajna je tada na Kontinuirano.
• Avery Berkel FX110, FX120 i FX131: na vagi odaberite protokol Mettler Toledo 82/7 i postavite blagajnu na Zatraži (Toledo) uz 7E1 (9600 bauda). Radi i Dialog 06. FX125 (s prikazom cijene) nema Toledo: ondje Dialog 06. Blagajna to sama postavi kad odaberete model.
• Avery Weigh-Tronix 7820, 7829 i ZP900 te Brecknell 6702U, 6710U i 6720U: NCI, protokol tvrtke Weigh-Tronix. Blagajna šalje W (kao kod Toleda), vaga odgovara težinom ( 1.234KG) i retkom stanja; on pokazuje pomiče li se, je li preteško ili prelagano. Blagajna je na Zatraži (Toledo) s 7E1 (9600 bauda). USB radi kao virtualni COM priključak. Kod ZP900 postavite blagajnu na priključak 2 (NCI). Kod 67xxU na vagi se može odabrati i 8213 (SCP03).
• Balanzas Marques BM1000P TOP: na COM priključku odaberite protokol B (METTLER) i 9600 bauda, 7 podatkovnih bitova, parni paritet; blagajna je tada na Zatraži (Toledo) uz 7E1.
• Baxtran TW, VW, XTA i XTA-P (vage s izračunom cijene; VW i XTA-P sa stupom): u izborniku RS232 vage odaberite protokol Toledo, 9600 bauda i 7 podatkovnih bitova s parnim paritetom (7E1); blagajna je tada na Zatraži (Toledo) uz 7E1. Blagajna to sama postavi kad odaberete model. Radi i CONT (vaga sama šalje): tada postavite blagajnu na Kontinuirano s istom brzinom i podatkovnim bitovima. Spajanje kabelom RS232 (9-pinskim) ili kabelom USB-RS232.
• Bizerba CS 300: Checkout-Dialog 06 (Bizerbina specifikacija): blagajna šalje cijenu po kilogramu, ovjerena vaga izračunava iznos. Ako vaga traži kontrolne kodove, dobit ćete ih od Bizerbe ili dobavljača.
• CAS PD-II, PDN, PDI i PDS-B (PDS-B npr. kod LRE): na vagi odaberite ECR type 2 (Toledo), a blagajnu postavite na Zatraži (Toledo) s 7E1 (9600 bauda).
• Datalogic Magellan 9300i, 9400i i 9800i: postavite Scale Interface Type zasebnog priključka za vagu na Mettler Toledo 8217, a blagajnu na Zatraži (Toledo) s 7E1.
• Dibal KS-400, D-POS 400, G-325 i PI-100: na vagi odaberite protokol Checkout_Dialog06 (protokol 24) te 9600 bauda, 7 podatkovnih bitova, neparni paritet (vrsta parametra 5); blagajna je tada na Dialog 06. D-POS 400 se može spojiti i preko USB-a.
• DIGI DS-781: postavite vagu na Type B / standardna naredba (data transmission 00011); blagajna šalje ENQ i dobiva neto, taru, cijenu po kg i iznos.
• Dini Argeo DFW, DGT i 3590E: postavite serijski priključak na kontinuirano slanje (9600 8N1); blagajna je tada na Kontinuirano.
• Excell Precision TPE (i 4. generacija AM4, FD4-P, FDP4-P, GE4, GEP4): postavite izlaz RS232 na kontinuirano (9600 8N1); blagajna je tada na Kontinuirano.
• Gram XFOC RS, XFOC+ RS i ZFOC RS: protokol Gram (9600 8N1). Blagajna šalje ENQ, vaga odgovara s ACK, blagajna šalje DC1 i vaga šalje težinu: SOH STX S/U/F teken gewicht eenheid BCC ETX EOT (S = stabilno, U = u pokretu, F = greška; BCC = XOR od stanja do mjerne jedinice uključivo). Spajanje preko RS232 ili USB kabelom tvrtke Gram.
• Kern & Sohn RPB i RFC: na vagi postavite Prot = DLG-06 (priključak za blagajnu je opcija 965-419); blagajna je tada na Dialog 06. RFE, IFB i EOC: kontinuirano slanje (8N1), blagajna na Kontinuirano.
• Mettler Toledo Ariva/Viva: postavite vagu na protokol Toledo (8217) a blagajnu na Zatraži (Toledo) uz Podatkovni bitovi / paritet = 7E1 (Mettler: 9600 bauda, 7 podatkovnih bitova, parni paritet; Ariva se može spojiti i preko USB-a kao virtualni COM priključak). Blagajna to sama postavi kad odaberete model.
• Minebea Intec Signum, Combics, Midrics i Puro te Sartorius Entris i Quintix: SBI s automatskim ispisom (9600 8N1); blagajna je tada na Kontinuirano. Poruka je N + 0.512 kg; bez jedinice se još pomiče.
• Ohaus Aviator 7000: u postavkama vage (korak 20) odaberite protokol Dialog 06; blagajna je tada na Dialog 06. RS232 ili USB, ovisno o kabelu.
• Ohaus Valor 7000, Ranger 3000/4000/7000 i Defender 3000 (vaganje bez cijene): postavite vagu na Auto Print Continuous (9600 bauda, 8N1) a blagajnu na Kontinuirano. Vaga šalje 0.512 kg G; ? iza težine znači da se još pomiče. Ranger 7000 se može spojiti i preko Etherneta (TCP priključak 9761).
• Precia Molen DP400, DPOS CR i C 210 (trgovačke vage od 2025. pripadaju tvrtki Dibal): Dialog 06 (9600 7O1), kao Dibal. Ako kod C 210 ne radi, pokušajte Zatraži (Toledo) s 7E1.
• Precisa XB, XT, LS i LX: postavite način ispisa na CONTINUOUS i 9600 8N1, bez datuma, vremena i ID-a u retku; blagajna je tada na Kontinuirano. Bez jedinice težina se još mijenja.
• Rice Lake BenchPro BP-S (Toledo 8213) i BP-R (NCI): blagajna je na Zatraži (Toledo) s 7E1.
• Star Micronics mG-T i mG-S8200: preko RS232 ili USB-a (virtualni COM priključak, s upravljačkim programom tvrtke Star) na Kontinuirano.
• UWE ASEP: RS232 prema PC-u/blagajni, blagajna na Kontinuirano (za testiranje).
• Wedderburn TSDS983, TSDS781T i TSDS782T su DIGI vage pod vlastitom oznakom: DIGI (Type B), kao DIGI DS-781. Ako to ne radi, pokušajte Zatraži (Toledo) s 7E1.
• Wintec ScalePOS ACS-S60E: blagajna radi na samom ScalePOS-u; ugrađena vaga je na COM6 (Windows) ili COM4 (Android), 9600 8N1. Odaberite Kontinuirano; ako ništa ne šalje, Pretraži pronalazi pravi protokol.
• Zebra MP7000 i MP72: priključak RS232-AUX tvornički je postavljen na SASI (9600 7E1, blagajna šalje W): blagajnu postavite na Zatraži (Toledo) s 7E1.
• Vage za etikete tih marki (Avery Berkel, Balanzas Marques, Bizerba, CAS, Dibal, DIGI, Ishida, Mettler Toledo, Precia Molen, Rongta, T-Scale, Wedderburn) samostalni su sustavi s vlastitom PLU datotekom. Uključite Skeniranje etiketa za vagu i postavite isti crtični kod kao na vagi (EAN-13, početak 20–29, PLU i težina ili cijena). PLU-ove postavljate na samoj vagi ili softverom marke; Pošalji na TS6X i Preuzmi PLU datoteku postoje samo za Aclas.

Isti popis nalazi se u blagajni pod Postavke → Vaga → Sve vage (ACLAS_MODELLEN u packages/shared/src/weegschaal.ts, s markom za svaki model).

Što manje upisivanja: kad odaberete model, blagajna pripremi ostalo kako ga marka tvornički postavlja: priključak COM priključak / USB na prvom slobodnom priključku, 9600 bauda (A&D: 2400) i protokol marke (Toledo: Aclas s 8N1, a s 7E1 Avery Berkel FX, Avery Weigh-Tronix, Balanzas Marques, Baxtran, Brecknell, CAS, Datalogic, Mettler Toledo, Rice Lake i Zebra; Dialog 06: Avery Berkel FX125, Bizerba, Dibal, Kern & Sohn RPB/RFC, Ohaus Aviator i Precia Molen; DIGI Type B: DIGI i Wedderburn; Gram: Gram; Kontinuirano: A&D, Adam Equipment, Dini Argeo, Excell Precision, ostale Kern & Sohn, Minebea Intec, ostale Ohaus, Precisa, Sartorius, Star Micronics, UWE i Wintec) te naziv (npr. OS6X, OS6X 2). PC ili AI vaga postaje Na ovom uređaju (npr. TS6X (ingebouwd); na Linuxu na unutarnjem priključku /dev/ttyS0). Ako nešto nije u redu, Pretraži pronalazi pravi priključak, brzinu i protokol.

Na ovom uređaju (Aclas Scale Module): vaga prikazuje ovjerenu težinu; blagajna šalje cijenu po kilogramu i taru (kao prethodnu taru) i preuzima iznos koji izračuna vaga, kao i kod Dialog 06.

• Android: Aclasova aplikacija AclasScaleDriver (com.aclas.aclasscaledriver) obično je već na vagi; ako nije, instalirajte aclas-android/AclasScaleDriver.apk. Aplikacija HorecaPOS komunicira izravno sa servisom te aplikacije, pa dodatna biblioteka nije potrebna.
• Linux: Aclas nema Scale Module za Linux. Jednostavno odaberite model (npr. TS6X): priključak tada postaje Na ovom uređaju (interni priključak) na /dev/ttyS0, 9600 bauda, Toledo. Ugrađena vaga obično je na /dev/ttyS0 ili /dev/ttyS1; Traženje ih isprobava i upisuje ispravan priključak, brzinu i protokol. I ovdje može biti samo jednom.

Softver tvrtke Aclas dolazi s blagajnom: Scale Module za Windows (aclas-module), AclasScaleDriver za Android (aclas-android) i Aclas Sync SDK za Windows i Linux (aclas-sdk). Aclas nam dopušta da ih isporučujemo. Instalacijski programi za Windows i Linux ih sadrže; ništa ne treba posebno preuzimati ni instalirati.

Bluetooth (npr. OS6X): najprije uparite vagu. Windows od nje napravi COM priključak (Postavke Bluetootha → Više mogućnosti Bluetootha → COM priključci), Linux /dev/rfcomm0: upišite taj priključak. U Android aplikaciji upišite Bluetooth adresu (00:11:22:AA:BB:CC); aplikacija jednom traži dopuštenje za Uređaji u blizini i povezuje se putem Bluetooth SPP.

AI vage (prepoznavanje proizvoda): kamera prepoznaje proizvod u Aclasovom softveru na vagi. Vaganje radi putem Scale Module (na ovom uređaju) ili RS232 priključka; AI vage za etikete nakon prepoznavanja ispisuju etiketu s crtičnim kodom koju blagajna skenira (kao kod TS6X).

Aclas AI Recognition Plugin (AI vaga s blagajnom na njoj, npr. iS6X s Windowsom): Aclasov dodatak prepoznaje proizvod i upisuje njegov crtični kod u blagajnu, baš kao skener (s Enterom nakon toga); zaslon za narudžbe dodaje proizvod s težinom na narudžbu. Ovako ga postavljate:

• Uključite za vagu Skeniranje etiketa s istim crtičnim kodom kao u dodatku. Preporuka: počinje s 27, PLU 5 znamenki, težina (Aclas tip 17): blagajna tada sama računa s cijenom po kilogramu. Može i s cijenom (tip 12, počinje s 22).
• Za tu vagu isključite Vaganje na blagajni: dodatak i Scale Module ne mogu istovremeno pristupiti vagi. Težina dolazi iz crtičnog koda. Ako dodatak odgovori pri Traži, blagajna predlaže takvu postavku i ne pokreće Scale Module. Bez aktivacijskog koda dodatak važe i izračunava iznos, ali ne prepoznaje proizvode.
• U samom dodatku: crtični kod pod Scale and Barcode Format Settings → Default Barcode Format (tip 17), a u postavkama prozora točka na koju dodatak klikne i upiše kod. Za to odaberite prazno mjesto na zaslonu za narudžbe, ne gumb. Nove proizvode objekt sam uči dodatak na vagi (AI treniranje).
• Dodijelite vaganim proizvodima PLU broj i pošaljite PLU-ove na vagu (Pošalji na TS6X ili PLU datoteka); dodatak prepoznaje po PLU broju.
• Blagajna dopušta dodatku prepoznavanje samo dok je zaslon za narudžbe otvoren na samoj vagi (POST /aiplugin/resume, pri zatvaranju /aiplugin/suspend, port 5003 na vagi; prvi put i EmployeeMode: zaslon za kupce na vagi ne prikazuje proizvode). Na drugim blagajnama i tabletima te putem administratorskog portala ne događa se ništa.
• Dodatak se uvijek pokreće u načinu Resume i ne može javiti svoje stanje. Zato zaslon za narudžbe svakih 30 sekundi ponovno šalje resume; ako to izostane (zaslon zatvoren, dodatak ili vaga ponovno pokrenuti), blagajna u roku od minute prebacuje dodatak na Suspend i drži ga tako.
• Dodatak traži aktivacijski kod od Aclasa po vagi (vezan uz serijski broj). Sada radi na Windowsu; Aclasova verzija za Android slijedi (blagajna ondje radi isto).

Aclas OS6X (POS vaga na blagajni, RS232/USB; tako rade i ostale spojene vage):

• Jedna ili više vaga (najviše 8), svaka s nazivom (npr. Pult, Šank) i vlastitim priključkom: COM priključak / USB (COM3 na Windowsu, /dev/ttyUSB0 na Linuxu/Androidu) s brzinom ili mreža putem serijsko-mrežnog pretvarača (IP adresa i TCP port, npr. 4001).
• Protokol: Zatraži (Toledo) = blagajna šalje W i vaga odgovara težinom (Toledo 8217, tako je OS6X obično postavljena; i poruke stanja nestabilno/preopterećenje/ispod nule) ili Kontinuirano = vaga sama stalno šalje težinu (ST,GS, 0.512kg, US = nestabilno) ili Dialog 06 (baždareno), vidi dolje, ili DIGI (Type B) = blagajna šalje ENQ a DIGI odgovara stanjem, neto, tarom, cijenom po kg i iznosom (37 znakova: <status> <toestand> CR 0<netto> CR 4<tarra> CR U<kiloprijs> CR T<bedrag> CR LF; stanje bit 1 = stabilno, bit 2 = ispod nule, bit 3 = preteško, bit 4 = prelagano), ili Gram = blagajna šalje ENQ, čeka ACK, šalje DC1 i čita SOH STX <S/U/F> <teken> <gewicht> <eenheid> <BCC> ETX EOT. Na vagi postavite isti protokol i brzinu. Podatkovni bitovi / paritet: 8N1 (Aclas, Adam Equipment, DIGI, Dini Argeo, Excell Precision, Gram, Kern & Sohn, Minebea Intec, Ohaus, Precisa, Sartorius, Star Micronics, UWE, Wedderburn, Wintec) ili 7E1 (A&D, Avery Berkel, Avery Weigh-Tronix, Balanzas Marques, Baxtran, Brecknell, CAS, Datalogic, Mettler Toledo 8217, Rice Lake, Zebra); Dialog 06 je uvijek 7O1. Zatraži čita i NCI (Avery Weigh-Tronix, Brecknell, Rice Lake BP-R): na W vaga odgovara LF 1.234KG CR LF S00 CR ETX; redak stanja (S + 2 ili 3 bajta) pokazuje pomiče li se (bajt 1 bit 0), je li prelagano (bajt 2 bit 0) ili preteško (bajt 2 bit 1); ^^^^^ = preteško, _____ = prelagano.
• Dialog 06 (Checkout-Dialog 06, europski protokol za ovjerenu vagu spojenu na blagajnu): blagajna šalje cijenu po kilogramu (i taru proizvoda) vagi; vaga važe, sama izračunava iznos i prikazuje cijenu po kilogramu, težinu i iznos na vlastitom (ovjerenom) zaslonu. Blagajna preuzima težinu i iznos; u prozoru vaganja piše "izračunala vaga". Uvijek 9600 bauda, 7 podatkovnih bitova, neparni paritet, 1 stop bit (brzina u postavci tada se ne uzima u obzir). Tijek: EOT STX 01 ESC <kiloprijs 6> ESC ETX (s tarom: zapis 03 s 4 znamenki grama) → 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 = još nije spremno, tada ponovno nakon 100 ms; 20 = pomiče se; 21 = najprije podignite; 30/31 = prelagano; 32 = preteško; 11 = nevažeća cijena). Kontrolni kodovi: mnoge Dialog 06 vage povremeno (npr. svakih 30 vaganja) traže kontrolne kodove softvera blagajne (zapis 11 → zapis 10). Te kodove i način njihova izračuna proizvođač vage daje samo dobavljaču blagajne. Upišite ih pod Kontrolni kodovi (parovi od 4 heksadecimalna znaka, npr. 74AE 1B2C); blagajna ih šalje kad ih vaga zatraži. Ako vaga računa s promjenjivim brojem (Z) pa fiksni kodovi ne odgovaraju, blagajna to javlja; tada zamolite dobavljača da vagu postavi bez ove provjere ili koristite Toledo.
• Vage su spojene na računalo ili uređaj na kojem radi poslužitelj blagajne; sve blagajne i tableti važu putem poslužitelja blagajne i u prozoru vaganja biraju koju vagu koriste. Testiraj važe jednom.
• Mreža radi svugdje.
• Težinu unesi i ručno: uključeno = težina se može ručno unijeti i kad postoji vaga; bez OS6X to je uvijek moguće.

Skeniranje etiketa (kvačica uz vagu: Aclas TS6X, druga PC ili AI vaga, serija LS ili LH15X; vaga + pisač etiketa, jedna po objektu):

• IP adresa: potrebna samo za Pošalji na TS6X. Vaganje i skeniranje etiketa rade i bez nje. Ako blagajna radi na samoj TS6X, ostavite prazno: blagajna tada šalje sama sebi (127.0.0.1). Ako ista vaga važe i na blagajni, obje su kvačice uz istu vagu (Traženje to tako postavlja).
• Skeniranje etiketa: skeniranje etiketa na zaslonu za narudžbe. Postavite izgled crtičnog koda, isto kao na TS6X: počinje s (20–29, zadano 28), broj znamenki za PLU (4, 5 ili 6), zatim težina u gramima ili cijena u centima, plus kontrolna znamenka (EAN-13). Ispod postavke prikazan je primjer.
• PLU brojevi: u Postavke → Proizvodi proizvod koji se važe dobiva cijenu po kilogramu, po potrebi taru i PLU broj (jedinstven). PLU broj birate s popisa (Bez PLU-a, sljedeći slobodni, Drugi broj…); kad označite Cijena po kilogramu, sljedeći slobodni broj već je upisan. Potrebno samo za etikete i PLU-ove TS6X: bez TS6X može ostati Bez PLU-a.
• Izravno slanje radi na Windowsima i Linuxu; na Androidu i macOS-u koristite PLU datoteku. Pri prvoj instalaciji provjerite nazive polja PLU datoteke i kodove u aclas-plu.ps1 prema SDK priručniku isporučene vage (jedno mjesto za prilagodbu: ACLAS_PLU_KOLOMMEN u packages/shared/src/weegschaal.ts).

Portal za upravljanje: poruka portalu ima funkciju Vaga (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) s uključeno/isključeno i vagama po modelu (npr. TS6X (op dit apparaat), 2x OS6X, PS1CX, Ariva-S, DS-781, LS6RX, 5 producten per kilo); bez IP adresa, COM priključaka ili Bluetooth adresa.

Zakon o mjeriteljstvu: vaga na kojoj prodajete mora biti ovjerena (klasa III, kao OS6X). S Toledo/kontinuiranim protokolom blagajna računa s težinom koju daje vaga; s Dialog 06 ovjerena vaga sama računa cijenu.

Kôd: packages/shared/src/weegschaal.ts (protokoli, etikete, PLU datoteka), apps/pos-server/src/lib/weegschaal.ts i routes/weegschaal.ts; zasloni WeegschaalInstellingen.tsx i WeegDialoog.tsx.

Thuisbezorgd.nl / Takeaway.com

Narudžbe s Thuisbezorgd.nl stižu izravno u blagajnu, bez posrednika (bez Deliverecta, HubRisea i sl.): Just Eat Takeaway JET Connect komunicira s administratorskim portalom tvrtke Pin Voordeel, a blagajna ondje preuzima svoje poruke.

U Belgiji se platforma zove Takeaway.com: ista tvrtka (Just Eat Takeaway) i ista integracija. Za belgijski objekt na zaslonima, u obavijestima, na radnom nalogu i u administratorskom portalu svugdje piše Takeaway.com umjesto Thuisbezorgd.nl. U nastavku Thuisbezorgd označava oboje.

Zašto preko portala? Blagajni trebaju samo PORTAAL_URL i PORTAAL_SLEUTEL (vidi Administratorski portal) i šalje samo odlazne zahtjeve.

Postavljanje (Postavke → Platforme za dostavu → Thuisbezorgd.nl / Takeaway.com, ovlast Postavljanje objekta, plaćanja i pisača; dosad je to bilo pod Postavke → Objekt):

1. Uključite Koristi Thuisbezorgd (primjenjuje se odmah, neovisno o Spremi).
2. Prijavi se na Thuisbezorgd. Objekt zatim kod Thuisbezorgda (Partner Hub ili account manager) odabire OptimumPOS / Pin Voordeel kao blagajnu. JET tada pokreće sesiju uključivanja; portal pronalazi prijavljenu blagajnu (po poštanskom broju i nazivu, inače Pin Voordeel ručno povezuje sesiju u portalu), šalje konfiguraciju i traži od blagajne jelovnik. Nakon toga integracija postaje aktivna.
3. Označite proizvode koji se mogu naručiti putem Thuisbezorgda (po grupi ili pojedinačno), po potrebi s opisom za Thuisbezorgd. Jelovnik (cijena, opcije kao modifikatori, alergeni, PDV) prenosi se automatski; PLU = id proizvoda/opcije. Nakon promjene u katalogu blagajna ažurira jelovnik u roku od 30 sekundi; samo "rasprodano"/"ponovno dostupno" ide putem API-ja za dostupnost.
4. Radno vrijeme Thuisbezorgd: posebno za dostavu i za van (npr. 16:00-22:00, više blokova odvojenih zarezom). Spremaju se gumbom Spremi radno vrijeme ispod i šalju se kao service times na Thuisbezorgd čim povezivanje bude spremno.
5. Privremeno zatvoreno / Ponovno otvoreno (u NL/BE najkasnije sljedeće jutro u 07:00 ponovno otvoreno).

Narudžbe. Narudžba postaje obična narudžba bez stola (bezorgen ili afhalen, naziv grupe TB <ordernummer>) s cijenama koje je kupac platio, plus troškovi dostave/usluge kao zasebna stavka i popust Thuisbezorgda kao stavka popusta; ako se ukupni iznos ipak ne poklapa, dodaje se stavka "Verschil Thuisbezorgd". Radni nalog odmah ide u kuhinju/šank (može se isključiti). Blagajna u roku od nekoliko sekundi potvrđuje portalu, koji to javlja JET-u; ako to ne uspije u roku od 3 minuta ili je blagajna offline, JET dobiva "neuspjelo" i objekt se vraća na Orderpad.

Gumb Thuisbezorgd u gornjoj traci (s brojem narudžbi u tijeku): popis, kupac i adresa, vrijeme spremnosti/dostave i vremenska crta (track & trace): primljeno, dostavljač na putu do objekta, dostavljač u objektu, na putu do kupca, dostavljeno (od JET-a), plus vlastiti koraci (u pripremi, spremno, na putu/dostavljeno kod vlastite dostave, preuzeto). Kartu uživo s dostavljačem JET Connect ne nudi blagajni; nju kupac vidi u aplikaciji Thuisbezorgd. Nova narudžba, otkazivanje i "dostavljač u objektu" daju narančastu traku i zvuk. Završi (plaćeno online) naplaćuje s načinom plaćanja online; ako kupac plaća na vratima, jednostavno naplatite. Otkazivanje s Thuisbezorgda poništava narudžbu i ispisuje radni nalog "OTKAZANO".

Kôd: apps/pos-server/src/lib/thuisbezorgd.ts, routes/thuisbezorgd.ts; zasloni ThuisbezorgdInstellingen.tsx i Thuisbezorgd.tsx. Strana portala: horecapos-portaal/src/thuisbezorgd.mjs (vidi README portala).

Brojanje u administratorskom portalu. Broj Thuisbezorgd narudžbi po danu šalje se u prijavi administratorskom portalu (verkoopTelling u lib/portaal.ts): primljene i neotkazane, na dan primitka. Thuisbezorgd narudžba koja se naplati na blagajni (i Završi (plaćeno online)) tamo se ne broji još jednom kod preuzimanja/dostave. Podaci Thuisbezorgda nalaze se u bazi podataka blagajne i stoga su normalno uključeni u sigurnosne kopije blagajne.

Web-trgovina i online naručivanje

Svaki objekt može dobiti vlastitu web-trgovinu: stranicu za naručivanje (i aplikaciju) u vlastitom vizualnom identitetu za za van, dostavu, naručivanje za stolom putem QR koda i rezervacije, s online plaćanjem (MultiSafepay ili Buckaroo) ili plaćanjem pri preuzimanju/dostavi. Web-trgovina je zaseban projekt, horecapos-webshop (Node.js, vidi README tamo), i radi na istom poslužitelju kao administratorski portal.

Uključivanje i postavljanje obavlja se u upravljanju web-trgovinom: gumb Upravljaj web-trgovinom u portalu za korisnike (vlasnik) ili kod instalacije u administratorskom portalu (Pin Voordeel). Tamo su uključivanje/isključivanje, web-adresa (<zaak>.<webshopdomein> ili vlastita domena), vizualni identitet (boje, logo, naslovna fotografija, font), radno vrijeme i termini za preuzimanje i dostavu, područje dostave (poštanski brojevi, radijus ili područje na karti, s troškom i minimumom), plaćanje, kodovi za popust, tekstovi, jezici, QR kodovi za stolove, rezervacije i aplikacija (može se instalirati kao PWA; Android aplikacija putem Trusted Web Activity) te push obavijesti (neobavezno, zadano isključeno): gost na stranici svoje narudžbe uključuje obavijest i dobiva push obavijest kad je narudžba spremna ili na putu; tko želi, povremeno dobiva i ponudu koju objekt šalje iz upravljanja web-trgovinom (kartica Push obavijesti). Radi na Androidu i računalima (Chrome, Edge, Firefox, Samsung Internet), u Android aplikaciji te na iPhoneu i iPadu (iOS 16.4 ili noviji) ako gost doda web-trgovinu na početni zaslon. Ne šalje se SMS ni e-mail i ne sprema se ime ni broj. Pojedinosti u README-u web-trgovine.

Meni. Blagajna sama šalje meni: sve aktivne proizvode (ne po kilogramu), po grupi proizvoda, s cijenom, opcijama, alergenima, rasprodano i fotografijom proizvoda, plus stolove i podatke objekta te koji su marketinški kanali uključeni (za kvačicu "primati ponude" pri plaćanju, vidi SMS i e-mail marketing). To se događa pri pokretanju, čim se web-trgovina uključi, unutar 30 sekundi nakon promjene u katalogu i unutar nekoliko sekundi nakon promjene u Postavke → Objekt, poput marketinga ili kartice vjernosti (ili s Pošalji meni sada). Proizvod se može isključiti iz web-trgovine u upravljanju web-trgovinom (sakrij) ili u bazi podataka s artikel.webshop = false.

Narudžbe. Za van i dostava postaju obična narudžba bez stola (naziv grupe WEB <bestelnummer>) s cijenama koje je gost vidio, plus trošak dostave i troškovi transakcije kao zasebne stavke te kod za popust kao stavka popusta; ako se ukupni iznos ipak ne slaže, dodaje se stavka "Verschil webshop". Napojnica gosta ne računa se kao promet: ona ide kao napojnica u plaćanje kod Završi (plaćeno online). Naručivanje za stolom (QR kod) ide na otvoreni račun tog stola (plaćeno online: kao zasebna grupa za tim stolom). Radni nalog odmah ide u kuhinju/šank (može se isključiti u prozoru Web-trgovina). Blagajna u roku od nekoliko sekundi potvrđuje brojem računa; gost tada dobiva "primljeno" i e-mail. Ako je blagajna offline, web-trgovina ne prima narudžbe (gost to odmah vidi) i šalje e-mail objektu ako narudžba predugo čeka. Rezervacije iz web-trgovine dolaze u Rezervacije (samo ako su rezervacije u blagajni uključene). Ako je postavljen maksimum po terminu (Dostava i termini), ubrajaju se i narudžbe iz web-trgovine s vremenom u tom terminu.

Belgija (crna kutija). Narudžba iz web-trgovine odmah ide kao narudžba (signOrder) u crnu kutiju, prije radnog naloga, isto kao Naruči na blagajni. Ako to ne uspije, ne ulazi u blagajnu, a web-trgovina je kasnije ponovno šalje. Ono što još nije testirano s crnom kutijom isključeno je u meniju za web-trgovinu (poklon-bonovi, kodovi za popust, na račun, na sobu, meniji, opcije s nadoplatom, happy hour i napojnica) i odbija se ako ga stara web-trgovina ipak pošalje. Završi provjerava napojnicu, plaćanje na račun i na sobu kao i blagajna.

Na sobu (hotelska veza, Postavke → Hotel → Samoposluga → U web-trgovini): meni dobiva kamer: { maxBedrag }; web-trgovina šalje betaling.wijze = "kamer" s kamer i achternaam. Blagajna provjerava gosta u hotelskom softveru (ne za stolom, ne s poklon-bonom) i sprema ga uz narudžbu; Završi (na sobu) naplaćuje na sobu i knjiži račun na hotelski račun. Zbirni račun kod plaćanja na račun: račun tada ostaje kao otvorena stavka.

Gumb Web-trgovina u gornjoj traci (s brojem aktivnih narudžbi): popis, kupac i adresa, željeno vrijeme ili "što prije", način plaćanja i vremenska crta. Korake U pripremi, Spremno i Na putu gost vidi uživo u web-trgovini (i e-poštom, ako objekt to želi). Naplaćeno na blagajni = Završeno; Odustani poništava samo stavke te narudžbe iz web-trgovine, ispisuje radni nalog "OTKAZANO", a online plaćenu narudžbu web-trgovina vraća. Stigao, nije došao ili otkazano kod rezervacije također se vraća web-trgovini. Nova narudžba ili rezervacija prikazuje narančastu traku i zvučni signal.

Kôd: apps/pos-server/src/lib/webshop.ts, routes/webshop.ts; zaslon Webshop.tsx. Strana portala: horecapos-portaal/src/webshop.mjs.

Blagajna i web-trgovina jednako (svaki se dio zasebno uključuje, zadano isključeno; starija web-trgovina zanemaruje nova polja). Što je uključeno na blagajni, radi i u web-trgovini:

• Happy hour: web-trgovina naplaćuje istu cijenu kao blagajna u tom trenutku (precrtana redovna cijena i naziv happy houra), i sa sezonom.
• Razdoblja menija i način narudžbe (ako su uključeni): web-trgovina prikazuje samo ono što je trenutno u prodaji, a kod preuzimanja i dostave cijenu i proizvode tog izbora (za stolom: u lokalu). Meni za svaki proizvod dobiva prijzen (afhalen, bezorgen) i nietBij te popis dagdelen.
• Meniji: gost bira jela (fiksna i po izboru, s njihovim opcijama); na blagajni se pojavljuje kao stavka menija s jelima ispod i raspoređenom cijenom menija (PDV po jelu je točan). Jela koja pripadaju samo meniju šalju se kao menuArtikelen. Stara web-trgovina bez izbora: meni se na računu pojavljuje kao običan proizvod, kao dosad.
• Nema zalihe = rasprodano, i opcije izbora sa sastojkom kojeg više nema.
• Alergeni: isključeni na blagajni = nisu u web-trgovini.
• Kartica vjernosti: gost pri plaćanju može skupljati bodove (na broj telefona ili e-mail); blagajna povezuje kupca s narudžbom, bodovi se dodaju pri naplati (zamjena se obavlja u objektu). Web-trgovina prikazuje stanje.
• Poklon-bonovi (Postavke → Objekt → Poklon-bonovi → Prodaja poklon-bonova u web-trgovini, samo sa stanjem): gost kupuje bon i plaća online; blagajna izrađuje bon, koji je odmah aktivan, a kod se preko portala vraća u web-trgovinu (status i e-mail). Ako je uključen i Poklon-bon kao način plaćanja, gost kod preuzimanja za van može odabrati "poklon-bonom u objektu".
• Kodovi za popust (Postavke → Kodovi za popust, sa sklopkom kod Objekt): za svaki kod na blagajni i/ili u web-trgovini; korištenje se broji zajedno za oboje.
• Pauza i gužva: gumb Web-trgovina u gornjoj traci: Pauziraj web-trgovinu (s tekstom za gosta) i Gužva (dodatne minute). Stiže u web-trgovinu za nekoliko sekundi.
• Online rezervacija prema pravilima blagajne (Postavke → Objekt → Rezervacije): najviše osoba, dana unaprijed, vremenski termin, najmanje unaprijed i vremena po danu u tjednu.
• Dostava i termini: vidi Web-trgovina slijedi blagajnu pod Dostava i termini.
• All-you-can-eat za stolom (Postavke → Lokal → All-you-can-eat → I kod naručivanja za stolom putem QR koda): ako za stolom traje paket, gost vidi jela iz paketa kao Uključeno za € 0, s rundama, maksimumom po osobi, vremenom čekanja i vremenskim ograničenjem. Ostalo plaća normalno; sve ide na račun stola. Ako se stanje za stolom upravo promijenilo, blagajna odbija narudžbu i gost naručuje ponovno.
• Na račun (Postavke → Računi → Plaćanje na račun → I u web-trgovini): vidi U web-trgovini pod Plaćanje na račun.
• Online na listu čekanja (Postavke → Lokal → Lista čekanja): vidi Online na listu čekanja pod Lista čekanja za goste bez rezervacije.
• Dodatna prodaja: "Još nešto uz to?" (neobavezno, zadano isključeno; Postavke → Objekt → Naplati → Dodatna prodaja u web-trgovini): odaberi kategorije (npr. pića, umaci, deserti) i broj prijedloga. U web-trgovini se tada u košarici i pri naplati prikazuju proizvodi iz tih kategorija koji još nisu u košarici (samo ono što je trenutačno u prodaji, nije rasprodano i bez obaveznih izbora); gost ih dodaje jednim dodirom. Nijedna kategorija odabrana = isključeno, kao dosad. Kiosk ima vlastitu dodatnu prodaju (vidi Samoposlužni kiosk).

Meni za web-trgovinu za to ima versie: 2 s poljima menuArtikelen, allergenenAan, happyhours, menus, klantenkaart, cadeaubon, kortingscodes, pauze, drukteMin, volgt, bezetting, reserveren.online, ayce, opRekening, wachtlijst i upsell. Potvrda portalu uz to sadrži cadeaubonnen (kodove), klant (bodove) i plek (listu čekanja).

Brojanje u administratorskom portalu. Za van i dostava preko web-trgovine broje se zasebno (webshop, webshopGeannuleerd u verkoopTelling), na dan primitka, i ne broje se još jednom kod preuzimanja/dostave. Naručivanje za stolom broji se normalno kod stola.

Plaćanje karticom i terminali

Postavke → Plaćanje (samo administrator):

• Terminali: za svaki terminal naziv, ID terminala i vlastiti API ključ iz PinPortala (Klant → Bewerk klant → Overige → API Keys). Nakon spremanja vidljiv je samo kraj ključa; nikad se ne vraća u preglednik. Gumbom Testiraj vezu provjeravate ključ i terminal.
• Testni način: oponaša terminal (nakon ±7 s uspješno; iznos koji završava na 13 centi se odbija). Korisno za testiranje bez POS terminala.

Ako postoji barem jedan terminal s API ključem (ili je uključen testni način), Naplati → Kartica / Bancontact automatski pokreće plaćanje na terminalu, za iznos koji izračuna poslužitelj.

Dok je integracija uključena, poslužitelj prihvaća "karticu" samo uz uspješno plaćanje na terminalu za upravo tu narudžbu i taj iznos. Zahtjevi se, kao u službenom PHP SDK-u, šalju kao običan obrazac, s rezervnim API-jem (api-backup.pinvandaag.com) ako glavni API ne odgovara. Svaki odgovor API-ja prikazan je s [pin] u prozoru poslužitelja, korisno kod smetnji. Uspješno plaćanje koje još nije obrađeno (npr. tablet se ugasio) pronalazi se pri sljedećoj naplati te narudžbe.

Napojnica (kartica, gotovina i poklon-bon)

Na zaslonu za naplatu uz svaki način plaćanja nalazi se red gumba za napojnicu: Ništa, 5%, 10%, 15% (zaokruženo naviše na 10 centi), Zaokruži (na sljedeći cijeli euro) i Drugi iznos. Kod kartice kupac plaća iznos + napojnicu odjednom na terminalu; kod gotovine napojnica se uračunava u ostatak i u blagajničku ladicu. Na računu je plaćeni iznos karticom s "od čega napojnica" ispod; UKUPNO i PDV ostaju isti jer napojnica nije promet. U X/Z izvješću napojnica je prikazana po načinu plaćanja i kao "Ukupno napojnice".

Administrator postavlja gumbe za napojnicu u Postavke → Objekt → Napojnica: uključeno/isključeno, koji postoci (najviše 4, npr. "5, 10, 15"), je li prikazan gumb "Zaokruži" i uz koje načine plaćanja (kartica, gotovina, poklon-bon) je napojnica moguća. "Ništa" i "Drugi iznos" uvijek su ponuđeni.

"Neka bude …" uvijek je prikazano, uz svaki način plaćanja, čak i kad su gumbi za napojnicu isključeni (nema postavke): kupac sam zaokružuje račun naviše, a razlika je napojnica. Postoje gumbi sa sljedećim cijelim eurom i sljedećim okruglim iznosima (npr. € 28,00 → 29, 30, 40; € 44,00 → 45, 50, 60) i Drugi ukupni iznos za ručni unos ukupnog iznosa. Ponovni dodir odabranog gumba = bez zaokruživanja. Najviše € 500 napojnice (ista granica kao na poslužitelju blagajne).

Nema interneta

Blagajna radi u lokalnoj mreži i ne treba internet; treba ga samo plaćanje karticom putem integracije. Ako objekt nema internet, u gornjoj traci piše Nema interneta · kartica ručno (provjerava se svake minute). Na zaslonu za naplatu tada se pojavljuje, kao i nakon neuspjelog pokretanja na terminalu, gumb Već plaćeno karticom na terminalu: naplatite iznos na samom terminalu i tako ga evidentirajte.

Tlocrti i stolovi

Postavke → Tlocrti (samo administrator):

• Dodavanje tlocrta (npr. Dvorana, Terasa, Zimski vrt), preimenovanje, brisanje i promjena redoslijeda s ◀ ▶.
• Dodajte stolove gumbima iznad mreže (okrugli, kvadratni, dugi, barski stol) i povucite ih mišem ili prstom na njihovo mjesto. Plavi kutić odabranog stola povećava ga ili smanjuje.
• Za svaki stol postavite naziv/broj, broj osoba (stolice oko stola se računaju) i oblik; duplicirajte ili izbrišite.
• Tipkovnicom: strelice pomiču (Shift = veći korak), Delete briše.
• Promjene vrijede tek nakon Spremi; "Poništi" sve vraća.
• Stol ili tlocrt s otvorenom narudžbom ne može se ukloniti. Izbrisani stolovi ostaju sačuvani u starim narudžbama.

Prijenos konfiguracije na drugi lokal

Postavke → Uvoz/izvoz (samo administrator). Ako ste jedan objekt potpuno uredili, izvezite konfiguraciju u .json datoteku i uvezite je u blagajnu drugog objekta. Može se birati po dijelu:

• Proizvodi: grupe, proizvodi, cijene (i po načinu narudžbe), PDV, opcije, meniji, happy hourovi (sa sezonom), razdoblja menija, alergeni, sastojci/recepti, kartice s pečatima, all-you-can-eat paketi i fotografije proizvoda.
• Tlocrti: prostorije i stolovi.
• Ostale postavke: sve opcije objekta, pisači (bez IP adrese), ovlasti po ulozi i knjigovodstvo.

Nikad se ne prenose: naziv, adresa, poštanski broj, mjesto, telefon, e-pošta, PDV broj i završni redak računa objekta, adresa e-pošte za Z-izvještaj, kartični terminali i njihovi ključevi, osoblje i PIN-ovi te sav promet, računi, kupci i količine zaliha.

Uvoz je strogo zaštićen: veliko crveno upozorenje, kvačica "Razumijem...", ponovno vlastiti PIN administratora, nema otvorenih narudžbi, ista država (stope PDV-a) i prethodno automatska sigurnosna kopija. Uvoz se odvija u jednoj transakciji: ako nešto pođe po zlu, ništa se ne mijenja. Postojeći proizvodi, grupe, sastojci i stolovi ne brišu se nego se uklanjaju iz blagajne (kao kod Izbriši), tako da stari računi i izvještaji ostaju točni.

Uvoz iz druge blagajne

Prelazak bez ponovnog upisivanja svega. Uvijek dostupno (bez prekidača): u Postavke → Uvoz/izvoz (samo administrator) nalazi se dio Uvoz iz druge blagajne.

• Što: proizvodi (naziv, cijena s PDV-om, PDV, grupa, šifra/PLU, zalihe) ili kupci s kartice vjernosti (ime, telefon, e-pošta, bodovi, adresa, poštanski broj, mjesto; ime i prezime se spajaju).
• Datoteka: izvoz iz tvoje prethodne blagajne (Dobizzz/DoPos, Lightspeed, MplusKASSA, unTill, Tebi ...) ili vlastiti popis: CSV (; , tab ili |; UTF-8 ili nizozemski Excel) ili Excel (.xlsx), prvi list, s nazivima stupaca u prvom retku. Staru .xls datoteku najprije spremi kao .xlsx ili CSV.
• Pregled: blagajna prepoznaje stupce po nazivu (Omschrijving, Verkoopprijs incl. BTW, BTW %, Omzetgroep, Artikelnummer, GSM, Spaarpunten ...) i prikazuje prvih 10 redaka. Ako stupac ne odgovara, odaberi ga sam. Ništa se ne mijenja do Uvezi.
• Proizvodi: cijene kao 3,50, € 3,50 ili 1.234,50; PDV kao 21, 9%, 0,09, visoka ili niska (nepoznato ili prazno: stopa koju odabereš, zadano najviša). Grupe proizvoda koje još ne postoje se stvaraju (bez grupe: "Uvezeno").
• Zalihe (stupac Voorraad, Stock, Aantal ...): ako je Praćenje zaliha uključeno (Postavke → Lokal), proizvod prati zalihe i zaliha postaje ta količina (brojanje u povijesti zaliha, razlog "Uvezeno"). Prazno: zaliha ostaje kakva jest.
• Primjer datoteke (CSV): popis koji sam ispuniš (Naam;Productgroep;Prijs;Btw;Voorraad;Code), na primjer u Excelu.
• Kupci: bodovi se dodaju kao ispravak "Uvezeno iz druge blagajne" (vidljivo u povijesti). Pristanak za SMS ili e-poštu se ne prenosi (GDPR): njega tražiš ponovno. Najprije uključi karticu vjernosti.
• Postojeći proizvodi (ista šifra ili, bez šifre, isti naziv) i kupci (isti telefon ili e-pošta) se preskaču ili ažuriraju ako to označiš (kod proizvoda naziv, cijena, PDV, grupa i zalihe). Dvostruki retci u datoteci uzimaju se samo jednom.
• Na kraju: koliko novih, ažuriranih i preskočenih, uz svaki redak što nije bilo u redu (npr. nema cijene). Najviše 5000 redaka odjednom. U dnevniku stoji kao "Konfiguracija uvezena".

Jezici (42, među ostalima turski, arapski, Darija, berberski, poljski, bugarski, mađarski, ruski, srpski, albanski, perzijski, tigrinja, amharski, somalski, papiamento, sranantongo, hindski, urdski, indonezijski, vijetnamski, sirijski aramejski, kineski i ukrajinski)

Pokraj gumbića © dolje desno na svakom se zaslonu nalazi gumbić s jezikom (npr. NL i zastavica). Dodirnite ga za izbornik: jezici su poredani abecedno, s nazivom na vlastitom jeziku ispred zastave: Bahasa Indonesia (indonezijski), Čeština (češki), Darija (marokanski arapski latinicom), Deutsch, English, Español, Français, Hrvatski, Italiano, Kurdî (kurmanji), Latviešu (latvijski), Lietuvių (litavski), Magyar (mađarski), Nederlands, Papiamentu (papiamento), Polski, Português, Română, Shqip (albanski), Slovenčina (slovački), Soomaali (somalski), Sranantongo, Srpski (srpski, latinicom), Tarifit (rifski berberski), Tiếng Việt (vijetnamski), Türkçe, zatim ćirilicom Български (bugarski), Русский (ruski) i Українська (ukrajinski), potom jezici arapskim pismom: اردو (urdski), الدارجة (darija), العربية (arapski), دری (dari), فارسی (perzijski, farsi), پښتو (paštu) i کوردی (سۆرانی) (kurdski sorani), zatim sirijskim pismom ܣܘܪܝܝܐ (sirijski aramejski, surayt), pismom devanagari हिन्दी (hindski), ge'ez pismom ትግርኛ (tigrinja) i አማርኛ (amharski), tifinaghom ⵜⴰⵎⴰⵣⵉⵖⵜ (tamazight, berberski) i na kraju 中文（简体）(kineski, pojednostavljeno pismo). Svi zasloni, gumbi, obavijesti i poruke o pogreškama poslužitelja blagajne su prevedeni.

• Po zaposleniku: odabrani jezik sprema se uz prijavljenog zaposlenika (gebruiker.taal). Ako se netko prijavi s drugim jezikom, blagajna se odmah prebacuje. Na samom uređaju pamti se zadnji korišteni jezik, tako da je i zaslon za PIN već na tom jeziku. Ako odaberete jezik (na zaslonu za PIN ili prijavljeni) i (ponovno) se prijavite u roku od 10 minuta, taj odabir ima prednost i postaje jezik tog zaposlenika. Promjena ponovno učitava zaslon; ostajete prijavljeni i otvoreni račun ostaje otvoren.
• Prvi put na uređaju: ako na tabletu ili računalu još nema jezika, blagajna se pokreće na jeziku odabranom pri instalaciji. Ako jezik nije odabran, onda na jeziku samog uređaja (preglednik ili operacijski sustav, i u Android aplikaciji), a ako on nije ponuđen, na nizozemskom. Nakon toga svaki uređaj pamti vlastiti odabir.
• Istočna Europa: poljski, češki, slovački, mađarski, rumunjski, bugarski, hrvatski (i za bosanski), litavski, latvijski, ukrajinski i ruski: jezici većine radnika migranata iz Srednje i Istočne Europe u Nizozemskoj i Belgiji.
• Balkan: srpski (latinicom, kako ga piše većina Srba u Nizozemskoj i Belgiji; i za crnogorski) i albanski (Albanija, Kosovo i Sjeverna Makedonija).
• Rog Afrike: tigrinja (Eritreja) i amharski (Etiopija), oba ge'ez pismom, te somalski (latinicom).
• Iran: perzijski (farsi). Uređaj postavljen na perzijski iz Afganistana (fa-AF) dobiva dari, svi ostali farsi.
• Karipska Nizozemska i Surinam: papiamento (Papiamentu, pravopis Curaçaa i Bonairea; i za Arubu) i sranantongo.
• Azija: hindski (devanagari; i za sarnami hindustani), urdski (s desna na lijevo), indonezijski i vijetnamski (latinica, i na računu).
• Marokanski: darija (marokanski arapski, govorni jezik) arapskim pismom i latinicom (kako ga mnogi Nizozemci marokanskog podrijetla pišu u porukama), uz standardni arapski. Berberski: tarifit (rifski, latinicom; većina Nizozemaca marokanskog podrijetla potječe iz Rifa) i standardni marokanski tamazight pismom tifinagh.
• S desna na lijevo: arapski (standardni arapski), urdski, darija arapskim pismom, dari i paštu (Afganistan), perzijski (farsi, Iran), kurdski sorani (Irak/Iran) i sirijski aramejski (surayt, sirijskim pismom). Iznosi, kodovi i brojčane tipke ostaju s lijeva na desno. Kurdski kurmanji (Turska/Sirija) piše se latinicom.
• Radni nalog (kuhinja/šank): zadano na jeziku zaposlenika koji prosljeđuje narudžbu. Za svaki pisač može se u Postavke → Pisači → Jezik radnog naloga postaviti i fiksni jezik (npr. kuharov), latinicom: 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 ili Türkçe. Bugarski, ruski i ukrajinski ispisuju se na radnom nalogu u latiničnoj transkripciji (pisač računa ne podržava ćirilicu). Arapsko, sirijsko, devanagari, ge'ez i tifinagh pismo te kineski ne mogu se ispisati na pisaču računa: tada darija ide latinicom, tamazight kao tarifit, a ostalo na nizozemskom. Fiksni tekstovi (STOL, Slijed, ČEKA na poziv, POZIV SLIJEDA, ISPISANO KASNIJE, Za van, Pult) se prevode; nazivi proizvoda i napomene ostaju onakvi kakvi su uneseni. Pisači koji su bili postavljeni na nizozemski slijede zaposlenika.
• Račun (za sve kupce): zadano nizozemski, neovisno o jeziku zaslona. Drugi jezik birate u Postavke → Objekt → Jezik računa (odmah ispod teksta na dnu računa), samo jezici latiničnog pisma. To vrijedi i za predračun, povratni račun, kopiju, poklon-bon i račun e-poštom. Iznosi, oznake PDV-a, PDV broj objekta i fiskalni retci (Belgija) ostaju isti; vlastiti tekst na dnu računa ostaje onakav kakav ga objekt upiše.
• Proizvodi, grupe i opcije zovu se onako kako ih objekt unese; oni se ne prevode.
• Jezik po zaposleniku postavljate i u Postavke → Osoblje.
• Uvod i priručnik također su dostupni na svim ovim jezicima. Putem gumbića © otvaraju se na jeziku blagajne; gore zastavicama birate drugi jezik (to ništa ne mijenja u blagajni).

Za programere: svaki vidljivi tekst u kodu je zapisan kao vt('Nederlandse tekst') (apps/pos-web/lib/i18n.ts); nizozemski tekst je ključ. Prijevodi se nalaze u apps/pos-web/lib/vertalingen/<taal>.ts. Ako prijevod nedostaje, blagajna prikazuje nizozemski; test i18n (pos-web) provjerava je li svaki tekst preveden na svaki jezik i jesu li mjesta {0} ispravna. Poruke poslužitelja blagajne ostaju na nizozemskom i prevode se u pregledniku (i s {0}, npr. naziv proizvoda u poruci).

Postavljanje pisača

Nova blagajna nema pisača. Prijavite se kao administrator (demo: 1111) i odaberite Postavke u gornjoj traci.

• Pisači: dodajte onoliko pisača koliko ih objekt ima (npr. blagajna, kuhinja, šank, pizza), svaki s vezom (obično mreža: IP adresa i priključak 9100) i širinom papira. Gumbom Probni ispis provjeravate radi li. Gore birate koji pisač ispisuje račun i predračun (i otvara ladicu blagajne). Za svaki pisač birate i jezik radnog naloga (vidi Jezici); račun ostaje na nizozemskom.
• Veza po pisaču:
  • Mreža (IP adresa): IP adresa i priključak (obično 9100). Tako je oduvijek radilo i tako će i dalje raditi: postojeći pisači automatski su postavljeni na mrežu.
  • USB: na Linuxu uređaj, na primjer /dev/usb/lp0. Na Androidu USB pisač spojen na uređaj (OTG kabel; prazno = prvi USB pisač). Na Windowsu i macOS-u odaberite Pisač sustava.
  • Serijski (COM / ttyUSB): COM priključak (Windows), /dev/ttyUSB0 ili /dev/ttyS0 (Linux, Android) ili /dev/cu.… (macOS), s brzinom (obično 9600, 19200 ili 38400 baud). I za Bluetooth pisač koji Windows ili Linux povezuje kao COM priključak ili /dev/rfcomm0.
  • Bluetooth: u aplikaciji HorecaPOS na Androidu, s Bluetooth adresom uparenog pisača (npr. mobilnog pisača računa). Najprije uparite pisač u Bluetooth postavkama Androida.
  • Pisač sustava (Windows / CUPS): pisač onako kako ga poznaje Windows ili CUPS (Linux, macOS), s njegovim vlastitim upravljačkim programom ili kao Generic / Text Only. Račun ide na pisač neobrađen (RAW), bez oblikovanja upravljačkog programa.
  • Ugrađeni (Sunmi, iMin ...): pisač u samoj Android blagajni.
  • Pretraži prikazuje pisače i priključke koje blagajna vidi. Odaberite jedan i adresa će biti upisana.
• Protokol: ESC/POS (gotovo svi pisači računa, i Star pisači u ESC/POS načinu) ili Star (Star Line Mode). Kod Star blagajna sama pretvara račun; račun izgleda isto.
• Zaslon za konobare s vlastitim pisačem: Android zaslon za konobare s aplikacijom HorecaPOS (npr. ručni terminal s mobilnim Bluetooth pisačem ili Sunmi kao zaslon za konobare) može sam ispisivati. Prijavi ga na samom uređaju (Postavke → Pisači → Zasloni za konobare s vlastitim pisačem) i kod pisača odaberi Spojen na. Zaslon za konobare preuzima svoje naloge s blagajne; ondje ostavi aplikaciju otvorenom. Ako to ne uspije (aplikacija zatvorena, izvan dometa Wi-Fi mreže), radni nalog ide u red čekanja za ispis, kao i kod isključenog mrežnog pisača. Odjavi uređaj vraća pisače na samu blagajnu.
• Pisač po grupi / proizvodu: za svaku grupu artikala odaberite na koji pisač ide radni nalog. Za pojedini proizvod to možete promijeniti vlastitim pisačem ili s "bez radnog naloga".

Isti se proizvodi pri ispisu spajaju: dvaput 1x Cola postaje 2x Cola, na radnom nalogu i na računu. Spajaju se samo proizvodi s istim opcijama i napomenom.

Linux instalacijski program dodaje korisnika blagajne u grupe lp i dialout kako bi blagajna smjela koristiti USB i serijske pisače.

Trebate pomoć?

Optimum POS · 085 560 00 60 · support@optimumpos.nl · pon–pet 9:00–20:00, sub–ned 14:00–20:00