# Checkbox + Krokul CRM

Так. Krokul CRM інтегрується з Checkbox. Krokul створює фіскальний чек у програмному РРО Checkbox, щойно оплата в угоді позначена отриманою. Товари й суми беруться з рахунку, а покупець отримує документ на email чи SMS. Фіскальний номер і PDF повертаються в Krokul вебхуком Checkbox і лягають на оплату.

**Статус:** Через API і вебхуки.

## Що отримує команда

### Отримана оплата одразу стає чеком

Бухгалтер позначає оплату в угоді отриманою, і Krokul викликає POST /api/v1/receipts/sell. У goods ідуть назви, ціни й кількість з рахунку, у payments сума й тип оплати, а в order_id номер документа Krokul. Якщо зміна касира закрита, Krokul відкриває її перед першим чеком дня.

### Покупець отримує чек на пошту

Блок delivery у запиті бере email з контакту угоди. Для клієнтів, які лишили лише телефон, Krokul надсилає чек методом /receipts/{id}/sms. Менеджер нічого не пересилає руками й бачить у стрічці угоди, куди пішов документ.

### Фіскальний номер на оплаті

Після фіскалізації Checkbox надсилає вебхук на адресу підключення Krokul. Krokul перевіряє підпис x-request-signature, знаходить угоду за order_id і записує фіскальний номер на оплату. Посилання на PDF чека з /receipts/{id}/pdf з’являється у файлах угоди.

### Повернення коштів з чеком повернення

Коли в Krokul оформлено повернення оплати, створюється чек повернення тим самим методом receipts/sell з позначкою is_return у товарах. Обидва чеки видно на одній угоді.

### Журнал каси поруч з продажами

Вебхук Checkbox повідомляє також про відкриття й закриття зміни та службові внесення й вилучення. Krokul складає ці події в журнал підключення, а зміну закриває за розкладом, який ви задали.

## Що передається між системами

| Checkbox | Krokul | Напрям | Коли |
|---|---|---|---|
| Чек продажу (receipts/sell): goods, payments, order_id | Оплата й позиції рахунку | Krokul → Checkbox | Оплата позначена отриманою |
| Доставка чека (delivery, /email, /sms) | Email чи телефон контакту угоди | Krokul → Checkbox | У запиті на чек |
| Зміна касира (shifts, shifts/close) | Налаштування підключення | Krokul → Checkbox | Перед першим чеком і за розкладом закриття |
| Вебхук фіскалізації чека | Фіскальний номер на оплаті, запис у стрічці угоди | Checkbox → Krokul | Після фіскалізації |
| PDF чека (/receipts/{id}/pdf) | Файл угоди | Checkbox → Krokul | Після фіскалізації |
| Чек повернення (goods з is_return) | Повернення оплати | Krokul → Checkbox | Коли оформлено повернення |
| Вебхук відкриття й закриття зміни, внесення й вилучення | Журнал підключення | Checkbox → Krokul | Під час роботи каси |

## Як підключити сьогодні

### Власний потік через API і вебхуки Krokul

1. На my.checkbox.ua заведіть торгову точку, касу й касира, отримайте ліцензійний ключ каси й підготуйте ключ підпису чеків (файл КЕП або хмарний DepositSign).
2. У Krokul випустіть ключ API зі scope на оплати й документи та підпишіть через `webhook/api-upsert` свою адресу на подію `payment.received`. Заголовок `x-crm-signature` кожної доставки звіряйте зі своїм секретом.
3. На подію авторизуйте касира методом /cashier/signin, за потреби відкрийте зміну й викличте /receipts/sell з позиціями рахунку, які дає `document/api-read`.
4. Зареєструйте свою адресу для вебхуків Checkbox (POST /api/v1/webhook). Фіскальний номер з вебхука запишіть у стрічку угоди через `activity/api-create`, а id чека прив’яжіть до оплати через `externalRef/api-set`.

### Для інтеграторів

Checkbox публікує відкриту специфікацію в OpenAPI, Swagger і ReDoc на api.checkbox.in.ua. Вебхук Checkbox повторюється до чотирьох годин, і Krokul приймає його ідемпотентно за id чека. Ті самі оплати доступні в публічному API Krokul, події `payment.received` та `invoice.paid` приходять підписаними вебхуками з журналом доставок, а для перевірки зв’язки є пісочниця з демо-даними.

[Документація API](https://app.krokul.com/api/v1/docs)

## Питання й відповіді

### Чи є в Krokul інтеграція з Checkbox?

Так. Krokul інтегрується з Checkbox через свій API і вебхуки. Krokul пробиває чек у Checkbox на отриману оплату, надсилає його покупцю, а фіскальний номер і PDF чека зберігає в угоді.

### Що потрібно для підключення Checkbox?

Каса в кабінеті Checkbox з ліцензійним ключем, касир з логіном і паролем та ключ підпису (файл КЕП або хмарний DepositSign).

### Чи кожна оплата в Krokul стає чеком?

Ні, лише ті, що підпадають під ваші правила. У налаштуваннях підключення ви вказуєте форми оплати й види документів, які фіскалізуються.

### Як Krokul дізнається, що чек фіскалізовано?

Checkbox надсилає вебхук на адресу підключення Krokul. Krokul перевіряє підпис x-request-signature і записує фіскальний номер на оплату.

## Обмеження

Чек у Checkbox підписує ключ каси (файл КЕП або хмарний DepositSign), а пробивається він від імені касира з відкритою зміною. Відповідність складу чека податковим правилам (ставки ПДВ товарів, форма оплати) перевіряє ваш бухгалтер у налаштуваннях каси й товарів.

## Пов’язані сервіси

- [Вчасно](https://krokul.com/uk/integrations/vchasno/index.md)
- [monobank](https://krokul.com/uk/integrations/monobank/index.md)
- [NovaPay](https://krokul.com/uk/integrations/novapay/index.md)
- [WayForPay](https://krokul.com/uk/integrations/wayforpay/index.md)

[Документообіг і ПРРО (Україна)](https://krokul.com/uk/integrations/category/documents-ua/index.md)

Checkbox є торговою маркою її власника. Krokul не афілійований із Checkbox.

Оновлено: 2026-10-12

---

Застосунок: https://app.krokul.com/ · API: https://app.krokul.com/api/v1/docs