UK
Подивитися демо

YouControl + Krokul CRM

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

  • Через API і вебхукиВи підключаєте сервіс застосунком 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.

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

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

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

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

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

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

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

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

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

Обмеження

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

Чогось бракує?

Напишіть, яким сервісом ви користуєтесь і що має ходити між ним і Krokul. Ми відповімо способом і строком.

Запит отримано. Відповімо на вашу пошту.

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

Подивитися демо