Тут пояснено, що є у відкритих даних ЄДР, чого в них немає з початку воєнного стану і коли замість ручного пошуку потрібен API.
Єдиний державний реєстр юридичних осіб, фізичних осіб – підприємців та громадських формувань (ЄДР) веде Міністерство юстиції України. Ключ юридичної особи в ньому — код ЄДРПОУ з 8 цифр. Частину відомостей реєстру Міністерство публікує як відкриті дані на порталі data.gov.ua за ліцензією CC BY 4.0, а набір даних оновлюється щотижня. Саме ці відкриті дані є джерелом Prometiam для України. Ліцензія дозволяє використання за умови вказання джерела, тому на цій сторінці наведено відповідний рядок.
Prometiam подає записи комерційних юридичних осіб: товариств з обмеженою та додатковою відповідальністю, акціонерних товариств, повних і командитних товариств, приватних, державних, комунальних та інших підприємств, виробничих кооперативів. Припинені юридичні особи теж входять до даних. Що саме повертає API:
| Відомості | Для України |
|---|---|
| Назва юридичної особи українською | Так: company_name |
| Код ЄДРПОУ | Так: company_number |
| Організаційно-правова форма | Так: legal_form, local_legal_form (ТОВ, ПрАТ, АТ, ДП тощо) |
| Статус, зокрема стан припинення та банкрутство | Так: status, local_status |
| Дата державної реєстрації та дата припинення | Так: founding_date, dissolution_date |
| Статутний капітал | Так: capital_amount, capital_currency (UAH), якщо реєстр його наводить |
| Керівники, засновники, кінцеві бенефіціарні власники | Ні: ми їх не надаємо |
| Адреса, код КВЕД, контакти | Ні: Міністерство юстиції не публікує їх у відкритих даних з початку воєнного стану |
| Номер ПДВ | Ні: його немає в реєстрі |
| Фінансова звітність, повідомлення про неплатоспроможність | Ні |
| Події змін у реєстрі та моніторинг компаній | Так: події про назву, статус, організаційно-правову форму й статутний капітал (GET /company-events/search), без адреси, бо реєстр її не публікує; моніторинг — POST /monitor |
З початку воєнного стану Міністерство юстиції не публікує у відкритих даних ЄДР адресу, код КВЕД і контактні дані юридичних осіб. Тому цих відомостей немає й у нашому API. Крім того, у відкритих даних відсутні деякі державні й пов’язані з обороною суб’єкти. Відсутність запису не означає, що компанії не існує.
Практичний наслідок: за відкритими даними ЄДР можна підтвердити, що юридична особа зареєстрована або припинена, у якому вона стані, коли її зареєстровано, яку назву й організаційно-правову форму вона має та який у неї статутний капітал. Щоб з’ясувати, де вона розташована, чим займається, хто нею керує й хто її кінцевий бенефіціарний власник, потрібні інші джерела та документи клієнта.
Тож ФОП як постачальника чи клієнта через цей API перевірити не можна: він повертає лише комерційні юридичні особи.
Дані ЄДР можна отримати трьома шляхами, і кожен вирішує своє завдання.
| Критерій | Власні сервіси пошуку Мін’юсту | Набір відкритих даних | Prometiam API |
|---|---|---|---|
| Для чого | Ручний пошук окремої юридичної особи й офіційні витяги | Власна обробка всього набору на вашому боці | Автоматична перевірка з вашого застосунку |
| Як отримати | У браузері | Завантажити файл з data.gov.ua; він оновлюється щотижня | Запит із ключем API |
| Що робите ви | Читаєте результат і переносите його у свою систему | Розбираєте файл, зберігаєте, оновлюєте й будуєте пошук | Читаєте JSON; розбирати й зберігати файл не потрібно |
| Формат | Сторінка або документ реєстру | Файл у структурі реєстру | Той самий об’єкт компанії, що й для 30 інших країн |
| Офіційний витяг | Так, його видає реєстр | Ні | Ні |
Пошуку Мін’юсту досить, коли треба перевірити одну-дві компанії або отримати офіційний витяг. Сам набір відкритих даних підходить команді, яка готова розбирати великий файл, зберігати його й оновлювати щотижня. API потрібен, коли перевірка має відбуватися автоматично: в онбордингу клієнтів, у системі закупівель, у ERP чи CRM; коли потрібні сповіщення про зміни в реєстрі; а також коли ви працюєте не лише з Україною, бо структура відповіді однакова для 31 країни.
ПрАТ «Київстар» за кодом ЄДРПОУ та за назвою:
# за кодом ЄДРПОУ curl 'https://api.prometiam.com/functions/v1/risk-api/companies/search?country=UA&company_number=21673832' \ -H 'Authorization: Bearer rk_live_...' # за назвою curl -G 'https://api.prometiam.com/functions/v1/risk-api/companies/search' \ --data-urlencode 'country=UA' \ --data-urlencode 'name=київстар' \ -H 'Authorization: Bearer rk_live_...'
Пошук за назвою може повернути кілька компаній, тож коли код ЄДРПОУ відомий, шукайте за ним. Номер ПДВ — окремий номер податкової служби, у реєстрі його немає: пошук за vat для України не працює. Докладніше про запит і про те, як читати результат, на сторінці «Перевірка контрагента через API».
Contains data from the Unified State Register of Legal Entities, Individual Entrepreneurs and Public Organisations (EDR), Ministry of Justice of Ukraine, published as open data on data.gov.ua under the Creative Commons Attribution licence (CC BY 4.0). Adapted by Prometiam.
Тарифи публічні, розмова з відділом продажів не потрібна. Starter коштує 9,99 € на місяць (1 000 кредитів), Professional — 29,99 € (10 000 кредитів), Scale — 99,99 € (50 000 кредитів), Enterprise — за домовленістю. Пошук компанії або її запис коштує 1 кредит, перевірка за санкційними списками (бета) — 3 кредити; відповіді з помилками безкоштовні. Пробний період триває 14 днів і містить 500 кредитів: потрібна банківська картка, під час пробного періоду кошти не списуються, далі діє Starter, якщо ви не скасуєте підписку. Докладніше: ціни.
Розпочати безкоштовний 14-денний пробний період · Документація API
Пробний період триває 14 днів і містить 500 кредитів. Потрібна банківська картка, під час пробного періоду кошти не списуються; далі діє тариф Starter (9,99 € на місяць), якщо ви не скасуєте підписку.