HelomiWIKI

Checkbox (фіскальні чеки)

Інтеграція з Checkbox фіскалізує продажі з угод: менеджер у картці угоди натискає «+ Створити чек», і програмний РРО Checkbox видає фіскальний чек з товарами угоди, способом оплати та email покупця. Підтримується кілька організацій (профілів) і касирів, доступи на створення чеків, повернення, перегляд і друк чеків; усі чеки зібрані у ФінансиФіскальні чеки«Фінанси → Фіскальні чеки».

9 хвОновлено 16.10.2026
Markdown для ШІ
На цій сторінці

Можливості

  • До 10 профілів (організацій ФОП/ТОВ), у кожному до 20 касирів: вхід ПІН-кодом із ключем ліцензії каси або логіном і паролем.
  • «Авторизація» касира: ПІБ підтягується з Checkbox.
  • «Доступи»: хто може створювати чеки цього профілю; дивитися й друкувати можуть усі з доступом до угод.
  • «Пов'язані поля»: назва товару для чека, поле угоди зі способом оплати і мапа спосіб оплатиГотівка / Картка / Своя назва для Безготівки«спосіб оплати → Готівка / Картка / Своя назва для Безготівки», коментар до чека.
  • Чек з угоди: вибір позицій, тип оплати, email, коментар; якщо зміну не відкрито — CRM відкриває її сама (типово) і створює чек.
  • Позиція, пробита в чеку, позначається галочкою і не редагується, доки не зроблено повернення.
  • Переглянути, PDF, PNG, надіслати на email, оновити стан, повернення.
  • Список усіх чеків з пошуком і підсумками.

1Налаштування

Налаштовує адміністратор. Дорога: «Налаштування» → «Інтеграції» → вкладка «Оплати» → картка «Checkbox».

Вкладка «Підключення». Перемикач «Інтеграція» має бути ввімкнений — інакше чеки не створюються. Ключів у цій вкладці нема: дані касирів вводяться у вкладці «Налаштування». «Перевірити» входить першим увімкненим касиром і читає стан зміни (нічого не пише в касу). «Стан роботи» показує профілі з кількістю касирів, «Касир авторизований» і «Чеків створено».

Вкладка «Налаштування».

  1. «+ Додати профіль» → «Назва» (ні на що не впливає, лише для вас; напр. назва ФОП). Профілі показуються вкладками.
  2. Блок «Касири» → «+ Додати касира» → шторка «Checkbox касир»:
    • «ПІН-код»: «ПІН-код » (Checkbox → Касири → колонка «ПІН-код») і «Ключ ліцензії » (Checkbox → Каси → колонка «Ключ ліцензії»);
    • або «Логін/Пароль»: «Логін », «Пароль » і «Ключ ліцензії (щоб відкривати зміну з CRM)».

«Зберегти», потім «Авторизація» — ПІБ касира підтягнеться з Checkbox («Стан», «ПІБ»). «змінити…» — нові дані входу; «Видалити касира». Значення зберігаються зашифрованими й більше не показуються.

  1. Блок «Доступи»: таблиця «Користувач» / «Створити» — позначте, хто може створювати чеки цього профілю. Адміністратор може завжди.
  2. Блок «Пов'язані поля»:
    • «Надсилання»: «Відправка Email», «Відправка ставки ПДВ», «Відправка УКТЗЕД коду» (розділи 3–4);
    • «Коментар до чеку»: «Без коментарів до чеку», «Відправляти коментар з користувацького поля» (вибрати поле угоди або «Коментар до угоди»), «Відправляти зазначений коментар» (текст);
    • «Назва товару»: «Назва товару (стандартне поле)» або інше текстове поле товару — назва має збігатися з назвою товару в Checkbox;
    • «Спосіб оплати»: поле-список угоди, з якого береться тип оплати (типово «Тип оплати checkbox»);
    • таблиця «Способи оплати» → «Тип оплати»: значення поля угоди → «Готівка», «Картка» або «Своя назва для Безготівки» з полем «Вкажіть назву способу оплати» (напр. «Rozetkapay», «NovaPay»). «Додати спосіб оплати»; без мапи чек не знатиме, готівка це чи картка.
  3. «Зберегти» / «Скасувати зміни» в панелі внизу. «Видалити профіль» — чеки, створені раніше, лишаються у ФінансиФіскальні чеки«Фінанси → Фіскальні чеки».

Кілька організацій — кілька профілів, кожен зі своїми касирами, доступами й способами оплати. Каса офлайн-магазину (розділ «Каса») бере касира окремо, з налаштувань сервера.

2Генерація чеків (ручний та автоматичний режим)

Вручну.

  1. Картка угоди → блок «Документи» → «Фіскальні чеки Checkbox» → «+ Створити чек».
  2. Шторка «Створити фіскальний чек»: «Організація» (профіль), «Касир», «Позиції (N з M)» — галочками, лише ті, що ще не в чеку, «Тип оплати (з поля угоди; змінити можна тут)», «Email для чека (через кому; порожньо — не надсилати)», «Коментар до чеку (порожньо — за налаштуваннями профілю)». Унизу — «До фіскалізації: <сума>».
  3. «Створити чек». Якщо зміну не відкрито, CRM відкриє її сама (у профілі ввімкнено «Відкривати зміну автоматично, коли створюється чек»). Якщо це вимкнено — з'явиться «Зміну в Checkbox не відкрито. Відкрити зміну і створити чек?» — підтвердіть.
  4. Чек з'являється в списку блоку: фіскальний №, «продаж» і тип оплати, стан, сума, дата, касир. Позиції чека позначаються галочкою і більше не редагуються; в списку угод угода отримує позначку «чек».

Знижка чи націнка угоди потрапляє в чек, коли пробиваються всі позиції. Номер замовлення в чеку — назва угоди.

Автоматично (за етапом угоди чи статусом ТТН) — поки не зроблено, чек створює людина.

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: help("int-checkbox")