> Усі статті WIKI Helomi: /wiki/llms.txt

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

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

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

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

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

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

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

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

## 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 → Доступи)» | Вас не позначено в «Доступах» | Попросіть адміністратора |
| «Касир: не задано ключ ліцензії каси» | Для входу ПІН-кодом бракує ключа ліцензії | Введіть «Ключ ліцензії» |
| «Відкрити зміну можна лише касиру з ключем ліцензії каси» | Касир з логіном без ключа ліцензії | Додайте касиру ключ ліцензії |
| «HTTP 422: Помилка валідації: <поле> — <причина>» | Checkbox не прийняв поле чека (наприклад, email клієнта не схожий на адресу) | Текст називає поле; виправте дані в угоді чи клієнті й повторіть. Номер угоди в чеку йде рядком «Замовлення …» у підвалі (окремого поля в Checkbox нема) |
| «Не вдалося розшифрувати дані касира — введіть ПІН-код і ключ ліцензії ще раз» | Змінився ключ шифрування на сервері | Введіть дані касира заново |
| «Усі позиції угоди вже в чеку (або позицій нема)» | Нема що фіскалізувати | Додайте позицію або зробіть повернення |
| «Сума чека 0» | Позиції без ціни | Вкажіть ціни позицій |
| «По цьому чеку повернення вже зроблено» | Повторне повернення | Нічого не треба |
| «Позиція «…» уже у фіскальному чеку — спершу зробіть повернення чека» | Спроба змінити пробиту позицію | Зробіть повернення чека |

## Для ШІ-співробітників
5`). ШІ бачить в угоді (`deals_get`) поле «Тип оплати checkbox» (`tip_oplaty_checkbox`) і може заповнити його значенням з мапи способів оплати, щоб людина створила правильний чек. Позиції з чеком змінювати не можна — помилка це підкаже. Статтю ШІ читає інструментом `help("int-checkbox")`.

## Додаткова інформація
- Пов'язані статті: [Угоди](deals.md), [Фінанси](finance.md), [Каса](cashbox.md), [Документи](documents.md).