Checkbox — каса і касир для FOPilot
Які дані Checkbox (ПРРО) потрібні для підключення, як їх знайти і як безпечно протестувати на тестовому середовищі.
Checkbox — програмний РРО (ПРРО). Через його API FOPilot показує стан зміни і чеки, відкриває та закриває зміну, видає чеки продажу та повернення.
Що потрібно
- Ключ ліцензії каси — у веб-кабінеті Checkbox у розділі каси (потрібен, щоб відкрити зміну).
- Касир: логін і пароль касира або PIN-код касира (PIN працює разом із ключем ліцензії каси).
- Підписаний ключ (КЕП) касира, налаштований у Checkbox — без нього каса не зможе фіскалізувати чеки.
📷 Скріншот: картка каси з ключем ліцензії та список касирів.
Підключення
Кабінет → Підключення → Checkbox → Підключити: вкажіть ключ ліцензії, логін і пароль касира (або PIN), оберіть середовище:
- Робоче —
api.checkbox.ua, чеки потрапляють до ДПС; - Тестове —
dev-api.checkbox.in.ua, для перевірки без реальної фіскалізації.
Радимо спершу підключити тестову касу і пройти сценарій «відкрити зміну → чек → повернення → закрити зміну».
Незворотні дії
Фіскальний чек, чек повернення та закриття зміни (Z-звіт) неможливо скасувати. Тому в FOPilot це руйнівні інструменти: AI-клієнт показує їх окремо і просить підтвердження. Суму чека інструмент розраховує з позицій замовлення в копійках, як вимагає API; якщо зміну не відкрито, Checkbox повертає помилку і чек не створюється.
Корисно знати
- Зміна в ПРРО не може тривати понад 24 години — FOPilot попереджає в щоденному підсумку, якщо зміна відкрита майже добу.
- Для кожного чека ми генеруємо ідентифікатор заздалегідь: якщо зв'язок обірветься, повторна спроба не створить дубль — ми знайдемо вже створений чек.
- Чи потрібен чек на кожну операцію (оплата на рахунок, накладений платіж), залежить від способу розрахунку і вашої групи ФОП — уточніть у бухгалтера.