¶ Вступ
☝️Ця інструкція покликана надати покрокові інструкції із запуску та налаштування каси на віддаленому сервері та пояснити нюанси різних схем підключення та методів їх адміністрування.
Що мінімально необхідно для налаштування такого типу підключення:
- комп'ютер/комп'ютери із встановленою фронт-системою для роботи касира/касирів;
- віддалений сервер із наступними операційними системами:
- Windows;
- Server 2008, 2012, 2016, 2019;
- Linux - усі основні популярні дистрибутиви:
- Ubuntu (2016 і новіші);
- Mint (18 та новіші);
- Debian (7 та новіші);
- ArchLinux (оновлення 2016 та новіші).
- Ubuntu 22.10, Mint 21 із архітектурою i686 та x86_64.
- ключ ліцензії каси та пін код касира з особистого кабінету Checkbox;
- наявність робочого інтернет-підключення.
Перед прочитанням статті, будь ласка, ознайомтесь з наступними термінами.
Checkbox Kasa/Каса — електрона каса, яка дозволяє проводити всі касові операції. Після запуску checkbox_kasa.exe працює в фоновому режимі в консолі. Надсилає дані до ДПС через сервер Checkbox.
Фронт-система — програма, якою користується касир для здійснення продажів на касі. Вона може встановлюватись на ПК касира або на віддаленому сервері, до якого касир під'єднується зі свого ПК.
Віддалений сервер — це окремий ПК, який налаштований для підключення з інших комп'ютерів для отримання, відправлення та зберігання інформації та адміністрування певних процесів та програм.
Checkbox Kasa Manager (менеджер каси) — це простий та дружній до користувача графічний інтерфейс менеджера каси для налаштування та управління однією або декількома касами.
Checkbox Kasa Manager не є окремою програмою, а лише дає можливіть користувачу виконувати керування касою без використання консолі або API. Він є рекомендованим для запуску каси з нуля або налаштування, але не є обов'язковим для керування касою/касами.
Незалежно від типу пристрою на якому запускається Checkbox Kasa Manager, він може бути запущений лише один раз. Це допомагає запобігати дублюванню кас.
Керування Checkbox Kasa може виконуватись також за допомогою:
- напряму із консольної утиліти
checkbox_kasa.exe; - консольної утиліти
checkbox_kasa_launcher.exe; - standalone версії Checkbox Kasa Manager (за запитом до технічної підтримки);
- метода API.
Зауважте, що для використання цих методів керуваня вам, вірогідно, знадобиться адміністратор або додаткове навчання працівників.
¶ Як каса обмінюється інформацією з фронт-системою
¶ Через драйвер Сheckbox
Драйвер CheckBoxFiscalDriver.dll допомагає касі та фронт-системі обмінюватись інформацією для повноцінної роботи.
Якщо налаштування/розгортання каси з нуля відбувається через Checkbox Kasa Manager, запущений від імені адміністатора, драйвер реєструється автоматично.
Щоб встановити драйвер вручну:
- Відкрийте інтерфейс та натисніть "Перелік кас".
- Оберіть необхідну касу подвійним натисканням.
- Натисніть "Протокол "Марія 304"".
- Натисніть "Встановити OLE".
По встановленню інтерфейсу, драйвер розташовується в директорії .../checkbox/kasa_test/{your_kasa_name}/profiles/1/com-server.
Якщо ви не використовуєте Checkbox Kasa Manager:
- Запустіть командний рядок від імені адміністратора.
- Введіть наступну команду: 'C:\Windows\Microsoft.NET\Framework\v4.0.30319\RegAsm.exe /tlb /codebase C:\checkbox.kasa.manager\profiles\1\com-server\CheckBox.FiscalDriver.dll'. Зверніть увагу, що
C\checkbox.kasa.manager\profiles\1...— це директорія каси, за яким розміщується драйвер. Змініть цей текст в команді вручну, якщо шлях вашої каси відрізняється. - Натисніть Enter.
¶ Методами локального API
Відкриття локального API — універсальний спосіб переконатись, що ваша каса налаштована правильно.
Щоб відкрити локальне API:
- Відкрийте ваш браузер.
Локальний API не працює із браузером Internet Explorer.
-
В адресний рядок введіть:
- якщо каса розташована на цьому ж комп'ютері: 127.0.0.1:9200. Де 127.0.0.1 — локальна IP-адреса вашого комп'ютера, а 9200 — порт каси.
- якщо каса розташована на іншому комп'ютері: XXX.X.X.X:9200. Де XXX.X.X.X — "біла" IP-адреса зовнішнього серверу (комп'ютера із касою), а 9200 — порт каси.
Оскільки у кожної каси свій порт, перевірте порт своєї каси заздалегідь.
-
Пройдіть за адресою.Використовуйте команди API аналогічно інтерфейсу Checkbox Kasa Manager.
¶ Як налаштувати касу на віддаленому сервері
Існує два варіанти налаштування каси на віддаленому сервері:
- Фронт-система на ПК касира — каса на віддаленому сервері.
- Фронт-система та каса на віддаленому сервері. Використання RDP.
¶ Налаштування каси
Незалежно від обраного варіанту налаштування, для каси мають зберігатись наступні умови.
-
Кожна каса має бути встановлена в своїй директорії. Наприклад:
- Каса 1:
.../checkbox/kasa_test/{your_kasa_name}/profiles/1. - Каса 2:
.../checkbox/kasa_test/{your_kasa_name}/profiles/2і тд.
- Каса 1:
-
Кожна каса повинна мати власний порт локального API.
При створенні нової каси через інтерфейс Checkbox Kasa Manager поле веб-порт буде заповнюватись автоматично, а саме: 9200 для першої каси, 9201 для другої каси тощо. Бажано не змінювати значення цього поля.
Щоб перевірити номер порту в інтерфейсі Checkbox Kasa Manager:
- Відкрийте інтерфейс та натисніть "Перелік кас".
- Оберіть необхідну касу подвійним натисканням.
- Натисніть "Загальне".
- В розділі "Налаштування веб-сервера каси" перевірте номер порта в полі "Порт".
-
За умови підключення через драйвери, має бути вказаний додатковий порт для каси.
Щоб вказати додатковий номер порту в інтерфейсі Checkbox Kasa Manager:
- Відкрийте інтерфейс та натисніть "Перелік кас".
- Оберіть необхідну касу подвійним натисканням.
- Натисніть "Протокол "Марія 304"".
- У випадному списку "Тип протоколу емуляції" оберіть TCP.
- В полі порт за замовчуванням має бути вказане значення 13000. Замініть значення на 13001, якщо це друга каса, на 13002, якщо це третя каса, тощо.
- Натисніть "Зареєструвати порт".
- Натисніть "Зберегти".
-
За умови підключення через COM-порт, кожна каса повинна мати власний COM-порт.
Щоб вказати необхідний COM-порт для каси:
- Відкрийте "Диспетчер задач" та перевірте номер COM-порту, до якого під'єднана каса фізично.
- Відкрийте інтерфейс та натисніть "Перелік кас".
- Оберіть необхідну касу подвійним натисканням.
- Натисніть "Протокол "Марія 304"".
- У випадному списку "Тип протоколу емуляції" оберіть RS232.
- У випадному списку "Порт" оберіть номер порту. Не змінюйте значення поля "Baudrate". У встановленій програмі можна побачити, які порти потрібно прописати в налаштуваннях. Наприклад: якщо каса працює на COM3, то на фронт системі треба підключатись до реєстратора на COM4.
- Натисніть "Зберегти".
Очевидне, але варте нагадування — фронт-система та віддалений сервер повинні мати доступ в інтернет-мережу.
¶ Варіант 1. Фронт-система на ПК касира — каса на віддаленому сервері
При цьому варіанті роботи із касою на сервері працює наступна схема:
Для роботи такої схеми мають бути дотримані наступні умови:
- У налаштуваннях фронт-системи має бути прописана "біла" статична IP-адреса каси.
- Каса повинна мати власний порт.
- Каса має бути запущеною на сервері.
В залежності від обраного вами типу підключення фронт-системи дотримуйтесь наступних інструкцій.
¶ Підключення через локальне API
- Встановіть на віддаленому сервері касу від імені адміністратора.
- При створенні каси упевніться, що:
- Кожна каса має власний номер порту. Як перевірити номер порту каси.
- Вказана "біла" статична IP-адреса в полі "IP-адреса". Якщо IP-адреса не є статичною вкажіть значення 0.0.0.0.
- В налаштуваннях фронт-системи вкажіть IP-адресу та порт каси з попереднього пункту.
- Протестуйте зовнішній доступ до вашої каси, за допомогою локального API — воно має працювати.
- Запустіть касу на віддаленому сервері перед початком роботи касира із фронт-системою.
¶ Підключення через драйвери
-
Встановіть на віддаленому сервері касу від імені адміністратора.
-
При створенні каси упевніться, що:
- Кожна каса має власний номер порту. Як перевірити номер порту каси.
- Вказана "біла" статична IP-адреса в полі IP-адреса. Якщо IP-адреса не є статичною вкажіть значення 0.0.0.0.
-
Вкажіть додатковий порт для каси.
Як це зробити для драйвера.
Як це зробити для підключення через COM-порт.Якщо ви встановили касу не від імені адміністратора, то драйвер не встановився автоматично і не зможе підключити касу.
-
В такий самий спосіб встановіть драйвер на комп'ютер касира, де встановлена фронт-система. Переконайтесь, що драйвер розташований у файловій системі комп'ютера за наступною директорією:
.../checkbox/kasa_test/{your_kasa_name}/profiles/1/com-server. -
В налаштуваннях фронт-системи вкажіть IP-адресу та порт каси з пункту 2 цієї інструкції.
-
Протестуйте зовнішній доступ до вашої каси, за допомогою локального API — воно має працювати.
-
Запустіть касу на віддаленому сервері перед початком роботи касира із фронт-системою.
¶ Варіант 2. Фронт-система та каса на віддаленому сервері. Використання RDP
RDP (англ. Remote Desktop Protocol, протокол віддаленого робочого стола) — спосіб захищеної передачі даних та користування робочим столом іншого комп'ютера. Налаштовується штатними засобами ОС Windows.
При цьому варіанті роботи із касою на сервері працює наступна схема:
Для роботи такої схеми мають бути дотримані наступні умови:
- Каса повинна мати власний порт.
- Кожен касир повинен мати власний вхід/екземпляр у фронт-систему.
- Каса має запускатись на сервері адміністратором.
- Комп'ютер касира та віддаленого сервера повинні мати підключення до інтернет-мережі.
Для налаштування роботи каси через RDP:
- Налаштуйте RDP-доступ з комп'ютера касира на віддалений сервер. Надайте касиру його власний логін та пароль для підключення.
- Встановіть необхідну фронт-систему/системи
- Встановіть касу/каси на віддалений сервер від імені адміністратора.
- При створенні каси упевніться, що:
- Кожна каса має власний номер порту. Як перевірити номер порту каси.
- В полі "IP-адреса" вказане значення 127.0.0.1.
- У фронт-системі касира вкажіть IP-адресу та порт каси у наступному форматі: 127.0.0.1:9200. Де 127.0.0.1 — локальна IP-адреса комп'ютера, а 9200 — порт каси.
- Вкажіть додатковий порт каси, якщо ви працюєте через драйвер або COM-порт.
Для тестування роботи каси спробуйте відкрити API каси.
¶ Керування касами з комп'ютера адміністратора
Серверне налаштування каси дає також можливіть адміністратору не працювати на віддаленому сервері, а виконувати менеджмент кас із власного комп'ютера.
Схема підключення для віддаленого керування виглядає наступним чином:
Щоб налаштувати такий спосіб керування касами:
- Виконайте запуск/налаштування кас на сервері: Варіант 1 або Варіант 2.
- Встановіть інтерфейс Checkbox Kasa Manager від імені адміністратора на комп'ютері адміністратора.
- Відкрийте інтерфейс та оберіть "Перелік кас".
- Натисніть "Додати існуючу".
- З випадного списку "Тип" оберіть Мережева.
- У полі адреса вкажіть IP-адресу віддаленого серверу та порт каси: XXX.X.X.X:9200. Де XXX.X.X.X — "біла" IP-адреса зовнішнього серверу (комп'ютера із касою), а 9200 — порт каси.
- Натисніть ✅.
Для тестування зовнішнього доступу спробуйте відкрити API каси.