Перейти до вмісту
FOPilot

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 попереджає в щоденному підсумку, якщо зміна відкрита майже добу.
  • Для кожного чека ми генеруємо ідентифікатор заздалегідь: якщо зв'язок обірветься, повторна спроба не створить дубль — ми знайдемо вже створений чек.
  • Чи потрібен чек на кожну операцію (оплата на рахунок, накладений платіж), залежить від способу розрахунку і вашої групи ФОП — уточніть у бухгалтера.