Як за допомогою API отримати актуальний перелік зв’язків суб’єкта з Реєстру господарських суб’єктів (KRS) з іншими суб’єктами та особами?

MGBI надає комплексний API для отримання даних із державних реєстрів та облікових баз, зокрема з Національного судового реєстру (KRS). Перелік джерел даних, доступних у цій службі, можна знайти на сайті:
👉 Державні реєстри API

Цей посібник стосується API для пошукової системи суб’єктів KRS, яку ми надаємо в рамках продукту:
👉 API Національного судового реєстру (KRS API) — Пошукова система суб’єктів

Нижче ми описали, як за допомогою API можна завантажити актуальний перелік зв’язків зазначеного суб’єкта з Реєстру судових справ (KRS) з іншими суб’єктами та особами на підставі його номера KRS.

Крок 1: Отримати ключ авторизації в API

Щоб отримати ключ авторизації, необхідний для виклику кінцевих точок, доступних в MGBI API, зв’яжіться з нами за допомогою контактної форми на сторінці продукту:
👉 API Національного судового реєстру (KRS API) — Пошукова система суб’єктів господарювання

Крок 2: Викличте кінцеву точку Get Records

Дані, доступні в пошуковій системі суб’єктів KRS, ми надаємо в MGBI API у вигляді моделі даних з ідентифікатором pl-krs-wp-record.

API надає для цієї моделі кінцеву точку Get Records, яка повертає записи, що містять текст поточного та повного виписки з KRS для суб’єктів, які відповідають вказаним критеріям.
👉 Документація кінцевої точки Get Records для моделі pl-krs-wp-record

Для отримання даних про окремий суб’єкт господарювання з КРС необхідно вказати в кінцевій точці Get Records його реєстраційний номер: KRS, NIP або REGON.

Приклад виклику ендпойнту Get Records із номером KRS:

{
    "count": 1,
    "pages": 1,
    "results": [
        {
            "id": [identyfikator rekordu],
            "identifiers": [identyfikatory podmiotu i powiązanych osób],
            "content": [treść odpisu aktualnego i pełnego],
            "files": [pliki odpisów w formacie PDF],
            "relations": [relacje podmiotu z innymi podmiotami i osobami],
            "meta": [metadane rekordu]
        }
    ]
}

Крок 3: З’ясуйте з відповідей інформацію про зв’язки

При правильному виклику кінцевої точки Get Records у відповідь повертається список записів, що відповідають заданим критеріям.

У наведеному вище прикладі кінцева точка повинна повернути список результатів, що містить один запис:

{
    "count": 1,
    "pages": 1,
    "results": [
        {
            "id": [identyfikator rekordu],
            "identifiers": [identyfikatory podmiotu i powiązanych osób],
            "content": [treść odpisu aktualnego i pełnego],
            "files": [pliki odpisów w formacie PDF],
            "relations": [relacje podmiotu z innymi podmiotami i osobami],
            "meta": [metadane rekordu]
        }
    ]
}

Актуальний перелік зв’язків суб’єкта з іншими суб’єктами та особами можна знайти у полі relations.

Кожен елемент словника, розміщений у цьому полі, містить перелік зв’язків певного типу разом із даними про пов’язані суб’єкти та осіб, а також додатковою інформацією.

Приклад вмісту словника relations:

{
    "dzial2_reprezentacja_sklad": [lista powiązań z członkami organów reprezentacji],
    "dzial2_prokurenci": [lista powiązań z prokurentami],
    "dzial2_organNadzoru_sklad": [lista powiązań z członkami organów nadzoru]
}

Структура даних у елементах списків відповідає структурі даних у полях повного витягу, доступного у словнику content.full_excerpt.dane.

Кожен елемент списку посилань містить додаткові поля:

• nrWpisuWprow — номер запису в Реєстрі судів (KRS), що вносить відповідне зв’язування,
• dataWpisuWprow — дата внесення до КРС запису, що встановлює відповідний зв’язок.

З огляду на історичні зв’язки також доступні такі поля:

• nrWpisuWykr — номер запису в КРС, яким скасовується відповідне зв’язування,
• dataWpisuWykr — дата внесення до Реєстру господарських суб’єктів (KRS) запису про скасування відповідного зв’язку.

Дізнайтеся більше:
👉 Структура даних у моделі pl-krs-wp-record
👉 Документація щодо кінцевих точок для моделі pl-krs-wp-record