Ръководство за HorecaPOS

Това ръководство е в три части: първо за персонала (обслужване), след това за мениджъра и накрая за администратора. Всяка част надгражда предишната: мениджърът може всичко, което може обслужването, а администраторът може всичко.

Какво точно е разрешено за вашата роля, администраторът задава в Настройки → Права. Ако не виждате даден бутон, вашата роля (все още) няма право за него.

Това ръководство е и в касата: докоснете бутона © долу вдясно на всеки екран и изберете Ръководство, или отворете http://<kassa-pc>:3000/handleiding. Вижте също въведението и API документацията.

Част 1 · Персонал

Първи стъпки

Вход. Отворете касата на касата, таблета или телефона и въведете своя ПИН код (4 до 8 цифри). След това виждате плана на масите.

Отваряне на маса. Докоснете маса. Свободна маса получава нова поръчка; при заета маса продължавате с вече съществуващата поръчка. Горе превключвате между залите (например Зала и Тераса). За тезгяха използвайте Бърза продажба, за поръчки за вкъщи За вкъщи.

Поръчка. Избери продуктова група и докосни продуктите. Те се появяват в сметката вляво. По желание първо избери хода (1 = веднага, 2 и 3 чакат, докато ги извикаш). Докосни Поръчай: тогава бележките отиват в кухнята и бара. Докато не си докоснал Поръчай, можеш спокойно да махаш редове.

Плащане. Докосни Плащане, избери Карта / Bancontact, В брой или Ваучер, по желание бакшиш, и потвърди. При плащане с карта плащането започва автоматично на ПОС терминала. Касовата бележка се отпечатва; можеш да я изпратиш и по имейл.

Изход. Излез, когато приключиш, за да не работи никой друг под твоето име. След 8 часа излизаш автоматично.

Няма интернет? Касата продължава да работи. Ако горе пише Няма интернет · карта ръчно, въведи сумата директно на ПОС терминала и в екрана за плащане избери Вече платено на терминала.

Няколко групи на една маса

На една маса може да има няколко групи, всяка със своя сметка и своя бележка.

• Докосни маса: свободна = нова поръчка; една група = направо тази група; няколко групи = първо избери, или + Нова група (името може да е празно).
• В екрана за поръчки горе е лентата с групи: превключване между групите, + Група, Име на група (напр. "Иванови") и Раздели / премести.
• Раздели / премести: за всеки ред избери колко бройки да се преместят (при 3× Бира напр. 1) и в коя група, или създай нова група. Така преместваш нещо, което е на грешна сметка, или разделяш накрая "всеки плаща своето". Ако група остане празна, тя изчезва.
• Няколко части наведнъж: с + Още една част подготвяш една част и избираш следващата (напр. рибата и едно Dry Martini към маса 2, останалото към маса 35). Една част може да отиде и към + Друга маса (там като нова група). С Премести всичко се премества наведнъж. ½ разделя ред наполовина, също и половин бутилка (0,667 става 2 × 0,3335).
• Обедини: всичко от една или повече други маси (или групи на тази маса) в тази сметка, наведнъж.
• Белгия: разделянето или обединяването наведнъж е една смяна на маса в черната кутия, както изисква ФПС Финанси (UC242, UC251, UC252, UC4119bis). Ако след поръчката нещо бъде изтрито или има отстъпка за вече поръчан ред, това се изпраща със следващото съобщение за тази маса (поръчка, предварителна сметка, смяна на маса), а иначе с продажбата: старият ред отрицателен, а новият положителен (UC226, UC4102, UC4104, UC4107, UC4110).
• В екрана с масите оранжева точка показва колко групи има; сумата е общата за всички групи.
• Касовата и кухненската бележка показват "Маса 5 - група 2" или "Маса 5 - Иванови".

Разделяне на сметката при плащане

Плащането работи както винаги: Всичко наведнъж. В екрана за плащане сметката вече може и да се раздели, с бутоните под Назад и Плащане (така те винаги остават видими, без плъзгане):

• Раздели поравно: изберете с − и + на колко души (по подразбиране броят гости или 2, ако касата не отчита гости). Екранът показва сумата на човек; всеки плаща своя дял с карта, в брой или с ваучер за подарък (с бакшиш, ако желае). След всеки дял се отброява ("остават 3 души"); последният плаща точно остатъка.
• Своя сума: някой плаща фиксирана сума (напр. € 20); останалото остава отворено.
• По продукт…: отваря Раздели / премести, за да преместиш продукти в отделна сметка и да я платиш отделно (както по-горе).

Частичното плащане записва само плащането; сметката остава отворена и в екрана за поръчки пише "вече платено … · остава …". Касовата бележка (с всички плащания) идва при последното плащане, както при обикновено плащане. Плащането с карта през връзката е точно за частичната сума. Ако вече е платено частично, редове не могат да се местят в друга група и не могат да се добавят отстъпки; махане е възможно само ако остава достатъчно неплатено. Всяко частично плащане влиза в дневника.

Бърза продажба и за вкъщи (без маса)

Горе вдясно в екрана с масите са Бърза продажба и За вкъщи. И двете веднага отварят поръчка без маса. Бързата продажба е продажба на бара/гишето (ДДС за консумация на място); За вкъщи използва ДДС ставката за вкъщи на всеки продукт. С "Име на клиента" добавяш име; то се появява на бележката ("За вкъщи – Иванов") и горе на кухненския бон. Отворените поръчки без маса са под бутоните за зони ("Без маса: За вкъщи #12 – Иванов"), за да ги намериш отново. Ако се върнеш, без да продадеш нищо, празната поръчка изчезва сама.

Двата бутона могат да се включват или изключват за всяко заведение в Настройки → Заведение, точно под светла/тъмна тема (по подразбиране включено). Изключено = бутонът е скрит; вече отворените поръчки без маса остават видими.

Доставка и часови интервали

Поръчки, които приемате директно на касата, например по телефона или на гишето, със същите правила като в онлайн магазина: зони за доставка и максимален брой поръчки на часови интервал. Включва се в Настройки → Заведение → Доставка и часови интервали, точно под бутоните Бърза продажба и За вкъщи (по подразбиране изключено).

• Бутон Доставка на екрана с масите (до За вкъщи): въведете име, телефон и адрес (с включено Бързо въвеждане на адрес: търсене по пощенски код и номер). Касата намира зоната за доставка и показва таксата за доставка, минимума и "безплатно от". Ако адресът е извън зоните, поръчката не е възможна.
• Зони за доставка: по пощенски код (диапазони и отделни кодове, напр. 5000-5049, 5051, 5052 AB), в радиус в км от заведението (по права линия) или зона на картата, която чертаете сами. Радиусът и зоната работят само с нидерландски адреси (местоположение чрез PDOK). За всяка зона: такса за доставка, минимум, безплатно от и допълнителни минути; важи първата подходяща зона отгоре, така че видовете могат да се комбинират (напр. първо няколко пощенски кода, после зона, после радиус за останалото). Няма настроени зони = доставка навсякъде, без такси и минимум. Зоните на онлайн магазина се настройват отделно (управление на онлайн магазина).
• Зона на картата: при зона за доставка изберете вида Зона на картата и след това Чертане на картата. Щракнете върху картата, за да поставите точки (поне 3); плъзнете точка, за да я преместите, щракнете върху точка, за да я премахнете, и плъзнете кръгчето в средата на ръб за точка между тях. Картата показва също зоните с радиус и заведението. Плочките на картата идват от OpenStreetMap, затова за картата е нужен интернет; за самата доставка не (освен за търсенето на адреса). Ако адресът не може да бъде намерен, касата съобщава това вместо "извън зоните за доставка".
• Таксата за доставка стои в поръчката като ред "Bezorgkosten" и се преизчислява след всяка промяна (безплатно от, без продукти = без такса), докато още нищо не е платено. Под минимума не може да се плати; екранът на поръчката показва колко още липсва, с бутона Все пак за вкъщи (таксата за доставка и минимумът отпадат).
• Час: Възможно най-скоро (сега + времето за доставка, плюс допълнителните минути на зоната) или часови интервал от днес. Ако имате работно време в Thuisbezorgd, то важи и тук.
• Максимум на часови интервал (0 = без максимум; часови интервал от 5 до 60 минути): за За вкъщи и Доставка заедно; броят се и поръчките от онлайн магазина в касата. Ако има максимум, и За вкъщи пита за час, а пълните часови интервали не могат да се изберат. Две каси едновременно за последното място: получава го само едната.
• На кухненския бон стоят адрес, име, телефон и час; в "Без маса" и горе на кухненския бон напр. "Доставка – 18:30 Иванов".

Разширения (всички по подразбиране изключени; без тези настройки всичко работи точно както по-горе):

• Собствено работно време за вкъщи и доставка (за всеки ден от седмицата, напр. 16:00-21:00 или 11:30-14:00, 17:00-22:00; след полунощ е позволено: 17:00-01:00; празно = затворено в този ден). Изкл. = както досега (часовете при Thuisbezorgd, ако има такива, иначе целия ден).
• Затворени дни (напр. 25-12-2026, 26-12-2026): тогава няма за вкъщи и доставка.
• Поръчка напред: от 0 (само днес, както досега) до 14 дни. В прозореца Доставка/За вкъщи тогава първо избирате деня; по-късен ден се отпечатва на кухненската бележка преди часа.
• Натоварено: толкова минути допълнително при "възможно най-скоро" (каса и онлайн магазин). Може да се зададе бързо и с бутона Онлайн магазин в горната лента.
• Белгийски адреси (пощенски код от 4 цифри): при радиус или зона на картата касата намира местоположението чрез OpenStreetMap (Nominatim; нужни са улица и населено място).
• Онлайн магазинът следва касата: касата е водеща. Тогава онлайн магазинът използва зоните за доставка, времето за доставка и за вкъщи, часовия интервал, максимума на интервал, работното време (ако е зададено тук), затворените дни и дните напред от касата и брои поръчките, приети на касата, в часовия интервал. Изкл. = онлайн магазинът има собствени настройки (управление на онлайн магазина), както досега. Включването/изключването на за вкъщи/доставка остава в онлайн магазина.

Код: lib/bezorgen.ts, routes/bezorgen.ts, BezorgDialoog.tsx, BezorgInstellingen.tsx, BezorgKaart.tsx и lib/kaart.ts (картата, без допълнителен пакет; същият код се намира като public/kaart.js в онлайн магазина).

Телефония: разпознаване на клиента при телефонна поръчка

Настройки → Телефония (по подразбиране изключено; при изключване всичко се запазва). Два отделни превключвателя:

• Търсене на клиент по телефонен номер при доставка и за вкъщи: въведете номера в екрана за доставка и касата показва клиента с адреса и предишните поръчки; Вземи данните попълва име, имейл и адрес. Работи и без телефонна централа.
• Разпознаване на номера: когато се обади клиент, централата (или настолният телефон, FRITZ!Box, модемът или Android телефонът) съобщава номера. На екраните се появява известие кой се обажда: име, адрес, последните поръчки (с ястията и сумата, също от онлайн магазина, Thuisbezorgd и платформите за доставка), общата сума и резервация. С Приеми поръчка за доставка или Приеми поръчка за вкъщи се отваря екранът за доставка с всичко попълнено (при включени доставка и времеви интервали); поръчката се свързва с разговора и известието изчезва от всички екрани. Бутон 📞 в горната лента: разговорите от последните 24 часа. Може да се изключи за всеки екран (Показвай известия на този екран).

Търси се в клиентската карта, поръчките за доставка и за вкъщи на касата, онлайн магазина, Thuisbezorgd, платформите за доставка и резервациите. Номерата се уеднаквяват (+31 6 1234 5678, 0031612345678 и 06-12345678 са едно и също; и белгийски номера).

Как пристига номерът (може няколко едновременно; един и същ разговор се брои веднъж):

Отговорът съдържа обаждащия се, също като contact (firstname, lastname, phone, email, address) за CRM шаблон на 3CX. Изходящите и вътрешните разговори не се показват; Само тези линии ограничава до определени линии или телефони. Разговорите се изтриват след срока на съхранение (по подразбиране 30 дни, GDPR). Тестов разговор симулира обаждане от номер.

Код: apps/pos-server/src/lib/telefonie.ts, routes/telefonie.ts, packages/shared/src/telefonie.ts; екрани Telefonie.tsx, BezorgDialoog.tsx; Android android-app/native/java/Beller*.java. Дневник: Телефония.

Собствени куриери: курсове, отчитане на парите и проследяване (track & trace)

За заведения със собствени куриери. Включете го от Настройки → Заведение → Доставка → Собствени куриери (по подразбиране изключено). Не е нужно приложение за куриера: куриерът използва страница в браузъра на собствения си телефон (който иска, използва приложението Optimum Bezorger: вижте Приложение за куриери по-долу).

Създаване на курс. В касата има бутон Курсове (с броя доставки, които още трябва да тръгнат, плюс курсовете на път).

1. При Готови за доставка отметнете поръчките, които тръгват. Това са поръчките за доставка от касата, онлайн магазина и Thuisbezorgd (само собствена доставка; тези с куриер на Thuisbezorgd не).
2. Изберете куриера (служител) и дребните пари, които взема (по подразбиране сумата от настройката), и докоснете Създай курс.
3. Появява се QR код. Куриерът го сканира със собствения си телефон и вижда за всеки адрес името, адреса с бутон Маршрут (навигация), Обади се, бележката, желаното време и какво има да събере. Има калкулатор за ресто (клиентът дава € 50 → ресто € 31,50). Не е нужно влизане. Споделяйте линка само с куриера: който го има, вижда адресите от този курс. С QR код за куриера създавате нов линк; старият вече не работи.
4. Докоснете Тръгване, когато куриерът тръгва. Дребните пари излизат от чекмеджето (изваждане на пари, с причината). Клиентът получава съобщение, че поръчката е на път:
   • при поръчка от касата чрез SMS и/или имейл, ако Съобщения до клиента е включено (вижте Доставка и часови интервали);
   • при онлайн магазина според настройките му (имейл, SMS или push известие);
   • при Thuisbezorgd чрез Thuisbezorgd.

Ако курсът още не е тръгнал, той може да бъде отменен.

1. По пътя куриерът докосва за всеки адрес Доставено, в брой, Доставено, с карта (собствен ПОС терминал) или Доставено (вече платено). Касата го вижда веднага. Ако куриерът не може да отбележи, това може да стане и в касата. Обратно в заведението куриерът докосва Върнах се в заведението.

Отчитане на парите. След курса докоснете Плащане (право Управление на касовото чекмедже):

• За всяка поръчка изберете в брой, карта на вратата, вече платено или недоставено (обратно). Отбелязаното от куриера вече е попълнено.
• Касата отчита всяка поръчка с неплатена сума без нова касова бележка (клиентът вече има бележката; повторен печат от Бележки). Недоставената поръчка излиза от курса и остава отворена, за да може да тръгне със следващ курс.
• Виждате какво се очаква: дребните пари плюс полученото в брой. Въведете какво предава куриерът или го пребройте по банкноти и монети (Броене по банкноти и монети). Касата показва дали сумата е точна или колко е в повече или липсва.
• Дребните пари се връщат в чекмеджето (внасяне на пари). Разликата се вижда при курса и в дневника и се появява и като касова разлика в Z отчета.

Проследяване (track & trace) (включва се отделно в настройката). При на път клиентът получава линк към страница за проследяване на портала. Линкът е в SMS-а или имейла, а в онлайн магазина на страницата за статус (Проследи куриера си). На страницата за проследяване се вижда:

• дали поръчката се приготвя, е на път или е доставена;
• очакваното време: от местоположението на куриера през адресите преди нея, иначе желаното време;
• колко адреса има още преди нея (без да се показват другите адреси);
• с Куриерът на живо на картата също куриерът, заведението и собственият адрес на карта (OpenStreetMap). Куриерът сам включва споделянето на местоположението на телефона (Сподели местоположението ми). Местоположението се изпраща само докато страницата е отворена; страницата държи екрана включен.

Страниците са на езика на телефона (всички езици на портала). В касата при курса виждате кога местоположението е изпратено за последно (с линк към картата).

Поверителност. Порталът пази данните за курса (имена, адреси, телефонни номера, местоположение) само докато курсът тече. При отчитането всичко се изтрива, иначе след 24 часа. Клиентът вижда само своята поръчка. Местоположението на куриера се вижда само по време на курса и вече не се вижда, щом куриерът се върне.

Планиране на курсове (по избор)

Включете го от Настройки → Заведение → Доставка → Планиране на курсове (по подразбиране изключено; работи със собствени куриери). Тогава в прозореца Курсове се появява бутонът Предложи курсове. Касата обединява в курсове поръчките, които още трябва да тръгнат:

• поръчките, които са близо една до друга и чиито желани часове попадат във времевия прозорец (по подразбиране 30 минути), тръгват заедно;
• до максималния брой адреси на курс (по подразбиране 4), стига курсът (отиване, всички адреси и връщане в заведението) да не трае повече от максимума (по подразбиране 45 минути);
• за всеки курс най-добрият ред, разстоянието (км), времето за път отиване и връщане и за всеки адрес очакваното пристигане при тръгване сега. Ако то е по-късно от желания час, до него стои по-късно от заявеното.

С Използвай този курс отмятате тези поръчки, в този ред; изберете куриера и докоснете Създай курс. При курс, който още не е тръгнал, Най-добър ред подрежда адресите в най-бързия ред (и на телефона на куриера). При всеки курс се виждат разстоянието и времето за път.

Настройки: адреси на курс, колко може да трае един курс, времевият прозорец, скоростта на куриера (велосипед ~15, скутер ~25, кола ~35 км/ч в града) и минутите на адрес (паркиране, звънене, плащане; по подразбиране 2). Тези стойности може да задава и мениджърът: в прозореца Курсове с бутона Настрой планирането на курсове (право Настрой планирането на курсове, по подразбиране включено за мениджъра; променя се в Настройки → Права). Включването или изключването на планирането на курсове и услугата за маршрути (адрес, API ключ) остават при администратора.

Разстояние и време за път, избира се от администратора:

• Оценка (по подразбиране): по права линия, умножено по 1,35 (коефициент на заобикаляне), със скоростта на куриера. Работи без интернет и без акаунт.
• OSRM: маршрути по пътя чрез OSRM сървър. Въведете адреса (https:// или http:// в собствената мрежа). Публичният демо сървър (https://router.project-osrm.org) е само за от време на време; за ежедневна употреба поставете собствен OSRM сървър или изберете доставчик.
• OpenRouteService: маршрути по пътя със собствен API ключ (създава се безплатно на openrouteservice.org, с дневен лимит). Адресът по подразбиране е https://api.openrouteservice.org и може да се смени със собствен сървър. Ключът остава на касата; екраните показват само, че е въведен.

С Тествай изпробвате услугата. Ако услугата не работи, планирането се връща към оценката и го казва. Адрес с неизвестно местоположение (без валиден пощенски код и номер) попада в предложението под без известно местоположение и не се планира. Експортът на конфигурацията включва настройките, но не и ключа.

Код: lib/ritplanning.ts.

Приложение за куриери (по избор)

Включете го от Настройки → Заведение → Доставка → Приложение за куриери (по подразбиране изключено; работи със собствени куриери и портала за управление). Тогава всеки куриер сдвоява собствения си телефон само веднъж, вместо да сканира QR код за всеки курс:

1. При Сдвоени телефони изберете куриера (служител), по желание името на телефона, и докоснете Сдвои телефон.
2. Появява се QR код. Куриерът го сканира в приложението Optimum Bezorger (бутон Сдвои) или с камерата на телефона: тогава страницата се отваря в браузъра. Тя работи и без приложение и може да се добави на началния екран.
3. Сдвояването е валидно, докато не го отмените; тогава телефонът веднага спира да вижда каквото и да е. Ново сдвояване за същия служител заменя старото (например при нов телефон).

В приложението или на страницата са всички собствени курсове (всеки курс, който касата създава за този куриер), със същите бутони като при курс: Маршрут, Обаждане, сума за събиране с калкулатор за ресто, Доставено и Върнах се в заведението. Отделно се включват:

• Самостоятелно поемане на поръчки: куриерът вижда доставките, които още трябва да влязат в курс, отмята каквото взема и докосва Вземам. Касата създава курса (или ги добавя, ако куриерът вече има курс, който още не е тръгнал); стандартното ресто тръгва с него. Каквото друг вече е взел, не може да се вземе.
• Самостоятелно тръгване: Тръгване в приложението прави същото като в касата (ресто от чекмеджето, клиентите получават съобщение).
• Карта на живо: при Курсове е бутонът Карта със заведението, всички куриери, които са на работа, и адресите, които още трябва да се доставят. Куриерът сам включва и изключва На работа. Приложението изпраща местоположението и при изключен екран (Android: известие в лентата, докато споделянето е включено); уеб страницата само докато е отворена. Без тази настройка местоположението се споделя само по време на курс с track & trace.

Приложението за Android е в Google Play и на страницата за изтегляне в портала (/download/). Версия за iPhone е готова, но ще излезе едва когато има акаунт за разработчици на Apple; дотогава iPhone-ите използват уеб страницата. При курс, който куриерът е поел сам, пише поет сам в приложението.

Код: lib/bezorgersapp.ts, в портала src/volgen.mjs, а приложението е в хранилището horecapos-bezorger.

В дневника се вижда кой е създал курса, пуснал го е на път, отбелязал го е като доставен и го е отчел, със сумите. Изключване: няма бутон Курсове; курсовете и настройките се запазват.

На портала: /bezorger/<sleutel> и /volg/<code>. Код: lib/bezorgers.ts, routes/bezorgers.ts, Bezorgers.tsx и в портала src/volgen.mjs.

Известие при твърде дълго време за изпълнение

Поръчка за вкъщи или за доставка, готова по-късно от обещаното: касата го забелязва и съобщава, и може веднага да изпрати извинение на клиента, при желание с ваучер. Включва се в Настройки → Заведение → Доставка → Известие при твърде дълго време за изпълнение (по подразбиране изключено).

• Кои поръчки: за вкъщи и за доставка с обещан час, от касата (доставка и времеви интервали), онлайн магазина и Thuisbezorgd.nl / Takeaway.com.
• Закъснение: толкова минути (по подразбиране 10) след обещания час още не е готова или на път. Готова или на път означава: всичко готово на кухненския екран, статус готова или на път в онлайн магазина или при Thuisbezorgd, изпратено съобщение ✉ Готово / ✉ На път до клиента, или платена. Касата проверява всяка минута.
• Известие: бутон Закъснение в горната лента с броя (със звук при нова), за всяка поръчка обещания час и с колко минути закъснява. Поръчката изчезва сама, когато е готова или на път, или с Приключено; отдолу са тези от последните 24 часа, с часа, в който са били готови. Всичко се записва в дневника.
• Онлайн магазин: страницата със статуса на госта показва, че отнема повече време, с новия очакван час.
• При Thuisbezorgd това не е възможно (клиентът е на Thuisbezorgd): там само известие. Може собствен текст; {naam}, {zaak}, {code}, {korting} и {geldig} се попълват автоматично.
• Ваучер (само с включени Кодове за отстъпка): с извинението личен код за отстъпка за следващата поръчка (напр. SORRY-7K4Q2M), сума или процент, за еднократна употреба, валиден определен брой дни, на касата и в онлайн магазина. Кодовете не са в списъка при Кодове за отстъпка. Ако изпращането не успее, кодът се анулира. С бутона в касата само с правото Дай отстъпка.
• Изкл.: известията и издадените кодове се запазват (и в резервното копие); настройката влиза в експорта на конфигурацията.

Код: lib/telaat.ts, routes/telaat.ts, TeLaat.tsx и packages/shared/src/telaat.ts.

Бутонът Поръчай: какво прави и кога ви трябва

Докосването на продукт и натискането на Поръчай са две различни стъпки:

• Докосването добавя продукта веднага към сметката (вляво в списъка) като нов. Само вие го виждате: кухнята и барът още не знаят нищо за него. Новият ред е чернова: можете спокойно да го премахнете или да промените количеството или опциите, без сторно.
• Поръчай изпраща всички нови редове наведнъж: бележките отиват към кухненските и бар принтерите (и към кухненския екран), а редовете след това са поръчани. Премахването тогава е възможно само със Сторно (право сторно). На бутона се вижда колко нови реда чакат, напр. Поръчай (3); ако няма нови редове, бутонът е сив.

Защо две стъпки? На масата приемате цялата поръчка (напитки, предястие, основно ястие), коригирате още нещо, ако гостът промени решението си, и след това я изпращате наведнъж към кухнята, с една бележка на станция вместо по една бележка за всеки продукт. Така кухнята може да започне много преди да е платено.

Какво още се случва при Поръчай:

• Ястия: ястие 1 отива веднага в кухнята; ястия 2, 3 и 4 се изпращат като ЧАКА и кухнята започва едва когато извикате това ястие (вижте Ястия).
• Рундове: всяко натискане на Поръчай е един рунд; на това се основава ↻ Още един рунд.
• Наличността се намалява и дозираният кран се освобождава.
• All-you-can-eat: ако е твърде много, твърде рано или твърде късно за пакета, касата първо пита дали все пак е позволено.
• Белгия (GKS 2.0): редовете първо се изпращат като проформа към черната кутия; ако това не успее, нищо не отива в кухнята и те остават нови.
• Няма връзка: поръчката се запазва и отива в кухнята веднага щом връзката се възстанови. Принтерът е изключен: поръчката все пак минава, бележката влиза в опашката за печат (вижте Кухненският принтер е изключен или няма кухненски екран).

Може и директно плащане. Ако натиснете Плащане, докато в сметката все още има нови редове, касата първо ги поръчва автоматично, така че кухнята и барът винаги да получат своята бележка. На бара или при поръчка за вкъщи не е нужно първо да натискате Поръчай: докосвате продуктите и веднага Плащане. Ако автоматичното поръчване не успее (няма връзка, ред all-you-can-eat, черна кутия), екранът за плащане не се отваря и виждате защо.

Не искате бележка за бара, когато плащате веднага? Включете отметката Директно плащане без работна бележка в Настройки → Заведение → Поръчка и плащане. Тогава към кухнята и бара отива само това, което изпращате с Поръчай; това, което плащате веднага, не получава работна бележка.

Голям или малък бутон Плащане

С отметката Голям бутон "Плащане" на екрана за поръчка точно под поръчаните продукти има голям бутон Плащане: широк, висок и със сумата, за да се натиска бързо. Ако част от сметката вече е платена, бутонът показва оставащата сума. Малкият бутон долу до Поръчай тогава изчезва.

С големия бутон и бутоните на екрана за плащане са големи: Плащане (при Карта, Ваучер и другите начини на плащане), а при В брой Точна сума в брой и Плащане са широки и високи, лесни за натискане, дори с мръсни пръсти (например в месарница). Начините на плащане са малко по-големи, а бутоните за бакшиш малко по-малки, за да остане всичко на екрана.

При нова инсталация отметката е изключена: тогава малкият бутон долу до Поръчай и екран за плащане с обикновени бутони. Предпочитате голям? В Настройки → Заведение, точно под светла/тъмна тема, включете отметката Голям бутон "Плащане". Каса, която вече е била в употреба, запазва това, което е имала. Изборът важи за всички каси и таблети на заведението.

Отбелязване на продукт като "изчерпан"

Всеки може в екрана за поръчки да задържи продукт (или да щракне с десния бутон) и да избере Свършил (изчерпан). Продуктът става сив и вече не може да се поръчва от никоя каса. По същия начин го връщаш с Отново наличен. Всяка промяна се записва в дневника. Администраторът може да го прави и в Настройки → Продукти. Касовият сървър също отказва продукт, отбелязан като "свършил" ("Кола" е свършила), включително от таблет, който още не е получил промяната, или от поръчки, запазени офлайн; тогава таблетът показва "Неуспешно изпращане".

Кухненски екран (KDS)

Освен принтерите за бонове (не вместо тях) кухнята или барът могат да използват екран. Отвори на таблет/компютър в кухнята http://<kassaserver>:3000/keuken, влез с ПИН код и избери станцията: това са същите имена като на принтерите (кухня, бар, ...), така че на екрана е точно това, което би излязло на този бон. "Всички" показва всички станции.

• По един бон на поръчка, най-старите първи, с маса/за вкъщи, номер и колко време вече чака (оранжево след 10, червено след 20 минути).
• Ходовете са отделно; ход, който още не е извикан, е сив с "ЧАКА извикване". Сторнираното е зачеркнато.
• Докосни ред, за да го маркираш като готов, или Готово за целия бон. Тогава обслужващите виждат в горната лента "Кухня: Маса 5 е готова". С Настройки → Заведение → Кухненски екран → Звук за обслужващите (по подразбиране изключено) касата издава и сигнал ("дзън-дзън", без звуков файл). Браузърът позволява звук едва след първото докосване на екрана; включи звука на таблета.
• Върни показва какво е маркирано като готово през последния час, така случайно махнатото може да се върне.

Екранът се обновява сам веднага. Боновете продължават да се печатат; който не ползва екрана, няма да забележи разлика.

Кухненски екран: препращане, ред и ход

Настройки → Принтери → Кухненски екран. Всяка част се включва отделно, по подразбиране изключена; при изключване всичко се запазва.

• Препращане между станции, например студено → топло → пас. За всяка станция задавате фиксирана следваща станция; на поръчката тогава се появява бутон → топло (и винаги Препрати към… за избор на друга станция). Преминават само отворените редове на тази станция. Една станция не се нуждае от принтер: въведете станции като пас в Станции без принтер. Готово (и известието до сервитьора) идва едва на последната станция. В "Всички" при препратен ред се вижда къде е в момента. Всяка стъпка се вижда при реда и в дневника.
• Пренареждане: плъзгайте поръчките (мишка) или ги местете с ◀ ▶ (сензорен екран). Редът важи за станцията и за всички екрани на тази станция; новите поръчки отиват накрая.
• Следващ ход от кухненския екран: при поръчка с чакащ ход стои Поискай ход 2. Сервитьорът тогава получава "Кухнята иска ход 2 за Маса 5" (със звук) и извиква както обикновено; на кухненския екран стои "Ход 2 поискан · n мин", докато ходът бъде извикан. Или изберете Извикай: тогава кухненският екран сам извиква хода, с работна бележка "ИЗВИКВАНЕ ХОД 2", точно като бутона в касата.

Кухненският принтер е изключен или няма кухненски екран

Касата винаги продължава да работи, дори когато принтерът в кухнята или бара е изключен (или няма хартия, или кабелът е разкачен), и дори без кухненски екран:

• Поръчването винаги минава. Редовете веднага са поръчани, сметката е точна и плащането работи нормално. Принтерите се извикват едновременно и всеки получава най-много около 4 секунди: изключен принтер не кара другите (и обслужващите) да чакат дълго.
• Опашка за печат. Бон, който не е успял да се отпечата, отива в опашката за печат. Касовият сървър опитва отново на всеки 30 секунди в продължение на четвърт час; щом принтерът заработи, бонът излиза с надпис ОТПЕЧАТАН ПО-КЪСНО най-горе. Ако следващ бон на този принтер мине успешно, чакащите бонове излизат веднага след него.
• След четвърт час повторните опити спират автоматично; Печатай отново сега все още е възможно.
• Кухненски екран. Ако поръчката е на кухненския екран, кухнята я вижда там дори когато принтерът е изключен. Който не ползва кухненски екран, не губи нищо: касата никъде не чака "Готово" от кухнята.
• Опашката е само в паметта на касовия сървър (след рестарт е празна).
• Същото важи и за касовата бележка: ако не се отпечата, плащането пак е направено (касата съобщава "печатът е неуспешен") и по-късно можеш да отпечаташ копие в Бележки.

Ястия (предястие, основно ястие ...)

Бутоните за ходове се показват само когато са нужни: щом в поръчката има меню (съставен продукт) или когато вече има нещо в ход 2 до 4. При обикновени продукти, като кола, не ги виждаш и всичко отива веднага в кухнята. Няма нищо за настройване.

Под списъка с поръчки е Ход 1 2 3 4. По подразбиране е избран ход 1 и всичко работи както винаги: "Поръчай" изпраща всичко веднага в кухнята, без заглавия на ходове на бона. Ако избереш ход 2 (или по-висок), преди да докоснеш продуктите, тогава:

• при "Поръчай" те вече отиват в кухнята, под "-- Ход 2 · ЧАКА извикване --", за да може кухнята да се подготви;
• в списъка с поръчки пише "Ход 2 · чака" с бутон Извикай;
• при Извикай кухнята получава бон " ИЗВИКВАНЕ ХОД 2 " с това, което трябва да се приготви сега.

Ход 1 винаги тръгва веднага. Ако ход 2 вече е извикан, по-късно допоръчано ястие в ход 2 също тръгва веднага.

Алергени за всеки продукт

По подразбиране изключено: тогава алергените не се виждат никъде. Включи от Настройки → Заведение → Въвеждай и показвай алергени по продукт.

• Настройки → Продукти: за всеки продукт отметни 14-те алергена от ЕС (глутен, ракообразни, яйца, риба, фъстъци, соя, мляко, ядки, целина, горчица, сусам, сулфити, лупина, мекотели). В списъка с продукти съкращенията стоят след името.
• Екран за поръчки: на всеки бутон на продукт има малки съкращения (напр. Gl Me), а бутонът ⚠ Алергени в лентата с групи показва алергените изцяло за всеки продукт от избраната група, с обяснение на съкращенията.
• Промените в алергените влизат в дневника (старо → ново). Ако настройката е изключена, вече въведените алергени се запазват.

All-you-can-eat

По подразбиране изключено. Включва се от Настройки → Заведение → All-you-can-eat (само администратор). Създаваш един или повече пакета, напр. Риба, Месо и Суши, всеки с:

• име (излиза на бележката: "Риба възрастен", "Риба дете");
• цена за възрастен и за дете (с ДДС) и ДДС ставка (по подразбиране NL LAAG, BE B);
• ястията, които влизат в пакета (€ 0): цели продуктови групи и/или отделни продукти (и от други групи, напр. пържени картофи и към Риба, и към Месо);
• времеви лимит в минути (0 = без);
• рундове: най-много толкова ястия на човек на рунд (0 = неограничено) и поне толкова минути между два рунда (0 = без);
• такса за остатъци на брой (0 = без).

Със ↑ ↓ задаваш реда. Той има значение, когато ястие е в няколко пакета: тогава отива към най-горния, който групата е избрала. Изтрий маха пакета за нови маси; текущите маси запазват своите ценови редове (там още може по-малко хора, но не повече).

На масата:

• На екрана за поръчки над бележката има + All-you-can-eat. За всеки пакет изберете броя възрастни и деца; може смесено (напр. 2× Риба и 2× Месо). Цената се добавя като редове в сметката; те не отиват в кухнята. Броят гости на групата става общият брой участници (ако касата отчита гости).
• Лентата показва за всеки пакет: хора, оставащо време (червено, когато времето е изтекло), кой рунд е заедно с максимума и колко остава до следващия рунд. Ястията от пакета са на бутоните с AYCE и на бележката с етикет AYCE за € 0. Всичко, което не е в избран пакет (напитки, десерти ...), се плаща нормално.
• Поръчай: всяко "Поръчай" с безплатни ястия е рунд, за всеки пакет (само пакетите, от които има ястия). Докоснато офлайн и изпратено по-късно не се блокира.
• Промени: промени бройките за всеки пакет. По-малко хора се брои като сторно (право "сторно"). Пакет може да се постави на 0 (или Спри за всички), докато в сметката още няма ястия от този пакет.
• Такса (само ако избран пакет има такса за остатъци): избери брой (и пакета, ако са няколко); "Такса за остатъци × брой" влиза в сметката.
• Плащането, разделянето, отстъпките и бележката работят както винаги: цените на пакетите, таксата и напитките са обикновени редове със свой ДДС.
• Ако администраторът изключи all-you-can-eat, докато има активни групи, новодокоснатите ястия отново струват обичайната цена; каквото вече е в сметката, остава.
• В онлайн магазина (по избор, по подразбиране изключено): с И при поръчка на масата чрез QR кода (онлайн магазин) гостът, който поръчва на маса с пакет, вижда ястията от пакета като Включено за € 0, а най-горе – състоянието (хора, рунд, време). Една поръчка е един рунд, със същите правила като при Поръчай; твърде много, твърде рано или твърде късно онлайн магазинът отказва веднага. Напитките и другите ястия гостът плаща нормално; всичко отива в сметката на масата. Изключено = онлайн магазинът начислява обичайните цени, както досега.

Ваучери за подарък

Два превключвателя в Настройки → Заведение → Ваучери:

• Ваучер като начин на плащане: по подразбиране включено, както винаги е било. Изключено = бутонът Ваучер го няма при плащане (нито при връщане на пари чрез при връщане на стока), и касовият сървър отказва плащане с ваучер.
• Продажба на ваучери със салдо: по подразбиране изключено. Включено:
  • В екрана за поръчки има бутон Ваучер: избери сумата (€ 10, 25, 50, 100 или друга сума) и остави касата да създаде код, или сканирай кода на предварително отпечатана карта. Ваучерът влиза като ред в сметката (ДДС код BON: не е оборот, без ДДС, не отива в кухнята). Оттам можеш и да провериш салдото за клиент.
  • След плащането ваучерът е активен и принтерът за бележки отпечатва ваучер със сумата, кода и QR код.
  • Използване: при плащане избери Ваучер и сканирай или въведи кода (бутонът Салдо показва салдото). Сумата се приспада от салдото. Ако салдото е по-малко от сметката, цялото салдо се приспада като частично плащане и останалото се плаща с карта или в брой. Салдото може да се използва на части.
  • Празен код = ваучер без код, както досега (напр. стар хартиен ваучер).
  • Отчет → Ваучери (право Управление на ваучери, по подразбиране мениджър и администратор): търсене по код, неизползван остатък, история за всеки ваучер, блокиране (изгубен/откраднат) и корекция на салдо с причина. Това влиза в дневника.
  • Отчети: продадените ваучери не се броят като оборот и са отделно (Продадени ваучери); получените пари обаче са при начините на плащане. Платеното с ваучер е обикновен оборот (с ДДС) при начина на плащане Ваучер.
  • Счетоводство: продадените ваучери се записват по кредита, а използваните по дебита на сметка Ваучери (задължения към клиенти).
  • Продаден ваучер може да се върне чрез Бележки → Връщане, докато още не е използван (салдо = стойност). След връщането ваучерът е анулиран (салдо 0, блокиран; вижда се в историята му). Ако вече е (частично) използван, задай салдото на 0 в Отчет → Ваучери и върни остатъка отделно. Отстъпка върху ваучер не е възможна.

Презареждаем кредит (по избор)

За клубове, спортни столове, младежки центрове и събития: ваучер със салдо става презареждаема карта. Включва се в Настройки → Заведение → Презареждаем кредит, под ваучерите (по подразбиране изключено; работи само ако Продажба на ваучери със салдо е включено).

• Карта или гривна: продайте ваучер с Предварително отпечатана карта и сканирайте картата (NFC/RFID четец, който работи като клавиатура, или баркод). Номерът на картата тогава е кодът; с него гостът плаща като с ваучер.
• Зареждане: екран за поръчки → Ваучер → Зареди кредит: сканирайте ваучера или картата и въведете сумата. Тя се добавя като ред в сметката (ДДС код BON: без оборот, без ДДС, както при продаден ваучер) и след плащането е в салдото. В историята на ваучера стои Заредено.
• Максимално салдо на ваучер или карта (по подразбиране € 500, може да се зададе до € 5.000).
• Върни остатъка (отметка, по подразбиране изключено; право Управление на касовото чекмедже): след Провери салдото се появява Върни остатъка. Салдото става € 0, а сумата се показва като пари от чекмеджето в X- и Z-отчета (Върнат кредит …).
• Зареждане може да се върне чрез Бележки → Връщане, докато салдото е поне толкова; ваучерът или картата остава валиден.
• Зареждане на киоска (по избор): виж Киоск за самообслужване.

Ваучери за храна

Само за заведения в Белгия, по подразбиране изключено: Настройки → Заведение → Плащане → Ваучери за храна. Ваучерите за храна са социална придобивка: работодателят ги зарежда на карта на служителя (Edenred, Monizze или Pluxee). Гостът плаща с нея на обикновения терминал за карти; не е нужна връзка с издателите.

• Включено: при плащане има бутон Ваучер за храна. Изберете издателя (само издателите, които заведението приема) и оставете госта да доближи картата до терминала за карти, както при плащане с карта. Без връзка с терминала: гостът плаща на самия терминал за карти, а вие докосвате Плащане.
• Без бакшиш и без ресто с ваучери за храна. Ако салдото не стига, гостът плаща остатъка по друг начин (сметката остава отворена, докато всичко бъде платено).
• Само за определени продуктови групи (по избор, напр. храна, но не алкохол): тогава с ваучери за храна може да се плати най-много сумата на тези продукти по сметката. Екранът за плащане показва колко; остатъка гостът плаща по друг начин.
• На касовата бележка: Ваучер за храна Pluxee (с издателя след него).
• Z отчет и X отчет: отделен ред за всеки издател (Ваучер за храна Edenred, … Monizze, … Pluxee).
• Счетоводство: отделна счетоводна сметка за всеки издател (Ваучери за храна Pluxee (за получаване) и т.н., по подразбиране 416100, 416200 и 416300), защото парите идват от издателя, а не от банката на терминала за карти.
• Нужно: договор с всеки издател, чиито ваучери приемате, и терминал за карти, който приема тези карти (попитайте доставчика на терминала).

Чуждестранна валута

Плащане в брой в друга валута, напр. за британски или американски туристи, или в граничния район с швейцарски франк. По подразбиране изключено: Настройки → Заведение → Плащане → Чуждестранна валута. Добавете валутите (CHF, CZK, DKK, GBP, HUF, NOK, PLN, SEK, TRY, USD) с курс за всяка валута: колко евро начислявате за 1 единица (напр. 1 GBP = € 1,15).

• Въведен ръчно: фиксиран курс; променете го сами, когато се промени.
• На живо (ЕЦБ): дневният курс на Европейската централна банка (референтни курсове, всеки работен ден около 16:00; безплатно, без акаунт). С надценка в проценти (0-20) курсът става толкова по-нисък, така че заведението не плаща само обмяната. Касата изтегля курсовете сама, ако са по-стари от 6 часа; Обнови сега ги изтегля веднага. Без интернет остава последният курс.
• Вкл.: при плащане има бутон Чуждестранна валута. Изберете валутата; касата показва колко е сумата в нея. Въведете какво дава гостът: касата преизчислява и дава рестото в евро. Ако гостът не иска ресто, отметнете Рестото е бакшиш: рестото влиза като бакшиш в бележката, в Белгия в тази валута (GKS 2.0, UC296).
• Ако гостът даде по-малко от цялата сума, това е част; останалото той плаща по друг начин.
• На касовата бележка: валутата, сумата и курсът, както и рестото в евро.
• X- и Z-отчет: отделен ред за всяка валута (Чуждестранна валута GBP, в евро), а при касовото чекмедже колко от тази валута има в чекмеджето. Рестото в евро се приспада от очакваните пари в чекмеджето; самите валути броите отделно.
• Счетоводство: отчита се като пари в брой (каса), в евро.

Допълнителни бутони при поръчка и плащане

Бутони за неща, които не всяко заведение използва. Всичко е изключено по подразбиране; включва се за всеки бутон в Настройки → Заведение → Поръчка и плащане (право Настройка на заведение, плащане и принтери). Изключено = бутонът не се вижда никъде в касата и касовият сървър отказва действието. В Нидерландия всичко работи без черна кутия; в Белгия бутонът работи едва когато функцията е тествана с черната кутия (при бутона пише, ако още не е).

При отваряне на маса:

• Отчитане на броя гости: въпросът "Колко души?" при свободна маса, гостите на плана на залата и в екрана за поръчки, както и гостите в отчетите. Вижте Брой гости.

При поръчка (екран за поръчки, за това, което докоснете след това):

• Сумиране на еднакви продукти (без бутон, по подразбиране включено): ако докоснете същия продукт още веднъж (същите опции, още непоръчан), количеството се увеличава, вместо да се добави нов ред: 4 Cola на един ред с цената по 4. С − отново се премахва един, дори ако вече е поръчан (сторно на един). С бележка, място или за вкъщи остава отделен ред; това, което вече е поръчано, остава отделен ред (нов рунд).
• − и + (пред цената на всеки ред): − премахва един, + добавя един (същия продукт, опции и бележка; ако Сумиране на еднакви продукти е изключено, нов ред). Още непоръчан и на 0: редът изчезва. Вече поръчан: един по-малко е сторно, този ред остава задраскан (за кухнята и отчетите); един повече става нов ред, който още трябва да се поръча. Докосването на самата цена вече не премахва нищо. При меню само −.
• За вкъщи (само на място): гостът взима този продукт със себе си, напр. бутилка вода или десерт. Този ред получава ДДС за вкъщи (в Белгия етикет C), останалата сметка ДДС на място. На бележката при реда пише вкъщи.
• Място (на маса): докосвайте за място 1, 2, 3 ...; редовете получават този номер на място (и в кухненския бон). В Белгия всеки ред отива с разходния център на мястото (CHAIR, UC4123) към черната кутия. Още веднъж след място 12 = отново без място.
• Приемане обратно: следващият продукт се добавя с -1, напр. празна бутилка или чаша (депозит). Възможно е само при продукти с Може да се връща (депозит) (Настройки → Продукти). Ако цялата сметка е отрицателна (само върнат депозит, без продажба), Плащане става възстановяване: в брой обратно или с карта (върнато на самия терминал). В Белгия като възстановяване (REFUND, UC4108 и UC4114).
• Осребри SPV: гостът плаща продукт или меню с single purpose voucher (ваучер точно за този продукт, напр. "1 menu all-in"). Докоснете Осребри SPV и след това продукта на бележката: той се добавя с -1 (същата цена и ДДС, при меню с компонентите), с SPV до него. Не отива в кухнята; може да се премахне нормално. Продукт-ваучер се продава предварително като обикновен продукт; отметнете в Настройки → Продукти SPV (ваучер). В Белгия редът отива при продажбата като VOUCHER към черната кутия (UC271).
• Приспадни аванса: вижте по-долу.
• Свободна цена (без бутон, за продукт): при продукт със Свободна цена касата пита за цената, напр. ястие на деня или аванс.

При плащане:

• Директно плащане без работна бележка (не е бутон): по подразбиране Плащане първо поръчва това, което още не е поръчано, така че кухнята и барът винаги получават своята бележка (вижте Бутонът Поръчай: какво прави и кога ви трябва). Включено: това, което плащате веднага, без първо да натиснете Поръчай, не получава работна бележка, напр. на бара, където го вземате сами. Това, което вече е поръчано, не се променя.
• Отделно плащане (на маса, при Раздели сметката): изберете какво плаща един гост сега, и част от ред (½ за половин бутилка). Това става отделна част, която плащате веднага; останалото остава по сметката, без първо да разделяте сметката или да я местите в друга група. Процентната отстъпка за цялата бележка се прилага пропорционално. Назад без плащане = всичко отново по сметката. В Белгия продажбата остава на мястото на масата, без смяна на маса (UC4103bis, UC4104).
• Гостът си тръгна без да плати (право Затваряне без плащане, по подразбиране само мениджър и администратор): сметката се затваря като продажба без плащане, с причина в дневника. В X и Z отчета и в дневния отчет е като Неплатено (гостът си тръгна); в счетоводния журнал към несъбираемо (по подразбиране 4985 / 643000). В Белгия продажба без плащане (UC4109).

Впоследствие (Бележки):

• Коригирай цената (право Коригиране на цената на бележка, по подразбиране само мениджър и администратор): цената на платена бележка не е била вярна, напр. 50% отстъпка вместо 5%. Касата създава нова бележка без маса с редовете на старата бележка обратно (отрицателни, по платеното тогава) и същите продукти отново по обичайната цена. Дайте там правилната отстъпка и платете разликата (или възстановете, ако новата цена е по-ниска). Старата бележка остава както е; веднъж на бележка и не ако вече има нещо върнато. В Белгия старите редове отиват като CORRECTION (UC4116).

Код: apps/pos-server/src/lib/kassaopties.ts, routes/kassaopties.ts; екран KassaOpties.tsx. Дневник: Настройката е променена, SPV осребрен, Корекция на бележка, Неплатено.

Приспадни аванса

Аванс (предплата, напр. за празненство или резервация) се продава като обикновен продукт с включен Аванс (Настройки → Продукти; винаги има свободна цена). Направете по един за ставка на ДДС, ако авансът трябва да е по ставки (напр. Аванс храна и Аванс напитки), или един продукт, ако е част от офертата. Гостът плаща аванса предварително и получава бележка.

Включване: Настройки → Заведение → Поръчка и плащане → Приспадни аванса (по подразбиране изключено). При крайното плащане докоснете в екрана за поръчки Приспадни аванса и въведете номера на бележката на аванса. Касата поставя авансовите редове от тази бележка с отрицателно количество в сметката (същият продукт, цена и ДДС). Което вече е приспаднато, не може да се приспадне отново. Ако авансът е повече от сметката, гостът получава разликата обратно (възстановяване). В Белгия приспаднатите редове отиват като възстановяване (REFUND) към черната кутия (UC4110, UC4111, UC4113). Дневник: Авансът е приспаднат.

Бележка по имейл

По подразбиране изключено. Включи от Настройки → Заведение → Бележка и по имейл.

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

След попълването рестартирай касата. След това при Плащане има поле Изпрати бележката и по имейл (по желание): празно = само печат, както винаги; въведен имейл адрес = същата бележка (с разбивка по ДДС и фискалните редове) се изпраща и по имейл на госта, с името на заведението като подател.

• Имейл адресът не се запазва; в дневника пише само "бележка N изпратена до a***@domein.nl" и дали е успешно.
• Ако изпращането не успее (напр. грешни данни за вход), бележката пак е платена и отпечатана; съобщението казва какво се е объркало.
• Не и при частично плащане (разделяне на сметката): бележката идва при последното плащане, така че там въвеждаш адреса.
• Изпращане по-късно: в Бележки до бележката има бутон Изпрати по имейл (право Печат на копие на бележка). Той изпраща бележката с надпис КОПИЕ, точно като отпечатано копие (в Белгия се регистрира като копие).
• Не са нужни допълнителни пакети: касата сама комуникира с пощенския сървър (STARTTLS на 587, TLS на 465).

Резервации

Включи от Настройки → Заведение → Резервации (по подразбиране изключено). Там задаваш и колко минути предварително резервираната маса се показва на плана (по подразбиране 60) и стандартната продължителност на резервация (по подразбиране 120 минути).

• Бутон Резервации в горната лента: преглед по дни (◀ ▶), с брой резервации, хора и неявили се. + Нова резервация: име, телефон, имейл, брой хора, дата, час, продължителност, маса (може и по-късно) и бележка. Резервациите се правят от персонала; онлайн резервиране (все още) няма.
• Ако на същата маса в този период вече има резервация, касата съобщава това; "Запази въпреки това" е възможно.
• Потвърждение по имейл (отметка или по-късно "Изпрати по имейл"), ако има имейл адрес и пощенски сървър (SMTP_HOST, виж Бележка по имейл).
• На плана резервираната свободна маса е лилава с "R 19:30 Иванов (4)". Ако я докоснеш: "Иванов дойде" отваря масата с 4 души и "Иванов" като име на група; "Други гости" просто я отваря.
• В прегледа: Пристигна (отваря масата; ако няма маса, първо избираш), Промени, Неявил се, Отмени и Възстанови. Всичко се записва в дневника.
• Резервации от онлайн платформи: вижте Платформи за резервации по-долу.

Връзка на касата с TheFork: масата се отваря при пристигане, сметката се връща

С POS-API на TheFork касата работи заедно с TheFork Manager (по подразбиране изключено), освен изтеглянето на резервациите по-горе. Включва се в Настройки → Платформи за резервации → Връзка на касата с TheFork; работи чрез портала за управление.

• Ако в TheFork Manager гост бъде отбелязан като Пристигнал или На масата, в касата се отваря масата със същото име, с броя гости и бележка: име, алергии и диета, капаро, оферта/отстъпка и точки за лоялност (Yums). Ако на тази маса вече има отворена поръчка, тя се свързва. Няма маса с това име: появява се известие, а в Платформи избирате масата.
• След плащане сметката отива в TheFork (общата сума и редове с име, продуктова група, количество и сума); тогава TheFork отбелязва резервацията като Тръгнал. При разделено плащане една сметка с общата сума. Ако не успее, касата опитва отново на всеки петнадесет минути (два дни), или с Изпрати отново в Платформи.
• Сдвояване: касата показва код за сдвояване; въведете го в TheFork Manager (Интеграции → каса). ID на ресторанта в TheFork (Customer-id) се въвежда от администратора или идва автоматично с първата поръчка.
• Отметки: автоматично отваряне на масата, име, алергии и капаро като бележка, сметка към TheFork.
• Условие: Pin Voordeel има API ключа на TheFork (само за партньори) и е регистрирал касата там като POS (бутон в портала за управление); TheFork пуска връзката на живо след тестова сесия.

Документация на TheFork: https://docs.thefork.io/POS-API/introduction

Списък на чакащи за гости без резервация

За гости без резервация, които чакат за маса. Включи от Настройки → Заведение → Списък на чакащите (без резервация) (по подразбиране изключено). Вижда се само ако SMS чрез CM.com е настроен; иначе списъкът на чакащите го няма никъде в касата (нито в настройките). Работи независимо от резервациите: дори когато те са изключени. Там е и текстът на SMS-а (празно = "Здравейте, {naam}, масата Ви в {zaak} е готова. Моля, обърнете се към персонала."; {naam}, {zaak} и {personen} се попълват автоматично).

• Бутон Чакащи в горната лента, с броя чакащи (оранжево, ако някой чака). + Добави в списъка: име, телефон (за SMS-а), брой хора, казаното време за чакане и желание (тераса, детско столче).
• Списъкът е подреден по реда на записване, с това колко дълго някой вече чака (червено, ако е повече от казаното), а горе е броят чакащи, хора и средното време за чакане днес.
• Ако SMS-ът не успее, причината е посочена. Изпрати SMS отново е възможно.
• Настани: изберете масата; касата я отваря с броя гости (ако касата отчита гости) и името като име на групата (както при пристигаща резервация).
• Тръгна си (напуснал или отказал се) и Възстанови. Под списъка е кой днес е настанен или си е тръгнал, и колко дълго е чакал.
• Поверителност: телефонните номера се изтриват след един ден; който е още в списъка след 12 часа, отпада автоматично. Записването, повикването (само с последните 3 цифри на номера) и настаняването се записват в дневника.
• Защо не в Резервации? Резервацията е за по-късно (дата, час, маса предварително); списъкът на чакащите е за сега (ред, време за чакане, SMS, когато масата се освободи). Затова има собствен превключвател и бутон, със същото "отваряне на маса" като при резервация.
• Онлайн в списъка на чакащите (по избор, по подразбиране изключено; само с онлайн магазина): с Гостите могат и сами да се запишат през онлайн магазина в онлайн магазина има Списък на чакащите (и има QR код за вратата, в управлението на онлайн магазина при Маси и QR). Гостът попълва име, телефон, брой хора и желание и вижда мястото си на живо. В касата той е в списъка с отметка онлайн; извикването, настаняването и тръгна си работят както винаги, а гостът вижда това и на телефона си (там може и да се откаже).

Клиентска карта / точки за лоялност

Включи от Настройки → Заведение → Клиентска карта / точки (по подразбиране изключено, тогава никъде нищо от това не се вижда). Там задаваш и: точки на евро (0 = само карти с печати), след колко точки има награда и колко евро отстъпка е наградата.

• На касата над сметката е "+ Клиентска карта": потърси клиента по име или телефон, или създай нов клиент (име, по желание телефон и имейл). След това името и салдото на точките са на сметката.
• Използвай: при достатъчно точки "Използвай 100 точки: € 5 отстъпка"; при пълна карта с печати "Безплатно кафе" (кафето трябва да е в сметката). Това става ред с отстъпка; всеки може да го махне отново.
• Точките и печатите се добавят и приспадат едва при плащането: точки върху сумата след отстъпката (без продадените ваучери), печати за всяка бройка от продукт с карта с печати (безплатният продукт не се брои).
• На касовата бележка: събрани, използвани, салдо и състоянието на картите с печати.
• Отчет → Клиенти (право Управление на клиентски карти): търсене на клиенти, промяна на данни, корекция на точки (с причина), история и изтриване (GDPR: името, телефонът и имейлът се премахват; историята остава анонимна). Най-долу са картите с печати по продукт (напр. 10 кафета = 1 безплатно).
• Връщането не анулира автоматично събраните точки; при нужда ги коригирай в Отчет → Клиенти.
• Клиентска карта с номер (по избор): в Отчет → Клиенти → (клиент) въведи номера на картата (или сканирай картата в това поле). С баркод скенера сканирането на тази карта свързва клиента с бележката, на касата и на киоска. Търсене по номер на карта има и при + Карта за лоялност.

Профил на госта: VIP, хранителни предпочитания и предпочитания (по избор)

Включва се в Настройки → Заведение → Профил на госта, под клиентската карта (по подразбиране изключено; работи само ако клиентската карта е включена). След това:

• В екрана за поръчки под свързания клиент има "+ Профил на госта": отметни VIP, избери хранителни предпочитания (вегетарианско, веганско, пескетарианско, халал, кашер) и алергии (14-те алергена) и въведи предпочитания (напр. "постоянна маса до прозореца", най-много 300 знака). След това те се виждат при клиента в екрана за поръчки, алергиите в червено. Могат да се променят и в Отчет → Клиенти → (клиент) → Профил на госта.
• Ако докоснеш продукт с алерген на госта (виж Алергени за всеки продукт), касата първо пита дали да се добави въпреки това. Важи само това, което е попълнено при продукта; при съмнение винаги питай кухнята.
• VIP получава ★ в плана на залата: при отворена сметка и при показаната резервация на този клиент. Когато гостите от резервация пристигнат, касата свързва клиента от резервацията със сметката.
• Хранителните предпочитания и алергиите (и VIP) излизат на кухненския бон за кухнята и бара: GAST: VIP · Vegetarisch · allergie: Noten.
• Хранителните предпочитания и алергиите са здравни данни: попълвай ги само със съгласието на госта. В дневника се записва само това, че профилът е променен, не и самите предпочитания. Изтриването на клиента премахва и профила на госта.

Любими / бързи бутони

По подразбиране изключено. Настройки → Заведение → Любими / бързи бутони:

• Най-продавани: първи в лентата с групи е бутонът ★ Любими с 12-те продукта, продавани най-много през последните 14 дни (обновява се автоматично). Екранът за поръчки се отваря на любимите.
• Избери сам: в екрана за поръчки задръж продукт (или десен клик) и избери ★ Любим (бърз бутон); още веднъж = премахване. Право Управление на продукти. Всички каси го виждат веднага.
• Докосване, опции, менюта, happy hour и "свършил" работят при любимите точно както в обикновените групи.

Още един рунд

В екрана за поръчки има бутон ↻ Още един рунд (щом има нещо в сметката, дори ако още не е поръчано). Едно докосване добавя последния рунд (всичко, изпратено наведнъж с "Поръчай", или това, което току-що си докоснал) още веднъж като нови редове; после просто Поръчай. Цените са текущите (включително happy hour).

• Продължително натискане (или десен клик): избираш сам. С ◀ ▶ разглеждаш по-ранните рундове, всеки продукт може да се включи/изключи (напр. махни отметката от храната) и бройката с − / +. Опциите и бележките се прехвърлят.
• Свършили продукти и менюта не се прехвърлят (менютата се докосват отделно). Работи и без връзка.
• Редовете се добавят така, както са в сметката: с включено Сумиране на еднакви продукти – един ред на продукт (2 Cola), с изключено – всеки ред поотделно (2 пъти по 1 Cola).

Време на масата в плана

На всяка заета маса стои ⏱ 45m · 12m: колко време масата е заета и преди колко време е добавено нещо за последно (задръж масата или посочи с мишката за точните часове). Ако известно време нищо не е поръчано, масата получава оранжева рамка: мини покрай нея. Колко минути се задава в Настройки → Заведение → Време на масата (по подразбиране 20, 0 = без оранжева рамка). Ако още нищо не е добавено, времето се брои от отварянето на масата.

Ако на една маса има няколко групи (със свои сметки), за всяка група има ред, напр. G1 ⏱ 50m · 12m и Иванови ⏱ 10m (името на групата, иначе номерът ѝ). Група, която е неактивна твърде дълго, получава оранжев етикет, а масата – оранжева рамка.

Преместване на цялата маса

В екрана за поръчки има Премести маса. Избери помещението (напр. Тераса) и маса: всички групи от масата се преместват, всяка със своята сметка. Ако избереш заета маса, масите се обединяват (групите се добавят). Ако искаш да преместиш само част, използвай както досега Раздели / премести. Ако всичко трябва да е в една сметка, използвай Обедини.

Работа офлайн (таблет без Wi-Fi)

Ако връзката между таблет и касовия сървър прекъсне (Wi-Fi на терасата, сървърът е спрял за момент), се появява жълта лента и таблетът продължава да работи с последно запазените маси, продукти и отворени поръчки:

• отваряне на маси, добавяне на продукти и Поръчай се запазват на таблета (дори при рестарт) и стоят в списъка с поръчки с пунктирана рамка ("още не е изпратено");
• щом връзката се върне, всичко отива по ред към сървъра и едва тогава бонът отива в кухнята. Всеки пакет има ключ, така че нищо не пристига два пъти. Ако междувременно някой друг е отворил масата, продуктите се добавят към тази поръчка;
• плащането, отстъпките, разделянето и т.н. са възможни само с връзка; "Плащане" изчаква, докато всичко от тази маса бъде изпратено.

Брой хора

По избор и по подразбиране изключено: Настройки → Заведение → Поръчване и плащане → Отчитане на броя гости. Изкл. = възможно най-малко докосвания: свободна маса се отваря с едно докосване, никъде не се показват гости, а отчетът, таблото и обобщението на деня не показват гости и разход на гост.

Вкл.: докоснете ли свободна маса, касата пита колко души са (големи бутони 1-8 или въвеждане; "Пропусни" = 1). На плана на залата при заета маса пише "3/4 души" (гости/места, в жълто, ако хората са повече от местата). В екрана за поръчки го променяте с бутона "3 души" в лентата с групи; при няколко групи масата сумира всички групи.

Без гости всичко продължава да работи: Раздели поравно при плащане започва от 2, all-you-can-eat сам пита за броя възрастни и деца, а резервациите и списъкът на чакащите пазят свой брой гости (тогава масата се отваря без гости).

HACCP регистрация

Всяко заведение трябва да следи и документира безопасността на храните: в Нидерландия според Hygiënecode voor de Horeca (Хигиенен кодекс за ресторантьорството, контрол от NVWA), в Белгия според самоконтрола на FAVV (ръководство G-023). Включи HACCP регистрация в Настройки → Закони и правила (по подразбиране изключено).

• Точки за измерване (администратор): напр. хладилна камера, фризер, топло задържане, температура в сърцевината след термична обработка, бързо охлаждане и приемане на стоки, с минимум и/или максимум в °C и колко често (всеки ден, два пъти на ден, всяка седмица или при употреба). Добави стандартен списък създава начална основа (охлаждане до 7 °C, в Белгия до 4 °C; фризер до -18 °C; топло задържане от 60 °C; термична обработка от 75 °C).
• Почистване и проверка: задачи на ден, седмица (по желание в определен ден) или месец, с помещение и инструкция, напр. дезинфекция на дъските за рязане, мазнинни филтри, контрол на вредители, проверка на термометъра.
• Записване (всеки влязъл потребител): бутон HACCP в горната лента, с броя на отворените за днес. Въведи температура или отметни задача (Готово или Неуспешно). Ако температура е извън границата, трябва да се добави коригиращо действие (напр. "затворена врата, изхвърлен продукт"). Записите не могат да се променят; грешка се поправя с нов запис.
• Справка (право Оборот за период): за всеки период всички записи, броят отклонения и пропуснатите записи по дни; като CSV (Excel) или за печат / запазване като PDF за проверка.

Наливна система и дебитомери

Всяко наливане, което съобщи наливен компютър или дебитомер, отива в сметката, така че нищо не "изтича". Включете го от Настройки → Наливна система (по подразбиране изключено).

• Източници (администратор): наливният компютър или системата от разходомери. Изберете марката; касата попълва предварителна настройка. От Нидерландия и Белгия: Van Duijnen Horeca (автоматизация на наливането, Dashbar), Beconet (Multi-Tap), TapSystems, Horecatechniek Nederland, Heineken SmartDispense, WeissBeerger / AB InBev и BarTrack; също Gruber, Addimat, WMF / Hogatron (E-Protokoll), Drinkotec (ex-Hartec), , Berg, Easybar, Azbar, Scanabar, PourMyBeer, iPourIt, BeerBoard, US BeerSAVER, Bevchek, Capton/BarVision, Kegtron, Kegbot Kegboard, "умен кран" или собствена система. Има пет начина за свързване (Kegboard: вижте Дозирано наливане и Kegboard по-долу):
  • Полета: kraan (или tap, plu), ml (или cl, liter, volume с eenheid) или porties, id (едно и също наливане два пъти = осчетоводено веднъж), tijdstip, tafel, bediening; едно наливане, списък или { "taps": [...] }.
  • Мрежа (TCP): касата се свързва с наливния компютър (адрес и порт) или сама слуша на порт.
  • Сериен порт: COM порт или USB сериен, 1200–115200 baud, 8N1, 7E1 или 7O1.
  • При мрежа и сериен порт задавате формата на съобщението (едно съобщение на ред или STX … ETX с евентуална XOR проверка и връщане на ACK/NAK) и шаблона на съобщението, с частите kraan или plu и евентуално ml, cl, liter, porties, tafel, bediening и id (напр. kraan;ml или само PLU на чаша). Доставчиците дават точния си формат само на монтажници; попитайте доставчика на наливния компютър. Тестово наливане изпраща наливане така, както би го направил наливният компютър.
• Кранове (администратор): за всеки кран или PLU продуктът и как се отразява в сметката: на чаша (чаша в ml; наливане от 520 ml с чаши от 250 ml = 2 чаши; от 50% се брои чаша) или на литър (цената на продукта е цената за литър; в сметката напр. "Бира 0,33 l" за точната сума).
• В сметката: ако наливният компютър съобщи маса, наливането отива веднага в отворената поръчка на тази маса. Иначе се показва в Налято: на екрана за поръчки се появява лентата "… пъти налято без сметка"; изберете наливанията и докоснете В тази сметка. Редовете веднага са поръчани (към бара не отива поръчка) и наличността се намалява. Бутонът Налято в горната лента показва всичко, което още няма сметка.
• Отписване (право Сторно): промиване, счупване, дегустация, персонал, безплатно или друго (с пояснение); записва се в дневника. По-малко от чаша (напр. промиване) трябва да се отпише.
• Преглед (право Оборот за период): за всеки кран налято, в сметка, отписано (по причина), анулирано и още отворено, в литри, с процента продадено, и като CSV.
• Съобщените наливания не могат да се променят (само да се обработят).

Дозирано наливане и Kegboard

При дозирано наливане кранът се отваря едва след като чашата е маркирана на касата, и то само за това количество. Така не се налива нищо, което не е в сметката. Работи само когато наливната система е включена, и се включва за всеки кран поотделно (по подразбиране изключено).

• За всеки кран (администратор, Настройки → Наливна система → Кранове): отметнете Дозирано наливане и изберете колко дълго кранът може да остане отворен след маркиране (10–600 секунди, по подразбиране 120). При Kegboard въвеждате и релето (магнитен вентил). Дозираното наливане е възможно само на чаша.
• Маркиране: при Поръчай (или при директно Плащане) касата създава за всеки ред от сметката с този продукт освобождаване (брой чаши × чаша в ml) и го изпраща към наливния компютър. Наливането, което постъпи след това, принадлежи към този ред. Затова то не се добавя отново в сметката, нито в Налято. Наливане без освобождаване отива нормално в Налято.
• Сторно на реда преди наливане: кранът се затваря отново. Освобождаване, което не е налято навреме, изтича; кранът никога не се отваря по-късно.
• Освобождавания в екрана за поръчки (лента над сметката): вижте какво е активно, Спри и Освободи отново. Повторно освобождаване е възможно само ако още нищо не е налято, така че никога не се освобождава нищо в повече. Тестово освобождаване (администратор) освобождава една чаша без сметка; това се записва в дневника.
• Как освобождаването стига до наливния компютър:
  • Kegboard (Kegbot, отворен код, ESP32 с разходомери и магнитни вентили; напълно публичен протокол): касата дава grant за крановете с този продукт, релетата и количеството. Платката сама затваря крана, когато количеството е достигнато или времето изтече.
  • Мрежа/сериен порт: настройваема команда за освобождаване с {kraan}, {ml}, {porties}, {sec} и {id} (напр. V{kraan};{ml}), изпратена във формата на съобщенията на източника (ред или STX … ETX с XOR). По избор има команда за спиране. Точната команда се дава от доставчика.
• Сдвояване на Kegboard: в + Източник изберете марката Kegbot Kegboard. Платката се обявява при източника; щракнете Разреши (или Откажи). Платката получава еднократно собствен ключ, който касата пази само като хеш. Друго устройство или грешен ключ не променят нищо при сдвоена платка; ако платката е загубила ключа си, първо използвайте Прекрати сдвояването. Източникът показва фърмуера, броячите и релетата на платката. Крановете са номерата на броячите (0, 1 …). Карта, поднесена към платката, се отказва: плащането става на касата. Ако системата за наливане е изключена, платката пази съобщенията си и ги изпраща по-късно.
• При източника задавате след колко секунди без поток кранът се затваря (5–300, по подразбиране 30). За всеки кран въвеждате номера на брояча, релето (електромагнитен клапан) и колко дълго кранът може да остане отворен след маркирането.

Управление на музиката от касата

Персоналът управлява музиката от сензорния екран на касата, така че не е нужен отделен екран на бара. Включете го в Настройки → Заведение → Екрани и управление → Управление на музиката от касата (по подразбиране изключено). Тогава в горната лента се появява бутонът Музика: за всеки източник (напр. Бар и Тераса) Пусни, Пауза, Следваща, Предишна, По-силно, По-тихо и плъзгач за силата на звука, заедно с това какво звучи сега. Обратно към касата затваря панела. При изключване източниците остават запазени.

• Опашка (Sonos, Bluesound и VLC): списъкът с това, което свири сега. Докоснете песен, за да я пуснете; с Редактирай премахвате песни (✕), местите ги нагоре или надолу (↑ ↓; Sonos и Bluesound) или изчиствате опашката. С Избери друга музика пускате любимо от Sonos (напр. радиостанция или канал на Tunify) или плейлиста от Sonos, или предварителна настройка на BluOS.
• На отделен екран: същото управление и опашката в голям размер на http://<kassaserver>:3000/muziek, напр. на втори монитор до касата или таблет на бара (ако вече сте влезли на същото устройство, иначе с ПИН).
• На таблет или телефон: QR код с адреса на този отделен екран в мрежата на заведението. Служител го сканира със своя таблет или телефон (в wifi мрежата на заведението) и влиза със своя ПИН; с Изход екранът се затваря отново. Вижте Втори екран на таблет или телефон.

Администраторът добавя източниците с + Музикален източник, избира как е свързан всеки от тях и го проверява с Тествай:

• Soundtrack (soundtrack.io): чрез публичния API, с API токен (поискайте го от Soundtrack) и звукова зона (Зареди зоните). Пускане, пауза, следваща, сила на звука и какво звучи.
• Sonos: IP адресът на тонколоната (при група: тонколоната, която управлява групата). Работи с всичко, което звучи на Sonos, напр. Tunify, Spotify или радио.
• Bluesound (BluOS): IP адресът на плейъра; също работи с всичко, което звучи на него, напр. Tunify.
• VLC на музикалния компютър: включен уеб интерфейс (Инструменти → Предпочитания → Покажи всички → Интерфейс → Основни интерфейси: Web, с парола при Lua); IP адресът (при нужда с :poort, по подразбиране 8080) и паролата.
• Собствен музикален компютър (уеб адреси): за музикален компютър или устройство с отделен уеб адрес за всеки бутон; GET или POST и {volume} (0-100) в адреса за силата на звука. Без адрес за По-силно/По-тихо касата променя силата на звука на стъпки.
• Уеб плейър на музикалната услуга: уеб адресът на уеб плейъра или страницата за управление (напр. уеб плейърът на Tunify или Media Tools) се отваря в касата с бутона Музика; ако услугата не може да се показва в друг екран, използвайте Отвори в отделен прозорец.

Касата комуникира с плейърите от сървъра, затова те трябва да са в същата мрежа като касата (Soundtrack през интернет). Управлението е достъпно за всеки влязъл потребител; настройката изисква правото Настройка на заведение, плащания и принтери. Токенът и паролата никога не се показват отново на екрана и не влизат в дневника; в дневника се записва само настройката (вкл./изкл., източници), а не всяко натискане на бутон. Експортът на конфигурацията включва само вкл./изкл. (източниците принадлежат на едно заведение).

Втори екран на таблет или телефон

Музиката и камерите могат да се показват и на собствения таблет или телефон на служител, като втори екран до касата. В прозореца Музика или Камери има бутон На таблет или телефон: той показва QR код с адреса, напр. http://192.168.1.20:3000/muziek или .../camera.

1. Свържете таблета или телефона с wifi мрежата на заведението.
2. Сканирайте QR кода с камерата (или въведете адреса в браузъра).
3. Влезте със своя ПИН. Виждате само това, което ви е разрешено: музиката – всички, камерите – само с правото Преглед на образи от камерите.
4. Готово: Изход горе вдясно. Ако входът е изтекъл (напр. таблетът не е бил използван през нощта), екранът отново пита за ПИН.

Съвет: добавете страницата към началния екран на таблета (в браузъра: Добавяне към началния екран), тогава тя се отваря като приложение.

Затова касата пита за IP адреса на компютъра на касата в мрежата (ако компютърът има няколко, напр. wifi и кабел, избирате мрежата). В портала за управление (каса от разстояние) това е адресът на портала. QR кода го създава самата каса, без интернет.

Сдвояване на таблети: с един бутон към таблета (по избор)

Още по-лесно: сдвоете таблет еднократно и касата изпраща музиката или камерите към него с един бутон. Включете го от Настройки → Заведение → Екрани и управление → Таблети като втори екран (по подразбиране изключено).

1. На таблета: отворете http://<kassaserver>:3000/tablet (при настройката е На таблет или телефон с QR кода), влезте с ПИН код и дайте име на таблета, напр. Таблет Бар. Сдвои.
2. На касата: в прозореца Музика или Камери вече има бутон Към Таблет Бар (със зелена точка, ако таблетът е включен). Докоснете го: таблетът сам отваря този екран. При музиката се предава и избраният източник (напр. Тераса).
3. На таблета: Затвори връща към изчакване; Премахни сдвояването на този таблет премахва сдвояването.

Оставете страницата на таблета отворена; ако таблетът е изключен или спи, той отваря екрана, щом се включи отново. Таблетът остава влязъл като служителя, който е влязъл на него: изпращането и гледането на камерите е възможно само с правото Преглед на образи от камерите. Администраторът вижда при настройката кои таблети са сдвоени и дали са включени и може да ги преименува или премахне. Таблетът пази собствен ключ; касата пази от него само хеш. При изключване сдвоените таблети остават запазени. В дневника се вижда кой е сдвоил, преименувал или премахнал таблет.

Екран за повикване на поръчки за вкъщи

Екран за гостите с Приготвя се вляво и Готово вдясно, с големи номера, като в закусвалня или заведение за бързо хранене. Включва се от Настройки → Заведение → Екрани и управление → Екран за повикване на поръчки за вкъщи (по подразбиране изключен).

Не е нужно сдвояване: отворете на телевизор с браузър (смарт телевизор, стик или мини компютър), таблет или втори монитор адреса на касата с /oproep, напр. http://192.168.1.20:3000/oproep. При настройката и в прозореца Повикай има бутони На отделен екран и На таблет или телефон (QR код с адреса). Не е нужно влизане: екранът показва само номера. Докоснете екрана веднъж и браузърът ще може да пуска звук.

Какво се показва:

• поръчки за вкъщи от касата, онлайн магазина и Thuisbezorgd (и при желание поръчки на бара без маса, при бърза продажба) от последните 12 часа;
• щом нещо е изпратено в кухнята или бара (или онлайн магазинът е на приготвя се): номерът е в Приготвя се;
• Готово се задава автоматично, когато кухненският екран отбележи цялата поръчка като готова или онлайн поръчката е на готово. Номерът премигва за кратко и екранът дава динг-донг;
• готовият номер остава толкова минути, колкото е зададено (по подразбиране 10), или до Взето;
• поръчките от киоска (вижте Киоск за самообслужване) винаги се показват веднага щом са платени или ще бъдат платени на касата, също и при "тук ще ям", с номера за вземане от бележката им;
• по избор и поръчки за куриери на Thuisbezorgd, Uber Eats, Deliveroo и HubRise (отметка Също поръчки за куриери …): с номера на поръчката от платформата и името на платформата отдолу, за да види куриерът кога поръчката му е готова. Взета тогава съобщава и на платформата, че куриерът я е взел (както в прозореца на платформата).

Номерът: при онлайн магазина, Thuisbezorgd и платформите за доставка – номерът на поръчката, който гостът или куриерът вече има; иначе номерът за взимане (от 1 до 999). Отпечатан е едро на касовата бележка, с обяснение, че номерът ще се появи на екрана, когато поръчката е готова (на езика на бележката).

По избор (по подразбиране изключено, в настройката):

• Обявяване на номера с глас: при нов готов номер екранът казва напр. "Nummer 42…" на избрания език (нидерландски, английски, немски, френски, испански, италиански, португалски, полски, турски или арабски). Гласът идва от браузъра на екрана и звучи различно на всяко устройство; след отваряне докоснете екрана веднъж. След звънеца, ако и звукът е включен.
• Статус на поръчката на телефона: под номера за вземане на бележката се появява QR код. Гостът го сканира, вижда номера си и статуса (поръчано, приготвя се, готово, взето) и получава известие, когато поръчката е готова. Работи през портала за управление, затова касата трябва да е свързана с него. Не за онлайн магазина и Thuisbezorgd (те имат свой статус) и не за киоска (той има своя настройка).

В касата има бутон Повикай (с броя на поръчките, които още се приготвят):

1. Готово отбелязва ръчно номер като готов (без кухненски екран или когато е по-бързо). При поръчка от онлайн магазина или Thuisbezorgd статусът също се обновява, така че клиентът получава и съобщение.
2. Назад го връща в Приготвя се.
3. Взето го премахва от екрана (с Отмени).

При настройката избирате също дали първото име да стои до номера (по подразбиране не, заради поверителността) и дали екранът да издава звук. При изключване: без бутон „Повикай“ и без номер за получаване на бележката; настройките се запазват. В дневника се вижда кой какво е отбелязал ръчно като готово, върнал или взето.

Отбелязване на влизане и излизане

По подразбиране отчитането на работно време е изключено: тогава не се вижда никъде в касата (няма бутон в горната лента, нищо на екрана за вход, няма раздел Работно време). Включи го от Настройки → Заведение, в Отчитане на идване и тръгване на персонала:

• Изкл.: не се използва. Ако по-късно изключите отчитането, то вече не се вижда никъде, но вече отчетените часове се запазват (нищо не се изтрива); ако го включите отново, те отново са налице.
• Включено: служителите могат да отчитат идване и тръгване. След вход касата пита дали искаш да отчетеш идване (Не сега е възможно). В горната лента тогава стои Отчети идване или На работа от 17:02; докосни го, за да отчетеш тръгване.
• Задължително: след вход първо отчети идване, иначе не можеш да използваш касата. Отчитането на тръгване те извежда веднага.

Който не използва касата (напр. кухнята), отчита на екрана за вход: докосни Идване / тръгване и въведи ПИН кода си. Това превключва между идване и тръгване, без вход в касата.

Когато отчитането е включено, администраторът вижда в Настройки → Работно време:

• кой в момента е на работа (и може да отчете тръгване на някой, който е забравил);
• отработените часове за всеки служител за период, с всички смени, и изтегляне като CSV (часовете и като десетично число за заплатите);
• промяна или добавяне на смени (докосни смяна или + Добави смяна). Всяка промяна влиза в дневника със старите и новите часове.

В Белгия всяко отчитане на идване и тръгване се съобщава и на черната кутия. Ако тя не е достъпна, отчитането не минава (както при плащането). Дали това напълно отговаря на белгийската регистрация на персонала, все още трябва да се потвърди.

Претегляне и етикети (везна)

Когато везната е включена (Настройки → Везна), продуктите могат да имат цена за килограм. Всички други продукти остават на брой.

• Претегляне: докосни продукт с цена за килограм (бутонът показва напр. 12,95/kg). Прозорецът Претегляне показва теглото от везната (напр. Aclas OS6X или везната, на която работи самата каса) на живо; зелено = стабилно. Сложи продукта на везната и докосни Добави, щом теглото се стабилизира. Цената е цена за килограм × тегло (закръглена до цент); опаковката (тара) на продукта се приспада автоматично. Ако продуктът има опции, те идват след това.
• Няколко везни: ако има няколко везни, горе в прозореца избираш на коя претегляш. Всяка каса/таблет запомня избора си.
• Ръчно: ако няма везна (или е разрешено ръчно), въведи теглото: 0,512 или 1,2 са килограми, 512 или 512 g са грамове.
• Етикет от TS6X: сканирай баркода на етикета с баркод скенера в екрана за поръчки (просто сканирай, нищо не трябва да е отворено), или докосни Етикет и сканирай или въведи 13-те цифри. Продуктът (PLU) и теглото идват от етикета. Ако на етикета има цена, касата начислява точно тази цена.
• На екрана, касовата бележка и клиентския дисплей е посочено теглото, напр. Кайма 6,63 и под него 0,512 kg x € 12,95/kg; на кухненския бон 0,512 kg Кайма. Разделянето, преместването и връщането са в килограми.
• Претеглен продукт е възможен само с връзка към касовия сървър (теглото идва през касовия сървър).

Uber Eats, Deliveroo и HubRise

Освен Thuisbezorgd.nl / Takeaway.com в касата идват и поръчки от Uber Eats (Нидерландия и Белгия), Deliveroo (само Белгия; Deliveroo напусна Нидерландия в края на 2022) и всичко, което е в HubRise (напр. Uber Eats, Deliveroo, Just Eat/Takeaway.com и по-малки приложения за поръчки). Всяка платформа се включва отделно в Настройки → Платформи за доставка (по подразбиране изключено, при изключване всичко се запазва). Разделът показва за всяка платформа в кои държави работи и предупреждава, ако не работи в държавата на заведението.

• Включете, след това Вход в Uber Eats и свързване на магазина (заведението влиза със собствения си акаунт в Uber Eats). Ако акаунтът има повече магазини, въведете ID на магазина (store id) и влезте отново. За целта Uber Eats първо трябва да одобри Pin Voordeel като партньор.
• Deliveroo: директно, чрез портала. Въведете site-id (location id) и ID на марката (brand id). Без таблет (по подразбиране): касата приема или отказва; с таблет: заведението приема на таблета, а порталът само съобщава дали поръчката е в касата.
• HubRise: касата сама изтегля поръчките (на всеки 20 секунди, не е нужен портал).
• За всяка платформа: автоматично приемане, кухненският бон веднага към кухнята/бара и (Uber Eats, Deliveroo) автоматично изпращане на менюто след промяна и Изпрати менюто сега. В менюто са продуктите, отметнати в Продукти в менюто на Uber Eats и Deliveroo, с опции за избор; изчерпаното също се предава.

Поръчки. Поръчката става обикновена поръчка (bezorgen или afhalen, име на групата <platform> <nummer>) с цените на платформата: продуктите се разпознават по ID (от менюто), кода или PLU номера, непознат = отделен ред с цената на платформата (и известие); такси за доставка, надбавки и отстъпка като отделни редове; ако общата сума пак не съвпада, ред "Разлика". Кухненският бон отива веднага към кухнята/бара. Бутон Платформи в горната лента (с броя текущи поръчки; оранжев, когато има нещо за приемане): приемане или отказ (с причина), в приготвяне, готова, на път, доставена или взета, анулиране и Приключи (платено онлайн). Каквото платформата поддържа, се връща (Uber Eats: приемане, отказ, анулиране; Deliveroo: приемане, отказ, в приготвяне, готова, взета; HubRise: всички статуси). Ако заведението доставя само (собствена доставка), поръчката е и в Курсове, а тръгването и доставката отиват автоматично към платформата. Анулиране от платформата прави поръчката невалидна. Ако касата не е свързана с портала повече от 2 минути, порталът отказва нова поръчка от Uber Eats и съобщава на Deliveroo (с таблет), че не е успяло, за да го види заведението на таблета.

Код: apps/pos-server/src/lib/bezorgplatforms.ts, routes/bezorgplatforms.ts; екрани Bezorgplatforms.tsx. Страна на портала: horecapos-portaal/src/platforms.mjs. Дневник: Платформи за доставка (вкл./изкл., настройки, поръчки). Всичко влиза в резервните копия на касата.

По-малките платформи в Нидерландия и Белгия (Homie, Hebtrek, sneleten.nl, Bistroo ...) нямат публична връзка с каси; ако са в HubRise, работят чрез HubRise. Още: вижте беклога.

Автомат за пари в брой (затворена система за пари в брой)

По подразбиране изключено: плащането в брой работи както винаги. При затворена система за пари в брой персоналът не докосва парите в брой: клиентът или служителят поставя парите в автомата, който ги преброява, проверява за фалшиви пари и връща рестото.

• Автомати, с които касата комуникира директно:
  • CashDro (3, 4+, 5, 7, S Compact; NuKassa, KluisKassa): през мрежата (web service). На CashDro включете Web Integration и създайте собствен потребител за касата.
  • Cashmatic (SelfPay 460/860/1060; в Белгия Xpos): през мрежата (порт 50301) с потребител на Cashmatic.
  • Azkoyen Cashlogy (POS1000, POS1500): чрез CashlogyConnector на Windows компютър до автомата (порт 8092).
  • CashKeeper: чрез CKMonitor на Windows компютър (порт 16501).
  • Glory CASHINFINITY (CI-5, CI-10, CI-10X; също чрез Cikam): чрез управлението (FCC) на автомата. Все още beta: оставете първата връзка да бъде проверена от Glory или от вашия дилър.
  • Външна: друг софтуер управлява автомата и комуникира с касата (като Cikam, ImaCash за 25 марки, софтуерът на CashGuard/StrongPoint (Merlin), PayComplete (SUZOHAPP), Gunnebo SafePay или френски марки като CashMag).
  • Тестов автомат: без хардуер, за упражнение или демонстрация. С Тествай връзката проверявате адреса и данните за вход. Поставете автомата в собствената мрежа (никога отворен към интернет) и използвайте собствен потребител за касата, не администратор.
• Плащане с В брой: Плащане на автомата за пари в брой стартира плащането за сумата (закръглена сума в брой, ако това е включено, плюс бакшиш; при разделяне на сметката – съответната част). Екранът показва какво е поставено и какво се връща; касата приключва плащането едва когато автоматът съобщи готово. Отказ = автоматът връща парите. Ако автоматът не е могъл да върне цялото ресто (твърде малко монети), е посочено колко трябва да се даде от касовото чекмедже. Успешно плащане, което още не е приключено (напр. таблетът е спрял), се намира отново при съответната поръчка.
• В брой само чрез автомата (по подразбиране включено): тогава сървърът на касата приема плащане в брой само с успешно плащане на автомата точно за тази поръчка и тази сума. Изключено = и обикновено плащане в брой в чекмеджето.
• Касово чекмедже (Отчет → Касово чекмедже, право Управление на касовото чекмедже): Проверка на наличността (по монети и банкноти, при Cashmatic, Cashlogy, Glory и тестовия автомат), Изплащане с причина (напр. дребни пари за чекмеджето), Зареждане и Изтегляне на излишък (дребните остават; при Cashmatic). Очаквано в касовото чекмедже не включва парите в автомата (те са посочени отделно отдолу: В автомата за пари в брой), но включва рестото, което е трябвало да се даде от чекмеджето.

Бутонът ©

Долу вдясно на всеки екран (ПИН код, план, поръчки и кухня) има малко бутонче ©. То отваря данните на OptimumPOS: лого, адрес, телефон, имейл и уебсайт. Иконата е локално в приложението, така че работи и без интернет. Същата икона е и иконата на приложението (раздел и начален екран).

Част 2 · Мениджър

Първи стъпки

Мениджърът по подразбиране може всичко, което може обслужващият, а освен това например да дава отстъпки, да прави връщания, да приключва деня, да управлява касовото чекмедже и да преглежда дневника и наличностите. Това е основно под бутона Отчет:

• Междинен отчет (X): оборотът досега, без приключване на деня.
• Касово чекмедже: начална сума, внасяне/изнасяне на пари и отваряне на чекмеджето.
• Приключи деня (Z): в края на деня; след това започва нов ден.
• Предишни Z-отчети, Оборот за период и Табло.
• Дневник, Ваучери и Клиенти.

Наличности

По подразбиране е изключено. Включва се от Настройки → Заведение → Следене на наличности. Изключено = не се вижда никъде в касата.

• За всеки продукт избирате в Настройки → Продукти → (продукт) → Наличности:
  • Не: както винаги;
  • По продукт: всяка продажба намалява с 1 (напр. бутилки, кенове), с праг за известие за "почти изчерпано";
  • Чрез съставки: рецепта, напр. хамбургер = 1 хлебче + 150 г месо + 1 филийка сирене. Всяка продажба намалява съставките.
• Настройки → Наличности (право Управление на наличности, по подразбиране мениджър и администратор):
  • Продукти и Съставки: текущото количество, с изчерпано / почти изчерпано; филтър "само (почти) изчерпани" и експорт в CSV.
  • За всеки продукт или съставка записвате Получаване (+) (доставка), Преброяване (=) (преброеното количество става новата наличност) или Отписване (−) (счупено, изтекъл срок; причината е задължителна).
  • Създаване на съставки с мерна единица (бр., г, кг, мл, сл, л, порция, бутилка, буре) и праг за известие.
  • История: всички движения (продажба, сторно, получаване, преброяване, отписване) с това кой и кога. Административните действия също се записват в дневника.
• Намаляването става при Поръчка (или при плащане за това, което е платено веднага). Сторно връща обратно. Разделянето и преместването не броят двойно. При менюта се намаляват ястията, а не реда на менюто. Връщанията (кредитна бележка) не се добавят обратно (върнатото обикновено вече не може да се продаде); при нужда го запишете като получаване.
• Ако наличността е изчерпана (или дадена съставка не стига за още един път), продуктът автоматично се показва като изчерпан на всички каси. При почти изчерпано на бутона на продукта стои още N. След получаване или преброяване веднага може да се поръчва отново. Касовият сървър също отказва продукта ("Pils" е изчерпан (наличност 0)), така че и от таблет, който още не е знаел това.
• Наличността може да падне под 0 (напр. два таблета едновременно или поръчка офлайн); преброяването я коригира.
• Списък за поръчка: Настройки → Наличности → Списък за поръчка. За всеки продукт (по продукт) и за всяка съставка освен прага за известие задавате и допълване до и доставчик. В списъка за поръчка е всичко, което е на или под прага за известие (без праг: на 0), по доставчик, с предложение допълване до − наличност. Количествата могат да се променят и да се отмятат/размятат. След това Печат (принтер за бележки), Копиране (за имейл или WhatsApp), Експорт (CSV), а след доставката Доставено: запиши като получаване (записва всичко наведнъж). С отметката горе виждате и това, което още не е изчерпано, за да поръчате допълнително.
• Опции за избор: при група за избор (Настройки → Продукти → Опции за избор) има бутон Наличности. За всеки избор посочете съставките на брой, напр. Допълнително сирене = 1 филийка сирене, Пържени картофи = 150 г картофи. Когато изборът бъде избран, тези съставки се приспадат на брой (дори ако самият продукт не следи наличност; при сторно се връщат). Ако дадена съставка е изчерпана, изборът се показва на касата като (изчерпано) и не може да бъде избран.

Поръчки към доставчици

По подразбиране изключено. Включва се в Настройки → Наличност → Поръчки към доставчици (само при включено Следене на наличности). Изключено = списъкът за поръчка работи както винаги.

• Доставчици (раздел Доставчици): изберете от списъка или създайте собствен доставчик. Списъкът съдържа търговци на едро и cash & carry (Sligro, Sligro-ISPC/Sligro-M, HANOS, Makro, De Kweker, Horeca Totaal, Van Zon, zegro, Lekkerland), foodservice (Bidfood и Bidfood Belgium, Solucious, Chefs Culinar, Java, Q-Food, Agora Culinair, VHC Jongens/Kreko/Actifood, Hocras, Van Hoeckel ...), търговци на едро с напитки (De Klok, Henk Smit, Horesca, De Monnik, Hansen, Dranken Geers ...), пивовари и безалкохолни напитки (Heineken чрез Sligro, AB InBev/BEES, Alken-Maes, Haacht, Duvel Moortgat, Martens, Coca-Cola, Spadel, Grolsch, Bavaria), доставчици на пресни продукти (Van Gelder, Driessen, FiliusKaas, Bakkers Brigade, Rungis ...), нехранителни стоки (Bunzl, Takeaware, Supplierz), онлайн магазина за вина Vinify.nl и платформи за поръчки (Apicbase, Exact Horeko, Growzer, inOne, Cuisin.io, OrderXL). В него са само доставчици от държавата на заведението. Когато изберете някой, начинът на поръчка, файлът и колоните вече са настроени правилно; при всеки доставчик е посочено как се поръчва от него.
• За всеки доставчик: клиентски номер, поръчка чрез:
  • Имейл: поръчката като имейл (с таблица) до имейл адреса за поръчки, по избор с копие, със списъка за поръчка като прикачен файл: CSV, Excel, CSV за Care4Fresh (много търговци на едро с пресни продукти), UBL 2.1 Order (Peppol BIS Order), EANCOM ORDERS (D96A в Нидерландия, D01B/HO2C в Белгия) или cXML. Отговорите пристигат на имейл адреса на заведението.
  • Файл: касата създава файла, вие го качвате в онлайн магазина на доставчика (напр. Bunzl Snel bestellen: artikel;aantal, Takeaware: SKU,Quantity). Разделителят, заглавният ред и колоните могат да се настройват (artikel, ean, omschrijving, aantal, eenheid, prijs, totaal; с artikel=SKU давате собствено име на заглавката).
  • Връзка (cXML): cXML OrderRequest с клиентски номер и споделена тайна до адреса за поръчки на доставчика, както го изпращат системите за покупки към Sligro, HANOS и Bidfood. Адреса, клиентския номер и тайната получавате от доставчика (Sligro: koppelingen@sligro.nl). Тайната никога не се връща на екрана.
  • И при двете връзки може да се използват потребителско име и парола (Basic) и допълнителни заглавки (по една на ред, напр. X-Api-Key: ...).
  • Качване (SFTP/FTPS): касата сама поставя файла (EANCOM, UBL, CSV, Excel ...) в папка на сървъра на доставчика, както много търговци на едро приемат EDI поръчки. SFTP (SSH), FTPS (явен на порт 21 или неявен на порт 990) или, само в собствената мрежа, FTP. Вход с парола или SSH ключ (OpenSSH, PEM или PuTTY .ppk; ed25519, ECDSA или RSA). Създай ключ създава двойка ключове в касата; публичния ключ изпращаш на доставчика. Тествай връзката влиза и търси папката. Отпечатъкът на SFTP сървъра се записва при първата връзка и след това се проверява (друг сървър не получава паролата); при FTPS със собствен сертификат фиксираш отпечатъка на сертификата. Не е нужен допълнителен софтуер.
  • Печат: поръчката на принтера за бележки, за да я продиктувате по телефона.
• Пароли, ключове, токени и заглавки никога не се връщат на екрана (оставено празно = запазване, Изчисти = премахване).
• Заяви връзка: при доставчик касата съставя имейл за връзка (cXML, EDI чрез SFTP/FTPS, UBL/Peppol или собствения API на доставчика) с данните на заведението (име, адрес, ДДС номер, клиентски номер, GLN) и това, което е необходимо; при EDI с публичния ключ. Редактираш и изпращаш; копие и отговорите отиват на имейл адреса на заведението. Датата на заявката е показана при доставчика. При Sligro тя отива на koppelingen@sligro.nl, иначе попълваш адреса на твоя акаунт мениджър.
• Собствен доставчик (не от списъка) може всичко освен това, което самият доставчик трябва да предлага: имейл, файл и печат работят винаги; връзка или качване само с данните на този доставчик.
• Дни за поръчка и доставка: дни за поръчка, краен час, срок на доставка (желаната дата на доставка в поръчката) и минимална сума за поръчка. Автоматично: в дните за поръчка от този час касата сама подготвя поръчка като чернова (ти я преглеждаш) или веднага я изпраща (по имейл, чрез качване или връзка; под минималната сума за поръчка само я подготвя като чернова). Веднъж на ден за всеки доставчик.
• За продукт (Настройки → Продукти → (продукт) → Наличност, при За продукт) и за съставка: Поръчка от (доставчикът), номер за поръчка при този доставчик, EAN, в опаковка (каса от 24 = 24), името на опаковката и покупната цена за опаковка. Минималното ниво е моментът за поръчка; допълни до показва колко трябва да има тогава.
• Поръчки за покупка (раздел Поръчки за покупка):
  • Предложение за поръчка за всеки доставчик: всичко, което е на минималното ниво или под него. Това, което вече е поръчано и още не е пристигнало (на път), се отчита, за да не поръчате нищо два пъти. Предложение = допълни до − наличност − на път (без допълни до: до минималното ниво), закръглено нагоре до цели опаковки. Коригирайте количествата и Създай поръчка.
  • Поръчката първо е подготвена: количествата, отделните редове (без продукт, напр. салфетки), бележката и датата на доставка още могат да се променят. След това Изпрати (по начина на доставчика или веднъж по друг начин). Ако не успее (напр. доставчикът откаже), е посочена причината и можете да опитате отново.
  • Получено: за всеки ред полученото количество (вече попълнено с поръчаното количество); наличността се увеличава по опаковки (2 каси по 24 = 48), с поръчката в историята.
  • Всеки файл (CSV, Excel, UBL, EANCOM, cXML) може да се изтегли и отделно.
• Изпращането, неуспехът, получаването и отказът се записват в дневника. Обикновеният Списък за поръчка продължава да работи; ако продукт има доставчик от списъка, той е показан там под неговото име.

Управление на отзиви

Четене на отзиви от Google и Trustpilot и отговор на тях направо в касата. Включва се в Настройки → Точки и отзиви → Управление на отзиви (по подразбиране изключено, тогава никъде нищо от това не се вижда). Четене и отговор в Отчет → Отзиви (право Четене на отзиви и отговор на тях, по подразбиране и за мениджъра). Ако го изключите, връзките и отзивите остават запазени.

• След това всеки обект само докосва Свързване с Google и влиза със собствения си Google акаунт на бизнес профила. Ключ за Places може да се настрои и централно (разходите тогава са за доставчика). Trustpilot е за всеки обект поотделно: всеки обект има собствен Trustpilot Business акаунт (API-то е част от платен абонамент), от който идват ключът, тайният ключ и business user ID. В касата при всеки начин пише "Кой се грижи за това?".
• Приложение на доставчика (чрез клиентския портал): ако Google приложението и/или Trustpilot приложението на доставчика са в клиентския портал (вижте README на horecapos-portaal, "Reviews: apps van de leverancier"), администраторът избира в Вход и ключове Приложение на доставчика (по подразбиране при нова връзка, ако порталът има приложението). Заведението натиска Свързване с Google или Вход с Trustpilot и влиза със собствения си акаунт; касата сама изчаква входът да приключи (на всеки 3 секунди, най-много 15 минути) и еднократно взема tokens от портала. Подновяването също минава през портала. В касата не са нужни client-ID, secret или API ключ; за Trustpilot са нужни домейнът и, за отговори, business user ID. Публичният Trustpilot тогава чете чрез ключа на портала. Изисква PORTAAL_URL и PORTAAL_SLEUTEL. Собствено приложение или API ключ продължава да работи, както е описано по-долу.
• Чии са отзивите: те остават в собствения бизнес профил в Google и на собствената страница в Trustpilot на заведението, а касата ги пази само в собствената си база данни. Отговорите се появяват под името на заведението. Порталът само предава входа (в паметта, най-много 15 минути, може да се вземе веднъж) и не пази отзиви или tokens; името на приложението на доставчика се вижда само на екрана за съгласие.
• Регистрирайте се сами: при всяка платформа има връзка, за да създадете сами бизнес профил в Google (business.google.com/create) или акаунт в Trustpilot Business (business.trustpilot.com), а при Trustpilot — и към абонаментите (business.trustpilot.com/plans). Регистрацията и плащането стават в самата платформа; за това няма API.
• След това Свързване с Google и влезте с акаунта, който управлява бизнес профила. Един обект в профила = избира се веднага; повече = избор в касата.
• Google Places (само четене): с Place ID и API ключ за Places API (или GOOGLE_PLACES_API_KEY): средната оценка, броят отзиви и 5-те най-релевантни отзива. Така не може да се отговаря.
• Trustpilot Business (четене и отговор): API ключ и API тайна на приложение в Trustpilot Business (Integrations → API; или TRUSTPILOT_API_KEY и TRUSTPILOT_API_SECRET), домейнът на заведението (касата сама намира business unit) и, за отговорите, business user ID на отговарящия.
• Trustpilot публичен (само четене): само API ключът.
• Касата изтегля на всеки 30 минути (и веднага след свързването; Изтегли сега). Имейл адреса и номера на поръчката на госта (които Trustpilot предава) касата не съхранява.
• Отчет → Отзиви: средна оценка, брой по звезди, без отговор и непрочетени; филтриране по платформа, звезди, без отговор и непрочетени. За всеки отзив Отговори (най-много 4000 знака; всеки може да го прочете), Промени отговора, Премахни отговора и Прочетено. Нов или променен отзив е непрочетен. В дневника се записват review_beantwoord и review_antwoord_weg.
• При прекъсване на връзката изтеглените отзиви се запазват.

SMS и имейл маркетинг

Съобщения до клиенти с клиентска карта, които са дали съгласие за това. Без клиентска карта нито едното, нито другото може да се включи.

• Съгласие за всеки клиент и всеки канал: при нов клиент на касата има отметки "Клиентът желае да получава акции по SMS" и "... по имейл" (по подразбиране изключени). В Отчет → Клиенти виждате и променяте съгласието (с датата, на която е дадено) и рожден ден (само ден и месец). Отписване: махнете отметките и запазете.
• Менюто се обновява веднага: ако включите или изключите маркетинга или клиентската карта, касата до няколко секунди изпраща менюто отново към онлайн магазина (само ако нещо се е променило), така че отметката веднага се появява или изчезва.
• Съгласие чрез онлайн магазина: ако заведението има онлайн магазин, при плащане има отметка "Искам да получавам оферти по имейл/SMS" (само включените канали; по подразбиране неотметната). Когато пристигне такава поръчка, касата търси клиента по телефонен номер (иначе по имейл адрес), при нужда го създава и записва съгласието с датата. Липсващ номер или адрес при съществуващ клиент се допълва; в дневника стои klant_toestemming с източник webshop.
• Отчет → Маркетинг (право Управление на клиентската карта): най-горе е посочено колко клиенти са дали съгласие за SMS и за имейл.
• Акции (еднократни): име, SMS или имейл, (тема,) текст с {naam}, {zaak} и {punten}, и по желание само клиенти, които не са идвали известно време или имат поне толкова точки. Преглед показва до колко клиенти отива, съобщението така, както ще го получи клиентът, и броя SMS-и на клиент. Изпрати тест до своя номер или адрес. След това Изпрати: касата изпраща във фонов режим (най-много 1000 наведнъж) и брои какво е изпратено и какво е неуспешно. Никой не получава една и съща акция два пъти; ако касата спре по средата, Продължи изпращането продължава с онези, които още не са получили нищо.
• Изпращане чрез Mailchimp или Klaviyo (с връзка с избран списък, вижте по-долу): при промоция по имейл в Изпращане чрез избирате касата (собствения пощенски сървър, както по-горе) или Mailchimp или Klaviyo. Тогава касата първо обновява списъка (отписвания, точки) и създава там кампания точно за избраните клиенти, които са в списъка (Mailchimp: постоянна група в audience; Klaviyo: собствен списък за промоцията), и я изпраща с подателя по подразбиране на audience или на акаунта. {naam} и {punten} се попълват от Mailchimp/Klaviyo за всеки клиент; отдолу е връзката за отписване на услугата. Без ограничение от 1000 на изпращане и без персонален код за отстъпка ({code}). Ако не успее, промоцията остава чернова със съобщението до нея. Разделът Маркетинг се показва и когато е активна само връзката (тогава само промоции чрез Mailchimp/Klaviyo; Изпрати тест работи с пощенския сървър на касата). Автоматичните съобщения касата винаги изпраща сама; в Mailchimp/Klaviyo ги създавате като Customer Journey или Flow. Ключ за Klaviyo: и права за запис за Campaigns и Templates (ако вече сте влезли: влезте отново).
• Като push известие през онлайн магазина (ако в управлението на онлайн магазина са включени Push известия с оферти): в Изпращане чрез изберете Push известие (онлайн магазинът като приложение), със заглавие (най-много 60 знака) и кратък текст (най-много 200 знака; попълва се само {zaak}, защото онлайн магазинът не знае кой е гостът). Касата изпраща промоцията през портала за управление към онлайн магазина, а той я изпраща до гостите, които са включили там Оферти като известие; докосването отваря менюто на онлайн магазина. След няколко секунди при промоцията се вижда колко са доставени. Най-много 3 на ден, заедно с това, което заведението изпраща от управлението на магазина; иначе промоцията остава чернова с посочена причина. Разделът Маркетинг се показва и когато е включено само това (без клиентска карта или имейл маркетинг). Без код за отстъпка или подбор (дни, точки); за тест: на собствения си телефон включете Оферти като известие в онлайн магазина.
• Автоматично: съобщение за рожден ден (на рождения ден, веднъж годишно) и "липсвате ни" (след толкова дни без посещение, веднъж за всеки период, в който клиентът отсъства). Вкл./изкл. за всяко съобщение; изпращат се само през деня (10:00–20:00).
• Персонален код за отстъпка (по избор, за всяко съобщение или промоция; само ако Кодове за отстъпка са включени в Настройки → Заведение): всеки клиент получава собствен код, напр. TERUG-7K4Q2M (рожден ден JARIG-…, промоция ACTIE-…), в проценти или фиксирана сума, по желание с минимална сума на поръчката, за еднократна употреба, валиден зададения брой дни след изпращането (по подразбиране 30) и на касата и/или в онлайн магазина. Поставете {code} и {geldig} в текста, където искате; иначе касата добавя под съобщението "Uw kortingscode: … (10% korting, aan de kassa of in de webshop, geldig t/m …)". Преглед и Изпрати тест показват примерен код (TERUG-VOORBEELD, не работи). Ако изпращането не успее, кодът не се създава. При промоцията се вижда колко кода са издадени и използвани.
• Отписване има под всяко съобщение: при SMS "Отписване? Обадете се на ... или кажете при следващото си посещение", при имейл връзка за отписване към имейл адреса на заведението (също и бутона Отписване в Gmail и Outlook). Отговорът на имейла отива до заведението.
• Поверителност (GDPR): само клиенти със съгласие и с номер или адрес; в дневника няма номера или адреси, но за всяка акция пише колко са изпратени и колко са неуспешни. Ако изтриете клиент, той изчезва и от списъка за изпращане.
• Разходи: SMS-ите минават през вашия акаунт в CM.com (над 160 знака = повече SMS-и на клиент). Gmail и другите пощенски сървъри имат дневен лимит; при много клиенти изпращайте на части.

Бакшиш по служител

В Настройки → Заведение → Бакшиш (само ако "Показване на бутони за бакшиш при плащане" е включено) избирате как бакшишът по служител да се показва в междинния отчет (X), Z-отчета (бележка и имейл) и Оборот за период (също в CSV):

Останалите центове отиват при този, който е най-близо до следващия цент, така че сумата винаги да е точна. Това е само преглед: касата не изплаща нищо (това става с "Изваждане на пари от чекмеджето"). Старите Z-отчети остават каквито са били.

Z-отчет по имейл

Въведете еднократно имейл адреса на администратора в Настройки → Заведение → Изпращане на Z-отчета до (повече адреси: разделени със запетая, макс. 3). След Дневно приключване Z-отчетът автоматично се изпраща до този адрес, освен отпечатаната бележка. Празно = без имейл, както винаги.

• Изпращането става във фонов режим, така че бавен пощенски сървър да не забавя дневното приключване.
• Неуспешно или нужно още веднъж: Отчет → Предишни Z-отчети → (отчет) → Изпрати отново (с надпис КОПИЕ).

Обобщение на деня (по избор)

Ако има адрес в Изпращай Z отчета по имейл до, под него има отметка С кратко обобщение на деня в началото на имейла (по подразбиране изключено). Вкл. = в началото на имейла със Z отчета няколко реда на обикновен език, само от собствените данни на касата (без AI, нищо не излиза навън):

• оборот, бонове и гости и средна сума на бон, спрямо същия период седмица по-рано (в проценти); ако тогава не е имало нищо, това се посочва;
• 5-те най-продавани продукта и какво се откроява: продукти, от които са продадени поне 3 повече или по-малко от миналата седмица;
• броят сторна (спрямо миналата седмица) и най-натовареният час (бонове и оборот).

Самият Z отчет (бон и имейл) остава точно същият. Преглед за днес показва обобщението от последното приключване на деня до сега. Обобщението е на нидерландски, както и имейлът със Z отчета.

Табло

Раздел Табло в Отчет (право Оборот за период), само за четене:

• Оборот по часове като графика: избраният ден (синьо) до същия ден миналата седмица (сиво). Днешният ден се сравнява с миналата седмица до същия час, за да е честен процентът. С ◀ ▶ или датата избирате друг ден.
• Плочки: оборот (± % спрямо миналата седмица), бележки и средно на бележка, среден разход на гост (само на място; за вкъщи/доставка не се броят) за този ден и за избрания период.
• Топ 10 продукта и най-натоварени часове за последните 7, 28 или 90 дни. Най-натоварените часове са топлинна карта ден от седмицата × час (среден оборот на работен ден) с трите най-натоварени часа отгоре, удобно за графика на смените.

Продадените ваучери за подарък не се броят за оборот, а отстъпките и заглавията на менюта не влизат в топ 10 (както в другите отчети). Един ден продължава от 00:00 до 24:00.

Допълнителни отчети

Три допълнителни раздела в Отчет, всеки се включва отделно от Настройки → Заведение → Управление и отчети → Допълнителни отчети (по подразбиране изключено: тогава няма раздел). Изискват същото право като Оборот за период и са само за четене. Период: тази седмица, миналата седмица, този месец, миналия месец, последните 90 дни, тази година или избран от вас (най-много малко над една година).

• Menu engineering: за всеки продукт колко често е продаван (дял от всички продадени бройки) спрямо какво носи на бройка (марж = продажна цена без ДДС минус себестойността). Всеки продукт получава категория: Звезда (популярен и с голям марж: оставете го така), Работен кон (популярен, малък марж: вдигнете малко цената или го направете по-евтино), Пъзел (малко продаван, голям марж: покажете го по-добре) и Куче (малко продаван, малък марж: махнете го от менюто или го заменете). Популярен = поне 70% от равния дял; голям марж = поне средният марж на продадена бройка. Себестойността идва от Apicbase (Настройки → Рецептури), иначе от покупната цена на продукта (покупна цена за опаковка, разделена на броя в опаковката), иначе от рецептата от съставки с покупна цена (Наличност). Продуктите без себестойност са отделно най-долу. По избор по продуктова група (?groep=).
• Промоции и кодове: за всеки код за отстъпка, за всяка акция от Маркетинг (личните кодове заедно) и за всеки happy hour: колко пъти е използван (бележки; при happy hour и бройките), колко е отстъпката, оборотът и средната стойност на бележка.
• Загуби: какво е отписано от наличността (Настройки → Наличност, Отпиши (−)), по причина (главните букви и интервалите нямат значение) и по продукт или съставка, със стойността по себестойност; и какво е анулирано, след като вече е изпратено към кухнята или бара, с продажната стойност и себестойността.

Отстъпки

Мениджър или администратор вижда в екрана за поръчки до общата сума бутона % Отстъпка:

• върху цялата бележка или върху един ред;
• като процент (10, 15, 20, 25, 50, 100% = безплатно, или въведете сами) или като фиксирана сума;
• винаги с причина (Персонал, Редовен клиент, Оплакване, Промоция, Лична консумация или въведете сами).

Отстъпката излиза като отделен ред на бележката ("Отстъпка 10%", с причината отдолу) със същата ставка на ДДС, така че общата сума и разбивката по ДДС да са точни. При цялата бележка отстъпката се разпределя по ставка на ДДС. Премахване: докоснете сумата на реда с отстъпката. Ако ред със собствена отстъпка бъде анулиран, отстъпката също отпада. Ако премахнете продукт от бележка с процентна отстъпка за цялата бележка, касата преизчислява отстъпката за останалото (в Белгия UC226); фиксирана сума остава и при плащане отново се разпределя по редовете. Ако заради 100% отстъпка няма нищо за плащане, приключвате с "Приключи (нищо за плащане)". Отстъпките се записват в дневника, а в X/Z-отчета и в отчета за периода като "от които отстъпка". При връщане на бележка с отстъпка, отстъпката се връща пропорционално.

Кодове за отстъпка (по избор)

Кодове с отстъпка за цялата бележка, например за промоция (ZOMER10). Включват се в Настройки → Заведение → Кодове за отстъпка (по подразбиране изключено); кодовете създавате в Настройки → Кодове за отстъпка (право Управление на продукти):

• отстъпка в проценти или фиксирана сума, по желание с минимална сума на поръчката, валиден от/до и най-много толкова пъти (празно = неограничено);
• за всеки код: на касата и/или в онлайн магазина (касата изпраща кодовете заедно с менюто; използването се брои общо за касата и онлайн магазина).

На екрана за поръчки има бутон Код за отстъпка (всеки може да въведе код; кодът е създаден предварително от заведението). Отстъпката се появява като ред "Код за отстъпка CODE" на бележката, разпределена по ставките на ДДС; един код на бележка и не повече, ако вече е платено (частично). Ако премахнете реда или поръчката бъде анулирана, използването вече не се брои. Премахването на използван код го изключва (отчетите остават точни). Всичко е в дневника (Код за отстъпка). Код: lib/kortingscodes.ts, routes/kortingscodes.ts, Kortingscodebeheer.tsx, KortingscodeDialoog.tsx.

Те не се показват в списъка в Настройки → Кодове за отстъпка (но броят за всяка промоция се вижда в Отчет → Маркетинг) и се прехвърлят към онлайн магазина, докато са валидни и неизползвани.

Отчети и дневно приключване

Бутон Отчет в горната лента:

• Междинен отчет (X): оборот, ДДС, начини на плащане, по група и касовото чекмедже от последното дневно приключване. Може и да се отпечата. Не приключва нищо.
• Дневно приключване (Z) (мениджър или администратор): преброяване на касовото чекмедже (показва се разликата спрямо началната сума + в брой), въвеждане на началната сума за следващия ден, приключване. Z-отчетът получава пореден номер, запазва се и се отпечатва на принтера за бележки. Не е възможно, докато има отворени поръчки. По избор: Преброяване по монети и банкноти (помощник) попълва преброената сума вместо вас; преброяването по монета/банкнота тогава излиза и в Z-отчета. Ръчното въвеждане на общата сума работи както винаги.
• Касово чекмедже (мениджър или администратор, по избор):
  • Изваждане на пари от чекмеджето (внасяне в банка, разход, изплатен бакшиш) или внасяне на пари в чекмеджето (дребни за ресто) със сума и причина. Чекмеджето се отваря и се отпечатва бележка с ред за подпис, която да се пази при парите (може да се изключи). Включва се в очаквано в чекмеджето и се показва на отделен ред в X- и Z-отчета.
  • Въвеждане или коригиране на началната сума за днес (обикновено я въвеждате при дневното приключване за следващия ден).
  • Отваряне на чекмеджето без продажба, с причина.
  • Всичко се записва в дневника. Ако не използвате това, дневното приключване работи точно както преди (начална сума + в брой = очаквано в чекмеджето).
• Под оборота е броят на гостите (хората от платените поръчки) и средното на гост, също и в отпечатания X/Z-отчет.
• Оборот за период (мениджър или администратор): днес, вчера, тази/миналата седмица, този/миналия месец, тази година или изберете сами от-до. Показва оборот, ДДС, начини на плащане, бакшиш, гости, продуктови групи, по ден и по служител. С Експорт (Excel/CSV) получавате файл за счетоводителя (точка и запетая и десетична запетая, отваря се директно в нидерландски Excel).
• Предишни Z-отчети: списък с оборот и касова разлика; отваряне и печат на копие (с надпис "КОПИЕ").

Експорт към счетоводството

Отчет → Оборот за период → Експорт за счетоводство (журнал) (право Оборот за период) създава CSV с по една счетоводна статия на ден, готов за зареждане в e-Boekhouden, Exact, SnelStart, Twinfield и др. (чрез техния импорт на CSV или на мемориални ордери), или един от форматите по-долу (UBL, XAF и готови формати за 14 програми).

За всеки ден един документ (KASSA-JJJJMMDD), който винаги е балансиран (дебит = кредит):

Връщанията и отстъпките вече са включени в бележките и намаляват оборота. Колони: Datum; Boekstuk; Dagboek; Rekening; Omschrijving; Debet; Credit; Btw-code; Btw-% (точка и запетая, десетична запетая). След изтеглянето касата съобщава дали има дни, които не са балансирани или имат по-голяма разлика от закръглянето.

До бутона избирате формата (изборът се запомня в браузъра). Същият журнал, но оформен така, че програмата да може директно да го зареди. Списъкът показва само форматите за държавата на заведението (Настройки → Заведение), първо стандартите (CSV, UBL, XAF), после програмите по азбучен ред:

Преглед: коя счетоводна програма по какъв начин

По сегменти, по азбучен ред. NL/BE = в коя държава работи програмата: в Настройки → Счетоводство → Счетоводна програма виждате само програмите за държавата на заведението (нидерландските програми не работят в Белгия и обратно). На живо = касата осчетоводява сама всеки ден (избира се в Настройки → Счетоводство → Счетоводна програма); при заявка = има API, но първо изисква партньорска регистрация или одобрение от доставчика (уведомете ни). Файл = форматът в Експорт за счетоводство. Където са възможни и двете, можете да използвате и двете. Списъкът е в packages/shared/src/boekhoudcatalogus.ts и се показва също в Настройки → Счетоводство.

Нека счетоводителят провери първия импорт. Форматирането е в packages/shared/src/journaalexport.ts (с тестове).

Настройки → Счетоводство (право Настройка на заведение, плащане и принтери): код на дневника (по подразбиране MEM) и счетоводната сметка за всяка позиция. Празно = примерна сметка (NL: 8000/8010/8020 оборот, 1500/1510 ДДС, 1000 каса, 1100 карта; BE: 7000xx оборот, 451000 ДДС, 570000 каса). Оставете счетоводителя да попълни истинските сметки.

Връзка със счетоводна програма

Връзки на живо с Acumulus, AFAS Profit, Microsoft Dynamics 365 Business Central, Exact Online, Horus, Moneybird, Odoo, QuickBooks Online, SAP Business One, Silvasoft, SnelStart, Twinfield, Xero, Yuki и Zoho Books. След всеки ден касата осчетоводява същия журнал като експорта по-горе (оборот и ДДС по ставка, начини на плащане, бакшиш, закръгляне, чекмедже и касова разлика) като мемориален ордер в избраната програма, с дневника и счетоводните сметки от Настройки → Счетоводство. Винаги е включена най-много една програма.

• Списъкът е разделен по сегменти (малки фирми и самостоятелно заети, международни, enterprise и вериги) и показва само програмите, които работят в държавата на заведението; сървърът отказва програма от друга държава (400) и не осчетоводява с нея (409). Точно под него администраторът получава точно полетата на тази програма; свързването и списъкът с осчетоводени дни са под счетоводните сметки, а под тях е прегледът на всички програми за тази държава. Ако при обновяването са били включени две (в по-стара версия това беше възможно), Exact Online остава включен, а другата програма се изключва.

• OAuth (Horus, QuickBooks, Twinfield, Xero, Zoho): еднократна регистрация на приложение в програмата.
• При някои програми полетата на API не могат да бъдат напълно потвърдени от публичната документация (между другото Horus, Zoho Books, знакът при Business Central и структурата при SAP Business One): винаги давайте първото осчетоводяване за проверка на счетоводителя.
• Exact Online: осчетоводява журнала като мемориален ордер в избраната администрация.
  • Избира се в Настройки → Счетоводство → Счетоводна програма → Exact Online (по подразбиране Изкл.). Белгия: касата автоматично използва start.exactonline.be.
  • Настройки → Счетоводство → Exact Online: Свържи с Exact Online отваря влизането в Exact; след това пише с коя администрация е свързана касата. В Дневник въведете кода на мемориален дневник в Exact (напр. 90) и се уверете, че счетоводните сметки съществуват в Exact.
  • Кога: веднага след Приключи деня и след това всеки час, за всички изминали дни (до вчера включително) от Осчетоводяване от (по подразбиране денят на свързване; по-ранните дни счетоводителят вече ги има). Всеки ден веднъж; дните без оборот се пропускат. Осчетоводи сега може винаги.
  • Грешки (сметка не съществува в Exact, денят не се балансира, няма интернет) се показват с причината при съответния ден; касата опитва отново по-късно, а следващите дни чакат, докато успее (така редът остава правилен). В дневника: "exact_geboekt".
  • ДДС е по счетоводните сметки за ДДС (без код на ДДС, както и в експорта). Нека счетоводителят ви провери първите осчетоводявания.
  • Exact: връзката работи, докато касата я използва (на всеки 10 минути нов токен, всеки път нов refresh token). Ако е отменена или не е използвана твърде дълго, касата иска Свържи отново. Прекъсни връзката изтрива токените; осчетоводеното остава.
• AFAS Profit: номер на средата (напр. 12345; продукция, тест или приемане), токенът на app-connector с UpdateConnector FiEntries и номерът на администрацията (по подразбиране 1). Дневник = кодът на мемориален дневник в AFAS (напр. 90).
• Дневник = номер или име на мемориален дневник; ако има само един мемориален дневник, касата взема него. Счетоводните сметки трябва да са номера.
• Twinfield: вход с OAuth. Без това приложение касата не може да се свърже. Касата намира клъстера и администрацията (празно = първата); дневник = кодът на мемориален дневник (напр. MEMO). Осчетоводява окончателно (destiny="final").
• Yuki: API ключ на администрацията (Yuki → Настройки → Уеб услуги); празна администрация = първата за този ключ. Осчетоводява мемориален ордер (GeneralJournal); Yuki не използва код на дневник.
• Кога: веднага след Приключи деня и всеки час, за всички изминали дни от Осчетоводяване от (по подразбиране денят на свързване; при друга програма отново от този ден). Всеки ден по веднъж за програма; дни без оборот се пропускат; при грешка причината стои при този ден, а следващите дни чакат. Осчетоводи сега може винаги. В дневника: "boekhoudpakket_geboekt".
• Ключовете и токените никога не се показват на екрана (оставете празно при повторно свързване = запази). В копието на касата на портала не се осчетоводява.

Одитен файл на касата (XAA)

За нидерландските заведения в Отчет → Оборот за период до експорта за счетоводство има бутон Одитен файл на касата (XAA): XML Auditfile Afrekensystemen 3.2 на нидерландската данъчна администрация (Belastingdienst) и XML Platform (SRA) за избрания период (най-много малко над година; право Оборот за период). Това е файлът, който Belastingdienst препоръчва за предоставяне на данните от една каса при проверка или на счетоводителя; правилата са в Handreiking voor een betrouwbaar afrekensysteem (Ръководство за надеждна касова система, docs/xaa).

Във файла (auditfile_kassa_<van>_tm_<tot>.xml, схема docs/xaa/XmlAuditfileAfrekensystemen3.2.xsd):

• основни данни: заведението (име, ДДС номер, адрес), кодовете за ДДС, всички служители (с роля и дата на създаване; плюс SYSTEEM за това, което касата прави сама, като уеб магазина и връзките) и всички артикули с тяхната група;
• събития: всичко от дневника за периода (вход и изход, отворено касово чекмедже, приключване на деня, променени настройки и цени, сторно, отстъпка, връщане, копие на бележка, влизане и излизане на смяна ...) и отварянето на касовия ден с началната наличност, всяко с кода на Belastingdienst (18001 вход, 18003 чекмедже, 18006 промяна в инсталацията, 18008 Z-отчет, иначе 18999);
• касови транзакции: всяка бележка (продажба, връщане и проформа, с номера на бележката, служителя и фискалния статус, ако не е наред) с всички редове (артикул, група, количество, цена, ДДС; също отстъпки, ваучери за подарък, заглавия на менюта и редове, анулирани преди плащането – тези със сума 0), ДДС по ставка, закръглянето, плащанията по начин на плащане (в брой, карта, ваучер за подарък, онлайн; бакшиш отделно) и парите, вкарани/изкарани от касовото чекмедже.

Сумите са положителни с C (продажба, постъпление) или D (връщане, изплащане); часовете са в нидерландско време с отместване. Всички ключове са id-тата от базата данни без тирета, така че могат да се намерят в касата.

Подписване (глава 6 от спецификацията): ако Optimum POS е настроил сертификат, одитният файл идва подписан в плик (XML Signature) и файлът се казва …_ondertekend.xml; иначе е самостоятелен одитен файл и касата съобщава това при изтеглянето.

Плащане по сметка

Бизнес клиентите (фирма, която всяка седмица поръчва обяд, хотел, сдружение) купуват по сметка и плащат по-късно с фактура. Включва се от Настройки → Фактури → Плащане по сметка (само при включени Фактури; по подразбиране е изключено).

• Клиенти: в Отчет → По сметка добавяте бизнес клиентите с данните за фактурата (име, адрес, ДДС номер, KvK номер / номер на предприятието, Peppol-ID, имейл), по желание лимит (колко най-много може да е неплатено) и собствен срок за плащане (иначе този от фактурите), както и дали фактурата да се изпраща веднага.
• Плащане: начин на плащане По сметка, изберете клиента (виждат се неплатеното до момента и лимитът). Бележката е обикновена продажба: оборот и ДДС за този ден, в Белгия както обикновено през черната кутия, на бележката „По сметка“. Касата веднага създава фактурата (UBL/Peppol и за печат) с оставащата сума и падежа и я изпраща, както е настроено при фактурите (имейл, Peppol чрез Billit/Storecove/Banqup или собствения адрес). По сметка е една сума за остатъка от сметката (първо може част да се плати по друг начин), без бакшиш; ваучер не може да се продава по сметка. Над лимита касата отказва.
• Плащане от клиента: клиентът плаща в обекта в брой, с карта или с ваучер (Отчет → По сметка → Плащането е получено; може и частично). Това не е нова продажба и не е нова касова бележка: в брой влиза като пари в чекмеджето (чекмеджето се отваря), всичко е в X и Z отчетите под Получено по сметка. Когато всичко е платено, фактурата е „платено“. Онлайн плащане не е част от това.
• Превод: ако в Данни във фактурата има IBAN, той се показва във фактурата (и в UBL) с "Може да платите и в обекта". Ако клиентът е превел сумата, отбелязвате го с Плащането е получено → Преведено (банка): не в чекмеджето, но в X и Z отчетите под „Получено по сметка“. Без IBAN пише "Плащане в обекта". В Белгия във фактурата и в UBL има структурирано съобщение (+++123/4567/89012+++, от номера на фактурата), което банката предава заедно с плащането.
• Банка: разнасяне на преводи без преписване, вижте по-долу.
• Баланс (пари предварително): в Отчет → По сметка → Зареди баланс внасяте пари предварително по сметката на клиент, в брой (чекмеджето се отваря) или с карта, напр. за серия обеди. При следващата продажба по сметка балансът първо се приспада от фактурата; ако фактурата е по-голяма, остатъкът остава отворен. Балансът се вижда при клиента (баланс € ...), в X и Z при Получено по сметка (Внесен баланс, С баланса на клиента) и в счетоводния журнал като получено предварително (по подразбиране 1640 / 460000). В Белгия внасянето отива като пари вход (signMoneyInOut) към черната кутия (UC4100).
• Обобщена фактура (за клиент, по подразбиране изключено): с Една фактура за всички бележки клиентът още не получава фактура при продажба по сметка. Бележката остава отворена при клиента (Още нефактурирани бележки, брои се към лимита) и вече може да бъде платена. С Създай обобщена фактура (напр. в края на месеца) всички отворени бележки влизат в една фактура, всеки ред с номера на бележката пред него; каквото вече е платено, стои като платено. Връщане към сметката влиза като отрицателни редове. Изключено = както винаги по една фактура за всяка продажба. В Белгия една фактура с всички бележки в черната кутия (signInvoice, UC4121 и UC4122).
• Белгия: ако клиентът плати по-късно продажба по сметка (в брой, с карта, ваучер или превод), касата отчита това като корекция на плащане на бележката: от клиентски кредит към реалния начин на плащане (signPaymentCorrection, UC4118).
• Преглед: неплатени фактури с падежа (просрочените в червено), по клиент фактурите и плащанията. В Настройки → Фактури колона Неплатено.
• Счетоводство: в журнала продажбата по сметка отива към Вземания от клиенти (по подразбиране 1300 в Нидерландия, 400000 в Белгия; настройва се от Настройки → Счетоводство), а плащането – от каса, карта, ваучер или банка (по подразбиране 1050 / 550000) към вземания от клиенти. XAA: начин на плащане „По сметка“.
• Право: Плащане по сметка и получаване на плащания по сметка (по подразбиране сервитьор не, мениджър да). Всичко се записва в дневника.
• Изключено: клиентите, фактурите и плащанията се запазват (и в резервното копие); превключвателят влиза в експорта на конфигурацията, клиентите не (те принадлежат на един обект).
• В онлайн магазина (по избор, по подразбиране изключено): с И в онлайн магазина бизнес клиентите поръчват онлайн по сметка (за вкъщи и доставка). В Отчет → По сметка създаваш за всеки клиент клиентски код и го даваш на клиента; касата пази само криптирана версия, затова го виждаш само веднъж. Нов клиентски код = старият вече не работи; Премахни клиентския код = този клиент вече не може да поръчва онлайн по сметка. Онлайн магазинът спазва лимита. В прозореца Онлайн магазин приключваш такава поръчка с Приключи (по сметка): плащане по сметка, веднага с фактурата.

Банка: разнасяне на преводи

В Отчет → По сметка → Банка касата търси за всяко постъпление съответната фактура по сметка:

• Зареждане на банково извлечение: файлът от онлайн банкирането, като CAMT.053 (XML, всички банки в Нидерландия и Белгия), MT940 (.sta/.940) или CODA (.cod, Белгия). Само постъпления; двукратното зареждане на едно извлечение не създава дублирани редове.
• Търсене: по номера на фактурата или структурираното съобщение в описанието (сигурно), иначе по сумата (и името): тогава е предложение. Всеки ред можете да разнесете (към предложената или друга фактура), да игнорирате или по-късно все пак да разнесете. Разнасяне = Преведено (банка) с банковата дата, никога повече от неплатената сума; не в чекмеджето.
• Банкова връзка (PSD2, по избор): в Настройки → Фактури → Банкова връзка касата сама изтегля постъпленията всеки час чрез Enable Banking (банки в Нидерландия, Белгия и останалата част от Европа). Изберете банката и влезте в нея (фирмена сметка); съгласието важи 180 дни, след това свържете отново. Прекъсването на връзката оттегля съгласието; постъпленията остават. Без договор с Enable Banking това работи само за собствените ви сметки (restricted production).
• Автоматично разнасяне (по подразбиране изключено): постъпление, което сигурно е към фактура, касата разнася веднага (и при зареждане).
• Право: разнасяне с Плащане по сметка и получаване на плащания по сметка; настройка на банковата връзка с Настройка на обект, плащания и принтери. Зареждането, свързването, изтеглянето и разнасянето се записват в дневника.
• Изключено: при изключено плащане по сметка касата не изтегля нищо; постъпленията и връзката се запазват (и в резервното копие).

Образи от камерите в касата

Всички образи от камерите на заведението на една страница, без отделен екран или приложение. Включете го в Настройки → Заведение → Екрани и управление → Образи от камерите в касата (по подразбиране изключено). Тогава бутонът Камери се появява в горната лента за тези с право Преглед на образи от камерите (по подразбиране мениджър и администратор; в Настройки → Права може да се включи и за сервитьорите). Всички камери са една до друга; докоснете камера за голям образ. При изключване системите за камери остават запазени.

Също и като отделен екран: На отделен екран отваря http://<kassaserver>:3000/camera (напр. монитор зад бара), а На таблет или телефон показва QR код: служител го сканира със своя таблет или телефон и влиза със своя ПИН (и там само с правото Преглед на образи от камерите). На тесен екран камерите са една под друга. Вижте Втори екран на таблет или телефон.

Администраторът добавя системите за камери с + Система за камери, тества ги с Тествай и избира за всяка камера името и дали е на страницата:

• Hikvision, Dahua, Axis и Reolink: камера или рекордер (NVR) в мрежата: IP адресът (евентуално с :poort), потребител (за предпочитане само за гледане) и каналите, напр. 1-8 или 1,3,5. Влизане с Basic или Digest; позволен е https със собствен сертификат.
• Synology Surveillance Station: адресът на NAS (порт по подразбиране 5000, с https 5001) и потребител; Извличане на камерите извлича камерите с имената им.
• UniFi Protect: адресът на конзолата (https) и локален акаунт; Извличане на камерите.
• ONVIF: всяка камера или рекордер с ONVIF (напр. Hanwha, Bosch, Uniview, Annke); Извличане на камерите намира адреса на снимката за всеки видеоизточник.
• Собствен уеб адрес: снимка (JPEG), MJPEG поток или rtsp:// адрес.
• Уеб страница на системата за камери (напр. Frigate, Blue Iris или go2rtc): отваря се в касата с бутона Камери (или в отделен прозорец).

Без ffmpeg: снимката.

Поверителност: касата извлича образите от системата за камери и само ги препраща; нищо не се записва (без записи, без кеш). Потребителите и паролите остават на сървъра и никога не се показват на екрана или в дневника. В дневника се вижда кой е гледал камерите. Самите образи страницата изисква с ключ (валиден 12 часа, докато служителят е влязъл), защото образ в браузъра не може да изпрати токен. Експортът на конфигурацията включва само вкл./изкл.

Дневник на чувствителни действия

Отчет → Дневник (мениджър или администратор) показва кой какво е направил и кога.

• Изберете период (днес, вчера, тази седмица, този/миналия месец или сами от-до), какво искате да видите (по подразбиране Чувствителни действия, или напр. само сторно и отстъпки, или Всичко) и при желание един служител.
• Горе по служител: брой и сума на сторната (изтрити след поръчка), отстъпки и връщания, колко пъти чекмеджето е отваряно без продажба, изваждане на пари от чекмеджето, копия на бележки, проформи и ръчно плащане с карта. Докоснете име, за да видите само този служител. Също и колко пъти е въведен грешен ПИН код.
• Под това всяко действие с час, кой, какво и разбираемо описание (напр. "2x Кола изтрита след поръчка € 5,60 · маса 4 · причина: клиентът се отказа").
• Изтегляне (CSV) за Excel.

Какво се записва: сторна, отстъпки (и премахването им), връщания, копия на бонове, проформи, ръчни плащания с карта, отваряне на чекмеджето, пари в/от чекмеджето, начална сума, дневно приключване, преместване на редове или маси, затваряне на празни поръчки, промяна на цена/име/ДДС на продукти, нови или изтрити продукти, промени в персонала и настройките, коригиране на работното време, вход и изход, грешни ПИН кодове и отбелязване на начало и край на смяна. С плащане по сметка и: клиенти, продажби и плащания по сметка, зареждане на банкови извлечения, банковата връзка и изтеглянето от банката. С известието при твърде дълго време за изпълнение: закъснели поръчки и изпратени извинения. С Mailchimp или Klaviyo: свързване, избор на списък, прекъсване на връзката и отписвания оттам. С управление на музиката: включване/изключване и добавяне, промяна и премахване на музикални източници. С образи от камерите: кой е гледал камерите (най-много веднъж на половин час на служител), включване/изключване и системите за камери. При сигнализиране: всеки сигнал, приключването му и включването и изключването.

Сигнализиране: измами и отклонения

Настройки → Сигнализиране. Две части, всяка се включва отделно и по подразбиране е изключена; изключването запазва всички сигнали и настройки. Настройва този, който има правото Настройка на сигнализирането (по подразбиране мениджърът и администраторът); сигналите вижда и приключва този, който може да вижда дневника. Касата проверява на всеки 5 минути (и с Провери сега); не на сенчестата каса.

Сигнализиране за измами и кражби (по служител, за работен ден от 05:00), всяко правило се включва отделно със собствен праг:

• сторно след про форма: премахнато, след като гостът вече е видял сметката;
• сторно, отстъпки и връщания: от определен брой пъти или общо от определена сума (0 = не по сума);
• чекмедже отворено без продажба (бутон „Отвори чекмеджето“);
• сметка дълго отворена: поръчано, но след определен брой минути още неплатено.

Известия при отклонения, сравнени със същия ден от седмицата и същия час през последните седмици (по подразбиране 4; дни без оборот не се броят, поне два дни за сравнение):

• оборот досега с повече от толеранса по-нисък (и/или по-висок) от обичайното, само при обичаен оборот от зададена сума;
• време в кухнята (от изпращането на сметката към кухнята до готовност на кухненския екран) за последния час над толеранса или над фиксиран брой минути;
• сторно днес над толеранса, само от минимален брой.

Всеки сигнал идва веднъж (за правило, служител и ден; времето в кухнята най-много веднъж на час) и отива към:

• касата: бутон Сигнали (n) в горната лента със сигналите за последния ден, седмица или 30 дни; Приключено с бележка. Другите екрани получават само известие без имена;
• push известие с ntfy (безплатно приложение; ntfy.sh или собствен сървър, topic и евентуално токен), Pushover (API-токен на приложението и user key) или Telegram (токен на бота и chat-id);

За всеки канал има бутон Тестово съобщение. Токените и ключовете остават в касата (екраните виждат само дали са попълнени). Сигналът не е доказателство: прегледайте сметката и дневника и го обсъдете със служителя.

Бележки: копие и връщане (кредитна бележка)

Бутон Бележки в горната лента:

• Списък на бележките от последното дневно приключване или от последните 7 дни; по-стара бележка търсите по нейния номер.
• Печат на копие: същата бележка с надпис "КОПИЕ" (в Белгия с FDM блока на оригиналната бележка). Записва се в дневника.
• Връщане / кредитна бележка (мениджър или администратор): изберете за всеки ред колко се връща, причина и как се връщат парите (в брой, карта, ваучер, друго). Старата бележка остава непроменена: добавя се нова кредитна бележка със собствен номер в журнала (вид бон retour, отрицателни суми, в Белгия като NR към FDM). Никога не може да се върне повече, отколкото е продадено. В X- и Z-отчета връщането се брои като отрицателен оборот.
• При CCV или друг терминал: първо върнете парите на самия терминал, след това отметнете "Вече върнато на терминала".
• В брой със закръгляне до 5 цента: сумата за връщане също се закръгля.
• Обратно по сметката (продажба по сметка): ако бележката е била по сметка на бизнес клиент, изберете По сметка. Сумата се приспада от отворената фактура и касата веднага създава кредитно известие (в UBL CreditNote, тип 381, с препратка към фактурата; в Белгия подписано със signInvoice, UC4122). Повече от отвореното по фактурата не може да се върне по сметката; върнете остатъка в брой или с карта. Кредитното известие е в Фактури и се изпраща като фактура.

Касово чекмедже със сензор и чекмедже за всеки служител

По подразбиране изключено. Настройва се в Настройки → Плащания → Касово чекмедже.

• Сензор: много чекмеджета съобщават чрез принтера за бележки дали са отворени или затворени (ESC/POS DLE EOT 1, DK порт пин 3). Това е възможно само с мрежов принтер за бележки. Докоснете Измерване: чекмеджето затворено и Измерване: чекмеджето отворено; ако има разлика, приемате правилната настройка (високо = отворено или ниско = отворено). Няма разлика = това чекмедже (или кабел) няма сензор. Няма отговор от принтера = неизвестно, никога "затворено".
  • Без плащане, докато чекмеджето е отворено: тогава сървърът на касата отказва ново плащане със съобщението "Касовото чекмедже все още е отворено".
• Собствено чекмедже за всеки служител: принтерът за бележки може да отваря две чекмеджета (чекмедже 1 и чекмедже 2). Изберете чекмеджето на всеки служител; тогава касата при плащане в брой, внасяне/изнасяне на пари и Отвори чекмеджето отваря чекмеджето на влезлия служител. В Отчет → Касово чекмедже тогава има Чекмедже по служител: начална сума за всеки служител, в брой (без автомата за пари в брой), очаквано, Преброяване и разликата за всеки човек (в дневника като ladetelling). Обикновеното приключване на деня остава непроменено.
• Тест на чекмедже 1 и Тест на чекмедже 2 отварят чекмеджето за проверка.
• Отвори чекмеджето без продажба винаги се записва (с причина) в дневника и в одитния файл на касата (XAA), както изисква нидерландската данъчна администрация (Belastingdienst) (изключения като "no sale").

Част 3 · Администратор

Първи стъпки

Инсталиране. HorecaPOS се инсталира с инсталационната програма за вашата система, която ще намерите на страницата за изтегляне на OptimumPOS: Android (приложение), Windows (инсталационна програма), macOS (инсталатор за Mac с Apple Silicon и Intel), Linux (графичен инсталатор или пакет .deb или .rpm), Raspberry Pi (графичен инсталатор или .deb за Raspberry Pi 3, 4 или 5 с 64-битов Raspberry Pi OS) и Chromebook (приложението за Android от Google Play). Изберете за всички потребители за касов сървър, към който се свързват таблетите и кухненският екран, или само за мен само за каса на това устройство. Инсталаторът поставя всичко необходимо, включително базата данни, и прави архивно копие всяка нощ. Актуализирате, като инсталирате новата версия: данните ви се запазват. Инсталационната програма стартира на езика на компютъра (иначе на английски); при Windows и Linux на първия екран можете да изберете друг език. След това касата стартира веднага на този език. Пакетите .deb и .rpm и приложението за Android следват езика на системата, а иначе са на нидерландски.

Администраторът настройва касата чрез Настройки. Там има раздели като Заведение, Персонал, Права, Работно време, Продукти, Happy hour, Наличности, Планове, Плащане, Принтери, Счетоводство, Архивиране, Импорт/експорт и База данни. Кои раздели вижда и мениджърът, зависи от правата.

База данни. В Настройки → База данни (само администраторът) избирате между MySQL / MariaDB, вградената база данни и PostgreSQL; при превключване всички данни се прехвърлят (вижте База данни). Ако Optimum POS вече е задал фиксиран адрес при инсталацията, важи този адрес и полета за попълване няма. Иначе сами попълвате Сървър, Порт, База данни, Потребител и Парола. Касата ги запазва сама, след това ги показва отново попълнени и винаги можете да ги промените с Промяна на данните за MySQL/MariaDB или Промяна на данните за PostgreSQL. Да оставите паролата празна означава: запазената парола остава (за същия потребител). Инсталаторът и актуализацията не променят нищо в DATABASE_URL или в избраната база данни.

Счетоводство

Всичко за счетоводството е в Настройки → Счетоводство. Попълнете заедно със счетоводителя си дневника и счетоводните сметки. Ако искате касата сама да осчетоводява дневния оборот всеки ден, изберете програмата си най-горе в Счетоводна програма, включително Exact Online: виждате само програмите, които работят в държавата на вашето заведение. Точно под нея попълвате данните на тази програма и се свързвате. При програми, в които влизате с вход (например Exact Online, Twinfield или Xero), първо попълвате приложението: клиентски идентификатор и клиентски таен ключ. Ако Optimum POS е задал фиксирано програмата или дадена стойност при инсталацията, този избор или това поле не се показва. Там има и преглед на всички програми: кои могат да се свържат на живо и кои получават файл. Файл създавате в Отчет → Оборот за период → Експорт за счетоводство: изберете формата на вашата програма или UBL (Peppol), XAF или дневен отчет. Винаги давайте първото осчетоводяване или импорт за проверка на счетоводителя си.

За нидерландско заведение там има и Одитен файл на касата (XAA): XML Auditfile Afrekensystemen на нидерландската данъчна администрация (Belastingdienst) с всички бележки, редове, плащания и събития на касата за избрания период. Него давате на вашия счетоводител или при проверка на Belastingdienst.

Заплати и планиране

Ако персоналът ви отчита работното време (влизане и излизане), в Настройки → Работно време най-долу има Заплати и планиране, в два блока. В Ведомост за заплати избирате програмата си за заплати или (в Белгия) социалния си секретариат и попълвате за всеки служител неговия служебен номер в тази програма. След това създавате за даден период файла с отработените часове и оборота по служител и го зареждате в програмата за заплати. В Планиране на персонала избирате системата си за планиране: при Deputy, Dyflexis и Shiftbase оборотът отива автоматично всеки час, при останалите създавате файл с оборота. Така в планирането си виждате разходите за заплати до оборота. Ако работите без отчитане на работно време, пак можете да изпращате оборота към планирането си: тогава това е най-долу в Настройки → Счетоводство, при Оборот към вашето планиране. Ако Optimum POS е задал нещо фиксирано при инсталацията, няма да виждате този избор или това поле.

Архивиране

Касата прави резервно копие автоматично всяка нощ, както и винаги преди обновяване. В Настройки → Резервни копия виждате всички резервни копия (кога, от кого или автоматично, размер) и с Направи резервно копие можете да направите копие сами. Ако последното резервно копие е на повече от два дни, се появява червено предупреждение: тогава се свържете с Optimum POS.

Възстановяването става с бутона Възстанови до съответното резервно копие. Всичко, случило се след това копие, се губи. Трябва да отметнете квадратчето и да въведете отново своя ПИН код. Касата първо прави предпазно резервно копие на текущото състояние и след това излиза от профилите на всички. В Белгия това не може да стане от касата (броячите на черната кутия продължават); там го прави Optimum POS.

База данни

В Настройки → База данни (само администраторът) виждате къде касата пази данните си. Най-горе е текущата база данни с програма, версия, таблици, редове и адрес или папка. За персонала и таблетите касата работи еднакво с всяка база данни. На Windows, macOS, Linux и Raspberry Pi избирате от три бази данни:

• MySQL / MariaDB: отделна програма за бази данни (MySQL 8.0 или по-нова, MariaDB 10.6 или по-нова), например на сървър или NAS, който вече имате. Тогава всички данни са в обикновени таблици в MySQL или MariaDB, четими за собствената ви програма за отчети или BI. Касата смята точно както с PostgreSQL.
• Вградена (PGlite): в самата каса е, не е нужно да инсталирате нищо. Най-добрият избор за повечето заведения и базата данни на Android и Chromebook.
• PostgreSQL: отделна програма за бази данни на компютъра на касата или другаде в мрежата.

Кога MySQL или MariaDB? Ако заведението ви вече има сървър MySQL или MariaDB, ако вашият ИТ администратор работи с него или ако искате да четете данните в собствените си отчети, в Excel или в BI програма. Ако се колебаете, изберете вградената: работи веднага.

Какво е нужно за MySQL или MariaDB?

• MySQL 8.0 или по-нова, или MariaDB 10.6 или по-нова, достъпна от сървъра на касата.
• Отделна база данни за касата (или за касите на една верига), с набор от символи utf8mb4.
• Потребител на базата данни, който може в нея да създава, променя, преименува и изтрива таблици (CREATE, ALTER, DROP, INDEX, SELECT, INSERT, UPDATE, DELETE), например така:

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

Ако MySQL или MariaDB работи на друг компютър, в последните два реда поставете IP адреса на сървъра на касата вместо localhost.

Прехвърляне към MySQL / MariaDB:

1. Под Адрес на MySQL/MariaDB попълнете полетата: Сървър (по подразбиране localhost), Порт (по подразбиране 3306), База данни (по подразбиране horecapos), Потребител и Парола; същото за MariaDB. Ако адресът вече е зададен, полетата са попълнени; ако оставите паролата празна, остава запазената парола (за същия потребител). Касата сама запазва адреса; ако Optimum POS вече е задал фиксиран адрес, важи този адрес и полета няма. Ако касата вече работи с MySQL/MariaDB, по-късно променяте данните с Промяна на данните за MySQL/MariaDB. Криптирана връзка ще ви настрои Optimum POS.
2. Докоснете Тествай връзката: виждате програмата и версията или защо не става.
3. Докоснете Прехвърли към MySQL/MariaDB, отбележете, че разбирате, и въведете своя ПИН код.

Прехвърлянето работи във всяка посока между трите бази данни и всички данни се пренасят:

1. Касата за кратко не приема заявки (обикновено под минута); след това таблетите продължават сами.
2. Първо касата прави резервно копие на текущото състояние (в Настройки → Резервни копия).
3. Всичко отива в новата база данни и касата брои по таблици дали всичко е там точно.
4. Едва когато всичко съвпада, касата продължава с новата база данни. Влезлите служители остават влезли.

Ако нещо не успее, нищо не се променя и касата продължава да работи със старата база данни. Старата база остава, така че винаги можете да се върнете. Данните на касата, които вече са били в новата база MySQL/MariaDB или PostgreSQL, се заменят. Работи и в Белгия: броячите на черната кутия се пренасят точно.

Резервните копия и възстановяването работят еднакво с трите бази данни (Настройки → Резервни копия). Резервно копие от една база данни може да се възстанови във всяка друга, включително копие от PostgreSQL в MySQL или MariaDB.

Какво има в MySQL или MariaDB? Всяка таблица на касата, със същото име и колони (часовете в UTC). Всяка таблица получава допълнителна ключова колона _hp_sleutel, а в помощните таблици _horecapos_stand, _horecapos_kolom, _horecapos_reeks и _horecapos_wijziging (дневник на промените, пази се 14 дни) касата води състоянието, типовете колони, броячите и промените. Другите програми четат данните; пишат само касите.

Как работи: касата смята в бързо работно копие на сървъра на касата и записва всяка промяна в MySQL/MariaDB в същата стъпка. Ако това не успее, промяната не се извършва и касата показва грешка; затова поддържайте MySQL/MariaDB достъпна. При стартиране касата прочита всичко от MySQL/MariaDB.

Няколко каси в една база данни. Както при PostgreSQL, няколко каси могат да ползват една и съща база MySQL/MariaDB, например всяко заведение от верига със собствен касов сървър. Промените стават една след друга и всяка каса първо поема направеното от другите, така че при едновременни промени нищо не се губи. Ако каса възстанови резервно копие или каса с по-нова версия обнови базата, другите каси сами прочитат всичко отново; затова обновявайте всички каси едновременно. Каса, изключена повече от 14 дни, при стартиране прочита всичко отново.

При инсталирането избирате и базата данни: MySQL / MariaDB, вградена (препоръчително) или PostgreSQL с адреса. Ако не е достъпна, касата се инсталира с вградената база данни; прехвърляне можете да направите после тук. При обновяване изборът остава.

Свързване на таблети и екрани

• На всеки таблет/каса отворете адреса на касовия сървър, напр. http://192.168.1.20:3000, и го добавете като пряк път на началния екран (Chrome: Добавяне към началния екран).
• Кухненски екран: http://192.168.1.20:3000/keuken.
• Клиентски дисплей (обърнат към клиента, по избор): http://192.168.1.20:3000/klantscherm, вижте Клиентски дисплей.
• Екраните намират касовия сървър автоматично (същият адрес, порт 4000).

Екран за клиента

Екран на касата, който е обърнат към клиента. Клиентът вижда приблизително какво е поръчано и много ясно сумата и начина на плащане. Той няма управление: екранът само следва това, което прави касата. По подразбиране е изключен; включва се от Настройки → Обект → Клиентски дисплей. На касов компютър с два екрана касата го включва автоматично първия път; ако след това го изключите, той остава изключен. Без клиентски дисплей (изключен или няма свързан) всичко работи точно както винаги: касата изпраща изображението във фонов режим и персоналът никога не забелязва грешка или липсващ екран.

Какво вижда клиентът:

• Покой (никой не плаща): името на обекта и ваш собствен текст за посрещане (Настройки → Обект; празно = "Добре дошли").
• Поръчване: продуктите с количество и сума (еднаквите редове заедно, менюто като един ред с компонентите с дребен шрифт отдолу, отстъпката като един ред) и голямо общата сума. Вече платеното при разделено плащане се вижда отдолу. С Настройки → Обект → Снимки на продукти → на клиентския дисплей до всеки продукт има малка снимка.
• Плащане: начинът на плащане (Карта, В брой, Ваучер за подарък), бакшишът и голямо За плащане. В брой: колко дава клиентът и колко ресто получава, щом това е въведено на касата. Карта: "Следвайте инструкциите на ПОС терминала".
• Благодарим: след плащането за няколко секунди "Благодарим!" с платената сума (в брой: рестото на клиента), след това отново екранът в покой.

Свързване, по два начина (и двата се настройват на самото устройство):

• Втори монитор към касовия компютър (Windows, Linux/Raspberry Pi, macOS): автоматично. При вписване и след инсталацията касата отваря клиентския екран на цял екран върху най-малкия дисплей, който не е основен (при еднакъв размер – най-десния); на Windows винаги на друг екран, а не на този на касата (касата е на сензорния екран и също се отваря сама при стартиране). Размерът и позицията идват от системата, така че всеки формат работи. Без втори екран нищо не се случва. На Windows затвореният клиентски екран се връща сам; на Linux и macOS прекият път HorecaPOS клиентски екран в менюто го връща на място. В Windows се отваря в киоск режима на Chrome (или Edge): на цял екран, без заглавна лента и без лента на задачите (затваряне с Alt+F4). Той следва касата на същия компютър без код за свързване.
  • Във всеки браузър продължителното натискане никъде не отваря менюто на браузъра и не се появява запитване за превод на страницата.
  • Касата затворена = клиентският екран затворен. Ако софтуерът на касата спре (Рестартиране, актуализация, касата е спряна или премахната), клиентският екран също се затваря след малко над 10 секунди; когато касата отново работи, той се връща сам. На Windows се затваря и ако затворите само прозореца на касата. Под Wayland (Linux) касата не може сама да затвори прозореца.
  • Клиентският екран е затворен по погрешка? На Windows той се връща сам след няколко секунди, стига касата да е отворена и вторият екран да е свързан.
  • Винаги само един клиентски екран. В Windows клиентският екран е само в киоск режима на втория екран. Клиентски екран в прозореца на касата (напр. възстановен от Edge след спиране на тока или отворен с бутона в касата) се затваря сам до няколко секунди; на негово място тогава идва правилният клиентски екран.
  • Никой не е влязъл = само приветствието. Ако касата е на екрана за ПИН код (също след рестартиране или излизане), клиентският екран показва само приветствения текст, никога предишната сметка.
  • В Windows автоматичното отваряне може да се изключи и с отметката Клиентски екран автоматично ... в инсталатора.
  • В Linux касата премества прозореца с wmctrl (идва с пакета). Под Wayland (напр. Raspberry Pi OS с labwc) това не е възможно: тогава преместете клиентския екран веднъж ръчно на втория екран (браузърът го запомня) или изберете X11 в raspi-config. В macOS първия път Mac иска разрешение в Достъпност.
  • Ръчно: Настройки → Обект → Клиентски екран → Отвори клиентския екран (втори монитор). В Chrome и Edge (и на Chromebook) бутонът веднага поставя прозореца на клиентския екран (първия път браузърът иска разрешение); едно щракване върху клиентския екран го прави на цял екран. В други браузъри: плъзнете и натиснете F11.
• Android каса с вграден клиентски екран (напр. Sunmi D2/T2) или монитор през HDMI/USB-C: също автоматично. Щом приложението е на касата, клиентският екран се появява на втория екран; включването и изключването работят веднага.
• Sunmi T1 mini / T2 mini с малкия текстов дисплей (2 реда): приложението автоматично показва сумата там: Общо, За плащане, при плащане в брой Ресто, след плащането Благодарим!, а в покой – името на обекта. Клиентският екран трябва да е включен.
• iPad (работен екран) с външен екран през HDMI/USB-C или AirPlay: приложението автоматично поставя клиентския екран на този екран (подготвено; приложението за iOS още не е издадено).
• Chromebook: като работен екран в Chrome бутонът Отвори клиентския екран (втори монитор) работи както по-горе. В Android приложението клиентският екран се появява автоматично на втория екран, щом ChromeOS предаде този екран на Android приложенията; ако не го направи, използвайте отделно устройство с код за свързване.
• Отделно устройство (таблет или собствен компютър до касата): отворете http://<kassaserver>:3000/klantscherm. Долу вдясно на екрана се показва код за сдвояване от 6 знака. Въведете го на касата в Настройки → Обект → Клиентски дисплей → Сдвои. Прекъсни връзката връща екрана към кода за сдвояване. Сдвояването се пази за всяка каса (в браузъра на тази каса), така че всяка каса може да има собствен клиентски дисплей.

Клиентският дисплей не иска ПИН код (няма какво да се управлява) и показва само изображението на касата, с която е сдвоен. Изображението се пази само в паметта на касовия сървър; след рестарт екранът е празен до следващата промяна. Настройката (вкл./изкл. и текст за посрещане) се включва в резервното копие и в Импорт/експорт (Други настройки).

Дигитална касова бележка чрез QR (по избор)

По подразбиране изключено. Включва се от Настройки → Заведение → Кухня и клиентски екран → Дигитална касова бележка (опцията се появява, когато клиентският екран е запазен като включен). След плащането на екрана Благодарим се показва QR код; тогава екранът остава 45 секунди вместо няколко секунди. Гостът го сканира със собствения си телефон и вижда бележката точно като хартиената (същият текст, а при белгийска каса и с FDM блока). На телефона може да разпечата бележката, да я запази като pdf или да я изтегли като текстов файл.

• Работи през портала за управление: https://kassa.<portaal>/__bon/<kassa>/<sleutel>. Затова касата трябва да е свързана с портала; иначе не се появява QR код и нищо не се променя.
• Ключът е случаен, не може да бъде отгатнат и е валиден 30 дни. След това касата го изтрива автоматично. Порталът не съхранява нищо.
• Работи с втори монитор и с отделен клиентски екран. Хартиената бележка и бележката по имейл продължават да работят както обикновено.

Клиентски екран в покой: слайдшоу (по избор)

По подразбиране изключено. Включва се от Настройки → Заведение → Кухня и клиентски екран → Клиентски екран в покой. Когато на клиентския екран няма сметка, слайдовете се сменят един след друг (по подразбиране на всеки 8 секунди, настройва се от 4 до 60):

• Акции: happy hour-ите (ако happy hour е включен), с отстъпката, дните и часовете и продуктите или групите; текущите са най-отпред, с "Сега!".
• Препоръчани продукти (най-много 12, например нови в менюто), с цена и (ако снимките на продукти на клиентския екран са включени) снимка. Изчерпан продукт екранът пропуска.
• Картата за точки: точки на евро, наградата и картите с печати (само ако клиентската карта е включена).
• Собствени текстове: най-много 5, всеки на отделен слайд (например "От петък ново: нашето лятно меню").

Без слайдове клиентският екран показва екрана за добре дошли, както винаги.

Happy hour

По подразбиране е изключено. Включва се от Настройки → Обект → Използвай happy hour; след това се появява разделът Настройки → Happy hour.

• За всеки happy hour: име (отпечатва се на бележката), дни, от–до (може да минава след полунощ, напр. 23:00–01:00), отстъпка в % или фиксирана цена, и за кои категории и/или отделни продукти.
• В този период касата автоматично начислява цената за happy hour при маркиране (никога по-скъпо от обикновено; при фиксирана цена опциите за избор се добавят както обикновено). На бутона на продукта старата цена е зачеркната, до нея е новата цена и HH; в поръчката и на бележката стои името на happy hour. Вече маркираното запазва цената си.
• Оферта на деня: отметнете Цял ден (00:00–24:00) и изберете деня (дните), напр. всеки вторник свински ребра на фиксирана цена.
• Сезон: отметнете Само през сезон (всяка година) и изберете от и до (ден и месец, напр. от 1 юни до 31 август; може и през Нова година, напр. от 1 декември до 28 февруари). Извън сезона happy hour не важи.
• Промените се записват в дневника.

Периоди на менюто и сезони

По подразбиране е изключено. Включва се от Настройки → Заведение → Периоди на менюто и вид поръчка → Асортимент по периоди на менюто и сезони; след това се появява разделът Настройки → Периоди на менюто. Ако го изключите, всички продукти отново се продават винаги, а периодите се запазват.

• За всеки период на менюто: име (напр. Закуска, Обяд, Вечеря, Лятно меню), дни, от–до (може и след полунощ; Цял ден = 00:00–24:00), по желание сезон (всяка година, ден и месец) и кои категории и/или отделни продукти влизат в него.
• Продуктите и категориите, които са в един или повече периоди на менюто, се продават само докато тече един от тези периоди; което не е в нито един период, се продава винаги. Екранът за поръчки показва само това, което се продава в момента, и се сменя сам, когато период започне или свърши; сървърът отказва останалото ("в момента не се продава, само при Закуска").
• Онлайн магазинът показва и начислява същия асортимент (към момента на поръчката).
• Друга цена в определен ден или сезон е happy hour (оферта на деня, вж. по-горе).
• Меню за всеки обект: всяка каса (филиал) има свои продукти, периоди на менюто и цени.
• Промените се записват в дневника.

Асортимент и цени по вид поръчка

По подразбиране е изключено. Включва се от Настройки → Заведение → Периоди на менюто и вид поръчка → Асортимент и цени по вид поръчка. Ако го изключите, навсякъде отново важи обичайната цена и всичко се продава навсякъде; въведените цени се запазват.

• В Настройки → Продукти за всеки продукт: Цена за вкъщи и Цена при доставка (празно = обичайната цена) и Продава се за (на място, за вкъщи, доставка; поне едно). Категорията също има Продава се за – за всички продукти в нея.
• При поръчка за вкъщи или с доставка екранът за поръчки показва цената за този вид поръчка и само това, което се продава за него; сървърът начислява тази цена и отказва останалото. Happy hour, менютата и опциите се изчисляват с тази цена.
• Ставката на ДДС за вкъщи (при продукта) е отделна от това, както винаги.
• При вземане за вкъщи и доставка онлайн магазинът показва цените и продуктите на този избор (при смяна страницата с менюто се презарежда), а на масата – тези за на място.
• Експортът и импортът на конфигурацията (Настройки → Импорт/експорт) включват цените по вид поръчка, "продава се за", периодите на менюто и сезона на happy hour.

Менюта

По подразбиране е изключено. Включва се от Настройки → Обект → Използвай менюта.

• Менюто е обикновен продукт (с цената на менюто), за който в Настройки → Продукти → (продукт) → Меню задавате компоненти:
  • фиксиран: винаги този продукт (напр. "Напитка: Домашно вино");
  • по избор: изберете 1 (или повече) от категория, по желание ограничено до определени продукти (напр. "Основно ястие: изберете 1 от Основни ястия").
  • За всеки компонент серия (1 = веднага, 2/3 = изчаква повикване).
• Когато маркирате менюто, избирате ястията за всеки компонент. За всяко ястие (и за фиксираните) можете да изберете опциите за избор както при отделен продукт (степен на изпичане, допълнително сирене; задължителните опции трябва да са избрани) и бележка. Добавките към цената на опциите се прибавят към цената на менюто. Менюто се показва като един ред с ястията (и техните опции) отдолу.
• Ястията отиват в кухнята/бара като отделни редове (кухненски бон и кухненски екран), в своята серия. Самият ред на менюто – не.
• За целите на ДДС цената на менюто се разпределя между компонентите пропорционално на обикновената им цена, така че храната и напитките имат правилната ставка. На бележката е менюто с общата цена и ястията отдолу.
• Ако самото меню има опции за избор (напр. размер), ги избирате най-горе в прозореца на менюто. Те стоят при реда на менюто на бележката, а при всяко ястие от менюто на кухненския бон и кухненския екран като "(menu)".
• Премахването/сторнирането става за цялото меню (докоснете реда на менюто).
• Раздели / премести: изберете реда на менюто; ястията се местят заедно с него. При 2× едно и също меню можете да преместите и 1 (заглавният ред и ястията се разделят).
• Без връзка можете спокойно да маркирате менюта; те се пазят на таблета и се изпращат, щом връзката се възстанови (както отделните продукти).
• Happy hour може да важи и за меню.

Рецептури и себестойност (Apicbase)

Връзка с Apicbase (рецептури, себестойност, наличност и покупки) чрез Generic POS API на Apicbase (по подразбиране изключено, всяка част се включва или изключва отделно). Настройва се в Настройки → Рецептури (право Настройка на обект, плащания и принтери). Касата сама комуникира с Apicbase (само изходящ трафик, не е нужен портал).

1. Свързване (всичко се попълва от администратора), по един от три начина:
   • Поставяне на token: в Apicbase Library Settings → API Settings → New token → Service Account Token (scopes accounts, library, sales); поставят се access token и refresh token;
   • Вход със собствено API-app на обекта (client-id и client secret от API Settings): Вход в Apicbase и се поставя кодът, който Apicbase показва след това;
   • Изтекъл token (след 7 дни) касата подновява автоматично с refresh token.
2. Outlet: Изтегли outlets и се избира outlet на този обект. Касата задава там POS на Generic POS API със собствен location-id (може да се променя; по подразбиране HORECAPOS-…, уникален за всяка каса).
3. Вкл., с отметки:
   • Продукти, групи и опции за избор към Apicbase: продуктови групи, продукти (PLU = PLU номерът на продукта, иначе кодът, иначе id), опции за избор като modifiers, с цена и ДДС. Автоматично след всяка промяна (след минута) и всеки ден. В Apicbase след това свързваш всеки продукт от касата с рецепта;
   • Всяка платена бележка към Apicbase: първо най-старите, най-много 100 наведнъж, до четвърт час след плащането (и на всеки 5 минути). Отстъпката се разпределя по редовете; свободни суми, такса за еднократна опаковка и депозит са отделен продукт в Apicbase; претеглени продукти като 1 брой с общата сума. Ако не успее, касата спира (Apicbase иска бележките по ред) и опитва отново по-късно: плащането не се засяга. При включване избираш от кой ден (по подразбиране от сега);
   • Изтегляй себестойността на порция (на всеки 6 часа): за всяка свързана рецепта food cost (съставки и фира), с разходи за персонал, продажната цена и маржа според Apicbase. Изчислено по най-евтиния доставчик, последната поръчана цена или средната стойност на наличността;
   • Вземай продажната цена от Apicbase (по подразбиране изкл.): задава продажната цена на свързаните продукти в касата (записва се в дневника).
4. Най-долу: Себестойност по продукт със себестойност, себестойност с персонал, цена в касата, себестойност % и марж. Бутони Изпрати каталога сега, Изпрати бележките сега и Изтегли себестойностите сега.

Код: apps/pos-server/src/lib/apicbase.ts, routes/apicbase.ts; екран Apicbase.tsx. Дневник: Apicbase. Условие: API модулът на Apicbase. За приложението на Pin Voordeel за всички клиенти: партньорство и сертифициране при Apicbase (виж backlog). Документация: https://developers.apicbase.com/docs/generic-pos-api-guide

Хотелски софтуер: в стаята

За ресторант или бар към хотел: сметката се прехвърля в стаята на гост. По подразбиране изключено: Настройки → Хотел (право Настройка на заведение, плащане и принтери).

• Един списък с целия хотелски софтуер (Хотелски софтуер на хотела). Вградени връзки:
  • Mews (Connector API: client token и access token, услугата на ресторанта и за всяка ставка на ДДС кодът на ДДС в Mews), apaleo (собствено приложение с client ID и client secret, property ID; за всяка ставка на ДДС при нужда видът ДДС) и Cloudbeds (API ключ и property ID), всяка с тестова и реална среда;
  • Oracle OPERA Cloud (OHIP), protel (protel I/O), RoomRaccoon, Booking Experts, Amadeus (XMLPOS), VIPS, Stayntouch, Clock PMS+, Guestline (Rezlynx), Hotelogix, eviivo, Little Hotelier, Shiji и Infor HMS (Databridge). След избора се показват точно полетата, нужни за този хотелски софтуер (ключове, ID на хотела, при нужда адресът на техния API и техният код за всяка ставка на ДДС), с кратко обяснение какво да поискате от доставчика. Тези връзки са изградени по документацията на доставчиците; помолете доставчика да потвърди връзката и първо пробвайте с Тествай връзката и един бон;
  • демо (четири апартамента, стаи от 4 до 7), за да пробвате;
  • Sirvoy, като половин връзка и само със Sirvoy Pro. Sirvoy няма API, през което касата да добавя нещо към резервация, дори чрез файл (CSV импортът създава само нови резервации). Така касата познава гостите (стая, име, пристигане, заминаване): търсенето при В стаята и самообслужването на киоска и в онлайн магазина работят нормално. Бележката не отива сама в Sirvoy: след плащането стои в Настройки → Хотел под За въвеждане в Sirvoy, със стаята, госта, номера на бележката и сумата по ставки на ДДС. Хотелът я въвежда ръчно като екстра към резервацията и натиска Въведено е (връщане с Все още не). Нужно:
    1. за предпочитане каса, свързана с портала за управление: тогава адресът минава през портала (https://<portaal>/hotel/<kassa-id>/sirvoy?sleutel=...) и в хотела не е нужно да се отваря порт. Иначе самата каса трябва да е достъпна от интернет през https (собствен домейн със сертификат или пренасочване на портове; Sirvoy изисква TLS 1.2 или по-нова версия) и въвеждате този адрес;
    2. Адресът се вижда само веднъж; касата пази само хеша. Създаване на нов адрес = старият вече не работи;

Sirvoy изпраща нещо само когато резервация се промени: резервациите отпреди свързването касата ги научава едва след промяна в Sirvoy. Съобщенията може да пристигат разбъркано; съобщение, по-старо (generatedAt) от това, което касата вече има, се пропуска. В хотела = неанулирана и без напускане, настанен или пристигане днес или по-рано, и заминаване днес или по-късно. Тествай връзката показва колко резервации са пристигнали.

Целият хотелски софтуер се продава в Нидерландия и/или Белгия. Тествай връзката проверява данните. Код за всяка връзка: apps/pos-server/src/lib/pms/<naam>.ts.

• Самообслужване (по подразбиране изключено): хотелският гост сам записва поръчката по стаята си, на киоска и/или в онлайн магазина (за вкъщи и доставка, не при поръчка на маса). Той въвежда номер на стаята и фамилия; касата проверява в хотелския софтуер дали този гост в момента е настанен в тази стая. С максимум на поръчка (по подразбиране € 150), а след 5 грешни опита за 15 минути гостът първо трябва да отиде на рецепцията. Съобщението никога не казва кой е настанен в дадена стая.
• Плащане: когато връзката е включена, има начин на плащане В стаята. Потърсете госта по име или номер на стая (само гости, които сега са в хотела) и докоснете Прехвърли в стая .... Касата осчетоводява бележката по ставки на ДДС в хотелската сметка на госта; гостът плаща при напускане.
• Белгия: ако поръчката вече е на маса в черната кутия, тя първо минава от масата към стаята (signCostCenterChange към ROOM, UC4101); бележката отива като кредит за стая (ROOM_CREDIT) към черната кутия.
• Ако осчетоводяването в хотелския софтуер не успее (няма интернет), продажбата все пак я има, а осчетоводяването е като Неуспешно в Настройки → Хотел, с Отново.
• Отчети и счетоводство: В стаята (хотел) е отделен начин на плащане в X и Z отчета, в дневния отчет и в одитния файл (XAA).

Код: apps/pos-server/src/lib/hotel.ts, routes/hotel.ts, връзките в lib/pms/, каталог packages/shared/src/hotelcatalogus.ts; екран Hotel.tsx. Дневник: Хотел. Тайните (токените) са само в базата данни, никога на екрана.

Управление на вината с Vinify

Настройки → Управление на вина (по подразбиране изключено; при изключване всичко се запазва). Vinify води винарската изба, винената карта и наличностите и е основният източник на вината. Съгласно POS изискванията на Vinify касата предлага API, с който Vinify:

Се удостоверява по всеки от трите начина, които Vinify поддържа (администраторът включва кой):

1. API ID и API ключ (X-Api-Id и X-Api-Key, или Authorization: Bearer <id>:<sleutel>);
2. API ключ и API secret с подпис: X-Api-Key, X-Timestamp и X-Signature = hex HMAC-SHA256(secret, <timestamp>\n<METHODE>\n<pad met query>\n<sha256 van de body>), най-много 5 минути стар.

Ключът и secret-ът се създават от касата (показват се веднъж); екраните виждат само дали са попълнени. Достъпно през портала на https://<portaal>/vinify/<kassa-id>/... (без отворен порт в заведението; адресът е в Настройки → Управление на вина). Кои продукти са вина: това, което Vinify създава, плюс групите, които отметнете. Ако Vinify даде адрес за продажбите, касата ги изпраща и сама (push, с токен): след всяка платена сметка и на всеки 5 минути това, което още не е успяло. Vinify включва връзката с HorecaPOS (hello@vinify.no). Всичко в дневника. Да не се бърка с Vinify.nl, онлайн магазин за вина: той е сред доставчиците (Поръчки към доставчици).

Бързо въвеждане на адрес по пощенски код и номер

Включва се в Настройки → Заведение → Бързо въвеждане на адрес (по подразбиране изключено; само за заведение в Нидерландия). Въведете пощенски код и номер (също с буква или добавка, напр. 12A или 12-1) и докоснете Търси адрес: улица, номер, пощенски код и населено място се попълват. Ако на този номер има няколко адреса (12, 12A, 12B), изберете правилния. След това можете да промените всичко сами.

• При данните на заведението (Настройки → Заведение, над адреса).
• При клиент с клиентска карта: на касата при нов клиент и в Отчет → Клиенти. За целта клиентите получават адрес (по избор): улица и номер, пощенски код и населено място.
• Адресите идват от безплатния Locatieserver на PDOK (официалните адреси в Нидерландия, BAG): не е нужен акаунт или ключ, но е нужен интернет. Без интернет или при белгийски адрес просто въвеждате адреса сами.

Известие за нова версия

Включва се в Настройки → Обект → Известие за обновяване (по подразбиране изключено).

• Касата е обновена: ако касовият сървър е обновен, докато на таблет още са отворени старите екрани, горе се показва "Касата е обновена (версия …)" с Опресни. Таблетът проверява на всеки 5 минути, когато екранът отново стане видим, и след рестарт на сървъра.
• Налично обновяване: ако касата е свързана с портала за управление (PORTAAL_URL/PORTAAL_SLEUTEL) и там е попълнено NIEUWSTE_VERSIE, потребителите с право да управляват настройките виждат "Налично обновяване: версия …" (с обяснението от UPDATE_NOTITIE). По-късно скрива известието на този таблет, докато не излезе още по-нова версия. Обновяването става както винаги с scripts\windows\update.cmd (вижте Обновяване).

Платформи за резервации

Резервациите от TheFork, Formitable, Zenchef, Resengo (само Белгия), OpenTable (само Нидерландия), PlanPanther, RestoManager и Aqqo (само Нидерландия) влизат автоматично в касата и на плана на залата. Включва се от Настройки → Платформи за резервации (по подразбиране изключено). Възможно е само ако Резервации са включени.

• Държава на обекта: можете да избирате само платформи, които работят в държавата на обекта (Resengo само в Белгия, OpenTable и Aqqo само в Нидерландия). Сървърът също проверява това.
• Няколко платформи едновременно: можете да свържете няколко платформи едновременно, например TheFork и Formitable. Две платформи никога не получават една и съща маса в един и същи интервал; тогава втората резервация идва без маса.
• + Свържи платформа: изберете платформата и попълнете данните. Тайните (client secret, ключ за обратно уведомяване) никога не се показват в прегледа; празно = запазване, Изтрий = премахване.
• TheFork (публичен B2B API): Restaurant UUID, Client ID и Client Secret (заявяват се от TheFork). Когато касата отмени, тя отменя и в TheFork.
• Formitable, Zenchef, Resengo, OpenTable, PlanPanther, RestoManager, Aqqo: техният API е само за партньори или не е публичен (PlanPanther, RestoManager и Aqqo: връзка с каса се договаря с тях). Събитията на Formitable (booking.created, .changed, .canceled, .checkin, .checkout) се разпознават.
• На плана на залата: ако маса в касата има същото име като масата в платформата и е свободна в този часови интервал, резервацията отива на тази маса; иначе е без маса (изберете при пристигане). Резервация, която пристигне отново, се обновява, а не се дублира. В прегледа пише "чрез TheFork".
• Статус: ако платформата отмени или съобщи за no-show, касата го приема. Каквото в касата вече е отбелязано като пристигнало, остава пристигнало.
• Обратно уведомяване (no-show обратно): въведете адрес за обратно уведомяване (например на вашата услуга за интеграция). Касата изпраща всяка промяна от касата (пристигнал, no-show, отменена, платена със сума) като JSON: { platform, id, status, statusEn, bedrag, valuta, tafel, tijdstip, gemeldOp } (сума в центове, само при платена), с Authorization: Bearer <terugmeld-sleutel>, ако го въведете. Ако не успее, касата опитва отново всяка минута и грешката се показва при платформата. Каквото е дошло от самата платформа, не се изпраща обратно.
• Тестова резервация: създава резервация, както би я изпратила платформата.
• Премахване: връзката и ключът изчезват; резервациите остават.
• Всички промени се записват в дневника (без тайни).

Програми за лоялност и отзиви

Два отделни превключвателя в Настройки → Точки и отзиви (и двата по подразбиране изключени, тогава никъде нищо от това не се вижда). Ако ги изключите, настройките и вече случилото се се запазват.

Програма за лоялност на друга платформа: гостът събира точки в Joyn (Белгия) и/или Piggy (Leat; Нидерландия и Белгия). Това е независимо от собствената клиентска карта на касата; тя може да работи успоредно.

• Няколко едновременно: в Белгия Piggy и Joyn могат да са включени заедно, всяка със собствени данни (изберете платформата, попълнете, Запази; Промени и Изтрий за всяка платформа). Гостът получава за всяка програма отделен QR код на касовата бележка, отделен линк в изпратената по имейл бележка и отделен бутон в онлайн магазина и събира точки веднъж на поръчка във всяка програма. Каквото вече е било настроено, продължава да работи.
• QR код на бележката: след плащане под бележката има QR код с "Сканирай и събирай точки в ...". В бележката по имейл има линк, а в онлайн магазина (вземане и доставка) – бутон на страницата на поръчката и линк в имейла за потвърждение. Една поръчка носи точки само веднъж: бележката, имейлът и онлайн магазинът използват един и същ уникален код (номера на поръчката). "QR код на отпечатаната бележка" може да се изключи; имейлът и онлайн магазинът пак получават линка.
• Piggy, начин "QR код и линк": въведете адреса на вашия клиентски портал в Piggy, Shop UUID и Account secret (Piggy Business Dashboard). Работи без интернет: касата сама създава линка.
• Piggy, начин "Веднага начисляване": въведете и personal access token (Piggy → Marketplace → Private App). Ако касата изпрати бележката по имейл и гостът с този адрес вече е член, касата начислява точките веднага; на бележката тогава пише "Точките са начислени в Piggy". Касата никога не създава нов член; не е член (или няма имейл адрес) = QR кодът.
• Joyn, начин "QR код и линк": с partner key, shop reference и shared secret от Joyn (заявяват се на api-integration@joyn.be). Работи без интернет. QR кодът е валиден 2 часа.
• Joyn, начин "Чрез API": с shop API key (включете връзката в търговския портал на Joyn). При плащане касата иска код за точки от Joyn. Използването на точки става както винаги на Joyn-iPad.
• Създай примерен линк: проверява дали данните са верни (линк за € 10; отворете го само за преглед).
• Могат да се избират само платформите от държавата на заведението; тайните данни са само в базата данни и никога не се показват на екрана (празно = запази).

Искане на отзиви: след посещението един имейл с бутон към Google и/или Trustpilot.

• Няколко часа по-късно (настройва се, по подразбиране 3) гостът получава имейла на езика на бележката.
• Онлайн магазин: при вземане и доставка онлайн магазинът сам изпраща имейла, няколко часа след като поръчката е приключена в касата, на езика на госта.
• Google: поставете линка за отзив от бизнес профила си (Google → вашият бизнес профил → Искане на отзиви, https://g.page/r/.../review) или въведете Place ID.
• Trustpilot: въведете домейна на заведението си (бутонът води към trustpilot.com/evaluate/<domein>). Ако имате в Trustpilot адрес за покани (Automatic Feedback Service, ...@invite.trustpilot.com), въведете и него: тогава имейлът отива като скрито копие (BCC) до Trustpilot, с невидими име, имейл адрес и номер на бележката, а Trustpilot сам изпраща поканата (тогава без собствен бутон за Trustpilot). Само Trustpilot с адрес за покани: касата изпраща имейл само до Trustpilot.
• Не твърде често: един и същ гост (имейл адрес) получава най-много една покана за период (по подразбиране 90 дни; 0 = всеки път). За целта касата пази само хеш на адреса; самият имейл адрес се изтрива веднага щом имейлът бъде изпратен (ако не успее – след три опита, иначе след 14 дни).
• QR код на бележката (по избор): и QR код за отзив под отпечатаната бележка.
• Примерен имейл и Изтрий чакащите имейли (адресите тогава се изтриват веднага). Дневникът показва review_gevraagd с a***@domein.bg.
• Google и Trustpilot забраняват награда за отзив и искане само от доволни гости ("review gating"). Затова касата пита всички еднакво и не дава нищо в замяна на отзив.
• Четене на отзиви и отговор на тях в касата: вижте Управление на отзиви по-долу.

Връзка с Mailchimp и Klaviyo

Клиентите с клиентска карта във вашата собствена програма за имейли: в Настройки → Заведение → Mailchimp и Klaviyo (под SMS и имейл маркетинга). Няма превключвател: без връзка с избран списък нищо не се случва.

• Свързване: с API ключ (Mailchimp: Profiel → Extra → API keys; Klaviyo: частен ключ pk_… с права за запис за Lists, Profiles, Subscriptions, Events, Campaigns и Templates). Клиентският таен ключ и ключът никога не се показват отново (празно = запазване). След това изберете списъка (Mailchimp: audience).
• Клиенти: който е дал съгласие за имейл, отива в списъка (абониран) с име, фамилия, телефон, рожден ден и точки за лоялност (Mailchimp: поле PUNTEN, което касата създава сама; Klaviyo: свойство punten). Оттеглено съгласие, променен имейл адрес или изтрит клиент: отписан. Отново се изпраща само това, което е променено. При свързване касата (и отметката "оферти" в онлайн магазина) иска от нов клиент и съгласие за имейл, като то може да се промени в Отчет → Клиенти, дори без собствения имейл маркетинг.
• Отписване: който се отпише в Mailchimp или Klaviyo, вече няма съгласие за имейл и в касата (дневник: "отписан в Mailchimp"). Който се е отписал сам, касата не го абонира отново.
• Поръчки: всеки платен бон на клиент от списъка се изпраща като събитие (Mailchimp: bestelling, със сума, номер на бона и брой; Klaviyo: Placed Order, със стойността в евро). С тях създавате автоматични имейли в програмата за имейли, напр. след първата поръчка или когато някой не е идвал от месец. Боновете отпреди избора на списъка не се изпращат.
• Промоции: в Отчет → Маркетинг можете да изпратите промоция и чрез Mailchimp или Klaviyo (вижте SMS и имейл маркетинг); тогава касата създава кампанията там и я изпраща.
• Обновяване: на всеки 5 минути или с Обнови сега. Прекъсване на връзката: изчезва от касата; в Mailchimp и Klaviyo всичко остава. Ключовете се пазят в базата данни (в резервното копие да, в експорта на конфигурацията не).

Код: lib/mailinglijst.ts, routes/mailinglijst.ts и MailingKoppelingen.tsx.

BI и експорт на данни

Данните за продажбите към Power BI, Looker Studio, Excel, Google Sheets, Tableau, Qlik Sense, Metabase, BI услуга (например YourBI, BI4Horeca или Moore DRV) или собствено хранилище за данни. Включва се от Настройки → BI и експорт на данни (по подразбиране изключено). Само четене: чрез интеграция нищо в касата не може да се промени. Без данни за гостите.

• Данни: бележки (включително кредитни), продадени продукти (редове от бележки), плащания, оборот за ден, оборот за час, сторна, продукти, служители (без ПИН) и отработени часове. Суми в евро с точка като десетичен разделител, часове по местното време на обекта.
• + Интеграция: изберете програмата и начина. Всяка програма поддържа един или повече начина; можете да имате няколко интеграции едновременно (и за една и съща програма).
• Програмата извлича данните сама (API): касата издава еднократно ключ само за четене. Период с ?van=&tot= (ГГГГ-ММ-ДД) или фиксиран адрес с ?periode= (днес, вчера, 7d, 30d, 90d, 365d, седмица, месец, предходен месец, година); най-много 366 дни, най-много 200 000 реда. Ключът в Authorization: Bearer, X-Sleutel или ?sleutel=.
• Чрез портала: ако касата е свързана с клиентския портал, същият адрес работи и извън обекта, без да се отваря порт: https://<portaal>/bi/<kassa-id>/<gegevens>?periode=90d&formaat=csv&sleutel=.... Така услугата Power BI го опреснява по график (без шлюз), а Google Sheets може да го извлича с =IMPORTDATA("...") (също източникът за Looker Studio). Касата показва адреса при интеграцията.
• Обзор на веригата през клиентския портал (няколко обекта): един адрес и един ключ за всички ваши каси заедно. Във всяка каса, която трябва да участва, включете Обзор на веригата през клиентския портал (под превключвателя за BI) и създайте ключ в клиентския портал в Моите каси → BI за всички ваши обекти. След това: https://<portaal>/bi/keten/<gegevens>?periode=90d&formaat=csv&sleutel=hpk_.... Порталът извлича данните от всяка каса и ги обединява, с kassaId и zaak на всеки ред. Касите, които са офлайн или не участват, са изброени в ontbrekend (JSON) и в заглавката X-Ontbrekend. Самата каса не се нуждае от собствен ключ за това; изключването в касата или в клиентския портал го спира.
• С токен той се изпраща като Authorization: Bearer, а в X-HorecaPOS-Handtekening има подпис (sha256= HMAC на съдържанието). Ако не успее, касата опитва отново всяка минута; нищо не се изпраща два пъти. С от изпраща и по-стари бележки.
• Касата доставя файлове: всеки ден (в определен час, предходния ден; пропуснатите дни се наваксват) или всеки час (днес досега), като CSV (запетая или точка и запетая за нидерландски Excel) или JSON, в папка на касовия компютър (например папка на OneDrive или SharePoint за Power BI или Excel), на FTP(S) или SFTP сървър или по имейл. Имена на файлове: horecapos_<gegevens>_<datum>.csv.
• Изпрати тест (push) и Експортирай сега (файл) при интеграцията.
• Изтегляне самостоятелно: изберете данни, период и формат.
• Шаблон за Power BI (.pbit): готов отчет за Power BI Desktop, с Изтегли шаблона за Power BI в BI и експорт на данни. Първо създайте API връзка (Power BI). В модела: таблица за всеки набор от данни с правилните типове, календар (година, месец, седмица, ден от седмицата), релации (дата → календар, редове от бонове → продукти, отработени часове → служители) и мерки (оборот с и без ДДС, ДДС, бакшиш, бонове, гости, средно на бон и на гост, продадено количество, оборот от продукти, платено, сторно, отработени часове, оборот на отработен час). Три страници: Обзор (ключови показатели, оборот по дни, дни от седмицата и часове, начини на плащане), Продукти (по група и по продукт) и Персонал (часове и оборот по служител). Чрез портала услугата Power BI го обновява и по график.
• Тайните данни (токен, парола, ключ) никога не се показват в прегледа; празно = запазване, Изтрий = премахване. Всичко се записва в дневника (без тайните данни).

Заплати и планиране

При включено отчитане на работно време (Настройки → Заведение) в Настройки → Работно време най-долу има Заплати и планиране (право Управление на настройките), в два отделни блока. Ако отчитането е изключено, няма часове: тогава има само блокът Планиране на персонала (оборотът, на живо или като файл с оборота) най-долу в Настройки → Счетоводство, под заглавието Оборот към вашето планиране:

• Ведомост за заплати (payroll): изберете програмата за заплати или (Белгия) социалния секретариат, попълнете полетата ѝ и за всеки служител неговия служебен номер в тази програма. След това създавате за даден период файла с отработените часове (приключени смени, по служител и ден на влизане) и оборота по служител (без ДДС, това, което той/тя е маркирал): готов за Loket.nl (Variabele gegevens, общо по служител за периода, заглавен ред aanslnr;persnr;ploeg;<looncomponent>) и SD Worx Белгия (Tijdsregistratie, фиксирани позиции, по служител и ден), иначе списъкът с часове (CSV: Дата; Служебен номер; Име; Часове; Оборот без ДДС). Служителите без служебен номер не влизат във файла за Loket или SD Worx; касата съобщава кои са те.
• Планиране на персонала (WFM): изберете системата за планиране. Повторното изпращане презаписва. Освен това списъкът с оборота (CSV по ден и час, без и с ДДС) и за Strobbo Excel файлът за Importeer omzet.
• Само програми, които работят в държавата на заведението, по групи и по азбучен ред; сървърът отказва програма от друга държава (400).
• Ключовете и токените никога не се показват на екрана.
• Засяга счетоводството: разходите за заплати ги осчетоводява програмата за заплати, оборота го осчетоводява касата (Настройки → Счетоводство). AFAS Payroll и Exact Online Loon са в същата среда като счетоводството на AFAS и Exact.
• В копието на касата в портала това не е възможно (прави го касата в заведението).
• При някои програми API не е публично или е само за партньори (вкл. Loket, Nmbrs, Nostradamus, Employes, Shyfter, Planday, Eitje): те са отбелязани при заявка; дотогава файлът. Структурата за SD Worx и Strobbo е взета от тяхната документация: дайте първия импорт за проверка.

Законови изисквания в Белгия и Нидерландия

Какво изисква законът и какво прави HorecaPOS за това (помолете счетоводителя си да потвърди какво важи за вашето заведение):

Закони и правила

Настройки → Закони и правила (администратор; асистентът за ДДС и с правото Управление на продукти). Всичко е изключено по подразбиране; без тези настройки касата работи както винаги.

• Проверка на възрастта за алкохол (18+): в Продукти отметнете Съдържа алкохол (или използвайте асистента за ДДС). При вземане и доставка с алкохол стои "18+" на работната бележка, касовата бележка и в екрана за поръчки. В уебмагазина клиентът сам потвърждава, че е навършил 18 години (полето не е отметнато предварително), и вижда, че възрастта се проверява при предаване.
• Такса за еднократна опаковка (Нидерландия): сума по продукт (ориентировъчни цени: чаша € 0,25, кутия за ястие € 0,50, малка кутия € 0,05). При вземане и доставка касата сама добавя ред "Такса за еднократна опаковка" на бележката (с ДДС на продукта); той следва продуктите автоматично (базата данни го пази, и след сторниране, преместване или друг вид поръчка) и стои отделно в оборота. На място няма такса. Thuisbezorgd.nl и уебмагазинът начисляват собствена такса.
• Депозит (Нидерландия): по продукт (€ 0,15 кен/бутилка, € 0,25 голяма бутилка), ред "Депозит" без ДДС, само при вземане и доставка.
• В брой € 3.000 или повече (Нидерландия, забранено за стоки от 1-1-2026): при вземане и доставка съобщение при плащане и при автомата за пари; служителят може да потвърди (напр. кетъринг като услуга), което се записва в дневника. Храна и напитки на място са услуга: без съобщение.
• Асистент за ДДС: за всеки продукт видът (ястие, безалкохолна напитка, алкохолна напитка, храна без приготвяне, друго; първоначално предположение по името и групата). Касата показва правилната ставка на място и за вкъщи (Белгия от 1-3-2026: ястия и безалкохолни 12%, и за вкъщи; алкохол 21%; храна без приготвяне 6%. Нидерландия: 9% и 21%) и я прилага, веднага или от дата.
• Планиране на промяна на ДДС: продукт към друга ставка или (само в Нидерландия) ставка с нов процент, от определена дата. Касата я изпълнява сама в този ден (проверка на всеки 15 минути и при стартиране).

Фактурите (в Белгия задължителни между фирми) са описани във „Фактури за бизнес клиенти“. Предстои: GKS 2.0, да се провери как стои сертифицирането (вижте docs/backlog-concurrenten.md).

Фактури за бизнес клиенти

Настройки → Фактури (администратор; по подразбиране изключено): включете Фактури за бизнес клиенти (UBL / Peppol). Когато е включено, отдолу са Плащане по сметка, Данни във фактурата, Peppol услуги, Банкова връзка (при плащане по сметка) и списъкът с всички фактури. В Белгия електронното фактуриране между фирми е задължително от 1-1-2026.

• Фактури за бизнес клиенти: Бележки → изберете бележката → Фактура. Въведете клиента (или изберете предишен клиент); касата създава фактура с номер (напр. F2026-0001, поредна за годината), като UBL по Peppol BIS Billing 3.0 и като фактура за печат или запис в PDF. Изпращане по имейл (двете като прикачени файлове, по желание с копие до счетоводителя), чрез Billit към мрежата Peppol (BILLIT_API_KEY, BILLIT_PARTY_ID), чрез Storecove (STORECOVE_API_KEY, STORECOVE_LEGAL_ENTITY_ID; получателят се взема от Peppol ID на клиента, напр. 0208 → BE:EN, 0106 → NL:KVK, иначе по имейл чрез Storecove) или чрез Banqup на Unifiedpost (BANQUP_CLIENT_ID, BANQUP_CLIENT_SECRET, BANQUP_SPACE_ID; BANQUP_SANDBOX=1 за тестовата среда; Banqup проверява UBL и сам го доставя), към собствен адрес (FACTUUR_HTTP_URL, напр. счетоводна програма или друга Peppol услуга) или изтегляне. Една фактура на бележка; бележката вече е платена, затова "платено". Номер в KvK/ЕИК, IBAN, Peppol ID, префикс и срок за плащане в Данни във фактурата. Всички фактури са в долната част на раздела (право Оборот за период).
• Ключове, тайни и заглавки никога не се показват (само "попълнено"; празно = запазване, Изчисти = премахване) и не се записват в дневника (само кои полета са променени). Пазят се в базата данни (vestiging.peppol_gegevens): в резервните копия да, в експорта на конфигурацията не.

Киоск за самообслужване

Гостите поръчват сами на стойка или таблет, като в заведение за бързо хранене, и плащат на касата или с карта на киоска. Екраните за поръчка са част от самата каса, така че менюто, цените, опциите, менютата, happy hours, частите от деня, снимките, алергените, езиците и бележката идват от касата и не трябва да се настройват другаде. На киоска работи приложението PinPortal Kiosk 2 (Android, включително Sunmi, както и Windows, Linux и macOS), което показва страницата и печата бележката. По подразбиране е изключено.

Включване и настройка (администратор): Настройки → Заведение → Екрани и управление → Киоск за самообслужване.

• Изберете какво може да избере гостът: Тук и/или За вкъщи (за вкъщи смята цената за вкъщи и ДДС ставката за вкъщи, ако са зададени).
• Текст за посрещане, след колко секунди без докосване киоскът се връща в началото (кошницата се изпразва) и кои продуктови групи са на киоска (нищо отметнато = всички).
• Нещо друго към това?: отметнете продуктови групи (напр. напитки, десерти); при кошницата киоскът предлага няколко продукта от тях.
• Плащане, за всеки киоск (вижте Добавяне и свързване на киоск):
  • На касата (по подразбиране, като при стария киоск): гостът поръчва, получава номер за вземане и плаща на касата. Не е нужен терминал на киоска.
  • С карта на киоска: гостът плаща на терминала до киоска.
  • Гостът избира: на касата или с карта. Ако киоскът няма терминал, плащането е на касата.
• Към кухнята (при плащане на касата): веднага след поръчката на киоска (по подразбиране), или едва след плащане на касата.
• Бележка: на принтера на киоска (по подразбиране), на принтера за бележки на касата, или без бележка (само номерът на екрана). При плащане на касата киоскът печата листче с номера и още не е платено; касовата бележка идва при приключване на касата.
• Статус на поръчката на телефона (по избор, по подразбиране изключено): на бележката от киоска и на последния екран се появява QR код. Гостът го сканира, вижда номера си и статуса (поръчано, приготвя се, готово) и получава известие, когато поръчката е готова. Работи през портала за управление, затова касата трябва да е свързана с него.
• Алкохол и продукти на килограм никога не са на киоска: без персонал възрастта не може да се провери и няма везна.
• Баркод скенер (по избор, по подразбиране всичко е изключено): отметни какво може да прави едно сканиране на киоска:
  • продукт в кошницата (кодът на продукта);
  • код за отстъпка;
  • клиентска карта (гостът трупа точки);
  • ваучер или предплатена карта като плащане. Ако салдото стига, поръчката е платена веднага. Иначе ваучерът плаща част, а гостът плаща останалото с карта или на касата (тогава това е позволено и на киоск само с плащане с карта). След такова частично плащане гостът вече не може да откаже; поръчката се вижда в касата като Киоск … · номер.

Самият скенер се настройва на киоска: в приложението PinPortal Kiosk 2 при управление → Баркод скенер (като клавиатура, вграденият скенер или COM порт), с тест на скенера. Скенер, който работи като клавиатура, работи и без приложението.

• Зареди кредит (по избор, по подразбиране изключено; работи само ако Презареждаем кредит е включен): на началния екран на киоска тогава има Зареди кредит. Гостът сканира картата или ваучера си (или въвежда кода), вижда салдото и избира сума. Сумите задавате сами (от 1 до 6, по подразбиране € 10, € 20 и € 50). Плащането е както е настроено за киоска: с карта или на касата с номера за вземане. След плащането сумата е в салдото. Такова зареждане не отива към кухнята, не се показва на екрана за повикване и не получава QR код. И тук важи максималното салдо от настройката Презареждаем кредит.
• По моята стая (хотелска връзка, по подразбиране изключено; Настройки → Хотел → Самообслужване): тогава до кошницата има Запиши по моята стая. Хотелският гост въвежда номер на стаята и фамилия; ако това съвпада с гост, който в момента е настанен в тази стая, поръчката отива в кухнята и се записва като платена по стаята (вижте Хотелски софтуер: в стаята).
• Белгия (черна кутия): каквото още не е тествано с черната кутия, на киоска е изключено автоматично (ваучер или наличност като плащане, зареждане, код за отстъпка, менюта, опции с доплащане, happy hour), както и на касата.

Добавяне и свързване на киоск

1. При Киоски въведете име (напр. Киоск вход) и изберете Добави киоск. Получавате код за свързване от 6 цифри (валиден 30 минути).
2. Изберете при киоска как плаща гостът: по подразбиране на касата. Ако е киоск с терминал, изберете с карта или гостът избира и изберете терминала на този киоск (от Настройки → Плащания).
3. Отворете на киоска страницата на киоска:
   • в заведението: в приложението в управление → Vast adres адреса, показан при настройката, напр. http://192.168.1.20:3000/kiosk;
   • или през портала за управление (https, и ако киоскът не е в същата мрежа): свържете адреса на киоска, показан при настройката, с кода на киоска в приложението, както при стария киоск.
4. Въведете кода за свързване на киоска. Готово: киоскът помни собствения си ключ. Свържи отново дава нов код; Премахни го изключва.

При всеки киоск се вижда дали е онлайн.

Как поръчва гостът

1. Начален екран с текста за посрещане; гостът избира езика си (всички езици на касата) и докосва, за да поръча.
2. Тук или за вкъщи.
3. Менюто по продуктови групи, със снимки, цена (с happy hour), алергени и какво е изчерпано. Продукти с избор или меню отварят прозореца за избор.
4. Кошницата: промяна на количествата и евентуално Нещо друго към това?.
5. Поръчай (плащане на касата): гостът вижда своя номер за вземане голям на екрана със сумата, получава листчето и плаща на касата. В касата поръчката е отворена като Киоск Вход · 42 (номерът, който гостът казва); таксува се както винаги. След това тя се показва като платена на екрана за повикване и отива в кухнята, ако това трябваше да стане едва след плащане.
6. Плащане с карта: касата изпраща сумата към терминала на този киоск (същата връзка за плащане като на касата). Ако не успее, гостът може да опита отново или да откаже (или, ако може да избира, все пак да плати на касата). Едва когато плащането е успешно, поръчката отива в кухнята и се приключва. Гостът вижда своя номер за вземане голям на екрана и получава бележката.
7. След няколко секунди киоскът се връща в началото.

При повреда: известие и авариен режим (в приложението на киоска, управление → Bij storing; по подразбиране изключено). Ако киоскът не може да се свърже с касата, показва Even gesloten. Две допълнителни функции:

• Teams, Slack, Discord, ntfy, Home Assistant, Make или Zapier), и съобщение hersteld, когато отново работи. С Testmelding sturen проверявате адреса.
• Авариен режим: киоскът запазва просто меню, което му подава страницата на киоска: продукти без избор и без менюта, с цената за консумация на място (или за вкъщи, ако това е единственият избор).
  • Ако касата липсва известно време (по подразбиране 60 секунди), гостът поръчва от това меню.
  • Гостът плаща с карта или на бара. Плащане с карта е възможно само ако Pinbetaling е включено в приложението.
  • Отпечатват се две аварийни бележки: една за госта (N1, N2 …) и една за бара/кухнята. На тях пише, че не са касова бележка.
  • Когато касата се върне, страницата на киоска въвежда аварийните поръчки в касата като Nood N… <киоск>. Те не отиват в кухнята (тя вече е получила аварийната бележка) и не се показват на екрана за повикване.
  • Платено с карта и същата сума като в касата: отчетено като Ръчно плащане с карта. Иначе (плащане на бара или различна сума) поръчката остава отворена за обслужването.
  • Всичко се записва в дневника.
• Белгия: с регистрираната касова система (GKS, черна кутия) всяка продажба трябва веднага да мине през касата и FDM. Тогава аварийният режим вероятно не е разрешен; първо проверете. В Белгия приложението на киоска го включва само след допълнително потвърждение, а касата показва предупреждение при киоска.

В касата поръчката от киоска е обикновена поръчка (за вкъщи или на място, с името Киоск Вход) на името на служителя Kiosk. Касата го създава сама; никой не може да влезе с него. Не го правете неактивен, иначе киоскът не може да поръчва. Поръчките от киоска са в отчетите, в Бележки и на екрана за повикване. Поръчка, която не е завършена на киоска (не е поръчана или не е платена с карта), изтича сама след 30 минути.

Плащане с карта в тестов режим (Настройки → Плащания)? Тогава киоскът реално не таксува; удобно за проба. Без интернет не може да се плаща с карта; киоскът тогава казва, че може да се поръча на бара.

Повреда: ако касата е недостъпна, приложението на киоска показва "Временно затворено" и продължава само. Ако киоскът работи през портала за управление и интернетът отпадне, приложението може да премине към касата в локалната мрежа (в приложението: управление → Разширения → При повреда към локалната мрежа); адреса го подава самият киоск.

Изключване: киоскът показва, че е затворен за момент. Киосковете и настройките се запазват. В дневника са включване/изключване, настройките, добавени и премахнати киоски, свързвания и отменени поръчки.

Дигитално меню

Менюто с цени на телевизор (или друг монитор с браузър), директно от касата. По подразбиране изключено; включва се от Настройки → Заведение → Екрани и управление → Дигитално меню. След това отворете на телевизора http://<kassaserver>:3000/menubord (или използвайте бутона На отделен екран / На таблет или телефон с QR кода). Без вход и без свързване.

• За всяка продуктова група продуктите с цена, в реда от касата. Изберете сами кои групи (и в какъв ред), от 1 до 4 колони, тъмно или светло, собствено заглавие (празно = името на заведението), снимки на продукти и алергени.
• Винаги актуално: таблото проверява менюто на всеки 10 секунди (и веднага при промяна), така че изчерпан продукт (зачеркнат с Изчерпано или махнат от таблото), изчерпана наличност, happy hour (промоционалната цена със зачеркната нормална цена, а името и крайният час най-горе) и периодите на менюто (само това, което се продава сега) се показват правилно автоматично.
• Ако не всичко се побира на екрана, страниците се сменят (по подразбиране на всеки 12 секунди, настройва се от 5 до 120).

Персонал и ПИН кодове

Настройки → Персонал (само администратор): добавяне на служители, промяна на име, роля и ПИН код, и деактивиране.

• Роли: сервитьор (поръчване, плащане, X отчет), мениджър (освен това отстъпка, връщане, приключване на деня, касово чекмедже и дневник) и администратор (всичко, включително всички Настройки). Това е по подразбиране; какво могат сервитьорът и мениджърът, може да се променя (вижте Права по роли).
• ПИН код от 4 до 8 цифри, уникален сред активните служители. ПИН кодовете се пазят в базата данни само криптирани (хеш) и не могат да бъдат прочетени обратно.
• Окончателно изтриване не е възможно (бележките и дневникът сочат към служителя); неактивен = не може вече да влиза.
• Винаги остава поне един активен администратор.
• Друга роля, нов ПИН код или деактивиране: текущите сесии на този служител се прекратяват веднага.
• Белгия: по избор национален регистрационен номер за регистрацията на персонала.
• Език: езикът на екраните за този служител (или "Език на устройството"). След влизане касата веднага е на този език; служителят може да го смени и сам с флагчето долу вдясно (вижте Езици).
• Съвет: сменете демо ПИН кодовете 1111 и 2222, преди касата да започне работа.

Вход с карта (по избор)

По подразбиране изключено. Включване: Настройки → Персонал, отметка Вход с карта (NFC, RFID или iButton). Нужно: USB четец на карти, който работи като клавиатура (за NFC или RFID карти, ключодържатели, гривни или iButton ключове). Такъв четец "въвежда" номера на картата и натиска Enter; не е нужен драйвер или връзка.

• Сдвояване: докоснете служителя, после Сдвои карта и доближете картата до четеца. Една карта принадлежи на един служител. Премахни картата, ако е изгубена.
• Вход: на екрана за вход доближете картата до четеца. ПИН кодът също продължава да работи както обикновено.
• Начало и край на смяна (ако е включено): на екрана за вход Начало / край на смяна и картата до четеца.
• Номерът на картата се пази в базата данни само криптиран (хеш), както ПИН кодът. Неактивни служители не могат да влязат и с картата си.
• Изкл.: вход само с ПИН код, както винаги. Сдвоените карти се запазват.

Права по роля

Настройки → Права (само администратор): отметнете за всяка роля какво могат сервитьорът и мениджърът. По подразбиране всичко е точно както е описано по-горе (както касата винаги е работила); квадратче, което се различава, е оцветено.

• Администраторът винаги може всичко. Промяната на персонала и правата винаги остава само за администратора (иначе някой би могъл да си даде повече права).
• Бутоните и разделите, които една роля няма право да използва, са скрити за нея; касовият сървър също проверява това. Ако мениджър получи напр. Управление на продукти, той вижда бутона Настройки само с раздела Продукти.
• Промените важат веднага на всички каси и се записват в дневника. Върни по подразбиране връща всичко както е било.

Данни на заведението

Настройки → Обект (само администратор): име, адрес, пощенски код, населено място, телефон и ДДС номер на обекта. Те стоят най-горе на всяка касова бележка и про форма. Тук може да се зададе и текстът в долната част на бележката (може на няколко реда; празно = без текст; по подразбиране "Bedankt en tot ziens!"), а под него езикът на касовата бележка (по подразбиране нидерландски; вижте Езици). Пример на бележката се обновява на живо. След запазване следващата бележка веднага използва новите данни. Държавата и данъчните данни (GKS) нарочно не могат да се променят тук. В Белгия ДДС номерът е задължителен. С отметката Закръгляй плащанията в брой до 5 цента (по подразбиране изключено) общата сума при плащане в брой се закръгля (€ 6,62 → € 6,60, € 6,63 → € 6,65); разликата се вижда като "Закръгляне" на бележката. Плащането с карта винаги е точно до цент.

Управление на продукти

Влезте като администратор и изберете Настройки → Продукти.

• Добавяне, промяна (име, цена, категория, ДДС ставка на място и за вкъщи, име на бележката, код, изчерпан) и изтриване на категории и продукти. Категориите и продуктите могат да имат собствен цвят; продукт с цвят получава оцветен бутон на екрана за поръчки (текстът автоматично е бял или тъмен за по-добра четливост).
• Променете подредбата, като плъзнете категория или продукт за ≡. Това работи с мишка и с пръст на таблет. Точно тази подредба се показва след това на екрана за поръчки; отворените екрани на касата се обновяват веднага.
• Изтриването премахва продукта от касата, но старите поръчки и фискалният журнал продължават да го познават. Категория може да се изтрие само когато е празна.
• Опции за избор: отворете продукт или категория и добавете в "Опции за избор" групи опции, като "Степен на изпичане" (точно една, задължително), "Сос" (най-много един) или "Екстра" (няколко, с минимум и максимум; празен максимум = без ограничение). Всяка опция има име и добавка към цената (може да е отрицателна, напр. -0,50). Групите опции на категория важат за всички продукти в нея, в допълнение към собствените опции на продукта. Подредба с ▲▼. Изтриването е възможно винаги: съществуващите поръчки и бележки пазят сами избраните опции. Сървърът също проверява задължителните опции и максимума.
• Снимка за всеки продукт: вижте Снимки на продукти.
• Цена за килограм, PLU номер и тара (само когато везната е включена): вижте Настройка на везната. Без отметка продуктът си остава на брой.

Снимки на продукти

Всеки продукт може да има снимка.

• Добавяне на снимка: Настройки → Продукти → изберете продукта → Избери снимка (на таблет или телефон може и директно с камерата). Снимката се намалява в браузъра до най-много 512 × 512 пиксела (JPEG, обикновено 20–80 kB) и се запазва веднага; Друга снимка я заменя, Изтрий снимката я премахва. В списъка с продукти пред името има малка снимка. Само с правото Управление на продукти; jpg, png и webp, най-много 512 kB.
• Какво да се показва, избира администраторът в Настройки → Обект → Снимки на продукти, поотделно и по подразбиране изключено:
  • Снимка на продукта върху бутоните на екрана за поръчки: снимката най-горе на бутона на продукта, с името и цената отдолу.
  • Снимка на продукта при продуктите на клиентския дисплей: малка снимка пред всеки ред на клиентския дисплей (самият клиентски дисплей също трябва да е включен). Продуктите без снимка остават каквито са; ако е изключено, всичко работи точно както преди.

Баркод скенер

С баркод скенер на касата сканираш продукти, кодове за отстъпка, клиентски карти и ваучери. Включва се в Настройки → Скенер (раздел до принтерите и везната; по подразбиране изключено). Отметни какво прави едно сканиране в екрана за поръчки:

• Продукт в бележката: продуктът с този код (Настройки → Продукти, поле Код; напр. EAN баркодът от опаковката). При избори, меню или цена на килограм първо се отваря прозорецът за избор или везната, както при докосване. Същото прави и Сканиране в екрана за поръчки при Печат на етикети; то продължава да работи както досега.
• Код за отстъпка в бележката (ако кодовете за отстъпка са включени).
• Клиентска карта: клиентът с този номер на карта влиза в бележката (ако клиентската карта е включена). Ако сканираш непознат код в бележка с клиент, касата пита дали това е новата му карта.
• Ваучер или предплатена карта: касата показва салдото (ако ваучерите със салдо са включени). Плащането е в Плащане → Ваучер; там можеш и да сканираш ваучера.

Касата търси първо сред продуктите, после сред клиентските карти, ваучерите и кодовете за отстъпка. Сканирането работи в екрана за поръчки, когато не си в поле за въвеждане. В поле за въвеждане кодът просто влиза в това поле.

Тест на скенера: в Настройки → Скенер при всяко сканиране виждаш кода и какво прави касата с него, дори скенерът още да е изключен. Ако не работи:

• Настрой скенера като клавиатура (USB-HID), с Enter след кода. При повечето скенери това вече е така.
• Вграден скенер (напр. на каса Sunmi) настройваш на въвеждане от клавиатура в настройките на скенера на устройството.
• Етикетите от везната TS6X (тегло и цена) се обработват от самата везна, и при включен скенер.

На киоска скенерът се настройва отделно (Настройки → Заведение → Киоск); виж Киоск за самообслужване.

Печат на етикети

Етикети за артикули с името, цената и баркод, на етикетен принтер (Brother, Dymo, Zebra ...), инсталиран на компютъра или таблета. Включва се в Настройки → Заведение → Печат на етикети (по подразбиране изключено). Там избираш и размера на етикета (38 × 25, 57 × 32, 62 × 29 или 100 × 50 mm) и дали цената и баркодът да са на него. Пробен печат отпечатва един пробен етикет.

• Настройки → Продукти → (продукт) → Етикети: избери брой и Печат.
• Покупки → (получена поръчка) → Печат на етикети: за всеки продукт толкова етикета, колкото са пристигнали (получени поръчкови единици × брой в поръчкова единица; без съставки). Най-много 500 етикета наведнъж.
• Касата отваря диалога за печат: там избери етикетния принтер и размера на хартията на ролката. Всеки етикет е една страница.
• Баркодът е кодът на продукта (Настройки → Продукти): 8 или 13 цифри с вярна контролна цифра = EAN (12 цифри: контролната цифра се добавя), иначе Code 128 (букви, цифри и препинателни знаци, до 30 знака). Без код няма баркод.
• Сканиране в екрана за поръчки (отметка, по подразбиране изключено): баркод скенер, който работи като клавиатура, добавя продукта с този код, с обичайните избори (опции, везна, алергия). Не заедно с везната TS6X, която има собствени етикети с тегло и цена.
• Право: Управление на продукти или Управление на наличности.

Настройка на кантара (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)

Отделен раздел Настройки → Везна (право Настройка на обект, плащания и принтери, по подразбиране само администраторът; разделът е винаги там, дори ако везната още е изключена). По подразбиране е изключено: тогава касата работи точно както преди. Не виждате раздела?

Автоматично търсене. Ако още нищо не е настроено, касата търси автоматично при отваряне на този раздел (бутонът Търсене търси отново):

• касата (сървърът) работи на самата Aclas PC или AI везна (TS6X, TS3X, TS5EX/NX/GX, iS6X, iS2X, iR6X, Ti6X, iL8X; марка/модел на устройството: Windows чрез WMI, Android чрез getprop, Linux чрез DMI) и Aclas Scale Module отговаря? Тогава тази везна се настройва като На това устройство, както и везната за етикети; на Linux (без Scale Module) вградената везна се настройва на намерения вътрешен порт (/dev/ttyS...) като "TS6X (ingebouwd)", заедно с модела;
• има ли OS6X на COM/USB порт? Всеки порт се пробва с 9600, 4800, 2400 и 19200 бода: първо кратко слушане (непрекъснато), след това изпращане на W (Toledo), а иначе Dialog 06 (9600, 7 бита данни, нечетна четност: заявка за статус).

Намерено = попълва се във формуляра с бутона Включи и използвай: едно докосване и работи. (Търсенето изпраща W до всеки свободен COM порт; зает порт, напр. от ПОС терминала, се пропуска.)

Всички везни Aclas. За всяка везна избирате модела; така касата знае как може да се свърже. Има два вида:

• На това устройство (настройва се веднъж): касата работи на самата везна (PC или AI везна). С Windows или Android тя тегли чрез Aclas Scale Module, без порт, скорост или протокол; с Linux (без Scale Module) чрез вътрешния порт на везната (обикновено /dev/ttyS0 или /dev/ttyS1), с порт, скорост и протокол. На каса има само една такава; Търсенето я намира автоматично. PC или AI везна (TS6X, iS6X ...) винаги е На това устройство: в списъка може да е само веднъж и тогава другите PC/AI модели вече не могат да се изберат. TS6X на друго място в заведението все пак може да печата етикети (тогава включете само Сканиране на етикети).
• Свързана (няколко едновременно): везната е свързана към сървъра на касата с кабел (RS232/USB), Bluetooth или чрез мрежата. Колкото са нужни (до 8), всяка със собствено име.

Един списък, две отметки. Всички везни са в един списък. За всяка везна отбелязвате какво прави: Теглене на касата (касата иска теглото при поръчка) и/или Сканиране на етикети (везната печата етикет с баркод, който касата сканира, и получава PLU кодовете от касата). PC или AI везна като TS6X може и двете; LS везна за етикети – само етикети. Етикетите може да идват от една везна на заведение.

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 и Zebra. Включени са често използваните модели на тези марки, за които е ясно как касата комуникира с тях (за тестване = протоколът не е посочен дословно в нито един източник; касата избира най-вероятния). Всички свързани (няколко едновременно) или като кантар за етикети, чийто етикет касата сканира:

• A&D EK-i и HV-WP: настройте кантара на stream (EK-i: prt 0; фабрично е на бутона PRINT) и касата на Непрекъснато с 2400 бода и 7E1 (така A&D е настроен фабрично). Съобщението е ST,+00512.00 g (US = движи се, OL = твърде тежко).
• Adam Equipment Swift: настройте кантара на непрекъснато към компютър (8N1); касата тогава е на Непрекъснато.
• Avery Berkel FX110, FX120 и FX131: на кантара изберете протокола Mettler Toledo 82/7 и настройте касата на Поискай (Toledo) с 7E1 (9600 бода). Dialog 06 също работи. FX125 (с ценови дисплей) няма Toledo: там Dialog 06. Касата настройва това сама, когато изберете модела.
• Avery Weigh-Tronix 7820, 7829 и ZP900 и Brecknell 6702U, 6710U и 6720U: NCI, протоколът на Weigh-Tronix. Касата изпраща W (както при Toledo), кантарът отговаря с теглото ( 1.234KG) и ред за състояние; той показва дали се движи, дали е твърде тежко или твърде леко. Касата е на Поискай (Toledo) с 7E1 (9600 бода). USB работи като виртуален COM порт. При ZP900 настройте касата на порт 2 (NCI). При 67xxU на кантара може да се избере и 8213 (SCP03).
• Balanzas Marques BM1000P TOP: при COM порта изберете протокол B (METTLER) и 9600 бода, 7 бита данни, четна четност; тогава касата е на Поискай (Toledo) с 7E1.
• Baxtran TW, VW, XTA и XTA-P (кантари с изчисляване на цена; VW и XTA-P с колона): в менюто RS232 на кантара изберете протокола Toledo, 9600 бода и 7 бита данни с четна четност (7E1); тогава касата е на Поискай (Toledo) с 7E1. Касата настройва това сама, когато изберете модела. CONT (кантарът изпраща сам) също работи: тогава настройте касата на Непрекъснато със същата скорост и битове данни. Свързване с кабела RS232 (9-пинов) или кабел USB-RS232.
• Bizerba CS 300: Checkout-Dialog 06 (спецификацията на Bizerba): касата изпраща цената за кг, легализираният кантар изчислява сумата. Ако кантарът поиска контролни кодове, ще ги получите от Bizerba или доставчика.
• CAS PD-II, PDN, PDI и PDS-B (PDS-B напр. при LRE): на кантара изберете ECR type 2 (Toledo) и настройте касата на Поискай (Toledo) с 7E1 (9600 бода).
• Datalogic Magellan 9300i, 9400i и 9800i: задайте Scale Interface Type на отделния порт за кантара на Mettler Toledo 8217 и касата на Поискай (Toledo) с 7E1.
• Dibal KS-400, D-POS 400, G-325 и PI-100: на кантара изберете протокола Checkout_Dialog06 (протокол 24) и 9600 бода, 7 бита данни, нечетна четност (тип параметър 5); тогава касата е на Dialog 06. D-POS 400 може да се свърже и през USB.
• DIGI DS-781: настройте кантара на Type B / стандартна команда (data transmission 00011); касата изпраща ENQ и получава нето, тара, цена за кг и сума.
• Dini Argeo DFW, DGT и 3590E: настройте серийния порт на непрекъснато изпращане (9600 8N1); касата тогава е на Непрекъснато.
• Excell Precision TPE (и 4-то поколение AM4, FD4-P, FDP4-P, GE4, GEP4): настройте изхода RS232 на непрекъснато (9600 8N1); касата тогава е на Непрекъснато.
• Gram XFOC RS, XFOC+ RS и ZFOC RS: протокол Gram (9600 8N1). Касата изпраща ENQ, кантарът отговаря с ACK, касата изпраща DC1 и кантарът изпраща теглото: SOH STX S/U/F teken gewicht eenheid BCC ETX EOT (S = стабилно, U = движи се, F = грешка; BCC = XOR от статуса до мерната единица включително). Свързване чрез RS232 или с USB кабела от Gram.
• Kern & Sohn RPB и RFC: задайте на кантара Prot = DLG-06 (връзката с касата е опция 965-419); касата тогава е на Dialog 06. RFE, IFB и EOC: непрекъснато изпращане (8N1), касата на Непрекъснато.
• Mettler Toledo Ariva/Viva: настройте кантара на протокол Toledo (8217) и касата на Поискай (Toledo) с Битове данни / четност = 7E1 (Mettler: 9600 бода, 7 бита данни, четност even; Ariva може да се свърже и през USB като виртуален COM порт). Касата настройва това сама, когато изберете модела.
• Minebea Intec Signum, Combics, Midrics и Puro и Sartorius Entris и Quintix: SBI с автоматичен печат (9600 8N1); касата тогава е на Непрекъснато. Съобщението е N + 0.512 kg; без мерна единица още се движи.
• Ohaus Aviator 7000: в настройките на кантара (стъпка 20) изберете протокола Dialog 06; тогава касата е на Dialog 06. RS232 или USB, в зависимост от кабела.
• Ohaus Valor 7000, Ranger 3000/4000/7000 и Defender 3000 (претегляне без цена): настройте кантара на Auto Print Continuous (9600 бода, 8N1) и касата на Непрекъснато. Кантарът изпраща 0.512 kg G; ? след теглото означава, че още се движи. Ranger 7000 може да се свърже и през Ethernet (TCP порт 9761).
• Precia Molen DP400, DPOS CR и C 210 (търговските кантари са на Dibal от 2025 г.): Dialog 06 (9600 7O1), както Dibal. Ако при C 210 не работи, опитайте Поискай (Toledo) с 7E1.
• Precisa XB, XT, LS и LX: настройте режима на печат на CONTINUOUS и 9600 8N1, без дата, час и ID на реда; касата тогава е на Непрекъснато. Без мерна единица теглото още се движи.
• Rice Lake BenchPro BP-S (Toledo 8213) и BP-R (NCI): касата е на Поискай (Toledo) с 7E1.
• Star Micronics mG-T и mG-S8200: чрез RS232 или USB (виртуален COM порт, с драйвера на Star) на Непрекъснато.
• UWE ASEP: RS232 към компютър/каса, касата на Непрекъснато (за тестване).
• Wedderburn TSDS983, TSDS781T и TSDS782T са кантари DIGI под собствен номер: DIGI (Type B), както DIGI DS-781. Ако това не работи, опитайте Поискай (Toledo) с 7E1.
• Wintec ScalePOS ACS-S60E: касата работи на самия ScalePOS; вграденият кантар е на COM6 (Windows) или COM4 (Android), 9600 8N1. Изберете Непрекъснато; ако не изпраща нищо, Търси намира правилния протокол.
• Zebra MP7000 и MP72: портът RS232-AUX е фабрично на SASI (9600 7E1, касата изпраща W): касата на Поискай (Toledo) с 7E1.
• Кантарите за етикети на тези марки (Avery Berkel, Balanzas Marques, Bizerba, CAS, Dibal, DIGI, Ishida, Mettler Toledo, Precia Molen, Rongta, T-Scale, Wedderburn) са самостоятелни системи със собствен PLU файл. Включете Сканиране на етикети за кантара и задайте същия баркод като на кантара (EAN-13, начало 20–29, PLU и тегло или цена). PLU задавате на самия кантар или със софтуера на марката; Изпрати към TS6X и Изтегли PLU файла са само за Aclas.

Същият списък е в касата в Настройки → Везна → Всички кантари (ACLAS_MODELLEN в packages/shared/src/weegschaal.ts, с марката за всеки модел).

Възможно най-малко попълване: когато изберете модел, касата подготвя останалото, както марката го настройва фабрично: връзка COM порт / USB на първия свободен порт, 9600 бода (A&D: 2400) и протокола на марката (Toledo: Aclas с 8N1, а с 7E1 Avery Berkel FX, Avery Weigh-Tronix, Balanzas Marques, Baxtran, Brecknell, CAS, Datalogic, Mettler Toledo, Rice Lake и Zebra; Dialog 06: Avery Berkel FX125, Bizerba, Dibal, Kern & Sohn RPB/RFC, Ohaus Aviator и Precia Molen; DIGI Type B: DIGI и Wedderburn; Gram: Gram; Непрекъснато: A&D, Adam Equipment, Dini Argeo, Excell Precision, останалите Kern & Sohn, Minebea Intec, останалите Ohaus, Precisa, Sartorius, Star Micronics, UWE и Wintec) и име (напр. OS6X, OS6X 2). PC или AI кантар става На това устройство (напр. TS6X (ingebouwd); в Linux на вътрешния порт /dev/ttyS0). Ако нещо не е наред, Търси намира правилния порт, скорост и протокол.

На това устройство (Aclas Scale Module): везната показва калибрираното тегло; касата изпраща цената за килограм и тарата (като предварителна тара) и взема сумата, която везната изчислява, точно както при Dialog 06.

• Android: приложението на Aclas AclasScaleDriver (com.aclas.aclasscaledriver) обикновено вече е на кантара; ако не е, инсталирайте aclas-android/AclasScaleDriver.apk. Приложението HorecaPOS комуникира директно с услугата на това приложение, така че не е нужна допълнителна библиотека.
• Linux: Aclas няма Scale Module за Linux. Просто изберете модела (напр. TS6X): тогава връзката става На това устройство (вътрешен порт) на /dev/ttyS0, 9600 бода, Toledo. Вградената везна обикновено е на /dev/ttyS0 или /dev/ttyS1; Търсенето ги пробва и попълва правилния порт, скорост и протокол. И тук тя може да се добави само веднъж.

Софтуерът на Aclas идва с касата: Scale Module за Windows (aclas-module), AclasScaleDriver за Android (aclas-android) и Aclas Sync SDK за Windows и Linux (aclas-sdk). Aclas ни разрешава да ги доставяме. Инсталаторите за Windows и Linux ги включват; нищо не се изтегля или инсталира отделно.

Bluetooth (напр. OS6X): първо сдвоете везната. Windows я превръща в COM порт (Настройки за Bluetooth → Още опции за Bluetooth → COM портове), Linux – в /dev/rfcomm0: въведете този порт. В приложението за Android въвеждате Bluetooth адреса (00:11:22:AA:BB:CC); приложението веднъж иска разрешение за Устройства наблизо и се свързва чрез Bluetooth SPP.

AI везни (разпознаване на продукти): камерата разпознава продукта в софтуера на Aclas на везната. Тегленето работи чрез Scale Module (на това устройство) или чрез порта RS232; AI везните за етикети след разпознаване печатат етикет с баркод, който касата сканира (както при TS6X).

Aclas AI Recognition Plugin (AI везна с касата на нея, напр. iS6X с Windows): плъгинът на Aclas разпознава продукта и въвежда баркода му в касата, точно като скенер (последван от Enter); екранът за поръчки добавя продукта с теглото към поръчката. Ето как да го настроите:

• Включете за везната Сканиране на етикети със същия баркод като в плъгина. Препоръка: започва с 27, PLU 5 цифри, тегло (Aclas тип 17): тогава касата сама смята с цената за килограм. С цената (тип 12, започва с 22) също може.
• За тази везна изключете Теглене на касата: плъгинът и Scale Module не могат да достъпват везната едновременно. Теглото идва от баркода. Ако плъгинът отговори при Търсене, касата предлага тази настройка и не стартира Scale Module. Без код за активиране плъгинът тегли и изчислява сумата, но не разпознава продукти.
• В самия плъгин: баркодът в Scale and Barcode Format Settings → Default Barcode Format (тип 17), а в настройките на прозореца – точката, където плъгинът щраква и въвежда кода. Изберете за това празно място на екрана за поръчки, не бутон. Новите продукти заведението само обучава плъгина да разпознава на везната (AI обучение).
• Дайте на продуктите за претегляне PLU номер и изпратете PLU към везната (Изпрати към TS6X или PLU файла); плъгинът разпознава по PLU номер.
• Касата позволява на плъгина да разпознава само докато екранът за поръчки е отворен на самата везна (POST /aiplugin/resume, при затваряне /aiplugin/suspend, порт 5003 на везната; първия път и EmployeeMode: клиентският дисплей на везната не показва продукти). На други каси и таблети и през портала за управление не се случва нищо.
• Плъгинът винаги стартира в Resume и не може да съобщи състоянието си. Затова екранът за поръчки изпраща отново resume на всеки 30 секунди; ако това спре (затворен екран, рестартиран плъгин или везна), касата превключва плъгина на Suspend до една минута и го държи там.
• Плъгинът изисква код за активиране от Aclas за всяка везна (свързан със серийния номер). Работи сега на Windows; версията на Aclas за Android предстои (касата прави там същото).

Aclas OS6X (POS везна на касата, RS232/USB; така работят и другите свързани везни):

• Една или повече везни (най-много 8), всяка с име (напр. Щанд, Бар) и собствена връзка: COM порт / USB (COM3 на Windows, /dev/ttyUSB0 на Linux/Android) със скоростта, или мрежа чрез сериен-към-мрежа конвертор (IP адрес и TCP порт, напр. 4001).
• Протокол: Поискай (Toledo) = касата изпраща W и кантарът отговаря с теглото (Toledo 8217, така обикновено е настроен OS6X; също съобщенията нестабилно/претоварване/под нулата) или Непрекъснато = кантарът сам постоянно изпраща теглото (ST,GS, 0.512kg, US = нестабилно) или Dialog 06 (калибрирана), вижте по-долу, или DIGI (Type B) = касата изпраща ENQ и DIGI отговаря със статус, нето, тара, цена за кг и сума (37 знака: <status> <toestand> CR 0<netto> CR 4<tarra> CR U<kiloprijs> CR T<bedrag> CR LF; състояние бит 1 = стабилно, бит 2 = под нулата, бит 3 = твърде тежко, бит 4 = твърде леко), или Gram = касата изпраща ENQ, чака ACK, изпраща DC1 и чете SOH STX <S/U/F> <teken> <gewicht> <eenheid> <BCC> ETX EOT. Задайте на кантара същия протокол и скорост. Битове данни / четност: 8N1 (Aclas, Adam Equipment, DIGI, Dini Argeo, Excell Precision, Gram, Kern & Sohn, Minebea Intec, Ohaus, Precisa, Sartorius, Star Micronics, UWE, Wedderburn, Wintec) или 7E1 (A&D, Avery Berkel, Avery Weigh-Tronix, Balanzas Marques, Baxtran, Brecknell, CAS, Datalogic, Mettler Toledo 8217, Rice Lake, Zebra); Dialog 06 е винаги 7O1. Поискай чете и NCI (Avery Weigh-Tronix, Brecknell, Rice Lake BP-R): на W кантарът отговаря LF 1.234KG CR LF S00 CR ETX; редът за състояние (S + 2 или 3 байта) показва дали се движи (байт 1 бит 0), дали е твърде леко (байт 2 бит 0) или твърде тежко (байт 2 бит 1); ^^^^^ = твърде тежко, _____ = твърде леко.
• Dialog 06 (Checkout-Dialog 06, европейският протокол за калибрирана везна към каса): касата изпраща цената за килограм (и тарата на продукта) към везната; везната тегли, сама изчислява сумата и показва цена за килограм, тегло и сума на собствения си (калибриран) дисплей. Касата взема теглото и сумата; в прозореца за теглене пише "изчислено от везната". Винаги 9600 бода, 7 бита данни, нечетна четност, 1 стоп бит (скоростта в настройката тогава не се взема предвид). Последователност: EOT STX 01 ESC <kiloprijs 6> ESC ETX (с тара: запис 03 с 4 цифри грамове) → 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 = още не е готово, тогава нов опит след 100 ms; 20 = движи се; 21 = първо вдигнете; 30/31 = твърде леко; 32 = твърде тежко; 11 = невалидна цена). Контролни кодове: много везни с Dialog 06 от време на време (напр. на всеки 30 претегляния) искат контролните кодове на касовия софтуер (запис 11 → запис 10). Тези кодове и как се изчисляват производителят на везната дава само на доставчика на касата. Въведете ги в Контролни кодове (двойки от 4 шестнадесетични знака, напр. 74AE 1B2C); касата ги изпраща, когато везната ги поиска. Ако везната изчислява с променящо се число (Z) и затова фиксираните кодове не съвпадат, касата съобщава за това; тогава помолете доставчика да настрои везната без тази проверка или използвайте Toledo.
• Везните са свързани към компютъра или устройството, на което работи сървърът на касата; всички каси и таблети теглят чрез сървъра на касата и в прозореца за теглене избират коя везна използват. Тест претегля веднъж.
• Мрежата работи навсякъде.
• Въвеждане на теглото и на ръка: включено = теглото може да се въвежда ръчно и при наличие на везна; без OS6X това винаги е възможно.

Сканиране на етикети (отметка при везната: Aclas TS6X, друга PC или AI везна, серията LS или LH15X; везна + принтер за етикети, по една на заведение):

• IP адрес: нужен е само за Naar TS6X sturen. Тегленето и сканирането на етикети работят и без него. Ако касата работи на самата TS6X, оставете го празно: тогава касата изпраща към себе си (127.0.0.1). Ако същата везна тегли и на касата, двете отметки са при една и съща везна (Търсенето го настройва така).
• Сканиране на етикети: сканиране на етикети на екрана за поръчки. Задайте как изглежда баркодът, точно както на TS6X: започва с (20–29, по подразбиране 28), брой цифри за PLU (4, 5 или 6) и след това теглото в грамове или цената в центове, плюс контролната цифра (EAN-13). Под настройката има пример.
• PLU номера: в Настройки → Продукти продукт за теглене получава цена за килограм, по желание тара и PLU номер (уникален). PLU номера избирате от списък (Без PLU, следващ свободен, Друг номер…); когато отметнете Цена за килограм, следващият свободен номер вече е попълнен. Нужен е само за етикетите и PLU кодовете на TS6X: без TS6X може да остане Без PLU.
• Директното изпращане работи под Windows и Linux; под Android и macOS използвайте PLU файла. При първата инсталация проверете имената на полетата в PLU файла и кодовете в aclas-plu.ps1 спрямо ръководството за SDK на доставената везна (едно място за промяна: ACLAS_PLU_KOLOMMEN в packages/shared/src/weegschaal.ts).

Портал за управление: съобщението към портала има функцията Кантар (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) с вкл./изкл. и кантарите по модел (напр. TS6X (op dit apparaat), 2x OS6X, PS1CX, Ariva-S, DS-781, LS6RX, 5 producten per kilo); без IP адреси, COM портове или Bluetooth адреси.

Закон за измерванията: везна, с която продавате, трябва да е калибрирана (клас III, като OS6X). При Toledo/непрекъснато касата изчислява с теглото, което дава везната; при Dialog 06 калибрираната везна сама изчислява цената.

Код: packages/shared/src/weegschaal.ts (протоколи, етикети, PLU файл), apps/pos-server/src/lib/weegschaal.ts и routes/weegschaal.ts; екрани WeegschaalInstellingen.tsx и WeegDialoog.tsx.

Thuisbezorgd.nl / Takeaway.com

Поръчките от Thuisbezorgd.nl идват директно в касата, без посредник (без Deliverect, HubRise или подобни): Just Eat Takeaway JET Connect комуникира с портала за управление на Pin Voordeel, а касата взема съобщенията си оттам.

В Белгия платформата се казва Takeaway.com: същата компания (Just Eat Takeaway) и същата интеграция. За белгийско заведение в екраните, известията, кухненския бон и портала за управление навсякъде пише Takeaway.com вместо Thuisbezorgd.nl. По-долу Thuisbezorgd означава и двете.

Защо чрез портала? Касата има нужда само от PORTAAL_URL и PORTAAL_SLEUTEL (вижте Портал за управление) и прави само изходящи заявки.

Настройка (Настройки → Платформи за доставка → Thuisbezorgd.nl / Takeaway.com, право Настройка на обект, плащания и принтери; досега беше в Настройки → Заведение):

1. Включете Използвай Thuisbezorgd (действа веднага, независимо от Запази).
2. Регистрация в Thuisbezorgd. След това заведението избира в Thuisbezorgd (Partner Hub или акаунт мениджър) OptimumPOS / Pin Voordeel като своя каса. Тогава JET започва сесия за свързване; порталът намира регистрираната каса (по пощенски код и име, иначе Pin Voordeel свързва сесията ръчно в портала), изпраща конфигурацията и иска менюто от касата. След това интеграцията започва да работи.
3. Отметнете продуктите, които могат да се поръчват чрез Thuisbezorgd (по група или поотделно), по желание с описание за Thuisbezorgd. Менюто (цена, опции като модификатори, алергени, ДДС) се изпраща автоматично; PLU = id на продукта/опцията. След промяна в каталога касата обновява менюто до 30 секунди; само "изчерпано"/"отново налично" минава през API за наличност.
4. Работно време в Thuisbezorgd: отделно за доставка и за вкъщи (напр. 16:00-22:00, няколко блока, разделени със запетая). Запазват се с бутона Запази работното време под тях и отиват като service times към Thuisbezorgd, щом връзката е готова.
5. Временно затворено / Отново отворено (в NL/BE отново отворено най-късно в 07:00 на следващата сутрин).

Поръчки. Поръчката става обикновена поръчка без маса (bezorgen или afhalen, име на група TB <ordernummer>) с цените, които клиентът е платил, плюс такса за доставка/обслужване като отделен ред и отстъпката от Thuisbezorgd като ред за отстъпка; ако общата сума все пак не съвпада, се добавя ред "Verschil Thuisbezorgd". Кухненският бон отива веднага в кухнята/бара (може да се изключи). Касата потвърждава до секунди на портала, който съобщава на JET; ако това не стане до 3 минути или касата е офлайн, JET получава "неуспешно" и заведението преминава на Orderpad.

Бутон Thuisbezorgd в горната лента (с броя на текущите поръчки): списък, клиент и адрес, час за готовност/доставка и хронология (track & trace): получена, куриерът е на път към заведението, куриерът е в заведението, на път към клиента, доставена (от JET), плюс собствени стъпки (в приготвяне, готова, на път/доставена при собствена доставка, взета). JET Connect не предлага на касата карта на живо с куриера; клиентът я вижда в приложението на Thuisbezorgd. Нова поръчка, анулиране и "куриерът е в заведението" показват оранжева лента и звук. Приключи (платено онлайн) приключва с начин на плащане online; ако клиентът плаща на вратата, просто платете както обикновено. Анулиране от Thuisbezorgd отменя поръчката и отпечатва кухненски бон "GEANNULEERD" (анулирана).

Код: apps/pos-server/src/lib/thuisbezorgd.ts, routes/thuisbezorgd.ts; екрани ThuisbezorgdInstellingen.tsx и Thuisbezorgd.tsx. От страна на портала: horecapos-portaal/src/thuisbezorgd.mjs (вижте README на портала).

Брой в портала за управление. Броят поръчки от Thuisbezorgd на ден се включва в съобщението към портала за управление (verkoopTelling в lib/portaal.ts): получени и неанулирани, в деня на получаване. Поръчка от Thuisbezorgd, платена в касата (включително с Приключи (платено онлайн)), не се брои там втори път към за вкъщи/доставка. Данните от Thuisbezorgd са в базата данни на касата и затова просто влизат в архивите на касата.

Онлайн магазин и онлайн поръчки

Всяко заведение може да получи собствен онлайн магазин: сайт за поръчки (и приложение) в собствен фирмен стил за за вкъщи, доставка, поръчка на масата с QR код и резервации, с онлайн плащане (MultiSafepay или Buckaroo) или плащане при вземане/доставка. Онлайн магазинът е отделен проект, horecapos-webshop (Node.js, вижте README там), и работи на същия сървър като портала за управление.

Включването и настройването става в управлението на онлайн магазина: бутон Управление на онлайн магазина в клиентския портал (собственик) или при инсталацията в портала за управление (Pin Voordeel). Там са включване/изключване, уеб адресът (<zaak>.<webshopdomein> или собствен домейн), фирменият стил (цветове, лого, заглавна снимка, шрифт), работното време и часовите интервали за вземане и доставка, зоната за доставка (пощенски кодове, радиус или зона на картата, с такса и минимум), плащане, кодове за отстъпка, текстове, езици, QR кодове за масите, резервации и приложението (инсталируемо като PWA; Android приложение чрез Trusted Web Activity), както и push известията (по избор, по подразбиране изключени): гостът включва известие на страницата на поръчката си и получава push известие, когато поръчката е готова или на път; който желае, получава и от време на време оферта, която заведението изпраща от управлението на онлайн магазина (раздел Push известия). Работи на Android и на компютри (Chrome, Edge, Firefox, Samsung Internet), в Android приложението и на iPhone и iPad (iOS 16.4 или по-нова версия), ако гостът добави онлайн магазина към началния екран. Не се изпращат SMS или имейли и не се пазят име или номер. Подробности в README на онлайн магазина.

Меню. Касата изпраща менюто сама: всички активни продукти (не на килограм), по продуктови групи, с цена, опции, алергени, изчерпано и снимката на продукта, плюс масите и данните на заведението, както и кои маркетингови канали са включени (за отметката "получаване на оферти" при плащане, вижте SMS и имейл маркетинг). Това става при стартиране, щом онлайн магазинът се включи, до 30 секунди след промяна в каталога и до няколко секунди след промяна в Настройки → Заведение, например маркетинга или клиентската карта (или с Изпрати менюто сега). Продукт може да се извади от онлайн магазина в управлението на онлайн магазина (скриване) или в базата данни с artikel.webshop = false.

Поръчки. За вкъщи и доставката стават обикновена поръчка без маса (име на група WEB <bestelnummer>) с цените, които клиентът е видял, плюс таксата за доставка и транзакционните разходи като отделни редове и код за отстъпка като ред за отстъпка; ако сумата все пак не съвпада, се добавя ред "Verschil webshop". Бакшишът на клиента не се брои за оборот: той влиза като бакшиш в плащането при Приключи (платено онлайн). Поръчката на масата (QR код) отива в отворената сметка на тази маса (платено онлайн: като отделна група на тази маса). Кухненският бон отива веднага в кухнята/бара (може да се изключи в прозореца Онлайн магазин). Касата потвърждава до секунди с номера на бележката; клиентът тогава получава "получена" и имейл. Ако касата е офлайн, онлайн магазинът не приема поръчки (клиентът вижда това веднага) и изпраща имейл на заведението, ако поръчка чака твърде дълго. Резервациите от онлайн магазина влизат в Резервации (само ако резервациите в касата са включени). Ако има максимум на часови интервал (Доставка и часови интервали), поръчките от онлайн магазина с час в него също се броят.

Белгия (черна кутия). Поръчка от онлайн магазина веднага отива като поръчка (signOrder) към черната кутия, преди кухненския бон, както Поръчай на касата. Ако това не стане, тя не влиза в касата и онлайн магазинът я изпраща отново по-късно. Каквото още не е тествано с черната кутия, е изключено в менюто за онлайн магазина (ваучери, кодове за отстъпка, по сметка, по стая, менюта, опции с доплащане, happy hour и бакшиш) и се отказва, ако стар онлайн магазин все пак го изпрати. Приключи проверява бакшиша, плащането по сметка и по стая като касата.

По стая (хотелска връзка, Настройки → Хотел → Самообслужване → В онлайн магазина): менюто получава kamer: { maxBedrag }; онлайн магазинът изпраща betaling.wijze = "kamer" заедно с kamer и achternaam. Касата проверява госта в хотелския софтуер (не на маса, не с ваучер) и го запазва към поръчката; Приключи (по стая) приключва плащането по стаята и осчетоводява бона в хотелската сметка. Обща фактура при плащане по сметка: бонът тогава стои като открита позиция.

Бутон Онлайн магазин в горната лента (с броя текущи поръчки): списък, клиент и адрес, желан час или "възможно най-скоро", начин на плащане и хронология. Стъпките В процес на приготвяне, Готово и На път клиентът вижда на живо в онлайн магазина (и по имейл, ако заведението желае). Платено в касата = Приключена; Отказ анулира само редовете на тази онлайн поръчка, отпечатва кухненски бон "АНУЛИРАНА", а онлайн платена поръчка се възстановява от онлайн магазина. Пристигнал, неявил се или анулирана при резервация също се връща към онлайн магазина. Нова поръчка или резервация показва оранжева лента и звуков сигнал.

Код: apps/pos-server/src/lib/webshop.ts, routes/webshop.ts; екран Webshop.tsx. От страна на портала: horecapos-portaal/src/webshop.mjs.

Каса и онлайн магазин еднакво (всяка част се включва отделно, по подразбиране изключено; по-стар онлайн магазин пренебрегва новите полета). Каквото е включено в касата, работи и в онлайн магазина:

• Happy hour: онлайн магазинът начислява същата цена като касата в този момент (зачертана нормална цена и името на happy hour), също и със сезон.
• Периоди на менюто и вид поръчка (ако са включени): онлайн магазинът показва само това, което се продава в момента, а при вземане за вкъщи и доставка – цената и продуктите на този избор (на масата: на място). Менюто получава за всеки продукт prijzen (afhalen, bezorgen) и nietBij, както и списъка dagdelen.
• Менюта: гостът избира ястията (фиксирани и по избор, с техните опции); в касата то идва като ред меню с ястията под него и разпределена цена на менюто (ДДС за всяко ястие е точен). Ястия, които са само част от меню, се изпращат като menuArtikelen. Стар онлайн магазин без избор: менюто идва като обикновен продукт на бележката, както досега.
• Свършена наличност = изчерпано, също и опции с изчерпана съставка.
• Алергени: изключени в касата = не се показват в онлайн магазина.
• Клиентска карта: гостът може при плащане да събира точки (по телефонен номер или имейл); касата свързва клиента с поръчката, точките се добавят при плащането (осребряването става в заведението). Онлайн магазинът показва салдото.
• Ваучери (Настройки → Заведение → Ваучери → Продажба на ваучери в онлайн магазина, само със салдо): гостът купува ваучер и плаща онлайн; касата създава ваучера, който е активен веднага, а кодът се връща през портала към онлайн магазина (статус и имейл). Ако е включен и Ваучер като начин на плащане, гостът може при вземане за вкъщи да избере "с ваучер в заведението".
• Кодове за отстъпка (Настройки → Кодове за отстъпка, с превключвателя в Заведение): за всеки код на касата и/или в онлайн магазина; използването се брои общо за двете.
• Пауза и натоварено: бутон Онлайн магазин в горната лента: Пауза на онлайн магазина (с текст за госта) и Натоварено (допълнителни минути). Стига до онлайн магазина за няколко секунди.
• Онлайн резервация с правилата на касата (Настройки → Заведение → Резервации): най-много души, дни напред, времеви слот, минимум предварително и часовете за всеки ден от седмицата.
• Доставка и часови интервали: вижте Онлайн магазинът следва касата в Доставка и часови интервали.
• All-you-can-eat на масата (Настройки → Заведение → All-you-can-eat → И при поръчка на масата чрез QR кода): ако на масата тече пакет, гостът вижда ястията от пакета като Включено за € 0, с рундовете, максимума на човек, времето за чакане и ограничението на времето. Останалото плаща нормално; всичко отива в сметката на масата. Ако състоянието на масата току-що се е променило, касата отказва поръчката и гостът поръчва отново.
• По сметка (Настройки → Фактури → Плащане по сметка → И в онлайн магазина): виж В онлайн магазина при Плащане по сметка.
• Онлайн в списъка на чакащите (Настройки → Заведение → Списък на чакащите): виж Онлайн в списъка на чакащите при Списък на чакащи за гости без резервация.
• Допълнителни продажби: "Нещо друго към това?" (по избор, по подразбиране изключено; Настройки → Заведение → Плащане → Допълнителни продажби в онлайн магазина): изберете продуктовите групи (напр. напитки, сосове, десерти) и колко предложения. Тогава в онлайн магазина при кошницата и при плащането се показват продукти от тези групи, които още не са в кошницата (само това, което се продава в момента, не е изчерпано и е без задължителен избор); гостът ги добавя с едно докосване. Няма избрани групи = изключено, както досега. Киоскът има собствени допълнителни продажби (вижте Киоск за самообслужване).

За целта менюто за онлайн магазина има versie: 2 с полетата menuArtikelen, allergenenAan, happyhours, menus, klantenkaart, cadeaubon, kortingscodes, pauze, drukteMin, volgt, bezetting, reserveren.online, ayce, opRekening, wachtlijst и upsell. Потвърждението към портала освен това съдържа cadeaubonnen (кодове), klant (точки) и plek (списък на чакащите).

Брой в портала за управление. За вкъщи и доставката през онлайн магазина се броят отделно (webshop, webshopGeannuleerd в verkoopTelling), в деня на получаване, и не се броят втори път към за вкъщи/доставка. Поръчката на масата се брои нормално към масата.

Плащане с карта и терминали

Настройки → Плащане (само администратор):

• Терминали: за всеки терминал име, ID на терминала и собствен API ключ от PinPortal (Клиент → Редактирай клиент → Други → API Keys). След запазване се вижда само краят на ключа; той никога не се връща към браузъра. С Тествай връзката проверявате ключа и терминала.
• Тестов режим: симулира терминал (успешно след ок. 7 s; сума, завършваща на 13 цента, се отказва). Удобно за тестване без ПОС терминал.

Ако има поне един терминал с API ключ (или тестовият режим е включен), Плащане → Карта / Bancontact стартира плащането автоматично на терминала, за сумата, изчислена от сървъра.

Докато интеграцията е включена, сървърът приема "карта" само с успешно плащане на терминала за точно тази поръчка и тази сума. Заявките се изпращат като обикновен формуляр, както в официалния PHP SDK, с резервния API (api-backup.pinvandaag.com), ако основният API не отговаря. Всеки отговор от API се показва с [pin] в прозореца на сървъра, което помага при проблеми. Успешно плащане, което още не е обработено (напр. таблетът е изключил), се намира отново при следващото плащане на тази поръчка.

Бакшиш (карта, в брой и ваучер за подарък)

На екрана за плащане при всеки начин на плащане има ред бутони за бакшиш: Без, 5%, 10%, 15% (закръглено нагоре до 10 цента), Закръгли (до следващото цяло евро) и Друга сума. При карта клиентът плаща сума + бакшиш наведнъж на терминала; при плащане в брой бакшишът се включва в рестото и в касовото чекмедже. На бона е сумата, платена с карта, с "от които бакшиш" под нея; ОБЩО и ДДС остават същите, защото бакшишът не е оборот. В X/Z отчета бакшишът е показан по начин на плащане и като "Бакшиш общо".

Администраторът настройва бутоните за бакшиш в Настройки → Заведение → Бакшиш: вкл./изкл., кои проценти (най-много 4, напр. "5, 10, 15"), дали има бутон "Закръгли" и при кои начини на плащане (карта, в брой, ваучер за подарък) може да има бакшиш. "Без" и "Друга сума" винаги са налични.

"Нека бъдат …" е винаги наличен, при всеки начин на плащане, дори когато бутоните за бакшиш са изключени (без настройка): клиентът сам закръгля сметката нагоре и разликата е бакшиш. Има бутони със следващото цяло евро и следващите кръгли суми (напр. € 28,00 → 29, 30, 40; € 44,00 → 45, 50, 60) и Друга обща сума, за да въведете сами общата сума. Повторно докосване на избрания бутон = без закръгляне. Най-много € 500 бакшиш (същото ограничение като на сървъра на касата).

Няма интернет

Касата работи в локалната мрежа и не се нуждае от интернет; само плащането с карта чрез интеграцията се нуждае. Ако заведението няма интернет, в горната лента пише Няма интернет · карта ръчно (проверява се всяка минута). Тогава на екрана за плащане, както и след неуспешно стартиране на терминала, се появява бутонът Вече платено с карта на терминала: приемете плащането на самия терминал и го запишете така.

Планове и маси

Настройки → Планове на залата (само администратор):

• Добавяйте планове на залата (напр. Зала, Тераса, Зимна градина), преименувайте, изтривайте и променяйте реда им с ◀ ▶.
• Добавяйте маси с бутоните над решетката (кръгла, квадратна, дълга, бар маса) и ги плъзгайте на мястото им с мишката или с пръст. Синият ъгъл на избрана маса я прави по-голяма или по-малка.
• За всяка маса задайте име/номер, брой места (столчетата около масата се броят) и форма; дублирайте или изтрийте.
• С клавиатурата: стрелките преместват (Shift = по-голяма стъпка), Delete изтрива.
• Промените важат едва след Запази; "Отмени" връща всичко обратно.
• Маса или план на залата с отворена поръчка не може да се премахне. Изтритите маси остават запазени в старите поръчки.

Пренасяне на конфигурацията към второ заведение

Настройки → Импорт/експорт (само администраторът). Когато сте настроили изцяло едно заведение, експортирайте конфигурацията във файл .json и я импортирайте в касата на второто заведение. Може да се избира по раздели:

• Продукти: групи, продукти, цени (и по вид поръчка), ДДС, опции, менюта, happy hours (със сезон), периоди на менюто, алергени, съставки/рецепти, карти с печати, пакетите all-you-can-eat и снимките на продуктите.
• Планове на залата: зали и маси.
• Други настройки: всички опции на заведението, принтери (без IP адрес), права по роля и счетоводство.

Никога не се прехвърлят: име, адрес, пощенски код, град, телефон, имейл, ДДС номер и последен ред на бона на заведението, имейл адресът за Z отчета, ПОС терминалите и ключовете им, персоналът и ПИН кодовете, както и целият оборот, бонове, клиенти и количества на наличност.

Импортирането е силно защитено: голямо червено предупреждение, отметка "Разбирам...", отново собственият ПИН код на администратора, без отворени поръчки, същата държава (ставки на ДДС) и автоматичен архив предварително. Импортът става в една транзакция: ако нещо се обърка, нищо не се променя. Съществуващите продукти, групи, съставки и маси не се изтриват, а се премахват от касата (както при Изтрий), така че старите бонове и отчети остават верни.

Импорт от друга каса

Преминаване, без да преписвате всичко. Винаги налично (без превключвател): в Настройки → Импорт/експорт (само администраторът) се намира разделът Импорт от друга каса.

• Какво: продукти (име, цена с ДДС, ДДС, категория, код/PLU, наличност) или клиенти с клиентска карта (име, телефон, имейл, точки, адрес, пощенски код, населено място; името и фамилията се обединяват).
• Файл: експорт от предишната ви каса (Dobizzz/DoPos, Lightspeed, MplusKASSA, unTill, Tebi ...) или собствен списък: CSV (; , таб или |; UTF-8 или нидерландски Excel формат) или Excel (.xlsx), първият лист, с имената на колоните на първия ред. Стар .xls файл първо запазете като .xlsx или CSV.
• Преглед: касата разпознава колоните по името им (Omschrijving, Verkoopprijs incl. BTW, BTW %, Omzetgroep, Artikelnummer, GSM, Spaarpunten ...) и показва първите 10 реда. Ако някоя колона не съвпада, изберете сами. Нищо не се променя до Импортиране.
• Продукти: цени като 3,50, € 3,50 или 1.234,50; ДДС като 21, 9%, 0,09, висока или ниска (неизвестна или празна: ставката, която изберете, по подразбиране най-високата). Категориите, които още не съществуват, се създават (без категория: "Импортирани").
• Наличност (колона Voorraad, Stock, Aantal ...): ако Следене на наличности е включено (Настройки → Заведение), продуктът следи наличност и наличността става това количество (преброяване в историята на наличностите, причина "Импортирани"). Празно: наличността остава същата.
• Примерен файл (CSV): списък, който попълвате сами (Naam;Productgroep;Prijs;Btw;Voorraad;Code), например в Excel.
• Клиенти: точките се добавят като корекция "Импортирано от друга каса" (видимо в историята). Съгласието за SMS или имейл не се прехвърля (GDPR): поискайте го отново. Първо включете клиентската карта.
• Съществуващите продукти (същия код или, без код, същото име) и клиенти (същия телефон или имейл) се пропускат или се обновяват, ако отметнете това (при продуктите: име, цена, ДДС, категория и наличност). Дублираните редове във файла се вземат веднъж.
• Накрая: колко са нови, обновени и пропуснати, като за всеки ред е посочено какво не е било наред (напр. липсва цена). Най-много 5000 реда наведнъж. В дневника се вижда като "Конфигурацията е импортирана".

Езици (42, вкл. турски, арабски, дарижа, берберски, полски, български, унгарски, руски, сръбски, албански, персийски, тигриня, амхарски, сомалийски, папиаменто, сранантонго, хинди, урду, индонезийски, виетнамски, сирийско-арамейски, китайски и украински)

До бутончето © долу вдясно на всеки екран има бутонче с езика (напр. NL и знаменцето). Докоснете го за менюто за избор: езиците са по азбучен ред, с името на собствения език пред знамето: Bahasa Indonesia (индонезийски), Čeština (чешки), Darija (марокански арабски на латиница), Deutsch, English, Español, Français, Hrvatski (хърватски), Italiano, Kurdî (курманджи), Latviešu (латвийски), Lietuvių (литовски), Magyar (унгарски), Nederlands, Papiamentu (папиаменто), Polski, Português, Română, Shqip (албански), Slovenčina (словашки), Soomaali (сомалийски), Sranantongo, Srpski (сръбски, на латиница), Tarifit (рифски берберски), Tiếng Việt (виетнамски), Türkçe, след това на кирилица Български, Русский (руски) и Українська (украински), после езиците на арабска писменост: اردو (урду), الدارجة (дарижа), العربية (арабски), دری (дари), فارسی (персийски, фарси), پښتو (пущу) и کوردی (سۆرانی) (кюрдски сорани), след това на сирийска писменост ܣܘܪܝܝܐ (сирийски арамейски, сурйойо), на деванагари हिन्दी (хинди), на писменост геез ትግርኛ (тигриня) и አማርኛ (амхарски), на тифинаг ⵜⴰⵎⴰⵣⵉⵖⵜ (тамазигт, берберски) и накрая 中文（简体）(китайски, опростено писмо). Всички екрани, бутони, съобщения и съобщения за грешки от сървъра на касата се превеждат.

• За всеки служител: избраният език се запазва при влезлия служител (gebruiker.taal). Ако някой влезе с друг език, касата превключва веднага. Самото устройство помни последно използвания език, така че и екранът за ПИН код вече е на този език. Ако изберете език (на екрана за ПИН код или след вход) и влезете (отново) до 10 минути, този избор има предимство и става езикът на този служител. Смяната презарежда екрана; оставате влезли и отворената сметка остава отворена.
• Първи път на устройство: ако на таблет или компютър още няма зададен език, касата стартира на езика, избран при инсталацията. Ако не е избран език, се използва езикът на самото устройство (браузър или операционна система, също и в приложението за Android), а ако той не е сред наличните – нидерландски. След това всяко устройство помни собствения си избор.
• Източна Европа: полски, чешки, словашки, унгарски, румънски, български, хърватски (също и за босненски), литовски, латвийски, украински и руски: езиците на повечето трудови мигранти от Централна и Източна Европа в Нидерландия и Белгия.
• Балкани: сръбски (на латиница, както го пишат повечето сърби в Нидерландия и Белгия; също и за черногорски) и албански (Албания, Косово и Северна Македония).
• Африканският рог: тигриня (Еритрея) и амхарски (Етиопия), и двата на писменост геез, и сомалийски (на латиница).
• Иран: персийски (фарси). Устройство на персийски от Афганистан (fa-AF) получава дари, останалите – фарси.
• Карибска Нидерландия и Суринам: папиаменто (Papiamentu, правопис от Кюрасао и Бонер; и за Аруба) и сранантонго.
• Азия: хинди (деванагари; и за сарнами хиндустани), урду (от дясно наляво), индонезийски и виетнамски (латиница, и на касовата бележка).
• Марокански: дарижа (марокански арабски, говоримият език) на арабска писменост и на латиница (както много марокански нидерландци пишат в чатовете), наред със стандартния арабски. Берберски: тарифит (рифски, на латиница; повечето марокански нидерландци са от Риф) и стандартен марокански тамазигт на писмеността тифинаг.
• От дясно наляво: арабски (стандартен арабски), урду, дарижа на арабска писменост, дари и пущу (Афганистан), персийски (фарси, Иран), кюрдски сорани (Ирак/Иран) и сирийски арамейски (сурйойо, на сирийска писменост). Сумите, кодовете и цифровите бутони остават от ляво надясно. Кюрдският курманджи (Турция/Сирия) е на латиница.
• Кухненски бон (кухня/бар): по подразбиране на езика на служителя, който изпраща поръчката. За всеки принтер в Настройки → Принтери → Език на кухненския бон може да се зададе и фиксиран език (напр. този на готвача), на латиница: 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 или Türkçe. Български, руски и украински се отпечатват на кухненския бон с латинска транслитерация (принтерът за бонове не поддържа кирилица). Арабска, сирийска писменост, деванагари, писменост геез, тифинаг и китайски не могат да се печатат на принтер за бонове: тогава дарижа излиза на латиница, тамазигт като тарифит, а останалите на нидерландски. Постоянните текстове (TAFEL, Gang, WACHT op afroep, AFROEP GANG, LATER GEPRINT, Afhalen, Balie) се превеждат; имената на продуктите и бележките остават такива, каквито са въведени. Принтерите, които са били на нидерландски, следват езика на служителя.
• Касов бон (за всички клиенти): по подразбиране на нидерландски, независимо от езика на екраните. Друг език избирате в Настройки → Заведение → Език на касовия бон (точно под текста в долната част на бона), само езици на латиница. Това важи и за проформата, бона за връщане, копието, ваучера за подарък и бона по имейл. Сумите, кодовете на ДДС, ДДС номерът на заведението и фискалните редове (Белгия) остават същите; собственият текст в долната част на бона остава точно както заведението го е написало.
• Продуктите, групите и опциите се наричат така, както заведението ги въведе; те не се превеждат.
• Езика за всеки служител можете да зададете и в Настройки → Персонал.
• Въведението и ръководството също са на всички тези езици. Чрез бутончето © те се отварят на езика на касата; горе можете да изберете друг език със знаменцата (това не променя нищо в касата).

За разработчици: всеки видим текст е в кода като vt('Nederlandse tekst') (apps/pos-web/lib/i18n.ts); нидерландският текст е ключът. Преводите са в apps/pos-web/lib/vertalingen/<taal>.ts. Ако липсва превод, касата показва нидерландския текст; тестът i18n (pos-web) проверява дали всеки текст е преведен на всеки език и дали местата {0} съвпадат. Съобщенията от сървъра на касата остават на нидерландски и се превеждат в браузъра (също и с {0}, напр. име на продукт в съобщението).

Настройка на принтери

Новата каса няма принтери. Влезте като администратор (демо: 1111) и изберете Настройки в горната лента.

• Принтери: добавете толкова принтери, колкото има заведението (напр. каса, кухня, бар, пица), всеки с връзка (обикновено мрежата: IP адрес и порт 9100) и ширина на хартията. С Тестова бележка проверявате дали работи. Горе избирате кой принтер печата касовата бележка и проформата (и отваря касовото чекмедже). За всеки принтер избирате и езика на кухненския бон (вижте Езици); касовата бележка остава на нидерландски.
• Връзка за всеки принтер:
  • Мрежа (IP адрес): IP адрес и порт (обикновено 9100). Така работеше винаги и така ще продължи да работи: съществуващите принтери автоматично са на мрежа.
  • USB: на Linux устройството, например /dev/usb/lp0. На Android USB принтерът, свързан към устройството (OTG кабел; празно = първият USB принтер). На Windows и macOS изберете Системен принтер.
  • Сериен (COM / ttyUSB): COM порт (Windows), /dev/ttyUSB0 или /dev/ttyS0 (Linux, Android) или /dev/cu.… (macOS), със скоростта (обикновено 9600, 19200 или 38400 baud). Също и за Bluetooth принтер, който Windows или Linux сдвояват като COM порт или /dev/rfcomm0.
  • Bluetooth: в приложението HorecaPOS на Android, с Bluetooth адреса на сдвоения принтер (напр. мобилен принтер за бележки). Първо сдвоете принтера в настройките за Bluetooth на Android.
  • Системен принтер (Windows / CUPS): принтерът така, както го познава Windows или CUPS (Linux, macOS), със собствения му драйвер или като Generic / Text Only. Бележката отива към принтера необработена (RAW), без форматиране от драйвера.
  • Вграден (Sunmi, iMin ...): принтерът в самата Android каса.
  • Търси показва принтерите и портовете, които касата вижда. Изберете един и адресът се попълва.
• Протокол: ESC/POS (почти всички принтери за бележки, включително принтери Star в режим ESC/POS) или Star (Star Line Mode). При Star касата сама преобразува бележката; бележката изглежда по същия начин.
• Сервитьорско устройство със собствен принтер: Android сервитьорско устройство с приложението HorecaPOS (напр. ръчен терминал с мобилен Bluetooth принтер или Sunmi като сервитьорско устройство) може само да печата. Регистрирайте го на самото устройство (Настройки → Принтери → Сервитьорски устройства със собствен принтер) и при принтера изберете Свързан към. Сервитьорското устройство взима своите бележки от касата; оставете приложението отворено на него. Ако не се получи (приложението е затворено, извън обхвата на wifi), кухненският бон отива в опашката за печат, както при изключен мрежов принтер. Отписване на устройството връща принтерите обратно към самата каса.
• Принтер по група / продукт: за всяка група артикули изберете на кой принтер отива кухненският бон. За отделен продукт можете да промените това със собствен принтер или "без кухненски бон".

Еднаквите продукти се обединяват при печат: два пъти 1x Cola става 2x Cola, на кухненския бон и на касовия бон. Обединяват се само продукти с еднакви опции и бележка.

Инсталаторът за Linux добавя потребителя на касата в групите lp и dialout, за да може касата да използва USB и серийни принтери.

Нужда от помощ?

Optimum POS · 085 560 00 60 · support@optimumpos.nl · пон–пет 9:00–20:00, съб–нед 14:00–20:00