# Вчасно + Krokul CRM

Так. Krokul CRM інтегрується з Вчасно і відправляє рахунок, акт чи договір з картки угоди у Вчасно.ЕДО готовим PDF. Статус документа (підписано, відхилено чи очікує підпису контрагента) повертається з Вчасно в Krokul. Підписаний документ переводить угоду на наступний етап. Зв’язка будується на API і вебхуках Krokul.

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

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

### Акт з угоди йде контрагенту одним натиском

Менеджер відкриває акт у картці угоди і натискає «Надіслати у Вчасно». Krokul формує PDF за вашим бланком, називає файл за правилами Вчасно з ЄДРПОУ отримувача й номером документа і завантажує його запитом POST /api/v2/documents. Ідентифікатор document_id Вчасно Krokul зберігає на документі.

### Статус підпису видно в картці документа

Krokul регулярно питає POST /api/v2/documents/statuses для документів, які очікують підпису. Статус 7008 означає, що зібрано всі підписи. Документ отримує позначку «Підписано», а угода переходить на етап, який ви вказали в налаштуваннях. Відмову контрагента (7006) Krokul записує в стрічку угоди й ставить відповідальному задачу.

### Чи працює клієнт у Вчасно, видно наперед

Коли в Krokul з’являється контрагент з кодом ЄДРПОУ, Krokul перевіряє його запитом POST /api/v2/check/company. Поле is_registered з відповіді стає позначкою на картці контрагента, і менеджер ще до договору знає, чи піде документ електронно.

### Рахунки після виграної угоди без ручної роботи

У налаштуваннях підключення ви вибираєте види документів, які Krokul відправляє у Вчасно сам, щойно вони створені. Для B2B типово це рахунок після переходу угоди у «виграно» і акт після закриття робіт. Кожна відправка з’являється в журналі синхронізації з результатом.

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

| Вчасно | Krokul | Напрям | Коли |
|---|---|---|---|
| Документ (POST /api/v2/documents, PDF) | Рахунок, акт, договір з угоди | Krokul → Вчасно | Натиск «Надіслати у Вчасно» або автоматично за видом документа |
| document_id | Зовнішній ключ і посилання на документі | Вчасно → Krokul | Одразу після завантаження |
| Статус документа (7000–7011) | Позначка на документі, запис у стрічці угоди | Вчасно → Krokul | Опитування /documents/statuses за розкладом |
| Статус 7008, усі підписи | Етап угоди | Вчасно → Krokul | Коли контрагент підписав |
| Статус 7006, відмова | Задача відповідальному | Вчасно → Krokul | Коли контрагент відхилив |
| Перевірка компанії (check/company, is_registered) | Позначка на картці контрагента | Вчасно → Krokul | Після створення контрагента з ЄДРПОУ |

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

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

1. У Вчасно увімкніть тариф з доступом до API і створіть токен користувача.
2. У Krokul випустіть ключ API зі scope на угоди й документи та підпишіть вебхук на `document.created` або `card.won`. Справжність кожної доставки підтверджує заголовок `x-crm-signature`, який ви звіряєте зі своїм секретом.
3. На подію прочитайте документ через `document/api-read`, візьміть бланк із `document/api-print` (він віддає HTML), перетворіть його на PDF і завантажте у Вчасно запитом POST /api/v2/documents. Отриманий document_id прив’яжіть до документа Krokul через `externalRef/api-upsert`.
4. Статуси перечитуйте POST /api/v2/documents/statuses і записуйте в стрічку угоди через `activity/api-create`. На статус 7008 переводьте угоду далі викликом `card/api-updateStatus`.

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

Документи, статуси й зовнішні ключі доступні також через публічний API Krokul. Роут `document/api-read` читає документ, а `externalRef/api-resolve` знаходить його в Krokul за document_id. Вебхуки `document.created` і `card.won` підписано HMAC-SHA256. Журнал доставок дозволяє повторити подію. Для перевірки зв’язки є пісочниця з демо-даними й окремим ключем API.

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

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

### Чи є в Krokul інтеграція з Вчасно?

Так. Krokul інтегрується з Вчасно через свій API і вебхуки. Документи з угоди йдуть у Вчасно.ЕДО, статус підпису повертається, і угода переходить далі, коли документ підписано.

### Як швидко Krokul дізнається, що контрагент підписав документ?

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

### Звідки береться PDF документа?

Krokul формує PDF з того самого бланка, який ви друкуєте з картки документа. Файл іде у Вчасно з назвою, яку вимагає інструкція Вчасно.

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

Тариф Вчасно з доступом до API і токен користувача. Відправником документа у Вчасно буде компанія, якій належить токен.

## Обмеження

Підписують документ сторони у Вчасно, Krokul лише відправляє файл і стежить за статусом. API Вчасно не надсилає подій, тож Krokul перечитує статуси за розкладом, а інструкція Вчасно обмежує обмін десятьма запитами на секунду від компанії і файлом до 15 МБ.

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

- [Checkbox](https://krokul.com/uk/integrations/checkbox/index.md)
- [Opendatabot](https://krokul.com/uk/integrations/opendatabot/index.md)
- [Нова пошта](https://krokul.com/uk/integrations/nova-poshta/index.md)

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

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

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

---

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