Комуникация с касовия апарат

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

Подобна проверка се осъществява и при стартиране на диалога Операции (… < Касови операции < Главно меню) и също се извежда предупредително съобщение.

За да бъде записан новосъздаден документ в СУПТО  е задължително за него да се генерира успешно УНП и да се отпечата касов бон, когато плащането е в брой или с банкова карта. Това става с един от двата бутона, според конкретната операция,  [Печат на касов бон и създаване на документ] или [Запис]. Те имат идентично действие – изпраща се команда/заявка към касовия апарат и според получената обратно информация за изпълнението на тази командата, документът се записва или не се записва в базата данни на Приложението.

В зависимост от резултата, всяка касова операция получава статус и той е достъпен за преглед и редакция (от администратор и то само при определени условия) от Главно меню > Касови операции > История.

SUCCESS (успешен) е най-желаният, а би трябвало да е и най-често срещан, при нормални условия на работа, статус. Той показва, че изпълнението на командата/заявката, изпратена от Приложението към касовия апарат с бутон [Печат на касов бон и създаване на документ] или [Запис], е успешно – касовият бон е разпечатан  и отговорът от касовия апарат е получен.

Изпращането на касовия бон в НАП е грижа на касовия апарат, Приложението не разполага с данни за изхода на тази операция и тя е извън контрола на Екип ПАСОСС.

Възможно е, макар и в редки случаи, новосъздаденият документ да не бъде записан в базата данни на Приложението, въпреки статуса success на касовата операция,  например, при смущения в интернет връзката между компютъра на потребителя и Приложението. Последицата от тази грешка е, че в базата данни остава касов бон без документ. За отстраняването ѝ сме предоставили лесен и удобен инструмент, който е достъпен от Главно меню > Касови операции > Операции > Сторниране на касов бон без документ, където се въведжат (избират се от списък) УНП и параметрите на касовия бон. Препоръчваме това да се направи незабавно, а документът, на този етап за съжаление, трябва да бъде въведен отново, при което ще се генерира нов УНП и касов бон.

FAILURE (неуспешен) е статус, който свидетелства за сериозна неизправност в системата, включително нерботещи нейни части или компоненти. При получаване на този статус от касовия апарат, в Приложението е разработен алгоритъм за извеждане на предупредително съобщение с възможно най-точно описание на проблема, което да позволи неговото своевременно и правилно разрешаване. Системата остава в готовност за нормална работа и след отстраняване на проблема очаква отново изпълнението на [Печат на касов бон и създаване на документ] или [Запис].

Причини за статус FAILURE могат да бъдат, например:

• няма активен касов апарат (няма включен; липсва захранване и/или интернет връзка);
• не е зададен КОД на потребителя;
• не разпознава командата;
• касовият апарат е останал без хартия;
• опит за сторно при недостатъчна касова наличност.

UNKNOWN (неизвестен) е най-неприятният за обработка статус, защото хем е свързан с налична (реална) неизправност в системата, хем липсват всякакви пордобности около причините за възникването ѝ. С времето и опита от работата на Приложението с различни потребители и при различни конкретни условия, възможностите на Екип ПАСОСС за контрол и обработка на подобни грешки ще се увеличава.

Статус UNKNOWN възниква рядко и внезапно в процеса на работа, при стечение на специфични обстоятелства, за милисекунди като време (ако времето не е толкова краткото, по-вероятно е статусът да бъде FAILURE, отколкото UNKNOWN).

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

1. Записът на създавания документ е неуспешен. Възможните изходи от него, както и за всеки нов документ, са само два: Запис (в случая блокиран от статус UNKNOWN), или Отказ (загуба на въведените данни). По-удобно е този документ да не бъде отказан, а да остане отворен на екрана, до изясняване на ситуацията. Повторният опит за запис е неизбежен, а така  данните ще бъдат запазени и няма да се въвеждат отново.
2. Приложението не позволява работа с касовия апарат, т.е. не е възможно да бъде изпратена повторно заявка за отпечатване на касов бон, а без него, според изискванията на Наредба 18 за работа в реално време, актуалният документ не може да бъде записан (а затова не може да се премине и към създаване на нов документ).
3. Потребителят трябва да провери физически (на касовия апарат) резултатът от изпълнението на операцията, от което да стане категорично ясно издаден ли е касов бон или не.
4. Потребител с администраторски права влиза (най-добре от друг компютър) в Главно меню > Касови операции  > История > Промяна на статуса за конкретната касова операция и ръчно променя нейния статус от UNKNOWN на SUCCESS (успешен) или FAILURE (неуспешен), според реалния резултат от проверката. Това възстановява нормалната работата на Приложението.
5. Независимо дали статуст е SUCCESS или  FAILURE, за документа трябва да се изпълни отново [Печат на касов бон и създаване на документ] или [Запис]. Така ще бъде отпечатан нов касов бон, касовата операция  получава статус SUCCESS и докуметът се записва в базата данни.
6. Когато статусът по т.4 е SUCCESS (успешен) касовият бон е отпечатан. Съгласно изискванията на Наредба 18 за работа на СУПТО в реално време. той не може да изчака и да се свърже с друг документ, затова трябва да се сторнира, като касов бон без документ: Главно меню > Касови операции > Операции > Сторниране на касов бон без документ.
7. В случай, че се окаже невъзможно документът да остане отворен на екрана и се наложи да бъде затворен с Отказ (виж т.1), за да извърши администраторът необходимите действия по т.4, например, след възстановяване на нормалната работа той трябва да бъде въведен отново, за да бъде записан.