Зміни

Опис реєстру

ЄДР містить інформацію про реєстрацію юридичних осіб та фізичних осіб - підприємців та громадських формувань, зокрема дані про:

• Вид економічної діяльності (КВЕД)
• Відомості про керівників або засновників
• Статус юридичної особи або ФОП (чинний/припинений)

Варіанти використання даних реєстру (можливі):

• Державне регулювання та контроль:
  • Реєстрація нових суб’єктів господарювання та громадських формувань.
  • Контроль діяльності компаній та ФОП.
  • Ліквідація та реєстрація змін у діяльності організацій.
• Бізнес-процеси:
  • Перевірка контрагентів (законність діяльності, статус, бенефіціари).
  • Аналіз ринку та конкурентів через дані про реєстрацію нових компаній.
  • Оцінка фінансової стабільності через інформацію про ліцензії, борги чи судові справи.
• Юридичні та аналітичні послуги:
  • Юридичні перевірки під час укладання угод (due diligence).
  • Використання інформації для складання бізнес-звітів.
• Громадський контроль та журналістські розслідування:
  • Виявлення зв’язків між компаніями та їх кінцевими бенефіціарами.
  • Аналіз прозорості роботи громадських організацій та політичних партій.
• Інтеграція з іншими реєстрами та системами:
  • Підключення до інших державних баз для автоматизації процесів (податкова, міграційна служба).
  • Забезпечення доступу до даних через API для цифрових платформ.
• Освітні та дослідницькі цілі:
  • Використання відкритих даних для досліджень економічного середовища.
  • Аналіз розвитку підприємництва в регіонах.
• Фінансовий сектор:
  • Використання банками для перевірки клієнтів.
  • Підтримка процедур ідентифікації та боротьби з відмиванням коштів.

Для забезпечення цих варіантів використання ЄДР має наступні сервіси:

• пошук суб’єкта за номером ЄДРПОУ, ІПН або паспортом;
• отримання детальної інформації по суб’єкту;
• отримання переліку суб’єктів, щодо яких проводились реєстраційні дії за добу;
• отримання останньої актуальної редакції установчого документа юридичної особи;
• отримання останньої актуальної редакції структури власності юридичної особи.

Нормативна база

1. ЗУ Про державну реєстрацію юридичних осіб, фізичних осіб - підприємців та громадських формувань
2. Постанова КМУ №593 від 08.09.2016 
3. Порядок державної реєстрації юридичних осіб, фізичних осіб - підприємців та громадських формувань, що не мають статусу юридичної особи
4. Порядок надання відомостей з Єдиного державного реєстру юридичних осіб, фізичних осіб - підприємців та громадських формувань

Документація доступна для ознайомлення

(Діаграми основних процесів, ТВ, ТЗ та інші документи, що можуть бути корисними для аналітиків чи розробників, (крім АРІ))

• Опис ППІ ЄДР на сайті ДП НАІС;
• Каталог сервісів Системи електронної взаємодії державних електронних інформаційних ресурсів“Трембіта”;

Профільні держоргани

Профільне міністерство: Мін'юст

Технічний адміністратор: ДП НАІС

Контактна особа з боку реєстру:

(особа, яка може зорієнтувати по актуальності АРІ, або запланованих змінах, попередньо від мінʼюсту чи НАІСу, необхідно уточнити після формалізації проєкту)

Поки немає.

Технологія та обмін даних

Технологія: HTTPS (JSON, XML), SOAP, REST

Обмін даними доступний через:

• ППІ ЄДР: API через HTTPS із підтримкою форматів JSON/XML, детальний опис тут
• СЕВДЕІР “Трембіта”: 
  • SOAP API - веб-сервіси розроблені як доповнення до існуючого ППІ ЄДР, щоб підключити ЄДР до СЕВДЕІР
  • REST-методи, що перелічені в каталозі “Трембіта”:
    • reason-enterprise
    • reason-branch
    • reason-person
    • та інші.

Історичність даних

Відсутня. Реєстр зберігає дані про юридичних та фізичних осіб в статусі “припинено”, але неможливо простежити зміни, які були внесені в запис: (зміна адреси, власників, назви тощо). 

Підписка на зміну даних в реєстрі

В самому ЄДР відсутній сервіс сповіщень про зміни даних в реєстрі, але є сторонні моніторингові ресурси, які можуть їх відслідковувати. Наприклад, Опендатабот дозволяє підписатися на оновлення даних компаній або ФОП в ЄДР, відслідковує зміни в і повідомляє про них користувача.

Також на порталі Мін'юсту кожні 2 дні оприлюднюються відомості про: рішення про припинення юридичної особи, відомості про комісію з припинення (ліквідатора, ліквідаційну комісію тощо) та про строк, визначений засновниками (учасниками) юридичної особи, судом або органом, що прийняв рішення про припинення юридичної особи, для заявлення кредиторами своїх вимог.

(використовується, у випадку, якщо необхідно відстежувати зміну статусів обʼєктів чи заяв)

Проблеми та обмеження

(Опис проблем з якими стикнулися під час роботи з реєстром, наприклад: вендорлок, обмеження на отримання даних (кількість запитів і т.д., складність нормативного врегулювання інтеграції)

Технічні обмеження сервісу

• Максимальна кількість елементів, які можна отримати у відповіді 100.
• Обмеження кількості запитів:
  • TEST: не більше 1000 запитів/місяць
  • PROD: від 5000 до 750000 запитів\місяць, залежно від умов підключення визначених за договором
  • Для захисту від DoS встановлено обмеження не більше ніж 200-500 запитів на хвилину залежно від обраного тарифного плану.

Обмеження доступу до даних

(Заповнюється, у випадку наявності обмежень на пошук даних в реєстрі, наприклад, для медичних даних, персональних даних, даних досудового розслідування)

Відсутні: аутентифікація за допомогою Токена платформи з якої особа здійснює запит в базу по HTTP протоколу.

Плата за користування:

Інтеграція платна для всіх, окрім:

• Центральні органи виконавчої влади (поліція, прокуратура, служба безпеки, агентство запобігання корупції)
• Суди
• Антимонопольний комітет
• Бюро економічної безпеки України
• Органи місцевого самоврядування та їх посадові особи
• Центральний орган виконавчої влади, що реалізує державну політику у сфері статистики, для використання у статистичних цілях

Визначення

Опис АРІ

Доступ до даних ЄДР реалізовано за такими технологіями API:

• ППІ ЄДР: API базується на HTTPS і підтримує формати JSON та XML. 
• СЕВДЕІР "Трембіта": SOAP API, розроблений як частина інтеграційної шини для підключення ЄДР до системи СЕВДЕІР. SOAP використовується через його здатність підтримувати складніші сценарії обміну даними з гарантованою структурою.

Наявність декількох API пояснюється потребою задовольнити різні вимоги щодо інтеграції, функціональності та безпеки, які висуваються різними користувачами (від приватних розробників до державних органів). 

Детальний опис ППІ ЄДР надано на сайті ДП НАІС. 

Для ППІ ЄДР також передбачена програмна реалізація.

Присутні наступні версії ППІ ЄДР, які визначаються за базовим URL:

• base url: /1.0 , api version: 1.0;
• base url: /2.0 , api version: 2.0.

Поточні версії мають наступні точки входу::

• пошук суб’єкта за номером ЄДРПОУ, ІПН або паспортом;
• отримання детальної інформації по суб’єкту;
• отримання довідника ролей;
• отримання довідника станів.

Функціонал доступний тільки для версії АПІ 2.0:

• отримання переліку суб’єктів, щодо яких проводились реєстраційні дії за добу;
• отримання останньої актуальної редакції установчого документа юридичної особи
• отримання останньої актуальної редакції установчого документа юридичної особи з КЕП Технічного адміністратора ЄДР
• отримання останньої актуальної редакції структури власності юридичної особи
• отримання останньої актуальної редакції
• структури власності юридичної особи з КЕП Технічного

адміністратора ЄДР

1. Пошук суб’єкта за номером ЄДРПОУ, ІПН або паспортом

Повертає перелік суб’єктів, які мають вказаний код (ЄДРПОУ для юридичних осіб або ІПН для фізичної особи-підприємця; якщо треба знайти фізичну особу-підприємця, яка не має ІПН - пошук проводиться по серії та номеру паспорта). Зазвичай, результатом є перелік з одним елементом, але у деяких випадках може мати більше одного, наприклад, якщо суб’єкт по якому виконується пошук проходить процес перетворення

1.1.  Назва сервісу: subjects

Протокол роботи: HTTPS (JSON, XML)

Відомості, що передаються у запиті:

• Код ЄДРПОУ або РНОКПП
• Серія та/або номер документа, що посвідчує фізичну особу
• Найменування юридичної особи або ПІБ ФОП
• Дата, протягом якої проводились реєстраційні дії

Загальний опис, що вертається: перелік суб’єктів, що відповідають пошуковому запиту

Детальний опис сервісу: тут

1.2. Назва сервісу: SearchSubjects

Протокол роботи: SOAP

Відомості, що передаються у запиті:

• Код ЄДРПОУ організації або ІПН ФОП
• Номер (або серія і номер) паспорта

Загальний опис, що вертається: 

• Назва суб’єкта
• Посилання на деталізовану інформацію про суб’єкта

Детальний опис сервісу: тут

1.3.  Назва сервісу: SearchSubjects2

Протокол роботи: SOAP

Відомості, що передаються у запиті:

• Код ЄДРПОУ або РНОКПП
• Серія та/або номер документа, що посвідчує фізичну особу.
• Найменування юридичної особи або ПІБ ФОП

Загальний опис, що вертається: 

• Найменування юридичної особи, або ПІБ ФОП
• Посилання на деталізовану інформацію про суб'єкта (при використанні API)

Детальний опис сервісу: тут

Зведена таблиця

2. Отримання детальної інформації по суб’єкту

У відповідь на запит сервіс повертає детальні відомості по конкретному суб’єкту за унікальним ідентифікатором такого суб’єкта.

2.1. Назва сервісу: subjects/{id}

Протокол роботи: HTTPS (JSON, XML)

Відомості, що передаються у запиті:

• Внутрішній ідентифікатор суб’єкта

Загальний опис, що вертається: 

• Детальна інформація про суб'єкта

Детальний опис сервісу: тут

2.2. Назва сервісу: SubjectDetail

Протокол роботи: SOAP

Відомості, що передаються у запиті:

• Внутрішній ідентифікатор суб’єкта

Загальний опис, що вертається: 

• Детальна інформація про суб'єкта

Детальний опис сервісу: тут

2.3.  Назва сервісу: SubjectDetail2

Протокол роботи: SOAP

Відомості, що передаються у запиті:

• Внутрішній ідентифікатор суб’єкта

Загальний опис, що вертається: 

• Детальна інформація про суб'єкта

Детальний опис сервісу: тут

Зведена таблиця

3. Допоміжні сервіси

3.1. Отримання довідника ролей

Можливі значення ролей:

3.2. Отримання довідника станів

Можливі значення станів суб’єкта:

Неочевидні дані, які можна отримати з реєстру

Немає інформації.

Зміни структури даних реєстру

Станом на зараз функціонує дві версії АРІ реєстру.

Вимоги до обміну даними

• Обмін йде по SOAP-протоколу, опис вимог є у WADL-файлах (формат XML)
• Інтеграція з реєстром вимагає відпрацювання взаємодії  на тестовому середовищі і тільки потім приєднання до промислового середовища

Публічний інтерфейс

Ресурс Мінʼюсту для пошуку в реєстрі

Відкриті дані 

Реєстр передбачає доступ до наступних відкритих даних:

• Основна інформація про юридичних осіб:
  1. Назва, код ЄДРПОУ.
  2. Організаційно-правова форма.
  3. Адреса реєстрації.
  4. Стан (діє/припинено/банкрутство тощо).
• Дані про фізичних осіб-підприємців:
  1. Прізвище, ім'я, по батькові (залежить від конфіденційності).
  2. Реєстраційні дії.
  3. Вид діяльності (КВЕД).
• Дані про громадські формування:
  1. Назва та статус.
• Додаткові дані:
  1. Відомості про засновників і бенефіціарів.
  2. Інформація про реєстраційні дії (зміна адреси, керівництва тощо).

Відкриті дані доступні:

• На офіційному порталі відкритих даних України: data.gov.ua.
• Партнерські сервіси: Опендатабот, YouControl тощо.

Заплановані зміни в реєстрі

Зміни в реєстрі на які є запит