Модуль Checkbox ПРРО для OkayCMS

Модуль інтегрує програмну касу Checkbox з OkayCMS: дозволяє створювати фіскальні чеки та чеки повернення, керувати змінами касира, налаштовувати податкові групи й автоматично фіскалізувати замовлення при зміні статусу або після отримання посилки Новою Поштою.

Можливості

Фіскальні чеки

• Створення чека продажу для замовлення.
• Створення чека повернення.
• Перегляд усіх чеків замовлення прямо в адмінці.
• Посилання на чек для покупця на сторінці замовлення.

Зміни касира

• Відкриття та закриття зміни касира.
• Перегляд журналу змін із статусами та датами.
• Автоматична перевірка та закриття застарілих змін.

Податкові групи

• Довільні податкові групи (код + назва) для передачі до Checkbox.
• Призначення податкової групи кожному товару окремо.

Автоматизація

• Автоматичне створення чека при зміні статусу замовлення на вказаний в налаштуваннях.
• Автоматичне створення чека при отриманні посилки Новою Поштою (потребує модуля NovaPoshtaTracking).
• Cron-завдання запускаються через вбудований планувальник OkayCMS.

Налаштування способів оплати

• Для кожного способу оплати задається тип Checkbox (CASH, CARD, CASHLESS, OTHER).
• Можна повністю відключити фіскалізацію для обраного способу оплати.

Вимоги

• OkayCMS v4.5.2
• Обліковий запис касира на my.checkbox.ua (логін, пароль, ліцензійний ключ каси)
• Модуль NovaPoshtaTracking (опціонально — для автоматичної фіскалізації при отриманні Новою Поштою)

Встановлення

Варіант 1: Скачування з GitHub

1. Скачайте останню версію модуля з останнього релізу на GitHub.
2. Розпакуйте архів на сервері в каталог: {OkayCMS_root}/Okay/Modules/

Варіант 2: Встановлення через Git

1. Виконайте команду в директорії {OkayCMS_root}/Okay/Modules/Sviat:

   git clone https://github.com/devSviat/Checkbox-OkayCMS.git Checkbox

Результат встановлення

Шлях до модуля має бути таким:

{OkayCMS_root}/Okay/Modules/Sviat/Checkbox/

Після встановлення перейдіть в адмін-панель → Модулі → Знайдіть «Checkbox» → Натисніть «Встановити».

Налаштування і використання

Підключення до Checkbox

1. Перейдіть в адмін-панель → Checkbox ПРРО → Налаштування.
2. Заповніть облікові дані касира:
   • Логін — логін касира з my.checkbox.ua.
   • Пароль — пароль касира.
   • Ліцензійний ключ каси — знаходиться в розділі «Каси» → «Дії» → «Деталі» в особистому кабінеті Checkbox.
3. Збережіть налаштування.

Фіскалізація чеків

• Відкрийте потрібне замовлення в адмінці.
• Натисніть «Фіскалізувати чек» для створення чека продажу.
• Натисніть «Створити чек повернення» за потреби.

Автоматичне створення чеків при зміні статусу

1. В розділі Налаштування вкажіть статус замовлення, при зміні на який чек створюється автоматично.

Автоматична фіскалізація при отриманні Новою Поштою

1. Встановіть та увімкніть модуль NovaPoshtaTracking.
2. В розділі Налаштування увімкніть опцію «Створювати чек при отриманні Новою Поштою».
3. Переконайтесь, що на сервері налаштовано cron-завдання (щохвилини):

   * * * * * php {OkayCMS_root}/ok scheduler:run
   

   Чеки будуть створюватися кожні 10 хвилин після оновлення статусу ТТН.

Податкові групи

1. Перейдіть в Checkbox ПРРО → Податкові ставки.
2. Додайте групи з відповідними кодами (відповідно до налаштувань каси в Checkbox).

Ліцензія

Модуль розповсюджується за вільною ліцензією MIT