# Практичний старт: як підготувати законний доступ до енергетичних даних

> **Для кого:** підприємства, незалежні агрегатори, розробники та фахівці з комерційного обліку. **Статус:** практичний навчальний матеріал EDDIE UA, не сервіс доступу до DataHub, не юридична консультація та не офіційна інструкція АКО. Оновлено 21 листопада 2026 року.

## Що можна зробити на цій сторінці

За кілька хвилин визначити власну роль, перелік потрібних даних і документів, перевірити синтетичний приклад доступу, корекції та відкликання права. **Реальні EIC, договори, профілі споживання, паролі й КЕП сюди завантажувати не потрібно.** EDDIE UA не здійснює запитів до промислового DataHub.

- [Запустити інтерактивну демонстрацію доступу](/playground/) – послідовно перевірте представника, надайте й відкличте умовний дозвіл, подивіться відмови та журнал дій прямо у браузері.
- [Відкрити синтетичний сценарій у JSON](/assets/examples/eddie-access-scenario-v0.1.json) – відкритий машинозчитуваний приклад для розробників та аудиторів.
- [Переглянути дослідницьку лабораторію](?page=laboratory) – сценарії перевірки сумісності без реальних даних.
- [Зрозуміти актуальну нормативну основу](?page=regulatory) – де чинний акт, де проєкт, а де наша пропозиція.

## 1. Я представляю підприємство: хочу зрозуміти споживання й потенціал гнучкості

**Питання, на яке хочете відповісти:** де виникають піки, чи варто встановити УЗЕ, як керувати холодильниками, СЕС або зарядними станціями, які очікувані заощадження після витрат?

**Підготуйте без передавання нам:** юридичне найменування і ЄДРПОУ; перелік власних об'єктів та їхніх EIC/ТКО; перелік повноважних представників; період, за який потрібна історія; тип аналізу; правову підставу надання даних конкретному сервісу. **EIC є ідентифікатором, а не дозволом.** Наявність номера не доводить права отримувати будь-які вимірювання.

1. Перевірте, хто має право діяти від імені юридичної особи та щодо відповідної ТКО протягом запитуваного періоду.
2. Сформулюйте мету: наприклад, 12 місяців інтервальних даних для розрахунку піків і вибору УЗЕ. Запитуйте мінімум, необхідний для мети.
3. Визначте законний канал отримання офіційних даних та потрібну форму підтвердження повноважень за чинними документами АКО й ППКО. **EDDIE UA не замінює цей канал.**
4. Перевірте повноту інтервалів, одиниці виміру, напрям імпорту/експорту, статуси якості, часовий пояс і корекції.
5. Передайте дані обраному аналітику лише в межах підтвердженої правової підстави й належних умов захисту.
6. Порівняйте консервативний, базовий та оптимістичний сценарії з CAPEX, OPEX, вартістю електроенергії, деградацією УЗЕ, ризиком небалансів і платежами сервісів.

**Результат підготовки:** опис мети, перевірені повноваження, перелік ТКО та періодів і вимоги до якості даних – не «автоматичний доступ по ЄДРПОУ».

## 2. Я незалежний агрегатор: хочу оцінити клієнта без зміни його постачальника або СВБ

**Мета:** отримати лише правомірно дозволену історію для оцінки гнучкості клієнта, який залишає чинного електропостачальника та сторонню сторону, відповідальну за баланс (СВБ).

1. Встановіть юридичні підстави доступу, право представництва і точний обсяг: ТКО, період, категорії даних, строк.
2. Зіставте ваш сценарій із фактично чинними процедурами АКО. Не припускайте наявність або відсутність спеціального API без підтвердження.
3. Отримайте лише передбачені законом і дозволом дані, зберігаючи відомості про їх джерело, версію та корекції.
4. Виконайте аналіз гнучкості, але **відокремте доступ до інформації від договору агрегації, належності до СВБ, ринкової кваліфікації та права керування обладнанням.**
5. Якщо процедура не документована або неоднозначна, зафіксуйте конкретну операцію, чинну норму, спостережуваний результат і питання до АКО, а не робіть висновок, що «доступу немає».

**Перевірка:** дві однаково правомочні незалежні компанії повинні мати зіставні умови доступу; відмови мають містити належно доступну причину без розкриття захищеної інформації. Це **запропонований критерій дослідження**, а не твердження про вже перевірену роботу АКО.

[Шість практичних сценаріїв](?page=use-cases) містять приклади для холодильників, торговельних центрів, СЕС, ОСББ та розробників.

## 3. Я інженер або розробник: хочу перевірити сумісність

**Мета:** спроєктувати власний клієнт інформаційного обміну без використання чужих облікових даних.

1. Почніть із [синтетичного JSON-файлу](/assets/examples/eddie-access-scenario-v0.1.json). Це **навчальна структура EDDIE UA, не офіційний формат DataHub, API, схема сертифікації або робочий endpoint**.
2. Перевірте встановлення зв'язку між правомочним отримувачем, власником/представником, ТКО і періодом. Запит поза обсягом повинен блокуватися у нашій моделі.
3. Відтворіть повторення запиту після відкликання права: сама давність вимірювання не відновлює припинений дозвіл.
4. Відтворіть корекцію вимірювання: не стирайте початкове значення та зберігайте джерело й ревізію.
5. Перевірте дві різні UTC-мітки, які під час осіннього переходу можуть мати однаковий локальний час. Відсутній інтервал не дорівнює нулю.
6. Документуйте очікуваний результат, фактичний результат, версію реалізації, пояснення відмови й журнал тесту.

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

[Технічна архітектура](?page=architecture) розділяє обмін даними комерційного обліку, сервіси доступу та фізичне керування енергетичними ресурсами.

## 4. Я АКО, ППКО, ОСР або регулятор: які саме питання ми пропонуємо перевірити?

Для відкритої перевірки важливі **не гасла про «новий DataHub», а конкретні процедури**.

- Який чинний документ встановлює категорії правомочних отримувачів, повноваження представника, доступну історію та причини відмов?
- Як відстежуються корекції, якість, версії, 23- і 25-годинні доби, припинення/відкликання доступу?
- Які матеріали інтегратор може законно отримати: формати, специфікації, тестові дані, протоколи й процедури оновлення?
- Як незалежно перевірити недискримінаційність без розкриття профілів клієнтів та секретів інформаційної безпеки?
- Чи можна реалізувати ті самі результати простішим централізованим API із резервуванням? Федерація не є наперед визначеним переможцем.

**Офіційна нормативна стадія:** станом на 21.11.2026 пункт 29 порядку денного НКРЕКП 24.11.2026 є майбутнім розглядом **проєкту**, а не прийнятою постановою. Після засідання потрібно перевірити фактичне рішення, оприлюднену редакцію та строк консультації. [Матеріали НКРЕКП](https://www.nerc.gov.ua/materials/materialy-do-zasidannia-24112026).

## 5. Як читати навчальний JSON-файл

Файл містить три приклади та контрольний опис: **обмежений дозвіл**, **історія з корекцією і зміною часу**, **відкликання й відмова на новий запит**. Поля й статуси придумані для пояснення, а не запозичені з офіційного протоколу.

- `case_type` – яке право або стан перевіряється.
- `scoped_permission` – хто, на яку ТКО та на який період у синтетичній моделі має дозволену дію.
- `readings` – приклад часових інтервалів, якості й ревізій.
- `expected_result` – результат, який повинна показати модель, а не реальний DataHub.
- `not_an_official_api` – незмінний запобіжник проти помилкового трактування прикладу.

Це матеріал для обговорення. **Публічна форма збору EIC або профілів споживання не відкрита**. Починайте з верифікації джерел, а не з надсилання приватних даних.

## Першоджерела

- [Закон України «Про ринок електричної енергії» №2019-VIII](https://zakon.rada.gov.ua/laws/show/2019-19).
- [Закон №4834-IX](https://zakon.rada.gov.ua/laws/show/4834-20).
- [Кодекс комерційного обліку електричної енергії, постанова НКРЕКП №311](https://zakon.rada.gov.ua/laws/show/v0311874-18).
- [Процедури доступу до даних в ЄС – Регламент 2023/1162](https://eur-lex.europa.eu/eli/reg_impl/2023/1162/oj/eng) – порівняльний орієнтир, не автоматично чинна норма в Україні.

[Розвиток проєкту](?page=updates) · [Питання й відповіді](?page=faq) · [Як долучитися](?page=participate)
