Checkbox каса підключається до Elbuz даними касира й ключем ліцензії каси: після цього фіскальний чек видається прямо з картки замовлення. Касу, касира й підпис ви налаштовуєте в кабінеті my.checkbox.ua, зміну Elbuz відкриває сам.
Що це дає:
- Каси ще немає — кабінет подає форми в податкову сам, безкоштовний ключ DepositSign не потребує файла.
- Хочете спершу спробувати — тестова каса й касир з’являються одразу після реєстрації, податкова не потрібна.
- Каса вже працює — вписуєте її дані, і чеки йдуть з Elbuz через неї.
З чого почати: візьміть дані тестового касира і впишіть їх у форму Checkbox в Elbuz.
Що вміє підключення Checkbox
- Два способи входу касира — логін і пароль або лише PIN-код.
- Налаштування каси — фірма, ПДВ, автоматичний чек, закриття зміни, накладений платіж.
- Тестовий режим — справжній шлях чека без податкової.
- Зрозумілі причини збою — підпис, ставка ПДВ, ключ ліцензії.
Де це і хто має доступ
- Меню
- Кабінет → Налаштування системи → «Інші налаштування» → «Зовнішні сервіси та інтеграції» → група «Фіскальні чеки» → Checkbox
- Право доступу
- вікно «API та токени доступу» у «Правах груп»
- Підготувати
- кабінет my.checkbox.ua; для справжньої каси — ключ КЕП/ЕЦП директора або ФОП
Як зареєструвати касу й касира в Checkbox
Реєстрація проходить у кабінеті Checkbox, форми в податкову він подає сам. Кроки нижче — за довідкою Checkbox станом на 06.11.2026: початок роботи, каси, касири.
- Кабінет. Зареєструйтесь на my.checkbox.ua і додайте дані компанії з податкової: знадобиться ключ директора.
- Торгова точка. Точки, уже зареєстровані в податковій, підтягуються при синхронізації. Нова реєструється формою 20-ОПП із кабінету.
- Каса. Розділ «Каси» → «Додати касу», торгова точка зі списку, тип ПРРО «Інтернет-торгівля». Запит підписується файловим ключем, Дія.Підписом або SmartID. Статус «На реєстрації» змінюється на «Активна» приблизно за 5–10 хвилин.
- Касир і ключ. Розділ «Касири» → «Додати касира», далі «Створити ключ DepositSign» або «Через ключ ЕЦП». Вигадайте логін, пароль і підпишіть запит.
- Checkbox.Підпис. Якщо ключ файловий: у рядку касира три крапки → «Запустити Checkbox.Підпис на захищеному хмарному сервісі», АЦСК, файл, пароль, «Запустити». За 3–5 хвилин біля касира з’явиться статус «Агент підпису працює».
- Ставки. За замовчуванням у кабінеті є лише «Без ПДВ». Платник ПДВ додає свої ставки: міняти їх можна при закритій зміні, зміни діють із наступної.
Касир працює лише з однією касою одночасно. ФОП може реєструвати касира на власний ключ, для ТОВ довідка вимагає окрему печатку на кожну касу.
Які дані потрібні Elbuz і де вони лежать
| Поле в Elbuz | Що вписати | Де взяти |
|---|---|---|
| Логін касира | Логін касира. Лишіть порожнім, якщо входите за PIN | вигадали при додаванні касира, розділ «Касири» |
| Пароль касира або PIN | Пароль касира або, за порожнього логіна, PIN-код | вигадали при додаванні касира; пароль не відновлюється, лише замінюється: «Касири» → «Дії» → «Редагувати» → «Новий пароль» |
| Ключ ліцензії каси | Ключ тієї каси, через яку йдуть чеки | кабінет my.checkbox.ua, розділ «Каси» |
| Ключ інтеграції (необов’язково) | Лишіть порожнім, якщо служба підтримки Checkbox його не видавала | служба підтримки Checkbox |
Логін касира унікальний у всьому Checkbox. Точного розташування ключа ліцензії й PIN-коду на екрані опублікована довідка не показує. Не знайшли їх у кабінеті — запитайте службу турботи Checkbox.
Як налаштувати касу в Elbuz
Де: Кабінет → Налаштування системи → «Інші налаштування» → плитка «Зовнішні сервіси та інтеграції» → група «Фіскальні чеки» → рядок «Checkbox», олівець.
1
Логін касира2
Пароль касира або PIN3
Ключ ліцензії каси4
Ключ інтеграції- Логін касира — порожній логін: у полі нижче вкажіть PIN.
- Пароль касира або PIN — збережене значення не показується.
- Ключ ліцензії каси — окремий на кожну касу.
- Ключ інтеграції — лише якщо його видала підтримка Checkbox.
Форма зберігається сама: унизу з’являється «Збережено». Збережені пароль і ключ ліцензії в полях не показуються. Нові значення скидають сесію касира, і наступний запит увійде вже з ними.
| Поле | Що робить | Спочатку |
|---|---|---|
| Активність | Вимкнена — каса не пропонується, кнопка чека зникає. Уже видані чеки лишаються в документах | вимкнено |
| Фірма | «Будь-яка» — для всіх документів; конкретна — лише для документів цієї фірми | Будь-яка |
| Платник ПДВ | Увімкнено — ставка береться з рядка документа або товару. Вимкнено — усі рядки йдуть без ПДВ | вимкнено |
| Чек при оплаті за посиланням | Чек видається сам при оплаті через посилання на оплату | вимкнено |
| Закривати зміну щовечора | Завдання крона формує Z-звіт о 22:30 або 23:30 за Києвом. Крім того, при відкритті зміни Checkbox отримує час автозакриття 23:30 | увімкнено |
| Накладений платіж | Режим для посилок із післяплатою, його обирає бухгалтер | Чек при відправці |
Блок «Зміна» під формою показує «Зміну відкрито» або «Зміну закрито». Якщо там текст помилки, дані касира або ключ ліцензії не підходять. Це перша перевірка, чек для неї не потрібен.
Як видати перший чек у тестовому режимі
Тестові каса й касир з’являються в розділах «Каси» і «Касири» одразу після реєстрації, КЕП для них не потрібен. Ліміт — 100 тестових чеків на місяць. Покупцеві тестовий чек видавати не можна: це не розрахунковий документ.
- Впишіть у форму Checkbox дані тестового касира й ключ ліцензії тестової каси, увімкніть «Активність».
- Відкрийте замовлення покупця в гривнях, натисніть «Фіскальний чек». Для перевірки візьміть своє замовлення.
- Перевірте спосіб оплати.
- Вимкніть «Надіслати чек на», якщо в документі контакт справжнього покупця.
- Натисніть «Видати чек» і зачекайте. Перший чек за зміну йде довше, бо Elbuz спершу відкриває зміну.
Результат: номер, сума, дата, позначка «тестовий, нефіскальний» і посилання «Відкрити чек». Той самий чек із позначкою «Тестовий чек» є в кабінеті, у «Архіві чеків». Він не заважає видати справжній чек за цим документом.
1
Номер чека2
Тестовий, нефіскальний3
Відкрити чек- Номер, сума й дата зберігаються в документі.
- Тестова каса: чек не потрапляє в податкову.
- Посилання на чек.
Щоб перейти на справжню касу, закрийте тестову зміну, замініть у формі дані касира й ключ ліцензії та переконайтеся, що блок «Зміна» не показує помилки.
Сценарії
ФОП сам продає через сайт
Що зробити. Зареєструйте касу з типом «Інтернет-торгівля», касира на власний ключ, запустіть Checkbox.Підпис, впишіть дані в Elbuz.
Що вийде. Чеки підписуються самі, комп’ютер із ключем тримати ввімкненим не треба.
Касир не хоче передавати пароль кабінету
Що зробити. Лишіть «Логін касира» порожнім, а в «Пароль касира або PIN» впишіть PIN-код.
Що вийде. Elbuz входить за парою «ключ ліцензії + PIN». Цей спосіб довідка Checkbox називає рекомендованим.
Каса вже працює в застосунку Checkbox
Що зробити. Закрийте зміну й підключіть в Elbuz того самого касира, або другого на другу касу: один касир одночасно працює лише з однією касою.
Що вийде. Чеки із замовлень видно і в Elbuz, і в кабінеті. Чеки, видані раніше в застосунку, Elbuz не бачить, а даних такого чека Checkbox від Elbuz не приймає. Як оформити повернення за ним, описано в розділі про чек іншої програми.
Що робити, коли каса не працює
| Що ви бачите | Чому так | Що зробити |
|---|---|---|
| «Касу не підключено. Увімкніть її й впишіть ключ у «Зовнішні сервіси» → «Фіскальні чеки».» | Каса вимкнена, не вписано пароль чи ключ ліцензії або фірма каси не підходить документу | Перевірте форму каси (налаштування) |
| «Checkbox: sign in HTTP …» | Checkbox не прийняв логін, пароль, PIN або ключ ліцензії | Перепишіть дані (де вони лежать). Для PIN лишіть логін порожнім |
| «Checkbox: shift was not opened, check the signing key in the Checkbox account» | Сервіс відмовив у відкритті зміни, зазвичай через ключ підпису | Перевірте статус «Агент підпису працює» і строк ключа в кабінеті (реєстрація) |
| «Checkbox: VAT rate … is not set up in the Checkbox account» | Такої ставки немає в кабінеті Checkbox | Додайте ставку при закритій зміні й натисніть «Видати чек» ще раз |
| «Чек не підтверджено: Checkbox: receipt is still being fiscalized. Натисніть ще раз: повтор не створить другого чека.» | Сервіс не встиг обробити чек за час очікування | Зачекайте кілька хвилин і натисніть «Видати чек» знову: Elbuz знайде той самий чек |
Повідомлення про сам чек у документі розібрані в статті про чеки.
Часті запитання
Що таке «Ключ інтеграції» і де його взяти?
Це необов’язковий ключ, який видає служба підтримки Checkbox. Якщо вам його не давали, лишіть поле порожнім: каса працює і без нього.
Хто надсилає чек покупцю?
Сам Checkbox, на email і телефон, які Elbuz передав із документа. Телефон передається лише український, у форматі +380.
Чи треба відкривати зміну перед чеком?
Ні. Якщо зміна закрита, Elbuz відкриє її перед чеком сам і дочекається підтвердження сервісу.
Закінчився строк дії ключа КЕП. Що зміниться в Elbuz?
Нічого не треба міняти в Elbuz. Замініть ключ у кабінеті Checkbox при закритій зміні. Поки ключ не замінено, зміна може не відкритися.
Що буде, якщо вимкнути «Активність»?
Кнопка чека зникне з нових документів, автоматичні чеки припиняться. Документи з виданими чеками кнопку зберігають, дані у формі лишаються. Увімкнення повертає все, як було.
Суміжні теми
- Якщо потрібна загальна картина й довідка про обов’язковість чека — Каси ПРРО: фіскальні чеки з Elbuz.
- Якщо каса підключена й час працювати — Як видати фіскальний чек і що робити при поверненні.
- Якщо вибираєте сервіс і дивитеся на другий варіант — Як підключити Вчасно.Касу.