Отримання інформації за суб’єктом в ЄДР: Search Subjects Edr Registry

1. Загальна інформація

Для спрощення моделювання бізнес-процесів розроблені типові інтеграційні конектори для отримання інформації з ЄДР[1], налаштування яких відбувається на схемах бізнес-процесів у додатку Camunda Modeler.

Наразі імплементовано 2 типи конекторів для отримання даних із ЄДР:

  1. Інтеграційний конектор searchSubject — призначений для отримання інформації про суб’єкт за кодом ЄДРПОУ або РНОКПП (раніше — ІПН).

  2. Інтеграційний конектор subjectDetails — призначений для отримання деталізованої інформації про суб’єкт за ID.

2. Налаштування делегата

Розширення Search Subjects Edr Registry — делегат для виклику зовнішнього SOAP-сервісу, призначений для отримання інформації про суб’єкт за кодом ЄДРПОУ або РНОКПП (раніше — ІПН), який налаштовується за допомогою шаблону Search Subjects Edr Registry (searchSubjectsEdrRegistryConnectorDelegate.json).

  1. Відкрийте Service Task.

  2. На панелі налаштувань справа натисніть Open Catalog та оберіть шаблон Search Subjects Edr Registry зі списку.

    element template settings 01

  3. Налаштуйте обраний шаблон:

    • У полі Name вкажіть назву задачі. Наприклад, Пошук інформації за суб’єктом в ЄДР

    • У полі Authorization token зазначте токен для доступу до СЕВ ДЕІР "Трембіта". Наприклад, {token}.

      Authorization token надається постачальником сервісу (в нашому випадку — ЄДР), який є іншим учасником СЕВ ДЕІР "Трембіта".

    • У полі Code введіть код (ЄДРПОУ або РНОКПП) для пошуку в ЄДР. Наприклад, 88888888.

    • У полі Result variable зазначте назву вихідного параметру, до якого буде записано відповідь від сервісу. Наприклад, response.

    element template settings 1

При інтеграції бізнес-процесів зі стороннім сервісом Search Subjects, особливу увагу слід звернути на мапінг значень поля state суб’єктів з Єдиного державного реєстру (ЄДР). У відповідях, отриманих від цього сервісу, значення стану суб’єкта представлені за допомогою цифрових ідентифікаторів (1, 2, 3 тощо). Вбудований механізм у делегаті Search subjects Edr Registry дозволяє зручно перетворювати (мапити) ідентифікатори на розумілі та читабельні текстові описи стану для зручності користувачів і подальшої обробки інформації. Наприклад, 1 = ACTIVE тощо.

Більш детально про мапінг статусів стану суб’єкта ви можете дізнатися у таблиці Можливі значення стану суб’єкта з ЄДР.

3. Приклади використання у бізнес-процесі

Розглянемо ситуацію, коли у бізнес-процесі необхідно перевірити статус суб’єкта в ЄДР.

Для цього у процесі необхідно налаштувати інтеграційний конектор для пошуку суб’єкта з ЄДР (в нашому випадку відповідь буде записано до змінної responseEDR).

element template settings 3

Приклад 1. Приклад відповіді від сервісу
    {
    "name": "active user",
    "code": "77777777",
    "id": 213123,
    "state": "ACTIVE"
    }

Відповідь містить параметр state, що має значення "ACTIVE". Далі на шлюзі відбувається перевірка:

Якщо state має значення SUSPENDED або CANCELLED, то бізнес-процес видає валідаційну помилку.
Приклад 2. Приклад налаштування гілки
${responseEdr.value.responseBody.elements().get(0).prop('state').value().equals('SUSPENDED') || responseEdr.responseBody.elements().get(0).prop('state').value().equals('CANCELED')}

element template settings 4

Якщо state не дорівнює SUSPENDED або CANCELLED, то відбудеться подальше виконання процесу.
Приклад 3. Приклад налаштування гілки
${!responseEdr.value.responseBody.elements().get(0).prop('state').value().equals('SUSPENDED') && !responseEdr.value.responseBody.elements().get(0).prop('state').value().equals('CANCELED')}

element template settings 5

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