Checkbox (fiscal receipts)
The Checkbox integration fiscalizes sales from deals: a manager clicks “+ Create receipt” on the deal card, and the Checkbox software cash register (PRRO) issues a fiscal receipt with the deal's products, the payment method, and the buyer's email. Multiple organizations (profiles) and cashiers are supported, along with access rights for creating receipts, refunds, and viewing and printing receipts; all receipts are collected in “Finance → Fiscal receipts”.
This article is in Ukrainian for now. Ask Lomi in your language — she will read the article and answer. Talk to Lomi
On this page
Можливості
- До 10 профілів (організацій ФОП/ТОВ), у кожному до 20 касирів: вхід ПІН-кодом із ключем ліцензії каси або логіном і паролем.
- «Авторизація» касира: ПІБ підтягується з Checkbox.
- «Доступи»: хто може створювати чеки цього профілю; дивитися й друкувати можуть усі з доступом до угод.
- «Пов'язані поля»: назва товару для чека, поле угоди зі способом оплати і мапа спосіб оплати›Готівка / Картка / Своя назва для Безготівки«спосіб оплати → Готівка / Картка / Своя назва для Безготівки», коментар до чека.
- Чек з угоди: вибір позицій, тип оплати, email, коментар; якщо зміну не відкрито — CRM відкриває її сама (типово) і створює чек.
- Позиція, пробита в чеку, позначається галочкою і не редагується, доки не зроблено повернення.
- Переглянути, PDF, PNG, надіслати на email, оновити стан, повернення.
- Список усіх чеків з пошуком і підсумками.
1Налаштування
Налаштовує адміністратор. Дорога: «Налаштування» → «Інтеграції» → вкладка «Оплати» → картка «Checkbox».
Вкладка «Підключення». Перемикач «Інтеграція» має бути ввімкнений — інакше чеки не створюються. Ключів у цій вкладці нема: дані касирів вводяться у вкладці «Налаштування». «Перевірити» входить першим увімкненим касиром і читає стан зміни (нічого не пише в касу). «Стан роботи» показує профілі з кількістю касирів, «Касир авторизований» і «Чеків створено».
Вкладка «Налаштування».
- «+ Додати профіль» → «Назва» (ні на що не впливає, лише для вас; напр. назва ФОП). Профілі показуються вкладками.
- Блок «Касири» → «+ Додати касира» → шторка «Checkbox касир»:
- «ПІН-код»: «ПІН-код » (Checkbox → Касири → колонка «ПІН-код») і «Ключ ліцензії » (Checkbox → Каси → колонка «Ключ ліцензії»);
- або «Логін/Пароль»: «Логін », «Пароль » і «Ключ ліцензії (щоб відкривати зміну з CRM)».
«Зберегти», потім «Авторизація» — ПІБ касира підтягнеться з Checkbox («Стан», «ПІБ»). «змінити…» — нові дані входу; «Видалити касира». Значення зберігаються зашифрованими й більше не показуються.
- Блок «Доступи»: таблиця «Користувач» / «Створити» — позначте, хто може створювати чеки цього профілю. Адміністратор може завжди.
- Блок «Пов'язані поля»:
- «Надсилання»: «Відправка Email», «Відправка ставки ПДВ», «Відправка УКТЗЕД коду» (розділи 3–4);
- «Коментар до чеку»: «Без коментарів до чеку», «Відправляти коментар з користувацького поля» (вибрати поле угоди або «Коментар до угоди»), «Відправляти зазначений коментар» (текст);
- «Назва товару»: «Назва товару (стандартне поле)» або інше текстове поле товару — назва має збігатися з назвою товару в Checkbox;
- «Спосіб оплати»: поле-список угоди, з якого береться тип оплати (типово «Тип оплати checkbox»);
- таблиця «Способи оплати» → «Тип оплати»: значення поля угоди → «Готівка», «Картка» або «Своя назва для Безготівки» з полем «Вкажіть назву способу оплати» (напр. «Rozetkapay», «NovaPay»). «Додати спосіб оплати»; без мапи чек не знатиме, готівка це чи картка.
- «Зберегти» / «Скасувати зміни» в панелі внизу. «Видалити профіль» — чеки, створені раніше, лишаються у Фінанси›Фіскальні чеки«Фінанси → Фіскальні чеки».
Кілька організацій — кілька профілів, кожен зі своїми касирами, доступами й способами оплати. Каса офлайн-магазину (розділ «Каса») бере касира окремо, з налаштувань сервера.
2Генерація чеків (ручний та автоматичний режим)
Вручну.
- Картка угоди → блок «Документи» → «Фіскальні чеки Checkbox» → «+ Створити чек».
- Шторка «Створити фіскальний чек»: «Організація» (профіль), «Касир», «Позиції (N з M)» — галочками, лише ті, що ще не в чеку, «Тип оплати (з поля угоди; змінити можна тут)», «Email для чека (через кому; порожньо — не надсилати)», «Коментар до чеку (порожньо — за налаштуваннями профілю)». Унизу — «До фіскалізації: <сума>».
- «Створити чек». Якщо зміну не відкрито, CRM відкриє її сама (у профілі ввімкнено «Відкривати зміну автоматично, коли створюється чек»). Якщо це вимкнено — з'явиться «Зміну в Checkbox не відкрито. Відкрити зміну і створити чек?» — підтвердіть.
- Чек з'являється в списку блоку: фіскальний №, «продаж» і тип оплати, стан, сума, дата, касир. Позиції чека позначаються галочкою і більше не редагуються; в списку угод угода отримує позначку «чек».
Знижка чи націнка угоди потрапляє в чек, коли пробиваються всі позиції. Номер замовлення в чеку — назва угоди.
Автоматично (за етапом угоди чи статусом ТТН) — поки не зроблено, чек створює людина.
3Відправка чеку на email і по SMS
- «Пов'язані поля» → «Відправка Email»: Checkbox сам надсилає чек на перший email клієнта з картки.
- Вручну: «⋮» біля чека → «Надіслати на email».
- По SMS — поки не зроблено: змінної з адресою чека в шаблонах SMS ще нема.
4Налаштування ПДВ і УКТЗЕД
- «Відправка ставки ПДВ» → поле з кодом або літерою ставки з Checkbox (кабінет Checkbox → Податкові ставки). У кожен товар чека піде ця ставка; ставки мають збігатися.
- «Відправка УКТЗЕД коду» → поле товару складу з кодом УКТ ЗЕД; код передається в чек.
5Повернення, перегляд, друк
«⋮» біля чека в угоді: «Переглянути» (чек у вікні), «Завантажити PDF», «Завантажити PNG», «Надіслати на email», «Оновити стан» (доки чек фіскалізується), «Повернення» — лише для проведеного чека продажу, один раз. Якщо зміну не відкрито — CRM відкриє її сама (або спитає, якщо автоматичне відкриття вимкнено) і зробить повернення. Після повернення позиції знову можна змінювати.
Зміна відкривається з CRM автоматично при першому чеку; закривається в кабінеті Checkbox.
6Розділ з чеками
«Фінанси» → вкладка «Фіскальні чеки»: пошук (фіскальний №, угода, касир), період, «Усі організації», «Продаж і повернення», «Усі стани» (Проведено, Фіскалізується, Помилка); підсумки «Чеків», «Продажі», «Повернення», «Разом»; таблиця з датою, фіскальним №, типом, сумою, оплатою, угодою й організацією.
Що змінилося 14.10 (C14B–C14D)
- Підключення каси у три кроки на одній сторінці: 1) ключ ліцензії справжньої каси; 2) ПІН-код касира або логін і пароль касира з кабінету Checkbox (email кабінету не підходить); 3) «Підключити касу» — ПІБ підтягується, касир створюється, інтеграція вмикається сама.
- Каса на кожну юрособу: у профілі поле «Юрособа»; угода пробивається касою своєї юрособи, у блоці «Документи» видно «Чек пробиває: …».
- Чек у «Документах» угоди: +›Фіскальний чек: касир«+ → Фіскальний чек: касир» створює одразу; рядок чека зі знаком «C»; «⋮» — PDF, URL, друк TXT/PNG, повернути, email. По угоді не більше одного чинного чека.
- Назва в чеку — поле «Назва Checkbox (латиницею)» позиції прайс-листа; у списку угод знак «C» і фільтр «Чек».
- Автоматичний чек — дія тригера «Фіскальний чек Checkbox» (пресет «при “Отримано”»), вмикається з налаштувань Checkbox.
Докладно — стаття «Фіскальні чеки Checkbox» (checkbox).
Можливі помилки
| Що ви бачите | Чому | Що зробити |
|---|---|---|
| «Інтеграцію Checkbox вимкнено — увімкніть її в Інтеграції›Checkbox«Інтеграції → Checkbox»» | Перемикач вимкнено | «Підключення» → «Інтеграція» |
| «Профіль Checkbox не налаштовано — додайте його в Інтеграції›Checkbox«Інтеграції → Checkbox»» | Немає профілю | «+ Додати профіль» |
| «Нема увімкненого касира з ПІН-кодом / паролем» | Касир не доданий або без даних входу | Додайте касира й «Авторизація» |
| «У профілі нема увімкненого касира — додайте в Інтеграції›Checkbox«Інтеграції → Checkbox»» | У шторці чека немає касира | Додайте касира в профіль |
| У вас нема доступу створювати чеки цього профілю (Налаштування Checkbox›Доступи)«У вас нема доступу створювати чеки цього профілю (Налаштування Checkbox → Доступи)» | Вас не позначено в «Доступах» | Попросіть адміністратора |
| «Касир: не задано ключ ліцензії каси» | Для входу ПІН-кодом бракує ключа ліцензії | Введіть «Ключ ліцензії» |
| «Відкрити зміну можна лише касиру з ключем ліцензії каси» | Касир з логіном без ключа ліцензії | Додайте касиру ключ ліцензії |
| «HTTP 422: Помилка валідації: <поле> — <причина>» | Checkbox не прийняв поле чека (наприклад, email клієнта не схожий на адресу) | Текст називає поле; виправте дані в угоді чи клієнті й повторіть. Номер угоди в чеку йде рядком «Замовлення …» у підвалі (окремого поля в Checkbox нема) |
| «Не вдалося розшифрувати дані касира — введіть ПІН-код і ключ ліцензії ще раз» | Змінився ключ шифрування на сервері | Введіть дані касира заново |
| «Усі позиції угоди вже в чеку (або позицій нема)» | Нема що фіскалізувати | Додайте позицію або зробіть повернення |
| «Сума чека 0» | Позиції без ціни | Вкажіть ціни позицій |
| «По цьому чеку повернення вже зроблено» | Повторне повернення | Нічого не треба |
| «Позиція «…» уже у фіскальному чеку — спершу зробіть повернення чека» | Спроба змінити пробиту позицію | Зробіть повернення чека |
Для ШІ-співробітників
5). ШІ бачить в угоді (deals_get) поле «Тип оплати checkbox» (tip_oplaty_checkbox) і може заповнити його значенням з мапи способів оплати, щоб людина створила правильний чек. Позиції з чеком змінювати не можна — помилка це підкаже. Статтю ШІ читає інструментом help("int-checkbox")`.
Додаткова інформація
Helomi AI employees read this same article: help("int-checkbox")