Так. Krokul CRM інтегрується з Checkbox. Krokul створює фіскальний чек у програмному РРО Checkbox, щойно оплата в угоді позначена отриманою. Товари й суми беруться з рахунку, а покупець отримує документ на email чи SMS. Фіскальний номер і PDF повертаються в Krokul вебхуком Checkbox і лягають на оплату.
Бухгалтер позначає оплату в угоді отриманою, і 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) | Krokul → Checkbox | Email чи телефон контакту угоди | У запиті на чек |
| Зміна касира (shifts, shifts/close) | Krokul → Checkbox | Налаштування підключення | Перед першим чеком і за розкладом закриття |
| Вебхук фіскалізації чека | Checkbox → Krokul | Фіскальний номер на оплаті, запис у стрічці угоди | Після фіскалізації |
| PDF чека (/receipts/{id}/pdf) | Checkbox → Krokul | Файл угоди | Після фіскалізації |
| Чек повернення (goods з is_return) | Krokul → Checkbox | Повернення оплати | Коли оформлено повернення |
| Вебхук відкриття й закриття зміни, внесення й вилучення | Checkbox → Krokul | Журнал підключення | Під час роботи каси |
webhook/api-upsert свою адресу на подію payment.received. Заголовок x-crm-signature кожної доставки звіряйте зі своїм секретом.document/api-read.activity/api-create, а id чека прив’яжіть до оплати через externalRef/api-set.Так. Krokul інтегрується з Checkbox через свій API і вебхуки. Krokul пробиває чек у Checkbox на отриману оплату, надсилає його покупцю, а фіскальний номер і PDF чека зберігає в угоді.
Каса в кабінеті Checkbox з ліцензійним ключем, касир з логіном і паролем та ключ підпису (файл КЕП або хмарний DepositSign).
Ні, лише ті, що підпадають під ваші правила. У налаштуваннях підключення ви вказуєте форми оплати й види документів, які фіскалізуються.
Checkbox надсилає вебхук на адресу підключення Krokul. Krokul перевіряє підпис x-request-signature і записує фіскальний номер на оплату.
Чек у Checkbox підписує ключ каси (файл КЕП або хмарний DepositSign), а пробивається він від імені касира з відкритою зміною. Відповідність складу чека податковим правилам (ставки ПДВ товарів, форма оплати) перевіряє ваш бухгалтер у налаштуваннях каси й товарів.
Напишіть, яким сервісом ви користуєтесь і що має ходити між ним і Krokul. Ми відповімо способом і строком.
Запит отримано. Відповімо на вашу пошту.
Checkbox є торговою маркою її власника. Krokul не афілійований із Checkbox.