• Головна
  • Інструкція: Як підключитися сервісам енергомоніторингу для передачі даних у ЄДЕССБ через API?

Інструкція: Як підключитися сервісам
енергомоніторингу для передачі даних у ЄДЕССБ
через API?

Ця інструкція описує порядок підключення зовнішніх сервісів енергомоніторингу до системи ЄДЕССБ з метою передачі даних для автоматичного формування документа “Відомості про енергоспоживання будівлі”. Інтеграція виконується через API та погодження з технічним адміністратором системи для отримання доступів.

1. Визначення ключових понять

Перед тим як почати процес підключення, слід розуміти основні терміни:

  • ЄДЕССБ (Єдина державна електронна система у сфері будівництва) — система, що містить інформацію про об’єкти будівництва, дозвільні документи, статистичні та аналітичні дані.
  • АРІ (Application Programming Interface) — програмний інтерфейс, що дозволяє інтегрувати інформаційні системи з ЄДЕССБ.
  • Користувач — юридична або фізична особа, яка отримує доступ до відомостей через АРІ.
  • Ідентифікатор користувача (client_id) — унікальне ім’я для авторизації в системі.
  • Ключ доступу (key) — унікальний ключ для підтвердження доступу.
  • Маркер доступу (access_token) — тимчасовий ключ для авторизації запитів.

2. Передумови для підключення

Перед початком інтеграції необхідно:

  • Мати розгорнутий сервіс енергомоніторингу.
  • Забезпечити можливість формування та передачі даних через REST API.
  • Підготувати технічну інформацію про систему:
    • Назва системи
    • Власник / організація
    • Контактна особа (ПІБ, email, телефон)
    • IP-адреси серверів
    • Опис структури даних
    • Формат передачі (JSON/XML)

3. Процедура підключення

Направлення запиту

Для ініціювання підключення необхідно направити офіційний лист технічному адміністратору ЄДЕССБ на електронну пошту: office@mbkd.gov.ua (шаблон листа див. Додаток 1)

У листі необхідно вказати:

  1. Загальну інформацію про організацію:
    • Назва організації
    • ЄДРПОУ/РНОКПП
    • Назва системи енергомоніторингу
  2. Мету інтеграції:

    Передача даних із сервісів енергомоніторингу у базу даних ЄДЕССБ для автоматичного формування документа «Відомості про енергоспоживання будівлі».

  3. Технічні параметри:
    • IP-адреси для доступу (whitelist)
    • Протокол (HTTPS)
    • Формат даних (JSON)
  4. Контакти відповідальних осіб:
    • Технічний спеціаліст
    • Бізнес-контакт

Отримання доступів

Після обробки запиту технічний адміністратор надає:

  • Ідентифікатор (client_id)
  • Ключ доступу (key)
  • Документацію по API

4. Підтримка та безпека

  • Контактна підтримка: support@e-construction.gov.ua
  • Зміна реквізитів користувача здійснюється через повторне подання Запиту про приєднання.
  • Заборонено передавати ідентифікатори та ключі третім особам. Порушення призведе до блокування доступу.

5. Завершення роботи та розірвання договору

Доступ до API може бути припинений у таких випадках:

  1. Порушення умов використання (передача ключів третім особам).
  2. Ініціатива користувача — через подання запиту на відключення доступу до API.