# Opendatabot + Krokul CRM

Так. Krokul CRM інтегрується з Opendatabot. Krokul запитує Opendatabot, щойно менеджер вводить код ЄДРПОУ контрагента, і заповнює з ЄДР повну назву, адресу, керівника, вид діяльності й стан реєстрації. Для контрагентів з відкритими угодами Krokul стежить за змінами в реєстрі й пише їх у стрічку картки. Зв’язку будують на API Opendatabot разом з API і вебхуками Krokul.

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

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

### Новий контрагент за кодом ЄДРПОУ

Менеджер вводить у Krokul код ЄДРПОУ, Krokul перевіряє контрольну суму й викликає GET /full-company/{code}. З блоку registry в картку контрагента лягають юридична назва, адреса, ім’я керівника й основний вид діяльності. Менеджер не копіює реквізити з реєстру руками.

### Стан реєстрації до підписання договору

Поле status з відповіді Opendatabot показує, чи компанія зареєстрована, у стані припинення чи вже припинена. Krokul показує цей стан у картці контрагента, а при створенні договору чи рахунку для компанії в стані припинення попереджає менеджера.

### Зміна директора приходить у стрічку

Для контрагентів з відкритими угодами Krokul оформлює підписку POST /subscriptions з типом company. За розкладом Krokul читає GET /history, і кожна нова зміна, наприклад новий керівник чи адреса, з’являється записом у стрічці контрагента та сповіщенням відповідальному.

### Картка оновлюється з реєстру за запитом

Кнопка «Оновити з реєстру» в картці контрагента повторює запит /full-company і показує, які поля змінились. Менеджер вирішує, що прийняти, а попередні значення лишаються в історії картки.

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

| Opendatabot | Krokul | Напрям | Коли |
|---|---|---|---|
| Код ЄДРПОУ (/full-company/{code}) | Поле ЄДРПОУ контрагента | Krokul → Opendatabot | Створення контрагента або «Оновити з реєстру» |
| Реєстраційні дані (registry: назва, адреса, керівник, вид діяльності) | Поля картки контрагента | Opendatabot → Krokul | У відповіді на запит |
| Стан реєстрації (status) | Позначка й попередження в картці контрагента | Opendatabot → Krokul | У відповіді на запит |
| Підписка на моніторинг (POST /subscriptions) | Контрагент з відкритою угодою | Krokul → Opendatabot | Коли в контрагента з’являється угода |
| Історія змін (/history) | Запис у стрічці контрагента, сповіщення | Opendatabot → Krokul | Опитування за розкладом |

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

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

1. Отримайте ключ API в Opendatabot кнопкою «Підключити» на сторінці API; для перевірки там дають тестовий доступ. У Krokul випустіть ключ API зі scope на читання й запис контрагентів.
2. Підпишіть вебхук Krokul на подію `clientCompany.created` і звіряйте заголовок `x-crm-signature` кожної доставки зі своїм секретом.
3. На подію викличте GET /full-company/{code} з кодом ЄДРПОУ нового контрагента й запишіть назву, адресу та керівника в картку через `clientCompany/api-update`.
4. Для моніторингу оформіть POST /subscriptions з типом company, читайте GET /history за розкладом і додавайте кожну зміну в стрічку контрагента через `activity/api-create` з типом comment.

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

Opendatabot публікує специфікацію OpenAPI для v3 з відповідями в JSON. На боці Krokul `clientCompany/api-create` відбиває дубль за ЄДРПОУ відповіддю 409, тож автозаповнення не плодить другу картку. Подія `clientCompany.created` приходить підписаним вебхуком з журналом доставок, а перевірити зв’язку можна в пісочниці з демо-даними.

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

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

### Чи перевіряє Krokul контрагента в реєстрі за ЄДРПОУ?

Так, через Opendatabot. Krokul перевіряє контрольну суму коду, а потім бере дані з ЄДР і заповнює картку контрагента.

### Які дані Opendatabot потрапляють у картку контрагента?

Метод /full-company повертає, серед іншого, повну й коротку назву, адресу, керівника, основний вид діяльності, стан реєстрації та засновників. Krokul записує реквізити й стан, решту видно в Opendatabot.

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

Так, для контрагентів на моніторингу. Krokul регулярно читає історію змін Opendatabot і пише кожну зміну в стрічку контрагента.

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

Ключ API Opendatabot. Умови доступу до API обговорюються з самим Opendatabot.

## Обмеження

Доступ до API Opendatabot оформлюється в самого Opendatabot, там же дають тестовий доступ. Opendatabot не надсилає вебхуків, тому зміни з моніторингу Krokul забирає опитуванням історії за розкладом.

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

- [Вчасно](https://krokul.com/uk/integrations/vchasno/index.md)
- [Checkbox](https://krokul.com/uk/integrations/checkbox/index.md)
- [ПриватБанк](https://krokul.com/uk/integrations/privatbank/index.md)

[Реєстри й закупівлі (Україна)](https://krokul.com/uk/integrations/category/registers-ua/index.md)

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

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

---

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