Початок роботи

• Виконати реєстрацію у Вчасно.Каса за відеоінструкцією.
  
• Налаштувати торгову точку у Вчасно.Каса за тією ж відеоінструкцією.
• Перейти до кабінету Вчасно.Каси і зайти в налаштування необхідної каси
  
• Необхідно встановити передачу залишку готівки із зміни в зміну, щоб готівка коректно синхронізувалась між Вчасно та ODOO
  
• Також необхідно, за потреби, в загальних налаштуваннях виставлення рахунків обрати фіскальну локалізацію та, змінити інші необхідні налаштування, обрати валюту.

Налаштування конфігурації каси

Пряме API

• Отримати токен в налаштуваннях обраної каси.
  
• Перейти в модуль ПРРО, в меню "Конфігурації ПРРО" і створити конфігурацію, вибравши ПРРО як "Вчасно.Каса", вказати унікальну назву, тип API "Пряме API" та згенерований токен.
  

Через Device Manager

• Завантажити Device Manager і створити ПРРО за інструкцією (натисніть для перегляду).
• Для чекодруку підключити принтер у Device Manager за допомогою кнопки зверху справа і цієї інструкції (натисніть для перегляду).
• Для пакетного режиму необхідно підключити пристрої та налаштувати торгову точку за інструкцією.
• Перейдемо до налаштування у модулі ПРОО. У конфігурації необхідно вказати тип ПРРО "Вчасно.Каса", унікальну назву, тип API "Device Manager", URL (має закінчуватися на /dm/), назву ПРРО (яку вказано в DM).
• Необхідно бути уважним з введенням URL Девайс Менеджера, бо це може призвести до помилок.
• Режими роботи:
  • Фіскалізація: обрати "API фіскалізації".
  • Фіскалізація з чекодруком: обрати "API фіскалізації з друком на принтер", вказати назву принтера (буде використовуватись принтер з назвою "prn", якщо назву не вказано).
  • Пакетний режим: налаштувати в Device Manager, обрати "АРІ для роботи в пакетному режимі".
• Рядок "Ендпоінт для DM" відображається для відладки і показує, куди буде надсилатись інформація відповідно до поточних налаштувань.
  

• За 2 години до блокування користувач почне бачити з певною періодичністю повідомлення про це, а при досягненні цього часу поточного дня, проводити продаж буде неможливо. Якщо це не вказувати, то продаж буде блокуватись через 24 години від відкриття ПРРО (тобто згідно закону) і користувач отримуватиме аналогічні повідомлення щодо блокування операцій по касі.
• Наступним кроком буде створення точки продажу в відповідному меню модуля "Точка продажу". Виберіть зверху зліва відображення списком і натисніть кнопку "Новий".
  
• Вкажіть назву магазину та обов'язково виберіть потрібну конфігурацію ПРРО! Якщо не буде потреби у використанні ПРРО - просто очистіть поле
  
• Користувач з правами адміністратора може перейти до налаштування торгової точки та змінити налаштовану конфігурацію
  Якщо конфігурацію не було вказано, то користувач побачить відповідне попередження. Якщо вказано, то побачить зелене повідомлення з назвою конфігурації

Загальні налаштування торгової точки

• Перейдемо до налаштувань торгової точки. Необхідно зайти в налаштування, обрати зліва в меню "Точка продажу" та обрати ту точку продажу, налаштовування якої треба змінити.
• Тепер необхідно налаштувати заокруглення готівки. Інакше створюються чеки з безготівковим розрахунком, наприклад, на 3 копійки, а це заборонено. Важливо вказати Лише на касовому методі - щоб округлення стосувалось саме що готівки
  
  
• Якщо потрібно буде працювати з загальночековими знижками, то необхідно поставити в налаштуваннях відповідної торгової точки прапорець навпроти "Загальна знижка". Для коректної роботи необхідно лишити налаштування "Товар знижки", який обведено на наступному скріншоті (він встановлений за замовчуванням).
• Тепер необхідно перейти до налаштування методів оплати в меню модуля ПРРО або меню модуля Точки Продажу, як наведено на скріншоті.
• Створити необхідні методи оплати і обов'язково обрати з випадаючого списку яким методом оплати Вчасно.Каси інтерпретувати.
• Далі повертаємось до налаштувань Торгової Точки і обираємо необхідні платіжні методи для вказаної точки продажу.
• Наступне - налаштування товарів. При їхньому створенні/редагування у вкладці "ПРРО" можна вказати коди УКТЗЕД, ДКПП, обов'язково вказати групу ПДВ (якою групою ПДВ інтерпретувати товар для фіскалізації Вчасно.Касою) і окремо налаштувати самі податки товару в ODOO. Також можна вказати акцизну марку (або кілька марок, якщо їх більше однієї).

Все налаштовано - можна працювати!

Використання модуля в Точці продажу. Фронт-система

• Після виконання всіх наведених вище налаштувань і вибору конфігурації для каси можна починати роботу. Перейдіть в модуль "Точка продажу" і натисніть на кнопку "Нова сесія"
• Система спробує відкрити зміну по даній касі, але якщо цього не вийде - виведе помилку і можливу її причину. Якщо ви впевнені, що сесія вже відкрита, то можете перезавантажити сторінку або проігнорувати це повідомлення. Якщо, наприклад, Чекбокс Касу не було увімкнено, то увімкніть її та після цього спробуйте ще раз, натиснувши на кнопку "Так"
• Після успішного відкриття, якщо каса має підключений готівковий метод оплати, відкриється меню з інформацією про поточний стан готівки в касі. В полі для введення буде вказано суму в касі на думку ODOO, а в примітці дані про кількість готівки, отримані від ПРРО. У разі розбіжностей бажано змінити на кількість готівки, яка вказана в примітці
• Тепер можна перейти до фіскальних операцій: продажу та повернення, службових внесення чи видачі готівки. При підключеному ПРРО фіскалізація проходить автоматично при виконанні цих операцій!
• Біля меню оплати відображається час до блокування продажу по касі. У випадку приближення до часу закриття колір зміниться на жовтий, а після блокування - на червоний, що мигтить. У цих випадках буде з'являтись час від часу повідомлення про це, а після блокування фіскальні операції не будуть доступними!
• Якщо під час продажу чи повернення не вийде фіскалізувати чек, то користувач побачить повідомлення з описом помилки і, у деяких випадках, її можливе рішення. Операція продажу чи повернення не буде проходити, доки існує помилка фіскалізації. Також ПРРО не дозволяє створювати чек, де одночасно відбувається повернення і продаж товару - це не підтримують ні Чекбокс, ні Вчасно.
• Для перегляду Х-звіту необхідно натиснути на меню-бургер справа зверху і натиснути на відповідну кнопку. Тут же можна і перейти до Службового внесення/видачі готівки (кнопка "Покласти/забрати готівку").
• Приклад "пустого" Х-звіту:
• При службових діях з готівкою відображається поточна кількість готівки в касовому апараті. Забрати готівки більше наявної не вийде.
• При закритті сесії щодо готівки в касі маємо інформацію таку ж, як і при відкритті: скільки "бачить" ODOO і скільки ПРРО. Також бачимо всі операції щодо готівки і інформацію по оплатам. При натисканні кнопки "Закрити сесію" буде згенеровано "Z-звіт", показано його в аналогічному до X-звіту форматі і збережено всю інформацію. У випадку помилки її буде виведено.
• Для надсилання чека клієнту необхідно вибрати його обліковий запис при оплаті. Якщо в обліковому записі вказано пошту, то на неї буде надіслано чек. На мобільний номер, що вказаний в обліковому записі, то буде надіслано чек на нього у Viber, якщо придбано надсилання повідомлень у кабінеті Вчасно.Каси.

Використання модуля в Точці продажу. Бекенд

• Перейшовши до замовлення, можна побачити нову вкладку "Вчасно.Каса" (доступно лише адміністратору) та кнопку "Переглянути Чек". У вкладці відображається технічна інформація щодо запитів на провайдера ПРРО, а також його відповідь. Кнопка відкриває нову вкладку в браузері з чеком на сайті Вчасно.Каси:
• Перейшовши до інформації про сесію, можна побачити 2 нові вкладки. Вони доступні лише адміністратору і показують технічну інформацію, про запити і відповіді щодо відкриття та закриття сесії Чекбоксу.
• Зверху наявна кнопка "Z-звіт", яка генерує звіт для друку у форматі PDF:

Робота з деякими помилками

• Будь-які "external exception" (наприклад, 1D) від ДМ — має допомогти перезавантаження пристрою
• Не вдалося виконати фіскалізацію: Неможливо розрахувати вартість товару в позиції (номер) — товар має нульову вартість, можливо, ви намагались видалити його зі списку покупок, але не зробили це повністю (в списку покупок він має кількість 0 і вартість 0). Видаліть такий товар зі списку і спробуйте продати ще раз.
• Не вдалося виконати фіскалізацію: Сума по типу оплати 1 рівна або менша 0 — один з рядків оплати має менше або нульове значення. Видаліть цей рядок і повторіть спробу.
• Якщо помилка пов'язане з fetch(), то перевірте посилання на ДМ.