# YouControl + Krokul CRM

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

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

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

### Реквізити з ЄДР за кодом ЄДРПОУ

Менеджер вводить код у новому контрагенті. Krokul перевіряє контрольну суму й викликає /v1/usr/{contractorCode}. Повна назва, адреса, вид діяльності за КВЕД, стан і дата реєстрації заповнюють картку. Друкувати рахунок можна одразу, без звірки реквізитів руками.

### Експрес-аналіз перед першою угодою

Для нового контрагента Krokul запитує /v1/expressAnalysis/{contractorCode} і показує в картці маркери ризику YouControl. Якщо серед них є податковий борг, Krokul додає дані з /v1/taxDebt. Керівник продажу вирішує, чи працювати з передоплатою, ще на етапі пропозиції.

### Статус платника ПДВ на рахунку

Перед створенням рахунку Krokul перевіряє /v1/vat/{contractorCode} і /v1/singleTax/{contractorCode}. Картка контрагента показує, чи компанія платник ПДВ або єдиного податку, а бухгалтер бачить це до того, як виставити документ із ПДВ.

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

Для контрагентів з відкритими угодами Krokul за розкладом читає /v1/history/{contractorCode}. Нова зміна, наприклад інша адреса чи назва, з’являється записом у стрічці контрагента. Відповідальний отримує сповіщення.

### Фінансовий стан великого клієнта

Для контрагента з великою сумою угод менеджер відкриває вкладку з оцінкою FinScore з /v1/financialScoring. Krokul показує оцінку за роками, і команда враховує її, коли погоджує відстрочку платежу.

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

| YouControl (YouScore) | Krokul | Напрям | Коли |
|---|---|---|---|
| Код ЄДРПОУ (/v1/usr/{contractorCode}) | Поле ЄДРПОУ контрагента | Krokul → YouControl | Створення контрагента чи «Оновити з реєстру» |
| Дані ЄДР (назва, адреса, КВЕД, стан і дата реєстрації) | Реквізити в картці контрагента | YouControl → Krokul | У відповіді на запит |
| Експрес-аналіз (/v1/expressAnalysis) | Маркери ризику в картці контрагента | YouControl → Krokul | Новий контрагент і перша угода |
| Податковий борг (/v1/taxDebt) | Попередження в картці контрагента й угоди | YouControl → Krokul | Коли експрес-аналіз показує борг |
| Реєстр платників ПДВ і єдиного податку (/v1/vat, /v1/singleTax) | Податковий статус контрагента | YouControl → Krokul | Перед створенням рахунку |
| Історія змін (/v1/history) | Запис у стрічці контрагента, сповіщення | YouControl → Krokul | Опитування за розкладом |
| Оцінка FinScore (/v1/financialScoring) | Вкладка фінансового стану контрагента | YouControl → Krokul | На запит менеджера |

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

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

1. Отримайте ключ API YouScore у YouControl і додайте IP-адресу свого сервера до дозволених. У Krokul випустіть ключ API зі scope на читання й запис контрагентів.
2. Підпишіть вебхук Krokul на `clientCompany.created` і перевіряйте заголовок `x-crm-signature` кожної доставки.
3. На подію викличте /v1/usr/{contractorCode} і /v1/expressAnalysis/{contractorCode} з кодом ЄДРПОУ, а результат запишіть у картку через `clientCompany/api-update`. Відповідь 202 означає, що YouScore оновлює дані, і запит треба повторити пізніше.
4. За розкладом читайте /v1/history/{contractorCode} для контрагентів з відкритими угодами й додавайте кожну зміну в стрічку через `activity/api-create`.

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

YouScore публікує специфікацію Swagger з відповідями в JSON і працює за ключем apiKey. Ліміт становить 200 запитів на хвилину й 50 запитів за 5 секунд на ключ, тому черга запитів Krokul тримає паузи. На боці Krokul `clientCompany/api-create` відповідає 409 на дубль за ЄДРПОУ, а `clientCompany.created` приходить підписаним вебхуком із журналом доставок і повторною відправкою.

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

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

### Чи перевіряє Krokul контрагента через YouControl?

Так. Krokul бере з YouControl дані ЄДР, експрес-аналіз ризиків, податковий статус і податковий борг за кодом ЄДРПОУ й показує їх у картці контрагента.

### Що означає відповідь 202 від API YouScore?

YouScore оновлює дані про компанію. Krokul повторює запит пізніше й заповнює картку, коли дані готові.

### Чи бачить Krokul зміни в реєстрі після створення контрагента?

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

### Що потрібно, щоб підключити YouControl до Krokul?

Ключ API YouScore з тарифом, що містить потрібні дані, і дозволена IP-адреса сервера. Умови доступу до API оформлюються в YouControl.

## Обмеження

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

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

- [Opendatabot](https://krokul.com/uk/integrations/opendatabot/index.md)
- [Вчасно](https://krokul.com/uk/integrations/vchasno/index.md)
- [Checkbox](https://krokul.com/uk/integrations/checkbox/index.md)

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

YouControl і YouScore є торговими марками їхнього власника. Krokul не афілійований із YouControl.

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

---

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