# YouControl + Krokul CRM

Yes. Krokul CRM integrates with YouControl through the YouScore API. By EDRPOU code, Krokul fills in the company card with data from the Unified State Register, shows the VAT payer status, tax debt and the express risk analysis, and writes register changes to the company feed. The manager sees the risks before sending an invoice.

**Status:** Via API and webhooks.

## What your team gets

### Details from the register by EDRPOU code

A manager enters the code in a new company. Krokul checks the checksum and calls /v1/usr/{contractorCode}. The full name, address, KVED business activity, registration state and date fill in the card. The invoice can be printed at once, with no manual check of the details.

### An express analysis before the first deal

For a new company, Krokul requests /v1/expressAnalysis/{contractorCode} and shows the YouControl risk markers on the card. If tax debt is among them, Krokul adds the data from /v1/taxDebt. The head of sales decides on prepayment while the deal is still at the proposal stage.

### VAT payer status on the invoice

Before an invoice is created, Krokul checks /v1/vat/{contractorCode} and /v1/singleTax/{contractorCode}. The company card shows whether the company pays VAT or the single tax, and the accountant sees it before issuing a document with VAT.

### Register changes reach the feed

For companies with open deals, Krokul reads /v1/history/{contractorCode} on a schedule. A new change, such as a different address or name, appears as an entry in the company feed. The owner gets a notification.

### The financial state of a large client

For a company with a large deal volume, the manager opens the tab with the FinScore rating from /v1/financialScoring. Krokul shows the rating by year, and the team takes it into account when agreeing a payment deferral.

## What moves between YouControl and Krokul

| YouControl (YouScore) | Krokul | Direction | When |
|---|---|---|---|
| EDRPOU code (/v1/usr/{contractorCode}) | Company EDRPOU field | Krokul → YouControl | A company is created, or «Update from register» |
| Register data (name, address, KVED, registration state and date) | Details on the company card | YouControl → Krokul | In the reply to the request |
| Express analysis (/v1/expressAnalysis) | Risk markers on the company card | YouControl → Krokul | A new company and its first deal |
| Tax debt (/v1/taxDebt) | Warning on the company card and the deal | YouControl → Krokul | When the express analysis shows a debt |
| VAT and single tax payer registers (/v1/vat, /v1/singleTax) | Company tax status | YouControl → Krokul | Before an invoice is created |
| Change history (/v1/history) | Entry in the company feed, notification | YouControl → Krokul | Polling on a schedule |
| FinScore rating (/v1/financialScoring) | Company financial state tab | YouControl → Krokul | When the manager asks for it |

## How to connect today

### Your own flow through the Krokul API and webhooks

1. Get a YouScore API key from YouControl and add the IP address of your server to the allowed list. In Krokul, issue an API key with scopes to read and write companies.
2. Subscribe a Krokul webhook to `clientCompany.created` and check the `x-crm-signature` header of every delivery.
3. On the event, call /v1/usr/{contractorCode} and /v1/expressAnalysis/{contractorCode} with the EDRPOU code, and write the result to the card through `clientCompany/api-update`. A 202 response means YouScore is updating the data, and the request has to be repeated later.
4. On a schedule, read /v1/history/{contractorCode} for companies with open deals and add each change to the feed through `activity/api-create`.

### For integrators

YouScore publishes a Swagger specification with JSON responses and works with an apiKey. The limit is 200 requests per minute and 50 requests per 5 seconds per key, so the Krokul request queue keeps pauses. On the Krokul side, `clientCompany/api-create` answers 409 to a duplicate by EDRPOU code, and `clientCompany.created` arrives as a signed webhook with a delivery log and redelivery.

[API documentation](https://app.krokul.com/api/v1/docs)

## Questions and answers

### Does Krokul check a counterparty through YouControl?

Yes. By EDRPOU code, Krokul takes register data, the express risk analysis, the tax status and tax debt from YouControl and shows them on the company card.

### What does a 202 response from the YouScore API mean?

YouScore is updating the company data. Krokul repeats the request later and fills in the card when the data is ready.

### Does Krokul see register changes after a company is created?

Yes, for companies with open deals. Krokul reads the YouScore change history regularly and writes new entries to the company feed.

### What do I need to connect YouControl to Krokul?

A YouScore API key on a plan that includes the data you need, and an allowed server IP address. API access terms are arranged with YouControl.

## Limits

Access to the YouScore API, the plan and the list of available data sets are arranged with YouControl. Requests are accepted from allowed IP addresses and limited per key, so Krokul requests data when a manager acts and on a schedule, without bulk pulls.

## Related services

- [Opendatabot](https://krokul.com/en/integrations/opendatabot/index.md)
- [Vchasno](https://krokul.com/en/integrations/vchasno/index.md)
- [Checkbox](https://krokul.com/en/integrations/checkbox/index.md)

[Registers and procurement (Ukraine)](https://krokul.com/en/integrations/category/registers-ua/index.md)

YouControl and YouScore are trademarks of their owner. Krokul is not affiliated with YouControl.

Updated: 2026-10-15

---

App: https://app.krokul.com/ · API: https://app.krokul.com/api/v1/docs